Skip to main content
Commands for bridging USDC across chains using Circle’s Cross-Chain Transfer Protocol (CCTP).
The CCTP integration must be enabled before using these commands:

Bridge USDC

Bridge USDC from Solana to an EVM chain.
  • amount: Amount of USDC to bridge
  • domain: Destination domain ID (see table below)
  • destination_address: Recipient address on the destination chain
  • --destination-caller, -d: Optional destination caller address
  • --max-fee-bps, -m: Maximum fee in basis points (default: 1)
  • --base58, -b: Address is in base58 format (default: EVM hex format)
  • --fast, -f: Use fast transfer mode (lower finality threshold)
Example: Bridge 100 USDC to Ethereum:
Example: Fast bridge to Arbitrum:

Domain IDs

Receive USDC

Receive USDC bridged from an EVM chain to Solana.
  • source_domain: Source chain domain ID
  • --txHash, -t: Transaction hash from the source chain (hex string starting with 0x)
  • --nonce, -n: Nonce from the source transaction (hex string starting with 0x)

List Bridge Events

List CCTP events for incoming and outgoing bridge transfers.
  • --since-slot, -s: Fetch events since this slot
  • --batch-size, -b: Batch size for RPC requests
  • --commitment, -c: Commitment level (default: confirmed)

Policy Management

CCTP policies allow you to restrict which destination addresses can receive bridged USDC.

View Policy

View the current CCTP policy.

Allowlist Destination

Add a destination address to the CCTP allowlist.
  • domain: Destination domain ID
  • destination_address: Address on the destination chain
  • --base58: Address is in base58 format
Example: Allowlist an Ethereum address:

Remove Destination

Remove a destination address from the CCTP allowlist.