# \[PROPOSAL 885\]\[PASSED\] Gaia v15 Software Upgrade

**URL:** <https://forum.cosmos.network/t/proposal-885-passed-gaia-v15-software-upgrade/13302>\
**Category:** Software Upgrade\
**Created:** [February 14, 2024, 7:56pm UTC](https://forum.cosmos.network/t/proposal-885-passed-gaia-v15-software-upgrade/13302 "2024-02-14T19:56:14Z")\
**Posts on this page:** 20\
**Page:** 1

<div class="post-metadata">

**Author:** ![btruax](https://yyz1.discourse-cdn.com/flex031/user_avatar/forum.cosmos.network/btruax/32/5640_2.png) [@btruax](https://forum.cosmos.network/u/btruax)\
**Post date:** [February 14, 2024, 7:56pm UTC](https://forum.cosmos.network/t/proposal-885-passed-gaia-v15-software-upgrade/13302/1 "2024-02-14T19:56:15Z")

</div>

Change log

- 2024-2-14 Created initial post
- 2024-3-1 Revised title for on-chain proposal
- 2024-3-17 Revised title for vote passing

### Important Notes for Node Operators

This is a **large upgrade** and we expect it to be fairly slow due to state migrations in upgrading the sdk to 0.47.x. There are revised hardware requirements just for this upgrade, but specs can return to current mainnet requirements afterwards.

- **Minimum:** 64GB RAM + 32GB swap
- **Recommended:** 128GB RAM
- **Bare minimum** 32GB RAM + 64GB swap

Optimal CPU performance: 2.50GHz, 8 cores (eg Intel Xeon Gold 6248 or equivalent consumer grade processor).

It is paramount that the operators set enough SWAP to cover all cases. SWAP partitions can be used to supplement the RAM requirement but they will increase the upgrade time.

### Further recommendations

- If you are unable to meet the hardware requirements, consider skipping the upgrade and resyncing from snapshot once the upgrade goes through.
  - NodeStake: [Cosmos | NodeStake](https://nodestake.org/cosmos)
  - Polkachu: [CosmosHub Node Snapshot | Polkachu](https://www.polkachu.com/tendermint_snapshots/cosmos)
  - Lavender.five: [Node Tools & Validator documentation | Lavender.Five Nodes](https://services.lavenderfive.com/mainnet/cosmoshub/snapshot)

- Logs will be sparse during this long upgrade. You can run your node with `-log_level="*:debug"` to get slightly more verbose logs during upgrade. Do not panic at the lack of info — just sit tight!
- Do not restart your node mid-upgrade unless you are getting OOM errors. Restarting mid-upgrade may lead to a corrupted database.
- Set min gas price to `0.005uatom` or your node will fail on restart. Failing on restart just means that you’ll have to set the param at that point, but doing it ahead of time will be smoother.

### Background

The Gaia v15 release is a major release that will follow the standard governance process by initially submitting this post on the Cosmos Hub forum. After collecting forum feedback (~ 1 week) and adapting the proposal as required, a governance proposal will be sent to the Cosmos Hub for voting. The on-chain voting period typically lasts 2 weeks.

On governance vote approval, validators will be required to update the Cosmos Hub binary at the halt-height specified in the on-chain proposal.

### Proposed Release Contents

The relevant Github epic for this release is: [Gaia v15 Release](https://github.com/cosmos/gaia/issues/2790)

The focus of this release is the upgrade of Cosmos SDK to v0.47 – this release uses [v0.47.8-ics-lsm](https://github.com/cosmos/cosmos-sdk/tree/v0.47.8-ics-lsm), a special Cosmos SDK branch with support for both ICS and LSM. Consequently, it also upgrades the following dependencies:

- IBC to [v7.3.1](https://github.com/cosmos/ibc-go/releases/tag/v7.3.1)
- CometBFT to [v0.37.4](https://github.com/cometbft/cometbft/releases/tag/v0.37.4)
- Interchain Security to [v3.3.1-lsm](https://github.com/cosmos/interchain-security/releases/tag/v3.3.1-lsm)
- Packet Forward Middleware to [v7.1.2](https://github.com/cosmos/ibc-apps/releases/tag/middleware%2Fpacket-forward-middleware%2Fv7.1.2)

In addition, this release migrates the following state:

- Sets the min commission rate staking parameter to `5%` and updates the commission rate for all validators accordingly (according to [governance proposal 826](https://www.mintscan.io/cosmos/proposals/826)). Validators with a commission rate \< `5%` prior to upgrade will have a rate of `5%` after upgrade is complete. This parameter can be changed via a param change proposal in the future.
- Migrates the vesting funds from _cosmos145hytrc49m0hn6fphp8d5h4xspwkawcuzmx498_to the community pool (according to [governance proposal 860](https://www.mintscan.io/cosmos/proposals/860)).

Finally, this releases fixes a series of issues found during the [Oak Security audit of SDK 0.47](https://github.com/oak-security/audit-reports/blob/master/Cosmos%20SDK/2024-01-23%20Audit%20Report%20-%20Cosmos%20SDK%20v1.0.pdf). As a result, this release introduces the following API changes:

- Reject `MsgVote` messages from accounts with less than 1 ATOM staked. All validators should ensure that they are staking at least 1 ATOM from the wallet they use for sending `MsgVote` messages.
- A new `MinDepositRatio` param is added (with a default value of `0.01`) and now deposits are required to be at least `MinDepositRatio*MinDeposit` to be accepted.

Taken together, these changes upgrade Gaia from cosmos-sdk v0.45 and open the door for further integrations, such as adding Skip Block SDK required by [Prop 842](https://www.mintscan.io/cosmos/proposals/842).

A release candidate can be found [here](https://github.com/cosmos/gaia/releases/tag/v15.0.0-rc1).

### Testing and Testnets

The v15 release has gone through rigorous testing, including e2e tests, integration tests, and differential tests. Differential tests are similar to integration tests, but they compare the system state to an expected state generated from a model implementation. In addition, v15 has been independently tested by the team at Hypha Co-op.

Validators and node operators have joined a public testnet to participate in a test upgrade to a release candidate before the Cosmos Hub upgrades to the final release. You can find the relevant information (genesis file, peers, etc.) to join the [Release testnet](https://github.com/cosmos/testnets/tree/master/public) (theta-testnet-001), or the [Replicated Security testnet](https://github.com/cosmos/testnets/tree/master/replicated-security) (provider).

### Potential risk factors

Although very extensive testing and simulation will have taken place there always exists a risk that the Cosmos Hub might experience problems due to potential bugs or errors from the new features. In the case of serious problems, validators should stop operating the network immediately.

Coordination with validators will happen in the [#cosmos-hub-validators-verified](https://discord.com/channels/669268347736686612/798937713474142229) channel of the Cosmos Network Discord to create and execute a contingency plan. Likely this will be an emergency release with fixes or the recommendation to consider the upgrade aborted and revert back to the previous release of gaia (v14).

### Governance votes

The following items summarize the voting options and what it means for this proposal:

**YES** - You agree that the Cosmos Hub should be updated with this release.

**NO** - You disagree that the Cosmos Hub should be updated with this release.

**NO WITH VETO** - A ‘NoWithVeto’ vote indicates a proposal either (1) is deemed to be spam, i.e., irrelevant to Cosmos Hub, (2) disproportionately infringes on minority interests, or (3) violates or encourages violation of the rules of engagement as currently set out by Cosmos Hub governance. If the number of ‘NoWithVeto’ votes is greater than a third of total votes, the proposal is rejected and the deposits are burned.

**ABSTAIN** - You wish to contribute to the quorum but you formally decline to vote either for or against the proposal.

---

<div class="post-metadata">

**Author:** ![lexa](https://yyz1.discourse-cdn.com/flex031/user_avatar/forum.cosmos.network/lexa/32/7415_2.png) [@lexa](https://forum.cosmos.network/u/lexa)\
**Post date:** [February 14, 2024, 8:32pm UTC](https://forum.cosmos.network/t/proposal-885-passed-gaia-v15-software-upgrade/13302/2 "2024-02-14T20:32:16Z")

</div>

> [@btruax](#):
>
> This is a **large upgrade** and we expect it to be fairly slow due to state migrations in upgrading the sdk to 0.47.x.

For context, this upgrade took us about an hour when doing a stateful upgrade with a single whale validator. Usually our Gaia upgrades are very quick in this format (\<10 min).

---

<div class="post-metadata">

**Author:** ![freak12techno](https://yyz1.discourse-cdn.com/flex031/user_avatar/forum.cosmos.network/freak12techno/32/2991_2.png) [@freak12techno](https://forum.cosmos.network/u/freak12techno)\
**Post date:** [February 14, 2024, 9:49pm UTC](https://forum.cosmos.network/t/proposal-885-passed-gaia-v15-software-upgrade/13302/3 "2024-02-14T21:49:25Z")

</div>

Appreciate including the fix for missing addresses in /signing\_info response: [Missing address in signing\_infos of rest api #1344 · Issue #1734 · cosmos/gaia · GitHub](https://github.com/cosmos/gaia/issues/1734), that’ll optimise the queries I have to do in my tools.  
Already waiting for this to land on Hub, LFG!

---

<div class="post-metadata">

**Author:** ![freak12techno](https://yyz1.discourse-cdn.com/flex031/user_avatar/forum.cosmos.network/freak12techno/32/2991_2.png) [@freak12techno](https://forum.cosmos.network/u/freak12techno)\
**Post date:** [February 14, 2024, 9:53pm UTC](https://forum.cosmos.network/t/proposal-885-passed-gaia-v15-software-upgrade/13302/4 "2024-02-14T21:53:52Z")

</div>

> [@btruax](#):
>
> The focus of this release is the upgrade of Cosmos SDK to v0.47 – this release uses [v0.47.8-ics-lsm](https://github.com/cosmos/cosmos-sdk/tree/v0.47.8-ics-lsm), a special Cosmos SDK branch with support for both ICS and LSM. Consequently, it also upgrades the following dependencies:

Are there plans for the future to abolish the need for custom releases/tags of cosmos-sdk with the changes specifically tailored for Cosmos Hub?

---

<div class="post-metadata">

**Author:** ![Polkachu](https://yyz1.discourse-cdn.com/flex031/user_avatar/forum.cosmos.network/polkachu/32/2741_2.png) [@Polkachu](https://forum.cosmos.network/u/Polkachu)\
**Post date:** [February 15, 2024, 12:03am UTC](https://forum.cosmos.network/t/proposal-885-passed-gaia-v15-software-upgrade/13302/5 "2024-02-15T00:03:26Z")

</div>

Look forward to it 🫡

---

<div class="post-metadata">

**Author:** ![mpoke](https://yyz1.discourse-cdn.com/flex031/user_avatar/forum.cosmos.network/mpoke/32/5436_2.png) [@mpoke](https://forum.cosmos.network/u/mpoke)\
**Post date:** [February 15, 2024, 11:21am UTC](https://forum.cosmos.network/t/proposal-885-passed-gaia-v15-software-upgrade/13302/6 "2024-02-15T11:21:14Z")

</div>

The reason Gaia requires a special SDK release is LSM. SDK 0.51 should enable plug-ins for the staking module, which means that the LSM logic can be implemented as a plug-in and then Gaia can go back to mainline SDK.

---

<div class="post-metadata">

**Author:** ![Sik\_stakingfac](https://yyz1.discourse-cdn.com/flex031/user_avatar/forum.cosmos.network/sik_stakingfac/32/6772_2.png) [@Sik\_stakingfac](https://forum.cosmos.network/u/Sik_stakingfac)\
**Post date:** [February 18, 2024, 9:54am UTC](https://forum.cosmos.network/t/proposal-885-passed-gaia-v15-software-upgrade/13302/7 "2024-02-18T09:54:08Z")

</div>

Staking Facilities is looking forward to upgrading the nodes 💪

We always value the detailled information and instructions provided.

That being said - I just wanted to drop the link to the technical upgrade docs including possible rollback scenarios and backup recommendations:

```auto
https://github.com/cosmos/gaia/blob/release/v15.x/UPGRADING.md 

```

---

<div class="post-metadata">

**Author:** ![Flo](https://yyz1.discourse-cdn.com/flex031/user_avatar/forum.cosmos.network/flo/32/5070_2.png) [@Flo](https://forum.cosmos.network/u/Flo)\
**Post date:** [February 18, 2024, 5:29pm UTC](https://forum.cosmos.network/t/proposal-885-passed-gaia-v15-software-upgrade/13302/8 "2024-02-18T17:29:58Z")

</div>

If i remember correctly a future change of the validator commission rate param will not trigger a change the comission rate of the current set?

---

<div class="post-metadata">

**Author:** ![0xXeno](https://yyz1.discourse-cdn.com/flex031/user_avatar/forum.cosmos.network/0xxeno/32/6681_2.png) [@0xXeno](https://forum.cosmos.network/u/0xXeno)\
**Post date:** [February 18, 2024, 6:08pm UTC](https://forum.cosmos.network/t/proposal-885-passed-gaia-v15-software-upgrade/13302/9 "2024-02-18T18:08:57Z")

</div>

It has evolved.

> Validators with a commission rate \< `5%` prior to upgrade will have a rate of `5%` after upgrade is complete.

---

<div class="post-metadata">

**Author:** ![Flo](https://yyz1.discourse-cdn.com/flex031/user_avatar/forum.cosmos.network/flo/32/5070_2.png) [@Flo](https://forum.cosmos.network/u/Flo)\
**Post date:** [February 18, 2024, 7:29pm UTC](https://forum.cosmos.network/t/proposal-885-passed-gaia-v15-software-upgrade/13302/10 "2024-02-18T19:29:20Z")

</div>

Yes in this upgrade the rate will be changes to 5% but if i remember it correctly a gov param change without an upgrade will have no effect on the current val set but will have an effect on new validators/ validator commission changes.

---

<div class="post-metadata">

**Author:** ![ChainupNewHuo](https://yyz1.discourse-cdn.com/flex031/user_avatar/forum.cosmos.network/chainupnewhuo/32/6778_2.png) [@ChainupNewHuo](https://forum.cosmos.network/u/ChainupNewHuo)\
**Post date:** [February 19, 2024, 1:48am UTC](https://forum.cosmos.network/t/proposal-885-passed-gaia-v15-software-upgrade/13302/11 "2024-02-19T01:48:22Z")

</div>

ChainUp & NewHuo is excited to perform the upcoming node upgrade ! appreciate the detailed upgrade documentation previously provided. Does the upcoming upgrade will automatically set the rate to 5% for all validators?

---

<div class="post-metadata">

**Author:** ![mpoke](https://yyz1.discourse-cdn.com/flex031/user_avatar/forum.cosmos.network/mpoke/32/5436_2.png) [@mpoke](https://forum.cosmos.network/u/mpoke)\
**Post date:** [February 19, 2024, 10:11am UTC](https://forum.cosmos.network/t/proposal-885-passed-gaia-v15-software-upgrade/13302/12 "2024-02-19T10:11:00Z")

</div>

This upgrade migrates the state to enforce the min 5% commission rate – [gaia/app/upgrades/v15/upgrades.go at v15.0.0-rc1 · cosmos/gaia · GitHub](https://github.com/cosmos/gaia/blob/v15.0.0-rc1/app/upgrades/v15/upgrades.go#L88)

---

<div class="post-metadata">

**Author:** ![btruax](https://yyz1.discourse-cdn.com/flex031/user_avatar/forum.cosmos.network/btruax/32/5640_2.png) [@btruax](https://forum.cosmos.network/u/btruax)\
**Post date:** [February 19, 2024, 12:18pm UTC](https://forum.cosmos.network/t/proposal-885-passed-gaia-v15-software-upgrade/13302/13 "2024-02-19T12:18:24Z")

</div>

The upcoming upgrade will automatically raise the rate to 5% for any validators under 5%. There will be no change in commission rate for any validators currently at 5% or higher.

---

<div class="post-metadata">

**Author:** ![waqarmmirza](https://yyz1.discourse-cdn.com/flex031/user_avatar/forum.cosmos.network/waqarmmirza/32/4189_2.png) [@waqarmmirza](https://forum.cosmos.network/u/waqarmmirza)\
**Post date:** [February 20, 2024, 1:19am UTC](https://forum.cosmos.network/t/proposal-885-passed-gaia-v15-software-upgrade/13302/14 "2024-02-20T01:19:04Z")

</div>

Redundant question was removed as many people answered the same question.

---

<div class="post-metadata">

**Author:** ![Huginn](https://yyz1.discourse-cdn.com/flex031/user_avatar/forum.cosmos.network/huginn/32/6555_2.png) [@Huginn](https://forum.cosmos.network/u/Huginn)\
**Post date:** [February 20, 2024, 2:26pm UTC](https://forum.cosmos.network/t/proposal-885-passed-gaia-v15-software-upgrade/13302/16 "2024-02-20T14:26:00Z")

</div>

> [@btruax](#):
>
> Sets the min commission rate staking parameter to `5%` and updates the commission rate for all validators accordingly (according to [governance proposal 826](https://www.mintscan.io/cosmos/proposals/826)).

This change will help small validators stay in the game, letting them keep pace with the big players. This way, the voting power within the network stays more balanced.

> [@btruax](#):
>
> Reject `MsgVote` messages from accounts with less than 1 ATOM staked.

This change is a welcome development in combating spam and bot votes on the network, allowing for clearer visibility into authentic user data.

Appreciate the hard work 🫡

---

<div class="post-metadata">

**Author:** ![wassie](https://yyz1.discourse-cdn.com/flex031/user_avatar/forum.cosmos.network/wassie/32/4925_2.png) [@wassie](https://forum.cosmos.network/u/wassie)\
**Post date:** [February 20, 2024, 2:40pm UTC](https://forum.cosmos.network/t/proposal-885-passed-gaia-v15-software-upgrade/13302/17 "2024-02-20T14:40:20Z")

</div>

Looking forward to it.

---

<div class="post-metadata">

**Author:** ![Flo](https://yyz1.discourse-cdn.com/flex031/user_avatar/forum.cosmos.network/flo/32/5070_2.png) [@Flo](https://forum.cosmos.network/u/Flo)\
**Post date:** [February 21, 2024, 7:14pm UTC](https://forum.cosmos.network/t/proposal-885-passed-gaia-v15-software-upgrade/13302/18 "2024-02-21T19:14:39Z")

</div>

Yes thats the issue/open question i have about this upgrade.

If we change the paramater in the future (for example to 10%) we will have to migrate the state in an later update again. During the timeframe of the success of this hypothetical proposal and the upgrade, will new validators be forced to use the 10% min\_commission and old validators will still be able to use the old min\_commission of 5%?

---

<div class="post-metadata">

**Author:** ![mpoke](https://yyz1.discourse-cdn.com/flex031/user_avatar/forum.cosmos.network/mpoke/32/5436_2.png) [@mpoke](https://forum.cosmos.network/u/mpoke)\
**Post date:** [February 22, 2024, 4:36pm UTC](https://forum.cosmos.network/t/proposal-885-passed-gaia-v15-software-upgrade/13302/19 "2024-02-22T16:36:18Z")

</div>

The `MinCommissionRate` param is only used for `CreateValidator` and `EditValidator` messages. This means that once the param is updated to e.g., 10%,

- new validators cannot be created with commission rates below 10%;
- existing validators cannot update their commission rate to values below 10%.  
So yeah, to enforce this new min commission rate to every validator, migration will be required.

---

<div class="post-metadata">

**Author:** ![btruax](https://yyz1.discourse-cdn.com/flex031/user_avatar/forum.cosmos.network/btruax/32/5640_2.png) [@btruax](https://forum.cosmos.network/u/btruax)\
**Post date:** [February 22, 2024, 7:47pm UTC](https://forum.cosmos.network/t/proposal-885-passed-gaia-v15-software-upgrade/13302/20 "2024-02-22T19:47:14Z")

</div>

We have been notified of an issue with the v15 upgrade that may interfere with operations on the Asteroid Protocol. There is a potential workaround identified and our team is assessing implementation timing. We want to ensure that we are fully supporting all apps that are built on Gaia. At the moment, we will be delaying the final release until next week. I will update this forum post with further information on timing if required.

---

<div class="post-metadata">

**Author:** ![Flo](https://yyz1.discourse-cdn.com/flex031/user_avatar/forum.cosmos.network/flo/32/5070_2.png) [@Flo](https://forum.cosmos.network/u/Flo)\
**Post date:** [February 22, 2024, 8:08pm UTC](https://forum.cosmos.network/t/proposal-885-passed-gaia-v15-software-upgrade/13302/21 "2024-02-22T20:08:47Z")

</div>

Thanks you for confirming my assumption.

I think `MinCommissionRate` should not be a governance paramter since it doesnt result in an immediate change of the commission rate of all validators but creates an unfair advantage over new validators.

I understand that the chances that this will happen are very small but inequalities like this should be avoided by design.

[Next page](https://forum.cosmos.network/t/proposal-885-passed-gaia-v15-software-upgrade/13302.md?page=2)