cosmos

Prop 924: Gaia v17 Software Upgrade

Background

The Gaia v17 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.

Release Binary & Upgrade Resources

IMPORTANT: Note that Gaia v17.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.

Release Contents

This release adds Partial Set Security (PSS) features to the Cosmos Hub blockchain. When the PSS enabled chain binary lands on mainnet, new consumer chains will be able to:

  • choose the % of Cosmos Hub's voting power that is required to operate the consumer chain
  • use allow/denylists to customize validator participation
  • choose a per-validator voting power maximum (voting power cap)
  • use a different number of validators compared to the Cosmos Hub (validator number cap)
  • choose to run as an "Opt-in" chain (running the chain is not mandatory for validators)
  • have validators choose a different commission rate on their chain

Stride and Neutron Change-over to Top N=95% Chains

Information here is provided by Lexa from Hypha, directly from their work on the Hub’s ICS Testnet.

After the v17 upgrade, Stride and Neutron will both automatically become Top N=95% chains, but will retain the 5% soft opt-out logic implemented on the consumer side.

Impact on immediate operations

  • Top 95% of Hub Validators: The top 95% of Hub validators (by voting power) will experience no change in operations and will automatically continue to validate Stride and Neutron.
  • Bottom 5% of Hub Validators: Any validators in the bottom 5% who are currently validating Stride or Neutron will have their node unbonded and see “This node is not a validator” upon restarting. To continue validating, you must send an opt-in transaction for each chain.

Impact on consumer chain security Both Stride and Neutron are currently Replicated Security chains with a 5% soft opt-out.

  • Current state: both chains are secured by 95% of the Hub’s active set (100% of the set is mandated to run the chain but the bottom 5% of the mandated faces no penalties for not running it).
  • State created by this update: a Top N=95% chain with a 5% soft opt-out is guaranteed to be secured by 90% of the Hub’s active set (95% of the set is mandated to run, but the bottom 5% of the mandated set faces no penalties for not running it).

Stride and Neutron may choose to remove the soft opt-out feature on the consumer side in a future consumer upgrade, which would result in 95% of the Hub’s active set being mandated to run the consumer chains. This was the original logic intended by Replicated Security with a 5% soft opt-out.

Testing and Testnets

The v17 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, v17 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 (v16).

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.