Cross-Chain Bridge Monitor
Overview
Monitor cross-chain bridge activity across multiple protocols. Track TVL, compare fees and transfer times, and monitor transaction status for bridges like Stargate, Across, Wormhole, and LayerZero.
Prerequisites
Before using this skill, ensure you have:
- Python 3.8+ with
requestslibrary - Internet access for DefiLlama and bridge APIs
- Optional: Custom RPC URLs for on-chain verification
Commands
tvl - Bridge TVL Rankings
python bridge_monitor.py tvl --limit 20Shows bridges ranked by Total Value Locked.
bridges - List All Bridges
python bridge_monitor.py bridges
python bridge_monitor.py bridges --chain arbitrumLists bridges by 24h volume with optional chain filter.
detail - Bridge Details
python bridge_monitor.py detail --bridge stargateShows detailed info including volume, chains, and TVL breakdown.
compare - Compare Routes
python bridge_monitor.py compare --source ethereum --dest arbitrum --amount 1000 --token USDC # 1000: 1 second in msCompares fees and transfer times across bridges for a route.
tx - Track Transaction
python bridge_monitor.py tx --tx-hash 0x...
python bridge_monitor.py tx --tx-hash 0x... --bridge wormholeTracks bridge transaction status across protocols.
chains - List Chains
python bridge_monitor.py chainsShows all supported chains.
protocols - List Protocols
python bridge_monitor.py protocolsShows supported bridge protocols with their chains.
Instructions
- Check bridge TVL rankings:
cd ${CLAUDE_SKILL_DIR}/scripts python bridge_monitor.py tvl - Compare bridge routes before transferring:
python bridge_monitor.py compare -s ethereum -d base -a 5000 -t USDC # 5000: bridge transfer amount in USD - Get bridge details for research:
python bridge_monitor.py detail --bridge across - Track a transaction:
python bridge_monitor.py tx --tx-hash 0x1234... - Export to JSON for analysis:
python bridge_monitor.py -f json bridges > bridges.json
Supported Bridges
| Bridge | Type | Avg Time | Typical Fee |
|---|---|---|---|
| Wormhole | Messaging | ~15 min | ~0.1% |
| LayerZero | Messaging | ~3 min | ~0.06% |
| Stargate | Liquidity | ~2 min | ~0.06% |
| Across | Liquidity | ~1 min | ~0.04% |
Supported Chains
- Ethereum, BSC, Polygon, Arbitrum, Optimism
- Base, Avalanche, Fantom, Solana (Wormhole)
- 45+ total chains via DefiLlama
Output
- TVL rankings: Bridges sorted by locked value
- Fee comparison: Side-by-side fee and time estimates
- TX status: Source/destination confirmation status
- JSON format: Structured data with
-f jsonflag
Error Handling
See ${CLAUDE_SKILL_DIR}/references/errors.md for comprehensive error handling including:
- API unavailability and fallback behavior
- Transaction tracking edge cases
- Rate limiting mitigation
Examples
See ${CLAUDE_SKILL_DIR}/references/examples.md for detailed examples including:
- Finding best route for large transfers
- Monitoring transactions after bridging
- Research workflows for bridge safety
Resources
- DefiLlama Bridges - Bridge TVL and volume
- Wormhole Scan - Wormhole transaction explorer
- LayerZero Scan - LayerZero message explorer
- Across Protocol - Optimistic bridge