This is a proposal to do a software upgrade to the v23.0.0 software tag of the Osmosis codebase on block height 13899375, which is estimated to occur on Tuesday, February 20th, UTC 15:00. Block times have high variance, so please monitor the chain for more precise time estimates.

Upgrade Features

This upgrade consists of fixes and improvements for the Osmosis codebase.

• Uptime Incentive parameters are enabled for incentive distribution to Supercharged pools.

  • External incentives are customizable by the Duration setting at creation.
  • Internal incentives are set with a global parameter. Uptime incentives require a position to remain in place for a period of time to be eligible for incentives. This duration will require setting in a further governance proposal.

• Incentive distribution now occurs as frequently as intended to pools involving high precision assets.

  • This requires the migration of pools impacted to implement a new scaling factor. To minimize any risk in the process these migrations have been thoroughly tested on edgenet from mainnet state-export.
  • The migration is limited to six pools with total liquidity upper bound of $1.2M at the time of snapshot. These pools are:
    • stDYDX/DYDX (1423)
    • YieldEth/ETH (1213)
    • wstETH/ETH (1291, 1431)
    • ETH/WETH.grv (1297)
    • ARCH/DAI (1298)

• Implemented further epoch optimization mechanisms such as gauge filters and staggered TWAP pruning to reduce the epoch block duration.

See the Full Change Log for more API Breaking, State Breaking, and other miscellaneous changes.

Getting Prepared for the Upgrade

To build the binary, be sure to install golang 1.21. NOTE: Golang versions lower than this will not work.

As always, we recommend validators utilize 64GB of RAM. Since state migration is relatively negligible in this upgrade, it is possible to get away with less, but still not recommended. If you are unable to have 64GB of RAM, at a minimum have a total of 64GB of swap set to prevent out of memory errors.

If using Cosmovisor, manually build & copy the osmosisd binary to /cosmovisor/upgrades/v23/bin/.

If not using Cosmovisor, wait for your node to halt at the upgrade height, then install and run the v23.0.0 binary.

Details of Upgrade Time

The proposal targets the upgrade proposal block to be 13899375, anticipated to be on Tuesday, February 20th, UTC 15:00. Note that block times have high variance, so keep monitoring the time. See countdown HERE.

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 validators channel in Discord to come to a quick emergency consensus and mitigate any further issues.