cosmos

Prop 948: Gaia v19 Software Upgrade

Background

The Gaia v19 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 (~ one 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 one week as software upgrade proposals are expedited.

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

Release Binary & Upgrade Resources

IMPORTANT: Note that Gaia v19.0.0 binary MUST be used.

  • The release can be found here.
  • The changelog can be found here.
  • The upgrade guide can be found here.

UPGRADE NOTES:

  • Relayer Operators for the Cosmos Hub and consumer chains will also need to update to use Hermes v1.10.0 or higher. You may need to restart your relayer software after a major chain upgrade.

Release Contents

The focus of this release is the upgrade of Cosmos SDK to v0.50 – this release uses v0.50.8-lsm, a special Cosmos SDK branch with support for LSM. Consequently, it also upgrades the following dependencies:

As a result of the IBC upgrade, this release will enable IBC channel upgrades, e.g., existing IBC channels can be upgraded to add relayer incentivization through IBC fees.

Testing and Testnets

The v19 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, v19 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 (theta-testnet-001), or the Interchain Security testnet (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 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 (v18.1.0).

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.