Skip to content

Integrating Coinbase smart wallets

The Coinbase Smart Wallet is the next iteration of the Coinbase Wallet, taking a lot of the wallet logic onchain to unlock massive new capabilities for users. The release will be available to users in a few weeks, with the launch of version 4.0.0 of the Coinbase Wallet sdk.

Privy will enable you to support Smart Wallet out of the box on day 1, no configuration required. Just update your SDK version on day 1 and give your users access to the Smart Wallets, meaning

  • you can set up the smart wallet with wagmi or your favorite library for free.
  • you can support the Smart Wallet alongside other popular login methods like MetaMask or email login.

What is the Coinbase Smart Wallet?

The Smart Wallet itself is an ERC-4337 compatible smart contract. It will prompt your user to sign up using passkeys generated on their device and can do everything a wallet can do from thereon in, and more. The Smart Wallet boasts a number of huge benefits:

  • No extensions or passphrases required: the user only needs a passkey to get up and running!
  • Accessible across sites: by tying the passkey to a Coinbase domain (, the Smart Wallet will work across any site that integrates it. This means one account for your user wherever they go.
  • Simple account funding: The Smart Wallet integrates with Coinbase Pay and Magic Spend out of the box, making it easy for your users to fund transactions from the wallet if they already have a Coinbase account and unlocking AA benefits around gas sponsorship with paymasters.
  • Flexibility of AA: Enabling more complex use cases, like multiple owners for a Smart Wallet, for instance.

Integrating AA at the wallet level is a powerful way to make it easily accessible to all users across apps, while giving developers an easily upgradeable experience thanks to the Smart Wallet's onchain system. By packaging the Smart Wallet as part of the existing Coinbase Wallet SDK, you can expect wide support on day 1.

What networks will Coinbase Smart Wallets support at launch? At launch the Coinbase Smart Wallet will be compatible with the following networks: - Arbitrum - Avalanche - Base - BNB - Ethereum L1 - Optimism - Polygon - Zora

For more, you can read about the Smart Wallet, and check out the source code

Integrating the Coinbase Smart Wallet with Privy

The Coinbase Smart Wallet will automatically be available to all Privy developers at launch. To get set up, you will simply need to update your Privy sdk version and make sure Coinbase Wallet is surfaced as part of your login flow.

By default Privy's implementation will surface the existing Coinbase Wallet extension for users who have it installed and the Smart Wallet for everyone else. You can ovveride this behavior using the coinbase-wallet-mode configuration:

  • smart-wallet-optional: (default) The Privy SDK will detect whether the user has the Coinbase wallet extension installed. It will popup the Coinbase wallet if they do and the Smart Wallet otherwise.
  • smart-wallet-only: The Privy SDK will surface the Coinbase Smart Wallet for all users.
  • disabled: The Privy SDK will only surface the Coinbase Wallet extension. Users who do not have it installed will be prompted to install it.

What's next

We believe the release of the Coinbase Smart Wallet is a big step forward for broad adoption of account abstraction and bringing crypto mainstream and we are excited to support this product at launch.

From there, we are looking at two paths moving ahead, both leveraging the forthcoming EIP-3074:

  • Making EOA migrations to smart wallets simple -- We want to ensure users can easily move assets over to a smart wallet system if they so choose.
  • Enabling multiple signers for the Smart Wallet system -- While powerful, we also recognize passkeys may not be right for all users. Using EIP-3074, we are looking to easily enable users to leverage the Coinbase Smart Wallet with an email or social based Privy embedded wallet.

For more on this, you can read our blog post on this integration path and check out @wilsoncusack's exploration of these systems leveraging the forthcoming EIP-3074.