The Universal Accounts SDK provides chain abstraction for your app by integrating Universal Accounts. These offer your users a single account, balance, and interaction point across EVM chains and Solana. Our SDK integrates with existing connection flows with minimal setup.Documentation Index
Fetch the complete documentation index at: https://developers.particle.network/llms.txt
Use this file to discover all available pages before exploring further.
Learn More About Universal Accounts
What are Universal Accounts, how do they work, and what problems do they solve?
Installation
Once your app is set up, install the Universal Accounts SDK:The SDK depends on
ethers.js internally, but you are not required to use it directly. You can use any provider or signer that fits your setup.Account Modes
Universal Accounts can operate in two modes, depending on your wallet setup and execution environment:7702 Mode (Default)
Within this mode:- Your user’s existing EOA is upgraded to act directly as a Universal Account.
- The EOA address and Universal Account address are the same.
- Assets already held at the user’s EOA are immediately usable on their Universal Account—without transferring assets.
- No smart account deployments needed.
Smart Account Mode
Within this mode:- A separate smart account is attached to your user’s EOA.
- The smart account has its own address, separate from the EOA.
- Users must transfer assets to the smart account before using it.
Mode Comparison
| Mode | Account Address | Asset Transfer Required | JSON-RPC Support |
|---|---|---|---|
| 7702 (default) | Same as EOA | No | No |
| Smart Account | Separate | Yes | Yes |
Integration flow
Understand account modes
Universal Accounts support two execution modes. Choosing the right one determines how the user’s account behaves.
Initialize Universal Accounts
Once connected, pass the user’s EOA address to the SDK and configure your project details.
Reference
Setup
Initialization & Configuration
Configure project credentials, account mode, and
tradeConfig.Addresses
Retrieve the owner EOA, EVM UA, and Solana UA addresses.
Primary Assets & Unified Balance
Fetch the unified balance and per-chain asset breakdowns.
EIP-7702 Compatible Wallets
Demos and integration notes for Dynamic, Magic, and Privy.
Transactions
Transfer
createTransferTransaction() — send tokens cross-chain.Custom Payable
createUniversalTransaction() — call any contract.Buy
createBuyTransaction() — buy a token with USD value.Sell
createSellTransaction() — sell a token into a primary asset.Conversion
createConvertTransaction() — convert between primary assets.Solana
Send transactions on Solana from any chain’s funds.
Transaction Preview
Inspect fees and token movements before signing.
sendTransaction() Response
Full breakdown of the
TransactionResult object.History & Integration
Transaction History
Fetch a user’s past transactions and details.
Particle Connect
Sign UA transactions with a wallet from Particle Connect.
Backend / Server-side
Use Universal Accounts in Node.js with a private key.
UniversalX Registration
Register a Universal Account on UniversalX.
Next steps
Quickstart
Build your first Universal Account integration in 5 minutes.
FAQ
Common questions about the SDK.