Skip to content

Repository files navigation

Game Night

Status: a testing deployment, played for play money. Everything at gamenight.faithnet.io — hold'em, canasta, clubs, coaches, buy-ins and cash-outs — runs on Sheqel, a test coin with an open mint that is worth nothing anywhere else. Nothing here is a wager, nothing is owed, and the deployment exists so people can play and so the card room and the Agentic Primitives substrate can be exercised end to end. It is not a real-money service and has not been assessed as one. The architecture and security audit that says exactly what is and is not in place is docs/AUDIT-2026-09-13.md; read its §7 before pointing any of this at an asset with value.

Texas Hold'em table service on the faithnet estate. People and AI Smart Agents sit at the same tables; buy-ins and cash-outs settle in Sheqel — the card room's own currency (contracts/) — from each player's Smart Agent treasury on faithchain. Built on the Agentic Primitives substrate. Read docs/DESIGN.md for the architecture and phases.

Quick start (phase 1, play money, local)

pnpm install
pnpm test                       # engine, protocol, ledger, agent-kit, tables, web
pnpm dev:tables                 # Worker + Durable Objects on http://localhost:8787
pnpm dev:web                    # Vite client on http://localhost:5173
# seat two bots at a table:
pnpm --filter pokernight-agent bot -- --table <tableId> --seat 1 --buy-in 200 --name Ada
pnpm --filter pokernight-agent bot -- --table <tableId> --seat 2 --buy-in 200 --name Bob

scripts/smoke.mjs starts the server, creates a table, seats two bots and plays 20 hands.

Workspaces

Path Package Purpose
packages/engine @pokernight/engine pure NLHE engine: side pots, evaluation, seeded shuffle with commit–reveal
packages/protocol @pokernight/protocol zod wire schemas: WebSocket, HTTP, poker.act A2A skill
packages/ledger @pokernight/ledger chip ledger + SettlementAdapter (play-money; on-chain adapters in phase 3/4)
packages/agent-kit @pokernight/agent-kit helpers + rules-based strategy for agents
apps/tables pokernight-tables Cloudflare Worker: PokerTableDO (WebSockets, SQLite, alarms) + LobbyDO
apps/web pokernight-web Vite + React client
apps/agent pokernight-agent reference bots: WebSocket bot now, A2A poker.act in phase 2

Deploy (faithnet)

Live: https://gamenight.faithnet.io (client) and https://games.faithnet.io (API/WebSockets; poker.faithnet.io redirects, tables.faithnet.io still answers). Phase 1 uses dev sessions (DEV_AUTH=true, any name, play money) until Home OIDC login lands.

Each app has a wrangler.toml with an [env.faithnet] block. Deploy with WRANGLER_ENV=faithnet pnpm --filter pokernight-tables deploy. Secrets go through wrangler secret put. See docs/DESIGN.md §9 and §10 for the one-time estate prerequisites.

About

Game Night — a Texas hold'em card room where people and AI agents share a table, built on Agentic Primitives. The reference third-party app: passkey sign-in through a Home, buy-in mandates, a coach under a study grant, receipts.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages