
What is the Universal SDK?
Universal Accounts give your users a single address and balance across all supported chains. The Universal Accounts SDK allows you to integrate Universal Accounts into your dApp, allowing you to onboard users from any ecosystem without requiring them to bridge—regardless of where your dApp is deployed.Integration Flow
The Universal Accounts SDK is designed for fast, minimum-lift integrations with common wallet connection mechanisms. Under the hood, it utilizes any wallet provider object (e.g., social logins, MetaMask, WalletConnect) and routes all transactions through the user’s Universal Account, an ERC-4337 smart account implementation. In short, the integration flow requires you to:- Configure the account using a single config object.
- Use your existing provider object (from RainbowKit or any other connection mechanism) using the SDK.
- Push transactions as usual—no other codebase changes needed. A user’s balance of any token will be treated as a collective of these tokens across any chain they’re on.
The Universal Accounts SDK uses wallet connection mechanisms. As such, if a user creates a Universal Account by connecting an existing wallet, their assets will not be automatically transferred into the UA. Users can transfer assets into their Universal Account from any supported chain via in-app flows. You may also make Universal Accounts an optional toggle within your dApp if you prefer to maintain EOAs as the default account mechanism.
Quickstart: Universal Accounts
Get a live integration ready in under 5 minutes by learning the basics of Universal Accounts and implementing the SDK.Introduction to Universal Accounts
What are Universal Accounts, how do they work, and what problems do they solve?
Getting Started
A step-by-step setup guide for integrating the UAs SDK into your application.
UA SDK Reference
SDK and API reference for the Universal Accounts SDK.
How-To Guides
Learn to implement specific Universal Account features in your app.Getting A Unified Balance
Learn how to fetch and display the unified balance of a Universal Account.
Sending Cross-Chain Transactions
Learn how to send transactions across different blockchain networks using Universal Accounts.
Displaying An Assets Breakdown
Learn how to display the assets breakdown of a Universal Account.
Toggling Universal Accounts On/Off
Implement a system to toggle between using Universal Accounts and regular EOAs.