Details of mainnet upgrades, installation block height and links to instructions.
The UnUniFi Network mainnet is regularly upgraded to provide the latest security patches, Cosmos SDK module integrations and performance improvements.
Some upgrades are able to be undertaken automatically with Cosmovisor while other upgrades need to be manually installed at specified block heights. Others can be installed at any time after their predecessor.
There are two types of upgrades that happen on UnUniFi Network. They are:
- 1.Planned feature upgrades or planned patches
- 2.Unplanned security upgrades.
Planned upgrades, as the name suggests, are upgrades that are developed and proposed via governance. If approved by the community, these upgrades are undertaken by the chain automatically halting at the planned upgrade height.
Node operators are then required to swap the binary for the planned upgrade binary. After all node operators have upgraded and started their nodes the network will continue in the upgraded state.
Where emergency security patches are required, node operators are notified via the official discord validator channels. Node operators will be required to halt their nodes manually at the required upgrade height, swap the patched binary and restart their nodes. After all node operators have upgraded and started their nodes the network will continue in the upgraded state.
In order to sync a node with the current UnUniFi mainnet, you will need to follow these steps:
If you want ununifid to upgrade automatically, do the following steps prior to the upgrade height:
export UPGRADE_NAME= # upgrade name
export NEW_VERSION= # release version for upgrade
mkdir -p $DAEMON_HOME/cosmovisor/upgrades/$UPGRADE_NAME/bin
git checkout $NEW_VERSION
cp build/ununifid $DAEMON_HOME/cosmovisor/upgrades/$UPGRADE_NAME/bin
If you are setting true for automatic download in cosmosvisor, you don't need to do this. But, it's not recommended for validators.