Complete the alpha-hardening Ralph task set, including tracker billing/accounting guards, validator fraud-audit primitives, wallet binding proof support, documentation runbooks, and updated tests. Verification: .venv/bin/python -m compileall -q packages tests; .venv/bin/python -m pytest -q --tb=short (313 passed, 3 skipped, 1 failed: tests/test_mining_cli.py::test_legacy_start_without_port_uses_next_available_port because meshnet-node pid 1263451 is already listening on port 7000).
28 lines
1012 B
Markdown
28 lines
1012 B
Markdown
Status: done
|
|
|
|
# 18 — DOC: Operational runbooks (stubs)
|
|
|
|
## What to build
|
|
|
|
Add operational runbook stubs for alpha operators under `docs/runbooks/` (or `.scratch/alpha-hardening/runbooks/` until close-feature):
|
|
|
|
1. **Ledger backup** — billing SQLite, accounts SQLite, registry DB paths; gossip pause procedure
|
|
2. **Treasury key rotation** — devnet mock-USDT mint + treasury keypair rotation without double-credit
|
|
3. **Upgrade path** — tracker rolling restart with persisted strike/reputation (post issue 05)
|
|
|
|
## Acceptance criteria
|
|
|
|
- [ ] Three markdown runbook stubs with prerequisites, steps, rollback
|
|
- [ ] Reference ADR-0015 settlement loop and ADR-0016 trust assumptions
|
|
- [ ] Secrets handling: never commit `.env.devnet`, keypairs
|
|
- [ ] No production code changes
|
|
|
|
## ADR links
|
|
|
|
- [ADR-0015](../../docs/adr/0015-usdt-custodial-settlement.md)
|
|
- [ADR-0016](../../docs/adr/0016-alpha-scope-and-known-limitations.md)
|
|
|
|
## Blocked by
|
|
|
|
None (stubs can land before issue 05; update after persistence ships)
|