Skip to content

Team-memevibe/paycrypt-miniapp

Repository files navigation

💰 PayCrypt Mini App

Status: 🚧 In Active Development

A mobile-friendly Web3 application that makes it easy to convert cryptocurrency into everyday services. Buy airtime, pay electricity bills, subscribe to TV channels, and purchase data — all with crypto, directly from your wallet.


📌 What is PayCrypt?

PayCrypt is a bridge between cryptocurrency and real-world services. Instead of selling your crypto to fiat currency, you can directly use it to purchase:

  • 📱 Airtime - Top up phone credit with major carriers (MTN, Airtel, Glo, 9mobile)
  • ⚡ Electricity Bills - Pay power companies in Nigeria
  • 📺 TV Subscriptions - Subscribe to DSTV, Startimes, and other TV services
  • 🌐 Internet Data - Purchase data plans from various providers
  • 💱 Crypto Conversion - Convert between cryptocurrencies and fiat values

All from a single, user-friendly dashboard.


🎯 Key Features

💳 Seamless Payments

  • Connect your crypto wallet in seconds
  • No complicated registration process
  • Real-time price conversion and fee breakdown
  • Support for multiple blockchains (Base, Lisk, Celo)

🔒 Security First

  • Non-custodial wallet integration — you control your assets
  • Secure transaction verification
  • Transaction history and receipts
  • Protected personal information

📊 User Dashboard

  • View your wallet balance and transaction history
  • Real-time portfolio overview
  • Quick access to all services
  • Download transaction receipts

🌍 Multi-Chain Support

  • Base - Ethereum L2 solution, low fees and fast transactions
  • Lisk - Specialized blockchain for scalability
  • Celo - Mobile-first blockchain for accessibility

📱 Farcaster Integration

  • Run as a mini app inside Farcaster frames
  • One-click wallet connection
  • Seamless experience for Farcaster users

🚀 Getting Started

For Users

  1. Open Farcaster or Base app (which already have built-in wallets)
  2. Access the PayCrypt mini app
  3. Your wallet is automatically connected
  4. Fund it with cryptocurrency on supported chains
  5. Select your service (airtime, electricity, etc.)
  6. Confirm the transaction
  7. Done! Service is activated

For Developers

This is a Next.js + React application. To run locally:

# Install dependencies
pnpm install

# Start development server
pnpm dev

# Open in browser
# http://localhost:3000

💻 Technology Stack

  • Frontend: Next.js 15, React 18, TypeScript
  • Styling: Tailwind CSS
  • Web3: wagmi v2, viem for blockchain interactions
  • Wallet: Privy for authentication
  • UI Components: Custom component library
  • Backend API: Integration with utility providers

📖 How It Works

Payment Flow

  1. User connects wallet → Your assets remain in your control
  2. Select service → Choose airtime, electricity, TV, or data
  3. Enter details → Phone number, meter ID, etc.
  4. Review & confirm → See total cost and fees
  5. Sign transaction → Approve with your wallet
  6. Service activated → Usually within minutes

Supported Cryptocurrencies (by chain)

  • Base: USDC, USDT, SEND
  • Lisk: USDC, USDT
  • Celo: cUSD, CELO, USDC, USDT

🎨 User Experience

  • Clean Interface - Intuitive design that doesn't require crypto knowledge
  • Mobile Optimized - Works perfectly on phones and tablets
  • Dark Mode - Easy on the eyes in any lighting
  • Fast Transactions - Most services activate within minutes
  • No Hidden Fees - Complete fee breakdown before you pay

📈 Roadmap

Completed ✅

  • Multi-chain support (Base, Lisk, Celo)
  • Airtime purchases
  • Electricity bill payments
  • TV subscriptions
  • Data purchases
  • Transaction history
  • Receipt downloads
  • Farcaster mini app integration

Coming Soon 🔜

  • More utility providers
  • Scheduled payments
  • Bill reminders
  • Referral program
  • Enhanced analytics
  • Mobile app version

🔐 Security & Privacy

  • Your private keys never leave your wallet
  • All transactions are cryptographically signed by you
  • No storage of sensitive payment information
  • Compliance with blockchain security standards
  • Regular security audits

❓ FAQ

Q: Is my crypto safe?
A: Yes. You control your wallet and sign all transactions. PayCrypt never has access to your funds.

Q: Which countries are supported?
A: Currently focused on Nigeria, with plans to expand across Africa.

Q: What happens if my transaction fails?
A: Your crypto is returned to your wallet. No funds are lost.

Q: Can I use this on mobile?
A: Yes! The app is fully mobile-optimized and works as a Farcaster mini app.

Q: What if I need help?
A: Check our support page or reach out through the app.


👥 Meet the Team

Abraham Navigator
Blockchain Developer & Co-Founder
GitHub

Qasim Rokeeb
Frontend Engineer & Co-Founder
GitHub


📞 Support & Feedback

  • Questions? Visit our support page in the app
  • Bug report? Please create an issue on GitHub
  • Feature request? We'd love to hear your ideas!

🚀 PayCrypt is making crypto useful for everyday people.
Join us as we make financial services more accessible across Africa.

Releases

No releases published

Packages

 
 
 

Contributors

Languages