Crate pallet_ranked_collective

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 be 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 voter’s 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.

Re-exports

• pub use weights::WeightInfo;
• pub use pallet::*;

Modules

• pallet
  The pallet module in each FRAME pallet hosts the most important items needed to construct this pallet.
• weights
  Autogenerated weights for pallet_ranked_collective

Structs

• EnsureMember
  Guard to ensure that the given origin is a member of the collective. The account ID of the member is the Success value.
• EnsureOfRank
  Guard to ensure that the given origin is a member of the collective. The rank of the member is the Success value.
• EnsureRanked
  Guard to ensure that the given origin is a member of the collective. The rank of the member is the Success value.
• EnsureRankedMember
  Guard to ensure that the given origin is a member of the collective. The pair of both the account ID and the rank of the member is the Success value.
• Geometric
  Vote-weight scheme where all voters get one vote plus additional votes for every excess rank they have incrementing by one vote for each excess rank. I.e.:
• Linear
  Vote-weight scheme where all voters get one vote plus an additional vote for every excess rank they have. I.e.:
• MemberRecord
  Record needed for every member.
• Tally
  Aggregated votes for an ongoing poll by members of the ranked collective.
• Unit
  Vote-weight scheme where all voters get one vote regardless of rank.

Enums

• VoteRecord
  Record needed for every vote.

Traits

• BenchmarkSetup
  Helper functions to setup benchmarking.
• GetMaxVoters
  Trait for getting the maximum number of voters for a given poll class.

Type Aliases

• ClassOf
• MemberIndex
  A number of members.
• PollIndexOf
• Rank
  Member rank.
• TallyOf
• Votes
  Votes.