Skip to content

Commit

Permalink
docs(gov): remove unimplemented section (#15697)
Browse files Browse the repository at this point in the history
  • Loading branch information
julienrbrt authored Apr 4, 2023
1 parent d0d1f5c commit 5b1ee22
Showing 1 changed file with 0 additions and 28 deletions.
28 changes: 0 additions & 28 deletions x/gov/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -231,34 +231,6 @@ At present, validators are not punished for failing to vote.

Later, we may add permissioned keys that could only sign txs from certain modules. For the MVP, the `Governance address` will be the main validator address generated at account creation. This address corresponds to a different PrivKey than the CometBFT PrivKey which is responsible for signing consensus messages. Validators thus do not have to sign governance transactions with the sensitive CometBFT PrivKey.

### Software Upgrade

If proposals are of type `SoftwareUpgradeProposal`, then nodes need to upgrade
their software to the new version that was voted. This process is divided into
two steps:

#### Signal

After a `SoftwareUpgradeProposal` is accepted, validators are expected to
download and install the new version of the software while continuing to run
the previous version. Once a validator has downloaded and installed the
upgrade, it will start signaling to the network that it is ready to switch by
including the proposal's `proposalID` in its *precommits*. (*Note: Confirmation that we want it in the precommit?*)

Note: There is only one signal slot per *precommit*. If several
`SoftwareUpgradeProposals` are accepted in a short timeframe, a pipeline will
form and they will be implemented one after the other in the order that they
were accepted.

#### Switch

Once a block contains more than 2/3rd *precommits* where a common
`SoftwareUpgradeProposal` is signaled, all the nodes (including validator
nodes, non-validating full nodes and light-nodes) are expected to switch to the
new version of the software.

Validators and full nodes can use an automation tool, such as [Cosmovisor](https://docs.cosmos.network/main/tooling/cosmovisor), for automatically switching version of the chain.

#### Burnable Params

There are three parameters that define if the deposit of a proposal should be burned or returned to the depositors.
Expand Down

0 comments on commit 5b1ee22

Please sign in to comment.