🎫 NFT Ticketing System

A decentralized ticketing platform built on blockchain technology that allows users to mint, purchase, transfer, and verify event tickets as NFTs (Non-Fungible Tokens). This project combines Web3 technology with a modern full-stack application to prevent ticket fraud and enable secure peer-to-peer ticket transfers.

🌟 Features

🔗 Blockchain-Based Tickets: Each ticket is a unique ERC-721 NFT on the blockchain
🦊 MetaMask Integration: Connect your crypto wallet to interact with the platform
🎟️ Event Management: Browse and purchase tickets for various events
📱 QR Code Verification: Generate and verify tickets using QR codes
💸 Secure Transfers: Transfer tickets directly between wallets
🔍 Ticket Validation: Verify ticket authenticity on the blockchain
📊 Transaction History: Track all ticket purchases and transfers
🎨 Modern UI: Built with React, TypeScript, and Tailwind CSS

🏗️ Architecture

The project consists of three main components:

1. Frontend (React + TypeScript + Vite)

Modern React application with TypeScript
MetaMask wallet integration
Responsive UI with Tailwind CSS
React Router for navigation
QR code generation and scanning

2. Backend (Node.js + Express + MongoDB)

RESTful API for event and transaction management
MongoDB database for storing event details
Integration with blockchain for ticket verification
CORS-enabled API endpoints

3. Smart Contracts (Solidity + Hardhat)

ERC-721 NFT standard implementation
Custom ticket minting and management logic
Event-based ticket tracking
OpenZeppelin contracts for security

🛠️ Tech Stack

Frontend

React 18 - UI library
TypeScript - Type-safe JavaScript
Vite - Build tool and dev server
Ethers.js - Ethereum library for Web3 interaction
Tailwind CSS - Utility-first CSS framework
React Router - Client-side routing
Lucide React - Icon library
QRCode.js - QR code generation

Backend

Node.js - JavaScript runtime
Express - Web framework
MongoDB - NoSQL database
Mongoose - MongoDB ODM
Ethers.js - Blockchain interaction
CORS - Cross-origin resource sharing
dotenv - Environment variable management

Smart Contracts

Solidity ^0.8.20 - Smart contract language
Hardhat - Ethereum development environment
OpenZeppelin - Secure smart contract library
ERC-721 - NFT token standard

📋 Prerequisites

Before running this project, make sure you have:

Node.js (v16 or higher)
npm or yarn
MongoDB (local or cloud instance)
MetaMask browser extension
Git

🚀 Installation & Setup

1. Clone the Repository

git clone https://github.com/Jiyasingh06/Digital_Payment_Project.git
cd Digital_Payment_Project-main

2. Install Dependencies

Frontend

npm install

Backend

cd backend
npm install
cd ..

Smart Contracts

cd smart-contract
npm install
cd ..

3. Environment Configuration

Create a .env file in the root directory:

# MongoDB Configuration
MONGODB_URI=mongodb://localhost:27017/ticketnft

# Backend Port
PORT=5000

# Blockchain Configuration
RPC_URL=http://127.0.0.1:8545
PRIVATE_KEY=your_private_key_here

# Contract Address (will be set after deployment)
CONTRACT_ADDRESS=your_deployed_contract_address

4. Start MongoDB

Make sure MongoDB is running on your system:

# For local MongoDB
mongod

Or use a cloud MongoDB service like MongoDB Atlas.

5. Deploy Smart Contracts

Start Local Blockchain (Hardhat)

cd smart-contract
npm run node

Deploy Contract (in a new terminal)

cd smart-contract
npm run deploy:local

Copy the deployed contract address and update it in:

.env file
src/web3/deployment.json

6. Seed Database (Optional)

cd backend
node seedDatabase.js

7. Start the Application

Terminal 1: Start Backend Server

cd backend
npm start
# or for development with auto-reload
npm run dev

Terminal 2: Start Frontend

npm run dev

The application will be available at:

Frontend: http://localhost:5173
Backend API: http://localhost:5000
Blockchain: http://localhost:8545

📁 Project Structure

Digital_Payment_Project-main/
├── src/                      # Frontend source code
│   ├── components/           # React components
│   │   ├── Header.tsx
│   │   └── MetaMaskPrompt.tsx
│   ├── context/              # React context providers
│   │   └── WalletContext.tsx
│   ├── pages/                # Page components
│   │   ├── EventsPage.tsx
│   │   ├── MyTicketsPage.tsx
│   │   ├── TransferPage.tsx
│   │   └── VerifyPage.tsx
│   ├── utils/                # Utility functions
│   │   ├── api.js
│   │   └── qrcode.js
│   ├── web3/                 # Web3 integration
│   │   ├── connectWallet.js
│   │   ├── contract.js
│   │   ├── contractABI.json
│   │   └── deployment.json
│   ├── App.tsx               # Main app component
│   └── main.tsx              # Entry point
│
├── backend/                  # Backend API
│   ├── models/               # MongoDB models
│   │   ├── Event.js
│   │   └── Transaction.js
│   ├── routes/               # API routes
│   │   ├── eventRoutes.js
│   │   └── transactionRoutes.js
│   ├── server.js             # Express server
│   ├── seedDatabase.js       # Database seeding
│   └── package.json
│
├── smart-contract/           # Smart contracts
│   ├── contracts/            # Solidity contracts
│   │   └── TicketNFT.sol
│   ├── deploy.js             # Deployment script
│   ├── hardhat.config.js     # Hardhat configuration
│   ├── mint-bulk.js          # Bulk minting script
│   ├── mint-test-tickets.js  # Test ticket minting
│   └── package.json
│
├── index.html                # HTML template
├── vite.config.ts            # Vite configuration
├── tailwind.config.js        # Tailwind CSS config
├── tsconfig.json             # TypeScript config
└── package.json              # Root package.json

🎯 Usage

For Event Attendees

Connect Wallet: Click "Connect MetaMask" to link your wallet
Browse Events: View available events on the Events page
Purchase Tickets: Buy tickets using your connected wallet
View Tickets: Check your tickets in "My Tickets" section
Transfer Tickets: Transfer tickets to another wallet address
Verify Tickets: Use QR codes for ticket verification at events

For Event Organizers

Mint Tickets: Use the smart contract to create tickets for events
Verify at Entry: Scan QR codes to validate tickets
Track Sales: Monitor ticket sales through the blockchain

🔑 API Endpoints

Events

GET /api/events - Get all events
GET /api/events/:id - Get event by ID
POST /api/events - Create new event
PUT /api/events/:id - Update event
DELETE /api/events/:id - Delete event

Transactions

GET /api/transactions - Get all transactions
GET /api/transactions/:walletAddress - Get transactions by wallet
POST /api/transactions - Create new transaction

🧪 Testing

Smart Contract Testing

cd smart-contract
npm test

Test Scripts

# Test blockchain verification
node test-blockchain-verify.js

# Check ticket status
node check-tickets.js

# Test live state
node test-live-state.js

📱 Smart Contract Functions

Key Functions

mintTicket() - Mint a new ticket NFT
transferTicket() - Transfer ticket to another address
getTicketDetails() - Get ticket information
invalidateTicket() - Mark ticket as used
isTicketValid() - Check if ticket is valid
getEventTickets() - Get all tickets for an event

🔐 Security Features

Blockchain Immutability: Ticket data stored on blockchain
Ownership Verification: Each ticket has a verified owner
Transfer Protection: Only owner can transfer tickets
Double-spending Prevention: Tickets can only be used once
Smart Contract Security: Built with OpenZeppelin standards

🌐 Deployment

Deploy to Polygon Mumbai Testnet

Get test MATIC from Mumbai Faucet
Update hardhat.config.js with your credentials
Deploy contract:

npm run deploy:mumbai

Deploy Frontend

npm run build

Deploy the dist folder to:

Vercel
Netlify
GitHub Pages
Any static hosting service

🤝 Contributing

Contributions are welcome! Please follow these steps:

Fork the repository
Create a feature branch (git checkout -b feature/AmazingFeature)
Commit your changes (git commit -m 'Add some AmazingFeature')
Push to the branch (git push origin feature/AmazingFeature)
Open a Pull Request

📝 License

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

👥 Authors

Jiya Singh - @Jiyasingh06

🙏 Acknowledgments

OpenZeppelin for secure smart contract templates
Hardhat for Ethereum development environment
React and Vite for modern frontend tooling
Tailwind CSS for styling

📞 Support

For issues and questions:

Open an issue on GitHub
Check existing documentation
Review the code examples

🗺️ Roadmap

Add support for multiple blockchain networks
Implement ticket resale marketplace
Add price limits and royalties
Mobile app development
Enhanced analytics dashboard
Multi-language support
Integration with event platforms

⚠️ Disclaimer

This is an educational project. Always conduct thorough security audits before deploying smart contracts to production or handling real financial transactions.

Built with ❤️ using React, Solidity, and Web3 technologies

Name		Name	Last commit message	Last commit date
Latest commit History 2 Commits
backend		backend
smart-contract		smart-contract
src		src
.env.example		.env.example
.gitignore		.gitignore
README.md		README.md
eslint.config.js		eslint.config.js
index.html		index.html
package-lock.json		package-lock.json
package.json		package.json
postcss.config.js		postcss.config.js
tailwind.config.js		tailwind.config.js
test-metamask.html		test-metamask.html
tsconfig.app.json		tsconfig.app.json
tsconfig.json		tsconfig.json
tsconfig.node.json		tsconfig.node.json
vite.config.ts		vite.config.ts
yarn.lock		yarn.lock

Folders and files

Latest commit

History

Repository files navigation

🎫 NFT Ticketing System

🌟 Features

🏗️ Architecture

1. Frontend (React + TypeScript + Vite)

2. Backend (Node.js + Express + MongoDB)

3. Smart Contracts (Solidity + Hardhat)

🛠️ Tech Stack

Frontend

Backend

Smart Contracts

📋 Prerequisites

🚀 Installation & Setup

1. Clone the Repository

2. Install Dependencies

Frontend

Backend

Smart Contracts

3. Environment Configuration

4. Start MongoDB

5. Deploy Smart Contracts

Start Local Blockchain (Hardhat)

Deploy Contract (in a new terminal)

6. Seed Database (Optional)

7. Start the Application

Terminal 1: Start Backend Server

Terminal 2: Start Frontend

📁 Project Structure

🎯 Usage

For Event Attendees

For Event Organizers

🔑 API Endpoints

Events

Transactions

🧪 Testing

Smart Contract Testing

Test Scripts

📱 Smart Contract Functions

Key Functions

🔐 Security Features

🌐 Deployment

Deploy to Polygon Mumbai Testnet

Deploy Frontend

🤝 Contributing

📝 License

👥 Authors

🙏 Acknowledgments

📞 Support

🗺️ Roadmap

⚠️ Disclaimer

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages