Struct Hash 

pub struct Hash(/* private fields */);

A 32-byte hash used for transaction IDs, block hashes, and merkle trees.

When displayed as a string, the bytes are reversed to match Bitcoin’s standard representation (little-endian internal, big-endian display).

Implementations

impl Hash

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

Create a Hash from a raw 32-byte array.

The bytes are stored as-is (internal byte order).

Arguments

• bytes - The 32 bytes in internal (little-endian) order.

Returns

A new Hash.

pub fn from_bytes(bytes: &[u8]) -> Result<Self, PrimitivesError>

Create a Hash from a byte slice.

Arguments

• bytes - A slice that must be exactly 32 bytes.

Returns

Ok(Hash) if the slice is 32 bytes, or an error otherwise.

pub fn from_hex(hex_str: &str) -> Result<Self, PrimitivesError>

Create a Hash from a byte-reversed hex string.

This matches the Go SDK’s NewHashFromHex / Decode function. The hex string represents bytes in display order (reversed from internal storage). Short strings are zero-padded on the high end.

Arguments

• hex_str - A hex string of up to 64 characters.

Returns

Ok(Hash) on success, or an error for invalid input.

pub fn clone_bytes(&self) -> Vec<u8>

Return a copy of the internal bytes.

Returns

A Vec<u8> containing the 32 hash bytes in internal order.

pub fn set_bytes(&mut self, bytes: &[u8]) -> Result<(), PrimitivesError>

Set the hash bytes from a slice.

Arguments

• bytes - A slice that must be exactly 32 bytes.

Returns

Ok(()) on success, or an error if the length is wrong.

pub fn is_equal(&self, other: Option<&Hash>) -> bool

Check equality with another Hash reference.

Handles the None/null case like the Go SDK’s IsEqual method.

Arguments

• other - An optional reference to another Hash.

Returns

true if both hashes are equal.

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

Access the internal byte array as a reference.

Returns

A reference to the 32-byte internal array.

pub fn size(&self) -> usize

Return the size of the hash in bytes.

Returns

Always returns 32.

Trait Implementations

impl Clone for Hash

fn clone(&self) -> Hash

Returns a duplicate 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

Deserialize from a hex string in JSON.

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

Deserialize this value from the given Serde deserializer.

impl Display for Hash

Display the hash as byte-reversed hex (Bitcoin convention).

Internal bytes [0x06, 0xe5, ...] display as "...e506".

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

Formats the value using the given formatter.

impl FromStr for Hash

Parse a byte-reversed hex string into a Hash.

Equivalent to Hash::from_hex.

type Err = PrimitivesError

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

Serialize as a hex string in JSON.

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

Serialize this value into the given Serde serializer.

impl Copy for Hash

impl Eq for Hash

impl StructuralPartialEq for Hash