This is a proposal to do a software upgrade to the v31.0.0 software tag of the Osmosis codebase on block height 47626000, which is estimated to occur on Monday, 3rd November 2025, UTC 14:00. Block times have high variance, so please monitor the chain for more precise time estimates.

Upgrade Features

This upgrade introduces significant improvements to taker-fee revenue routing, automated burning, and staking reward smoothing.

The release also includes infrastructure enhancements and minor bug fixes to improve network stability and validator efficiency.

Inflation Endpoint

A new endpoint, osmosis/mint/v1beta1/inflation, tracks the release rate of OSMO into the circulating supply.

This does not account for OSMO burned but can be used in combination with the daily burn to track net inflation rate.

Raise Minimum Default Base Gas Price

The minimum gas price has been increased threefold to 0.03 uosmo/gas, making gas prices for transactions on the Osmosis chain more typical compared to other chains.

Staking Reward Smoothing

Implements a smoothing mechanism for taker fee staking rewards allocation through a new parameter DailyRewardsSmoothingFactor.

This causes the taker fee distributed to stakers to be smoothed over multiple epochs, resulting in a more stable staking APR with varying taker fees. The initial setting is 7 epochs.

Taker Fee Optimizations

Improved Taker Fee Routing

Non-OSMO collections required a direct pairing with the target denomination for a swap at epoch, usually OSMO or BTC. This update enables automated two-hop routes at epoch, thereby releasing previously unconvertible collected assets.

OSMO Taker Fee Burn Automated

OSMO collected from taker fees is now burned automatically, removing the need for monthly burn proposals from the community pool as outlined in Proposal 903.

Non-OSMO Taker Fee Buyback and Burn

The methodology used for taker fee splitting has been adjusted to the state discussed in previous proposals, such as Proposal 955 - Prioritize Burn over Accumulation from Taker Fees.

These proposals assumed that the flow of non-OSMO to a buyback would then feed into the main OSMO distribution ratio, which is 30% distributed and 70% burned, resulting in a buyback and burn. This was not applied, and all OSMO bought back was distributed by default.

This has been corrected by splitting the distribute parameter for non-OSMO into a specific Staking Reward/Burn split, mirroring the 30%/70% ratio currently used for OSMO distribution.

Please see the Full Change Log for a complete list of optimizations and any API changes.

Getting Prepared for the Upgrade

Binary Installation

To build the binary, be sure to install Golang 1.23.4 or higher

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 it is 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/v31/bin/.

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

Details of Upgrade Time

The proposal targets the upgrade proposal block to be 47626000, anticipated to be on Monday, 3rd November 2025, UTC 14:00. Note that block times have high variance, so keep monitoring the time. See the countdown HERE.

The upgrade is anticipated to take approximately 15 minutes, during which time there will be no on-chain activity on the network.

In the event of an issue at upgrade time, coordinate via the validators channel in Discord to come to a quick emergency consensus and mitigate any further issues.