CORLENS

AI-powered corridor health atlas & autonomous compliance agent for XRPL - mapping 2,436 live fiat corridors, routing capital safely, and generating audit-grade reports. Live at cor-lens.xyz

Demo Video

Project Information

At a Glance

AI-powered corridor health atlas & autonomous compliance agent for XRPL - mapping 2,436 live fiat corridors, routing capital safely, and generating audit-grade reports. Live at cor-lens.xyz

Description

CORLens is the first public corridor health catalogue for XRPL cross-border payments, paired with an autonomous AI agent that routes capital through it safely.

The problem: Institutions cannot audit the XRPL payment infrastructure before committing capital. Ripple's Liquidity Hub is partner-only. Chainalysis covers sanctions, not corridor health. XRPScan shows trust lines but doesn't know what a corridor is.

Corridor Atlas — 2,436 live fiat corridors across 48 currencies

All on-chain data is fetched in real time via QuickNode XRPL WebSocket endpoints. Every corridor is classified by how it settles on XRPL:

  • XRPL-native (42 corridors) — live IOU orderbooks on the DEX via GateHub and Bitstamp. We run path_find against the live ledger every hour via QuickNode.
  • Hybrid — on-chain IOUs exist but are dead. Real flow runs through off-chain partners and RLUSD.
  • Off-chain bridge (2,322 corridors) — settlement flows through real-world partners (CEXes, ODL partners, banks) holding RLUSD or XRP on XRPL.

Each corridor page shows AI commentary, 30-day status sparkline, actor registry with ODL/RLUSD badges, live measured orderbook depth from Bitso, and a partner flow graph.

Safe Path AI Agent — 7 custom tools

Pick two currencies and an amount. The agent uses 7 tools we built specifically for it: corridor resolution, deep entity analysis (BFS crawl + RAG indexing), web research, partner depth fetching, on-chain path analysis via QuickNode's path_find, split routing computation, and compliance report generation. It crawls every hop account for risk flags (clawback, global freeze, deep freeze), proposes split routing for large amounts, and generates a downloadable compliance report. The entire run streams live via SSE — tool calls, reasoning steps, path acceptances and rejections visible in real time.

Entity Audit

Paste any XRPL address. The same BFS crawler the Safe Path Agent uses runs standalone and produces an interactive knowledge graph: 18 node types, 19 edge types, 21 risk flags. All account data crawled live from XRPL mainnet via QuickNode.

Public REST API + MCP Server

6 REST endpoints exposing every corridor, status, and actor as JSON. A downloadable MCP server with 7 tools for Claude Desktop and Claude Code — AI agents can query CORLens programmatically.

What makes it special:

  • No competitor exists — no public tool maps XRPL fiat corridors as a classified, actor-annotated, live-status catalogue
  • Three-type corridor classification covers the 95% of corridors that ledger-only tools miss (the off-chain RLUSD bridge layer)
  • Live measured orderbook depth from Bitso — 350k XRP bid, 6bps spread, refreshed every 60 seconds

here are the slide but we intend to use our website has demo - Slide : https://docs.google.com/presentation/d/1SGE2QhuQLQ12GqszPw615uW81fUfgL3j35qbIEEg_Uc/edit?usp=sharing

Technical Details

TypeScript monorepo (pnpm): React 18 + Vite + TailwindCSS frontend, Express.js backend, MCP server. QuickNode as main RPC provider — XRPL WebSocket (50 req/s, rate-limited) feeds a BFS crawler (depth 1-3, 60 accounts max, 4 concurrency). Graph visualization with ReactFlow (18 node kinds, 19 edge kinds). Risk engine: 21 flags including XLS-77 deep freeze and XLS-73 AMM clawback. 2,436 corridors in PostgreSQL with hourly BullMQ refresh running path_find, book_offers, amm_info, gateway_balances against mainnet via QuickNode. 3 RAG indexes (corridor atlas, single corridor, entity analysis) via pgvector + OpenAI text-embedding-3-small (1536-dim). Safe Path Agent: OPEN AI model with 7 custom tools, SSE streaming. Wallet auth via Crossmark SDK with XRP payment for premium access on XRPL testnet. Infra: PostgreSQL + pgvector, Redis + BullMQ, Nginx, Docker Compose.

Team

2
FB

Florent Belotti

JD

Jean-Baptiste Durand

Hackathon

HACK THE BLOCK 2026 Paris Blockchain Week XRPL Hackathon

Duration

Apr 11, 6:30 AM - Apr 12, 6:00 PM UTC

View Hackathon Details