Struct Hash

pub struct Hash(pub [u8; 32]);

A hash of a block, used to identify blocks and link blocks into a chain. ⛓️

Technically, this is the (SHA256d) hash of a block header, but since the block header includes the Merkle root of the transaction Merkle tree, it binds the entire contents of the block and is used to identify entire blocks.

Note: Zebra displays transaction and block hashes in big-endian byte-order, following the u256 convention set by Bitcoin and zcashd.

Tuple Fields

0: [u8; 32]

Implementations

impl Hash

pub fn bytes_in_display_order(&self) -> [u8; 32]

Return the hash bytes in big-endian byte-order suitable for printing out byte by byte.

Zebra displays transaction and block hashes in big-endian byte-order, following the u256 convention set by Bitcoin and zcashd.

pub fn from_bytes_in_display_order(bytes_in_display_order: &[u8; 32]) -> Hash

Convert bytes in big-endian byte-order into a block::Hash.

Zebra displays transaction and block hashes in big-endian byte-order, following the u256 convention set by Bitcoin and zcashd.

Trait Implementations

impl Arbitrary for Hash

type Parameters = <[u8; 32] as Arbitrary>::Parameters

The type of parameters that arbitrary_with accepts for configuration of the generated Strategy. Parameters must implement Default.

type Strategy = Map<<[u8; 32] as Arbitrary>::Strategy, fn(_: [u8; 32]) -> Hash>

The type of Strategy used to generate values of type Self.

fn arbitrary_with(_top: Self::Parameters) -> Self::Strategy

Generates a Strategy for producing arbitrary values of type the implementing type (Self). The strategy is passed the arguments given in args.

fn arbitrary() -> Self::Strategy

Generates a Strategy for producing arbitrary values of type the implementing type (Self).

impl Clone for Hash

fn clone(&self) -> Hash

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Hash

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

Formats the value using the given formatter.

impl Default for Hash

fn default() -> Hash

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Hash

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Hash

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

Formats the value using the given formatter.

impl From<&Arc<Header>> for Hash

fn from(block_header: &Arc<Header>) -> Self

Converts to this type from the input type.

impl<'a> From<&'a Block> for Hash

fn from(block: &'a Block) -> Hash

Converts to this type from the input type.

impl<'a> From<&'a Header> for Hash

fn from(block_header: &'a Header) -> Self

Converts to this type from the input type.

impl From<[u8; 32]> for Hash

fn from(bytes: [u8; 32]) -> Self

Converts to this type from the input type.

impl From<Arc<Header>> for Hash

fn from(block_header: Arc<Header>) -> Self

Converts to this type from the input type.

impl From<Header> for Hash

fn from(block_header: Header) -> Self

Converts to this type from the input type.

impl FromHex for Hash

type Error = <[u8; 32] as FromHex>::Error

fn from_hex<T: AsRef<[u8]>>(hex: T) -> Result<Self, Self::Error>

Creates an instance of type Self from the given hex string, or fails with a custom error type.

impl FromStr for Hash

type Err = SerializationError

The associated error which can be returned from parsing.

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

Parses a string s to return a value of this type.

impl Hash for 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 PartialEq<ExpandedDifficulty> for Hash

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

Is self equal to other?

See <ExpandedDifficulty as PartialOrd<block::Hash>::partial_cmp for details.

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 PartialEq<Hash> for ExpandedDifficulty

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

Is self equal to other?

See partial_cmp for details.

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 PartialEq for Hash

fn eq(&self, other: &Hash) -> 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 PartialOrd<ExpandedDifficulty> for Hash

fn partial_cmp(&self, other: &ExpandedDifficulty) -> Option<Ordering>

How does self compare to other?

Consensus

See <ExpandedDifficulty as PartialOrd<block::Hash>::partial_cmp for details.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl PartialOrd<Hash> for ExpandedDifficulty

fn partial_cmp(&self, other: &Hash) -> Option<Ordering>

Consensus

block::Hashes are compared with ExpandedDifficulty thresholds by converting the hash to a 256-bit integer in little-endian order.

Greater values represent less work. This matches the convention in zcashd and bitcoin.

https://zips.z.cash/protocol/protocol.pdf#workdef

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Serialize for Hash

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl ToHex for &Hash

fn encode_hex<T: FromIterator<char>>(&self) -> T

Encode the hex strict representing self into the result. Lower case letters are used (e.g. f9b4ca)

fn encode_hex_upper<T: FromIterator<char>>(&self) -> T

Encode the hex strict representing self into the result. Upper case letters are used (e.g. F9B4CA)

impl ToHex for Hash

fn encode_hex<T: FromIterator<char>>(&self) -> T

Encode the hex strict representing self into the result. Lower case letters are used (e.g. f9b4ca)

fn encode_hex_upper<T: FromIterator<char>>(&self) -> T

Encode the hex strict representing self into the result. Upper case letters are used (e.g. F9B4CA)

impl TrustedPreallocate for Hash

The maximum number of hashes in a valid Zcash protocol message.

fn max_allocation() -> u64

Provides a loose upper bound on the size of the Vec<T: TrustedPreallocate> which can possibly be received from an honest peer.

impl ZcashDeserialize for Hash

fn zcash_deserialize<R: Read>(reader: R) -> Result<Self, SerializationError>

Try to read self from the given reader.

impl ZcashSerialize for Hash

fn zcash_serialize<W: Write>(&self, writer: W) -> Result<(), Error>

Write self to the given writer using the canonical format.

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

Helper function to construct a vec to serialize the current struct into

fn zcash_serialized_size(&self) -> usize

Get the size of self by using a fake writer.

impl Copy for Hash

impl Eq for Hash

impl StructuralPartialEq for Hash