Skip to content

docs(plan): RG0 ratified — RT-G13 isolated cutover clamp verified INERT (NOT-A-BUG)#160

Merged
dzhelezov merged 1 commit into
mainfrom
docs/rg0-rtg13-ratified
Jul 12, 2026
Merged

docs(plan): RG0 ratified — RT-G13 isolated cutover clamp verified INERT (NOT-A-BUG)#160
dzhelezov merged 1 commit into
mainfrom
docs/rg0-rtg13-ratified

Conversation

@dzhelezov

Copy link
Copy Markdown
Collaborator

RG0 ground-truth ratification

Resolves the RG0 gate's open question: does the isolated historical→realtime cutover adopt a stale-LOW refetched finalized boundary? Answer, verified: no — it is guarded, not unconditional.

Mechanism (upstream, not the fork)

getHistoricalEventsIsolated in packages/core/src/runtime/historical.ts breaks before the boundary assignment whenever

hexToNumber(finalizedBlock.number) − hexToNumber(params.syncProgress.finalized.number) <= params.chain.finalityBlockCount

and only otherwise runs params.syncProgress.finalized = finalizedBlock. A stale-LOW clamp yields a negative delta, always <= finalityBlockCount (≥ 0), so the break fires and the below-floor boundary is never adopted. The multichain site's floor is load-bearing only because its post-catchup assignment is unconditional; the isolated site has no such path.

Verification

  • Two blind reviewers — independent reasoning + a grafted-source read across all pinned versions (0.15.17 / 0.16.6–0.16.9, identical guard shape) — both NOT-A-BUG.
  • Re-verified first-hand against raw upstream 0.16.9 historical.ts:827-835.

Disposition

RT-G13 reclassified must-verify→must-fix ⇒ should-fix. RT-2 still lands the floor for defense / doc-parity, but its mutation-verified test pins the upstream guard (weaken the <= comparison ⇒ a stale-low block is adopted ⇒ test fails), not the floor — removing the floor alone cannot fail the test.

Docs-only: marks the RG0 gate MET and records the verdict in the RT-G13 register entry + summary.

🤖 Generated with Claude Code

…RT (NOT-A-BUG)

RG0's ground-truth question (does the isolated historical->realtime cutover
adopt a stale-LOW refetched boundary?) is resolved: it does NOT. Upstream's own
adoption guard in getHistoricalEventsIsolated breaks before the assignment
whenever (finalizedBlock.number - syncProgress.finalized.number) <=
finalityBlockCount; a stale-low clamp gives a negative delta, always <=
finalityBlockCount, so the below-floor boundary is never adopted. The multichain
site's floor: is load-bearing only because that site's post-catchup assignment
is unconditional; the isolated site has no such path.

Verified three ways: two blind reviewers (independent reasoning + grafted-source
read across all pinned versions) plus a first-hand re-check of raw upstream
0.16.9 historical.ts:827-835. RT-G13 reclassified must-verify->must-fix =>
should-fix: RT-2 still lands the floor for defense/doc-parity, but the
mutation-verified test pins the upstream guard (weaken the <= comparison =>
stale-low block adopted => fail), not the floor.

Records the RG0 verdict + marks the RG0 gate MET in the campaign plan.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@dzhelezov dzhelezov merged commit 5d52d51 into main Jul 12, 2026
14 checks passed
@dzhelezov dzhelezov deleted the docs/rg0-rtg13-ratified branch July 12, 2026 11:00
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant