Governance via Polkadot.js

Learn how to create and vote for a governance proposal via the polkadot.js app

Introduction

We can referenda normal proposals and external proposals.

Normal proposals require endorsers (some people stake tokens to support) to decide which proposals can be voted on in the next round of referendums.

proposals

Usually, Only one proposal will be voted on per round of referenda.

The council can propose an external proposal, Then this external will have priority in the next round of referendums.

external-proposal

There may be more than two referendum if the technical committee uses the “Fast track” to urgently process an external proposal.

fast-track-referenda

How to upgrade runtime through governance?

Take the external proposal as an example.

1. Compile the new version of the compressed wasm file

It usually ends with .compact.compressed.wasm.

2. Submit a preimage

Preimage is the content of a proposal that contains all the parameters of an extrinsic.

Anyone can submit the preimage.

submit-preimage

preimage-submission-form

Be sure to record the preimage hash before submitting.

3. Submit an external proposal

Use the council member’s account to submit an external proposal.

propose-external

external-proposal-submission-form

Council members can vote on it. If the threshold is reached before the voting period ends, after clicking close button, the proposal will be moved to a external proposal list in democracy page.

close-external-proposal

become-propose-external

We need to wait for the start of a new round of referenda, this proposal will go to referendum.

LaunchPeriod is in the upper right corner of the image. It is the duration of each round of referenda, it is 7 days in Turing.

4. Vote for proposal

Users can vote during the voting period after the new round of referenda begins. VotingPeriod is 7 days in Turing.

referenda

After VotingPeriod, if the proposal wins the referendum, it will wait for the delay defined by EnactmentPeriod to execute. EnactmentPeriod is 8 days in Turing.

dispatch-proposal

4. Fast-track from Technical Committee In order to expedite the external proposal, the Technical Committee can create a motion to fast-track it. Please refer to the Fast-track an External Proposal for the detailed steps.

Update chain configuration through Governance

Similar steps as above:

1. Submit a preimage.

do-a-configuration

2. Submit a normal proposal or external proposal.

3. If the external proposal needs urgent processing, the technical committee can use the “fast track” to process it.

4. conduct a referendum.

5. When the voting period ends, the vote will be executed at the end of the enactment period.

The outcome of the referendum

There are 3 ways to win or lose a referendum:

1. Public Referenda

The condition for winning the referendum:

public-referenda

approve - the number of aye votes

against - the number of nay votes

turnout - the total number of voting tokens (does not include conviction)

electorate - the total number of tokens issued in the network

A heavy super-majority of aye votes is required to carry at low turnouts

2. Unanimous Council Referenda

When all members of the council agree on a proposal, it can be moved to a referendum.

The condition for winning the referendum:

image

when the turnout rate is low, a super-majority is required to reject the proposal, which means a lower threshold of “aye” votes have to be reached

3. Majority Council Referendum

When agreement from only a simple majority of council members occurs, the referendum can also be voted upon.

The condition for winning the referendum:

image

Votes of referendum

Polkadot utilizes an idea called Voluntary Locking that allows token holders to increase their voting power by declaring how long they are willing to lock up their tokens, hence, the number of votes for each token holder will be calculated by the following formula:

votes = tokens * conviction_multiplier

The conviction multiplier increases the vote multiplier by one every time the number of lock periods double.

Lock Periods Vote Multiplier
0 1
1 1
2 2
4 3
8 4
16 5
32 6

Only the winning voter’s tokens are locked.

References

Questions like how to count votes are very important and there are many ways to count votes, so please read the official article carefully.

Governance

https://wiki.polkadot.network/docs/learn-governance


Delegation via Extrinsics
Verify Runtime of Upgrade