🌍 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

# 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

# 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

cd contracts
stellar contract build
stellar contract deploy --wasm target/wasm32-unknown-unknown/release/escrow.wasm --network testnet

MVP Features

• Wallet creation (phone/email)
• Send & receive funds
• QR code payments
• Transaction history
• Fiat on/off ramps (Phase 2)
• Stablecoin integration (Phase 2)
• Agent network (Phase 2)

Revenue Model

• 0.1%–0.5% transaction fees
• FX spreads
• Premium features
• B2B/API integrations

License

MIT