🤖 MiniMate

AI Finance Assistant on Celo — Built for MiniPay

---

Chat with your money. MiniMate lets MiniPay users check balances, track spending, set savings goals, and send payments — all through natural language, with zero gas friction.

🎯 Why MiniMate?

MiniPay has 10M+ users in emerging markets. Most aren't crypto-native — they think in dollars, not gas tokens. MiniMate bridges that gap:

• No CELO needed — gas paid in USDm via fee abstraction
• Natural language — "Send 10 USDm to mom" instead of copy-pasting addresses
• Real-time insights — on-chain spending breakdown by category
• Goal-based saving — set targets, track progress visually

✨ Features

Feature	Description	Status
💰 Balance	View CELO, USDm, USDC, USDT in real-time	✅ Live
📊 Spending	Auto-categorized breakdown from on-chain txs	✅ Live
📋 History	Recent transactions with Celoscan links	✅ Live
🎯 Goals	Save toward targets with progress tracking	✅ Live
💸 Send	Step-by-step payment flow with token picker	✅ Live
⛽ Fee Abstraction	Gas paid in USDm for MiniPay users	✅ Live
🔄 Chain Switch	Auto-switch to Celo from any network	✅ Live

🏗️ Architecture

minimate/
├── frontend/
│   ├── src/
│   │   ├── App.jsx         # Chat UI + send flow state machine
│   │   ├── lib/celo.js     # Wallet, chain, tx utilities
│   │   └── index.css       # Dark theme styling
│   └── api/
│       └── chat.js         # Serverless API — NLP + Blockscout
├── contracts/
│   ├── MiniMateVault.sol   # Savings vault (on-chain goals)
│   └── MiniMateRouter.sol  # Payment router
└── README.md

🛠️ Tech Stack

Layer	Tech
Frontend	React 19, Vite, viem 2
Blockchain	Celo Mainnet (42220)
Contracts	Solidity 0.8.20, OpenZeppelin
Data	Blockscout API v2
Wallet	MiniPay (native), Farcaster, MetaMask
Deploy	Vercel Serverless

📦 Stablecoins

Token	Address
USDm (cUSD)	0x765DE816845861e75A25fCA122bb6898B8B1282a
USDC	0xcebA9300f2b948710d2653dD7B07f33A8B32118C
USDT	0x48065fbBE25f71C9282ddf5e1cD6D6A887483D5e
CELO	0x471EcE3750Da237f93B8E339c536989b8978a438

🔗 Smart Contracts (Celo Mainnet)

• MiniMateVault — 0x8d85...9B7
• MiniMateRouter — 0xc891...5b61

📱 MiniPay Integration

// Auto-detect MiniPay
const isMiniPay = window.ethereum?.isMiniPay === true;

// Fee abstraction — pay gas in USDm
if (isMiniPay) {
  txParams.feeCurrency = '0x765DE816845861e75A25fCA122bb6898B8B1282a';
}

When opened in MiniPay:

• ✅ Auto-connects (no "Connect Wallet" button)
• ✅ Stablecoin-first UI (USDm, USDC, USDT)
• ✅ Gas paid in USDm (no CELO needed)
• ✅ Legacy tx format (MiniPay compatible)

🚀 Quick Start

git clone https://github.com/ulsreall/minimate.git
cd minimate/frontend
npm install
npm run dev

Test in MiniPay

1. Install MiniPay
2. Settings → About → tap Version 7x → Developer Mode
3. Developer Settings → Load Test Page
4. Enter URL: https://minimate-green.vercel.app

🗺️ Roadmap

• Balance checking (CELO, USDm, USDC, USDT)
• On-chain spending analysis via Blockscout
• Savings goals with localStorage persistence
• Step-by-step send flow with token picker
• MiniPay fee abstraction (gas in USDm)
• Auto chain switch to Celo
• Farcaster Mini App support
• On-chain savings vault (smart contract)
• Token swaps via Mento DEX
• Multi-language (Bahasa Indonesia, Swahili)
• Recurring payments / auto-save
• Push notifications for goals

📄 License

MIT License — see LICENSE.

🙏 Acknowledgments

• Celo — blockchain infrastructure
• MiniPay — mobile wallet
• Blockscout — on-chain data API
• viem — TypeScript Ethereum library

---

Built with ❤️ for Celo Proof of Ship