docs(cluster): note stale-output + contracts-ref pitfalls in genesis flow#757
Open
Richard1048576 wants to merge 1 commit into
Open
docs(cluster): note stale-output + contracts-ref pitfalls in genesis flow#757Richard1048576 wants to merge 1 commit into
Richard1048576 wants to merge 1 commit into
Conversation
…flow Two gotchas when standing up a fresh local devnet, both surfacing as nodes stuck at block 0 with "The genesis transaction was not found": - reusing a stale/partial ./output/ from a previous run. Always `make clean && make init && make genesis` for a fresh chain. - a gravity_chain_core_contracts checkout out of sync with the SDK, so genesis-tool rejects the generated config (e.g. missing field `minimumProposalStake`). Keep the contracts ref in sync.
nekomoto911
approved these changes
Jun 26, 2026
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.
Two gotchas hit when standing up a fresh local devnet from
cluster/, both surfacing the same way — every node fails to bootstrap and sits at block 0 withThe genesis transaction was not found/chain ID (None). Documents both incluster/README.mdso the next operator doesn't have to reverse-engineer them.1. Reusing a stale
./output/If
./output/holds artifacts from a previous (or partial) run,make deploy_startalone happily distributes an incomplete genesis (no consensus genesis transaction), and nodes can't bootstrap. The fix is to always regenerate from scratch:2.
gravity_chain_core_contractsout of sync with the SDKThe existing note already says the contracts repo isn't auto-updated. Added that a stale
refingenesis.toml(vs the SDK'sgenesis-tool) makes generation fail with e.g.missing field minimumProposalStake— so keep the contracts checkout in sync.Both notes go in the
make genesissection next to the existing contracts-update warning. Docs only.