dnzengou/africa-oracle-agent

# Africa Oracle Extraction Agent > **A resilient, sovereign, scalable, affordable alternative to foreign fiat-backed stablecoins.** > Phase 0 of the AFRI Jetton (TIP-74 on TON) — mobile-money-native price oracle for ~30 African countries. ## What it does Extracts real-time price feeds from M-Pesa, Airtel Money, Orange Money, and MTN MoMo aggregator APIs. Aggregates into a robust median price + volume-weighted spread per currency. **Quorum-protected** so a single-provider outage cannot move the published rate. ``` Mobile Money APIs (M-Pesa, Airtel, Orange, MTN) ↓ Oracle Agents (Py / Go / Sh — one per provider×country) ↓ Aggregation Layer (median · vol-weighted spread · quorum ≥ N providers) ↓ Price Feed API (FastAPI · /hunt · /feeds/all · /feeds/quorum · /feeds/stream · /metrics) ↓ AFRI Jetton (TON, TIP-74 · 120% over-collateralized) ``` ## The five pillars | Pillar | What it means | Where it lives | |---|---|---| | **Resilient** | Single-provider outage doesn't move the rate | `quorum_aggregate(min_providers=2)` · `/feeds/quorum` · polyglot ports | | **Sovereign** | African jurisdictional + operational control | `fly.toml` jnb region · `docker-compose.yml` self-host · open-source FunC | | **Scalable** | Edge + cloud, push + poll, multi-region | async `/feeds/all` · SSE `/feeds/stream` · multi-arch image · stateless | | **Affordable** | Free-tier viable, $35-hardware edge | shared-cpu-1x Fly.io · POSIX shell port on Raspberry Pi · no Redis/Postgres | | **Alternative** | Better than USDT/USDC on African settlement | mobile-money-native collateral · TON gas ~$0.005 · Telegram via TON Connect | Full value-prop + USDT/USDC comparison: see `SOVEREIGNTY.md`. ## Supported providers | Provider | Countries | Currencies | Status | |---|---|---|---| | Safaricom M-Pesa | KE, TZ, UG, RW, ZA, GH, CD, LS, MZ, SO | KES, TZS, UGX, RWF, ZAR, GHS, CDF, LSL, MZN, SOS | Simulated (v0.3.0) · Real API Phase-1 | | Airtel Money | KE, UG, RW, ZA, CD, NE, GA, CG, TD | KES, UGX, RWF, …