MoonRunners
LogoLogo

990

  1. /
  2. Osmosis
  3. /
  4. Mainnet
  5. /
  6. Governance
  7. /
  8. 990
  • Docs
  • Support
2026 © Made with 💜 by MoonRunnersAPI OK
DocsSupportDonate

Proposal #990

Osmosis v31 Software Upgrade

PassedSoftware Upgrade

Passed on 01 Nov 2025 with 98.2% of the votes for yes.

Yes

98.2%

100.0% without abstain

Veto

0.0%

of votes cast

Ended

01 Nov 2025

The ballotvotes cast · final tally
Yes

98.17%

of votes cast

Abstain

1.81%

of votes cast

No

0.02%

of votes cast

Veto

0.00%

of votes cast

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.

[Hidden link]

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.

[Hidden link]

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.

[Hidden link]

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

[Hidden link]

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.

[Hidden link]

OSMO collected from taker fees is now burned automatically, removing the need for monthly burn proposals from the community pool as outlined in [Hidden link].

[Hidden link]

The methodology used for taker fee splitting has been adjusted to the state discussed in previous proposals, such as [Hidden link].

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 [Hidden link] 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 [Hidden link] 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 [Hidden link].

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 [Hidden link] to come to a quick emergency consensus and mitigate any further issues.

Timeline

  1. Submitted27 Oct 2025
  2. Voting started27 Oct 2025
  3. Voting ended01 Nov 2025
  4. Deposit deadline10 Nov 2025

Proposer

Address
osmo19w2…3hfq0r
Deposit6.0K

Rules

Not recorded for this proposal.