feat: King of the Hill 85/10/5 payouts

[kenobijon]

Summary

Updating to a King of the Hill competition where continuous payouts are made to the king + the past 2 kings for each modality, 85/10/5.

Tested on testnet

• Full 85/10/5 chain on image, video, and audio (three distinct kings each).
• Validator weight builder against the live kings payload: slot weights match 40%×85/10/5 and 4%×85/10/5, unused generator share burns, vector sums to 1.0.
• Dethrone margin: +0.009 keeps the king, +0.010 transfers; sitting king restored.
• Unit tests for residual rollup and burn.

---

Note

High Risk
Validator weight-setting is a core subnet change: escrow routing is removed in favor of API-driven KOTH splits, with discriminator emissions gated on external API metadata—misconfiguration or stale kings data directly affects TAO distribution.

Overview
v5.0.0 replaces round-based / escrow discriminator rewards with King of the Hill: validators pull kings from GAS (/api/v1/validator/kings), cache them across restarts, and set weights via new build_koth_weights — 40% / 40% / 4% image / video / audio lanes plus 16% generators, with each lane split 85 / 10 / 5 across the current king and the last two distinct crowned hotkeys (missing kings or API gaps burn to the burn UID). Discriminator lane payouts stay off until GAS publishes emissions_enabled and a passed emissions_start_at; generators are unchanged during warmup.

Discriminator push is hardened: duplicate-hash (409) uploads count as success, chain registration is optional (--skip-chain), capped retries (--max-retries), configurable upload URL, and the CLI/process exits cleanly after push (os._exit, exit-code propagation). Upload success no longer fails when on-chain metadata is missing or chain registration exhausts retries.

Docs align with one counted model per hotkey (not three modalities per key) and document KOTH rules, defense, and dethrone margin; validator guides are consolidated. PM2 config honors NETUID and EPOCH_LENGTH env overrides.

^{Reviewed by Cursor Bugbot for commit 8098fa1. Bugbot is set up for automated code reviews on this repo. Configure here.}

[cursor]

Cursor Bugbot has reviewed your changes using default effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit a14ffd8. Configure here.}