What is the Universal Accounts SDK?
What is the Universal Accounts SDK?
The Universal Accounts SDK lets you integrate Particle Network’s chain abstraction into your dApp. It provides your users with a unified address and balance across EVM chains and Solana.You can use this SDK to:
- Allow users with assets on any chain to access your dApp.
- Give your users a unified assets balance and identity across chains and ecosystems.
- Execute transactions across chains without bridging or transferring assets.
Which platforms are supported by the SDK?
Which platforms are supported by the SDK?
The SDK is currently only available for Web.
Check out our SDK Reference for detailed platform-specific docs.
What are Primary Assets, and how do they work?
What are Primary Assets, and how do they work?
Primary Assets are tokens with deep liquidity, used by the Universal Accounts SDK as sources for cross-chain transactions. These assets are used for gas, swaps, and liquidity routing across chains.Users can hold Primary assets on any supported chain. When a transaction (like a swap or transfer) is initiated, the SDK will:
Find a list of the supported Primary Assets in the Supported Chains & Primary Assets page.
- Identify the most optimal Primary Asset from the user’s portfolio. For example, it may select USD on Polygon to allow a user to purchase a memecoin on Solana.
- Route liquidity across all the chains the user holds this Primary Asset using Universal Liquidity.
- Complete the transaction on the destination chain, even if the user holds no assets on that chain.
Do users need to deposit assets into their Universal Account?
Do users need to deposit assets into their Universal Account?
Yes. Universal Accounts are ERC-4337 smart account implementations, which means users must deposit assets into them before they can be used.However, if a user already holds funds on another app leveraging Universal Accounts, like UniversalX, those balances will be already available and usable within your dAppTo enable swaps, transfers, or contract calls:
- Users must hold at least one Primary Asset on their Universal Account.
- Once deposited, the SDK can route liquidity across supported chains.
Do Universal Accounts have private keys?
Do Universal Accounts have private keys?
No. Universal Accounts are ERC-4337 smart accounts—they don’t have private keys like traditional EOAs (Externally Owned Accounts).Instead, ownership and permissions are managed via a signer (such as a user’s wallet or social login) that authorizes transactions.
What are the transaction fees?
What are the transaction fees?
Each Universal Account (UA) transaction may include the following fees:
- Gas fees: Required to execute the transaction on the destination chain.
- Liquidity provider (LP) fee: A 0.20% fee applied only to cross-chain transactions, paid to the LP handling the transfer.
- Swap fee: Applied only when swapping tokens, and varies based on token popularity:
- 0.1% for tokens ranked in the top 500 on CoinGecko.
- 1% for tokens ranked above 500.
How to fix the 'Buffer is not defined' error in Vite
How to fix the 'Buffer is not defined' error in Vite
This error happens because Vite doesn’t polyfill Node.js globals like
Buffer
in the browser. However, some SDK dependencies (like ethers
) may expect it to be available.To fix this, follow these steps:1. Install required packages
- Update your
vite.config.ts
vite.config.ts
Could not find a declaration file for module '@particle-network/universal-account-sdk'.
Could not find a declaration file for module '@particle-network/universal-account-sdk'.
You might get this error when using TypeScript. To fix it, you can add a declaration in This will solve the declaration error.
tsconfig.json
.Add ./node_modules/@particle-network/universal-account-sdk/dist/index.d.ts
to the paths
property in tsconfig.json
.Still need help?
Reach out via our Telegram support channel to get direct help from Particle’s Developer Relations team.
Reach out via our Telegram support channel to get direct help from Particle’s Developer Relations team.