Skip to content

docs(cluster): note stale-output + contracts-ref pitfalls in genesis flow #757

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
Richard1048576 wants to merge 1 commit into
base: main
Choose a base branch
from
Open

docs(cluster): note stale-output + contracts-ref pitfalls in genesis flow #757

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 6 additions & 1 deletion cluster/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -41,11 +41,16 @@ make genesis
```
*This generates `genesis.json` and `waypoint.txt` in `./output`.*

> ⚠️ **Important**: The `genesis.sh` script will clone `gravity_chain_core_contracts` to `external/` if it doesn't exist, but will **NOT** automatically update it. To update:
> ⚠️ **Important**: The `genesis.sh` script will clone `gravity_chain_core_contracts` to `external/` if it doesn't exist, but will **NOT** automatically update it. Keep the contracts checkout in sync with the SDK (a stale `ref` in `genesis.toml` can make `genesis-tool` reject the generated config, e.g. `missing field minimumProposalStake`). To update:
> ```bash
> cd external/gravity_chain_core_contracts && git pull origin main
> ```

> ⚠️ **Always regenerate from scratch**: do not reuse a leftover `./output/` from a previous (or partial) run — an incomplete genesis makes every node fail to bootstrap (`The genesis transaction was not found`, stuck at block 0). For a fresh chain:
> ```bash
> make clean && make init && make genesis
> ```

### 5. Deploy and Start
```bash
make deploy_start
Expand Down
Loading