How to spin up a local Grug devnet

how-to-spin-up-local-devnet.md

How to spin up a local devnet

1. Compile CometBFT, i.e. the sequencing layer:

git clone https://github.com/cometbft/cometbft
cd cometbft
git checkout v0.38.10
make install

2. Compile Grug, i.e. the execution layer:

git clone https://github.com/left-curve/grug
cd grug
just install

3. Compile necessary contracts:

just optimize

4. Initialize CometBFT. This will create a directory ~/.cometbft, which most notably includes the genesis file at ~/.cometbft/config/genesis.json. However, the app genesis state (the app_state field in the JSON) is left empty for now:

cometbft init

5. Generate two keys. We will create register two accounts during genesis, which will use these two keys, respectively:

grug keys add test1
grug keys add test2

4. Prepare the genesis file. This runs an example script, which utilizes grug_sdk::GenesisBuilder to create an app genesis state and populate in the CometBFT genesis file:

cargo run -p grug-sdk --example build_genesis

5. Start the node. Generally, when starting, start grug first, then cometbft; when shutting down, stop cometbft first, then grug:

grug start
cometbft start

6. Optional: deleting existing chain data and restart anew:

cometbft unsafe-reset-all
grug db reset

7. How to shut down the node

Use CTRL+C to kill CometBFT first, then CTRL+C to kill Grug.

Generally, when starting, start Grug first then start CometBFT; then stopping, kill CometBFT then kill Grug.

Don't worry, you won't mess up anything if you get the order wrong. This is just the intended order the software are designed.

What I had to do for Dango:

git clone https://github.com/cometbft/cometbft
cd cometbft
git checkout v0.38.10
make install

git clone https://github.com/left-curve/grug
cd grug
just install

just optimize
cometbft init
RUST_BACKTRACE=1 cargo run --example build_genesis -- dev-6 2025-01-31T00:00:00Z

cometbft start
cargo run -p dango-cli start

cleaning code:

cometbft unsafe-reset-all
dango db reset