Quote

/bridge quote 100 USDC sol to eth           # Quote 100 USDC Solana → Ethereum
/bridge quote 1000 USDC arb to base         # Quote Arbitrum → Base
/bridge quote 50 USDC eth to sol            # Quote Ethereum → Solana

Execute Transfer

/bridge send 100 USDC sol to eth            # Send 100 USDC Solana → Ethereum
/bridge send 1000 USDC arb to base          # Send Arbitrum → Base
/bridge send 50 USDC eth to sol --address <dest>  # To specific address

Redeem (Claim)

/bridge redeem <tx-hash>                    # Claim transferred tokens
/bridge pending                             # List pending redemptions

Status

/bridge status <tx-hash>                    # Check transfer status
/bridge history                             # View transfer history

TypeScript API Reference

Wormhole Bridge

import { executeWormholeBridge, executeWormholeRedeem } from 'clodds/bridge/wormhole';

// Get quote
const quote = await getWormholeQuote({
  sourceChain: 'solana',
  destChain: 'ethereum',
  token: 'USDC',
  amount: 100,
});

console.log(`Transfer 100 USDC: Solana → Ethereum`);
console.log(`Fee: $${quote.fee}`);
console.log(`Est. time: ${quote.estimatedTime} seconds`);

// Execute transfer
const transfer = await executeWormholeBridge({
  sourceChain: 'solana',
  destChain: 'ethereum',
  token: 'USDC',
  amount: 100,

  // Source wallet
  sourcePrivateKey: process.env.SOLANA_PRIVATE_KEY,

  // Destination address (optional, defaults to your address)
  destAddress: '0x1234...',
});

console.log(`Transfer initiated: ${transfer.txHash}`);
console.log(`VAA: ${transfer.vaa}`);
console.log(`Status: ${transfer.status}`);

// Redeem on destination chain
const redeem = await executeWormholeRedeem({
  destChain: 'ethereum',
  vaa: transfer.vaa,
  destPrivateKey: process.env.EVM_PRIVATE_KEY,
});

console.log(`Redeemed: ${redeem.txHash}`);
console.log(`Amount received: ${redeem.amount} USDC`);

CCTP (Circle) Bridge

import { executeCCTPBridge, redeemCCTP } from 'clodds/bridge/cctp';

// CCTP is optimized for USDC transfers
const transfer = await executeCCTPBridge({
  sourceChain: 'arbitrum',
  destChain: 'base',
  amount: 1000,  // USDC

  sourcePrivateKey: process.env.EVM_PRIVATE_KEY,
  destAddress: '0x1234...',
});

console.log(`CCTP transfer: ${transfer.txHash}`);
console.log(`Message: ${transfer.messageHash}`);

// Wait for attestation (usually ~15 minutes)
await waitForAttestation(transfer.messageHash);

// Redeem
const redeem = await redeemCCTP({
  destChain: 'base',
  messageHash: transfer.messageHash,
  destPrivateKey: process.env.EVM_PRIVATE_KEY,
});

Check Status

import { getTransferStatus } from 'clodds/bridge';

const status = await getTransferStatus(txHash);

console.log(`Status: ${status.status}`);
// 'pending' | 'confirming' | 'attesting' | 'redeemable' | 'completed' | 'failed'

console.log(`Source confirmations: ${status.sourceConfirmations}`);
console.log(`VAA status: ${status.vaaStatus}`);
console.log(`Redeemed: ${status.redeemed}`);

if (status.status === 'redeemable') {
  console.log(`Ready to redeem! VAA: ${status.vaa}`);
}

Get Pending Redemptions

import { getPendingRedemptions } from 'clodds/bridge';

const pending = await getPendingRedemptions({
  chains: ['ethereum', 'solana', 'arbitrum'],
  address: myAddress,
});

for (const p of pending) {
  console.log(`${p.sourceChain} → ${p.destChain}`);
  console.log(`  Amount: ${p.amount} ${p.token}`);
  console.log(`  Status: ${p.status}`);
  console.log(`  Age: ${p.age} minutes`);
}

Transfer Flow

Wormhole

Lock tokens on source chain
Wait for confirmations (varies by chain)
Guardian attestation (VAA generation)
Redeem on destination chain

CCTP

Burn USDC on source chain
Wait for attestation (~15 min)
Mint USDC on destination chain

Fees & Times

Route	Fee	Time
Solana → Ethereum	~$5	15-20 min
Ethereum → Solana	~$20	15-20 min
Arbitrum → Base (CCTP)	~$0.50	15-20 min
Polygon → Arbitrum	~$1	15-20 min

Best Practices

Use CCTP for USDC - Faster and cheaper
Check gas prices - High gas can increase costs
Save VAA/message hash - Needed for redemption
Monitor pending transfers - Don't forget to redeem
Start with small amounts - Test before large transfers
Verify destination address - Double-check before sending

Chain	Wormhole	CCTP (USDC)
Solana	Yes	Yes
Ethereum	Yes	Yes
Polygon	Yes	Yes
Arbitrum	Yes	Yes
Optimism	Yes	Yes
Avalanche	Yes	Yes
Base	Yes	Yes

bridge

Bridge - Complete API Reference

Supported Chains

Chat Commands