Token Transfers

The CDP SDK provides convenient methods for transferring native tokens (ETH, SOL) and fungible tokens (ERC-20, SPL) across supported networks.

EVM Token Transfers

Basic ETH Transfer

Transfer ETH using the high-level transfer method:

TypeScript
Python

import { CdpClient } from "@coinbase/cdp-sdk";

const cdp = new CdpClient();
const sender = await cdp.evm.getOrCreateAccount({ name: "Sender" });

const result = await sender.transfer({
  to: "0x1234567890123456789012345678901234567890",
  amount: 1000000000000000n, // 0.001 ETH in wei
  token: "eth",
  network: "base-sepolia"
});

console.log(`Transaction hash: ${result.transactionHash}`);

from cdp import CdpClient

async with CdpClient() as cdp:
    sender = await cdp.evm.get_or_create_account(name="Sender")
    
    result = await sender.transfer(
        to="0x1234567890123456789012345678901234567890",
        amount=1000000000000000,  # 0.001 ETH in wei
        token="eth",
        network="base-sepolia"
    )
    
    print(f"Transaction hash: {result.transaction_hash}")

ERC-20 Token Transfer

Transfer ERC-20 tokens (like USDC, USDT, DAI):

TypeScript
Python

import { parseUnits } from "viem";

// Transfer 10 USDC (6 decimals)
const result = await sender.transfer({
  to: "0x9F663335Cd6Ad02a37B633602E98866CF944124d",
  amount: 10000000n, // 10 USDC in smallest unit
  token: "usdc",
  network: "base-sepolia"
});

// Or use parseUnits helper
const amount = parseUnits("10", 6); // 6 decimals for USDC
const result = await sender.transfer({
  to: "0x9F663335Cd6Ad02a37B633602E98866CF944124d",
  amount: amount,
  token: "usdc",
  network: "base-sepolia"
});

from cdp import parse_units

# Transfer 10 USDC (6 decimals)
result = await sender.transfer(
    to="0x9F663335Cd6Ad02a37B633602E98866CF944124d",
    amount=10000000,  # 10 USDC in smallest unit
    token="usdc",
    network="base-sepolia"
)

# Or use parse_units helper
amount = parse_units("10", 6)  # 6 decimals for USDC
result = await sender.transfer(
    to="0x9F663335Cd6Ad02a37B633602E98866CF944124d",
    amount=amount,
    token="usdc",
    network="base-sepolia"
)

Token Decimals Guide:

ETH, WETH: 18 decimals
USDC, USDT: 6 decimals
DAI: 18 decimals

Always verify the token’s decimals before transferring!

Transfer to Another Account

You can transfer directly to another CDP account:

TypeScript
Python

const sender = await cdp.evm.getOrCreateAccount({ name: "Sender" });
const receiver = await cdp.evm.getOrCreateAccount({ name: "Receiver" });

const result = await sender.transfer({
  to: receiver, // Pass the account object directly
  amount: 10000n, // 0.01 USDC
  token: "usdc",
  network: "base-sepolia"
});

sender = await cdp.evm.get_or_create_account(name="Sender")
receiver = await cdp.evm.get_or_create_account(name="Receiver")

result = await sender.transfer(
    to=receiver,  # Pass the account object directly
    amount=10000,  # 0.01 USDC
    token="usdc",
    network="base-sepolia"
)

Smart Account Transfers

Smart accounts can transfer tokens via user operations, optionally with gas sponsorship:

TypeScript
Python

const owner = await cdp.evm.createAccount();
const smartAccount = await cdp.evm.createSmartAccount({ owner });

// Transfer with optional paymaster
const result = await smartAccount.transfer({
  to: "0x1234...",
  amount: 10000000n, // 10 USDC
  token: "usdc",
  network: "base-sepolia",
  paymasterUrl: "https://paymaster.example.com" // Optional
});

console.log(`User operation hash: ${result.userOpHash}`);

// Wait for confirmation
const confirmed = await smartAccount.waitForUserOperation(
  result.userOpHash
);
console.log(`Transaction hash: ${confirmed.transactionHash}`);

owner = await cdp.evm.create_account()
smart_account = await cdp.evm.create_smart_account(owner=owner)

# Transfer with optional paymaster
result = await smart_account.transfer(
    to="0x1234...",
    amount=10000000,  # 10 USDC
    token="usdc",
    network="base-sepolia",
    paymaster_url="https://paymaster.example.com"  # Optional
)

print(f"User operation hash: {result.user_op_hash}")

# Wait for confirmation
confirmed = await smart_account.wait_for_user_operation(
    user_op_hash=result.user_op_hash
)
print(f"Transaction hash: {confirmed.transaction_hash}")

Solana Token Transfers

SOL Transfer

Transfer native SOL tokens:

TypeScript
Python

import { CdpClient } from "@coinbase/cdp-sdk";

const cdp = new CdpClient();
const sender = await cdp.solana.getOrCreateAccount({ 
  name: "SolanaSender" 
});

const signature = await sender.transfer({
  to: "9aE4FvpEqMj3K4cZKXXCHwDr9FQZyH2yZ8xF5Cz7T3v2",
  amount: 1000000n, // 0.001 SOL (in lamports)
  token: "sol",
  network: "solana-devnet"
});

console.log(`Transaction signature: ${signature}`);

from cdp import CdpClient

async with CdpClient() as cdp:
    sender = await cdp.solana.get_or_create_account(
        name="SolanaSender"
    )
    
    signature = await sender.transfer(
        to="9aE4FvpEqMj3K4cZKXXCHwDr9FQZyH2yZ8xF5Cz7T3v2",
        amount=1000000,  # 0.001 SOL (in lamports)
        token="sol",
        network="solana-devnet"
    )
    
    print(f"Transaction signature: {signature}")

Solana Units:

1 SOL = 1,000,000,000 lamports (9 decimals)
Always specify amounts in lamports

SPL Token Transfer

Transfer SPL tokens (Solana’s equivalent to ERC-20):

TypeScript
Python

// Transfer USDC on Solana (6 decimals)
const signature = await sender.transfer({
  to: "9aE4FvpEqMj3K4cZKXXCHwDr9FQZyH2yZ8xF5Cz7T3v2",
  amount: 1000000n, // 1 USDC
  token: "usdc",
  network: "solana-devnet"
});

# Transfer USDC on Solana (6 decimals)
signature = await sender.transfer(
    to="9aE4FvpEqMj3K4cZKXXCHwDr9FQZyH2yZ8xF5Cz7T3v2",
    amount=1000000,  # 1 USDC
    token="usdc",
    network="solana-devnet"
)

Checking Token Balances

Before transferring, check token balances:

EVM Balances

TypeScript
Python

const balances = await account.listTokenBalances({
  network: "base-sepolia"
});

for (const balance of balances.tokenBalances) {
  console.log(
    `${balance.symbol}: ${balance.amount} (${balance.decimals} decimals)`
  );
}

balances = await account.list_token_balances(
    network="base-sepolia"
)

for balance in balances.token_balances:
    print(
        f"{balance.symbol}: {balance.amount} "
        f"({balance.decimals} decimals)"
    )

Complete Transfer Example

Here’s a complete example with faucet funding and confirmation:

TypeScript
Python

import { CdpClient } from "@coinbase/cdp-sdk";
import { createPublicClient, http } from "viem";
import { baseSepolia } from "viem/chains";

const cdp = new CdpClient();
const sender = await cdp.evm.getOrCreateAccount({ name: "Sender" });
const receiver = await cdp.evm.getOrCreateAccount({ name: "Receiver" });

// Fund sender with testnet tokens
console.log("Requesting USDC and ETH from faucet...");
const [usdcFaucet, ethFaucet] = await Promise.all([
  cdp.evm.requestFaucet({
    address: sender.address,
    network: "base-sepolia",
    token: "usdc"
  }),
  cdp.evm.requestFaucet({
    address: sender.address,
    network: "base-sepolia",
    token: "eth"
  })
]);

// Wait for faucet transactions
const publicClient = createPublicClient({
  chain: baseSepolia,
  transport: http()
});

await Promise.all([
  publicClient.waitForTransactionReceipt({
    hash: usdcFaucet.transactionHash
  }),
  publicClient.waitForTransactionReceipt({
    hash: ethFaucet.transactionHash
  })
]);

console.log("Faucet funds received!");

// Transfer USDC
console.log("Sending 0.01 USDC...");
const result = await sender.transfer({
  to: receiver,
  amount: 10000n, // 0.01 USDC
  token: "usdc",
  network: "base-sepolia"
});

// Wait for confirmation
const receipt = await publicClient.waitForTransactionReceipt({
  hash: result.transactionHash
});

console.log(`Transfer confirmed! Status: ${receipt.status}`);
console.log(
  `Explorer: https://sepolia.basescan.org/tx/${receipt.transactionHash}`
);

from cdp import CdpClient
from web3 import Web3

w3 = Web3(Web3.HTTPProvider("https://sepolia.base.org"))

async with CdpClient() as cdp:
    sender = await cdp.evm.get_or_create_account(name="Sender")
    receiver = await cdp.evm.get_or_create_account(name="Receiver")
    
    # Fund sender with testnet tokens
    print("Requesting USDC and ETH from faucet...")
    usdc_faucet = await cdp.evm.request_faucet(
        address=sender.address,
        network="base-sepolia",
        token="usdc"
    )
    eth_faucet = await cdp.evm.request_faucet(
        address=sender.address,
        network="base-sepolia",
        token="eth"
    )
    
    # Wait for faucet transactions
    w3.eth.wait_for_transaction_receipt(usdc_faucet.transaction_hash)
    w3.eth.wait_for_transaction_receipt(eth_faucet.transaction_hash)
    print("Faucet funds received!")
    
    # Transfer USDC
    print("Sending 0.01 USDC...")
    result = await sender.transfer(
        to=receiver,
        amount=10000,  # 0.01 USDC
        token="usdc",
        network="base-sepolia"
    )
    
    # Wait for confirmation
    receipt = w3.eth.wait_for_transaction_receipt(
        result.transaction_hash
    )
    
    print(f"Transfer confirmed! Status: {receipt['status']}")
    print(
        f"Explorer: https://sepolia.basescan.org/tx/"
        f"{receipt['transactionHash'].hex()}"
    )

Troubleshooting

Insufficient Balance

If the transfer fails due to insufficient balance:

// Check balance first
const balances = await account.listTokenBalances({ 
  network: "base-sepolia" 
});
console.log(balances);

// Request testnet tokens
await cdp.evm.requestFaucet({
  address: account.address,
  network: "base-sepolia",
  token: "usdc"
});

Gas Estimation Failed

Ensure the account has enough native tokens (ETH/SOL) for gas:

await cdp.evm.requestFaucet({
  address: account.address,
  network: "base-sepolia",
  token: "eth" // Always need ETH for gas
});

Transfer to Invalid Address

Always validate addresses before transferring:

TypeScript
Python

import { isAddress } from "viem";

const recipient = "0x1234...";
if (!isAddress(recipient)) {
  throw new Error("Invalid Ethereum address");
}

from web3 import Web3

recipient = "0x1234..."
if not Web3.is_address(recipient):
    raise ValueError("Invalid Ethereum address")

Token Decimal Confusion

Double-check token decimals:

// WRONG: Sending 1 full USDC (will send 0.000001 USDC)
await account.transfer({
  amount: 1n,
  token: "usdc",
  // ...
});

// CORRECT: Sending 1 full USDC
await account.transfer({
  amount: 1000000n, // 6 decimals
  token: "usdc",
  // ...
});

Get Started

Core Concepts

Guides

Examples

Token Transfers

EVM Token Transfers

Basic ETH Transfer

ERC-20 Token Transfer

Transfer to Another Account

Smart Account Transfers

Solana Token Transfers

SOL Transfer

SPL Token Transfer

Checking Token Balances

EVM Balances

Complete Transfer Example

Troubleshooting

Insufficient Balance

Gas Estimation Failed

Transfer to Invalid Address

Token Decimal Confusion

Next Steps

Build docs developers (and LLMs) love

Get Started

Core Concepts

Guides

Examples

​EVM Token Transfers

​Basic ETH Transfer

​ERC-20 Token Transfer

​Transfer to Another Account

​Smart Account Transfers

​Solana Token Transfers

​SOL Transfer

​SPL Token Transfer

​Checking Token Balances

​EVM Balances

​Complete Transfer Example

​Troubleshooting

​Insufficient Balance

​Gas Estimation Failed

​Transfer to Invalid Address

​Token Decimal Confusion

​Next Steps

Build docs developers (and LLMs) love

EVM Token Transfers

Basic ETH Transfer

ERC-20 Token Transfer

Transfer to Another Account

Smart Account Transfers

Solana Token Transfers

SOL Transfer

SPL Token Transfer

Checking Token Balances

EVM Balances

Complete Transfer Example

Troubleshooting

Insufficient Balance

Gas Estimation Failed

Transfer to Invalid Address

Token Decimal Confusion

Next Steps