Try   HackMD

Osmosis v4 Berylium Chain Upgrade

This upgrade is a large stability upgrade to Osmosis. It brings with it faster epochs, and improved computation time for various on-chain operations, and fixes to the high gas amounts needed for bonding and unbonding txs.

The features of this upgrade are:

  • Fixing gas issues for bonding and unbonding tokens (NOTE: issues at epoch of there just being super high amounts of activity may still persist, with it taking seconds for txs to get into a block)
  • Removing the need for users to withdraw locked tokens once they are finished unlocking
  • Adding a governance parameter for a minimum fee to create a pool.
  • Implements prop 12

See more in the changelog

Getting prepared for the upgrade

Follow the cosmovisor setup instructions here: https://github.com/osmosis-labs/networks/blob/main/osmosis-1/upgrades/cosmovisor.md

Namely, configure cosmovisor to auto-restart. Then either auto-download binaries or manually build & copy the osmosisd v4.0.0 binary to .osmosisd/cosmovisor/upgrades/v4/bin/.

Details of upgrade time

When the network reaches the halt height, the state machine of the Osmosis will be halted. Cosmovisor if configured properly, will then switch the binary used to v4.0.0, and the chain will proceed post upgrade.

The proposal sets the upgrade proposal block at #1314500, which
is anticipated to be at Friday 2PM UTC (10AM EST). This is figured using the 7 day average block time of 6.45 seconds per block. Note that block times are highly variable, and this time estimate could very well be off by a couple of hours, due to live network conditions.

The upgrade is anticipated to take 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 validators channel in discord.

Testing your upgrade setup

There is a testnet which full nodes can sync to, to test that they have setup cosmovisor correctly on a new node. See #testnet-announcements and #testnet-discussion channels in the Osmosis Discord.