Skip to main content

Bridge Contracts

View the bridge contract source code

Audit Reports

Trail of Bits audit and Perimeter fuzzing reports

​
Bridge Options

BridgeTypeSpeedBest For
Canonical BridgeNative (Axelar)15-30 minLarge amounts, highest security
LayerSwapLiquidity NetworkMinutesFast transfers
SquidAggregatorMinutesMulti-chain routing
The canonical bridge currently uses Axelar for cross-chain messaging, with plans to add ZK proofs in the future for enhanced security.

​
Bridge UIs

Immutable Play

Best interface for Passport wallets

Toolkit

Canonical bridge for advanced users

​
Canonical Bridge

The canonical bridge enables secure asset transfers between Ethereum (L1) and Immutable Chain (L2).

​
Supported Assets

AssetL1 → L2L2 → L1
ETH✅✅
IMX✅✅
USDC✅✅
USDT✅✅
wBTC✅✅
any mapped ERC-20✅✅

​
How It Works

Deposit (L1 → L2): ~15-30 minutes
  1. Call the bridge contract on Ethereum with the asset and destination
  2. Wait for L1 confirmation and Axelar relay
  3. Assets appear in your L2 wallet
Withdrawal (L2 → L1): Up to 24 hours (see Flow Rate Parameters)
  1. Call the bridge contract on Immutable Chain
  2. Wait for message relay
  3. Claim on Ethereum

​
Flow Rate Parameters

The bridge implements safety mechanisms to protect against exploits:
TokenFlow-Rate Capacity (4-Hour Window)Large Withdrawal Threshold
ETH14829.60
IMX539,052107,230
USDC372,00074,000
USDT372,00074,000
wBTC3.370.67
GODS2,310,559459,627
GOG9,386,8281,867,272
Large withdrawals exceeding the threshold are queued for 24 hours. If total withdrawals in a 4-hour window exceed the flow rate capacity, all withdrawals are queued until manually reviewed.

​
Bridge Contract Addresses

​
Ethereum (L1)

ContractMainnetTestnet (Sepolia)
Bridge Proxy0xBa5E35E26Ae59c7aea6F029B68c6460De2d13eB60x0D3C59c779Fd552C27b23F723E80246c840100F5
Adaptor Proxy0x4f49B53928A71E553bB1B0F66a5BcB54Fd4E89320x6328Ac88ba8D466a0F551FC7C42C61d1aC7f92ab

​
Immutable Chain (L2)

ContractMainnetTestnet
Bridge Proxy0xBa5E35E26Ae59c7aea6F029B68c6460De2d13eB60x0D3C59c779Fd552C27b23F723E80246c840100F5
Adaptor Proxy0x4f49B53928A71E553bB1B0F66a5BcB54Fd4E89320x6328Ac88ba8D466a0F551FC7C42C61d1aC7f92ab

​
Token Addresses (L2)

TokenMainnetTestnet
Wrapped ETH0x52a6c53869ce09a731cd772f245b97a4401d33480xe9E96d1aad82562b7588F03f49aD34186f996478
Wrapped IMX0x3a0c2ba54d6cbd3121f01b96dfd20e99d1696c9d0x1CcCa691501174B4A623CeDA58cC8f1a76dc3439
USDC0x6de8aCC0D406837030CE4dd28e7c08C5a96a30d20x3B2d8A1931736Fc321C24864BceEe981B11c3c57
USDT0x68bcc7F1190AF20e7b572BCfb431c3Ac10A936AbTBA
Wrapped BTC0x235F9A2Dc29E51cE7D103bcC5Dfb4F5c9c3371DeTBA
GODS0xE0e0981D19eF2E0a57Cc48CA60D9454eD2D53fEBTBA
GOG0xb00ed913aAFf8280C17BfF33CcE82fE6D79e85e8TBA

​
Querying Flow Rates

You can query flow rate parameters directly from the L1 bridge contract:
  • flowRateBuckets(tokenAddress) - Returns bucket capacity and refill rate
  • largeTransferThreshold(tokenAddress) - Returns the large withdrawal threshold

Manual Bridging Guide

For programmatic bridging, see the manual bridging documentation