modrispath/Stellar-Remittance

Cross-border payments in Africa are: Expensive (5%–15% fees) Slow (often takes days) Controlled by intermediaries Hard for the unbanked population Millions depend on remittances but lose money to fees and delays. # 🌍 Stellar Remittance > The fastest and cheapest way to send money across Africa — powered by Stellar & Soroban. ## Overview Stellar Remittance is a fast, low-cost cross-border payment platform built on Stellar and Soroban smart contracts. It enables users to send money instantly across African countries with near-zero fees. ## Architecture ``` stellar-remittance/ ├── apps/ │ ├── mobile/ # React Native mobile app │ └── web/ # React web dashboard ├── backend/ # Node.js/Express API ├── contracts/ # Soroban smart contracts (Rust) ├── packages/ │ └── shared/ # Shared types & utilities └── docker-compose.yml ``` ## Tech Stack - **Blockchain**: Stellar Network + Soroban smart contracts - **Mobile**: React Native - **Web**: React + Vite - **Backend**: Node.js + Express + TypeScript - **Database**: Firebase / PostgreSQL - **Smart Contracts**: Rust (Soroban SDK) ## Smart Contracts | Contract | Purpose | |---|---| | `escrow` | Holds funds until transfer conditions are met | | `fee_engine` | Automatically deducts platform fees (0.1–0.5%) | | `currency_swap` | Handles NGN, GHS, XLM swaps | | `agent_settlement` | Supports local cash-in/cash-out agents | ## Getting Started ### Prerequisites - Node.js >= 18 - Rust + Cargo - Stellar CLI (`stellar`) - React Native environment (for mobile) ### Install ```bash # Install all dependencies npm install # Backend cd backend && npm install # Web cd apps/web && npm install # Mobile cd apps/mobile && npm install ``` ### Environment Variables Copy `.env.example` to `.env` in each app and fill in your keys. ### Run locally ```bash # Backend API cd backend && npm run dev # Web dashboard cd apps/web && npm run dev # Mobile cd apps/mobile && npx expo start ``` ### Deploy Soroban Contracts ```bash cd contracts stellar contract build stellar contract deploy --wasm target/wasm32-unknown-unknown/release/escrow.wasm --network testnet ``` ## MVP Features - [x] Wallet c …