Struct bitcoin::blockdata::block::BlockHeader

pub struct BlockHeader {
    pub version: u32,
    pub prev_blockhash: Sha256dHash,
    pub merkle_root: Sha256dHash,
    pub time: u32,
    pub bits: u32,
    pub nonce: u32,
    pub coinbase_txn: Transaction,
    pub block_hash: Sha256dHash,
    pub coinbase_branch_hashes: Vec<Sha256dHash>,
    pub coinbase_branch_side_mask: u32,
    pub blockchain_branch_hashes: Vec<Sha256dHash>,
    pub blockchain_branch_side_mask: u32,
    pub parent_version: u32,
    pub parent_prev_blockhash: Sha256dHash,
    pub parent_merkle_root: Sha256dHash,
    pub parent_time: u32,
    pub parent_bits: u32,
    pub parent_nonce: u32,
}

A block header, which contains all the block's information except the actual transactions

Fields

version: u32

The protocol version. Should always be 1.

prev_blockhash: Sha256dHash

Reference to the previous block in the chain

merkle_root: Sha256dHash

The root hash of the merkle tree of transactions in the block

time: u32

The timestamp of the block, as claimed by the miner

bits: u32

The target value below which the blockhash must lie, encoded as a a float (with well-defined rounding, of course)

nonce: u32

The nonce, selected to obtain a low enough blockhash

coinbase_txn: Transaction

Coinbase transaction that is in the parent block, linking the AuxPOW block to its parent block

block_hash: Sha256dHash

Hash of the parent_block header

coinbase_branch_hashes: Vec<Sha256dHash>

The merkle branch linking the coinbase_txn to the parent block's merkle_root

coinbase_branch_side_mask: u32

Bitmask of which side of the merkle hash function the branch_hash element should go on. Zero means it goes on the right, One means on the left. It is equal to the index of the starting hash within the widest level of the merkle tree for this merkle branch.

blockchain_branch_hashes: Vec<Sha256dHash>

The merkle branch linking this auxiliary blockchain to the others, when used in a merged mining setup with multiple auxiliary chains

blockchain_branch_side_mask: u32

Bitmask of which side of the merkle hash function the branch_hash element should go on. Zero means it goes on the right, One means on the left. It is equal to the index of the starting hash within the widest level of the merkle tree for this merkle branch.

parent_version: u32

Parent block header The protocol version. Should always be 1.

parent_prev_blockhash: Sha256dHash

Reference to the previous block in the chain

parent_merkle_root: Sha256dHash

The root hash of the merkle tree of transactions in the block

parent_time: u32

The timestamp of the block, as claimed by the miner

parent_bits: u32

The target value below which the blockhash must lie, encoded as a a float (with well-defined rounding, of course)

parent_nonce: u32

The nonce, selected to obtain a low enough blockhash

Methods

impl BlockHeader

pub fn target(&self) -> Uint256

Computes the target [0, T] that a blockhash must land in to be valid

pub fn compact_target_from_u256(value: &Uint256) -> u32

Computes the target value in float format from Uint256 format.

pub fn difficulty(&self, network: Network) -> u64

Compute the popular "difficulty" measure for mining

pub fn spv_validate(&self, required_target: &Uint256) -> Result<(), Error>

Performs an SPV validation of a block, which confirms that the proof-of-work is correct, but does not verify that the transactions are valid or encoded correctly.

pub fn work(&self) -> Uint256

Returns the total work of the block

Trait Implementations

impl BitcoinHash for BlockHeader

fn bitcoin_hash(&self) -> Sha256dHash

Produces a Sha256dHash which can be used to refer to the object

impl<S: Encoder> Encodable<S> for BlockHeader

fn consensus_encode(&self, s: &mut S) -> Result<(), Error>

Encode an object with a well-defined format, should only ever error if the underlying Encoder errors.

impl<D: Decoder> Decodable<D> for BlockHeader

fn consensus_decode(d: &mut D) -> Result<BlockHeader, Error>

Decode an object with a well-defined format

impl Eq for BlockHeader

impl Clone for BlockHeader

fn clone(&self) -> BlockHeader

Returns a copy of the value.

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

Performs copy-assignment from source.

impl PartialEq<BlockHeader> for BlockHeader

fn eq(&self, other: &BlockHeader) -> bool

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

fn ne(&self, other: &BlockHeader) -> bool

This method tests for !=.

impl<'_> From<&'_ BlockHeader> for BaseHeader

fn from(item: &BlockHeader) -> Self

Performs the conversion.

impl Debug for BlockHeader

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

Formats the value using the given formatter.