Skip to content

README.md

Latest commit

 

History

History
85 lines (59 loc) · 3.97 KB

README.md

File metadata and controls

85 lines (59 loc) · 3.97 KB

🏆 Ticket Booking System on Aptos Blockchain

📌 1. Command to Run Code

🔹 Prerequisites

Ensure you have the following installed:

  • ✅ Node.js (Latest LTS version recommended)
  • ✅ npm (Comes with Node.js)
  • ✅ Aptos CLI (For blockchain interaction)
  • ✅ Petra Wallet Account (Required for authentication and transactions)

🚀 Installation & Running the Frontend

Use the following .env format and input the same in the 'client' folder.

VITE_GOOGLE_CLIENT_ID=857779810805-sbojmllvthbp03kjeuanbjn0a0neugfq.apps.googleusercontent.com # You can use this one although we aren't using google auth.
VITE_APP_ADMIN_WALLET=0x6cdc77d82e4936bd7ca3b052062680ade8c188bce9cd1eeea87a51dc4a8bf6d8 # the admin 
VITE_MODULE_ADDRESS=0x20650f016e8cf109b197528a28f4b2f3f574008fe69b24c3e2b75bd1b8a8aecd # this should be static and never changed.
VITE_APP_123=0x6cdc77d82e4936bd7ca3b052062680ade8c188bce9cd1eeea87a51dc4a8bf6d8 # this is the same as app admin.

cd client
npm install
npm run dev

This will start the frontend development server.

Youtube demonstration video : https://youtu.be/URwhuox4pbQ

Our Website link deployed live : http://20.191.66.216:5173/ (Please note that this website is hosted on my person Azure VM, and is 100% safe.)

If you face any issues with the live deployed website please localhost the website please.....

📂 2. Repository Structure

image

📝 3. Summary of the Code

This project is a decentralized ticket booking system built on the *Aptos blockchain. It enables users to *buy and sell tickets securely, ensuring transparency and trust through blockchain technology. The key components of the system are:

🔹 Solution Overview

Our solution ensures complete integrity and authenticity of event tickets by minting each ticket as a unique NFT on the *Aptos blockchain. The metadata of each ticket—such as event details, seat numbers, and ownership history—is securely stored on-chain, making it *tamper-proof and impossible to alter without authorization. This guarantees that every ticket is genuine, significantly reducing the risks of counterfeit tickets.

🎨 Frontend (Web Application)

Alt Text Alt Text

📌 Tech Stack: React (with Vite), Tailwind CSS, JavaScript

🔹 Responsibilities:

  • 🎟️ User Interface: Intuitive event listing, ticket purchase, and resale interface.
  • 🔗 Wallet Integration: Integration with Petra Wallet for authentication and transactions.
  • ⛓️ Blockchain Interaction: Uses Aptos SDK and Move contract APIs to interact with the blockchain.

🔑 Admin Panel (Movie Management)

🔹 Functionality:

  • 🎬 Create Movies: Admins can create new movie listings for ticket sales.

  • 📝 Manage Events: Modify event details like title, description, pricing, and availability.

  • 🎟 Ticket Configuration: Set limits on ticket quantities and pricing controls.

  • 📊 View Sales Data: Track ticket sales and revenue generated from events.

🔗 Smart Contracts (Move on Aptos)

🔹 Responsibilities:

  • 🔍 Ownership Validation: Prevents duplication and ensures verifiable ownership.
  • 💰 Price Controls: Enforces a 1.5x resale price cap via smart contract logic.
  • 🎶 Royalty Enforcement: Implements a 7.5% royalty on every resale to benefit organizers.

🔑 Wallet (Petra Wallet)

🔹 Functionality:

  • 🔐 User Authentication: Users connect wallets for login and transactions.
  • ✍️ Transaction Signing: Petra Wallet handles user-side transaction approvals.
  • 📖 Onboarding Experience: Provides guides for non-crypto users to set up and use Petra Wallet.

✅ Ensure your Aptos wallet is set up and configured before interacting with the system.