Bridge Overview
How the Xhavic bridge works — deposits, withdrawals, supported assets, and architecture.
The Xhavic bridge enables asset transfers between Ethereum (L1) and Xhavic (L2). It uses a lock-and-mint mechanism secured by Ethereum’s settlement layer.
Deposits (L1 → L2)
- Send ETH or ERC-20 tokens to the bridge contract on Ethereum
- The bridge contract locks the assets and emits a deposit event
- The relayer detects the deposit and queues a minting instruction on L2
- WETH or the L2 token equivalent is minted on Xhavic
- Deposit typically completes within minutes
Note: ETH becomes WETH (an ERC-20 token) on Xhavic for replay protection.
Withdrawals (L2 → L1)
Standard Withdrawal (7-day)
- Initiate withdrawal on L2 — tokens are burned
- Wait for the L2 batch to post on Ethereum
- Generate a Merkle inclusion proof (
xhv_getWithdrawalProof) - Wait the 7-day challenge period
- Execute the withdrawal on L1 to claim your assets
Fast Exit (via Liquidity Provider)
For users who need immediate L1 liquidity:
- Initiate withdrawal on L2
- A liquidity provider pays you on L1 immediately (minus a fee)
- The LP claims the standard withdrawal after the 7-day period
Cross-Chain Messaging
Beyond asset transfers, the bridge supports arbitrary message passing between L1 and L2 for cross-chain contract calls and governance actions.