Flare Bridge Sentinel

Autonomous AI agent monitoring Flare's interoperable asset ecosystem — FAssets, FTSOv2, cross-chain bridges — with 8 MCP tools and real Coston2 testnet integration.

🎯 Problem

Flare's interoperability layer (FAssets, FTSO) unlocks DeFi for non-native assets like XRP. But monitoring this infrastructure requires watching multiple on-chain data sources, oracle price feeds, and bridge states in real time. No tool exists that autonomously monitors the health and risk of Flare's interoperable asset ecosystem.

✅ Solution

Flare Bridge Sentinel is an autonomous AI agent that:

1. Perceives — Pulls live data from Flare Coston2 testnet RPC: chain status, FTSOv2 oracle prices, FAsset (FXRP) bridge state, FlareContractRegistry
2. Analyzes — Runs anomaly detection heuristics on price feeds, bridge supply, gas prices, and RPC latency
3. Scores — Computes a composite 0-100 risk score from anomaly severity, feed health, and FAsset collateralization
4. Alerts — Generates severity-classified alerts with human-readable summaries and recommended actions
5. Audits — Records every scan, anomaly, and alert in a persistent audit trail

🏆 Unique Angle

Unlike generic blockchain monitors, Flare Bridge Sentinel is built specifically for Flare's interoperability layer — querying FTSOv2 oracle price feeds, FAsset (FXRP) bridge supply, and the FlareContractRegistry through 8 MCP-style tools that AI agents can call autonomously.

🏗️ Architecture

┌──────────────┐     ┌─────────────────┐     ┌──────────────────────────────┐
│   AI Agent   │────▶│  MCP Protocol    │────▶│  Flare Bridge Sentinel       │
│ (orchestrator)│     │  (8 tools)       │     │  FastAPI + Vercel Serverless │
└──────────────┘     └─────────────────┘     └──────────────┬───────────────┘
                                                            │
                              ┌─────────────────────────────┴─────────────┐
                              │                                           │
                    ┌─────────▼──────────┐              ┌─────────────────▼──────────┐
                    │  Flare Coston2 RPC  │              │   SQLite Audit Trail       │
                    │  (chainId 114)      │              │   (scans, anomalies,       │
                    │                     │              │    alerts, FTSO snapshots) │
                    │  • FTSOv2 Oracle    │              └────────────────────────────┘
                    │  • FAsset (FXRP)    │
                    │  • ContractRegistry │
                    └────────────────────┘

🔧 MCP Tools (8)

#	Tool	Description
1	get_chain_status	Live Flare Coston2 chain metadata (chainId, block, gas)
2	get_ftso_prices	Real FTSOv2 oracle prices (FLR, BTC, ETH, XRP, DOGE)
3	monitor_fasset	FAsset FXRP bridge state (supply, decimals, manager)
4	get_registry_contracts	FlareContractRegistry — all 69 protocol contracts
5	detect_anomaly	Heuristic anomaly detection on price feeds + bridge
6	calculate_risk_score	Composite 0-100 risk score
7	generate_alert	Severity-classified alert with recommendations
8	get_audit_trail	Persistent audit trail of past scans

📡 Real On-Chain Data (Verified Live)

All data is real from Flare Coston2 testnet — no mocks:

Source	Contract	Verified
Flare Coston2 RPC	https://coston2-api.flare.network/ext/C/rpc	chainId=114, block ~34M
FTSOv2 Price Feeds	0xc4e9c78ea53db782e28f28fdf80baf59336b304d	FLR=$0.006, BTC=$63.5K, ETH=$1.88K, XRP=$1.02, DOGE=$0.072
FAsset FXRP Token	0x0b6A3645d3a4885Bdb64717E2CE3B565Ea83c474	totalSupply=6,142,098 FXRP, decimals=6
AssetManager FXRP	0xc1ca88b9351D99986685920141687403d01E33dB	fAsset() → FXRP token address
FlareContractRegistry	0xaD67FE6610c43C95d9c02f4E5a44B5befB02cD69	getAllContracts() → 69 contracts

🚀 Setup (<5 commands)

git clone https://github.com/0xConsole/flare-bridge-sentinel.git
cd flare-bridge-sentinel
pip install -r requirements.txt
uvicorn app.main:app --reload
# Open http://localhost:8000

🌐 Live Demo

• Demo URL: https://flare-bridge-sentinel.vercel.app
• GitHub: https://github.com/0xConsole/flare-bridge-sentinel
• Health check: /api/health — chain status + RPC connectivity
• Autonomous sweep: /api/demo — full 6-step agent run
• MCP tools: /mcp/tools — list all 8 tools | /mcp/call?tool=get_ftso_prices — call any tool

🛠️ Tech Stack

• Python 3.12 + FastAPI
• Flare Coston2 testnet (public RPC, chainId 114)
• FTSOv2 (Flare Time Series Oracle) — real decentralized price feeds
• FAsset FXRP — real XRP bridge token on Coston2
• FlareContractRegistry — canonical protocol contract registry
• SQLite (audit trail persistence)
• Vercel serverless (free tier)
• Static HTML/CSS/JS dashboard (dark theme, no framework)

📋 What's Real vs What's Next

Component	Status
Flare Coston2 RPC	✅ Real (live block data)
FTSOv2 price feeds	✅ Real (live oracle prices)
FAsset FXRP monitoring	✅ Real (live token supply)
FlareContractRegistry	✅ Real (live contract resolution)
Anomaly detection	✅ Real (heuristic on live data)
Risk scoring	✅ Real (computed from live anomalies)
Audit trail	✅ Real (SQLite persistence)
LLM agent reasoning	🔄 Rule-based orchestration (LLM-ready: swap agent.py loop for Gemini/GPT)
Mainnet deployment	📋 Next step (Coston2 → Songbird → Flare Mainnet)

🎯 Bounty Target

Bounty 1: Interoperable Asset Products — Flare Bridge Sentinel monitors the interoperability infrastructure (FAssets, FTSO) that enables DeFi for non-native assets. It directly addresses the "interoperable asset products" focus area by monitoring the health and risk of Flare's cross-chain asset bridge.

📜 License

Apache 2.0

🔗 Links

• Flare Developer Docs: https://dev.flare.network/
• Flare Summer Signal Hackathon: https://dorahacks.io/hackathon/flaresummersignal
• MCP Protocol: https://modelcontextprotocol.io