jahpay is a modern Web3 application that enables seamless fiat-to-crypto and crypto-to-fiat conversions on the Celo blockchain. Built with Next.js and TypeScript, it works as both a standard website and a MiniPay Mini App, supporting stablecoin transactions with multiple payment providers.
- Dual-Mode Operation: Works as a website and MiniPay Mini App
- Multi-Provider Support: Yellow Card, Cashramp, Bitmama
- Stablecoin Transactions: USDm, USDC, USDT support
- Smart Contracts: RampAggregator for optimized on/off-ramp flows
- Mobile-First Design: Responsive UI optimized for mobile
- Type-Safe: Full TypeScript support
- Node.js 18+
- PNPM 8+
# Install dependencies
pnpm install
# Setup environment
cp apps/web/.env.minipay.example apps/web/.env.local
# Edit .env.local with your values
# Start development server
pnpm devVisit http://localhost:3000 to see the app.
jahpay/
├── apps/
│ ├── web/ # Next.js frontend application
│ └── contracts/ # Solidity smart contracts
├── packages/ # Shared utilities and types
└── docs/ # Documentation
| Command | Description |
|---|---|
pnpm dev |
Start development servers |
pnpm build |
Build all packages and apps |
pnpm lint |
Lint all packages and apps |
pnpm type-check |
Run TypeScript type checking |
| Layer | Technology |
|---|---|
| Frontend | Next.js 14, React 18, TypeScript |
| Styling | Tailwind CSS, shadcn/ui |
| Web3 | Wagmi, Viem, RainbowKit |
| Blockchain | Celo, Solidity |
| Monorepo | Turborepo, PNPM |
- Network: Celo Mainnet (42220) & Celo Sepolia (11142220)
- Tokens: USDm, USDC, USDT
- Smart Contracts: RampAggregator for optimized routing
- Wallet Support: MetaMask, WalletConnect, MiniPay
jahpay is fully compatible with MiniPay, the fastest-growing stablecoin wallet in the Global South. The app automatically detects the MiniPay environment and adapts accordingly.
Learn more: MiniPay Integration Guide
- MiniPay Integration - Full MiniPay setup guide
- Quick Start - 5-minute setup
- Architecture - System design
- Testing Checklist - Testing procedures
- Smart contracts audited for security
- No private keys stored in the app
- Secure wallet integration via industry-standard libraries
- Environment variables for sensitive configuration
MIT License - see LICENSE file for details
Contributions are welcome! Please feel free to submit a Pull Request.
- Celo Docs: https://docs.celo.org
- MiniPay Docs: https://docs.minipay.xyz
- Issues: GitHub Issues
Built with ❤️ for financial inclusion on Celo