370

This is a proposal to do a software upgrade to the v13.0.0 software tag of the Osmosis codebase on block height [Hidden link], which is estimated to occur on Thursday December 8th, UTC 15: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]

• Stableswap pools offer low slippage for two assets that are intended to be tightly correlated.
• There is a price ratio they are expected to be at, and the AMM offers low slippage around this price.

[Hidden link]

• Governance may define how much value can flow in and out of the chain for a specific denom, channel, and time period.
• Increases the level of security for assets on Osmosis in the event of any security issues on Osmosis, the counter-party chain, or within IBC itself.

[Hidden link]

• IBC has been upgraded to v3.4.0 which allows metadata to be passed as part of the message.
• Enables use cases such as cross chain swaps.

Force Unlock

• Governance may specify addresses to permit instantly unlocking bonded liquidity.
• Enables uses such as the liquidation of bonded pools when used for collateral.

Multi-hop OSMO discount

• When a trade consists of just two OSMO pools during a single transaction, the swap fees are automatically halved.
• For further details see Proposal 187 when this was initially signalled for development.

Getting Prepared for the Upgrade

As always, we recommend validators utilize 64GB of RAM. Since state migration is relatively negligible in this upgrade, it is likely 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/v13/bin/.

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

Details of Upgrade Time

The proposal targets the upgrade proposal block to be [Hidden link], anticipated to be on Thursday December 8th, 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.