Skip to content

README.md

Latest commit

 

History

History
41 lines (28 loc) · 1.17 KB

README.md

File metadata and controls

41 lines (28 loc) · 1.17 KB
Raw

Proof of Play (Somnia Fantasy Football MVP)

Monorepo starter for a 4-week MVP where users join single-match fantasy football rooms, Somnia agents fetch stats, contracts settle scores, and winners are paid on-chain.

Workspace layout

  • apps/web: Next.js app (frontend + API routes for demo fixtures/players/stats)
  • contracts: Solidity + Hardhat contracts and tests
  • packages/shared: shared TypeScript types and scoring constants
  • supabase: SQL schema for off-chain cache/index data
  • docs: architecture and implementation notes

Quick start

pnpm install
pnpm dev

Core routes (web)

  • /: Landing page
  • /rooms: List rooms
  • /rooms/create: Create room
  • /rooms/[id]: Join room, submit lineup, view status
  • /rooms/[id]/results: Final scores, receipt, payout status

Contract targets

  • MatchRoomFactory.sol
  • FantasyMatchRoom.sol
  • PlayerRegistry.sol

Notes

  • This scaffold uses deterministic demo data via API routes so settlement is demo-safe.
  • Replace demo stats endpoint with a live football API later without changing the on-chain room lifecycle.

Demo runbook

  • Local Anvil end-to-end flow: docs/e2e-local-demo-runbook.md