#member #vote #voting #set #prime #account-id #motion

no-std pallet-collective

Collective system: Members of a set of account IDs can make their collective feelings known through dispatched calls from one of two specialized origins. (polkadot v1.15.0)

53 releases (35 major breaking)

new 37.0.0 Jul 18, 2024
36.0.0 Jul 12, 2024
35.0.0 Jun 24, 2024
34.0.0 May 23, 2024
2.0.0-alpha.5 Mar 24, 2020

#1333 in Magic Beans

Download history 1306/week @ 2024-03-27 1050/week @ 2024-04-03 1014/week @ 2024-04-10 799/week @ 2024-04-17 731/week @ 2024-04-24 913/week @ 2024-05-01 626/week @ 2024-05-08 985/week @ 2024-05-15 1139/week @ 2024-05-22 1370/week @ 2024-05-29 1281/week @ 2024-06-05 1157/week @ 2024-06-12 1238/week @ 2024-06-19 1340/week @ 2024-06-26 593/week @ 2024-07-03 1266/week @ 2024-07-10

4,692 downloads per month
Used in 17 crates (8 directly)

Apache-2.0

2.5MB
46K SLoC

Collective system: Members of a set of account IDs can make their collective feelings known through dispatched calls from one of two specialized origins.

The membership can be provided in one of two ways: either directly, using the Root-dispatchable function set_members, or indirectly, through implementing the ChangeMembers. The pallet assumes that the amount of members stays at or below MaxMembers for its weight calculations, but enforces this neither in set_members nor in change_members_sorted.

A "prime" member may be set to help determine the default vote behavior based on chain config. If PrimeDefaultVote is used, the prime vote acts as the default vote in case of any abstentions after the voting period. If MoreThanMajorityThenPrimeDefaultVote is used, then abstentions will first follow the majority of the collective voting, and then the prime member.

Voting happens through motions comprising a proposal (i.e. a dispatchable) plus a number of approvals required for it to pass and be called. Motions are open for members to vote on for a minimum period given by MotionDuration. As soon as the required number of approvals is given, the motion is closed and executed. If the number of approvals is not reached during the voting period, then close may be called by any account in order to force the end the motion explicitly. If a prime member is defined, then their vote is used instead of any abstentions and the proposal is executed if there are enough approvals counting the new votes.

If there are not, or if no prime member is set, then the motion is dropped without being executed.

License: Apache-2.0

Dependencies

~18–32MB
~547K SLoC