BitcoinII v31.1.0 documentation currentness audit — 2026-09-02
Date: 2026-09-02
Purpose
Section titled “Purpose”This record documents the MoreBC2 refresh triggered by BitcoinII Core v31.1.0 and the first deep follow-up audit of its principal BitcoinII-specific consensus changes.
The goal is to prevent current-facing MoreBC2 pages from continuing to present v29.1.0 as the current release, the pre-ShockWave 2016-block-only difficulty path as current behavior, or release-note feature names without source-path detail.
Current upstream baseline checked
Section titled “Current upstream baseline checked”- Canonical repository:
Bitcoin-II/BitcoinII-Core - Current release:
v31.1.0 - Published:
2026-08-29T02:39:30Z
Release notes identify:
- ShockWave per-block difficulty adjustment;
- consensus-level Ordinals, inscriptions, and Runes mitigation;
- BC2 transaction replay protection;
- fork-aware header synchronization;
- associated wallet, mining, mempool, RPC, validation, and PSBT updates.
Reviewed v31.1.0 mainnet chain parameters establish:
nShockWaveActivationHeight = 57750nDataRestrictionsHeight = 57750nReplayProtectionHeight = 57750nReplayProtectionForkId = 0x01324342- target block spacing remains 10 minutes
- default P2P port remains
8338 - Bitcoin-like address prefixes remain present
Deep consensus-source audit completed
Section titled “Deep consensus-source audit completed”The following release-note areas now have dedicated release-pinned Source Atlas reviews:
-
- activation boundary and production
GetNextWorkRequired()dispatch; - 25-block / 24-interval MTP rolling baseline;
- short-horizon response and timestamp moderation;
- emergency stall recovery constants and recovery behavior;
- mining candidate-time recalculation;
- exact history requirements for header synchronization.
- activation boundary and production
-
- fork-id selection by block height;
- signature-hash domain behavior;
- next-block mempool validation and activation-boundary mempool clearing;
- validation-cache separation;
- wallet, raw-transaction RPC, PSBT and external-signer paths.
-
- post-activation OP_RETURN count/size rules;
- OP_13 detection in OP_RETURN scripts;
- bare multisig restriction;
- Taproot annex, tapscript-size and Ordinals-envelope restrictions;
- block-connection enforcement;
- located unit/functional test surfaces.
-
- existing PRESYNC/REDOWNLOAD anti-DoS model;
- candidate branch anchoring at the known fork point;
- private 35-index branch-specific ShockWave/MTP history;
- exact
GetNextWorkRequired()verification during header sync; - per-peer state clearing on failure;
- located unit/fuzz test surfaces.
Current-facing pages refreshed in the v31 baseline pass
Section titled “Current-facing pages refreshed in the v31 baseline pass”README.mddocs/README.mddocs/documentation/what-is-bitcoinii.mddocs/documentation/network-specifications.mddocs/documentation/consensus-overview.mddocs/documentation/releases.mddocs/architecture/consensus-model.mddocs/encyclopedia/difficulty-adjustment.mddocs/encyclopedia/proof-of-work.mddocs/mining/mining-overview.mddocs/developers/source-atlas/pow-cpp.mddocs/developers/source-atlas/chainparams-cpp.mddocs/compatibility/known-breakpoints.mddocs/nodes/README.mddocs/releases/README.mddocs/releases/v31.1.0-assets.mddocs/verification/verification-index.mddocs/verification/known-unknowns.mddocs/verification/open-questions.md
The exchange integration/operator pages were refreshed separately immediately before this pass and are already v31.1.0-aware on main.
Historical records intentionally not rewritten
Section titled “Historical records intentionally not rewritten”Dated evidence records remain tied to the version and environment actually tested. Examples include:
docs/verification/local-node-inspection-2026-07-10.mddocs/verification/read-only-rpc-smoke-test-2026-07-10.mddocs/verification/release-artifact-authentication-2026-08-27.mddocs/verification/windows-node-operator-test-2026-08-27.mddocs/verification/windows-peer-discovery-test-2026-08-28.mddocs/releases/v29.1.0-assets.md
A historical record saying v29.1.0 is not stale merely because a newer release exists, provided the record clearly describes a dated v29.1.0 observation/test.
Wording rules after this audit
Section titled “Wording rules after this audit”Current-facing documentation should not say:
v29.1.0is the current BitcoinII release;- current BitcoinII mainnet changes difficulty only every 2016 blocks;
- Dark Gravity Wave alone is the current BitcoinII algorithm name;
- replay protection is an address-format change;
- the data restrictions constitute a proven blanket ban on every arbitrary-data protocol;
- header sync itself chooses the active chain;
- older local
v29.1.0RPC/node observations provev31.1.0runtime behavior.
Current-facing documentation may say:
- BitcoinII Core
v31.1.0is the current documented release as of this audit; - ShockWave applies per-block difficulty adjustment beginning at mainnet height
57750; - pre-57750 history used the inherited Bitcoin-style retarget path;
- v31 activates replay protection and data restrictions at height
57750; - replay protection adds a BC2 signature-hash domain with fork id
0x01324342; - the explicit post-activation transaction-data rules are documented from source;
- header synchronization reproduces branch-specific ShockWave history for candidate branches within the existing anti-DoS sync framework;
- historical tests remain version-scoped evidence.
Remaining follow-up priorities
Section titled “Remaining follow-up priorities”The first three source-mapping priorities from the original currentness pass are now substantially resolved at the source-review level.
Remaining high-value work:
- execute/map v31 consensus and header-sync tests locally;
- generate safe replay-protection pre/post-fork test vectors;
- run data-restriction activation-boundary tests;
- run current-release competing-branch/header-sync scenarios;
- review wallet/PSBT changes beyond the replay-protection path;
- review mempool/RPC/validation changes outside these audited features;
- review mining subsystem changes beyond difficulty;
- perform fresh
v31.1.0runtime node/RPC testing; - independently authenticate
v31.1.0release artifacts.
Evidence boundary
Section titled “Evidence boundary”This audit is a source/documentation review. It does not claim that every BitcoinII Core source file was diffed or that MoreBC2 executed the upstream test suite.
Where source paths are established, the documentation now records them. Where runtime/test evidence does not yet exist, the gap remains explicit.
Verification
Section titled “Verification”Status: Audit record
Primary sources checked: BitcoinII Core v31.1.0 release metadata and release-pinned source paths for chain parameters, difficulty, validation, transaction data rules, replay-protection signing/validation, wallet/PSBT, and headers synchronization
Notes: Use this record as the boundary between the initial v31 currentness refresh and the deeper feature-path audit completed on 2026-09-02.