Real-time prediction markets for hackathon projects
🏆 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.
- 🎥 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
| 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 |
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]
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
| 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. |
- Node ≥ 18
- pnpm ≥ 9
- Flow CLI
- Docker (for PostgreSQL)
- PostgreSQL ≥ 14
Standard installation process for Node.js monorepo with workspace dependencies, environment configuration, and Flow blockchain setup.
The project includes a comprehensive Makefile with colored output and organized commands for all development tasks.
make setup # Install dependencies and start database
make dev # Start all services in development mode
make help # Show all available commandsmake 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 codemake 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 mainnetmake 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 migrationsmake 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 imagesmake db-start # Start database container
make db-stop # Stop database container
make db-reset # Reset database (stop, remove volumes, start)make test # Run all tests
make test-frontend # Run frontend tests
make test-server # Run server testsmake clean # Clean all build artifacts
make clean-all # Clean everything including Dockermake all-dev # Start all services in development mode
make all-build # Build all services for production
make all-start # Start all services in production modeDevelopment 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.
- Frontend — pushed to
mainautomatically deploys to Vercel preview.productionbranch 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.
- 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.
- Create a feature branch
- Commit using Conventional Commits (
feat(ui): add project card) - Open a PR; templates auto-label scope
- CI must pass lint, tests, and contract size
MIT © 2025 LiveStakes Contributors
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