Struct Header

pub struct Header<N: Network> { /* private fields */ }

The header for the block contains metadata that uniquely identifies the block.

Implementations

impl<N: Network> Header<N>

pub fn genesis( ratifications: &Ratifications<N>, transactions: &Transactions<N>, ratified_finalize_operations: Vec<FinalizeOperation<N>>, ) -> Result<Self>

Initializes the genesis block header.

pub fn is_genesis(&self) -> bool

Returns true if the block header is a genesis block header.

impl<N: Network> Header<N>

pub fn to_root(&self) -> Result<Field<N>>

Returns the block header root.

pub fn to_path(&self, leaf: &HeaderLeaf<N>) -> Result<HeaderPath<N>>

Returns the Merkle path for the Merkle tree of the block header.

pub fn to_leaf(&self, id: &Field<N>) -> Result<HeaderLeaf<N>>

Returns the Merkle leaf for the given ID in the header.

pub fn to_tree(&self) -> Result<HeaderTree<N>>

Returns an instance of the Merkle tree for the block header.

impl<N: Network> Header<N>

pub fn verify( &self, expected_previous_state_root: N::StateRoot, expected_transactions_root: Field<N>, expected_finalize_root: Field<N>, expected_ratifications_root: Field<N>, expected_solutions_root: Field<N>, expected_subdag_root: Field<N>, expected_round: u64, expected_height: u32, expected_cumulative_weight: u128, expected_cumulative_proof_target: u128, expected_coinbase_target: u64, expected_proof_target: u64, expected_last_coinbase_target: u64, expected_last_coinbase_timestamp: i64, expected_timestamp: i64, current_timestamp: i64, ) -> Result<()>

Ensures the block header is correct.

impl<N: Network> Header<N>

pub fn from( previous_state_root: N::StateRoot, transactions_root: Field<N>, finalize_root: Field<N>, ratifications_root: Field<N>, solutions_root: Field<N>, subdag_root: Field<N>, metadata: Metadata<N>, ) -> Result<Self>

Initializes a new block header with the given inputs.

pub fn is_valid(&self) -> bool

Returns true if the block header is well-formed.

pub const fn previous_state_root(&self) -> N::StateRoot

Returns the previous state root from the block header.

pub const fn transactions_root(&self) -> Field<N>

Returns the transactions root in the block header.

pub const fn finalize_root(&self) -> Field<N>

Returns the finalize root in the block header.

pub const fn ratifications_root(&self) -> Field<N>

Returns the ratifications root in the block header.

pub const fn solutions_root(&self) -> Field<N>

Returns the solutions root in the block header.

pub const fn subdag_root(&self) -> Field<N>

Returns the subdag root in the block header.

pub const fn metadata(&self) -> &Metadata<N>

Returns the metadata in the block header.

pub const fn network(&self) -> u16

Returns the network ID of the block.

pub const fn round(&self) -> u64

Returns the round number of the block.

pub const fn height(&self) -> u32

Returns the height of the block.

pub const fn cumulative_weight(&self) -> u128

Returns the cumulative weight for this block.

pub const fn cumulative_proof_target(&self) -> u128

Returns the cumulative proof target for this block.

pub const fn coinbase_target(&self) -> u64

Returns the coinbase target for this block.

pub const fn proof_target(&self) -> u64

Returns the proof target for this block.

pub const fn last_coinbase_target(&self) -> u64

Returns the coinbase target of the last coinbase.

pub const fn last_coinbase_timestamp(&self) -> i64

Returns the Unix timestamp (UTC) of the last coinbase.

pub const fn timestamp(&self) -> i64

Returns the Unix timestamp (UTC) for this block.

Trait Implementations

impl<N: Clone + Network> Clone for Header<N>

where N::StateRoot: Clone,

fn clone(&self) -> Header<N>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<N: Network> Debug for Header<N>

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

Prints the header as a JSON-string.

impl<'de, N: Network> Deserialize<'de> for Header<N>

fn deserialize<D: Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error>

Deserializes the header from a JSON-string or buffer.

impl<N: Network> Display for Header<N>

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

Displays the header as a JSON-string.

impl<N: Network> FromBytes for Header<N>

fn read_le<R: Read>(reader: R) -> IoResult<Self>

Reads the block header from the buffer.

fn from_bytes_le(bytes: &[u8]) -> Result<Self, Error>

where Self: Sized,

Returns Self from a byte array in little-endian order.

impl<N: Network> FromStr for Header<N>

fn from_str(header: &str) -> Result<Self, Self::Err>

Initializes the header from a JSON-string.

type Err = Error

The associated error which can be returned from parsing.

impl<N: Hash + Network> Hash for Header<N>

where N::StateRoot: Hash,

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<N: PartialEq + Network> PartialEq for Header<N>

where N::StateRoot: PartialEq,

fn eq(&self, other: &Header<N>) -> 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<N: Network> Serialize for Header<N>

fn serialize<S: Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error>

Serializes the header to a JSON-string or buffer.

impl<N: Network> ToBytes for Header<N>

fn write_le<W: Write>(&self, writer: W) -> IoResult<()>

Writes the block header to the buffer.

fn to_bytes_le(&self) -> Result<Vec<u8>, Error>

where Self: Sized,

Returns self as a byte array in little-endian order.

impl<N: Copy + Network> Copy for Header<N>

where N::StateRoot: Copy,

impl<N: Eq + Network> Eq for Header<N>

where N::StateRoot: Eq,

impl<N: Network> StructuralPartialEq for Header<N>