Cross-Chain Bridge

CalixBridge uses a lock-and-release model to move assets between Calix Chain and external networks. A Go relayer monitors on-chain events and finalizes transfers on the destination chain.

Architecture

The bridge operates in two steps:

1. User calls bridgeOut (or bridgeOutNative) on the source chain — assets are locked in the contract and a BridgeOut event is emitted.
2. The relayer detects the event, waits for finality, then calls bridgeIn on the destination chain to release or mint the equivalent assets.

Supported Assets & Destinations

Security Model

• Multi-relayer allowlist — only approved relayer addresses can call bridgeIn
• Nonce deduplication — each outbound nonce can only be finalized once, preventing replay
• nonReentrant guard on all state-changing functions
• Daily limits per asset to cap worst-case exploit exposure
• Pause — owner can halt all bridge operations in an emergency

Sending Assets

ERC-20 tokens

// Approve bridge first
await token.approve(bridgeAddress, amount);

// Bridge out to Ethereum
await bridge.bridgeOut(
  tokenAddress,
  amount,
  destinationChainId,   // e.g. 1 for Ethereum mainnet
  recipientAddress      // hex address on destination
);

Native CLX

await bridge.bridgeOutNative(
  destinationChainId,
  recipientAddress,
  { value: ethers.parseEther("10") }
);