Concepts › Bridge
Model
Hyperlane warp route of type collateral ⇄ collateral (@hyperlane-xyz/core 12.1.0), 1 : 1 ratio, two routes:
| Route | Arbitrum One | Bitcoin Swap 482120 | |
|---|---|---|---|
| USDC | USDC (6 decimals) locked in the router | ⇄ | USDC (Bitcoin Swap) (18 decimals) released from the router's vault |
| USD₮0 | USD₮0 (6 decimals) locked in the router | ⇄ | USDC (Bitcoin Swap) (18 decimals) released from the router's vault |
Nothing is minted on either side: each router only releases what it currently holds. So withdrawals from one side can never exceed the amount locked on that side. Both routes share USDC (Bitcoin Swap) on the 482120 side but have separate vaults.
Lifecycle of a transfer
- The user calls
transferRemoteon the source-chain router — tokens are locked in the router and the Mailbox dispatches a message. - The source chain's validator signs a checkpoint for the message.
- The relayer delivers the message + signature to the destination Mailbox.
- The ISM (Interchain Security Module) on the destination chain verifies the signature: multisig message-id with a 1/1 threshold.
- The destination router releases tokens to the recipient and emits
ReceivedTransferRemote.
Usually takes 10–30 seconds. If the relayer is down, messages wait and are delivered once it restarts — sent messages are not lost.
Dedicated Hyperlane infrastructure
The Mailbox, hooks and ISM on both chains are dedicated deployments for Bitcoin Swap, not the standard Mailbox of the Hyperlane network. The bridge's validator and relayer are dedicated as well. Consequences:
- Hyperlane Explorer and public relayers do not track or deliver these messages.
- There is no interchain gas payment: call
transferRemotewithmsg.value = 0; the bridge relayer pays destination gas itself. - Bridge security = security of the validator key and the Owner key. See Trust model.
Rounding — granularity
USDC/USD₮0 have 6 decimals, USDC (Bitcoin Swap) has 18. The 482120 router only accepts amounts divisible by granularity() = 1012
(i.e. rounded to 6 decimal places); finer amounts revert with BadGranularity.
Limits and pausing
The routers are GuardedCollateralRouter — a standard warp route plus two Owner-controlled switches:
allowlistEnabled(): when on, only allowlisted wallets can send (NotAllowed). Currently off on all 4 routers — any wallet can send.paused(): halts sending (Paused). In-flight messages are not lost and are delivered after unpausing. Each chain also has a PausableHook for emergency stops at the Mailbox level.
Live state: Status. Step by step: Bridge funds.
ETH route — sealed, on the dedicated core (R-66)
Native ETH on Arbitrum One ⇄ ETH.e on Bitcoin Swap, 1 : 1, 18 decimals on both sides. It runs on the dedicated Hyperlane core of the WBTC and USDC.e routes (same Mailboxes, verifier and relayer), not on the USDC / USD₮0 core above.
| Arbitrum One | Bitcoin Swap 482120 | |
|---|---|---|
| Contract | GuardedNativeVault 0x0a3fD8b35593fB4f82Da4C110C356745Dd7CDce2 | SealedSyntheticToken ETH.e 0x72a1Ee092807B58682592543Eba7b49004e30579 |
| What happens | ETH is locked in the vault | ETH.e is minted to the recipient; sending it back burns it and the vault releases the ETH |
- ETH.e supply never exceeds the ETH locked: there is no other way to mint it, so every holder can always send ETH.e back for ETH 1 : 1 (the destination liquidity check of the USDC / USD₮0 routes does not apply).
- Sealed: each end's verifier is fixed at deployment and its counterpart was enrolled once and can never be changed; no fees. The Owner wallet keeps only pause and the allowlist. The allowlist is off — any wallet can send.
- Deposit with
msg.valueequal to the amount: the vault bridgesamount; any extra value stays in the vault and is not bridged. ETH sent to the vault with a plain transfer mints nothing and cannot be recovered. - Withdraw to a wallet: if the Arbitrum recipient is a contract that refuses ETH, the ETH.e is burned but the ETH cannot be delivered and stays in the vault.
- ETH.e trades on its own market (OracleTokenAMM, ETH/USD oracle price ± 0.3%) and through the second SwapRouter: quote API route
amm-ethe, andbest/routerfor BTCw and other tokens.
Step by step: Bridge funds → ETH.
BTCw on Arbitrum — sealed, on the dedicated core (R-68)
WBTCw on Bitcoin Swap ⇄ BTCw (ERC-20, 18 decimals) on Arbitrum One, 1 : 1. The direction is the reverse of the other routes: the asset is locked on Bitcoin Swap and the token is minted on Arbitrum. Same dedicated core (Mailboxes, verifier, relayer) as the WBTC, USDC.e and ETH routes.
| Bitcoin Swap 482120 | Arbitrum One | |
|---|---|---|
| Contract | ReserveCollateralRouter (locks WBTCw) 0xCC7184B2cAc633f5d130C2A88688e4BF8d52eBa6 | SealedSyntheticToken BTCw 0xeFf52De4F24238001fa9afAaF1aFEEf457fB8bbD |
| To Arbitrum | approve(lock, amount) on WBTCw, then transferRemote(42161, recipient, amount) on the lock router | BTCw is minted to the recipient |
| Back | the lock router releases the WBTCw to the recipient | transferRemote(482120, recipient, amount) on BTCw (no approval: it burns) |
- BTCw on Arbitrum never exceeds the WBTCw locked, and WBTCw never exceeds the WBTC locked on Arbitrum (R-54): every BTCw there is backed 1 : 1 down to WBTC.
- Open to every wallet since 8 Oct 2026 (allowlist off on both ends). Sealed like the other routes: fixed verifier, counterpart enrolled once, no fees; the Owner wallet keeps pause and the allowlist.
recipientis the address left-padded to 32 bytes. WBTCw is obtained on Bitcoin Swap, for example from the WBTCw / USDC.e pool (btcw.tech/pool).- On Arbitrum, BTCw trades on Uniswap V3: BTCw/WBTC 0.01 % (
0xA865…e04d) and BTCw/USDC 0.05 % (0xdAD5…3526).
Receive BTCw or ETHw directly
The btcw.tech/swap/#bridge page lets you pick the asset on the Bitcoin Swap side: USDC (Bitcoin Swap) (1 : 1), BTCw (swapped via OracleAMM) or ETHw (swapped via the ETHw oracle-priced vault). On deposit, USDC (Bitcoin Swap) is then swapped to BTCw/ETHw (one more transaction on 482120, which needs a little BTCw for gas); on withdrawal, BTCw/ETHw is first swapped to USDC (Bitcoin Swap) and then bridged. The bridge itself only moves USDC (Bitcoin Swap). With ETH picked on the Arbitrum side the same page offers ETH.e (1 : 1), USDC (Bitcoin Swap) (ETH.e market) or BTCw (second SwapRouter).