🎟️ TicketMint

The Future of Decentralized Event Ticketing

Secure • Transparent • Immutable

---

📋 Table of Contents

1. 🤖 About The Project
2. ⚙️ Tech Stack
3. ✨ Key Features
4. 📸 Screenshots
5. 🚀 Getting Started
6. 📜 Smart Contract Info
7. 🛣️ Roadmap
8. 🤝 Contributing

---

🤖 About The Project

TicketMint is a decentralized event ticketing platform built on the Polygon blockchain. It addresses the critical issues plaguing the traditional ticketing industry—scalping, counterfeit tickets, and lack of transparency.

By leveraging NFT (Non-Fungible Token) technology, every ticket issued on TicketMint is a unique digital asset. This ensures verifiable ownership, allows for controlled secondary market trading, and provides organizers with real-time data on ticket lifecycles.

---

⚙️ Tech Stack

Component	Technology	Description
Blockchain		High-speed, low-cost EVM network (Mumbai/Mainnet)
Smart Contracts		Core logic for minting and validation (ERC-721)
Frontend		Interactive UI with Hooks and Context API
Styling		Responsive and modern design framework
Web3 Client		Blockchain interaction and state management
Storage		Decentralized storage for NFT metadata

---

✨ Key Features

• 🎫 Verifiable NFT Tickets: Every ticket is an ERC-721 token, preventing duplication and fraud.
• 💳 Seamless Payments: Purchase tickets directly using crypto via MetaMask.
• 🧾 Resale Controls: Smart contracts can enforce royalty fees or price caps on secondary sales.
• 📱 QR Validation: (Planned) On-chain ownership verification via QR codes at entry.
• 🖼️ Dynamic Metadata: Event details stored securely on IPFS.
• ⚡ Low Gas Fees: Optimized for the Polygon network to ensure affordability for users.

---

📸 Screenshots

Landing Page

---

🚀 Getting Started

Follow these steps to set up the project locally.

Prerequisites

• Node.js (v16.x or higher)
• MetaMask Wallet (Browser Extension)
• Git

Installation

1. Clone the repository

   git clone [https://github.com/16Prithvi/ticketmint.git](https://github.com/16Prithvi/ticketmint.git)
   cd ticketmint

2. Install dependencies

   npm install
   # or
   yarn install

3. Configure Environment Variables Create a .env file in the root directory:

   REACT_APP_ALCHEMY_API_URL=your_alchemy_url_here
   REACT_APP_CONTRACT_ADDRESS=your_deployed_contract_address

4. Run the application

   npm start

The app should now be running on http://localhost:3000.

---

📜 Smart Contract Info

• Network: Polygon Mumbai Testnet
• Contract Address: 0x... (Add your deployed address here)
• Standard: ERC-721 (OpenZeppelin)

To deploy the contracts yourself:

npx hardhat run scripts/deploy.js --network mumbaierifiable NFT Tickets:** Every ticket is an ERC-721 token, preventing duplication and fraud.
* **💳 Seamless Payments:** Purchase tickets directly using crypto via MetaMask.
* **🧾 Resale Controls:** Smart contracts can enforce royalty fees or price caps on secondary sales.
* **📱 QR Validation:** (Planned) On-chain ownership verification via QR codes at entry.
* **🖼️ Dynamic Metadata:** Event details stored securely on IPFS.
* **⚡ Low Gas Fees:** Optimized for the Polygon network to ensure affordability for users.

---


## 🚀 Getting Started

Follow these steps to set up the project locally.

### Prerequisites

* **Node.js** (v16.x or higher)
* **MetaMask Wallet** (Browser Extension)
* **Git**

### Installation

1.  **Clone the repository**
    ```bash
    git clone [https://github.com/16Prithvi/ticketmint.git](https://github.com/16Prithvi/ticketmint.git)
    cd ticketmint
    ```

2.  **Install dependencies**
    ```bash
    npm install
    # or
    yarn install
    ```

3.  **Configure Environment Variables**
    Create a `.env` file in the root directory:
    ```env
    REACT_APP_ALCHEMY_API_URL=your_alchemy_url_here
    REACT_APP_CONTRACT_ADDRESS=your_deployed_contract_address
    ```

4.  **Run the application**
    ```bash
    npm start
    ```

The app should now be running on `http://localhost:3000`.

---

## 📜 Smart Contract Info

* **Network:** Polygon Mumbai Testnet
* **Contract Address:** `0x...` (Add your deployed address here)
* **Standard:** ERC-721 (OpenZeppelin)

To deploy the contracts yourself:
```bash
npx hardhat run scripts/deploy.js --network mumbai