alsk1992/bridge

Bridge - Complete API Reference

Transfer tokens across chains using Wormhole and Circle CCTP protocols.

Supported Chains

| 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 |

---

Chat Commands

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

1. Lock tokens on source chain
2. Wait for confirmations (varies by chain)
3. Guardian attestation (VAA generation)
4. Redeem on destination chain

CCTP

1. Burn USDC on source chain
2. Wait for attestation (~15 min)
3. 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

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