Repository navigation
[docs] Cover joining after launch and moving from testnet in the runbook - #1394
Merged
Bridgerz merged 1 commit intoOct 10, 2026
Merged
Conversation
|
0xsiddharthks
approved these changes
Oct 10, 2026
Bridgerz
added this pull request to stack #1393
October 10, 2026 00:24
- A validator that registers after launch must start or restart its node afterwards: hashi register does not write the node's next-epoch keys, so a node left running can be seated an epoch late. - A mainnet node needs its own empty db and its own backup-dir, not a testnet node's. - The testmempoolaccept withdrawal check and its two metrics are not in the 1.0 releases.
Bridgerz
force-pushed
the
bridgerzoske/runbook-late-join
branch
from
October 10, 2026 00:29
6aab800 to
fa1d991
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Stacked on #1392.
Summary
Three gaps a mainnet validator can hit that the runbook did not cover.
Changes
hashi registerrecords the registration but not the node's next-epoch BLS and encryption keys; the node writes those when it starts. A node that was already running when its validator registered can therefore miss the next committee formation and be seated an epoch late, so the section says to register and then start or restart. Five validators hit this on testnet-1.0.dband its ownbackup-dir. It also recommends new TLS and operator keys for mainnet.testmempoolacceptwithdrawal check and its twohashi_withdrawal_bitcoin_check_*metrics are documented but are not intestnet-1.0ormainnet-1.0. The runbook now says so.Verification
npm run buildindesign/passes and the new anchor resolves.mainnet-1.0commit: the register command passes no next-epoch keys, the node passes them at startup, and a node with no registration after genesis logs the quoted message.testmempoolacceptand both metrics have no occurrences in the source at that commit.