Odhiambo526/soko-tabiri

Kenya's first privacy-focused prediction market built on Zcash # Soko Tabiri 🌍 **Private NSE & SACCO Prediction Markets for Kenya** - Built on USDT ## Overview Soko Tabiri ("Market Prediction" in Swahili) is a privacy-preserving prediction market platform focused on **Kenya**, with markets centered on **Nairobi Securities Exchange (NSE) PLCs** and **SACCO performance**. ### Why Privacy Matters Unlike Polymarket (Polygon) where every bet is publicly visible, Soko Tabiri uses USDT-based settlement to protect user privacy. This is critical for: - **Market-sensitive NSE outcomes** (dividends, profit warnings, index milestones) - **SACCO performance signals** that could reveal member or institutional intent - **Sensitive market participation** where public exposure has real consequences ## Architecture Soko Tabiri uses a four-service microservices architecture: ``` ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │ Frontend │────▶│ Gateway │────▶│ Engine │ │ (React) │ │ API │ │ (AMM/Order) │ └─────────────┘ └─────────────┘ └─────────────┘ │ │ ▼ ▼ ┌─────────────┐ ┌─────────────┐ │ Oracle │ │ Settlement │ │ (Dispute) │ │(Lightwalletd)│ └─────────────┘ └─────────────┘ ``` | Service | Port | Description | |---------|------|-------------| | Gateway API | 3001 | User-facing API, routes requests | | Engine | 3002 | AMM math, orderbook matching | | Settlement | 3003 | USDT settlement adapter, signing | | Oracle | 3004 | Reporter management, disputes | ## Quick Start ### Prerequisites - Docker and Docker Compose - Node.js 18+ (for local development) - Make (optional) ### Start Services ```bash # Clone repository git clone github.com cd soko-tabiri # Copy environment file cp .env.example .env # Start all services make dev-up # Or: docker-compose -f docker-compose.yml up --build ``` ### USDT + MetaMask (Frontend) Set these in your `.env` for the frontend (or Vercel env vars): ` …