Struct noble_society::Module [−][src]
The module declaration.
Implementations
impl<T: Config<I> + 'static, I: Instance> Module<T, I>
[src]
pub fn founder() -> Option<T::AccountId>
[src]
The first member.
pub fn rules() -> Option<T::Hash>
[src]
A hash of the rules of this society concerning membership. Can only be set once and only by the founder.
pub fn candidates(
) -> Vec<Bid<T::AccountId, <<T as Config<I>>::Currency as Currency<<T as Config>::AccountId>>::Balance>>
[src]
) -> Vec<Bid<T::AccountId, <<T as Config<I>>::Currency as Currency<<T as Config>::AccountId>>::Balance>>
The current set of candidates; bidders that are attempting to become members.
pub fn suspended_candidate<K: EncodeLike<T::AccountId>>(
key: K
) -> Option<(<<T as Config<I>>::Currency as Currency<<T as Config>::AccountId>>::Balance, BidKind<T::AccountId, <<T as Config<I>>::Currency as Currency<<T as Config>::AccountId>>::Balance>)>
[src]
key: K
) -> Option<(<<T as Config<I>>::Currency as Currency<<T as Config>::AccountId>>::Balance, BidKind<T::AccountId, <<T as Config<I>>::Currency as Currency<<T as Config>::AccountId>>::Balance>)>
The set of suspended candidates.
pub fn pot(
) -> <<T as Config<I>>::Currency as Currency<<T as Config>::AccountId>>::Balance
[src]
) -> <<T as Config<I>>::Currency as Currency<<T as Config>::AccountId>>::Balance
Amount of our account balance that is specifically for the next round’s bid(s).
pub fn head() -> Option<T::AccountId>
[src]
The most primary from the most recently approved members.
pub fn members() -> Vec<T::AccountId>
[src]
The current set of members, ordered.
pub fn suspended_member<K: EncodeLike<T::AccountId>>(key: K) -> bool
[src]
The set of suspended members.
pub fn vouching<K: EncodeLike<T::AccountId>>(key: K) -> Option<VouchingStatus>
[src]
Members currently vouching or banned from vouching again
pub fn defender() -> Option<T::AccountId>
[src]
The defending member currently being challenged.
pub fn max_members() -> u32
[src]
The max number of members for the society at one time.
impl<T: Config<I>, I: Instance> Module<T, I>
[src]
Can also be called using Call
.
pub fn bid(
origin: T::Origin,
value: <<T as Config<I>>::Currency as Currency<<T as Config>::AccountId>>::Balance
) -> DispatchResult
[src]
origin: T::Origin,
value: <<T as Config<I>>::Currency as Currency<<T as Config>::AccountId>>::Balance
) -> DispatchResult
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 Module 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)
NOTE: Calling this function will bypass origin filters.
pub fn unbid(origin: T::Origin, pos: u32) -> DispatchResult
[src]
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 theBids
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)
NOTE: Calling this function will bypass origin filters.
pub fn vouch(
origin: T::Origin,
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
) -> DispatchResult
[src]
origin: T::Origin,
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
) -> DispatchResult
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 totalvalue
payout when the candidate is inducted into the society. Tips larger thanvalue
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 Module 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)
NOTE: Calling this function will bypass origin filters.
pub fn unvouch(origin: T::Origin, pos: u32) -> DispatchResult
[src]
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 theBids
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)
NOTE: Calling this function will bypass origin filters.
pub fn vote(
origin: T::Origin,
candidate: <T::Lookup as StaticLookup>::Source,
approve: bool
) -> DispatchResult
[src]
origin: T::Origin,
candidate: <T::Lookup as StaticLookup>::Source,
approve: bool
) -> DispatchResult
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)
NOTE: Calling this function will bypass origin filters.
pub fn defender_vote(origin: T::Origin, approve: bool) -> DispatchResult
[src]
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)
NOTE: Calling this function will bypass origin filters.
pub fn payout(origin: T::Origin) -> DispatchResult
[src]
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)
NOTE: Calling this function will bypass origin filters.
impl<T: Config<I>, I: Instance> Module<T, I>
[src]
pub fn remove_member(m: &T::AccountId) -> DispatchResult
[src]
Remove a member from the members list, except the Head.
NOTE: This does not correctly clean up a member from storage. It simply removes them from the Members storage item.
pub fn account_id() -> T::AccountId
[src]
The account ID of the treasury pot.
This actually does computation. If you need to keep using it, then make sure you cache the value and only call this once.
pub fn payouts() -> T::AccountId
[src]
The account ID of the payouts pot. This is where payouts are made from.
This actually does computation. If you need to keep using it, then make sure you cache the value and only call this once.
pub fn take_selected(
members_len: usize,
pot: <<T as Config<I>>::Currency as Currency<<T as Config>::AccountId>>::Balance
) -> Vec<Bid<T::AccountId, <<T as Config<I>>::Currency as Currency<<T as Config>::AccountId>>::Balance>>
[src]
members_len: usize,
pot: <<T as Config<I>>::Currency as Currency<<T as Config>::AccountId>>::Balance
) -> Vec<Bid<T::AccountId, <<T as Config<I>>::Currency as Currency<<T as Config>::AccountId>>::Balance>>
Get a selection of bidding accounts such that the total bids is no greater than Pot
and
the number of bids would not surpass MaxMembers
if all were accepted.
May be empty.
Trait Implementations
impl<T: Config<I>, I: Instance> Callable<T> for Module<T, I>
[src]
impl<T: Clone + Config<I>, I: Clone + Instance> Clone for Module<T, I>
[src]
impl<T: Copy + Config<I>, I: Copy + Instance> Copy for Module<T, I>
[src]
impl<T: Config<I>, I: Instance> Debug for Module<T, I> where
T: Debug,
I: Debug,
[src]
T: Debug,
I: Debug,
impl<T: Eq + Config<I>, I: Eq + Instance> Eq for Module<T, I>
[src]
impl<T: Config<I>, I: Instance> GetNobleVersion for Module<T, I>
[src]
fn current_version() -> NobleVersion
[src]
fn storage_version() -> Option<NobleVersion>
[src]
impl<T: Config<I>, I: Instance> IntegrityTest for Module<T, I>
[src]
pub fn integrity_test()
[src]
impl<T: Config<I>, I: Instance> ModuleErrorMetadata for Module<T, I>
[src]
fn metadata() -> &'static [ErrorMetadata]
[src]
impl<T: Config + Config<I>, I: Instance> OffchainWorker<<T as Config>::BlockNumber> for Module<T, I>
[src]
pub fn offchain_worker(_n: BlockNumber)
[src]
impl<T: Config + Config<I>, I: Instance> OnFinalize<<T as Config>::BlockNumber> for Module<T, I>
[src]
pub fn on_finalize(_n: BlockNumber)
[src]
impl<T: Config<I>, I: Instance> OnGenesis for Module<T, I>
[src]
fn on_genesis()
[src]
impl<T: Config + Config<I>, I: Instance> OnInitialize<<T as Config>::BlockNumber> for Module<T, I>
[src]
fn on_initialize(n: T::BlockNumber) -> Weight
[src]
impl<T: Config<I>, I: Instance> OnRuntimeUpgrade for Module<T, I>
[src]
fn on_runtime_upgrade() -> Weight
[src]
impl<T: Config> OnUnbalanced<<<T as Config<DefaultInstance>>::Currency as Currency<<T as Config>::AccountId>>::NegativeImbalance> for Module<T>
[src]
fn on_nonzero_unbalanced(
amount: <<T as Config>::Currency as Currency<<T as Config>::AccountId>>::NegativeImbalance
)
[src]
amount: <<T as Config>::Currency as Currency<<T as Config>::AccountId>>::NegativeImbalance
)
pub fn on_unbalanceds<B>(amounts: impl Iterator<Item = Imbalance>) where
Imbalance: Imbalance<B>,
[src]
Imbalance: Imbalance<B>,
pub fn on_unbalanced(amount: Imbalance)
[src]
impl<T: PartialEq + Config<I>, I: PartialEq + Instance> PartialEq<Module<T, I>> for Module<T, I>
[src]
impl<T: Config<I>, I: Instance> StructuralEq for Module<T, I>
[src]
impl<T: Config<I>, I: Instance> StructuralPartialEq for Module<T, I>
[src]
Auto Trait Implementations
impl<T, I> RefUnwindSafe for Module<T, I> where
I: RefUnwindSafe,
T: RefUnwindSafe,
I: RefUnwindSafe,
T: RefUnwindSafe,
impl<T, I> Send for Module<T, I> where
I: Send,
T: Send,
I: Send,
T: Send,
impl<T, I> Sync for Module<T, I> where
I: Sync,
T: Sync,
I: Sync,
T: Sync,
impl<T, I> Unpin for Module<T, I> where
I: Unpin,
T: Unpin,
I: Unpin,
T: Unpin,
impl<T, I> UnwindSafe for Module<T, I> where
I: UnwindSafe,
T: UnwindSafe,
I: UnwindSafe,
T: UnwindSafe,
Blanket Implementations
impl<T> Any for T where
T: 'static + ?Sized,
[src]
T: 'static + ?Sized,
impl<T> Borrow<T> for T where
T: ?Sized,
[src]
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]
T: ?Sized,
pub fn borrow_mut(&mut self) -> &mut T
[src]
impl<T> CheckedConversion for T
[src]
pub fn checked_from<T>(t: T) -> Option<Self> where
Self: TryFrom<T>,
[src]
Self: TryFrom<T>,
pub fn checked_into<T>(self) -> Option<T> where
Self: TryInto<T>,
[src]
Self: TryInto<T>,
impl<T> Downcast for T where
T: Any,
T: Any,
pub fn into_any(self: Box<T, Global>) -> Box<dyn Any + 'static, Global>
pub fn into_any_rc(self: Rc<T>) -> Rc<dyn Any + 'static>
pub fn as_any(&self) -> &(dyn Any + 'static)
pub fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
impl<T> DowncastSync for T where
T: Any + Send + Sync,
T: Any + Send + Sync,
impl<T> DynClone for T where
T: Clone,
[src]
T: Clone,
pub fn __clone_box(&self, Private) -> *mut ()
[src]
impl<T> From<T> for T
[src]
impl<T> Instrument for T
[src]
pub fn instrument(self, span: Span) -> Instrumented<Self>
[src]
pub fn in_current_span(self) -> Instrumented<Self>
[src]
impl<T, U> Into<U> for T where
U: From<T>,
[src]
U: From<T>,
impl<T> IsType<T> for T
[src]
pub fn from_ref(t: &T) -> &T
[src]
pub fn into_ref(&self) -> &T
[src]
pub fn from_mut(t: &mut T) -> &mut T
[src]
pub fn into_mut(&mut self) -> &mut T
[src]
impl<T, Outer> IsWrappedBy<Outer> for T where
T: From<Outer>,
Outer: AsRef<T> + AsMut<T> + From<T>,
T: From<Outer>,
Outer: AsRef<T> + AsMut<T> + From<T>,
pub fn from_ref(outer: &Outer) -> &T
Get a reference to the inner from the outer.
pub fn from_mut(outer: &mut Outer) -> &mut T
Get a mutable reference to the inner from the outer.
impl<T> MaybeDebug for T where
T: Debug,
T: Debug,
impl<T> MaybeDebug for T where
T: Debug,
T: Debug,
impl<T> MaybeRefUnwindSafe for T where
T: RefUnwindSafe,
T: RefUnwindSafe,
impl<T> Member for T where
T: 'static + Send + Sync + Debug + Eq + PartialEq<T> + Clone,
[src]
T: 'static + Send + Sync + Debug + Eq + PartialEq<T> + Clone,
impl<T> Same<T> for T
type Output = T
Should always be Self
impl<T> SaturatedConversion for T
pub fn saturated_from<T>(t: T) -> Self where
Self: UniqueSaturatedFrom<T>,
Self: UniqueSaturatedFrom<T>,
pub fn saturated_into<T>(self) -> T where
Self: UniqueSaturatedInto<T>,
Self: UniqueSaturatedInto<T>,
impl<T> ToOwned for T where
T: Clone,
[src]
T: Clone,
type Owned = T
The resulting type after obtaining ownership.
pub fn to_owned(&self) -> T
[src]
pub fn clone_into(&self, target: &mut T)
[src]
impl<T, U> TryFrom<U> for T where
U: Into<T>,
[src]
U: Into<T>,
type Error = Infallible
The type returned in the event of a conversion error.
pub fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
[src]
impl<T, U> TryInto<U> for T where
U: TryFrom<T>,
[src]
U: TryFrom<T>,
type Error = <U as TryFrom<T>>::Error
The type returned in the event of a conversion error.
pub fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>
[src]
impl<S, T> UncheckedInto<T> for S where
T: UncheckedFrom<S>,
T: UncheckedFrom<S>,
pub fn unchecked_into(self) -> T
impl<T, S> UniqueSaturatedInto<T> for S where
T: Bounded,
S: TryInto<T>,
T: Bounded,
S: TryInto<T>,
pub fn unique_saturated_into(self) -> T
impl<V, T> VZip<V> for T where
V: MultiLane<T>,
V: MultiLane<T>,