Canonical Bridge Deposit Tool

WHAT IT DOES

Canonical Bridge Deposit Tool enables users to deposit tokens into canonical bridge contracts for secure cross-chain transfers between L1 and L2 networks. The tool reads your connected wallet address, the bridge contract address, token addresses, token decimals, token balances, current gas prices, bridge fee rates, destination chain ID, recipient address, and deposit amount. It automatically handles ERC-20 approvals, estimates gas costs, and provides a detailed review screen before you confirm. Whether depositing native currency or ERC-20 tokens, the tool manages the entire deposit workflow—approving token spend, initiating the bridge deposit, and confirming the transaction. It also displays your current balance, the bridge fee, and estimated gas costs so you know exactly what you're paying.

HOW TO USE

Connect your wallet and select your network. Enter the canonical bridge contract address, the token address (or leave empty for native currency), the destination chain ID (e.g., 10 for Optimism, 42161 for Arbitrum), the recipient address on the destination chain, and the deposit amount. Click "Fetch bridge status" to load your token balance, the bridge fee, and a gas estimate. Review all details carefully—the tool shows your balance, the fee, the recipient, and the estimated gas cost. Click "Deposit via bridge" to approve token spend (if needed) and execute the deposit transaction. The tool will handle the approval and deposit in sequence, showing you the transaction hash and confirmation status.

THE REAL MECHANISM — SEQUENTIAL APPROVAL AND DEPOSIT WITH GAS ESTIMATION

Unlike simple transfer tools, this tool implements a two-phase deposit workflow with proper fee handling. It first checks whether the token is native currency (zero address) or an ERC-20. For ERC-20 deposits, it reads the token's decimals and balance, then checks the allowance for the bridge contract. If allowance is insufficient, it triggers an approval transaction for the exact deposit amount—never an unlimited approval. For native currency deposits, it checks that the user's balance covers both the deposit amount and the estimated gas cost, deducting the fee from the same balance. The tool then calls the bridge's deposit function with the token address, deposit amount, destination chain ID, and recipient address. For native deposits, it includes the deposit amount as msg.value. The bridge fee is read live from the bridge contract's fee() function, and gas costs are estimated using the provider's fee data with receipt.effectiveGasPrice for accurate cost reporting. The entire flow respects EIP-1559 pricing, and the tool calculates totals per sender—checking that the balance covers the deposit plus gas fees for native currency, and the token balance covers the deposit for ERC-20 transfers.

WHAT IT CANNOT SEE

Cannot verify off-chain bridge security—this tool has no visibility into the bridge's validator set, security audits, or vulnerability history. It cannot ensure message relayer reliability—it cannot guarantee that relayers will pick up and forward the deposit message to the destination chain. It cannot predict cross-chain finality times—the tool cannot estimate how long the deposit will take to finalize on the destination chain. It cannot detect if the bridge contract contains vulnerabilities or malicious code—the tool does not audit the bridge logic. It cannot recover funds if the bridge fails or if the destination chain's bridge contract differs.

PLEASE NOTE — EVM CHAINS ONLY

This tool exclusively supports EVM-compatible chains where ethers.js can connect via standard JSON-RPC. It does not support non-EVM chains such as Solana, Tron, Starknet, SUI, TON, Aptos, Bitcoin, Cosmos, or XRP. The bridge contract must implement the specific interface expected by this tool (deposit, fee). Always test with small amounts on a testnet before depositing mainnet value. This tool is a bridge deposit interface, not a financial advisor or security auditor. Cross-chain transfers carry inherent risks—review the bridge's documentation and security guarantees before use.