Enum sp_runtime::DigestItem[−][src]

pub enum DigestItem<Hash> {
    ChangesTrieRoot(Hash),
    PreRuntime(ConsensusEngineId, Vec<u8>),
    Consensus(ConsensusEngineId, Vec<u8>),
    Seal(ConsensusEngineId, Vec<u8>),
    ChangesTrieSignal(ChangesTrieSignal),
    Other(Vec<u8>),
}

Expand description

Digest item that is able to encode/decode ‘system’ digest items and provide opaque access to other items.

Variants

ChangesTrieRoot(Hash)

System digest item that contains the root of changes trie at given block. It is created for every block iff runtime supports changes trie creation.

PreRuntime(ConsensusEngineId, Vec<u8>)

A pre-runtime digest.

These are messages from the consensus engine to the runtime, although the consensus engine can (and should) read them itself to avoid code and state duplication. It is erroneous for a runtime to produce these, but this is not (yet) checked.

NOTE: the runtime is not allowed to panic or fail in an on_initialize call if an expected PreRuntime digest is not present. It is the responsibility of a external block verifier to check this. Runtime API calls will initialize the block without pre-runtime digests, so initialization cannot fail when they are missing.

Consensus(ConsensusEngineId, Vec<u8>)

A message from the runtime to the consensus engine. This should never be generated by the native code of any consensus engine, but this is not checked (yet).

Seal(ConsensusEngineId, Vec<u8>)

Put a Seal on it. This is only used by native code, and is never seen by runtimes.

ChangesTrieSignal(ChangesTrieSignal)

Digest item that contains signal from changes tries manager to the native code.

Other(Vec<u8>)

Some other thing. Unsupported and experimental.

Implementations

impl<Hash> DigestItem<Hash>

pub fn dref(&self) -> DigestItemRef<'_, Hash>

Returns a ‘referencing view’ for this digest item.

pub fn as_changes_trie_root(&self) -> Option<&Hash>

Returns Some if the entry is the ChangesTrieRoot entry.

pub fn as_pre_runtime(&self) -> Option<(ConsensusEngineId, &[u8])>

Returns Some if this entry is the PreRuntime entry.

pub fn as_consensus(&self) -> Option<(ConsensusEngineId, &[u8])>

Returns Some if this entry is the Consensus entry.

pub fn as_seal(&self) -> Option<(ConsensusEngineId, &[u8])>

Returns Some if this entry is the Seal entry.

pub fn as_changes_trie_signal(&self) -> Option<&ChangesTrieSignal>

Returns Some if the entry is the ChangesTrieSignal entry.

pub fn as_other(&self) -> Option<&[u8]>

Returns Some if self is a DigestItem::Other.

pub fn try_as_raw(&self, id: OpaqueDigestItemId<'_>) -> Option<&[u8]>

Returns the opaque data contained in the item if Some if this entry has the id given.

pub fn try_to<T: Decode>(&self, id: OpaqueDigestItemId<'_>) -> Option<T>

Returns the data contained in the item if Some if this entry has the id given, decoded to the type provided T.

pub fn seal_try_to<T: Decode>(&self, id: &ConsensusEngineId) -> Option<T>

Try to match this to a Self::Seal, check id matches and decode it.

Returns None if this isn’t a seal item, the id doesn’t match or when the decoding fails.

pub fn consensus_try_to<T: Decode>(&self, id: &ConsensusEngineId) -> Option<T>

Try to match this to a Self::Consensus, check id matches and decode it.

Returns None if this isn’t a consensus item, the id doesn’t match or when the decoding fails.

pub fn pre_runtime_try_to<T: Decode>(&self, id: &ConsensusEngineId) -> Option<T>

Try to match this to a Self::PreRuntime, check id matches and decode it.

Returns None if this isn’t a pre-runtime item, the id doesn’t match or when the decoding fails.

Trait Implementations

impl<H: PartialEq + Eq + Debug> CheckEqual for DigestItem<H> where
    H: Encode,

fn check_equal(&self, other: &Self)

Perform the equality check.

impl<Hash: Clone> Clone for DigestItem<Hash>

fn clone(&self) -> DigestItem<Hash>

Returns a copy of the value. Read more

1.0.0[src]

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

Performs copy-assignment from source. Read more

impl<Hash> Debug for DigestItem<Hash> where
    Hash: Debug,

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

Formats the value using the given formatter. Read more

impl<Hash: Decode> Decode for DigestItem<Hash>

fn decode<I: Input>(input: &mut I) -> 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. Read more

fn encoded_fixed_size() -> Option<usize>

Returns the fixed encoded size of the type. Read more

impl<'a, Hash: Decode> Deserialize<'a> for DigestItem<Hash>

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

Deserialize this value from the given Serde deserializer. Read more

impl<Hash: Encode> Encode for DigestItem<Hash>

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

Convert self to an owned vector.

fn size_hint(&self) -> usize

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

fn encode_to<T>(&self, dest: &mut T) where
    T: Output + ?Sized,

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

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. Read more

impl<Hash> MallocSizeOf for DigestItem<Hash> where
    Hash: MallocSizeOf,

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. Read more

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. Read more

impl<Hash: PartialEq> PartialEq<DigestItem<Hash>> for DigestItem<Hash>

fn eq(&self, other: &DigestItem<Hash>) -> bool

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

fn ne(&self, other: &DigestItem<Hash>) -> bool

This method tests for !=.

impl<Hash: Encode> Serialize for DigestItem<Hash>

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

Serialize this value into the given Serde serializer. Read more

impl<Hash: Encode> EncodeLike<DigestItem<Hash>> for DigestItem<Hash>

impl<Hash: Eq> Eq for DigestItem<Hash>

impl<Hash> StructuralEq for DigestItem<Hash>

impl<Hash> StructuralPartialEq for DigestItem<Hash>

Auto Trait Implementations

impl<Hash> RefUnwindSafe for DigestItem<Hash> where
    Hash: RefUnwindSafe,

impl<Hash> Send for DigestItem<Hash> where
    Hash: Send,

impl<Hash> Sync for DigestItem<Hash> where
    Hash: Sync,

impl<Hash> Unpin for DigestItem<Hash> where
    Hash: Unpin,

impl<Hash> UnwindSafe for DigestItem<Hash> where
    Hash: UnwindSafe,

Blanket Implementations

impl<T> Any for T where
    T: 'static + ?Sized,

pub fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

impl<T> Borrow<T> for T where
    T: ?Sized,

pub fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

impl<T> BorrowMut<T> for T where
    T: ?Sized,

pub fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

impl<T> CheckedConversion for T

fn checked_from<T>(t: T) -> Option<Self> where
    Self: TryFrom<T>,

Convert from a value of T into an equivalent instance of Option<Self>. Read more

fn checked_into<T>(self) -> Option<T> where
    Self: TryInto<T>,

Consume self to return Some equivalent value of Option<T>. Read more

impl<T> DecodeAll for T where
    T: Decode,

pub fn decode_all(input: &[u8]) -> Result<T, Error>

Decode Self and consume all of the given input data. Read more

impl<T> DecodeLimit for T where
    T: Decode,

pub fn decode_all_with_depth_limit(limit: u32, input: &[u8]) -> Result<T, Error>

Decode Self and consume all of the given input data. Read more

pub fn decode_with_depth_limit(limit: u32, input: &[u8]) -> Result<T, Error>

Decode Self with the given maximum recursion depth. Read more

impl<T> Downcast for T where
    T: Any,

pub fn into_any(self: Box<T, Global>) -> Box<dyn Any + 'static, Global>ⓘNotable traits for Box<R, Global>
impl<R> Read for Box<R, Global> where
    R: Read + ?Sized, impl<W> Write for Box<W, Global> where
    W: Write + ?Sized, impl<F, A> Future for Box<F, A> where
    F: Future + Unpin + ?Sized,
    A: Allocator + 'static,     type Output = <F as Future>::Output;impl<I, A> Iterator for Box<I, A> where
    I: Iterator + ?Sized,
    A: Allocator,     type Item = <I as Iterator>::Item;

Convert Box<dyn Trait> (where Trait: Downcast) to Box<dyn Any>. Box<dyn Any> can then be further downcast into Box<ConcreteType> where ConcreteType implements Trait. Read more

pub fn into_any_rc(self: Rc<T>) -> Rc<dyn Any + 'static>

Convert Rc<Trait> (where Trait: Downcast) to Rc<Any>. Rc<Any> can then be further downcast into Rc<ConcreteType> where ConcreteType implements Trait. Read more

pub fn as_any(&self) -> &(dyn Any + 'static)

Convert &Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot generate &Any’s vtable from &Trait’s. Read more

pub fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)

Convert &mut Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot generate &mut Any’s vtable from &mut Trait’s. Read more

impl<T> DowncastSync for T where
    T: Any + Send + Sync,

pub fn into_any_arc(self: Arc<T>) -> Arc<dyn Any + Sync + Send + 'static>

Convert Arc<Trait> (where Trait: Downcast) to Arc<Any>. Arc<Any> can then be further downcast into Arc<ConcreteType> where ConcreteType implements Trait. Read more

impl<T> DynClone for T where
    T: Clone,

pub fn __clone_box(&self, Private) -> *mut ()

impl<T> From<T> for T

pub fn from(t: T) -> T

Performs the conversion.

impl<T> Instrument for T

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more

impl<T, U> Into<U> for T where
    U: From<T>,

pub fn into(self) -> U

Performs the conversion.

impl<T, Outer> IsWrappedBy<Outer> for T where
    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> KeyedVec for T where
    T: Codec,

pub fn to_keyed_vec(&self, prepend_key: &[u8]) -> Vec<u8, Global>

Return an encoding of Self prepended by given slice.

impl<T> MallocSizeOfExt for T where
    T: MallocSizeOf,

fn malloc_size_of(&self) -> usize

Method to launch a heapsize measurement with a fresh state. Read more

impl<T> Same<T> for T

type Output = T

Should always be Self

impl<T> SaturatedConversion for T

fn saturated_from<T>(t: T) -> Self where
    Self: UniqueSaturatedFrom<T>,

Convert from a value of T into an equivalent instance of Self. Read more

fn saturated_into<T>(self) -> T where
    Self: UniqueSaturatedInto<T>,

Consume self to return an equivalent value of T. Read more

impl<T> ToOwned for T where
    T: Clone,

type Owned = T

The resulting type after obtaining ownership.

pub fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more

pub fn clone_into(&self, target: &mut T)

🔬 This is a nightly-only experimental API. (toowned_clone_into)

recently added

Uses borrowed data to replace owned data, usually by cloning. Read more

impl<T, U> TryFrom<U> for T where
    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>

Performs the conversion.

impl<T, U> TryInto<U> for T where
    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>

Performs the conversion.

impl<S, T> UncheckedInto<T> for S where
    T: UncheckedFrom<S>,

pub fn unchecked_into(self) -> T

The counterpart to unchecked_from.

impl<T, S> UniqueSaturatedInto<T> for S where
    T: Bounded,
    S: TryInto<T>,

pub fn unique_saturated_into(self) -> T

Consume self to return an equivalent value of T.

impl<V, T> VZip<V> for T where
    V: MultiLane<T>,

pub fn vzip(self) -> V

impl<S> Codec for S where
    S: Decode + Encode,

impl<T> DeserializeOwned for T where
    T: for<'de> Deserialize<'de>,

impl<'_, '_, T> EncodeLike<&'_ &'_ T> for T where
    T: Encode,

impl<'_, T> EncodeLike<&'_ T> for T where
    T: Encode,

impl<'_, T> EncodeLike<&'_ mut T> for T where
    T: Encode,

impl<T> EncodeLike<Arc<T>> for T where
    T: Encode,

impl<T> EncodeLike<Box<T, Global>> for T where
    T: Encode,

impl<'a, T> EncodeLike<Cow<'a, T>> for T where
    T: ToOwned + Encode,

impl<T> EncodeLike<Rc<T>> for T where
    T: Encode,

impl<S> FullCodec for S where
    S: Decode + FullEncode,

impl<S> FullEncode for S where
    S: Encode + EncodeLike<S>,

impl<T> MaybeDebug for T where
    T: Debug,

impl<T> MaybeDebug for T where
    T: Debug,

impl<T> MaybeMallocSizeOf for T where
    T: MallocSizeOf,

impl<T> MaybeRefUnwindSafe for T where
    T: RefUnwindSafe,

impl<T> MaybeSerialize for T where
    T: Serialize,

impl<T> MaybeSerializeDeserialize for T where
    T: DeserializeOwned + Serialize,

impl<T> Member for T where
    T: 'static + Send + Sync + Debug + Eq + PartialEq<T> + Clone,