Skip to content

Talent-Index/event-vax

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

276 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐ŸŽŸ๏ธ Eventverse.

๐ŸŒ Overview

Eventverse is a revolutionary blockchain-based ticketing platform engineered to combat fraud and inefficiencies in the event ticketing industry. Leveraging the Avalanche blockchain, our platform empowers event organizers to issue tickets as digital tokens, ensuring secure purchases, effortless resales, and QR-code-based authentication.

โœจ Key Features,

๐ŸŽŸ๏ธ Decentralized Ticket Minting & Transfer

  • Event organizers can mint unique, tamper-proof tickets with embedded event details.
  • Blockchain-backed transparency guarantees authenticity and secure transfers.

๐Ÿค– AI Assistant

  • An intelligent chatbot designed to help users navigate the EventVax platform
  • Provides accurate, context-aware answers about ticket purchasing, wallet connections, event creation, and more
  • Offers step-by-step guidance for blockchain interactions and NFT ticket management
  • Features a beautiful floating UI that's accessible throughout the platform

๐Ÿ“ฒ QR Code Verification

  • Each ticket is embedded with a unique QR code for instant and tamper-proof validation.
  • Eliminates counterfeit tickets and simplifies on-site verification.

๐Ÿ” Secure Blockchain Transactions

  • Powered by Avalanche, enabling fast, transparent, and cost-efficient ticket purchases and resales.
  • Immutable transaction records provide peace of mind for buyers and sellers.

๐Ÿ”„ Resale Marketplace

  • A decentralized marketplace for verified resale, maintaining ticket integrity and fair pricing.
  • Automated smart contracts prevent scalping and fraud.

๐Ÿ› ๏ธ Tech Stack

Languages & Frameworks

Languages & Frameworks

JavaScript Solidity React

Blockchain

Avalanche Web3.js

Development Tools

Foundry OpenZeppelin npm

๐Ÿš€ Getting Started

Prerequisites

  1. Install Node.js:

    # For Windows: Download and install from https://nodejs.org/
    
    # For Ubuntu/Debian
    sudo apt update
    sudo apt install nodejs npm
    
    # For macOS wicth Homebrew
    brew install node

    Verify installation with: node --version and npm --version

  2. Install Core Wallet:

    Core is the recommended wallet for interacting with Avalanche and the EventVax platform.

    • Download: https://core.app/
    • Browser Extension: Available for Chrome, Firefox, Brave, and Edge
    • Mobile App: Available on iOS and Android

    Setup Steps:

    1. Install the Core browser extension or mobile app
    2. Create a new wallet or import an existing one
    3. Securely backup your recovery phrase
    4. Switch to Fuji Testnet in network settings
  3. Get Test AVAX (Fuji Faucet):

    You'll need test AVAX to interact with the platform on Fuji testnet.

    Option 1: Official Avalanche Faucet

    Option 2: Core Faucet

    • Open Core wallet
    • Navigate to the faucet section
    • Request test AVAX directly from the wallet interface

    ๐Ÿ’ก Note: Faucet requests are limited to once per 24 hours per address

  4. Clone the repository:

    git clone https://github.com/JosephOkumu/event-vax.git
    
  5. Install dependencies:

    npm install
  6. Compile smart contracts:

    cd contracts
    forge build
  7. Configure Avalanche network: Create .env file in contracts/ directory:

    PRIVATE_KEY=your_private_key
    FUJI_RPC_URL=https://api.avax-test.network/ext/bc/C/rpc
    SNOWTRACE_API_KEY=your_api_key
    
  8. Deploy contracts (Already deployed to Fuji):

    forge script script/Deploy.s.sol --rpc-url $FUJI_RPC_URL --broadcast --verify
  9. Run the application locally:

    # First, install and run the backend server
    cd server
    npm install
    npm run dev
    
    # In a new terminal, run the frontend
    cd eventvax
    npm install
    npm run dev

๐Ÿ’ก Contract addresses are configured in src/config/contracts.js

๐Ÿ‘ฅ The Team

Name Role Contact
Williams Ochieng Smart Contract Dev williams@example.com
Joseph Okumu Otieno Full-stack Engineer jokumu25@gmail.com
John Mokaya Frontend Developer mokayaj857@gmail.com
Phillip Ochieng Frontend Developer oumaphilip01@gmail.com
Ouma Ouma Full-Stack Enginee ouma.godwin10@gmail.com

๐ŸŒ Waitlist Landing Page Integration

Screenshot 2025-01-21 151558

Key Deliverables:

  1. Landing Page Design

    Screenshot 2025-01-21 151517
  2. Tickets collection Screenshot 2025-01-21 161518

  3. Ticket sales

Screenshot 2025-01-21 151643
  1. Ticket Minting Screenshot 2025-01-21 151623

  2. QR code Intergration Screenshot 2025-01-21 162251

  3. Go Live!

    • Promote the page across social media and mailing lists.

๐ŸŽฅ Project Video Demo

Watch Project Video

๐Ÿ“ฝ๏ธ Click the image above to watch the full project demo hosted on Google Drive.

โ›ฐ๏ธ Avalanche Integration

๐Ÿš€ Why Avalanche?

  • Speed & Efficiency: Lightning-fast finality for instant ticket transfers within 2 seconds.
  • Low Costs: Affordable transactions for users and event organizers.
  • ๐Ÿ’ฐ Cost Efficiency
    • Minimal transaction fees
    • Economical for both users and operators

๐Ÿ”— Deployment Strategy

  • Our smart contracts are deployed on Avalanche's C-Chain to facilitate secure ticket operations.
  • Robust deployment pipeline via Foundry ensures reliability.

๐Ÿ“ Live Contracts (Fuji Testnet)

Contract Address
EventFactory 0x53687CccF774FDa60fE2bd4720237fbb8e4fd02c
Marketplace 0x5316aD9DB181111D7dA7AF4d139d223A1DdAB8E1
EventManager 0x1651f730a846eD23411180eC71C9eFbFCD05A871
QR Verification 0xd04E0B0959Ceb4f5Be7e29fc0d072368C1EC0e06

Explorer: View on Snowtrace

Deployment Details: See DEPLOYMENT.md

๐Ÿ”ฎ Vision.

Eventverse is redefining event ticketing by combining blockchain security with intuitive user experiences. Stay tuned for exciting updates and new features as we shape the future of event access!

๐Ÿ“Š Project Status

Development Status Build Status Test Coverage

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 7