Trust & ops

Architecture

Browser-first architecture: UI, local storage, and Tether WDK. No pot backend.

System overview

Browser
├── Landing (/)
├── App (/app)
├── Pot room (/pot/[id])
├── Import (/import)
├── Docs (/docs)
├── sessionStorage → encrypted seed vault + address meta
├── memory → plaintext seed only while unlocked
├── localStorage → pot records
└── Tether WDK → EVM RPC (sign, balance, transfer)

Layers

Layer	Responsibility
UI (Next.js App Router)	Landing, app, pot room, docs
WDK client	Seed, address, sign, verify, ERC-20 transfer
Chain config	Token address, decimals, explorer, RPC
Store	Wallet session + pot persistence + share encode

Trust boundaries

Device — seed, signatures, pot JSON
Network — EVM RPC, optional USDt transfers, invite URLs
Host player — lock, settle, on-chain custody of stakes

Detailed diagrams also live in the repo: docs/ARCHITECTURE.md.

Stack

Next.js 16 + React 19 + TypeScript
Tailwind CSS 4
@tetherto/wdk + @tetherto/wdk-wallet-evm
Apache 2.0 license