Struct DigestInfo

pub struct DigestInfo<T: Config<I>, I: 'static = ()>(BoundedVec<LazyBalanceOf<T, I>, VariantCountOf<T::Position>>);

Stores balance information for each variant of a digest.

A digest may have multiple semantic variants (e.g. Affirmative, Contrary, etc), each maintaining its own balance. This structure tracks the corresponding LazyBalanceOf for every variant.

Internally, it is backed by a [BoundedVec] whose length is fixed to the number of semantic variants defined by Config::Position via the VariantCount bound. This guarantees a single, stable slot per variant.

In some scenarios, a higher-indexed variant may be initialized before its preceding variants. In such cases, the earlier slots are filled with a default lazy balance to preserve positional invariants. While eagerly initializing all slots would also be invariant-safe, it could increase storage usage when many digests exist or when commitments do not utilize all variants.

To keep storage usage minimal, it is expected that the default variant ([Default] for Config::Position) occupies index 0, as defined by PositionIndex.

Tuple Fields

0: BoundedVec<LazyBalanceOf<T, I>, VariantCountOf<T::Position>>

Implementations

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

pub fn balances( &self, ) -> Result<Vec<(T::Position, LazyBalanceOf<T, I>)>, DispatchError>

Returns the actively funded lazy balances of commitment digests along with their corresponding semantic positions (commit variants).

Returns DispatchError if lookup or decoding fails.

pub(crate) fn mut_balance( &mut self, variant: &T::Position, ) -> Option<&mut LazyBalanceOf<T, I>>

pub fn get_balance(&self, variant: &T::Position) -> Option<&LazyBalanceOf<T, I>>

pub fn reveal( &self, ) -> BoundedVec<LazyBalanceOf<T, I>, VariantCountOf<T::Position>>

pub(crate) fn init_balance( &mut self, variant: &T::Position, ) -> Result<(), DispatchError>

Trait Implementations

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

where T::Position: Clone,

fn clone(&self) -> DigestInfo<T, I>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T, I> Debug for DigestInfo<T, I>

where T: Debug + Config<I>, I: Debug + 'static,

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

Formats the value using the given formatter.

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

where BoundedVec<LazyBalanceOf<T, I>, VariantCountOf<T::Position>>: 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<T: Config<I>, I: 'static> Default for DigestInfo<T, I>

fn default() -> Self

Creates an empty DigestInfo with no variant balances. Variant slots are initialized lazily and filled safely on demand.

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

where BoundedVec<LazyBalanceOf<T, I>, VariantCountOf<T::Position>>: 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>

Convert self to an owned vector.

fn using_encoded<__CodecOutputReturn, __CodecUsingEncodedCallback: FnOnce(&[u8]) -> __CodecOutputReturn>( &self, f: __CodecUsingEncodedCallback, ) -> __CodecOutputReturn

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> MaxEncodedLen for DigestInfo<T, I>

where BoundedVec<LazyBalanceOf<T, I>, VariantCountOf<T::Position>>: MaxEncodedLen,

fn max_encoded_len() -> usize

Upper bound, in bytes, of the maximum encoded size of this item.

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

where T::Position: PartialEq,

fn eq(&self, other: &DigestInfo<T, I>) -> bool

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<T, I> TypeInfo for DigestInfo<T, I>

where BoundedVec<LazyBalanceOf<T, I>, VariantCountOf<T::Position>>: TypeInfo + 'static, T: Config<I> + 'static, I: 'static,

type Identity = DigestInfo<T, I>

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> DecodeWithMemTracking for DigestInfo<T, I>

where BoundedVec<LazyBalanceOf<T, I>, VariantCountOf<T::Position>>: DecodeWithMemTracking,

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

where BoundedVec<LazyBalanceOf<T, I>, VariantCountOf<T::Position>>: Encode,

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

where T::Position: Eq,

impl<T: Config<I>, I: 'static> StructuralPartialEq for DigestInfo<T, I>