jeremylongshore/tons-of-skills-marketplace / plugins/crypto/cross-chain-bridge-monitor/skills/monitoring-cross-chain-bridges
monitoring-cross-chain-bridges
VerifiedMonitor cross-chain bridge TVL, volume, fees, and transaction status across networks. Use when researching bridges, comparing routes, or tracking bridge transactions. Trigger with phrases like "monitor bridges", "compare bridge fees", "track bridge tx", "bridge TVL", or "cross-chain transfer status".
| File | Kind | Size |
|---|---|---|
| ARD.md | markdown | 5.4 KB |
| PRD.md | markdown | 2.1 KB |
| SKILL.md | skill md | 4.2 KB |
| config/settings.yaml | config | 2.6 KB |
| references/errors.md | markdown | 3.7 KB |
| references/examples.md | markdown | 7.6 KB |
| references/implementation.md | markdown | 1.5 KB |
| scripts/bridge_fetcher.py | script | 9.7 KB |
| scripts/bridge_monitor.py | script | 9.7 KB |
| scripts/config_loader.py | script | 4.3 KB |
| scripts/formatters.py | script | 9.7 KB |
| scripts/protocol_adapters.py | script | 12.4 KB |
| scripts/tx_tracker.py | script | 8.0 KB |
references/examples.md
View on GitHub# Usage Examples
## Bridge TVL Rankings
### Show Top Bridges by TVL
```bash
python bridge_monitor.py tvl
# Output:
# BRIDGE TVL RANKINGS
# ================================================================================
# Rank Bridge Total TVL Chains
# --------------------------------------------------------------------------------
# 1 Stargate $1.24B 8
# 2 Across $456.78M 6
# 3 Synapse $234.56M 15
# 4 Hop $123.45M 6
# ================================================================================
```
### TVL as JSON
```bash
python bridge_monitor.py -f json tvl --limit 5
```
## List All Bridges
### Show Bridge Rankings by Volume
```bash
python bridge_monitor.py bridges
# Output:
# CROSS-CHAIN BRIDGES
# ==========================================================================================
# Rank Bridge 24h Volume Chains Change
# ------------------------------------------------------------------------------------------
# 1 Stargate $245.67M 8 +12.34%
# 2 Across Protocol $123.45M 6 -5.67%
# 3 Synapse $98.76M 15 +8.90%
# ==========================================================================================
# Total bridges: 45
```
### Filter by Chain
```bash
# Show bridges supporting Arbitrum
python bridge_monitor.py bridges --chain arbitrum
```
## Bridge Details
### Get Detailed Bridge Info
```bash
python bridge_monitor.py detail --bridge stargate
# Output:
# BRIDGE: Stargate
# ============================================================
# Name: stargate
# ID: 1
#
# VOLUME
# ------------------------------------------------------------
# 24h Volume: $245.67M
# Previous 24h: $218.92M
# Change: +12.21%
#
# SUPPORTED CHAINS
# ------------------------------------------------------------
# ethereum, arbitrum, optimism, polygon, bsc
# avalanche, fantom, base
#
# TVL BY CHAIN
# ------------------------------------------------------------
# ethereum $456.78M
# arbitrum $234.56M
# optimism $123.45M
# ...
# Total $1.24B
# ============================================================
```
## Compare Bridge Routes
### Compare Fees for a Route
```bash
python bridge_monitor.py compare --source ethereum --dest arbitrum --amount 1000 --token USDC
# Output:
# BRIDGE FEE COMPARISON: ETHEREUM → ARBITRUM
# Amount: 1000 USDC
# ================================================================================
# Bridge Bridge Fee Gas (Total) Total Fee Time
# --------------------------------------------------------------------------------
# Across $0.4000 $0.0060 $0.4060 ~1 min
# Stargate $0.6000 $0.0150 $0.6150 ~2 min
# LayerZero $0.6000 $0.0110 $0.6110 ~3 min
# Wormhole $1.0000 $0.0070 $1.0070 ~15 min
# ================================================================================
# Cheapest: Across
# Fastest: Across
```
### Compare Large Transfer
```bash
python bridge_monitor.py compare \
--source ethereum \
--dest base \
--amount 100000 \
--token USDC
```
### Compare as JSON
```bash
python bridge_monitor.py -f json compare \
--source ethereum \
--dest arbitrum \
--amount 5000 \
--token USDC
```
## Track Transactions
### Track a Bridge Transaction
```bash
python bridge_monitor.py tx --tx-hash 0x1234...abcd
# Output:
# BRIDGE TRANSACTION STATUS
# ============================================================
# TX Hash: 0x1234...abcd
# Bridge: Stargate
# Route: ethereum → arbitrum
# Status: [OK] COMPLETED
#
# CONFIRMATION
# ------------------------------------------------------------
# Source Chain: Confirmed
# Dest Chain: Confirmed
# Amount: 1000.00 USDC
# Dest TX: 0xabcd...1234
# Timestamp: 2024-01-20 15:30:45
# ============================================================
```
### Track with Bridge Hint
```bash
# Faster tracking if you know the bridge
python bridge_monitor.py tx \
--tx-hash 0x1234...abcd \
--bridge wormhole
```
### Track with Source Chain
```bash
python bridge_monitor.py tx \
--tx-hash 0x1234...abcd \
--chain ethereum
```
## List Supported Chains
### Show All Chains
```bash
python bridge_monitor.py chains
# Output:
# SUPPORTED CHAINS
# ============================================================
# ethereum bsc polygon arbitrum
# optimism base avalanche fantom
# linea scroll zksync mantle
# ============================================================
# Total: 45 chains
```
## List Bridge Protocols
### Show Supported Protocols
```bash
python bridge_monitor.py protocols
# Output:
# SUPPORTED BRIDGE PROTOCOLS
# ============================================================
#
# Wormhole
# ----------------------------------------
# Chains: ethereum, solana, bsc, polygon, avalanche
# +15 more
#
# LayerZero
# ----------------------------------------
# Chains: ethereum, bsc, avalanche, polygon, arbitrum
# +45 more
#
# Stargate
# ----------------------------------------
# Chains: ethereum, bsc, avalanche, polygon, arbitrum
# +3 more
#
# Across
# ----------------------------------------
# Chains: ethereum, optimism, arbitrum, polygon, base
# +1 more
#
# ============================================================
# Total protocols: 4
```
## JSON Output
### Any Command with JSON
```bash
# TVL as JSON
python bridge_monitor.py -f json tvl
# Bridges as JSON
python bridge_monitor.py -f json bridges --limit 10
# Detail as JSON
python bridge_monitor.py -f json detail --bridge across
# Transaction as JSON
python bridge_monitor.py -f json tx --tx-hash 0x...
```
## Common Workflows
### Find Best Route for Large Transfer
```bash
# Compare routes
python bridge_monitor.py compare -s ethereum -d arbitrum -a 50000 -t USDC
# Check bridge liquidity
python bridge_monitor.py detail --bridge stargate
# Verify TVL is sufficient
python bridge_monitor.py tvl
```
### Monitor Bridge After Transfer
```bash
# Get tx hash from wallet/explorer, then track
python bridge_monitor.py tx --tx-hash 0x...
# If pending, check again later
watch -n 30 "python bridge_monitor.py tx --tx-hash 0x..."
```
### Research Bridge Safety
```bash
# Check bridge volume and TVL trends
python bridge_monitor.py detail --bridge synapse
# Compare with other bridges
python bridge_monitor.py bridges | head -20
```
## Integration Examples
### Python Import
```python
from bridge_fetcher import BridgeFetcher
from protocol_adapters import get_all_adapters
from tx_tracker import TxTracker
# Get bridge data
fetcher = BridgeFetcher()
bridges = fetcher.get_all_bridges()
print(f"Found {len(bridges)} bridges")
# Check TVL
for bridge in bridges[:5]:
tvl = fetcher.get_bridge_tvl(bridge.id)
print(f"{bridge.display_name}: ${tvl.total_tvl:,.0f}")
# Track transaction
tracker = TxTracker()
status = tracker.track_bridge_tx("0x...")
print(f"Status: {status.status}")
```
### Shell Script Monitoring
```bash
#!/bin/bash
# Monitor bridge TVL changes
while true; do
echo "=== $(date) ==="
python bridge_monitor.py tvl --limit 5
sleep 300 # Check every 5 minutes
done
```
---
*[Tons of Skills](https://tonsofskills.com) by [Intent Solutions](https://intentsolutions.io) | [jeremylongshore.com](https://jeremylongshore.com)*
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| add-product-e2e-evalpaperclipai/paperclipAdd or extend a Paperclip full-stack runner E2E workflow, fixture, matcher, or report evidence path for local or Daytona execution. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| add-runner-evalpaperclipai/paperclipAdd or extend a Paperclip Runner protocol evaluation definition, roster, assertion, or report fixture with provenance and narrow validation. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| diagnose-why-work-stoppedpaperclipai/paperclipCompatibility entry point for failed, stalled, looping, or over-recovered Paperclip work. Use fix-failed-paperclip-run for the full diagnosis, regression, repair, real verification, and green-PR workflow; honor an explicitly requested diagnosis-only scope. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| fix-failed-paperclip-runpaperclipai/paperclipDiagnose and fix failed, stuck, slow, or incorrectly blocked Paperclip tasks and runs. Use with a task/run URL or failure report to trace the root cause, prove a regression red then green, check second-order effects, verify the real workflow, and deliver a PR with passing checks. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |