Skip to main content
Universal Accounts

​
What is the Universal SDK?

Universal Accounts give your users a single account and balance across all supported chains. The Universal Accounts SDK allows you to integrate Universal Accounts into your dApp. With UAs, your users can interact with your dApp without bridging — regardless of your native chain or where their assets live.

​
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.
It also leverages EIP-7702 to facilitate users to spend their existing assets through their Universal Account, without migrating.
In short, the integration flow requires you to:
  1. Configure the account using a single config object.
  2. Use your existing provider object (from RainbowKit or any other connection mechanism) using the SDK.
  3. Push transactions throug the UA instance. A user’s balance of any token will be treated as a collective of these tokens across any chain they’re on.
Once integrated, all transacions, balance reads, and gas handling will automatically use the Universal Account—no additional code for bridging or gas logic required. The Universal Accounts SDK leverages EIP-7702. As such, if a user creates a Universal Account by connecting an existing wallet, this wallet and its assets will be automatically upgraded to a Universal Account (as long as the target application uses a supported provider). If the target application does not use a supported provider, developers may also make Universal Accounts an optional toggle within the dApp if they prefer to maintain EOAs as the default account mechanism. Users can transfer assets into their Universal Account from any supported chain via in-app flows.
Universal Accounts are independent smart accounts if used in smart account mode, not extensions of an existing wallet.
  • When a user creates a Universal Account with their existing wallet, their assets stay in the original wallet. Nothing is moved automatically.
  • Users can transfer assets into their Universal Account from any supported chain through in-app flows.
  • As a developer, you can choose whether to make Universal Accounts the default experience or keep them as an optional toggle alongside EOAs.

​
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.

Integrate Universal Accounts

Learn how to integrate Universal Accounts into any dApp.

Use Universal Accounts as deposit flow

Learn how to use Universal Accounts as deposit flow.

Displaying An Assets Breakdown

Learn how to display the assets breakdown of a Universal Account.

​
Understanding Chain Abstraction

Explore the foundational concepts behind Universal Accounts and how they power chain abstraction.

What Is Chain Abstraction?

Breakdown of chain abstraction, Universal Accounts, and Universal Liquidity.

Supported Chains

List of chains supported by Universal Accounts.