Enum pallet_society::pallet::Call

pub enum Call<T: Config<I>, I: 'static = ()> {
    bid {
        value: <<T as Config<I>>::Currency as Currency<<T as Config>::AccountId>>::Balance,
    },
    unbid {
        pos: u32,
    },
    vouch {
        who: T::AccountId,
        value: <<T as Config<I>>::Currency as Currency<<T as Config>::AccountId>>::Balance,
        tip: <<T as Config<I>>::Currency as Currency<<T as Config>::AccountId>>::Balance,
    },
    unvouch {
        pos: u32,
    },
    vote {
        candidate: <T::Lookup as StaticLookup>::Source,
        approve: bool,
    },
    defender_vote {
        approve: bool,
    },
    payout {},
    found {
        founder: T::AccountId,
        max_members: u32,
        rules: Vec<u8>,
    },
    unfound {},
    judge_suspended_member {
        who: T::AccountId,
        forgive: bool,
    },
    judge_suspended_candidate {
        who: T::AccountId,
        judgement: Judgement,
    },
    set_max_members {
        max: u32,
    },
    // some variants omitted
}

Contains one variant per dispatchable that can be called by an extrinsic.

Variants

bid

A user outside of the society can make a bid for entry.

Payment: CandidateDeposit will be reserved for making a bid. It is returned when the bid becomes a member, or if the bid calls unbid.

The dispatch origin for this call must be Signed.

Parameters:

• value: A one time payment the bid would like to receive when joining the society.

Key: B (len of bids), C (len of candidates), M (len of members), X (balance reserve)

• Storage Reads:
  • One storage read to check for suspended candidate. O(1)
  • One storage read to check for suspended member. O(1)
  • One storage read to retrieve all current bids. O(B)
  • One storage read to retrieve all current candidates. O(C)
  • One storage read to retrieve all members. O(M)
• Storage Writes:
  • One storage mutate to add a new bid to the vector O(B) (TODO: possible optimization w/ read)
  • Up to one storage removal if bid.len() > MAX_BID_COUNT. O(1)
• Notable Computation:
  • O(B + C + log M) search to check user is not already a part of society.
  • O(log B) search to insert the new bid sorted.
• External Pallet Operations:
  • One balance reserve operation. O(X)
  • Up to one balance unreserve operation if bids.len() > MAX_BID_COUNT.
• Events:
  • One event for new bid.
  • Up to one event for AutoUnbid if bid.len() > MAX_BID_COUNT.

Total Complexity: O(M + B + C + logM + logB + X)

Fields of bid

value: <<T as Config<I>>::Currency as Currency<<T as Config>::AccountId>>::Balance

unbid

A bidder can remove their bid for entry into society. By doing so, they will have their candidate deposit returned or they will unvouch their voucher.

Payment: The bid deposit is unreserved if the user made a bid.

The dispatch origin for this call must be Signed and a bidder.

Parameters:

• pos: Position in the Bids vector of the bid who wants to unbid.

Key: B (len of bids), X (balance unreserve)

• One storage read and write to retrieve and update the bids. O(B)
• Either one unreserve balance action O(X) or one vouching storage removal. O(1)
• One event.

Total Complexity: O(B + X)

Fields of unbid

pos: u32

vouch

As a member, vouch for someone to join society by placing a bid on their behalf.

There is no deposit required to vouch for a new bid, but a member can only vouch for one bid at a time. If the bid becomes a suspended candidate and ultimately rejected by the suspension judgement origin, the member will be banned from vouching again.

As a vouching member, you can claim a tip if the candidate is accepted. This tip will be paid as a portion of the reward the member will receive for joining the society.

The dispatch origin for this call must be Signed and a member.

Parameters:

• who: The user who you would like to vouch for.
• value: The total reward to be paid between you and the candidate if they become a member in the society.
• tip: Your cut of the total value payout when the candidate is inducted into the society. Tips larger than value will be saturated upon payout.

Key: B (len of bids), C (len of candidates), M (len of members)

• Storage Reads:
  • One storage read to retrieve all members. O(M)
  • One storage read to check member is not already vouching. O(1)
  • One storage read to check for suspended candidate. O(1)
  • One storage read to check for suspended member. O(1)
  • One storage read to retrieve all current bids. O(B)
  • One storage read to retrieve all current candidates. O(C)
• Storage Writes:
  • One storage write to insert vouching status to the member. O(1)
  • One storage mutate to add a new bid to the vector O(B) (TODO: possible optimization w/ read)
  • Up to one storage removal if bid.len() > MAX_BID_COUNT. O(1)
• Notable Computation:
  • O(log M) search to check sender is a member.
  • O(B + C + log M) search to check user is not already a part of society.
  • O(log B) search to insert the new bid sorted.
• External Pallet Operations:
  • One balance reserve operation. O(X)
  • Up to one balance unreserve operation if bids.len() > MAX_BID_COUNT.
• Events:
  • One event for vouch.
  • Up to one event for AutoUnbid if bid.len() > MAX_BID_COUNT.

Total Complexity: O(M + B + C + logM + logB + X)

Fields of vouch

who: T::AccountIdvalue: <<T as Config<I>>::Currency as Currency<<T as Config>::AccountId>>::Balancetip: <<T as Config<I>>::Currency as Currency<<T as Config>::AccountId>>::Balance

unvouch

As a vouching member, unvouch a bid. This only works while vouched user is only a bidder (and not a candidate).

The dispatch origin for this call must be Signed and a vouching member.

Parameters:

• pos: Position in the Bids vector of the bid who should be unvouched.

Key: B (len of bids)

• One storage read O(1) to check the signer is a vouching member.
• One storage mutate to retrieve and update the bids. O(B)
• One vouching storage removal. O(1)
• One event.

Total Complexity: O(B)

Fields of unvouch

pos: u32

vote

As a member, vote on a candidate.

The dispatch origin for this call must be Signed and a member.

Parameters:

• candidate: The candidate that the member would like to bid on.
• approve: A boolean which says if the candidate should be approved (true) or rejected (false).

Key: C (len of candidates), M (len of members)

• One storage read O(M) and O(log M) search to check user is a member.
• One account lookup.
• One storage read O(C) and O(C) search to check that user is a candidate.
• One storage write to add vote to votes. O(1)
• One event.

Total Complexity: O(M + logM + C)

Fields of vote

candidate: <T::Lookup as StaticLookup>::Sourceapprove: bool

defender_vote

As a member, vote on the defender.

The dispatch origin for this call must be Signed and a member.

Parameters:

• approve: A boolean which says if the candidate should be approved (true) or rejected (false).

• Key: M (len of members)
• One storage read O(M) and O(log M) search to check user is a member.
• One storage write to add vote to votes. O(1)
• One event.

Total Complexity: O(M + logM)

Fields of defender_vote

approve: bool

payout

Transfer the first matured payout for the sender and remove it from the records.

NOTE: This extrinsic needs to be called multiple times to claim multiple matured payouts.

Payment: The member will receive a payment equal to their first matured payout to their free balance.

The dispatch origin for this call must be Signed and a member with payouts remaining.

Key: M (len of members), P (number of payouts for a particular member)

• One storage read O(M) and O(log M) search to check signer is a member.
• One storage read O(P) to get all payouts for a member.
• One storage read O(1) to get the current block number.
• One currency transfer call. O(X)
• One storage write or removal to update the member’s payouts. O(P)

Total Complexity: O(M + logM + P + X)

Fields of payout

found

Found the society.

This is done as a discrete action in order to allow for the pallet to be included into a running chain and can only be done once.

The dispatch origin for this call must be from the FounderSetOrigin.

Parameters:

• founder - The first member and head of the newly founded society.
• max_members - The initial max number of members for the society.
• rules - The rules of this society concerning membership.

• Two storage mutates to set Head and Founder. O(1)
• One storage write to add the first member to society. O(1)
• One event.

Total Complexity: O(1)

Fields of found

founder: T::AccountIdmax_members: u32rules: Vec<u8>

unfound

Annul the founding of the society.

The dispatch origin for this call must be Signed, and the signing account must be both the Founder and the Head. This implies that it may only be done when there is one member.

• Two storage reads O(1).
• Four storage removals O(1).
• One event.

Total Complexity: O(1)

Fields of unfound

judge_suspended_member

Allow suspension judgement origin to make judgement on a suspended member.

If a suspended member is forgiven, we simply add them back as a member, not affecting any of the existing storage items for that member.

If a suspended member is rejected, remove all associated storage items, including their payouts, and remove any vouched bids they currently have.

The dispatch origin for this call must be from the SuspensionJudgementOrigin.

Parameters:

• who - The suspended member to be judged.
• forgive - A boolean representing whether the suspension judgement origin forgives (true) or rejects (false) a suspended member.

Key: B (len of bids), M (len of members)

• One storage read to check who is a suspended member. O(1)
• Up to one storage write O(M) with O(log M) binary search to add a member back to society.
• Up to 3 storage removals O(1) to clean up a removed member.
• Up to one storage write O(B) with O(B) search to remove vouched bid from bids.
• Up to one additional event if unvouch takes place.
• One storage removal. O(1)
• One event for the judgement.

Total Complexity: O(M + logM + B)

Fields of judge_suspended_member

who: T::AccountIdforgive: bool

judge_suspended_candidate

Allow suspended judgement origin to make judgement on a suspended candidate.

If the judgement is Approve, we add them to society as a member with the appropriate payment for joining society.

If the judgement is Reject, we either slash the deposit of the bid, giving it back to the society treasury, or we ban the voucher from vouching again.

If the judgement is Rebid, we put the candidate back in the bid pool and let them go through the induction process again.

The dispatch origin for this call must be from the SuspensionJudgementOrigin.

Parameters:

• who - The suspended candidate to be judged.
• judgement - Approve, Reject, or Rebid.

Key: B (len of bids), M (len of members), X (balance action)

• One storage read to check who is a suspended candidate.
• One storage removal of the suspended candidate.
• Approve Logic
  • One storage read to get the available pot to pay users with. O(1)
  • One storage write to update the available pot. O(1)
  • One storage read to get the current block number. O(1)
  • One storage read to get all members. O(M)
  • Up to one unreserve currency action.
  • Up to two new storage writes to payouts.
  • Up to one storage write with O(log M) binary search to add a member to society.
• Reject Logic
  • Up to one repatriate reserved currency action. O(X)
  • Up to one storage write to ban the vouching member from vouching again.
• Rebid Logic
  • Storage mutate with O(log B) binary search to place the user back into bids.
• Up to one additional event if unvouch takes place.
• One storage removal.
• One event for the judgement.

Total Complexity: O(M + logM + B + X)

Fields of judge_suspended_candidate

who: T::AccountIdjudgement: Judgement

set_max_members

Allows root origin to change the maximum number of members in society. Max membership count must be greater than 1.

The dispatch origin for this call must be from ROOT.

Parameters:

• max - The maximum number of members for the society.

• One storage write to update the max. O(1)
• One event.

Total Complexity: O(1)

Fields of set_max_members

max: u32

Implementations

impl<T: Config<I>, I: 'static> Call<T, I>

pub fn new_call_variant_bid(
    value: <<T as Config<I>>::Currency as Currency<<T as Config>::AccountId>>::Balance
) -> Self

Create a call with the variant bid.

pub fn new_call_variant_unbid(pos: u32) -> Self

Create a call with the variant unbid.

pub fn new_call_variant_vouch(
    who: T::AccountId,
    value: <<T as Config<I>>::Currency as Currency<<T as Config>::AccountId>>::Balance,
    tip: <<T as Config<I>>::Currency as Currency<<T as Config>::AccountId>>::Balance
) -> Self

Create a call with the variant vouch.

pub fn new_call_variant_unvouch(pos: u32) -> Self

Create a call with the variant unvouch.

pub fn new_call_variant_vote(
    candidate: <T::Lookup as StaticLookup>::Source,
    approve: bool
) -> Self

Create a call with the variant vote.

pub fn new_call_variant_defender_vote(approve: bool) -> Self

Create a call with the variant defender_vote.

pub fn new_call_variant_payout() -> Self

Create a call with the variant payout.

pub fn new_call_variant_found(
    founder: T::AccountId,
    max_members: u32,
    rules: Vec<u8>
) -> Self

Create a call with the variant found.

pub fn new_call_variant_unfound() -> Self

Create a call with the variant unfound.

pub fn new_call_variant_judge_suspended_member(
    who: T::AccountId,
    forgive: bool
) -> Self

Create a call with the variant judge_suspended_member.

pub fn new_call_variant_judge_suspended_candidate(
    who: T::AccountId,
    judgement: Judgement
) -> Self

Create a call with the variant judge_suspended_candidate.

pub fn new_call_variant_set_max_members(max: u32) -> Self

Create a call with the variant set_max_members.

Trait Implementations

impl<T: Config<I>, I: 'static> Clone for Call<T, I>

fn clone(&self) -> Self

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<T: Config<I>, I: 'static> Debug for Call<T, I>

fn fmt(&self, fmt: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<T: Config<I>, I: 'static> Decode for Call<T, I>

fn decode<__CodecInputEdqy: Input>(
    __codec_input_edqy: &mut __CodecInputEdqy
) -> Result<Self, Error>

Attempt to deserialise the value from input.

fn skip<I>(input: &mut I) -> Result<(), Error> where
    I: Input, 

Attempt to skip the encoded value from input.

fn encoded_fixed_size() -> Option<usize>

Returns the fixed encoded size of the type.

impl<T: Config<I>, I: 'static> Encode for Call<T, I>

fn encode_to<__CodecOutputEdqy: Output + ?Sized>(
    &self,
    __codec_dest_edqy: &mut __CodecOutputEdqy
)

Convert self to a slice and append it to the destination.

fn size_hint(&self) -> usize

If possible give a hint of expected size of the encoding.

fn encode(&self) -> Vec<u8, Global>

Convert self to an owned vector.

fn using_encoded<R, F>(&self, f: F) -> R where
    F: FnOnce(&[u8]) -> R, 

Convert self to a slice and then invoke the given closure with it.

fn encoded_size(&self) -> usize

Calculates the encoded size.

impl<T: Config<I>, I: 'static> GetCallName for Call<T, I>

fn get_call_name(&self) -> &'static str

Return the function name of the Call.

fn get_call_names() -> &'static [&'static str]

Return all function names.

impl<T: Config<I>, I: 'static> GetDispatchInfo for Call<T, I>

fn get_dispatch_info(&self) -> DispatchInfo

Return a DispatchInfo, containing relevant information of this dispatch.

impl<T: Config<I>, I: 'static> PartialEq<Call<T, I>> for Call<T, I>

fn eq(&self, other: &Self) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl<T: Config<I>, I: 'static> TypeInfo for Call<T, I> where
    PhantomData<(T, I)>: TypeInfo + 'static,
    <<T as Config<I>>::Currency as Currency<<T as Config>::AccountId>>::Balance: TypeInfo + 'static,
    T::AccountId: TypeInfo + 'static,
    <<T as Config<I>>::Currency as Currency<<T as Config>::AccountId>>::Balance: TypeInfo + 'static,
    <<T as Config<I>>::Currency as Currency<<T as Config>::AccountId>>::Balance: TypeInfo + 'static,
    <T::Lookup as StaticLookup>::Source: TypeInfo + 'static,
    T::AccountId: TypeInfo + 'static,
    T::AccountId: TypeInfo + 'static,
    T::AccountId: TypeInfo + 'static,
    T: Config<I> + 'static,
    I: 'static, 

type Identity = Self

The type identifying for which type info is provided.

fn type_info() -> Type

Returns the static type identifier for Self.

impl<T: Config<I>, I: 'static> UnfilteredDispatchable for Call<T, I>

type Origin = OriginFor<T>

The origin type of the runtime, (i.e. frame_system::Config::Origin).

fn dispatch_bypass_filter(
    self,
    origin: Self::Origin
) -> DispatchResultWithPostInfo

Dispatch this call but do not check the filter in origin.

impl<T: Config<I>, I: 'static> EncodeLike<Call<T, I>> for Call<T, I>

impl<T: Config<I>, I: 'static> Eq for Call<T, I>