Skip to content
Demo

Getting Started (V4.0.0+)

Install @coinbase/wallet-sdk

npm
npm i @coinbase/wallet-sdk

Create an SDK Instance

setup.ts
import { CoinbaseWalletSDK } from '@coinbase/wallet-sdk';
 
export const sdk = new CoinbaseWalletSDK({
    appName: "My App",
    appLogoUrl: "https://example.com/logo.png",
    appChainIds: [8453],
});

Create a Provider

provider.ts
import { sdk } from './setup'
 
// see the makeWeb3Provider page for more information
const preference = {
    options: "smartWalletOnly",
    attribution: {
        auto: true,
    }
};
 
// Create provider
export const provider = sdk.makeWeb3Provider(preference);
// Use provider
const addresses = provider.request({method: 'eth_requestAccounts'});

Parameters

appName (optional)

  • Type: string

The app name. This will be displayed to users on connection, transacting, and signing requests.

appChainIds (optional)

  • Type: number[]

Array of chain IDs your app supports. Default value is [1].

What networks are supported?

appLogoUrl (optional)

  • Type: string

App logo image URL. Favicon is used if unspecified.

preference (optional)

  • Type Preference
type Attribution = {
    auto: boolean;
    dataSuffix?: never;
} | {
    auto?: never;
    dataSuffix: `0x${string}`;
}
 
type Preference = {
    keysUrl?: string;
    options?: 'all' | 'smartWalletOnly' | 'eoaOnly';
    attribution?: Attribution;
}