Stocks-Up/formance-ai

Kulu Demo: Mobile money platform powered by Formance Ledger - P2P transfers, merchant payments, and agent banking for Guinea # Kulu Digital Wallet - Formance PoC ## Overview This is a proof-of-concept demonstrating how **Formance** can serve as the core financial infrastructure for Kulu, a West African digital wallet supporting P2P, P2B, and POS transactions. **Key Achievement:** Successfully replaced Kulu's current core with Formance's open-source financial ledger while maintaining the authentic Kulu brand experience. --- ## 🎯 Objectives 1. Validate Formance as a replacement for Kulu's current digital wallet core 2. Demonstrate P2P, P2B, and agent network functionality 3. Prove scalability and performance for West African market needs 4. Maintain authentic Kulu brand identity and user experience --- ## 🏗️ Architecture ### Technology Stack - **Backend:** Formance Stack (Ledger v2.2.0, Payments v3.0.1) - **Database:** PostgreSQL 15 - **API Gateway:** Caddy 2.7 - **Frontend:** React 18 + TypeScript + Vite - **Styling:** TailwindCSS with Kulu brand colors - **Containerization:** Docker Compose ### Formance Components Used 1. **Ledger** - Programmable double-entry accounting system 2. **Numscript** - Financial transaction modeling DSL 3. **API Gateway** - RESTful API endpoints --- ## 💰 Kulu Financial Operations ### 1. P2P Transfers (Person-to-Person) - **Fee Structure:** 1.5% with minimum $0.50 - **Implementation:** Numscript with automatic fee calculation - **Features:** Instant transfers, balance validation, transaction history ### 2. P2B Payments (Person-to-Business) - **Commission:** 2.5% platform fee - **Use Cases:** Merchant payments, QR code transactions - **Status:** Framework implemented, UI ready for expansion ### 3. Agent Network (Cash-In/Cash-Out) - **Agent Commission:** 0.5% of transaction - **Purpose:** Enable cash deposits/withdrawals at local agents - **Flow:** Cash pool → User wallet with agent commission ### 4. Marketplace Escrow - **Hold & Release:** Funds held until delivery confirmation - **Platform Fee:** 3% on release - **Security:** Built-in fraud pre …