Struct sp_npos_elections::Assignment

pub struct Assignment<AccountId, P: PerThing> {
    pub who: AccountId,
    pub distribution: Vec<(AccountId, P)>,
}

A voter’s stake assignment among a set of targets, represented as ratios.

Fields

who: AccountId

Voter’s identifier.

distribution: Vec<(AccountId, P)>

The distribution of the voter’s stake.

Implementations

impl<AccountId: IdentifierT, P: PerThing128> Assignment<AccountId, P>

pub fn into_staked(self, stake: ExtendedBalance) -> StakedAssignment<AccountId>

Convert from a ratio assignment into one with absolute values aka. StakedAssignment.

It needs stake which is the total budget of the voter.

Note that this might create un-normalized assignments, due to accuracy loss of P. Call site might compensate by calling try_normalize() on the returned StakedAssignment as a post-precessing.

If an edge ratio is Bounded::min_value(), it is dropped. This edge can never mean anything useful.

pub fn try_normalize(&mut self) -> Result<(), &'static str>

Try and normalize this assignment.

If Ok(()) is returned, then the assignment MUST have been successfully normalized to 100%.

Errors

This will return only if the internal normalize fails. This can happen if sum of self.distribution.map(|p| p.deconstruct()) fails to fit inside UpperOf<P>. A user of this crate may statically assert that this can never happen and safely expect this to return Ok.

Trait Implementations

impl<AccountId: Clone, P: Clone + PerThing> Clone for Assignment<AccountId, P>

fn clone(&self) -> Assignment<AccountId, P>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<AccountId, P> Debug for Assignment<AccountId, P>where
    AccountId: Debug,
    P: Debug + PerThing,

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

Formats the value using the given formatter.

impl<AccountId, P: PerThing> Decode for Assignment<AccountId, P>where
    AccountId: Decode,
    Vec<(AccountId, P)>: Decode,

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

Attempt to deserialise the value from input.

fn decode_into<I>(
    input: &mut I,
    dst: &mut MaybeUninit<Self>
) -> Result<DecodeFinished, Error>where
    I: Input,

Attempt to deserialize the value from input into a pre-allocated piece of memory.

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<AccountId: Default, P: Default + PerThing> Default for Assignment<AccountId, P>

fn default() -> Assignment<AccountId, P>

Returns the “default value” for a type.

impl<AccountId, P: PerThing> Encode for Assignment<AccountId, P>where
    AccountId: Encode,
    Vec<(AccountId, P)>: Encode,

fn size_hint(&self) -> usize

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

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

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

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

Convert self to an owned vector.

fn using_encoded<R, F>(&self, f: F) -> Rwhere
    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<AccountId: PartialEq, P: PartialEq + PerThing> PartialEq<Assignment<AccountId, P>> for Assignment<AccountId, P>

fn eq(&self, other: &Assignment<AccountId, P>) -> 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 !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<AccountId, P: PerThing> EncodeLike<Assignment<AccountId, P>> for Assignment<AccountId, P>where
    AccountId: Encode,
    Vec<(AccountId, P)>: Encode,

impl<AccountId: Eq, P: Eq + PerThing> Eq for Assignment<AccountId, P>

impl<AccountId, P: PerThing> StructuralEq for Assignment<AccountId, P>

impl<AccountId, P: PerThing> StructuralPartialEq for Assignment<AccountId, P>