monitoring-cross-chain-bridges

# 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 `requests` library
- Internet access for DefiLlama and bridge APIs
- Optional: Custom RPC URLs for on-chain verification

## Commands

### tvl - Bridge TVL Rankings
```bash
python bridge_monitor.py tvl --limit 20
```
Shows bridges ranked by Total Value Locked.

### bridges - List All Bridges
```bash
python bridge_monitor.py bridges
python bridge_monitor.py bridges --chain arbitrum
```
Lists bridges by 24h volume with optional chain filter.

### detail - Bridge Details
```bash
python bridge_monitor.py detail --bridge stargate
```
Shows detailed info including volume, chains, and TVL breakdown.

### compare - Compare Routes
```bash
python bridge_monitor.py compare --source ethereum --dest arbitrum --amount 1000 --token USDC  # 1000: 1 second in ms
```
Compares fees and transfer times across bridges for a route.

### tx - Track Transaction
```bash
python bridge_monitor.py tx --tx-hash 0x...
python bridge_monitor.py tx --tx-hash 0x... --bridge wormhole
```
Tracks bridge transaction status across protocols.

### chains - List Chains
```bash
python bridge_monitor.py chains
```
Shows all supported chains.

### protocols - List Protocols
```bash
python bridge_monitor.py protocols
```
Shows supported bridge protocols with their chains.

## Instructions

1. **Check bridge TVL rankings**:
   ```bash
   cd ${CLAUDE_SKILL_DIR}/scripts
   python bridge_monitor.py tvl
   ```

2. **Compare bridge routes** before transferring:
   ```bash
   python bridge_monitor.py compare -s ethereum -d base -a 5000 -t USDC  # 5000: bridge transfer amount in USD
   ```

3. **Get bridge details** for research:
   ```bash
   python bridge_monitor.py detail --bridge across
   ```

4. **Track a transaction**:
   ```bash
   python bridge_monitor.py tx --tx-hash 0x1234...
   ```

5. **Export to JSON** for analysis:
   ```bash
   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 json` flag

## 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](https://defillama.com/bridges) - Bridge TVL and volume
- [Wormhole Scan](https://wormholescan.io/) - Wormhole transaction explorer
- [LayerZero Scan](https://layerzeroscan.com/) - LayerZero message explorer
- [Across Protocol](https://across.to/) - Optimistic bridge