Struct PreparedBlock

pub struct PreparedBlock {
    pub block: Block,
    pub height: u32,
    pub input_utxos: HashMap<OutPoint, Coin>,
    pub in_block_outputs: HashMap<OutPoint, InBlockOutput>,
    pub execution_levels: TxExecutionLevels,
}

A block with pre-fetched UTXOs ready for verification.

This structure enables efficient verification by:

1. Pre-fetching all required UTXOs in a single batch
2. Tracking in-block outputs for same-block spending
3. Providing execution levels for parallel verification

Fields

block: Block

The Bitcoin block.

height: u32

Block height.

input_utxos: HashMap<OutPoint, Coin>

Pre-fetched UTXOs for inputs spending external outputs. Key: OutPoint being spent Value: The Coin (UTXO) data

in_block_outputs: HashMap<OutPoint, InBlockOutput>

Outputs created within this block (for in-block spending).

execution_levels: TxExecutionLevels

Transaction execution levels for intra-block parallelism.

Implementations

impl PreparedBlock

pub fn prepare<P: UtxoProvider>( block: Block, height: u32, utxo_provider: &P, ) -> Self

Prepare a block for verification by pre-fetching required UTXOs.

This method:

1. Scans the block to identify all required outpoints
2. Separates external UTXOs from in-block outputs
3. Batch-fetches external UTXOs from the provider
4. Builds execution levels for parallel verification

pub fn get_utxo(&self, outpoint: &OutPoint) -> Option<(TxOut, bool, u32)>

Get a UTXO needed for verification.

Checks in-block outputs first, then pre-fetched external UTXOs. Returns (TxOut, is_coinbase, coin_height).

pub fn missing_utxos(&self) -> Vec<OutPoint>

Check if all required external UTXOs were found.

Returns a list of missing outpoints if any are missing.

pub fn tx_count(&self) -> usize

Returns the number of transactions in the block.

pub fn block_hash(&self) -> BlockHash

Returns the block hash.

pub fn into_verified( self, script_verification_duration: Duration, ) -> VerifiedBlock

Convert to a VerifiedBlock after successful verification.

This transfers ownership of the pre-fetched UTXOs to the VerifiedBlock, allowing apply_verified_block to use them without re-fetching.

Trait Implementations

impl Debug for PreparedBlock

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

Formats the value using the given formatter.