send money easy with us across East Africa
# Blockchain-Based Cross-Border Payment System for East Africa
**A production-grade DeFi payment rail combining smart contracts, on-chain wallets, and a tamper-proof ledger for seamless cross-border transactions across the East African Community.**
## 🌍 Project Overview
This system enables instant, low-cost cross-border payments across East Africa by leveraging blockchain settlement, non-custodial wallets, and FX optimization. It maintains the familiar M-Pesa-meets-Wise interface while providing true decentralization and transparency.
### Supported Countries & Currencies
- 🇰🇪 Kenya — KES
- 🇹🇿 Tanzania — TZS
- 🇺🇬 Uganda — UGX
- 🇷🇼 Rwanda — RWF
- 🇧🇮 Burundi — BIF
- 🇸🇸 South Sudan — SSP
- 🇨🇩 DR Congo — CDF
- 🇸🇴 Somalia — SOS
## 🏗️ Architecture Overview
```
┌─────────────────┐ ┌──────────────────┐ ┌─────────────���───┐
│ Frontend │◄────────►│ Backend API │◄────────►│ Smart Contract │
│ (React 18) │ │ (Fastify) │ │ (Polygon) │
└─────────────────┘ └──────────────────┘ └─────────────────┘
│ │ │
│ ┌──────▼────────┐ │
│ │ PostgreSQL │ │
│ │ Database │ │
│ └───────────────┘ │
│ │ │
│ ┌──────▼────────┐ │
│ │ Redis │ │
└────────────────────┼─(Sessions)────┼────────────────────┘
└───────────────┘
```
## 📦 Monorepo Structure
```
eac-payment-system/
├── frontend/ # React 18 + TypeScript + Vite
├── backend/ # Node.js 20 + Fastify + TypeScript
├── contracts/ # Solidity smart contracts (Hardhat)
├── shared/ # Shared types & utilities
├── docs/ # Documentation
├── .github/ …