Struct Metadata

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

Implementations

impl<N: Network> Metadata<N>

pub fn genesis() -> Result<Self>

Initializes the genesis metadata.

pub fn is_genesis(&self) -> bool

Returns true if the metadata is a genesis metadata.

impl<N: Network> Metadata<N>

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

Returns the metadata hash.

impl<N: Network> Metadata<N>

pub fn verify( &self, 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 metadata is correct.

impl<N: Network> Metadata<N>

pub fn new( network: u16, round: u64, height: u32, cumulative_weight: u128, cumulative_proof_target: u128, coinbase_target: u64, proof_target: u64, last_coinbase_target: u64, last_coinbase_timestamp: i64, timestamp: i64, ) -> Result<Self>

Initializes a new metadata with the given inputs.

pub fn is_valid(&self) -> bool

Returns true if the block metadata is well-formed.

impl<N: Network> Metadata<N>

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 block timestamp 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 Metadata<N>

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

Returns a copy of the value.

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

Performs copy-assignment from source.

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

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

Prints the metadata as a JSON-string.

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

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

Deserializes the metadata from a JSON-string or buffer.

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

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

Displays the metadata as a JSON-string.

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

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

Reads the metadata 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 Metadata<N>

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

Initializes the metadata from a JSON-string.

type Err = Error

The associated error which can be returned from parsing.

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

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 Metadata<N>

fn eq(&self, other: &Metadata<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 Metadata<N>

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

Serializes the metadata to a JSON-string or buffer.

impl<N: Network> ToBits for Metadata<N>

fn write_bits_le(&self, vec: &mut Vec<bool>)

Returns the little-endian bits of the metadata.

fn write_bits_be(&self, vec: &mut Vec<bool>)

Returns the big-endian bits of the metadata.

fn to_bits_le(&self) -> Vec<bool>

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

fn to_bits_be(&self) -> Vec<bool>

Returns self as a boolean array in big-endian order.

fn num_bits() -> Option<usize>

An optional indication of how many bits an object can be represented with.

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

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

Writes the metadata 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 Metadata<N>

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

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