PesaKit Mobile Money Agents to Stablecoins (USDC) Bridge: Technical Architecture

Existing PesaKit infrastructure (not funded by this grant)
New — built this grant ★
Integration Track partner ✦
External systems
Future scale phase
AGENT INTERFACE PESAKIT PLATFORM STELLAR NETWORK EXTERNAL FUTURE SCALE PHASE — post product-market fit ← EXISTING NEW — BUILT THIS GRANT → PesaKit Android App Live on Google Play · 70,000+ agents · daily mobile money transactions EXISTING Balance · airtime · loans Mobile money · bill pay NEW SCREENS ★ KES ↔ USDC conversion UI Stellar balance · tx history · yield view Stellar Web dApp ★ Prototype exists · full build this grant · Stellar balances and tx history · Conversion status and history · Analytics and yield dashboard KYC / KYB Engine · Document verification · Liveness + selfie biometric · Business KYB · Location verification · Sanctions screening 70,000+ agents already verified Payment Adapters · M-Pesa (live since 2020) · Airtel Money (live) · Telkom Kenya (live) · Bill payments · airtime Confirmation events → Bridge Controller Bridge Controller ★ · Conversion orchestration · KYC / sanctions check · Payment event handling · $100 / tx limit · KSh 100,000 / day limit · Reversal (record only; USDC recovery is a separate process) Stellar Service ★ · Horizon API client · Agent account provisioning · USDC trustline setup · Soroban contract invocations · On-chain / off-chain reconciliation · Reserve monitoring + alerting · Return handling (USDC → KES) Soroban Contract ★ · KES→USDC accounting · USDC credit / debit · On-chain limit enforce · Pause · admin controls · SCF-audited (Tranche 3) Apache 2.0 · pesakitdev/stellar Bridge Reserve ★ · 2-of-3 multisig · All keys: PesaKit-held · 1 key on hardware device · USDC in circulation ≡ KES in custody Agent Accounts ★ · One per verified agent · USDC trustline · KYC-gated — no open access · Agent-owned wallet, built into the PesaKit app, with KYC-gated access · No personal data on-chain SoroSwap ✦ Integration Track partner · Soroban DEX routing · Aquarius aggregation · USDC → LP deposits · Pool accounting per agent · Advanced agents / direct LP DeFindex ✦ Integration Track partner · Yield aggregator · Managed yield strategies · Agents: "earn yield" → DeFindex routes to pools · Simpler than direct LP Mobile Money Rails Safaricom M-Pesa · Airtel Money · Telkom Kenya KES payment confirmation events → Payment Adapters KES Reserve (Custody) KES held per USDC in circulation Bridge Controller triggers hold / release MoneyGram Cash-in/cash-out at agent locations Stellar-based diaspora remittances Integration Track partner (future) Regulatory Pathway ① Bank partnerships (MoU, licensed bank) ② Regulated remittance companies ③ PesaKit own CBK remittance licence ① conversion request verify agent KYC ② ③ invoke contract ④ USDC credited ⑤ LP deposit ⑥ earn yield future
Conversion flow — KES to USDC, yield, and reverse
Step What happens What is new with this grant
Step 1 Agent opens the app and enters a KES amount to convert to USDC Conversion UI screens — Android + web dApp ★
Step 2 Bridge Controller verifies agent KYC status and sanctions list via the existing engine; confirms KES payment via the existing adapter; enforces $100/tx and KSh 100,000/day limits; the contract enforces a USDC daily cap as a backstop Bridge Controller ★; KYC-bridge connector ★
Step 3 Stellar Service invokes the Soroban bridge contract; contract records the conversion and enforces limits on-chain.
Testnet contract: CBFVXFM4CQBJZFVRO3TLGZ75TAWIZRXNHJHEYK35YI3K7UL37BU7O3UH (Stellar testnet)
Stellar Service module ★; Soroban Bridge Contract ★; Bridge Reserve (2-of-3 multisig) ★
Step 4 USDC is credited to the agent's Stellar account; app updates to show balance and transaction hash Agent Stellar Account provisioning ★; USDC trustline setup ★
Step 5 Agent (optional) deploys held USDC into a SoroSwap liquidity pool via the bridge. SoroSwap routes across its pools and aggregates Aquarius liquidity for best rates. For agents who want direct LP control. SoroSwap integration ✦ (Integration Track partner)
Step 6 Agent (optional) activates yield on held USDC via DeFindex. DeFindex routes across yield strategies automatically — no manual pool selection. For agents who just want their idle USDC to earn. DeFindex integration ✦ (Integration Track partner)
Step 7 Agent can move USDC back to KES through the bridge Bridge Controller ★; Stellar Service module ★ (return handling)
What is not being built with this grant: M-Pesa, Airtel Money and Telkom adapters (live since 2020); bill payment integrations (live); KYC/KYB engine and agent verification (live, 70,000+ agents verified); PesaKit Android app base (live on Google Play); PesaKit backend core (live). The grant connects the new Stellar bridge layer to these existing systems — it does not rebuild them.

Aquarius: aggregated into the SoroSwap integration automatically via SoroSwap's routing — no separate engineering work required.

Future scale phase: once PesaKit achieves product-market fit on the bridge and yield products, the agent network is positioned to become a remittance hub — agents receive diaspora USDC and pay out KES cash locally. This requires MoneyGram as a Stellar Integration Track partner. Three regulatory pathways are available: (i) bank partnerships via MoU with a licensed bank; (ii) operating under a regulated remittance company; or (iii) PesaKit obtaining its own CBK remittance licence under the National Payment System Act, which PesaKit's existing regulatory track record (microfinance, insurance agency) supports. This phase is outside this grant and is subject to regulatory readiness.