LiveStakes 🎥💰

Real-time prediction markets for hackathon projects

🌐 www.livestakes.fun

---

👤 Created by Molly Beach, Ziz Khu, and Joao Santos

---

1. Overview 🔍

🏆 ETHGlobal Cannes Finalist 🏆 A real-time 📈 prediction market 💰 & livestream dashboard engagement 🎥 for hackathons. View live project demos, place on-chain predictions, & earn crypto rewards for accurate forecasts. All interactions are powered by smart contracts & decentralized video infrastructure. Created by Molly Beach, Ziz Khu, Joao Santos. LiveStakes is an open source platform that lets viewers watch every ETHGlobal hackathon project in real time and place on-chain predictions on which ones will win prizes. Teams broadcast live demos through WebRTC while the Hedera Agent Kit analyzes livestream environment and voice data to automatically create betting markets and predict winners using an automated market maker. When the AI makes final decisions, the Flow blockchain contracts settle and payout bettors instantly.

It contains the Next.js frontend, Flow smart contracts, Hedera Agent Kit integration, WebRTC streaming server, and infrastructure as code required to deploy the complete system.

---

2. Feature Highlights ✨

• 🎥 Live project video streaming powered by WebRTC and Express server
• 🤖 AI-powered betting market creation using Hedera Agent Kit analysis
• 🎙️ Voice and environment data processing for automated winner prediction
• 📈 Dynamic prediction markets with CPMM pricing on Flow blockchain
• 💹 Real-time odds adjustment based on AI insights
• 🔁 Re-allocation of positions before AI makes final decisions
• 🔐 Privy wallet authentication for seamless Web3 onboarding
• 📊 Real-time stats (bet volume, price movement, AI confidence scores) via PostgreSQL

---

3. Tech Stack 🛠️

Layer	Technology
💻 Frontend	Next.js 14, React 18, TailwindCSS, shadcn/ui, Flow Client Library
📜 Smart contracts	Cadence (Flow), Flow CLI, Flow Emulator
🤖 AI Decision Engine	Hedera Agent Kit, Voice Analysis, Environment Processing
🎥 Live Streaming	WebRTC, Express.js, Socket.io
🗂️ Database	PostgreSQL, Prisma ORM
🌐 Off-chain API	Node 18 (Express), WebRTC signaling server
🔐 Auth	Privy (Wallet Connection), GitHub OAuth
🚀 DevOps	Turborepo, GitHub Actions, Vercel, Flow Testnet

---

4. Architecture 🧠

flowchart TD
  FE[Next.js Frontend] <--> API[Express API]
  FE <--> WS[WebRTC Streaming]
  FE --> PV[Privy Auth]
  API --> DB[(PostgreSQL)]
  API --> FC[Flow Contracts]
  HAK[Hedera Agent Kit] --> API
  HAK --> WS
  WS --> VA[Voice Analysis]
  WS --> ED[Environment Detection]
  VA --> HAK
  ED --> HAK
  HAK --> BM[Bet Market Creation]
  HAK --> WP[Winner Prediction]

Loading

---

5. Repository Directory Structure 📁

livestakes/
├─ apps/
│  ├─ web/                 # Next.js frontend (App Router)
│  └─ streaming-server/    # Express WebRTC signaling server
├─ packages/
│  ├─ contracts/           # Flow Cadence contracts and tests
│  ├─ hedera-agent/        # Hedera Agent Kit integration and AI logic
│  └─ ui/                  # Shared React component library (shadcn/ui wrappers)
├─ infra/
│  ├─ terraform/           # Vercel, PostgreSQL, Flow network resources
│  └─ gh-actions/          # Reusable workflow templates
├─ scripts/                # Helper scripts (deploy, seed, data-export)
├─ docs/                   # Additional specs, diagrams, decision logs
├─ .github/
│  └─ workflows/           # CI pipelines: lint, test, contract size, AI model validation
├─ turbo.json              # Turborepo pipeline config
├─ flow.json               # Flow network configuration
└─ README.md               # You are here

Directory Details 📦

Path	Purpose
apps/web	🌐 Public site and dashboard. Contains pages, components, hooks, and Flow blockchain integration.
apps/streaming-server	📡 Express server handling WebRTC signaling, Socket.io connections, and livestream management.
packages/contracts	🔏 Flow Cadence smart contracts, Flow CLI tests, and deployment scripts for prediction markets.
packages/hedera-agent	🤖 Hedera Agent Kit integration for AI analysis, voice processing, and automated betting decisions.
packages/ui	🎨 Design-system primitives wrapped around shadcn/ui for consistent styling.
infra/terraform	🏗️ Infrastructure definitions for Vercel projects, PostgreSQL database, and Flow network endpoints.
scripts	⚙️ Type-scripted CLI utilities for project onboarding, market creation, and database seeding.

---

6. Getting Started 🚀

6.1 Prerequisites ✅

• Node ≥ 18
• pnpm ≥ 9
• Flow CLI
• Docker (for PostgreSQL)
• PostgreSQL ≥ 14

6.2 Installation 💾

Standard installation process for Node.js monorepo with workspace dependencies, environment configuration, and Flow blockchain setup.

6.3 Makefile Commands 🛠️

The project includes a comprehensive Makefile with colored output and organized commands for all development tasks.

Quick Start Commands

make setup          # Install dependencies and start database
make dev           # Start all services in development mode
make help          # Show all available commands

Frontend Commands

make frontend-install    # Install frontend dependencies
make frontend-dev        # Start Next.js development server
make frontend-build      # Build frontend for production
make frontend-start      # Start frontend production server
make frontend-lint       # Lint frontend code

Blockchain Commands

make blockchain-compile           # Compile smart contracts
make blockchain-test             # Run blockchain tests
make blockchain-test-coverage    # Run tests with coverage
make blockchain-node             # Start local Hardhat node
make blockchain-clean            # Clean blockchain artifacts

# Deployment Commands
make deploy-local               # Deploy to local network
make deploy-sepolia            # Deploy to Sepolia testnet
make deploy-mainnet            # Deploy to Ethereum mainnet
make deploy-flow-testnet       # Deploy to Flow testnet
make deploy-flow-mainnet       # Deploy to Flow mainnet

Server Commands

make server-install     # Install server dependencies
make server-dev         # Start server in development mode
make server-dev-debug   # Start server in debug mode
make server-build       # Build server for production
make server-start       # Start server in production mode
make server-migrate     # Run database migrations

Docker Commands

make docker-dev         # Start development environment with Docker
make docker-prod        # Start production environment with Docker
make docker-build       # Build Docker images
make docker-clean       # Clean Docker containers and images

Database Commands

make db-start          # Start database container
make db-stop           # Stop database container
make db-reset          # Reset database (stop, remove volumes, start)

Testing Commands

make test              # Run all tests
make test-frontend     # Run frontend tests
make test-server       # Run server tests

Cleanup Commands

make clean             # Clean all build artifacts
make clean-all         # Clean everything including Docker

Combined Development Commands

make all-dev           # Start all services in development mode
make all-build         # Build all services for production
make all-start         # Start all services in production mode

6.4 Start All Services 🔧

Development environment includes PostgreSQL database, Flow emulator, Hedera Agent Kit AI service, WebRTC streaming server, and Next.js frontend all running concurrently through Turborepo.

Navigate to http://localhost:3000 to see LiveStakes in action.

---

7. Deployment 🚢

• Frontend — pushed to main automatically deploys to Vercel preview. production branch triggers production promotion.
• Streaming Server — deployed to Vercel as serverless functions with WebRTC support.
• Contracts — tagged releases deploy against Flow Testnet, then Mainnet on manual approval.
• Hedera Agent — AI service deployed to cloud infrastructure with voice processing capabilities.

---

8. Testing 🧪

• Unit — Flow testing for Cadence contracts, Vitest for TypeScript.
• Integration — WebRTC streaming tests and AI prediction accuracy validation.
• End-to-end — Playwright scripts simulating complete bettor and streaming flow.

Comprehensive testing suite covers all components from smart contracts to AI models.

---

9. Contributing 🤝

1. Create a feature branch
2. Commit using Conventional Commits (feat(ui): add project card)
3. Open a PR; templates auto-label scope
4. CI must pass lint, tests, and contract size

---

10. License 📄

MIT © 2025 LiveStakes Contributors

Project Structure

livestakes/
├── .git/
├── common/
│   ├── ecosystem.config.js
│   ├── nginx.conf
│   ├── supervisord.conf
│   ├── supervisord.conf.dev
│   ├── uwsgi_params
│   └── wsgi.ini
├── pipeline/
│   ├── .dockerignore
│   ├── ansible.cfg
│   ├── check.sh
│   ├── deploy_buildx.sh
│   ├── deploy_home.sh
│   ├── deploy_ubuntu.sh
│   ├── deploy.sh
│   ├── Dockerfile
│   ├── main.yaml
│   └── stack.yml
├── scripts/
│   └── generate-flow-json.js
├── src/
│   ├── .next/
│   ├── app/
│   │   ├── about/
│   │   │   └── page.tsx
│   │   ├── api/
│   │   │   ├── livestreams/
│   │   │   │   └── route.ts
│   │   │   └── markets/
│   │   │   │   └── route.ts
│   │   ├── chart/
│   │   │   └── page.tsx
│   │   ├── chat/
│   │   │   └── page.tsx
│   │   ├── components/
│   │   │   ├── clientwrapper/
│   │   │   │   └── index.tsx
│   │   │   ├── ui/
│   │   │   │   ├── button.tsx
│   │   │   │   └── card.tsx
│   │   │   ├── BettingIndicator.tsx
│   │   │   ├── BettingModal.tsx
│   │   │   ├── CardContent.tsx
│   │   │   ├── Chat.tsx
│   │   │   ├── ConnectWallet.tsx
│   │   │   ├── CTA.tsx
│   │   │   ├── DashboardHeader.tsx
│   │   │   ├── FeatureCard.tsx
│   │   │   ├── Features.tsx
│   │   │   ├── Footer.tsx
│   │   │   ├── Header.tsx
│   │   │   ├── Hero.tsx
│   │   │   ├── HowItWorks.tsx
│   │   │   ├── Leaderboard.tsx
│   │   │   ├── LiveBadge.tsx
│   │   │   ├── LivestreamCard.tsx
│   │   │   ├── LivestreamSection.tsx
│   │   │   ├── MarketAssociationModal.tsx
│   │   │   ├── MarketCreationModal.tsx
│   │   │   ├── MarketFilter.tsx
│   │   │   ├── MarketHeader.tsx
│   │   │   ├── Markets.tsx
│   │   │   ├── Marquee.tsx
│   │   │   ├── Navigation.tsx
│   │   │   ├── NavItem.tsx
│   │   │   ├── OutcomeTable.tsx
│   │   │   ├── PageLayout.tsx
│   │   │   ├── PixelWindow.tsx
│   │   │   ├── PredictionGraph.tsx
│   │   │   ├── Profile.tsx
│   │   │   ├── PWAProvider.tsx
│   │   │   ├── SearchBar.tsx
│   │   │   ├── SideNav.tsx
│   │   │   ├── SocialIcon.tsx
│   │   │   ├── StreamCard.tsx
│   │   │   ├── Support.tsx
│   │   │   └── TradePanel.tsx
│   │   ├── context/
│   │   │   └── AuthContext.tsx
│   │   ├── data/
│   │   │   ├── features.ts
│   │   │   ├── howItWorks.ts
│   │   │   ├── livestreams.ts
│   │   │   ├── markets.ts
│   │   │   ├── marquee.ts
│   │   │   ├── profile.ts
│   │   │   └── support.ts
│   │   ├── features/
│   │   │   └── page.tsx
│   │   ├── howitworks/
│   │   │   └── page.tsx
│   │   ├── leaderboard/
│   │   │   └── page.tsx
│   │   ├── lib/
│   │   │   ├── cloudinary.ts
│   │   │   ├── contractsApi.ts
│   │   │   └── livestreamsApi.ts
│   │   ├── livestreams/
│   │   │   └── page.tsx
│   │   ├── markets/
│   │   │   └── page.tsx
│   │   ├── profile/
│   │   │   └── page.tsx
│   │   ├── support/
│   │   │   └── page.tsx
│   │   ├── globals.css
│   │   ├── layout.tsx
│   │   ├── not-found.tsx
│   │   └── page.tsx
│   ├── blockchain/
│   │   ├── artifacts/
│   │   │   ├── build-info/
│   │   │   │   └── e7b1899348a83502b2f4db86ca36448e.json
│   │   │   └── contracts/
│   │   │   │   ├── MarketFactory.sol/
│   │   │   │   │   ├── MarketFactory.dbg.json
│   │   │   │   │   └── MarketFactory.json
│   │   │   │   └── PredictionMarket.sol/
│   │   │   │   │   ├── IMarketFactory.dbg.json
│   │   │   │   │   ├── IMarketFactory.json
│   │   │   │   │   ├── PredictionMarket.dbg.json
│   │   │   │   │   └── PredictionMarket.json
│   │   ├── cache/
│   │   │   └── solidity-files-cache.json
│   │   ├── contracts/
│   │   │   ├── .DS_Store
│   │   │   ├── MarketFactory.sol
│   │   │   └── PredictionMarket.sol
│   │   ├── node_modules/
│   │   ├── scripts/
│   │   │   ├── deploy-testnet.js
│   │   │   ├── deploy.js
│   │   │   ├── getMarket.js
│   │   │   ├── getProject.js
│   │   │   └── setup-testnet.js
│   │   ├── test/
│   │   │   ├── MarketFactory.test.js
│   │   │   └── PredictionMarket.test.js
│   │   ├── transactions/
│   │   │   ├── claimPayout.js
│   │   │   ├── createMarket.js
│   │   │   ├── placeBet.js
│   │   │   └── resolveMarket.js
│   │   ├── .DS_Store
│   │   ├── .env
│   │   ├── .gitignore
│   │   ├── deployment-flow-testnet.json
│   │   ├── deployment-localhost.json
│   │   ├── FLOW_EVM_SETUP.md
│   │   ├── hardhat.config.js
│   │   ├── package.json
│   │   ├── pnpm-lock.yaml
│   │   └── README.md
│   ├── howitworks/
│   │   └── page.tsx
│   ├── node_modules/
│   ├── public/
│   ├── server/
│   │   ├── node_modules/
│   │   ├── src/
│   │   │   ├── database/
│   │   │   │   ├── db.ts
│   │   │   │   ├── dbInitialization.ts
│   │   │   │   ├── migrations.ts
│   │   │   │   └── transactions.ts
│   │   │   ├── routes/
│   │   │   │   ├── markets.ts
│   │   │   │   ├── marketsMetadata.ts
│   │   │   │   └── videoUpload.ts
│   │   │   ├── scripts/
│   │   │   │   ├── cleanBucket.ts
│   │   │   │   └── importVideos.ts
│   │   │   ├── services/
│   │   │   │   └── videoAnalysis.ts
│   │   │   ├── index.ts
│   │   │   └── migrate.ts
│   │   ├── temp/
│   │   ├── .env
│   │   ├── EXAMPLE_USAGE.md
│   │   ├── LIVESTREAMS_API.md
│   │   ├── MIGRATION.md
│   │   ├── package-lock.json
│   │   ├── package.json
│   │   ├── README.md
│   │   ├── tsconfig.json
│   │   └── VIDEO_IMPORT_SETUP.md
│   ├── .DS_Store
│   ├── .env
│   ├── .env.example
│   ├── .gitignore
│   ├── eslint.config.mjs
│   ├── next-env.d.ts
│   ├── next.config.js
│   ├── package.json
│   ├── pnpm-lock.yaml
│   ├── postcss.config.js
│   ├── README.md
│   ├── tailwind.config.js
│   └── tsconfig.json
├── .dockerignore
├── DATA_REQUIREMENTS.md
├── deploy.sh
├── docker-compose-local.yml
├── docker-compose.yml
├── docker-entrypoint.sh
├── Dockerfile
├── Dockerfile.dev
├── dump-livestakes.sql
├── Makefile
└── README.md