Struct Block

pub struct Block {
    pub header: Header,
    pub txdata: Vec<Transaction>,
}

Bitcoin block.

A collection of transactions with an attached proof of work.

See Bitcoin Wiki: Block for more information.

Bitcoin Core References

• CBlock definition

Fields

header: Header

The block header

txdata: Vec<Transaction>

List of transactions contained in the block

Implementations

impl Block

pub fn block_hash(&self) -> BlockHash

Returns the block hash.

pub fn check_merkle_root(&self) -> bool

Checks if merkle root of header matches merkle root of the transaction list.

pub fn check_witness_commitment(&self) -> bool

Checks if witness commitment in coinbase matches the transaction list.

pub fn compute_merkle_root(&self) -> Option<TxMerkleNode>

Computes the transaction merkle root.

pub fn compute_witness_commitment( witness_root: &WitnessMerkleNode, witness_reserved_value: &[u8], ) -> WitnessCommitment

Computes the witness commitment for the block’s transaction list.

pub fn witness_root(&self) -> Option<WitnessMerkleNode>

Computes the merkle root of transactions hashed for witness.

pub fn weight(&self) -> Weight

Returns the weight of the block.

Block weight is defined as Base size * 3 + Total size.

pub fn total_size(&self) -> usize

Returns the total block size.

Total size is the block size in bytes with transactions serialized as described in BIP144, including base data and witness data.

pub fn coinbase(&self) -> Option<&Transaction>

Returns the coinbase transaction, if one is present.

pub fn bip34_block_height(&self) -> Result<u64, Bip34Error>

Returns the block height, as encoded in the coinbase transaction according to BIP34.

Trait Implementations

impl Clone for Block

fn clone(&self) -> Block

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Block

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

Formats the value using the given formatter.

impl Decodable for Block

fn consensus_decode_from_finite_reader<R>(r: &mut R) -> Result<Block, Error>

where R: Read + ?Sized,

Decode Self from a size-limited reader.

fn consensus_decode<R>(r: &mut R) -> Result<Block, Error>

where R: Read + ?Sized,

Decode an object with a well-defined format.

impl<'de> Deserialize<'de> for Block

fn deserialize<__D>( __deserializer: __D, ) -> Result<Block, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Encodable for Block

fn consensus_encode<R>(&self, r: &mut R) -> Result<usize, Error>

where R: Write + ?Sized,

Encodes an object with a well-defined format.

impl From<&Block> for BlockHash

fn from(block: &Block) -> BlockHash

Converts to this type from the input type.

impl From<Block> for BlockHash

fn from(block: Block) -> BlockHash

Converts to this type from the input type.

impl PartialEq for Block

fn eq(&self, other: &Block) -> 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<C> Queryable<C> for Block

where C: RpcApi,

type Id = BlockHash

Type of the ID used to query the item.

fn query(rpc: &C, id: &<Block as Queryable<C>>::Id) -> Result<Block, Error>

Query the item using rpc and convert to Self.

impl Serialize for Block

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for Block

impl StructuralPartialEq for Block