Skip to content

README.md

Latest commit

 

History

History
241 lines (178 loc) · 6.54 KB

README.md

File metadata and controls

241 lines (178 loc) · 6.54 KB

🔋 Paycrypt - Crypto Utility Payment Platform

Status: ✅ Live on Production

A revolutionary payment platform that makes it simple for users to convert cryptocurrency into everyday services. Buy airtime, pay bills, and manage your digital wallet all in one place — with a clean, modern interface designed for everyone.

🎯 What is Paycrypt?

Paycrypt bridges the gap between cryptocurrency and real-world utility needs in Africa. Whether you want to buy airtime from your favorite telecom provider, pay your electricity or TV bills, or purchase data bundles — you can now do it all using crypto.

Perfect for:

  • Users who have crypto and want to use it for daily expenses
  • People sending money across borders without hassle
  • Anyone looking for a faster alternative to traditional payment methods

✨ What You Can Do

📱 Buy Airtime & Data

Purchase airtime and data bundles from all major telecom providers (MTN, Airtel, Glo, 9mobile) instantly using cryptocurrency.

💡 Pay Bills

  • Electricity: Pay prepaid meter bills with a single click
  • TV Subscriptions: Renew DSTV, Startimes, and other TV services
  • Internet: Top up internet plans from any provider

💰 Easy Conversions

  • Real-time exchange rates
  • See exactly how much crypto you need before confirming
  • Clear fee breakdown so no surprises

🔐 Safe & Secure

  • Connect your wallet securely (supports MetaMask, WalletConnect, and more)
  • Your private keys never leave your device
  • All transactions are encrypted and tracked

🌍 Multi-Chain Support

Use crypto on three different blockchain networks:

  • Base - Fast and affordable
  • Lisk - Secure and reliable
  • Celo - Mobile-first blockchain

📊 Track Everything

  • View your transaction history anytime
  • Get detailed receipts for every purchase
  • Monitor exchange rates and payment trends

🚀 Getting Started

For Users

  1. Visit the Paycrypt website at https://www.paycrypt.org/
  2. Connect your cryptocurrency wallet
  3. Choose what you want to buy or which bill to pay
  4. Enter the amount and details
  5. Confirm and done! Your service is activated

For Developers

Prerequisites:

  • Node.js 18+
  • pnpm (or npm/yarn)
  • A web3 wallet for testing

Installation: ```bash

Clone the repository

git clone https://github.com/Team-memevibe/Paycrypt.git cd Paycrypt

Install dependencies

pnpm install

Start development server

pnpm dev

Build for production

pnpm build ```

The application will be available at http://localhost:3000/

💻 Technology Stack

Frontend

  • Framework: Next.js 15 with React 18
  • Language: TypeScript for type safety
  • Styling: Tailwind CSS for modern design
  • Wallet Connection: Privy & Wagmi for secure wallet integration
  • UI Components: Radix UI for accessible interfaces

Blockchain

  • Networks: Base, Lisk, Celo
  • Contract Interaction: Viem for blockchain communication
  • Smart Contracts: Custom Solidity contracts for payment processing

Features

  • Dark and light theme toggle
  • Mobile-responsive design
  • Real-time exchange rate updates
  • Transaction status tracking
  • Detailed receipt generation and printing

📂 Project Structure

``` paycrypt/ ├── app/ # Page components and routes │ ├── airtime/ # Airtime purchase page │ ├── internet/ # Data bundle page │ ├── electricity/ # Bill payment pages │ ├── tv/ # TV subscription page │ ├── dashboard/ # User dashboard │ └── history/ # Transaction history ├── components/ # Reusable UI components ├── lib/ # Utility functions and API helpers ├── config/ # Configuration files ├── hooks/ # Custom React hooks └── public/ # Static assets ```

🔐 Security & Privacy

We take security seriously:

  • ✅ Secure wallet integration with zero private key exposure
  • ✅ All transactions are validated on-chain
  • ✅ Encrypted communication with our servers
  • ✅ Regular security audits
  • ✅ Two-factor authentication support
  • ✅ Transaction limits and fraud detection

🎯 Core Features Overview

Feature Status Description
Wallet Connection ✅ Live Connect MetaMask, WalletConnect, and more
Airtime Purchase ✅ Live Buy from MTN, Airtel, Glo, 9mobile
Data Bundles ✅ Live Purchase data from all major providers
Electricity Bills ✅ Live Pay prepaid meter bills instantly
TV Subscriptions ✅ Live Renew TV service subscriptions
Multi-Chain ✅ Live Support for Base, Lisk, and Celo
Receipt Download ✅ Live Download and print receipts
Transaction History ✅ Live View all past transactions

📱 User Experience Highlights

  • Lightning Fast: Optimized for slow connections
  • Intuitive: No technical knowledge needed
  • Accessible: Works on any device or browser
  • Transparent: Clear pricing with no hidden fees
  • Reliable: 24/7 uptime with instant confirmations

🚦 Current Status & Roadmap

✅ Completed

  • Multi-chain smart contract deployment
  • User authentication and wallet connection
  • Real-time exchange rate integration
  • Payment processing for all service types
  • Transaction receipt generation
  • Mobile-responsive interface
  • Production deployment on Vercel

🔄 In Progress

  • Enhanced user analytics
  • Push notifications for transaction updates
  • Loyalty rewards program
  • API documentation for partners

📋 Planned

  • Mobile app (iOS & Android)
  • Additional payment methods
  • More telecom providers
  • International expansion
  • Advanced portfolio tracking

💡 How It Works (Simplified)

User's Journey:

1. Connect Wallet
   ↓
2. Choose Service (Airtime/Bills/Data)
   ↓
3. Enter Amount & Details
   ↓
4. Review Crypto Cost
   ↓
5. Confirm & Sign with Wallet
   ↓
6. Transaction Processed
   ↓
7. Service Activated Instantly
   ↓
8. Receive Digital Receipt

🤝 Support & Contact

Have questions? Need help?

📄 License

This project is proprietary software. All rights reserved.

👥 Team

Built with ❤️ by the Paycrypt team at Team Memevibe

Disclaimer: This is a financial application. Please use responsibly and ensure compliance with local regulations in your jurisdiction.