Struct sp_core::ChangesTrieConfiguration

pub struct ChangesTrieConfiguration {
    pub digest_interval: u32,
    pub digest_levels: u32,
}

Substrate changes trie configuration.

Fields

digest_interval: u32

Interval (in blocks) at which level1-digests are created. Digests are not created when this is less or equal to 1.

digest_levels: u32

Maximal number of digest levels in hierarchy. 0 means that digests are not created at all (even level1 digests). 1 means only level1-digests are created. 2 means that every digest_interval^2 there will be a level2-digest, and so on. Please ensure that maximum digest interval (i.e. digest_interval^digest_levels) is within u32 limits. Otherwise you’ll never see digests covering such intervals && maximal digests interval will be truncated to the last interval that fits u32 limits.

Implementations

impl ChangesTrieConfiguration

pub fn new(digest_interval: u32, digest_levels: u32) -> Self

Create new configuration given digest interval and levels.

pub fn is_digest_build_enabled(&self) -> bool

Is digest build enabled?

pub fn is_digest_build_required_at_block<Number>(
    &self,
    zero: Number,
    block: Number
) -> bool where
    Number: From<u32> + PartialEq + Rem<Output = Number> + Sub<Output = Number> + PartialOrd + Zero, 

Do we need to build digest at given block?

pub fn max_digest_interval(&self) -> u32

Returns max digest interval. One if digests are not created at all.

pub fn prev_max_level_digest_block<Number>(
    &self,
    zero: Number,
    block: Number
) -> Option<Number> where
    Number: Clone + From<u32> + PartialOrd + PartialEq + Add<Output = Number> + Sub<Output = Number> + Div<Output = Number> + Mul<Output = Number> + Zero, 

Returns max level digest block number that has been created at block <= passed block number.

Returns None if digests are not created at all.

pub fn next_max_level_digest_range<Number>(
    &self,
    zero: Number,
    block: Number
) -> Option<(Number, Number)> where
    Number: Clone + From<u32> + PartialOrd + PartialEq + Add<Output = Number> + Sub<Output = Number> + Div<Output = Number> + Mul<Output = Number>, 

Returns max level digest blocks range (inclusive) which includes passed block.

Returns None if digests are not created at all. It will return the first max-level digest if block is <= zero.

pub fn digest_level_at_block<Number>(
    &self,
    zero: Number,
    block: Number
) -> Option<(u32, u32, u32)> where
    Number: Clone + From<u32> + PartialEq + Rem<Output = Number> + Sub<Output = Number> + PartialOrd + Zero, 

Returns Some if digest must be built at given block number. The tuple is: ( digest level digest interval (in blocks) step between blocks we’re interested in when digest is built )

Trait Implementations

impl Clone for ChangesTrieConfiguration

fn clone(&self) -> ChangesTrieConfiguration

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for ChangesTrieConfiguration

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

Formats the value using the given formatter.

impl Decode for ChangesTrieConfiguration

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 Default for ChangesTrieConfiguration

fn default() -> ChangesTrieConfiguration

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ChangesTrieConfiguration

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error> where
    __D: Deserializer<'de>, 

Deserialize this value from the given Serde deserializer.

impl Encode for ChangesTrieConfiguration

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 MallocSizeOf for ChangesTrieConfiguration

fn size_of(&self, ops: &mut MallocSizeOfOps) -> usize

Measure the heap usage of all descendant heap-allocated structures, but not the space taken up by the value itself. If T::size_of is a constant, consider implementing constant_size as well.

fn constant_size() -> Option<usize>

Used to optimize MallocSizeOf implementation for collections like Vec and HashMap to avoid iterating over them unnecessarily. The Self: Sized bound is for object safety.

impl PartialEq<ChangesTrieConfiguration> for ChangesTrieConfiguration

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

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

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

This method tests for !=.

impl Serialize for ChangesTrieConfiguration

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error> where
    __S: Serializer, 

Serialize this value into the given Serde serializer.

impl EncodeLike<ChangesTrieConfiguration> for ChangesTrieConfiguration

impl Eq for ChangesTrieConfiguration

impl StructuralEq for ChangesTrieConfiguration

impl StructuralPartialEq for ChangesTrieConfiguration