Struct zebra_state::SemanticallyVerifiedBlock

pub struct SemanticallyVerifiedBlock {
    pub block: Arc<Block>,
    pub hash: Hash,
    pub height: Height,
    pub new_outputs: HashMap<OutPoint, OrderedUtxo>,
    pub transaction_hashes: Arc<[Hash]>,
    pub deferred_balance: Option<Amount<NonNegative>>,
}

A block which has undergone semantic validation and has been prepared for contextual validation.

It is the constructor’s responsibility to perform semantic validation and to ensure that all fields are consistent.

This structure contains data from contextual validation, which is computed in the service caller’s task, not inside the service call itself. This allows moving work out of the single-threaded state service.

Fields

block: Arc<Block>

The block to commit to the state.

hash: Hash

The hash of the block.

height: Height

The height of the block.

new_outputs: HashMap<OutPoint, OrderedUtxo>

New transparent outputs created in this block, indexed by OutPoint.

Each output is tagged with its transaction index in the block. (The outputs of earlier transactions in a block can be spent by later transactions.)

Note: although these transparent outputs are newly created, they may not be unspent, since a later transaction in a block can spend outputs of an earlier transaction.

This field can also contain unrelated outputs, which are ignored.

transaction_hashes: Arc<[Hash]>

A precomputed list of the hashes of the transactions in this block, in the same order as block.transactions.

deferred_balance: Option<Amount<NonNegative>>

This block’s contribution to the deferred pool.

Implementations

impl SemanticallyVerifiedBlock

pub fn with_hash(block: Arc<Block>, hash: Hash) -> Self

Creates SemanticallyVerifiedBlock from Block and block::Hash.

pub fn with_deferred_balance( self, deferred_balance: Option<Amount<NonNegative>>, ) -> Self

Sets the deferred balance in the block.

Trait Implementations

impl Clone for SemanticallyVerifiedBlock

fn clone(&self) -> SemanticallyVerifiedBlock

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for SemanticallyVerifiedBlock

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

Formats the value using the given formatter.

impl From<&SemanticallyVerifiedBlock> for SemanticallyVerifiedBlock

fn from(semantically_verified: &SemanticallyVerifiedBlock) -> Self

Converts to this type from the input type.

impl From<Arc<Block>> for SemanticallyVerifiedBlock

fn from(block: Arc<Block>) -> Self

Converts to this type from the input type.

impl From<CheckpointVerifiedBlock> for SemanticallyVerifiedBlock

fn from(checkpoint_verified: CheckpointVerifiedBlock) -> Self

Converts to this type from the input type.

impl From<ContextuallyVerifiedBlock> for SemanticallyVerifiedBlock

fn from(valid: ContextuallyVerifiedBlock) -> Self

Converts to this type from the input type.

impl From<FinalizedBlock> for SemanticallyVerifiedBlock

fn from(finalized: FinalizedBlock) -> Self

Converts to this type from the input type.

impl From<SemanticallyVerifiedBlock> for ChainTipBlock

fn from(prepared: SemanticallyVerifiedBlock) -> Self

Converts to this type from the input type.

impl PartialEq for SemanticallyVerifiedBlock

fn eq(&self, other: &SemanticallyVerifiedBlock) -> 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 Eq for SemanticallyVerifiedBlock

impl StructuralPartialEq for SemanticallyVerifiedBlock