658

This is a proposal to do a software upgrade to the v20.0.0 software tag of the Osmosis codebase on block height 12028900, which is estimated to occur on Monday October 23rd, UTC 16:00. Block times have high variance, so please monitor the chain for more precise time estimates.

Upgrade Features

This upgrade adds the following features: [Hidden link]

• Adds a new incentives mechanism that allows pools to be grouped into Volume Splitting Gauges and be incentivized as a set.
• Incentives for pools within this set will re-adjust at each epoch to the volume ratio present in each pool over the last epoch.
• This allows multiple pools of the same pairing with different specifications to be incentivized to allow incentives to be optimized around trading volume more rapidly.
• This upgrade proposal creates groups containing the Classic and Supercharged pools with existing migration links between them and moves incentive allocation to incentivize these group gauges rather than the previous mechanism of sharing via the migration link.

Concentrated Liquidity modifications

• Concentrated Liquidity positions [Hidden link] to another address
• Added a parameter that allows governance to add addresses that can [Hidden link].
• Added a parameter that allows governance to [Hidden link].

Validator Set Preferences

• Allows users with defined validator sets to [Hidden link].

See the [Hidden link] 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.20. 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/v20/bin/. If not using Cosmovisor, wait for your node to halt at the upgrade height, then install and run the v20.0.0 binary.

Details of Upgrade Time

The proposal targets the upgrade proposal block to be 12028900, anticipated to be on Monday October 23rd, UTC 16:00. Note that block times have high variance, so keep monitoring the time. See countdown [Hidden link]. 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.