Skip to content

Latest commit

 

History

History
65 lines (39 loc) · 4.02 KB

shockwave-delta-testnet.md

File metadata and controls

65 lines (39 loc) · 4.02 KB

Shockwave Delta (pulsar-2 testnet)

Secret Network v1.4 "Shockwave Delta" Testnet Upgrade Instructions

Upgrading Manually

When the network reaches the halt height 4,711,950, you'll see this message in your node's log (journalctl -fu secret-node):

1:25PM ERR UPGRADE "v1.4-fix" NEEDED at height: 4711950:
1:25PM ERR CONSENSUS FAILURE!!! err="UPGRADE \"v1.4-fix\" NEEDED at height: 4,711,950

Then, the upgrade steps for v1.4 are:

⚠️ Note: if you have modified your systemd unit file (/etc/systemd/system/secret-node.service) you will need to re-apply those changes post installation and pre service restart.

⚠️ Note: uncomment the right binary based on the database type you're using: rocksdb vs goleveldb. To check what database type you're currently using: awk -F \" '/^db_backend =/{print $2}' ~/.secretd/config/config.toml.

# Stop the v1.3 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.4

## goleveldb
# wget "https://github.com/scrtlabs/SecretNetwork/releases/download/v1.4.0-beta.6/secretnetwork_1.4.0-beta.6_testnet_goleveldb_amd64.deb"
# echo "c879e1bbe2d774e5a095a480fe0bd20f4809abc0919b457fc3c32fbf68daa476 secretnetwork_1.4.0-beta.6_testnet_goleveldb_amd64.deb" | sha256sum --check

## rocksdb
# wget "https://github.com/scrtlabs/SecretNetwork/releases/download/v1.4.0-beta.6/secretnetwork_1.4.0-beta.6_testnet_rocksdb_amd64.deb"
# echo "14c2e91c8e4c86e39037473bb8abe7ee041dbc21dab65e321c363f82d1266539 secretnetwork_1.4.0-beta.6_testnet_rocksdb_amd64.deb" | sha256sum --check

# Install v1.4 binaries
sudo apt install -y ./secretnetwork_1.4.0-beta.6_testnet_*_amd64.deb

# re-apply any systemd unit file customizations

# Restart the node
sudo systemctl restart secret-node

After restarting the node with v1.4, you should see INF applying upgrade "v1.4-fix" at height: 4711950 in the logs (journalctl -fu secret-node). Once 67% of voting power comes online, you'll see blocks executing again.

Upgrading Automatically Using Cosmovisor

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.

⚠️ Cosmovisor is still new and best practices for using it are not yet established. If you don't feel adventurous at this time, we recommend upgrading the manual way.

For instructions on how to setup Cosmovisor, go here.

Details of Upgrade Time

When the network reaches the halt height 4,711,950, the Secret Network testnet blockchain will be halted and validators will need to take action to upgrade the chain to the secretd v1.4 binary (be it manually or automatically).

The proposal targets the upgrade proposal block to be 4,711,950, anticipated to be on Sunday Septmber 11, 2022 at 2:00PM UTC.

The upgrade is anticipated to take approx 30 minutes, during which time, there will not be any on-chain activity on the network.

In Case of an Upgrade Failure

In the event of an issue at upgrade time, we should coordinate via the "SN Testnet Validators" Telegram group.

If as a result of a software bug the network fails to produce new blocks with the v1.4 binaries, the SCRT Labs team will distribute a v1.3 binary with an empty v1.4 upgrade handler, which will essentially allow the chain to revert to v1.3 while continuing to produce new blocks.