Struct blocks_iterator::BlockExtra

pub struct BlockExtra {
    pub version: u8,
    pub block: Block,
    pub block_hash: BlockHash,
    pub size: u32,
    pub next: Vec<BlockHash>,
    pub height: u32,
    pub outpoint_values: HashMap<OutPoint, TxOut>,
    pub block_total_inputs: u32,
    pub block_total_outputs: u32,
    pub txids: Vec<Txid>,
}

The bitcoin block and additional metadata returned by the crate::iter() method

Fields

version: u8

Serialization format version

block: Block

The bitcoin block

block_hash: BlockHash

The bitcoin block hash, same as block.block_hash() but result from hashing is cached

size: u32

The byte size of the block, as returned by in serialize(block).len()

next: Vec<BlockHash>

Hash of the blocks following this one, it’s a vec because during reordering they may be more than one because of reorgs, as a result from the iteration, it’s just one.

height: u32

The height of the current block, number of blocks between this one and the genesis block

outpoint_values: HashMap<OutPoint, TxOut>

All the previous outputs of this block. Allowing to validate the script or computing the fee Note that when configuration skip_script_pubkey is true, the script is empty, when skip_prevout is true, this map is empty.

block_total_inputs: u32

Total number of transaction inputs in this block

block_total_outputs: u32

Total number of transaction outputs in this block

txids: Vec<Txid>

Precomputed transaction hashes such that txids[i]=block.txdata[i].txid()

Implementations

impl BlockExtra

pub fn average_fee(&self) -> Option<f64>

Returns the average transaction fee in the block

pub fn fee(&self) -> Option<u64>

Returns the total fee of the block

pub fn tx_fee(&self, tx: &Transaction) -> Option<u64>

Returns the fee of a transaction contained in the block

pub fn base_reward(&self) -> u64

Return the base block reward in satoshi

pub fn iter_tx(&self) -> impl Iterator<Item = (&Txid, &Transaction)>

Iterate transactions of blocks together with their txids

Trait Implementations

impl Debug for BlockExtra

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

Formats the value using the given formatter.

impl Decodable for BlockExtra

fn consensus_decode<D: Read + ?Sized>(d: &mut D) -> Result<Self, Error>

Decode an object with a well-defined format.

fn consensus_decode_from_finite_reader<R>(reader: &mut R) -> Result<Self, Error>where R: Read + ?Sized,

Decode Self from a size-limited reader.

impl Encodable for BlockExtra

fn consensus_encode<W: Write + ?Sized>( &self, writer: &mut W ) -> Result<usize, Error>

Encodes an object with a well-defined format.

impl PartialEq<BlockExtra> for BlockExtra

fn eq(&self, other: &BlockExtra) -> 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 TryFrom<FsBlock> for BlockExtra

type Error = String

The type returned in the event of a conversion error.

fn try_from(fs_block: FsBlock) -> Result<Self, Self::Error>

Performs the conversion.

impl Eq for BlockExtra

impl StructuralEq for BlockExtra

impl StructuralPartialEq for BlockExtra