keryx-miner-supr 0.15.0 — H15 hard fork

Mandatory update before the Keryx H15 hard fork (mainnet DAA 140,115,000, expected around 2026-10-30 15:00 UTC). From that block on, every block needs a PoM v5 proof, a block-task root in its header and — for block candidates — a verifiable trace opening, and pools switch to stratum v4. Miners below 0.15.0 produce invalid blocks after the gate and are refused by pools that enforce the version floor.

The switch is driven by the block DAA in each job, never by wall-clock time: start 0.15.0 now and it keeps mining exactly like 0.14.7 until the gate, then changes over on its own. No restart, pool, wallet or model change is needed.

What changes at the gate

• PoM v5 context pad. The possession walk reads an additional per-tier context pad next to the model weights. It is generated on the GPU and walked with the same fast kernels as before (the chaseless kernel where the card supports it). The pad takes VRAM: while mining, the inference context is shrunk to a small block-task context and restored when the pool sends an inference request. A card with too little VRAM for its tier's pad logs a clear warning and stays idle instead of mining invalid work — move it to a lower tier with --force-model.
• Block task. For every ~64-block window the miner runs a short canonical inference pass on its own resident model and commits the resulting root into the block header before grinding. Block candidates ship a verifiable opening of that trace; the miner checks every opening with the node's own verifier before submitting, and runs a one-time self-check per card and tier when it starts mining post-gate.
• Stratum v4. The pool sends the full block header and the window seed; the miner hashes the header itself and submits a 7-field share. Pre-gate v3 jobs keep working unchanged; post-gate header-less (v3) jobs are skipped with a warning because they cannot carry a block-task root.
• Engine. libkeryx-llama.so / keryx-llama.dll (engine ABI 3) adds the canonical trace. Always ship the engine library that comes with this release next to the miner binary.

Platform notes

• NVIDIA (Linux modern/legacy, Windows, Docker): full H15 support.
• AMD (OpenCL/Vulkan) and Apple Silicon (Metal): these backends have no trace engine yet and therefore cannot commit a block-task root. They mine normally until the gate and then idle honestly with a warning instead of burning power on jobs that can never become valid blocks. H15 support for these lines follows in a later release.

Testnet / staging

KERYX_TESTNET=1 switches the complete activation table to the Keryx testnet parameters (the same role as upstream's --testnet). Individual KERYX_*_ACTIVATION_DAA overrides still take precedence. Without either, all gates are the mainnet constants.

Validation

Validated against a post-gate testnet pool and node: every submitted share accepted, block candidates verified by the node's verify_block_task and accepted into the chain; mainnet pre-gate mining verified unchanged against the production pool. Byte-exact unit vectors against the node for the v5 pad walk, the header layouts and the block-task opening are part of the test suite.

Downloads

Use the matching SHA256SUMS file to verify downloads.