CCTP Commands

Cross-Chain Transfer Protocol (CCTP) enables secure USDC transfers between Solana and EVM chains. These commands manage CCTP policies and execute bridge transfers.

view-policy

View the current CCTP policy showing allowed destination addresses by domain.

glam cctp view-policy

Arguments

None

Options

None

Examples

glam cctp view-policy

Output

CCTP allowed destinations:
0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb
0x9f8F72aA9304c8B593d555F12eF6589cC3A579A2
0x1234567890123456789012345678901234567890

Domain reference:

0: Ethereum
1: Avalanche
2: Optimism
3: Arbitrum
6: Base
7: Polygon PoS

See CCTP Supported Blockchains for complete list.

allowlist-destination

Add a destination address to the CCTP allowlist for a specific domain.

glam cctp allowlist-destination <domain> <destination_address> [options]

Arguments

domain

number

required

CCTP domain identifier (e.g., 0 for Ethereum, 3 for Arbitrum)

destination_address

string

required

Destination address (EVM address by default, or base58 if —base58 flag is used)

Options

--base58

flag

Treat destination address as base58-encoded Solana address instead of EVM address

-y, --yes

flag

Skip confirmation prompt and execute immediately

Examples

Add Ethereum address with confirmation:

glam cctp allowlist-destination 0 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb

Add Arbitrum address without confirmation:

glam cctp allowlist-destination 3 0x1234567890123456789012345678901234567890 -y

Add Solana address (base58):

glam cctp allowlist-destination 5 8XyZqR2fK3VNhBJT9x5eWdL4mPnQvR7sJ6kU1cH2gM9N --base58

Output

Destination 0x742d35Cc... (domain 0) added to allowlist: 5Hs2kP3vN8wL...

Error Cases

Fails if destination is already in the allowlist
Fails if address format is invalid

remove-destination

Remove a destination address from the CCTP allowlist.

glam cctp remove-destination <domain> <destination_address> [options]

Arguments

domain

number

required

CCTP domain identifier

destination_address

string

required

Destination address to remove (EVM address by default, or base58 if —base58 flag is used)

Options

--base58

flag

Treat destination address as base58-encoded Solana address instead of EVM address

-y, --yes

flag

Skip confirmation prompt and execute immediately

Examples

Remove Ethereum address:

glam cctp remove-destination 0 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb

Remove without confirmation:

glam cctp remove-destination 3 0x1234567890123456789012345678901234567890 -y

Output

Destination 0x742d35Cc... (domain 0) removed from allowlist: 2Xt9pL4mK7wN...

bridge-usdc

Bridge USDC from Solana to an EVM chain. The USDC is burned on Solana and can be minted on the destination chain.

glam cctp bridge-usdc <amount> <domain> <destination_address> [options]

Arguments

amount

number

required

Amount of USDC to bridge (in USDC units, e.g., 100.5)

domain

number

required

CCTP domain identifier for destination chain

destination_address

string

required

Recipient address on destination chain (EVM address by default)

Options

-d, --destination-caller

string

Address authorized to call receive on destination chain

-m, --max-fee-bps

number

default:"1"

Maximum fee in basis points (e.g., 1 = 0.01%, 100 = 1%)

-b, --base58

flag

Treat addresses as base58-encoded instead of EVM addresses

-f, --fast

flag

Use fast transfer mode with lower finality threshold (1000 vs 2000)

-y, --yes

flag

Skip confirmation prompt and execute immediately

Examples

Bridge 100 USDC to Ethereum:

glam cctp bridge-usdc 100 0 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb

Bridge with fast mode:

glam cctp bridge-usdc 1000 3 0x1234567890123456789012345678901234567890 --fast

Bridge with custom max fee (0.5%):

glam cctp bridge-usdc 500 1 0xabcdef1234567890abcdef1234567890abcdef12 -m 50

Bridge with destination caller:

glam cctp bridge-usdc 250 0 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb \
  -d 0x9876543210987654321098765432109876543210

Bridge without confirmation:

glam cctp bridge-usdc 100 0 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb -y

Output

USDC burned: 7Qm8nK5pL3wM9fC6rT2xP8bD5jG1aX9cF8uE7sU3kJ2N

Behavior

Validates destination is in allowlist (if policy exists)
Converts amount to base units (6 decimals for USDC)
Calculates max fee based on amount and max-fee-bps
Sets finality threshold (1000 for fast, 2000 for normal)
Burns USDC on Solana
Emits attestation for Circle attestation service

Finality Thresholds

See CCTP Finality Thresholds:

Normal (2000): Higher security, longer wait time
Fast (1000): Lower finality requirement, faster but slightly less secure

receive

Receive USDC on Solana from an EVM chain bridge transfer.

glam cctp receive <source_domain> [options]

Arguments

source_domain

number

required

Source domain identifier where USDC was burned

Options

-t, --txHash

string

Transaction hash from source chain (hex string starting with 0x). Either txHash or nonce is required.

-n, --nonce

string

Nonce from burn message (hex string starting with 0x). Either txHash or nonce is required.

Examples

Receive using transaction hash:

glam cctp receive 0 -t 0xabc123...

Receive using nonce:

glam cctp receive 3 -n 0x1234567890abcdef

Output

Received USDC: 4Km7nJ4pK2wL8fB5qS1xN7aD4jF0aW8cE7tD6rT2kH1M

Behavior

Fetches attestation from Circle’s attestation service
Validates the message
Mints USDC to the vault on Solana
Uses CCTP lookup table for transaction optimization

Requirements

Either --txHash or --nonce must be provided
The burn transaction must be attested by Circle (may take a few minutes)
The message must be addressed to this vault

list

List all CCTP bridge events (incoming and outgoing) for the vault.

glam cctp list [options]

Arguments

None

Options

-s, --since-slot

number

Fetch events starting from this slot number

-b, --batch-size

number

Batch size for RPC requests. Higher values reduce latency but require higher RPC rate limits.

-c, --commitment

string

default:"confirmed"

Commitment level (processed, confirmed, finalized)

Examples

List all events:

glam cctp list

List events since specific slot:

glam cctp list --since-slot 250000000

List with custom batch size:

glam cctp list -b 100

List with finalized commitment:

glam cctp list -c finalized

Output

JSON object containing:

vaultState: Vault state PDA
vaultPda: Vault PDA
incoming: Array of incoming bridge events
outgoing: Array of outgoing bridge events

{
  "vaultState": "8XyZqR2fK3VNhBJT9x5eWdL4mPnQvR7sJ6kU1cH2gM9N",
  "vaultPda": "3Dm9vK8pL2hW5rN9xC7fT6mE4qJ1bY3aG8uH9sV2kP7M",
  "incoming": [
    {
      "slot": 250123456,
      "signature": "4Km7nJ4pK2wL8fB5qS1xN7aD4jF0aW8cE7tD6rT2kH1M",
      "sourceDomain": 0,
      "amount": "100000000",
      "nonce": "0x1234567890abcdef"
    }
  ],
  "outgoing": [
    {
      "slot": 250123400,
      "signature": "7Qm8nK5pL3wM9fC6rT2xP8bD5jG1aX9cF8uE7sU3kJ2N",
      "destinationDomain": 3,
      "amount": "50000000",
      "recipient": "0x1234567890123456789012345678901234567890"
    }
  ]
}

CCTP Workflow

Bridging FROM Solana to EVM:

Set up policy - Add destination addresses to allowlist

glam cctp allowlist-destination 0 0x742d35Cc...

Bridge USDC - Burn USDC on Solana

glam cctp bridge-usdc 100 0 0x742d35Cc...

Wait for attestation - Circle attestation service processes the burn (usually 2-20 minutes)
Mint on destination - Use Circle’s SDK or UI on destination chain to complete the transfer

Bridging TO Solana from EVM:

Burn on source chain - Use CCTP on source EVM chain to burn USDC
Wait for attestation - Circle processes the attestation
Receive on Solana - Complete the transfer
```
glam cctp receive 0 -t 0xabc123...
```

Monitoring:

Check transfer history:

glam cctp list

Vault Management

Trading & Swaps

DeFi Integrations

Access Control

Investor Operations

Advanced

​CCTP Commands

​view-policy

​Arguments

​Options

​Examples

​Output

​allowlist-destination

​Arguments

​Options

​Examples

​Output

​Error Cases

​remove-destination

​Arguments

​Options

​Examples

​Output

​bridge-usdc

​Arguments

​Options

​Examples

​Output

​Behavior

​Finality Thresholds

​receive

​Arguments

​Options

​Examples

​Output

​Behavior

​Requirements

​list

​Arguments

​Options

​Examples

​Output

​CCTP Workflow

​Bridging FROM Solana to EVM:

​Bridging TO Solana from EVM:

​Monitoring:

​Resources

Build docs developers (and LLMs) love

CCTP Commands

view-policy

Arguments

Options

Examples

Output

allowlist-destination

Arguments

Options

Examples

Output

Error Cases

remove-destination

Arguments

Options

Examples

Output

bridge-usdc

Arguments

Options

Examples

Output

Behavior

Finality Thresholds

receive

Arguments

Options

Examples

Output

Behavior

Requirements

list

Arguments

Options

Examples

Output

CCTP Workflow

Bridging FROM Solana to EVM:

Bridging TO Solana from EVM:

Monitoring:

Resources