Afro-Pay/AfroPay-Stellar

**AfroPay-Stellar** is a cross-border remittance platform built on the Stellar blockchain. It provides fast, low-cost, and secure global money transfers, with a focus on Africa and Nigeria. # AfroPay-Stellar > Cross-border remittance platform built on the Stellar blockchain — fast, low-cost, and Africa-focused. **Live demo:** afro-pay-stellar.vercel.app --- ## Table of Contents - Overview - Feature Matrix - Architecture - Tech Stack - Project Structure - Getting Started - Environment Variables - Running Tests - Docker - Roadmap - Contributing - License --- ## Overview AfroPay-Stellar simplifies international money transfers by leveraging the Stellar blockchain: - **Near-instant settlement** — transactions confirm in 3–5 seconds - **Low fees** — Stellar's base fee model keeps transfer costs minimal - **Multi-currency** — supports NGN, USD, EUR, and USDC - **Africa-first** — designed around the Nigerian Naira and broader African remittance corridors - **Fiat rails** — deposit and withdrawal flows via Stellar anchor network --- ## Feature Matrix This table captures the current state of the platform and what is planned next. The project is **active and in testnet**. ### ✅ Implemented | Area | Feature | Notes | |---|---|---| | **Authentication** | JWT-based login & registration | `apps/api/src/auth` | | **Authentication** | Password hashing (bcrypt) | Integrated in auth service | | **Wallet** | Stellar wallet generation | Keypair created on user registration | | **Wallet** | Encrypted private key storage | AES encryption at rest in PostgreSQL | | **Wallet** | Balance tracking (XLM, USDC, NGN) | Queried from Stellar Horizon | | **Wallet** | Trustline management | Checked before transfers | | **Transfers** | Multi-currency send (XLM, USDC, NGN) | Via Stellar path payments | | **Transfers** | Real-time FX rate fetch | Pre-transfer quote via Horizon | | **Transfers** | Transfer simulation (dry-run) | `transfer-simulation.service.ts` — validates path, fees, trustlines without submitting | | **Transaction Engine** | Async job queue | Redis + BullMQ decouples API from settlement | | **Transaction Engine** | Stellar transaction s …