Finchippay Solution

Open-source Stellar Web3 payments platform — send, stream, escrow, and batch payments on Stellar with a production-grade Soroban smart contract.

---

Quick Links

• 📖 Documentation
• 🏛️ Governance Model
• 🔒 Security Policy
• 📋 Contributing Guide
• 🛡️ Audit Framework

Architecture

Layer	Tech	Path
Smart Contract	Rust + Soroban SDK	contracts/finchippay-contract/
Backend API	Node.js + Express + PostgreSQL	backend/
Frontend	Next.js + Tailwind CSS	frontend/
SDK	TypeScript	sdk/
Infrastructure	Terraform + Kubernetes + Docker	terraform/, kubernetes/

Features

• 💸 Send payments — XLM, USDC, and custom Stellar assets
• 🔄 Recurring & streaming — Scheduled and per-ledger payment streams
• 🔐 Escrow — Time-locked custody with dispute resolution
• ✍️ Multi-signature — N-of-M threshold approvals
• 📦 Batch sends — Up to 50 recipients in one transaction
• 🔑 Hardware wallet — Ledger Nano S/X support via WebUSB
• 📊 Analytics — Spending charts, top recipients, portfolio tracking
• 🌐 i18n — Multi-language support

Getting Started

# Clone and install
git clone https://github.com/FinChippay/Finchippay-Solution.git
cd Finchippay-Solution

# Development
make dev        # Start all services

# Testing
make test       # Run all tests

# Build
make build      # Build all components

See QUICKSTART.md for detailed setup instructions.

Security

Report vulnerabilities to security@finchippay.dev. See SECURITY.md for our disclosure policy.

We maintain a Security Audit Framework based on Stellar Smart Contract Security Guidelines and OWASP Top 10.

Community

• Contributing: See CONTRIBUTING.md
• Governance: See GOVERNANCE.md
• RFCs: Propose major changes via docs/rfc/

License

MIT © Finchippay contributors

Quick Start (Local Development)

# 1. Clone and install dependencies
git clone https://github.com/FinChippay/Finchippay-Solution.git
cd Finchippay-Solution
npm install && cd backend && npm install && cd ../frontend && npm install && cd ..

# 2. Start development services (PostgreSQL, Redis, Horizon)
docker compose -f docker-compose.dev.yml up -d

# 3. Run migrations
cd backend && npm run migrate && cd ..

# 4. Start backend and frontend
npm run dev

The app will be available at:

• Frontend: http://localhost:3000
• Backend API: http://localhost:4000
• Health Check: http://localhost:4000/api/health
• Swagger Docs: http://localhost:4000/api-docs