Enum polkadot_service::generic::DigestItemRef

pub enum DigestItemRef<'a> {
    PreRuntime(&'a [u8; 4], &'a [u8]),
    Consensus(&'a [u8; 4], &'a [u8]),
    Seal(&'a [u8; 4], &'a [u8]),
    Other(&'a [u8]),
    RuntimeEnvironmentUpdated,
}

A ‘referencing view’ for digest item. Does not own its contents. Used by final runtime implementations for encoding/decoding its log items.

Variants

PreRuntime(&'a [u8; 4], &'a [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.

Consensus(&'a [u8; 4], &'a [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(&'a [u8; 4], &'a [u8])

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

Other(&'a [u8])

Any ‘non-system’ digest item, opaque to the native code.

RuntimeEnvironmentUpdated

Runtime code or heap pages updated.

Implementations

impl<'a> DigestItemRef<'a>

pub fn as_pre_runtime(&self) -> Option<([u8; 4], &'a [u8])>

Cast this digest item into PreRuntime

pub fn as_consensus(&self) -> Option<([u8; 4], &'a [u8])>

Cast this digest item into Consensus

pub fn as_seal(&self) -> Option<([u8; 4], &'a [u8])>

Cast this digest item into Seal

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

Cast this digest item into PreRuntime

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

Try to match this digest item to the given opaque item identifier; if it matches, then return the opaque data it contains.

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

where T: Decode,

Try to match this digest item to the given opaque item identifier; if it matches, then try to cast to the given data type; if that works, return it.

pub fn seal_try_to<T>(&self, id: &[u8; 4]) -> Option<T>

where T: Decode,

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>(&self, id: &[u8; 4]) -> Option<T>

where T: Decode,

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>(&self, id: &[u8; 4]) -> Option<T>

where T: Decode,

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<'a> Clone for DigestItemRef<'a>

fn clone(&self) -> DigestItemRef<'a>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for DigestItemRef<'a>

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

Formats the value using the given formatter.

impl<'a> Encode for DigestItemRef<'a>

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.

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.

impl<'a> PartialEq for DigestItemRef<'a>

fn eq(&self, other: &DigestItemRef<'a>) -> 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<'a> EncodeLike for DigestItemRef<'a>

impl<'a> Eq for DigestItemRef<'a>

impl<'a> StructuralPartialEq for DigestItemRef<'a>