lucylow/sunu-sav

Open-source, mobile-first platform that digitizes West African tontines using Bitcoin Lightning Network # SunuSàv — Our Savings, Our Future **Bitcoin-powered digital tontines for Senegal** > **Open-source, mobile-first platform that digitizes West African tontines using Bitcoin Lightning Network** SunuSàv preserves communal savings rituals while reducing fraud and friction through Bitcoin's censorship-resistant, programmable money. Built specifically for Senegal's mobile money ecosystem with USSD fallback for feature phones. ## 🎯 Project Overview SunuSàv is an open-source platform that digitizes the West African tontine (susu) model using Bitcoin and Lightning Network. Our goals: - **Preserve communal savings rituals** while reducing fraud and friction - **Make saving accessible** on low-end phones (USSD fallback, offline sync) - **Use Lightning** for low-fee, fast payouts and optional on-chain settlement - **Prioritize security, transparency, and community governance** ### Why SunuSàv? - **Tontines are deeply social** and already widely used — digital tooling should augment, not replace - **Lightning offers micro-sats economics** that make micro-savings practical - **Senegal has strong mobile money penetration** and large remittance flows — ideal for Lightning on-ramps/off-ramps - **Bitcoin's programmability** enables transparent, automated community fund management ## 📁 What's in This Repo ``` sunu-sav/ ├── backend/ # Node.js backend (API, services, workers) │ ├── app.js # Main Express server │ ├── routes/ # API endpoints │ │ ├── tontine.js # Core tontine logic │ │ ├── senegal.js # Senegal-specific features │ │ └── webhook.js # Lightning webhook handling │ ├── services/ # Business logic │ │ ├── TontineService.js # Core tontine cycle management │ │ ├── SenegalTontineService.js # Senegal-specific logic │ │ ├── WaveMobileMoneyService.js # Wave integration │ │ ├── USSDService.js # USSD menu system │ │ └── LightningService.js # …