Crate noble_democracy[][src]

Democracy Noble

Overview

The Democracy noble handles the administration of general stakeholder voting.

There are two different queues that a proposal can be added to before it becomes a referendum, 1) the proposal queue consisting of all public proposals and 2) the external queue consisting of a single proposal that originates from one of the external origins (such as a collective group).

Every launch period - a length defined in the runtime - the Democracy noble launches a referendum from a proposal that it takes from either the proposal queue or the external queue in turn. Any token holder in the system can vote on referenda. The voting system uses time-lock voting by allowing the token holder to set their conviction behind a vote. The conviction will dictate the length of time the tokens will be locked, as well as the multiplier that scales the vote power.

Terminology

  • Enactment Period: The minimum period of locking and the period between a proposal being approved and enacted.
  • Lock Period: A period of time after proposal enactment that the tokens of winning voters will be locked.
  • Conviction: An indication of a voter’s strength of belief in their vote. An increase of one in conviction indicates that a token holder is willing to lock their tokens for twice as many lock periods after enactment.
  • Vote: A value that can either be in approval (“Aye”) or rejection (“Nay”) of a particular referendum.
  • Proposal: A submission to the chain that represents an action that a proposer (either an account or an external origin) suggests that the system adopt.
  • Referendum: A proposal that is in the process of being voted on for either acceptance or rejection as a change to the system.
  • Delegation: The act of granting your voting power to the decisions of another account for up to a certain conviction.

Adaptive Quorum Biasing

A referendum can be either simple majority-carries in which 50%+1 of the votes decide the outcome or adaptive quorum biased. Adaptive quorum biasing makes the threshold for passing or rejecting a referendum higher or lower depending on how the referendum was originally proposed. There are two types of adaptive quorum biasing: 1) positive turnout bias makes a referendum require a super-majority to pass that decreases as turnout increases and 2) negative turnout bias makes a referendum require a super-majority to reject that decreases as turnout increases. Another way to think about the quorum biasing is that positive bias referendums will be rejected by default and negative bias referendums get passed by default.

Interface

Dispatchable Functions

Public

These calls can be made from any externally held account capable of creating a signed extrinsic.

Basic actions:

  • propose - Submits a sensitive action, represented as a hash. Requires a deposit.
  • second - Signals agreement with a proposal, moves it higher on the proposal queue, and requires a matching deposit to the original.
  • vote - Votes in a referendum, either the vote is “Aye” to enact the proposal or “Nay” to keep the status quo.
  • unvote - Cancel a previous vote, this must be done by the voter before the vote ends.
  • delegate - Delegates the voting power (tokens * conviction) to another account.
  • undelegate - Stops the delegation of voting power to another account.

Administration actions that can be done to any account:

  • reap_vote - Remove some account’s expired votes.
  • unlock - Redetermine the account’s balance lock, potentially making tokens available.

Preimage actions:

  • note_preimage - Registers the preimage for an upcoming proposal, requires a deposit that is returned once the proposal is enacted.
  • note_preimage_operational - same but provided by T::OperationalPreimageOrigin.
  • note_imminent_preimage - Registers the preimage for an upcoming proposal. Does not require a deposit, but the proposal must be in the dispatch queue.
  • note_imminent_preimage_operational - same but provided by T::OperationalPreimageOrigin.
  • reap_preimage - Removes the preimage for an expired proposal. Will only work under the condition that it’s the same account that noted it and after the voting period, OR it’s a different account after the enactment period.

Cancellation Origin

This call can only be made by the CancellationOrigin.

  • emergency_cancel - Schedules an emergency cancellation of a referendum. Can only happen once to a specific referendum.

ExternalOrigin

This call can only be made by the ExternalOrigin.

  • external_propose - Schedules a proposal to become a referendum once it is is legal for an externally proposed referendum.

External Majority Origin

This call can only be made by the ExternalMajorityOrigin.

  • external_propose_majority - Schedules a proposal to become a majority-carries referendum once it is legal for an externally proposed referendum.

External Default Origin

This call can only be made by the ExternalDefaultOrigin.

  • external_propose_default - Schedules a proposal to become a negative-turnout-bias referendum once it is legal for an externally proposed referendum.

Fast Track Origin

This call can only be made by the FastTrackOrigin.

  • fast_track - Schedules the current externally proposed proposal that is “majority-carries” to become a referendum immediately.

Veto Origin

This call can only be made by the VetoOrigin.

  • veto_external - Vetoes and blacklists the external proposal hash.

Root

  • cancel_referendum - Removes a referendum.
  • cancel_queued - Cancels a proposal that is queued for enactment.
  • clear_public_proposal - Removes all public proposals.

Re-exports

pub use weights::WeightInfo;
pub use $crate::traits::GetNobleVersion as _;

Modules

weights

Weights for noble_democracy THIS FILE WAS AUTO-GENERATED USING THE TETCORE BENCHMARK CLI VERSION 2.0.0 DATE: 2020-10-28, STEPS: [50, ], REPEAT: 20, LOW RANGE: [], HIGH RANGE: [] EXECUTION: Some(Wasm), WASM-EXECUTION: Compiled, CHAIN: Some(“dev”), DB CACHE: 128

Structs

Blacklist

A record of who vetoed what. Maps proposal hash to a possible existent block number (until when it may not be resubmitted) and who vetoed it.

Cancellations

Record of all proposals that have been subject to emergency cancellation.

Delegations

Amount of votes and capital placed in delegation for an account.

DepositOf

Those who have locked a deposit.

GenesisConfig

Genesis config for the module, allow to build genesis storage.

LastTabledWasExternal

True if the last referendum tabled was submitted externally. False if it was a public proposal.

Locks

Accounts for which there are locks in action which may be removed at some point in the future. The value is the block number at which the lock expires and may be removed.

LowestUnbaked

The lowest referendum index representing an unbaked referendum. Equal to ReferendumCount if there isn’t a unbaked referendum.

Module
NextExternal

The referendum to be tabled whenever it would be valid to table an external proposal. This happens when a referendum needs to be tabled and one of two conditions are met:

Preimages

Map of hashes to the proposal preimage, along with who registered it and their deposit. The block number is the block at which it was deposited.

PublicPropCount

The number of (public) proposals that have been made so far.

PublicProps

The public proposals. Unsorted. The second item is the proposal’s hash.

ReferendumCount

The next free referendum index, aka the number of referenda started so far.

ReferendumInfoOf

Information concerning any given referendum.

ReferendumStatus

Info regarding an ongoing referendum.

Tally

Info regarding an ongoing referendum.

Vote

A number of lock periods, plus a vote, one way or the other.

VotingOf

All votes for a particular voter. We store the balance for the number of votes that we have recorded. The second item is the total amount of delegations, that will be added.

Enums

AccountVote

A vote for a referendum of a particular account.

Call

Dispatchable calls.

Conviction

A value denoting the strength of conviction of a vote.

Error
PreimageStatus
RawEvent

Events for this module.

ReferendumInfo

Info regarding a referendum, present or past.

UnvoteScope

Whether an unvote operation is able to make actions that are not strictly always in the interest of an account.

VoteThreshold

A means of determining if a vote is past pass threshold.

Voting

An indicator for what an account is doing; it can either be delegating or voting.

Constants

MAX_VETOERS

The maximum number of vetoers on a single proposal used to compute Weight.

Traits

Approved
Config

Type Definitions

Event

RawEvent specialized for the configuration Config

PropIndex

A proposal index.

ReferendumIndex

A referendum index.