CharlesMfouapon/pan-african-fx-grid

Decentralized FX liquidity mesh for African currency markets. Cross-border arbitrage detection, mobile money settlement, Byzantine fault-tolerant consensus on MTN/Moov/Orange Money rails. --- # Pan-African FX Grid **Decentralized foreign exchange liquidity mesh for African currency markets.** African FX markets are structurally different from Western markets. Fragmented liquidity. Mobile money rails. Parallel market dynamics. This protocol is purpose-built for those realities. ## The Problem | Western FX | African FX | |---|---| | Centralized ECNs | Mobile money fragmentation | | SWIFT settlement | Provider-specific APIs | | Deep liquidity pools | Thin, fragmented markets | | Sub-microsecond latency | Variable connectivity | | Single exchange rate | Official/parallel spread | ## Architecture ``` UEMOA Fragment ←→ WAMZ Fragment ←→ EAC Fragment ↑ ↑ ↑ └────────────────┴────────────────┘ │ Arbitrage Detection (Bellman-Ford cycles) │ Mobile Money Settlement (MTN | Orange | M-Pesa | Wave) │ BFT Consensus Layer (Rate attestation + settlement proof) ``` ## Key Components | Component | Language | Description | |---|---|---| | Arbitrage Engine | Rust | Bellman-Ford negative cycle detection across currency digraph | | Rate Oracle Network | Rust | Median-based aggregation with modified z-score outlier rejection | | Quant Models | Python | Market simulation, volatility surfaces, regime detection | | Settlement Adapter | Rust | Mobile money API integration layer | | Dashboard | TypeScript | Real-time visualization of liquidity mesh | ## Supported Currencies XOF XAF NGN GHS KES UGX TZS RWF ZAR ETB EGP MAD ## Supported Mobile Money Providers MTN Mobile Money | Orange Money | M-Pesa | Wave | Moov Money ## Quick Start ```bash # Build the arbitrage engine cargo build --release # Run tests cargo test # Run benchmarks cargo bench # Generate personalized badges python scripts/generate_badges.py ``` ## Research Read the Protocol Specification for the complete architectural design, threat model, and performance targets. Author: Charles Mfouapon Building financial infrastructure for African markets.