State sync

With our state sync services you will be able to catch up latest chain block in matter of minutes

State Sync allows a new node to join the network by fetching a snapshot of the application state at a recent height instead of fetching and replaying all historical blocks. Since the application state is generally much smaller than the blocks, and restoring it is much faster than replaying blocks, this can reduce the time to sync with the network from days to minutes.


Stop penumbra_cometbft and reset database

sudo systemctl stop penumbra_cometbft
cp .penumbra/testnet_data/node0/cometbft/data/priv_validator_state.json .penumbra/testnet_data/node0/cometbft/priv_validator_state.json.backup
penumbra_cometbft tendermint unsafe-reset-all --home .penumbra/testnet_data/node0/cometbft --keep-addr-book

Get and configure the state sync information

LATEST_HEIGHT=$(curl -s $STATE_SYNC_RPC/block | jq -r .result.block.header.height)
BLOCK_HEIGHT=$(LATEST_HEIGHT | awk '{print $1 - ($1 % 6000)}'); \
TRUST_HASH=$(curl -s "$STATE_SYNC_RPC/block?height=$BLOCK_HEIGHT" | jq -r .result.block_id.hash)

echo -e "Modifying .penumbra/testnet_data/node0/cometbft/config/config.toml based on the following values:"
echo -e "RPC Address:          $STATE_SYNC_RPC"
echo -e "Latest Block Height:  $LATEST_HEIGHT"
echo -e "Sync Block Height:    $BLOCK_HEIGHT"
echo -e "Trust Hash:           $TRUST_HASH"

sed -i \
  -e "s|^enable *=.*|enable = true|" \
  -e "s|^rpc_servers *=.*|rpc_servers = \"$STATE_SYNC_RPC,$BACKUP_RPC\"|" \
  -e "s|^trust_height *=.*|trust_height = $BLOCK_HEIGHT|" \
  -e "s|^trust_hash *=.*|trust_hash = \"$TRUST_HASH\"|" \
  -e "s|^seeds *=.*|seeds = \"$SEEDS\"|" \

mv .penumbra/testnet_data/node0/cometbft/priv_validator_state.json.backup .penumbra/testnet_data/node0/cometbft/data/priv_validator_state.json

Download latest wasm

Currently state sync does not support copy of the wasm folder. Therefore, you will have to download it manually.

curl -L | lz4 -dc - | tar -xf - -C .penumbra/testnet_data/node0/cometbft

Restart penumbra_cometbft and check the log

sudo systemctl restart penumbra_cometbft && sudo journalctl -u penumbra_cometbft -f --no-hostname -o cat

Last updated