Cross-Chain Bridge Monitor

WHAT IT DOES

This tool provides real-time monitoring for any EVM cross-chain bridge contract. It reads on-chain data including bridge status (active/paused), native and token balances held by the bridge, recent deposit and withdrawal events, and liquidity levels. You can track bridge activity, verify that funds are flowing correctly, and detect unusual patterns. The tool queries the bridge contract directly via your wallet's RPC provider, giving you unfiltered access to on-chain data without relying on third-party dashboards or APIs. It's designed for users who want to independently verify bridge operations, liquidity providers monitoring their positions, or anyone concerned about bridge security and activity.

HOW TO USE

Connect your wallet using the BGWallet bridge and select the network where your bridge contract is deployed. Enter the bridge contract address and optionally a token address to track. Click "Monitor bridge status" to check the contract's paused state, fee rate, owner, native balance, and token balance. Click "Fetch recent events" to retrieve the latest deposit, withdrawal, and transfer events from the bridge. Click "Check liquidity" to view detailed liquidity information including native and token balances, and token metadata. All queries are executed directly against the blockchain via your wallet's RPC provider — no intermediaries.

TECHNICAL MECHANISM

The tool uses ethers.js v5.7.2 to interact with the blockchain via BGWallet's provider. It reads bridge contract state using standard interfaces (paused(), fee(), owner()) and token balances using balanceOf(). The critical feature is the automatic log chunking with halving: when fetching events, the tool walks backwards from the current block and requests logs in chunks. If the RPC provider returns a limit error (code -32005 or "too many results"), it halves the chunk size and retries. This ensures scans complete even on public RPC endpoints with restrictive eth_getLogs caps. The tool also supports fetching events by specific topics (Deposit, Withdrawal, Transfer) and aggregates them for a complete picture of bridge activity. All BigNumber values are converted to strings for readability in the results.

WHAT IT CANNOT SEE

This tool cannot verify the security or solvency of the bridge protocol itself. It cannot detect off-chain validator behavior, malicious activity that doesn't appear on-chain, or compromised validator keys. It cannot verify bridge oracle data, external price feeds, or the actual assets backing the bridge tokens. It cannot detect if the bridge contract has been upgraded to a malicious version (unless the upgrade is on-chain and visible). It cannot predict future bridge failures or identify social engineering attacks. The tool only reads on-chain state — if the bridge is exploited through off-chain means, the tool will not flag it as suspicious. You are responsible for understanding the bridge's security model and verifying its trust assumptions.

PLEASE NOTE

EVM chains only. Supports Ethereum, Optimism, BNB Chain, Polygon, Fantom, zkSync, Arbitrum, Avalanche, Base, Linea, and others with standard JSON-RPC support. Does not support Solana, Tron, Starknet, SUI, TON, Aptos, Bitcoin, Cosmos, or XRP. Requires a wallet connected via BGWallet to provide the RPC provider. The tool is read-only and does not sign any transactions. Always verify the bridge contract address independently before monitoring.