tyche-test-and-verify

Run pnpm --filter @tyche/<pkg> followed by typecheck, test, lint, and build in that order, requiring each step green before the next. Tests use node --test with tsx and co-located *.test.ts files importing from node:test and node:assert/strict.

Run all contract work inside a pinned rust:1.91-bookworm Docker container via scripts/run-cargo.mjs, mounting a volume for the toolchain and deploy keypairs. SBF instruction tests run with --test-threads=1 because they are flaky in parallel.

Code gated by #[cfg(feature=...)] is only checked under the matching feature set, so the default build misses devnet-test branches and --all-features misses the production cfg(not(...)) branch. Both clippy runs are required for full coverage.

tsx watch does not hot-reload over Windows bind mounts, so the container keeps old code until you run docker compose restart. One-off docker exec tsx invocations do read current source since tsx recompiles each run.

Use a read-only simulateTransaction with sigVerify false and replaceRecentBlockhash true to reproduce the failure as any wallet. The simulation logs print the Error Code and Error Number without requiring a signature or broadcast.

All three stores must agree: on-chain TurnState and Claim PDAs, API projections like GET /rounds and verification results, and the hash-linked audit chain with integrity true. Re-running the broadcast must be a no-op returning already_closed.