#rank #vote #member #system #pallet #origin #polkadot

no-std pallet-ranked-collective

Ranked 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.10.0)

29 major breaking releases

new 32.0.0 Apr 8, 2024
31.0.0 Mar 18, 2024
30.0.0 Feb 26, 2024
29.0.0 Feb 13, 2024
0.0.0 Nov 21, 2022

#978 in Magic Beans

Download history 260/week @ 2023-12-18 47/week @ 2023-12-25 617/week @ 2024-01-01 626/week @ 2024-01-08 233/week @ 2024-01-15 344/week @ 2024-01-22 296/week @ 2024-01-29 389/week @ 2024-02-05 684/week @ 2024-02-12 1172/week @ 2024-02-19 1209/week @ 2024-02-26 415/week @ 2024-03-04 352/week @ 2024-03-11 738/week @ 2024-03-18 628/week @ 2024-03-25 1076/week @ 2024-04-01

2,819 downloads per month
Used in 13 crates (6 directly)

Apache-2.0

2.5MB
49K SLoC

Ranked collective system

This is a membership pallet providing a Tally implementation ready for use with polling systems such as the Referenda pallet. Members each have a rank, with zero being the lowest. There is no complexity limitation on either the number of members at a rank or the number of ranks in the system thus allowing potentially public membership. A member of at least a given rank can be selected at random in O(1) time, allowing for various games to constructed using this as a primitive. Members may only be promoted and demoted by one rank at a time, however all operations (save one) are O(1) in complexity. The only operation which is not O(1) is the remove_member since they must be removed from all ranks from the present down to zero.

Different ranks have different voting power, and are able to vote in different polls. In general rank privileges are cumulative. Higher ranks are able to vote in any polls open to lower ranks. Similarly, higher ranks always have at least as much voting power in any given poll as lower ranks.

Two Config trait items control these "rank privileges": MinRankOfClass and VoteWeight. The first controls which ranks are allowed to vote on a particular class of poll. The second controls the weight of a vote given the voters rank compared to the minimum rank of the poll.

An origin control, EnsureRank, ensures that the origin is a member of the collective of at least a particular rank.

Dependencies

~16–30MB
~490K SLoC