Addresses

Create wallet addresses, list wallet addresses, and inspect balances.

Each chain requires its own derived address before a wallet can operate on that network. Address management is usually part of onboarding and chain enablement, while balance inspection is part of everyday runtime logic.

Create a wallet address

CLI

caw address create --chain-id SETH

Python SDK

address = await owner_client.create_wallet_address(
    wallet_uuid=wallet_uuid,
    chain_id="SETH",
)
print(address["address"])

TypeScript SDK

const address = (await walletsApi.createWalletAddress(walletUuid, {
  chain_id: 'SETH',
})).data.result;
console.log(address.address);

List wallet addresses

CLI

caw address list

Python SDK

addresses = await owner_client.list_wallet_addresses(wallet_uuid)
for addr in addresses.get("items", []):
    print(addr["address"], addr["chain_id"])

TypeScript SDK

const addresses = (await walletsApi.listWalletAddresses(walletUuid)).data.result;
for (const addr of addresses.items ?? []) {
  console.log(addr.address, addr.chain_id);
}

Check balances

CLI

caw wallet balance

Python SDK

balances = await owner_client.list_balances(wallet_uuid=wallet_uuid)
for b in balances.get("items", []):
    print(b["token_id"], b["balance"], b["chain_id"])

TypeScript SDK

const balances = (await balanceApi.listBalances(walletUuid)).data.result;
for (const b of balances.items ?? []) {
  console.log(b.token_id, b.balance, b.chain_id);
}

For toolkit-based runtimes, the closest runtime-facing tools are list_wallet_addresses and get_balance.