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 byT::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 byT::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
|
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 |
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 | |
PropIndex | A proposal index. |
ReferendumIndex | A referendum index. |