Coinbase Wallet SDK

Coinbase Wallet SDK allows dapps to connect to Coinbase Wallet

1. Coinbase Smart Wallet
   • Docs
2. Coinbase Wallet mobile for Android and iOS
   • Desktop: Users can connect to your dapp by scanning a QR code
   • Mobile: Users can connect to your mobile dapp through a deeplink to the dapp browser
3. Coinbase Wallet extension for Chrome and Brave
   • Desktop: Users can connect by clicking the connect with extension option.

Installing Wallet SDK

1. Check available versions:

   1  # yarn
   2  yarn info @coinbase/wallet-sdk versions
   3
   4  # npm
   5  npm view @coinbase/wallet-sdk versions

2. Install latest version:

   1# yarn
   2yarn add @coinbase/wallet-sdk
   3
   4# npm
   5npm install @coinbase/wallet-sdk

3. Check installed version:

   1# yarn
   2yarn list @coinbase/wallet-sdk
   3
   4# npm
   5npm list @coinbase/wallet-sdk

Upgrading Wallet SDK

Migrating from v3 to v4? Please see our v4 migration guide for a full list of breaking changes.

1. Compare installed version with latest:

   1# yarn
   2yarn outdated @coinbase/wallet-sdk
   3
   4# npm
   5npm outdated @coinbase/wallet-sdk

2. Update to latest:

   1# yarn
   2yarn upgrade @coinbase/wallet-sdk --latest
   3
   4# npm
   5npm update @coinbase/wallet-sdk

Basic Usage

1. Initialize SDK

   1const sdk = new CoinbaseWalletSDK({
   2  appName: 'SDK Playground',
   3});

2. Make web3 Provider

   1const provider = sdk.makeWeb3Provider();

3. Request accounts to initialize connection to wallet

   1const addresses = provider.request({
   2  method: 'eth_requestAccounts',
   3});

4. Make more requests

   1provider.request('personal_sign', [
   2  `0x${Buffer.from('test message', 'utf8').toString('hex')}`,
   3  addresses[0],
   4]);

5. Handle provider events

   1provider.on('connect', (info) => {
   2  setConnect(info);
   3});
   4
   5provider.on('disconnect', (error) => {
   6  setDisconnect({ code: error.code, message: error.message });
   7});
   8
   9provider.on('accountsChanged', (accounts) => {
   10  setAccountsChanged(accounts);
   11});
   12
   13provider.on('chainChanged', (chainId) => {
   14  setChainChanged(chainId);
   15});
   16
   17provider.on('message', (message) => {
   18  setMessage(message);
   19});

Developing locally and running the test dapp

• The Coinbase Wallet SDK test dapp can be viewed here https://coinbase.github.io/coinbase-wallet-sdk/.

• To run it locally follow these steps:

  1. Fork this repo and clone it
  2. From the root dir run yarn install
  3. From the root dir run yarn dev