Bringing Compound's lending and borrowing protocols to WhatsApp, unlocking DeFi for mobile-first markets in Africa and beyond.
CompoundChat makes DeFi accessible to anyone with a phone and WhatsApp. No app downloads, no browser extensions, no complex UIs — just simple text commands to earn interest on crypto savings.
Target Markets: Kenya 🇰🇪 | Nigeria 🇳🇬 | Uganda 🇺🇬 | Ghana 🇬🇭 | Tanzania 🇹🇿
- 💬 Chat-Based DeFi: Interact with Compound through simple WhatsApp messages
- 🔐 Non-Custodial Wallets: Users control their own keys with military-grade encryption
- 💰 Supply & Withdraw: Deposit crypto to earn interest, withdraw anytime
- 📊 Real-Time Balances: Check wallet and Compound positions instantly
- 🔒 End-to-End Encryption: Sensitive data protected with AES-256-GCM
- 🛡️ Zero-Knowledge Proofs: Privacy-preserving transaction verification
- Node.js 20+ and npm 9+
- PostgreSQL 15+
- Redis 7+
- WhatsApp Business API account
- Ethereum RPC provider (Alchemy/Infura)
# Clone the repository
git clone https://github.com/compoundchat/compoundchat.git
cd compoundchat
# Install dependencies
npm install
# Copy environment variables
cp .env.example .env
# Edit .env with your API keys
# Run database migrations
npm run migrate
# Start development server
npm run dev# Run with hot reload
npm run dev
# Build for production
npm run build
# Run tests
npm test
# Run tests with coverage
npm test:coverage
# Lint and format
npm run lint
npm run formatOnce connected to WhatsApp, users can interact with these commands:
help- Get started guide and available commandscreate wallet- Create a new non-custodial walletbalance- Check wallet balance and Compound positionssupply [amount] [token]- Deposit crypto to earn interest (e.g., "supply 100 USDC")withdraw [amount] [token]- Withdraw from Compound (e.g., "withdraw 50 USDC")markets- View all available Compound markets and APYs
User: "help"
Bot: "👋 Welcome to CompoundChat! ..."
User: "create wallet"
Bot: "✅ Wallet created! Your address: 0x1234...5678
🔐 Save this recovery phrase: [24 words]"
User: "supply 100 USDC"
Bot: "✅ Supply Successful! Deposited: 100 USDC, APY: 4.2%"
User: "balance"
Bot: "💰 Your Balance
USDC: 1,000.00 (4.2% APY)
Interest earned: $12.50"
┌─────────────┐
│ WhatsApp │
│ User │
└──────┬──────┘
│
▼
┌─────────────────────────────┐
│ WhatsApp Business API │
└──────┬──────────────────────┘
│
▼
┌─────────────────────────────┐
│ Webhook Server │
│ - Signature verification │
│ - Rate limiting │
└──────┬──────────────────────┘
│
▼
┌─────────────────────────────┐
│ Command Handlers │
│ - balance, supply, withdraw │
└─┬─────────────────────────┬─┘
│ │
▼ ▼
┌──────────┐ ┌─────────────┐
│ Wallet │ │ Compound V3 │
│ Layer │ │ Integration │
└──────────┘ └─────────────┘
CompoundChat is built with security as the top priority:
- Non-custodial: Users always control their private keys
- Encrypted storage: Private keys encrypted with AES-256-GCM
- No plaintext keys: Keys never stored or logged unencrypted
- Webhook verification: HMAC-SHA256 signature validation
- Rate limiting: Protection against abuse
- Input validation: All user inputs sanitized
- Audit-ready: Independent security review before launch
See SECURITY.md for our threat model and security architecture.
We maintain high test coverage for all security-critical code:
# Run all tests
npm test
# Run specific test suites
npm run test:unit
npm run test:integration
npm run test:e2e
# Watch mode (development)
npm run test:watch
# Coverage report
npm run test:coverageCoverage Requirements:
- Security-critical code: 85%+ coverage
- Overall codebase: 70%+ coverage
- WhatsApp webhook integration
- Non-custodial wallet creation
- Compound V3 supply/withdraw
- E2E encryption
- Basic ZK proofs
- 30+ beta testers
- M-Pesa integration (Kenya, Tanzania, South Africa)
- MTN Mobile Money (Uganda, Ghana, Nigeria)
- 200+ active users
- $50K+ transaction volume
- Borrowing functionality
- Real-time notifications
- Referral system
- 100+ borrowing positions
- Production launch
- 1,000+ users
- $400K+ TVL
- Marketing campaign
- Beacher @0Xbeach - Cryptography & Security Lead
- Bunny - Mobile Money & Backend Specialist
- Wisdom - Smart Contract Integration Lead
MIT License - see LICENSE file for details.
We're currently in private beta (Milestone 1). The repository will be open-sourced after Milestone 4.
For bug reports or security issues, please email: security@compoundchat.xyz
- Telegram: @0Xbeach
- Twitter: @0Xbeachbuidler
- Website: compoundchat.xyz (coming soon)
- Compound Labs for building accessible DeFi protocols
- Ethereum Foundation for the underlying blockchain technology
- African crypto communities for invaluable feedback and support
Built with ❤️ for financial inclusion in Africa