- Operator guide: local stack, image and canary, launching a run, auditors, honeypots, production on a Cortex master, budget and teardown.
- Miner guide: hardware, config, admission and bond, determinism, audits and fault payments, troubleshooting.
- Protocol specification: envelopes, signatures, leaf scheme, round state machine, ledger, determinism checklist.
- Mechanism specification: audit math, adaptive audit rate, rewards, escrow and clawback, burn accounting, residual risks.
- Parity specification: topology for many replicas across datacenters, formulas, schedule, pre-registered TOST protocol, CPU grid results.
- Multi-GPU training and MFU: running the 1B island on several RTX 5090s over PCIe, every knob, measured MFU and its limits.
- Challenge routes: every HTTP route, body, auth and status code.
- Message schemas: JSON Schema for each signed message (RunManifest, Commit, DeltaManifest, Receipt, Forfeit, Dispute, Finalize and the rest). Regenerate with
uv run --frozen python -m hypertrain.protocol.schema docs/schemas. - Design notes.
Every local command in the two guides is run by bash scripts/doctest_docs.sh. Production-only commands are tagged doctest-skip:prod; the script lists them without running them.