This is a proposal to do a software upgrade to the v17.0.0 software tag of the Osmosis codebase on block height 11126100, which is estimated to occur on Wednesday August 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]

Introduces async acknowledgments for CosmWasm contracts. When a transaction is received, the action does not need to be performed immediately but can trigger an action at a later time.

[Hidden link]

• Actions [Hidden link]
• Adds a message that breaks all locks associated with a position, swaps all assets to the native asset and stakes.

Supercharged Liquidity Pool Improvements

• Multiple gas optimizations for interacting with Supercharged pools.
• ProtoRev now routes through Supercharged pools.
• Added a [Hidden link] that creates a new Supercharged Liquidity pool and a migration link to an existing Classic pool in the same proposal.
• Creates many Supercharged liquidity pools and migration links paired with Classic OSMO pools. (Actions [Hidden link])

[Hidden link]

This enhancement allows for executing custom logic before sending tokens, providing more flexibility and control over token transfers.

Miscellaneous changes

• [Hidden link] to update the scaling factor controller address of a stableswap pool.

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/v17/bin/.

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

Details of Upgrade Time

The proposal targets the upgrade proposal block to be 11126100, anticipated to be on Wednesday August 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.