Keryx-Labs/keryx-node v1.3.1-OPoI

Keryx-node-v1.3.1-OPoI

on GitHub

H3 activates at DAA 43,450,000 (≈ 2026-07-05 18:00 UTC).

⚠️ Action required — this is a hard fork

Every node and miner must upgrade before the activation DAA or they fork off the chain.

• Node operators: upgrade to v1.3.1.
• Miners: upgrade to keryx-miner v0.3.6 (fills the new header field + matching PoW salt).
• Pool operators: post-H3 a worker must return the walk's pomFinalState (or the pool must recompute it from the weights) — a nonce alone can no longer form a valid block.

Highlights

• From-scratch IBD restored. The block header now commits to the PoM walk's final_state (pomFinalState), which re-enables header-only PoW verification and real block levels. The pruning proof is bounded again (built in seconds instead of hours), so new nodes can sync from genesis and pruned datadirs are servable.
• Forced upgrade via PoM salt. The pre-pow-hash words feeding both PoM folds are salted at H3, so every walk trajectory and PoW value changes at the gate. Pre-H3 binaries — even ones patched to echo the header field — produce proofs that verify false.
• Ratio-reward v2 — fairer and un-gameable. Production is now counted per paid blue (an exact mirror of the payment set, which kills the ~1.7× chain-connectivity bias) over a DAA-sized 24h window (fixed duration, no longer drifting with mergeset size).
• Coinbase output cap aligned with the builder. The legacy K+2 cap is replaced by the OPoI builder's true structural bound 3*(K+1)+4 (379 on mainnet). The old cap could have halted the network on a large mergeset — the 2026-07-04 storm peaked two blues short. Era-gated at H3. Root-caused by @Dizzztroyer (#16).
• H2 inference-reward minimums enforced. Adds the consensus floors for Qwen3-1.7B (0.3 KRX) and Llama-3.3-70B-Q2 (4.0 KRX) that were missing since the H2 lineup. Gated at the same H3 DAA.
• Faster IBD. Windowed-production queries are now O(1) per blue (per-block window context hoisted + coinbase production memoized), removing a quadratic slowdown during sync.
• Consolidated activation banner logged at the H3 DAA.

What's Changed

• feat(consensus): commit the PoM walk final_state in the header — header-only PoW checks + real block levels
• feat(consensus): salt the pph words feeding both PoM folds at the H3 gate (POM_H3_PPH_SALT)
• feat(consensus): ratio-reward v2 — per-blue production accounting + DAA-sized 24h window
• fix(consensus): align the coinbase output cap with the OPoI builder (3*(K+1)+4), era-gated at H3 (#16) — @Dizzztroyer
• perf(consensus): O(1) per-blue windowed-production queries
• chore(consensus): gate the H2 inference_reward minimums at H3 (43,450,000)
• feat(consensus): consolidated H3 activation banner
• feat: warn when --connect mode isolates the node (#15) — @Dizzztroyer

Upgrading

git pull origin master
cargo build --release --bin keryxd

Restart keryxd before DAA 43,450,000.