🎟️ Web3 Tickets - NFT Ticketing Platform

A modern, decentralized ticketing platform built with React and Ethereum smart contracts. Features fraud-proof NFT tickets, anti-scalping protection, and a built-in resale marketplace.

Features

• 🎟️ NFT Tickets - Each ticket is a unique ERC-721 token
• 🔒 Fraud Prevention - Blockchain-based authenticity
• 🔄 Resale Marketplace - Safe secondary market with price limits
• 🛡️ Anti-Scalping - Maximum 5 tickets per wallet per event
• 💰 Automatic Refunds - Smart contract handles cancelled events
• 🎨 Modern UI - Clean cream and black design

Tech Stack

• Frontend: React, Privy Auth, Web3 Integration
• Blockchain: Ethereum, Solidity Smart Contracts
• Database: Supabase
• Styling: Custom CSS with Klack theme

🚀 Quick Start

Prerequisites

• Node.js 16+ and npm
• MetaMask browser extension
• Git

Installation

1. Clone the Repository

   git clone https://github.com/YOUR_USERNAME/web3-tickets.git
   cd web3-tickets

2. Install Dependencies

   npm install

3. Set Up Environment Variables

   cp .env.example .env

   Edit .env and add your configuration:

   REACT_APP_PRIVY_APP_ID=your_privy_app_id_here
   REACT_APP_CONTRACT_ADDRESS=your_contract_address
   REACT_APP_RPC_URL=your_rpc_url
   REACT_APP_CHAIN_ID=your_chain_id
   REACT_APP_SUPABASE_URL=your_supabase_url
   REACT_APP_SUPABASE_ANON_KEY=your_supabase_key

4. Start Development Server

   npm start

5. Deploy Smart Contract (Optional - for local development)

   npx hardhat node
   npx hardhat run scripts/deploy.js --network localhost

🔧 Setup Services

Privy Authentication

1. Go to Privy Dashboard
2. Create a new app
3. Copy your App ID to .env

Supabase Database

1. Create a Supabase project
2. Copy URL and anon key to .env
3. Run the SQL schema from supabase-schema.sql (if available)

Project Structure

src/
├── App.jsx                  # Main application router
├── index.js                 # React entry point
├── index.css                # Base styles
├── klack-theme.css          # Custom theme (cream & black)
├── components/              # Reusable UI components
│   ├── Navbar.js           # Navigation component
│   ├── Footer.js           # Footer component
│   └── index.js            # Component exports
├── pages/                   # Page components
│   ├── Home.js             # Landing page
│   ├── Login.js            # Authentication page
│   ├── Events.js           # Events listing
│   ├── CreateEvent.js      # Event creation form
│   ├── EventDetails.js     # Individual event page
│   ├── Dashboard.js        # User dashboard
│   ├── MyTickets.js        # User's tickets
│   ├── Marketplace.js      # Resale marketplace
│   ├── About.js            # About page
│   └── index.js            # Page exports
├── contexts/                # React contexts
│   ├── WalletContext.js    # Wallet & auth state
│   └── ContractContext.js  # Smart contract integration
├── services/                # Business logic
│   ├── contractService.js  # Blockchain interactions
│   ├── userService.js      # User management
│   └── walletService.js    # Wallet utilities
└── lib/
    └── supabase.js         # Database configuration

Environment Variables

REACT_APP_PRIVY_APP_ID=your_privy_app_id
REACT_APP_CONTRACT_ADDRESS=deployed_contract_address
REACT_APP_RPC_URL=your_rpc_url
REACT_APP_CHAIN_ID=network_chain_id
REACT_APP_SUPABASE_URL=your_supabase_url
REACT_APP_SUPABASE_ANON_KEY=your_supabase_key

🎨 Screenshots

🧪 Testing

# Run tests
npm test

# Run tests with coverage
npm run test:coverage

🚀 Deployment

Frontend Deployment (Vercel/Netlify)

1. Build the project: npm run build
2. Deploy the build folder to your hosting service
3. Set environment variables in your hosting dashboard

Smart Contract Deployment

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

# Verify contract on Etherscan
npx hardhat verify --network sepolia DEPLOYED_CONTRACT_ADDRESS

🤝 Contributing

1. Fork the repository
2. Create a feature branch: git checkout -b feature/amazing-feature
3. Commit your changes: git commit -m 'Add amazing feature'
4. Push to the 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.

🙏 Acknowledgments

• OpenZeppelin for secure smart contract libraries
• Privy for seamless Web3 authentication
• Supabase for backend infrastructure
• React for the frontend framework

📞 Support

If you have any questions or need help, please:

• Open an issue on GitHub
• Check the documentation
• Join our community discussions