A cross-border remittance application built on the Stellar blockchain, enabling fast and low-cost international money transfers.
This repository includes both frontend and backend services for building a Stellar payment experience.
- Create Stellar accounts
- Check account balances
- Send XLM payments
- Low transaction fees (~$0.00001)
- Fast settlement (3-5 seconds)
- Backend: Node.js + Express + Stellar SDK
- Frontend: React + Vite
- Blockchain: Stellar (Testnet)
- Install dependencies:
npm install- Configure backend environment:
cd backend
cp .env.example .envSee backend/CONFIGURATION.md for environment options, validation rules, and optional encrypted secrets.
- Configure frontend environment (optional):
cd frontend
cp .env.example .envSet VITE_API_URL to your production API endpoint when deploying to a CDN or different domain. Leave empty for development (Vite proxy handles /api requests to localhost:3001).
- Start development servers:
npm run devBackend runs on http://localhost:3001 Frontend runs on http://localhost:3000
- Click "Create Account" to generate a new Stellar keypair
- Account is automatically funded on testnet via Friendbot
- Check balance to see your XLM
- Send payments to other Stellar addresses
- Add stablecoin support (USDC)
- Integrate fiat on/off ramps
- Add exchange rate conversion
- Implement KYC/AML compliance
- Add transaction history
- Mobile app development
- Security best practices for integrators — API key storage, webhook verification, private key management, CSP, replay attacks, front-running
See CONTRIBUTING.md for local setup, running tests, branch naming, PR process, code style, and commit message conventions.
Key technology choices are documented as ADRs in docs/adr/:
| ADR | Decision |
|---|---|
| ADR-0001 | Stellar as the blockchain layer |
| ADR-0002 | Prisma as the ORM |
| ADR-0003 | Multi-level caching (in-memory L1 + Redis L2) |
| ADR-0004 | JWT auth with refresh token rotation |