get-supported-tokens

Supported chain families:

EVMSolanaAptosTONCanton

List tokens supported for CCIP transfers and display token pool configurations.

Synopsis

Bash

ccip-cli get-supported-tokens -n <network> -a <address> [options]

Aliases: getSupportedTokens

Description

The get-supported-tokens command queries CCIP infrastructure to display supported tokens and their pool configurations. It provides information about fee tokens, transfer limits, and rate limiter states.

Options

Required Options

Option	Alias	Type	Description
--network	-n	string	Source network (chain ID or name, e.g., ethereum-mainnet)
--address	-a	string	Router, OnRamp, TokenAdminRegistry, or TokenPool address

Optional Options

Option	Alias	Type	Default	Description
--token	-t	string	-	Token address to query (pre-selects from list if address is a registry)
--fee-tokens	-	boolean	false	List fee tokens instead of transferable tokens

See Configuration for global options (--rpcs, --format, etc.).

Command Builder

Build your get-supported-tokens command interactively:

ccip-cli get-supported-tokens Builder

List tokens supported for CCIP transfers

Output Options

Control command output format

Output Format-- Select --Pretty (human-readable tables)JSON (machine-readable)Log (console.log style)

Format for command output

Verbose

Enable debug logging

RPC Configuration

Configure blockchain RPC connections

RPC URLs

List of RPC endpoint URLs (ws[s] or http[s])

RPC File

File containing RPC endpoints (reads RPC_* environment variables)

Fill in required fields to generate command

Generated Command

ccip-cli get-supported-tokens --rpcs-file ./.env --format pretty

Output Modes

Token List Mode

When querying a Router without specifying a token:

Section	Description
Token List	Interactive searchable list of all tokens

Use --fee-tokens to display fee tokens instead:

Bash

ccip-cli get-supported-tokens -n ethereum-mainnet -a 0xRouter... --fee-tokens

Token Detail Mode

When a token is selected or specified:

Field	Description
Token address	Contract address on the source chain
Symbol / Name	Token symbol and full name
Decimals	Token decimal places
Pool address	Associated token pool contract
Pool type	Lock/Release, Burn/Mint, etc.
finalityDepth	(v2.0+ pools) Minimum source-chain block confirmations for FTF (0 = supported but not enabled)
finalitySafe	(v2.0+ pools) Whether Pool supports safe finality (Fast Confirmation Rule)
Remote chains	Supported destination chains with rate limits

Examples

List supported tokens on Ethereum mainnet

Bash

ccip-cli get-supported-tokens -n ethereum-mainnet -a 0x80226fc0Ee2b096224EeAc085Bb9a8cba1146f7D

Query a specific token

Bash

ccip-cli get-supported-tokens \
  -n ethereum-mainnet \
  -a 0x80226fc0Ee2b096224EeAc085Bb9a8cba1146f7D \
  -t 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48

Query a token pool directly

Bash

ccip-cli get-supported-tokens -n ethereum-mainnet -a 0xTokenPoolAddress

Output as JSON

Bash

ccip-cli get-supported-tokens -n ethereum-mainnet -a 0x80226fc0... --format json

List fee tokens

Bash

ccip-cli get-supported-tokens -n ethereum-mainnet -a 0x80226fc0Ee2b096224EeAc085Bb9a8cba1146f7D --fee-tokens

Rate Limiter Information

For each remote chain, the command displays rate limiter state:

Field	Description
capacity	Maximum tokens in the rate limiter bucket
tokens	Current available tokens (percentage of capacity)
rate	Refill rate per second
timeToFull	Time until bucket reaches capacity (if not full)

Faster-Than-Finality (FTF) Fields

For TokenPool v2.0+ contracts, additional fields may appear:

Field	Description
[fast]outbound	FTF outbound rate limiter state (custom block confirmations)
[fast]inbound	FTF inbound rate limiter state (custom block confirmations)

These FTF rate limiters apply separate limits when transfers use custom (lower) block confirmations instead of full finality.

Interactive Mode

In --format pretty (default), the token list is interactive:

Key	Action
Type	Filter by address, symbol, or name
Arrow keys	Navigate the list
Enter	Select token and view details

See Also

• send - Send tokens using --transfer-tokens
• Configuration - RPC setup

Exit Codes

Code	Meaning
0	Success - tokens listed or token details retrieved
1	Error (network failure, invalid contract, missing arguments)

Use in scripts:

Bash

# JSON output is newline-delimited (one JSON object per token)
ccip-cli get-supported-tokens -n $NETWORK -a $ROUTER --format json | jq -s '.[].symbol'