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
```
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 {baseDir}/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
   ```

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-has