Struct Block

pub struct Block<V = Unchecked>
where
    V: Validation,
{ /* private fields */ }

Available on crate feature alloc only.

Bitcoin block.

A collection of transactions with an attached proof of work.

See Bitcoin Wiki: Block for more information.

Bitcoin Core References

• CBlock definition

Implementations

impl Block<Unchecked>

pub fn new_unchecked( header: Header, transactions: Vec<Transaction>, ) -> Block<Unchecked>

Constructs a new Block without doing any validation.

pub fn assume_checked( self, witness_root: Option<WitnessMerkleNode>, ) -> Block<Checked>

Ignores block validation logic and just assumes you know what you are doing.

You should only use this function if you trust the block i.e., it comes from a trusted node.

pub fn into_parts(self) -> (Header, Vec<Transaction>)

Decomposes block into its constituent parts.

impl Block<Checked>

pub fn header(&self) -> &Header

Gets a reference to the block header.

pub fn transactions(&self) -> &[Transaction]

Gets a reference to the block’s list of transactions.

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

Returns the cached witness root if one is present.

It is assumed that a block will have the witness root calculated and cached as part of the validation process.

impl<V: Validation> Block<V>

pub fn block_hash(&self) -> BlockHash

Returns the block hash.

Trait Implementations

impl<'a> Arbitrary<'a> for Block

Available on crate feature arbitrary only.

fn arbitrary(u: &mut Unstructured<'a>) -> Result<Self>

Generate an arbitrary value of Self from the given unstructured data.

fn arbitrary_take_rest(u: Unstructured<'a>) -> Result<Self, Error>

Generate an arbitrary value of Self from the entirety of the given unstructured data.

fn size_hint(depth: usize) -> (usize, Option<usize>)

Get a size hint for how many bytes out of an Unstructured this type needs to construct itself.

fn try_size_hint( depth: usize, ) -> Result<(usize, Option<usize>), MaxRecursionReached>

Get a size hint for how many bytes out of an Unstructured this type needs to construct itself.

impl<V> Clone for Block<V>

where V: Validation + Clone,

fn clone(&self) -> Block<V>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<V> Debug for Block<V>

where V: Validation + Debug,

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

Formats the value using the given formatter.

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

where V: Validation,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

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<V> PartialEq for Block<V>

where V: Validation + PartialEq,

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

where V: Validation,

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl<V> Eq for Block<V>

where V: Validation + Eq,

impl<V> StructuralPartialEq for Block<V>

where V: Validation,