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.
https://afro-pay-stellar.vercel.app/login
AfroPay-Stellar simplifies international money transfers by leveraging blockchain technology:
- Near-instant transactions (3–5 seconds)
- Low transaction fees
- Multi-currency support (NGN, USD, EUR, USDC)
- Seamless fiat-to-crypto and crypto-to-fiat integration via Stellar anchors
AfroPay-Stellar is structured as a polyglot microservices architecture: Client (Next.js) ↓ API Gateway (NestJS - TypeScript) ↓ | Wallet Service (TypeScript) | | Transaction Service (TypeScript)| | Anchor Service (TypeScript) | ↓ Queue (Redis / BullMQ) ↓ | Rust Worker (Blockchain Engine) | ↓ | Python Services (Fraud/Risk) | ↓
PostgreSQL + Redis
Languages:
- TypeScript: Backend APIs and frontend
- Rust: Blockchain execution and smart contracts
- Python: Fraud detection and analytics
- JavaScript: Minimal utilities
Frameworks & Tools:
- Next.js (Frontend)
- NestJS (Backend)
- Stellar SDK
- PostgreSQL + Prisma
- Redis / BullMQ
- Docker & Docker Compose
- Terraform (optional)
Wallet System:
- Generate Stellar wallets
- Secure key storage and management
- Balance tracking (XLM, USDC, NGN)
Cross-Border Transfers:
- Multi-currency transfers
- Stellar path payments for currency conversion
- Real-time FX rates
Transaction Engine:
- Async processing via queue
- Retry and failure handling
- Transaction tracking and logging
Anchor Integration:
- Deposit and withdrawal endpoints
- Multi-anchor fallback support
- Liquidity routing
Security & Compliance:
- Encrypted private keys
- JWT authentication
- KYC/AML-ready
- Rate limiting and audit logs
Intelligence Layer:
- Fraud detection
- Risk scoring
- Transaction monitoring
/apps /frontend # Next.js (TypeScript) /api # NestJS backend
/services /rust-worker # Blockchain execution engine /python-analytics# Fraud detection & analytics
/packages /stellar-wrapper /shared-types
/infrastructure /docker /terraform
/scripts setup.sh deploy.sh
- Node.js v18+
- Docker & Docker Compose
- PostgreSQL
- Redis
# Clone the repository
git clone https://github.com/your-username/remitx.git
cd remitx
# Copy environment variables
cp .env.example .env
# Run with Docker
docker-compose up --build
Running Locally (Without Docker)
# Install dependencies
npm install
# Run backend
cd apps/api
npm run start:dev
# Run frontend
cd apps/frontend
npm run dev
Environment Variables
Create a .env file with the following keys:
DATABASE_URL=postgresql://user:password@localhost:5432/remitx
REDIS_URL=redis://localhost:6379
JWT_SECRET=your_secret_key
STELLAR_NETWORK=testnet
STELLAR_HORIZON_URL=https://horizon-testnet.stellar.org
Testing
# Run unit tests
npm run test
# Run linting
npm run lint
Docker
# Build and run all services
docker-compose up --build
# Stop services
docker-compose down
Roadmap
Multi-signature wallets
Escrow smart contracts (Rust/Soroban)
Advanced liquidity routing
Admin dashboard
Mobile app (React Native)
Contributing
Contributions are welcome:
# Fork the repo
# Create a feature branch
git checkout -b feature/your-feature
# Commit changes
git commit -m "Add feature"
# Push and open a pull request
git push origin feature/your-feature
License
MIT License