docs: prepare Mocha-5 network restart - #2546
Draft
jcstein wants to merge 6 commits into
Draft
Conversation
Contributor
|
🚀 Preview Deployment Your preview is ready: https://celestiaorg.github.io/docs-preview/pr-2546/ |
Collaborator
|
generally this looks good to me, only thing im unsure of is this? "give existing consensus operators a separate-home migration path that preserves mocha-4 data during cutover" so basically what we need here is to make sure all docs are updated, explorers will be since all explorer operators are also validators (except Celenium maybe?).. and as for the snapshot/data preservation, all that is needed is an exported file that lives somewhere for a while imo |
Review feedback: preserving mocha-4 history is a central responsibility, not something each consensus operator should carry. State that the Foundation will publish and host an exported copy of the final mocha-4 state, and that operator-side retention is optional. Keep the separate-home instructions, but justify them by their actual reason -- a reused home carries a mocha-4 priv_validator_state.json whose last-signed height blocks signing on a chain that restarts at height 1 -- rather than framing them as data preservation. The hosting location and retirement date are still TBD and are marked with a placeholder callout plus a draft blocker on the PR. Co-Authored-By: Claude <noreply@anthropic.com>
Drop the claim that the Foundation will publish and host an export of final mocha-4 state; that has not been decided. Say only that operators are not expected to retain mocha-4 data, that community-hosted archives or endpoints may exist without guarantee, and that anyone depending on mocha-4 history should export it before the restart. Co-Authored-By: Claude <noreply@anthropic.com>
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
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.
Summary
mocha-4tomocha-5priv_validator_state.jsondoes not block signing on a chain that restarts at height 1Closes PROTOCO-2189.
Why
Mocha-5 is a new height-1 chain rather than an in-place upgrade. Only account balances at the selected mocha-4 snapshot height carry over; later activity does not. Account sequences reset, staking positions become liquid balances, and the validator set, governance proposals, IBC channels, Hyperlane state, community pool, and other chain state do not carry over. The docs need to distinguish that restart from a routine network upgrade and stop emitting mocha-4 in current setup commands.
Impact
Once the launch artifacts are ready, Mocha node initialization, genesis/peer lookup, node-store paths, IBC configuration, and code examples will resolve to
mocha-5. Existing consensus operators are instructed to initialize mocha-5 under$HOME/.celestia-app-mocha-5and avoid copying old chain data or validator state into the new home. Keeping the mocha-4 home around is framed as an optional cutover fallback, not as an archival duty. An exported copy of the final mocha-4 state will be available for one month after the restart; its download location still needs to be added.Draft blockers
This PR is intentionally not ready to merge. Before cutover:
mocha-4state export URL; the export will remain available for one month after the restartcelestiaorg/networks/mocha-5genesis, seeds, and peersRelated work is tracked in PROTOCO-2187 (services and infrastructure), PROTOCO-2188 (celestia-app), PROTOCO-2190 (celestia-node), and DEVX-99 (validator outreach/gentx coordination).
Validation
npm run lint— passes with one pre-existing unrelated warning inNodeAPIContent.tsxnpm run build— passes, including static export, LLM-ready Markdown generation, and Pagefind indexingp2p.Network("mocha-5")git diff --check— passesmain, all inapp/build/blobstream/integrate-contracts/page.mdx; this PR does not change those links or the link checker