⚡ BNBBrawl – Real-Time VCT Betting Platform on BNB Chain

BNBBrawl is a real-time esports wagering platform built in just 16 hours during a BNB Chain hackathon. It lets users predict outcomes of live Valorant Champions Tour (VCT) matches, place on-chain bets using BNB Testnet, and receive instant payouts via smart contracts when matches conclude.

---

🚀 Features

• 📅 Upcoming Matches – Fetches complete schedules of upcoming VCT matches.
• 🎮 Live Matches – Displays ongoing matches with real-time odds and team scores.
• 💸 On-Chain Betting – Users connect their wallets via MetaMask and place bets securely using the BNB Smart Chain Testnet.
• ⚡ Instant Payouts – Winnings are auto-calculated and disbursed via smart contracts based on odds at the time of bet placement.
• 🔄 Realtime Updates – Odds, match data, and bet history sync live to the frontend via Supabase Realtime + cron jobs.

---

🛠 Tech Stack

Frontend

• React.js + Vite
• TailwindCSS
• MetaMask Integration

Backend

• Express.js
• TypeScript
• Cheerio (for scraping match data from internet)

Database

• Supabase (PostgreSQL, Realtime)

Blockchain

• BNB Smart Chain (Testnet)
• Solidity Smart Contract (Escrow for bets + payouts)
• Ethers.js for backend integration

Infrastructure

• Cron jobs for:

  • Fetching upcoming matches (every 15 min)
  • Fetching live matches & odds (every 15–30 sec)
  • Settling completed matches & payouts (every 1–2 min)

---

📈 How It Works

1. Match Data Fetching

   • Scraper pulls upcoming and live VCT matches.
   • Stored in Supabase for real-time access.

2. Placing a Bet

   • User connects MetaMask → selects a live match → chooses a team.
   • Odds snapshot is saved in Supabase.
   • Bet transaction is sent to BNB testnet smart contract.

3. Match Settlement

   • Cron detects when a match is completed.
   • Result is fetched → smart contract payout function triggered.
   • Winners receive (bet_amount * odds) instantly.

---

🔗 Smart Contract

A minimal escrow contract on BNB Testnet that:

• Stores bets against match IDs.
• Holds funds until match completion.
• Releases winnings automatically after admin triggers settlement.

---

📂 Project Structure

BNBBrawl/
├── backend
│   ├── package-lock.json
│   ├── package.json
│   ├── src
│   │   ├── app.ts
│   │   ├── controller
│   │   │   ├── Bets.ts
│   │   │   ├── VLR.ts
│   │   │   └── sample.html
│   │   ├── middleware
│   │   │   └── VLR.ts
│   │   ├── routes
│   │   │   └── VLR.ts
│   │   └── util
│   │       ├── common.ts
│   │       ├── proxies.helper.ts
│   │       ├── responseMaker.helper.ts
│   │       ├── web3.helper.ts
│   │       └── winstonLogger.ts
│   └── tsconfig.json
├── fifa-ai
│   ├── main.py
│   ├── requirements.txt
│   └── yolov8n.pt
├── frontend
│   ├── BETTING_SETUP.md
│   ├── README.md
│   ├── eslint.config.js
│   ├── index.html
│   ├── package-lock.json
│   ├── package.json
│   ├── public
│   │   ├── logo.png
│   │   └── vite.svg
│   ├── src
│   │   ├── App.css
│   │   ├── App.tsx
│   │   ├── assets
│   │   │   └── react.svg
│   │   ├── components
│   │   │   ├── BettingModal.tsx
│   │   │   ├── Header.tsx
│   │   │   ├── Hero.tsx
│   │   │   ├── LiveStreams.tsx
│   │   │   ├── Matches.tsx
│   │   │   ├── SideNav.tsx
│   │   │   └── WalletConnect.tsx
│   │   ├── config
│   │   │   └── contract.ts
│   │   ├── hooks
│   │   │   └── useAuth.ts
│   │   ├── index.css
│   │   ├── main.tsx
│   │   ├── pages
│   │   │   └── Home.tsx
│   │   ├── services
│   │   │   ├── apiService.ts
│   │   │   ├── bettingService.ts
│   │   │   └── web3Service.ts
│   │   ├── utils
│   │   │   └── testBetting.ts
│   │   └── vite-env.d.ts
│   ├── tsconfig.app.json
│   ├── tsconfig.json
│   ├── tsconfig.node.json
│   └── vite.config.ts
└── smartContracts
    ├── README.md
    ├── artifacts
    │   ├── abi.json
    │   └── bytecode.txt
    ├── contracts
    │   └── MultiTokenEscrow.sol
    ├── hardhat.config.js
    ├── package.json
    ├── scripts
    │   └── deploy.js
    └── test
        └── MultiTokenEscrow.test.js

---

⚙️ Setup & Installation

Prerequisites

• Node.js (>=16)
• MetaMask (configured with BNB Testnet)
• Supabase project with Postgres DB
• Remix or Hardhat for contract deployment

Backend Setup

cd backend
npm install
npm run dev

Configure .env file with:

X_API_KEYS=your-api-key
SUPABASE_URL = ...
SUPABASE_SERVICE_ROLE_KEY=your-supabase-key
PRIVATE_KEY=your_wallet_private_key
BSC_TESTNET_RPC=https://data-seed-prebsc-1-s1.binance.org:8545/
BSC_MAINNET_RPC=https://bsc-dataseed.binance.org/
BSCSCAN_API_KEY=
ESCROW_ADDRESS=.....

Frontend Setup

cd frontend
npm install
npm run dev

---

🎥 Demo

▶️ Watch Demo Video

---

👥 Team

• Vikrant Singh – Backend, Data scraping + odds logic
• Aryaman Raj – Integrations
• Sweta Karar – UI/UX & Frontend (React.js)
• Tejasvi Kumar – Smart Contracts
• Soumik Baksi – AI Vision

---

🏆 Hackathon

Built during BNB Chain Hackathon 2025 in 16 hours.

---

📌 Roadmap

• Deploy production-ready contracts on BNB Mainnet
• Implement dynamic odds calculation (based on bets placed)
• Add leaderboard & user profiles
• Multi-game support (LoL, CS2, Dota2)