Skip to content

Team-Parashuram/monad-hackathon

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

16 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸš€ MonadPe - Web3 Payments Made Simple

MonadPe Logo

Lightning-fast crypto payments on the Monad blockchain

Live Demo GitHub YouTube


πŸ“‹ Table of Contents


πŸ“– Overview

MonadPe revolutionizes crypto payments by making them as simple as sharing a link. Built on the high-performance Monad blockchain, MonadPe enables merchants to generate instant payment links and accept cryptocurrencies with zero coding required.

Why MonadPe?

  • βœ… No complex setup or technical knowledge needed
  • βœ… Direct wallet-to-wallet transfers (non-custodial)
  • βœ… Mobile-friendly with QR code support
  • βœ… Professional UI with dark/light theme
  • βœ… Built on Monad's blazing-fast EVM

🎯 Key Features

  • πŸ”— Instant Payment Links - Generate payment links in seconds
  • πŸ“± QR Code Integration - Mobile-friendly QR code payments
  • ⚑ Lightning Fast - Built on Monad's high-performance EVM
  • 🎨 Professional UI - Clean, modern interface with dark/light themes
  • πŸ”’ Secure - Non-custodial, direct wallet-to-wallet transfers
  • πŸ’° Multi-Token Support - ETH, MON, USDC, USDT support
  • πŸ“Š Dashboard Analytics - Track payments and transaction history

🎬 Demo

🌐 Live Application

Try MonadPe now: https://monadpe.vercel.app/

πŸ“Ί Video Walkthrough

Watch our comprehensive demo: YouTube Demo


πŸ›  Technology Stack

Frontend

  • Framework: Next.js 15.5.2 with TypeScript
  • Styling: Tailwind CSS with professional design system
  • UI Components: Lucide React icons, Shadcn/ui
  • Wallet Integration: Wagmi, Viem
  • Theme: Next-themes for dark/light mode

Blockchain

  • Network: Monad Testnet
  • Smart Contracts: Solidity
  • Development: Hardhat
  • Libraries: OpenZeppelin

Deployment

  • Frontend: Vercel
  • Smart Contracts: Monad Testnet

πŸš€ Quick Start

Prerequisites

  • Node.js 18+
  • npm or yarn
  • MetaMask or compatible Web3 wallet

Installation

  1. Clone the repository

    git clone https://github.com/Team-Parashuram/monad-hackathon.git
    cd monad-hackathon
  2. Install dependencies

    # Frontend
    cd client
    npm install
    
    # Smart Contracts
    cd ../contract
    npm install
  3. Environment Setup

    # Copy environment file
    cp .env.example .env.local
    
    # Add your configuration
    NEXT_PUBLIC_NETWORK_MODE=development
  4. Run the application

    cd client
    npm run dev
  5. Visit the app

    http://localhost:3001
    

πŸ’³ How It Works

For Merchants

  1. Connect Wallet - Connect your MetaMask or compatible wallet
  2. Generate Link - Specify amount and token type
  3. Share Payment - Send the generated link or QR code to customers
  4. Receive Payments - Funds are sent directly to your wallet

For Customers

  1. Click Link - Open the payment link on any device
  2. Connect Wallet - Connect wallet to complete payment
  3. Confirm Transaction - Review and confirm the payment
  4. Payment Complete - Transaction is processed on Monad blockchain

πŸ— Project Structure

monad-hackathon/
β”œβ”€β”€ client/                 # Next.js frontend application
β”‚   β”œβ”€β”€ src/
β”‚   β”‚   β”œβ”€β”€ app/           # App router pages
β”‚   β”‚   β”œβ”€β”€ components/    # Reusable UI components
β”‚   β”‚   β”œβ”€β”€ hooks/         # Custom React hooks
β”‚   β”‚   └── lib/           # Utility functions
β”‚   β”œβ”€β”€ public/            # Static assets
β”‚   └── package.json
β”œβ”€β”€ contract/              # Smart contracts
β”‚   β”œβ”€β”€ contracts/         # Solidity contracts
β”‚   β”œβ”€β”€ scripts/           # Deployment scripts
β”‚   β”œβ”€β”€ test/              # Contract tests
β”‚   └── hardhat.config.cjs
└── README.md

πŸ“œ Smart Contracts

PaymentReceiver Contract

The core smart contract that handles payment processing on the Monad blockchain.

Key Features:

  • Accepts both native (MON/ETH) and ERC-20 tokens
  • Direct wallet-to-wallet transfers
  • Event emission for payment tracking
  • Gas-optimized design
  • Built with OpenZeppelin standards

Deployment:

cd contract
npx hardhat compile
npx hardhat test
npx hardhat run scripts/deploy.js --network monad-testnet

🎨 Features Showcase

Professional Design System

  • Orange/Yellow Theme - Professional color scheme for light/dark modes
  • Responsive Design - Mobile-first approach with perfect desktop experience
  • Clean Typography - Professional fonts and spacing
  • Intuitive UX - Streamlined user experience for crypto payments

Smart Contract Integration

  • Payment Receiver Contract - Secure payment processing
  • Multi-token Support - ERC-20 token compatibility
  • Gas Optimization - Efficient contract design
  • Event Logging - Complete payment tracking

Advanced Features

  • QR Code Generation - Instant mobile payment support
  • Payment History - Track all transactions
  • Network Auto-switching - Seamless Monad testnet connection
  • Error Handling - Comprehensive error management

πŸ”§ Development

Smart Contract Development

cd contract

# Compile contracts
npx hardhat compile

# Run tests
npx hardhat test

# Deploy to testnet
npx hardhat run scripts/deploy.js --network monad-testnet

Frontend Development

cd client

# Development server
npm run dev

# Build for production
npm run build

# Run production build
npm start

🌐 Deployment

Frontend (Vercel)

  1. Connect repository to Vercel
  2. Configure environment variables
  3. Deploy automatically on push

Smart Contracts (Monad Testnet)

  1. Configure network in hardhat.config.cjs
  2. Add private key and RPC URL
  3. Deploy using Hardhat scripts

πŸ›‘ Security Features

  • Non-custodial - Users maintain full control of funds
  • Smart Contract Security - Secure payment processing
  • Frontend Security - XSS protection and secure coding practices
  • Wallet Integration - Industry-standard wallet connections

🀝 Contributing

We welcome contributions! Please follow these steps:

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit changes (git commit -m 'Add amazing feature')
  4. Push to branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

πŸ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.


πŸ‘₯ Team

Team Parashuram

  • Professional blockchain developers
  • UI/UX design specialists
  • Smart contract security experts

πŸ”— Links


⚑ Why Monad?

MonadPe leverages Monad's high-performance EVM to provide:

  • 10,000+ TPS - Lightning-fast transaction processing
  • Low Fees - Cost-effective payments for merchants and customers
  • EVM Compatibility - Seamless integration with existing Ethereum tools
  • Developer-Friendly - Easy deployment and development experience

Built with ❀️ for the Monad ecosystem

Monad

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •