Validator migration guide
Follow this guide to become a validator on the new Terra chain. This guide walks you through making a gentx
file that will be added to the validator chain. A gentx
is a special transaction included in the genesis file that accomplishes three things:
- Registers your validator account as a validator operator account.
- Self-delegates the specified amount of LUNA tokens for staking.
- Links the validator operator account with a Tendermint node pubkey used to sign blocks.
All validators that want to be included in the new Terra chain must follow the steps below.
Networks
- New Terra testnet:
pisco-1
- New Terra mainnet:
phoenix-1
Prerequisites
Supplemental Resources
- Official Terra Validator Genesis Guide
- Cosmos SDK: How to run a node
- What is GenTX
- Validator tutorial
Timeline (Expected)
-
Fri May 27 2022 18:00:00 GMT+0900 (KST)
-
Thu May 27 2022 09:00:00 GMT+0000 (UTC)
Share
preultimate-genesis.json
and start to collect gen_txs from the validators. -
Sat May 28 2022 12:00:00 GMT+0900 (KST)
-
Sat May 28 2022 03:00:00 GMT+0000 (UTC)
Finish collecting gen_txs and build & share
genesis.json
. -
Sat May 28 2022 15:00:00 GMT+0900 (KST)
-
Sat May 28 2022 06:00:00 GMT+0000 (UTC)
Launch network.
Snapshot
This section covers how to take the pre- and post-attack snapshots. The following steps need to be run on your existing validator's machine.
- Stop your
columbus-5
node:
- Clone, checkout, and install the Terra Core Genesis state exporter:
- Verify the exporter binary version:
The above command should result in the following:
- Take the pre-attack snapshot:
- Take the post-attack snapshot:
- Verify the SHA256 hash of the sorted pre-attack & post-attack export snapshots:
Penultimate Genesis
The following steps need to be run on the same machine as your snapshot.
- Clone and checkout genesis builder:
- Move pre-attack and post-attack snapshots into
genesis-tools
:
- Run genesis builder script:
- Verify the SHA256 of the sorted penultimate-genesis.json:
Set up a new validator
Set up a new validator on a new machine by following the steps outlined in the full node tutorial.
After configuring your general settings, continue to the next section.
GenTx
Complete the following steps on your new validator's machine.
- Checkout and install the new Terra core:
- Verify the binary version:
- Prepare your environment:
- Execute GenTx:
- Upload the generated GenTx file to this repository's gentx folder via PR:
Collect GenTxs
The following steps need to be run on the same machine as your GenTx.
- Download gentx files and change into the terra home config:
- Execute
collect-gentxs
:
- Verify the SHA256 hash of the sorted final genesis:
Launch Network
Execute the Terrad binary on your new validator's machine and wait until network launch: