CharlesMfouapon/agentic-liquidity-router

Autonomous AI agent for cross-border payment routing across African mobile money rails and onchain liquidity. Real-time optimization for cost, speed, and reliability. # Agentic Liquidity Router **Autonomous AI agent for cross-border payment routing across African mobile money rails and onchain liquidity.** Not a chatbot. Not a simple swap widget. An agent that observes real-time rates, reasons about optimal paths, and routes value across the most complex payment corridors in the world. ## The Problem Sending money between African countries is expensive, slow, and opaque. A payment from Nigeria to Cote d'Ivoire might route through: - NGN → USDT on Binance P2P - USDT → XOF via MTN Mobile Money - Alternatively: NGN → USD via bank wire → XOF via Orange Money Each path has different fees, settlement times, and reliability. The optimal route changes by the hour. ## How It Works User Intent │ ▼ ┌─────────────────────────────┐ │ Rate Fetcher │ │ MTN │ Orange │ M-Pesa │ │ Uniswap │ Curve │ Binance │ └──────────┬──────────────────┘ │ ▼ ┌─────────────────────────────┐ │ AI Agent (Claude 3.5) │ │ Observes rates │ │ Reasons about context │ │ Evaluates routes │ │ Returns optimal path │ └──────────┬──────────────────┘ │ ▼ ┌─────────────────────────────┐ │ Routing Decision │ │ Route + Fee + ETA + Risk │ │ Confidence score │ │ Alternatives │ └─────────────────────────────┘ ## Supported Corridors | Corridor | Providers | Avg Fee | Settlement | |---|---|---|---| | Nigeria → Cote d'Ivoire | MTN, Orange, Binance P2P | 1.5-3% | 1-10 min | | Kenya → Uganda | M-Pesa, Wave | 1-2% | 1-3 min | | Ghana → South Africa | MTN, Bank wire | 2-4% | 5-30 min | | USDC → XOF | Uniswap + Orange | 0.5-2% | 30 sec - 3 min | ## Tech Stack | Component | Technology | |---|---| | Agent framework | Rig (Rust) | | Reasoning | Claude 3.5 Sonnet | | Rate data | Provider APIs + Alchemy | | Demo frontend | Next.js + OnchainKit | | Simulation | Tenderly dry-run | ## Quick Start ```bash # Clone git clone github.com cd agentic-liquidity-router # Run demo (no API keys needed) cargo run --example demo # Run with AI (req …