Context
AgenticPay uses cross-chain bridges for liquidity movement. Bridge failures can result in stuck funds and failed settlements.
Current Limitation/Problem
There is no monitoring for cross-chain bridge operations. Failed or delayed bridge messages go undetected until a user reports an issue.
Expected Outcome
A bridge monitoring service that tracks all cross-chain messages from source to destination, alerts on delays/failures, and provides a dashboard for bridge health.
Acceptance Criteria
- Track message lifecycle: initiated, confirmed on source, relayed, executed on destination
- Monitor multiple bridge providers (Wormhole, LayerZero, Axelar, custom)
- Alert when message exceeds expected delivery time (configurable per bridge)
- Detect stuck messages and provide retry/recovery actions
- Dashboard showing bridge message volume, success rate, average latency per bridge
- Historical bridge analytics with failure trend analysis
- Retry failed messages via admin API
- Gas cost tracking per bridge message
Technical Scope
backend/src/services/bridge-monitor/ - bridge monitoring service
backend/src/services/bridge-monitor/listeners/ - per-bridge event listeners
backend/src/services/bridge-monitor/alert-engine.ts - alerting logic
- Prisma:
BridgeMessage, BridgeAlert, BridgeRetry models
- Frontend:
/dashboard/monitoring/bridges - bridge monitoring UI
- Edge cases: chain reorganization, gas price spikes, bridge downtime, message expiry
Context
AgenticPay uses cross-chain bridges for liquidity movement. Bridge failures can result in stuck funds and failed settlements.
Current Limitation/Problem
There is no monitoring for cross-chain bridge operations. Failed or delayed bridge messages go undetected until a user reports an issue.
Expected Outcome
A bridge monitoring service that tracks all cross-chain messages from source to destination, alerts on delays/failures, and provides a dashboard for bridge health.
Acceptance Criteria
Technical Scope
backend/src/services/bridge-monitor/- bridge monitoring servicebackend/src/services/bridge-monitor/listeners/- per-bridge event listenersbackend/src/services/bridge-monitor/alert-engine.ts- alerting logicBridgeMessage,BridgeAlert,BridgeRetrymodels/dashboard/monitoring/bridges- bridge monitoring UI