mirror of
https://github.com/0glabs/0g-chain.git
synced 2024-11-10 18:15:19 +00:00
18ee69f480
* update migration from v0.13 to v0.14 * update dates, add rollback instructions * address review comments
92 lines
4.3 KiB
Markdown
92 lines
4.3 KiB
Markdown
# Kava-5.1 Upgrade Instructions
|
|
|
|
## Software Version and Key Dates
|
|
|
|
* We will be upgrading from chain-id "kava-6" to chain-id "kava-5.1". This is to keep the features in our roadmap aligned with the features on mainnet going forward.
|
|
* The version of Kava for kava-5.1 is v0.14.0
|
|
* Kava-6 validators should prepare to shutdown their nodes March 24th, 2021 at 13:00 UTC by setting `--halt-time` to `1616590800`
|
|
* Kava-5.1 genesis time is set to March 24th, 2021 at 15:00 UTC
|
|
* The version of cosmos-sdk for kava-5.1 is v0.39.2
|
|
* The version of tendermint for kava-5.1 v0.33.9
|
|
* The minimum version of golang for kava-5.1 is 1.13+, 1.15+ has been tested and is recommended.
|
|
|
|
### Risks
|
|
|
|
As a validator, performing the upgrade procedure on your consensus nodes carries a heightened risk of double-signing and being slashed. The most important piece of this procedure is verifying your software version and genesis file hash before starting your validator and signing.
|
|
|
|
The riskiest thing a validator can do is discover that they made a mistake and repeat the upgrade procedure again during the network startup. If you discover a mistake in the process, the best thing to do is wait for the network to start before correcting it. If the network is halted and you have started with a different genesis file than the expected one, seek advice from a Kava developer before resetting your validator.
|
|
|
|
### Recovery
|
|
|
|
Prior to exporting kava-6 state, validators are encouraged to take a full data snapshot at the export height before proceeding. Snap-shotting depends heavily on infrastructure, but generally this can be done by backing up the .kvd and .kvcli directories.
|
|
|
|
It is critically important to back-up the .kvd/data/priv_validator_state.json file after stopping your kvd process. This file is updated every block as your validator participates in consensus rounds. It is a critical file needed to prevent double-signing, in case the upgrade fails and the previous chain needs to be restarted.
|
|
|
|
In the event that the upgrade does not succeed, validators and operators must downgrade back to v0.12.4 of the Kava software and restore to their latest snapshot before restarting their nodes.
|
|
|
|
## Upgrade Procedure
|
|
|
|
### Before the upgrade
|
|
|
|
Set your node to produce the final block of kava-6 at __13:00__ UTC March 24th, 2021. To restart your node with that stop time,
|
|
|
|
```sh
|
|
kvd start --halt-time 1616590800
|
|
```
|
|
|
|
You can safely set the halt-time flag at any time.
|
|
|
|
### On the day of the upgrade
|
|
|
|
__The kava chain is expected to halt at 13:00 UTC, and restart with new software at 15:00 UTC March 24th. Do not stop your node and begin the upgrade before 13:00UTC on March 24th, or you may go offline and be unable to recover until after the upgrade!__
|
|
|
|
Kava developers will update this PR with the final block number when it is reached. __Make sure the kvd process is stopped before proceeding and that you have backed up your validator__. Failure to backup your validator could make it impossible to restart your node if the upgrade fails.
|
|
|
|
1. Export State (this __MUST__ be done using __v0.12.4__, previous v0.12.x versions will not produce the same genesis hash!)
|
|
|
|
```sh
|
|
kvd export --for-zero-height --height PLACEHOLDER > export-genesis.json
|
|
```
|
|
|
|
__Note:__ This can take a while!
|
|
|
|
2. Update to kava-5.1
|
|
|
|
```sh
|
|
# in the `kava` folder
|
|
git pull
|
|
git checkout v0.14.0
|
|
make install
|
|
|
|
# verify versions
|
|
kvd version --long
|
|
# name: kava
|
|
# server_name: kvd
|
|
# client_name: kvcli
|
|
# version: 0.14.0
|
|
# commit: PLACEHOLDER
|
|
# build_tags: netgo,ledger
|
|
# go: go version go1.15.8 linux/amd64
|
|
|
|
|
|
# Migrate genesis state
|
|
kvd migrate export-genesis.json > genesis.json
|
|
|
|
# Verify output of genesis migration
|
|
kvd validate-genesis genesis.json # should say it's valid
|
|
jq -S -c -M '' genesis.json | shasum -a 256
|
|
# PLACEHOLDER
|
|
|
|
# Restart node with migrated genesis state
|
|
cp genesis.json ~/.kvd/config/genesis.json
|
|
kvd unsafe-reset-all
|
|
|
|
# Restart node -
|
|
# ! Be sure to remove --halt-time flag if it is set in systemd/docker
|
|
kvd start
|
|
```
|
|
|
|
### Coordination
|
|
|
|
If the kava-5.1 chain does not launch by March 24, 2021 at 17:00 UTC, the launch should be considered a failure and validators should refer to the [rollback]("./rollback.md") instructions to restart the previous kava-6 chain. In the event of launch failure, coordination will occur in the [Kava discord](https://discord.com/invite/kQzh3Uv).
|