Migrate from Coinbase Wallet SDK

​

Overview

The Base Account SDK allows Base Account users to connect 3rd party mobile and web applications. The Base Account SDK is the successor to the Coinbase Wallet SDK, which is now considered legacy.

Developers should integrate the Base Account SDK such that users connect to use it via a “Sign in with Base” or “Base” button (see guide).

We do not recommend immediately replacing existing “Coinbase Wallet” buttons in your app, but rather add the Base Account button as an additional option, next to a “Coinbase Wallet” button. This will allow a transition period for users to get familiar with the new Base brand.

Driving this change is a transition of our mobile app: the Coinbase Wallet app is now the Base app. We are gradually transitioning all of our users to have Base Accounts, which are powered by our Smart Wallet platform.

Below is a table of existing users and how they will connect to apps now and in the future:

​

Changes to user experience when click “Coinbase Wallet”

As of SDK v4.0, users without Coinbase Wallet extension are directed to a popup window where they can choose to connect with the mobile app, via WalletLink, or use a passkey-powered Smart Wallet natively on the web.

This will continue to be the case, but the logged out experience has changed to educate Smart Wallet users that they should be using “Sign in with Base” in the future. Here is how it looks on desktop.

If you would like to avoid users seeing any popup window, we recommend using a version of the Coinbase Wallet SDK < 4.0

​

How to migrate?

If you’re using the SDK, you can simply replace the Coinbase Wallet SDK with the Base Account SDK.

import { createBaseAccountSDK } from "@base-org/account";

const baseAccount = createBaseAccountSDK({
  // ...
});

For more information please refer to the Quickstart guide.

If you’re using a third party library, you can follow the Wagmi or Privy guides.

We will have a more complete migration guide in the near future.