Quickstart

The CDP SDK allows you to create wallets and send funds onchain within minutes. In this quickstart, you will learn how to create a wallet, fund it with testnet ETH, transfer funds between wallets, and trade assets.

​

What You’ll Learn

• How to install the CDP SDK
• How to create a Developer-Managed Wallet and view its default address
• How to fund your wallet with testnet ETH
• How to transfer funds between wallets
• How to trade assets in a wallet

​

Requirements

node -v
npm -v

nvm install node # "node" is an alias for the latest version
nvm use node

​

Installation

git clone git@github.com:coinbase/coinbase-sdk-nodejs.git; cd coinbase-sdk-nodejs/quickstart-template

npm install

​

Creating a Wallet

The following instructions illustrate how to create a Developer-Managed (1-of-1) Wallet from scratch, using the CDP SDK.

1. Create a CDP Secret API key
2. Initialize the CDP SDK by passing your downloaded API key file
3. Create a new Developer-Managed (1-of-1) wallet

import { Coinbase, Wallet } from "@coinbase/coinbase-sdk";

const apiKeyName = "Copy your secret API key name here."
const apiKeyPrivateKey = "Copy your secret API key's private key here."

Coinbase.configure(apiKeyName, apiKeyPrivateKey)

let coinbase = Coinbase.configureFromJson({ filePath: '~/Downloads/cdp_api_key.json' });

// Create a new Wallet
let wallet = await Wallet.create();
console.log(`Wallet successfully created: `, wallet.toString());

// Wallets are not saved locally by default. Refer to the Wallets concept for more information.

let address = await wallet.getDefaultAddress();
console.log(`Default address for the wallet: `, address.toString());

The wallet created should be persisted to avoid losing access to it. Refer to Persisting a wallet section for more information.

​

Importing a Wallet

The following instructions illustrate how to bring your own wallet into the CDP ecosystem, as a Developer-Managed (1-of-1) Wallet, using the CDP SDK.

1. Create a CDP Secret API key
2. Initialize the CDP SDK by passing your downloaded API key file
3. Create a new Developer-Managed (1-of-1) wallet using your BIP-39 mnemonic seed phrase

import { Coinbase, Wallet } from "@coinbase/coinbase-sdk";

const apiKeyName = "Copy your secret API key name here."
const apiKeyPrivateKey = "Copy your secret API key's private key here."

Coinbase.configure(apiKeyName, apiKeyPrivateKey)

let coinbase = Coinbase.configureFromJson({ filePath: '~/Downloads/cdp_api_key.json' });

// Import your Wallet into CDP using your BIP-39 mnemonic seed phrase.
// NOTE 1: For security reasons, we recommend storing your seed phrase in an environment variable.
// NOTE 2: Your wallet's seed and seed phrase will not leave your device.
let wallet = await Wallet.import({ mnemonicPhrase: process.env.MNEMONIC_PHRASE });
console.log(`Wallet successfully created: `, wallet.toString());

// Wallets are not saved locally by default. Refer to the Wallets concept for more information.

let address = await wallet.getDefaultAddress();
console.log(`Default address for the wallet: `, address.toString());

Once initialized, your imported wallet should be stored as a Wallet data object, for easy re-instantiation. Refer to Persisting a wallet section for more information.

​

Funding a Wallet

Wallets do not have funds on them to start. For Base Sepolia and Ethereum Sepolia testnets, we provide a faucet method to fund your wallet with testnet ETH.

const faucetTransaction = await wallet.faucet();

// Wait for transaction to land on-chain.
await faucetTransaction.wait();

console.log(`Faucet transaction completed successfully: `, faucetTransaction.toString());

​

Transferring Funds

Now that your faucet transaction has successfully completed, you can send the funds in your wallet to another wallet. The code below creates another wallet, and sends testnet ETH from the first wallet to the second:

let anotherWallet = await Wallet.create();
console.log(`Second Wallet successfully created: `, anotherWallet.toString());

const transfer = await wallet.createTransfer({
amount: 0.00001,
assetId: Coinbase.assets.Eth,
destination: anotherWallet,
});

// Wait for the transfer to settle.
await transfer.wait()

// Check if the transfer successfully completed on-chain.
if (transfer.getStatus() === 'complete') {
console.log(`Transfer successfully completed: `, transfer.toString());
} else {
console.error('Transfer failed on-chain: ', transfer.toString());
}

See Transfers for more information.

You can create your wallet, fund it with testnet tokens and perform your first transfer by running the following command:

npm start

​

Trading Assets

On base-mainnet you can trade between different assets from your wallet. Since trading is only supported on mainnet wallets, wallet should be funded with real assets before trading. The code below creates a wallet and trades some ETH to USDC and then all of the USDC to WETH:

import { Coinbase, Wallet } from "@coinbase/coinbase-sdk";

let coinbase = Coinbase.configureFromJson({ filePath: '~/Downloads/cdp_api_key.json' });

// Create a Wallet on base-mainnet to trade assets with.
let wallet = await Wallet.create({ networkId: Coinbase.networks.BaseMainnet });

// Fund the Wallet's default Address with ETH from an external source.
// Trade 0.00001 ETH to USDC.
let trade = await wallet.createTrade({
  amount: 0.00001,
  fromAssetId: Coinbase.assets.Eth,
  toAssetId: Coinbase.assets.Usdc
});

await trade.wait();

if (trade.getStatus() === 'complete') {
  console.log(`Trade successfully completed: `, trade.toString());
} else {
  console.log(`Trade failed on-chain: `, trade.toString());
}

// Trade the wallet's full balance of USDC to WETH.
let trade2 = await wallet.createTrade({
  amount: wallet.getBalance(Coinbase.assets.Usdc),
  fromAssetId: Coinbase.assets.Usdc,
  toAssetId: Coinbase.assets.Weth,
});

await trade2.wait();

if (trade2.getStatus() === "complete") {
  console.log(`Trade successfully completed: `, trade2.toString());
} else {
  console.log(`Trade failed on-chain: `, trade2.toString());
}