A cross-border payment and remittance hub built on the Stellar network, enabling instant, low-cost international money transfers with multi-currency support.
Gpay-Remit leverages Stellar's payment rails to provide:
- Instant Remittances: Near-instant cross-border transfers
- Multi-Currency Support: Automatic currency conversions via Stellar DEX
- Escrow Services: Secure transfers with conditional releases
- Invoice Generation: Automated invoice creation and tracking
- Compliance Tools: KYC/AML integration hooks
- Low Fees: Minimal transaction costs using Stellar network
- Smart Contracts: Soroban (Rust) - Escrow and payment logic
- Backend: Go 1.21+ with Gin framework, Stellar Go SDK
- Database: PostgreSQL with GORM ORM
- Frontend: React.js with Stellar SDK
- Deployment: Docker & Docker Compose
Gpay-Remit/
├── contracts/ # Soroban smart contracts (Rust)
├── backend/ # Go API server
├── frontend/ # React.js web interface
├── docs/ # Architecture documentation
└── scripts/ # Setup and deployment scripts
- Rust 1.75+ with
wasm32-unknown-unknowntarget - Soroban CLI (
cargo install soroban-cli) - Go 1.21+
- Node.js 18+
- Docker & Docker Compose
- Stellar account on Testnet
# Clone the repository
git clone https://github.com/yourusername/Gpay-Remit.git
cd Gpay-Remit
# Run setup script
chmod +x scripts/setup.sh
./scripts/setup.sh
# Start local development environment
docker-compose up -d
# Deploy contracts to Stellar Testnet
chmod +x scripts/deploy_contracts.sh
./scripts/deploy_contracts.shBackend:
cd backend
go run main.go
# Server runs on http://localhost:8080Frontend:
cd frontend
npm start
# UI runs on http://localhost:3000Copy .env.example to .env and configure:
STELLAR_NETWORK: testnet or futurenetHORIZON_URL: Stellar Horizon API endpointDATABASE_URL: PostgreSQL connection stringCONTRACT_ID: Deployed Soroban contract ID
Smart Contracts:
cd contracts
cargo testBackend:
cd backend
go test ./...Frontend:
cd frontend
npm testSee docs/deployment.md for production deployment guide.
- Store secrets in environment variables
- Implement KYC/AML checks before large transfers
- Use multi-signature for high-value escrows
- Regular security audits recommended
Contributions welcome! Please read CONTRIBUTING.md for guidelines.
MIT License - see LICENSE file for details.