tokens

Manage the per-chain list of ERC20 tokens that `beam balance` shows by default.

Usage

$ beam [--chain <name|id>] tokens [list]
$ beam [--chain <name|id>] tokens add [token|token-address] [label] [--decimals <decimals>]
$ beam [--chain <name|id>] tokens remove <token|token-address>

Examples

$ beam tokens
$ beam --chain base tokens add 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913
$ beam --chain base tokens add 0x0000000000000000000000000000000000000bee BEAMUSD
$ beam tokens remove USDC

Built-in labels

Beam preloads metadata for these tokens on first run:

USDC
USDT

Privacy-capable Payy chains also expose the PUSD predeploy at 0x0200000000000000000000000000000000000000 as the label native.

Where it lives

The tracked-token list is stored per chain in ~/.beam/config.json under tracked_tokens. Known token metadata (label → address, decimals) lives under known_tokens.

You can use either the label or a raw address on any ERC20 or balance command:

$ beam --chain base balance USDC
$ beam --chain base balance 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913