When the network reaches the halt height 3,343,000, you'll see this message in your node's log (
journalctl -fu secret-node):
1:25PM ERR UPGRADE "v1.3" NEEDED at height: 3343000:
1:25PM ERR CONSENSUS FAILURE!!! err="UPGRADE \"v1.3\" NEEDED at height: 3343000
Then, the upgrade steps for v1.3 are:
⚠️ Note: uncomment the right binary based on the database type on the node that you're upgrading:
# Stop the v1.2 node, to make sure that your process manager isn't trying to restart it while you upgrade
sudo systemctl stop secret-node
# Get & verify secretd v1.3
# wget "https://github.com/scrtlabs/SecretNetwork/releases/download/v1.3.0/secretnetwork_1.3.0_mainnet_goleveldb_amd64.deb"
# echo "b5a4387fd3af477f1d7d0c8ab13debc9b9ad9abccb59c82b1a35cc8a90db902b secretnetwork_1.3.0_mainnet_goleveldb_amd64.deb" | sha256sum --check
# wget "https://github.com/scrtlabs/SecretNetwork/releases/download/v1.3.0/secretnetwork_1.3.0_mainnet_rocksdb_amd64.deb"
# echo "a1fc48003b3b563aae216901fc5821bb11164746c61b86507bc813cb49bd85cb secretnetwork_1.3.0_mainnet_rocksdb_amd64.deb" | sha256sum --check
# Install v1.3 binaries
sudo apt install -y ./secretnetwork_1.3.0_mainnet_*_amd64.deb
# Restart the node
sudo systemctl restart secret-node
After restarting the node with v1.3, you should see
INF applying upgrade "v1.3" at height: 3343000in the logs (
journalctl -fu secret-node). Once 67% of voting power comes online, you'll see blocks executing again.
Cosmovisor is a new process manager for cosmos blockchains. It can make low-downtime upgrades smoother, as validators don't have to manually upgrade binaries during the upgrade, and instead can pre-install new binaries, and Cosmovisor will automatically update them based on on-chain SoftwareUpgrade proposals.
When the network reaches the halt height 3343000, the Secret Network blockchain will be halted and validators will need to take action to upgrade the chain to the secretd v1.3 binary (be it manually or automatically).
The proposal targets the upgrade proposal block to be 3343000, anticipated to be on Wednesday May 11, 2022 at 2:00PM UTC. This uses a 7 day average block time, derived from https://www.mintscan.io/secret/blocks/3343000 with #100,000 as the block time calculation window. Note that block times have high variance, so keep monitoring the time.
The upgrade is anticipated to take approx 30 minutes, during which time, there will not be any on-chain activity on the network.
In the event of an issue at upgrade time, we should coordinate via the "SN Validators" Telegram group.
If as a result of a software bug the network fails to produce new blocks with the v1.3 binaries, the SCRT Labs team will distribute a v1.2 binary with an empty v1.3 upgrade handler, which will essentially allow the chain to revert to v1.2 while continuing to produce new blocks.