fedimint_core

Trait BitcoinHash

pub trait BitcoinHash:
    Copy
    + Clone
    + PartialEq
    + Eq
    + PartialOrd
    + Ord
    + Hash
    + Debug
    + Display
    + LowerHex
    + Index<RangeFull, Output = [u8], Output = [u8], Output = [u8], Output = [u8], Output = u8>
    + Index<RangeFrom<usize>>
    + Index<RangeTo<usize>>
    + Index<Range<usize>>
    + Index<usize>
    + Borrow<[u8]> {
    type Engine: HashEngine;
    type Bytes: FromHex + Copy;

    const LEN: usize;
    const DISPLAY_BACKWARD: bool = false;

    // Required methods
    fn from_engine(e: Self::Engine) -> Self;
    fn from_slice(sl: &[u8]) -> Result<Self, Error>;
    fn to_byte_array(self) -> Self::Bytes;
    fn as_byte_array(&self) -> &Self::Bytes;
    fn from_byte_array(bytes: Self::Bytes) -> Self;
    fn all_zeros() -> Self;

    // Provided methods
    fn engine() -> Self::Engine { ... }
    fn hash(data: &[u8]) -> Self { ... }
}
Expand description

Trait which applies to hashes of all types.

Required Associated Constants§

const LEN: usize

Length of the hash, in bytes.

Provided Associated Constants§

const DISPLAY_BACKWARD: bool = false

Flag indicating whether user-visible serializations of this hash should be backward. For some reason Satoshi decided this should be true for Sha256dHash, so here we are.

Required Associated Types§

type Engine: HashEngine

A hashing engine which bytes can be serialized into. It is expected to implement the io::Write trait, and to never return errors under any conditions.

type Bytes: FromHex + Copy

The byte array that represents the hash internally.

Required Methods§

fn from_engine(e: Self::Engine) -> Self

Produces a hash from the current state of a given engine.

fn from_slice(sl: &[u8]) -> Result<Self, Error>

Copies a byte slice into a hash object.

fn to_byte_array(self) -> Self::Bytes

Returns the underlying byte array.

fn as_byte_array(&self) -> &Self::Bytes

Returns a reference to the underlying byte array.

fn from_byte_array(bytes: Self::Bytes) -> Self

Constructs a hash from the underlying byte array.

fn all_zeros() -> Self

Returns an all zero hash.

An all zeros hash is a made up construct because there is not a known input that can create it, however it is used in various places in Bitcoin e.g., the Bitcoin genesis block’s previous blockhash and the coinbase transaction’s outpoint txid.

Provided Methods§

fn engine() -> Self::Engine

Constructs a new engine.

fn hash(data: &[u8]) -> Self

Hashes some bytes.

Object Safety§

This trait is not object safe.

Implementations on Foreign Types§

§

impl Hash for BlockHash

§

const LEN: usize = 32usize

§

const DISPLAY_BACKWARD: bool = true

§

type Engine = <Hash as Hash>::Engine

§

type Bytes = <Hash as Hash>::Bytes

§

fn engine() -> <BlockHash as Hash>::Engine

§

fn from_engine(e: <BlockHash as Hash>::Engine) -> BlockHash

§

fn from_slice(sl: &[u8]) -> Result<BlockHash, Error>

§

fn from_byte_array(bytes: <BlockHash as Hash>::Bytes) -> BlockHash

§

fn to_byte_array(self) -> <BlockHash as Hash>::Bytes

§

fn as_byte_array(&self) -> &<BlockHash as Hash>::Bytes

§

fn all_zeros() -> BlockHash

§

impl Hash for FilterHash

§

const LEN: usize = 32usize

§

const DISPLAY_BACKWARD: bool = true

§

type Engine = <Hash as Hash>::Engine

§

type Bytes = <Hash as Hash>::Bytes

§

fn engine() -> <FilterHash as Hash>::Engine

§

fn from_engine(e: <FilterHash as Hash>::Engine) -> FilterHash

§

fn from_slice(sl: &[u8]) -> Result<FilterHash, Error>

§

fn from_byte_array(bytes: <FilterHash as Hash>::Bytes) -> FilterHash

§

fn to_byte_array(self) -> <FilterHash as Hash>::Bytes

§

fn as_byte_array(&self) -> &<FilterHash as Hash>::Bytes

§

fn all_zeros() -> FilterHash

§

impl Hash for FilterHeader

§

const LEN: usize = 32usize

§

const DISPLAY_BACKWARD: bool = true

§

type Engine = <Hash as Hash>::Engine

§

type Bytes = <Hash as Hash>::Bytes

§

fn engine() -> <FilterHeader as Hash>::Engine

§

fn from_engine(e: <FilterHeader as Hash>::Engine) -> FilterHeader

§

fn from_slice(sl: &[u8]) -> Result<FilterHeader, Error>

§

fn from_byte_array(bytes: <FilterHeader as Hash>::Bytes) -> FilterHeader

§

fn to_byte_array(self) -> <FilterHeader as Hash>::Bytes

§

fn as_byte_array(&self) -> &<FilterHeader as Hash>::Bytes

§

fn all_zeros() -> FilterHeader

§

impl Hash for Hash

§

const LEN: usize = 32usize

§

const DISPLAY_BACKWARD: bool = false

§

type Engine = <Hash as Hash>::Engine

§

type Bytes = <Hash as Hash>::Bytes

§

fn engine() -> <Hash as Hash>::Engine

§

fn from_engine(e: <Hash as Hash>::Engine) -> Hash

§

fn from_slice(sl: &[u8]) -> Result<Hash, Error>

§

fn from_byte_array(bytes: <Hash as Hash>::Bytes) -> Hash

§

fn to_byte_array(self) -> <Hash as Hash>::Bytes

§

fn as_byte_array(&self) -> &<Hash as Hash>::Bytes

§

fn all_zeros() -> Hash

§

impl Hash for LegacySighash

§

const LEN: usize = 32usize

§

const DISPLAY_BACKWARD: bool = false

§

type Engine = <Hash as Hash>::Engine

§

type Bytes = <Hash as Hash>::Bytes

§

fn engine() -> <LegacySighash as Hash>::Engine

§

fn from_engine(e: <LegacySighash as Hash>::Engine) -> LegacySighash

§

fn from_slice(sl: &[u8]) -> Result<LegacySighash, Error>

§

fn from_byte_array(bytes: <LegacySighash as Hash>::Bytes) -> LegacySighash

§

fn to_byte_array(self) -> <LegacySighash as Hash>::Bytes

§

fn as_byte_array(&self) -> &<LegacySighash as Hash>::Bytes

§

fn all_zeros() -> LegacySighash

§

impl Hash for PubkeyHash

§

const LEN: usize = 20usize

§

const DISPLAY_BACKWARD: bool = false

§

type Engine = <Hash as Hash>::Engine

§

type Bytes = <Hash as Hash>::Bytes

§

fn engine() -> <PubkeyHash as Hash>::Engine

§

fn from_engine(e: <PubkeyHash as Hash>::Engine) -> PubkeyHash

§

fn from_slice(sl: &[u8]) -> Result<PubkeyHash, Error>

§

fn from_byte_array(bytes: <PubkeyHash as Hash>::Bytes) -> PubkeyHash

§

fn to_byte_array(self) -> <PubkeyHash as Hash>::Bytes

§

fn as_byte_array(&self) -> &<PubkeyHash as Hash>::Bytes

§

fn all_zeros() -> PubkeyHash

§

impl Hash for ScriptHash

§

const LEN: usize = 20usize

§

const DISPLAY_BACKWARD: bool = false

§

type Engine = <Hash as Hash>::Engine

§

type Bytes = <Hash as Hash>::Bytes

§

fn engine() -> <ScriptHash as Hash>::Engine

§

fn from_engine(e: <ScriptHash as Hash>::Engine) -> ScriptHash

§

fn from_slice(sl: &[u8]) -> Result<ScriptHash, Error>

§

fn from_byte_array(bytes: <ScriptHash as Hash>::Bytes) -> ScriptHash

§

fn to_byte_array(self) -> <ScriptHash as Hash>::Bytes

§

fn as_byte_array(&self) -> &<ScriptHash as Hash>::Bytes

§

fn all_zeros() -> ScriptHash

§

impl Hash for SegwitV0Sighash

§

const LEN: usize = 32usize

§

const DISPLAY_BACKWARD: bool = false

§

type Engine = <Hash as Hash>::Engine

§

type Bytes = <Hash as Hash>::Bytes

§

fn engine() -> <SegwitV0Sighash as Hash>::Engine

§

fn from_engine(e: <SegwitV0Sighash as Hash>::Engine) -> SegwitV0Sighash

§

fn from_slice(sl: &[u8]) -> Result<SegwitV0Sighash, Error>

§

fn from_byte_array(bytes: <SegwitV0Sighash as Hash>::Bytes) -> SegwitV0Sighash

§

fn to_byte_array(self) -> <SegwitV0Sighash as Hash>::Bytes

§

fn as_byte_array(&self) -> &<SegwitV0Sighash as Hash>::Bytes

§

fn all_zeros() -> SegwitV0Sighash

§

impl Hash for TapLeafHash

§

const LEN: usize = 32usize

§

const DISPLAY_BACKWARD: bool = false

§

type Engine = <Hash<TapLeafTag> as Hash>::Engine

§

type Bytes = <Hash<TapLeafTag> as Hash>::Bytes

§

fn engine() -> <TapLeafHash as Hash>::Engine

§

fn from_engine(e: <TapLeafHash as Hash>::Engine) -> TapLeafHash

§

fn from_slice(sl: &[u8]) -> Result<TapLeafHash, Error>

§

fn from_byte_array(bytes: <TapLeafHash as Hash>::Bytes) -> TapLeafHash

§

fn to_byte_array(self) -> <TapLeafHash as Hash>::Bytes

§

fn as_byte_array(&self) -> &<TapLeafHash as Hash>::Bytes

§

fn all_zeros() -> TapLeafHash

§

impl Hash for TapNodeHash

§

const LEN: usize = 32usize

§

const DISPLAY_BACKWARD: bool = false

§

type Engine = <Hash<TapBranchTag> as Hash>::Engine

§

type Bytes = <Hash<TapBranchTag> as Hash>::Bytes

§

fn engine() -> <TapNodeHash as Hash>::Engine

§

fn from_engine(e: <TapNodeHash as Hash>::Engine) -> TapNodeHash

§

fn from_slice(sl: &[u8]) -> Result<TapNodeHash, Error>

§

fn from_byte_array(bytes: <TapNodeHash as Hash>::Bytes) -> TapNodeHash

§

fn to_byte_array(self) -> <TapNodeHash as Hash>::Bytes

§

fn as_byte_array(&self) -> &<TapNodeHash as Hash>::Bytes

§

fn all_zeros() -> TapNodeHash

§

impl Hash for TapSighash

§

const LEN: usize = 32usize

§

const DISPLAY_BACKWARD: bool = false

§

type Engine = <Hash<TapSighashTag> as Hash>::Engine

§

type Bytes = <Hash<TapSighashTag> as Hash>::Bytes

§

fn engine() -> <TapSighash as Hash>::Engine

§

fn from_engine(e: <TapSighash as Hash>::Engine) -> TapSighash

§

fn from_slice(sl: &[u8]) -> Result<TapSighash, Error>

§

fn from_byte_array(bytes: <TapSighash as Hash>::Bytes) -> TapSighash

§

fn to_byte_array(self) -> <TapSighash as Hash>::Bytes

§

fn as_byte_array(&self) -> &<TapSighash as Hash>::Bytes

§

fn all_zeros() -> TapSighash

§

impl Hash for TapTweakHash

§

const LEN: usize = 32usize

§

const DISPLAY_BACKWARD: bool = false

§

type Engine = <Hash<TapTweakTag> as Hash>::Engine

§

type Bytes = <Hash<TapTweakTag> as Hash>::Bytes

§

fn engine() -> <TapTweakHash as Hash>::Engine

§

fn from_engine(e: <TapTweakHash as Hash>::Engine) -> TapTweakHash

§

fn from_slice(sl: &[u8]) -> Result<TapTweakHash, Error>

§

fn from_byte_array(bytes: <TapTweakHash as Hash>::Bytes) -> TapTweakHash

§

fn to_byte_array(self) -> <TapTweakHash as Hash>::Bytes

§

fn as_byte_array(&self) -> &<TapTweakHash as Hash>::Bytes

§

fn all_zeros() -> TapTweakHash

§

impl Hash for TxMerkleNode

§

const LEN: usize = 32usize

§

const DISPLAY_BACKWARD: bool = true

§

type Engine = <Hash as Hash>::Engine

§

type Bytes = <Hash as Hash>::Bytes

§

fn engine() -> <TxMerkleNode as Hash>::Engine

§

fn from_engine(e: <TxMerkleNode as Hash>::Engine) -> TxMerkleNode

§

fn from_slice(sl: &[u8]) -> Result<TxMerkleNode, Error>

§

fn from_byte_array(bytes: <TxMerkleNode as Hash>::Bytes) -> TxMerkleNode

§

fn to_byte_array(self) -> <TxMerkleNode as Hash>::Bytes

§

fn as_byte_array(&self) -> &<TxMerkleNode as Hash>::Bytes

§

fn all_zeros() -> TxMerkleNode

§

impl Hash for Txid

§

const LEN: usize = 32usize

§

const DISPLAY_BACKWARD: bool = true

§

type Engine = <Hash as Hash>::Engine

§

type Bytes = <Hash as Hash>::Bytes

§

fn engine() -> <Txid as Hash>::Engine

§

fn from_engine(e: <Txid as Hash>::Engine) -> Txid

§

fn from_slice(sl: &[u8]) -> Result<Txid, Error>

§

fn from_byte_array(bytes: <Txid as Hash>::Bytes) -> Txid

§

fn to_byte_array(self) -> <Txid as Hash>::Bytes

§

fn as_byte_array(&self) -> &<Txid as Hash>::Bytes

§

fn all_zeros() -> Txid

§

impl Hash for WPubkeyHash

§

const LEN: usize = 20usize

§

const DISPLAY_BACKWARD: bool = false

§

type Engine = <Hash as Hash>::Engine

§

type Bytes = <Hash as Hash>::Bytes

§

fn engine() -> <WPubkeyHash as Hash>::Engine

§

fn from_engine(e: <WPubkeyHash as Hash>::Engine) -> WPubkeyHash

§

fn from_slice(sl: &[u8]) -> Result<WPubkeyHash, Error>

§

fn from_byte_array(bytes: <WPubkeyHash as Hash>::Bytes) -> WPubkeyHash

§

fn to_byte_array(self) -> <WPubkeyHash as Hash>::Bytes

§

fn as_byte_array(&self) -> &<WPubkeyHash as Hash>::Bytes

§

fn all_zeros() -> WPubkeyHash

§

impl Hash for WScriptHash

§

const LEN: usize = 32usize

§

const DISPLAY_BACKWARD: bool = false

§

type Engine = <Hash as Hash>::Engine

§

type Bytes = <Hash as Hash>::Bytes

§

fn engine() -> <WScriptHash as Hash>::Engine

§

fn from_engine(e: <WScriptHash as Hash>::Engine) -> WScriptHash

§

fn from_slice(sl: &[u8]) -> Result<WScriptHash, Error>

§

fn from_byte_array(bytes: <WScriptHash as Hash>::Bytes) -> WScriptHash

§

fn to_byte_array(self) -> <WScriptHash as Hash>::Bytes

§

fn as_byte_array(&self) -> &<WScriptHash as Hash>::Bytes

§

fn all_zeros() -> WScriptHash

§

impl Hash for WitnessCommitment

§

const LEN: usize = 32usize

§

const DISPLAY_BACKWARD: bool = true

§

type Engine = <Hash as Hash>::Engine

§

type Bytes = <Hash as Hash>::Bytes

§

fn engine() -> <WitnessCommitment as Hash>::Engine

§

fn from_engine(e: <WitnessCommitment as Hash>::Engine) -> WitnessCommitment

§

fn from_slice(sl: &[u8]) -> Result<WitnessCommitment, Error>

§

fn from_byte_array( bytes: <WitnessCommitment as Hash>::Bytes, ) -> WitnessCommitment

§

fn to_byte_array(self) -> <WitnessCommitment as Hash>::Bytes

§

fn as_byte_array(&self) -> &<WitnessCommitment as Hash>::Bytes

§

fn all_zeros() -> WitnessCommitment

§

impl Hash for WitnessMerkleNode

§

const LEN: usize = 32usize

§

const DISPLAY_BACKWARD: bool = true

§

type Engine = <Hash as Hash>::Engine

§

type Bytes = <Hash as Hash>::Bytes

§

fn engine() -> <WitnessMerkleNode as Hash>::Engine

§

fn from_engine(e: <WitnessMerkleNode as Hash>::Engine) -> WitnessMerkleNode

§

fn from_slice(sl: &[u8]) -> Result<WitnessMerkleNode, Error>

§

fn from_byte_array( bytes: <WitnessMerkleNode as Hash>::Bytes, ) -> WitnessMerkleNode

§

fn to_byte_array(self) -> <WitnessMerkleNode as Hash>::Bytes

§

fn as_byte_array(&self) -> &<WitnessMerkleNode as Hash>::Bytes

§

fn all_zeros() -> WitnessMerkleNode

§

impl Hash for Wtxid

§

const LEN: usize = 32usize

§

const DISPLAY_BACKWARD: bool = true

§

type Engine = <Hash as Hash>::Engine

§

type Bytes = <Hash as Hash>::Bytes

§

fn engine() -> <Wtxid as Hash>::Engine

§

fn from_engine(e: <Wtxid as Hash>::Engine) -> Wtxid

§

fn from_slice(sl: &[u8]) -> Result<Wtxid, Error>

§

fn from_byte_array(bytes: <Wtxid as Hash>::Bytes) -> Wtxid

§

fn to_byte_array(self) -> <Wtxid as Hash>::Bytes

§

fn as_byte_array(&self) -> &<Wtxid as Hash>::Bytes

§

fn all_zeros() -> Wtxid

§

impl Hash for XpubIdentifier

§

const LEN: usize = 20usize

§

const DISPLAY_BACKWARD: bool = false

§

type Engine = <Hash as Hash>::Engine

§

type Bytes = <Hash as Hash>::Bytes

§

fn engine() -> <XpubIdentifier as Hash>::Engine

§

fn from_engine(e: <XpubIdentifier as Hash>::Engine) -> XpubIdentifier

§

fn from_slice(sl: &[u8]) -> Result<XpubIdentifier, Error>

§

fn from_byte_array(bytes: <XpubIdentifier as Hash>::Bytes) -> XpubIdentifier

§

fn to_byte_array(self) -> <XpubIdentifier as Hash>::Bytes

§

fn as_byte_array(&self) -> &<XpubIdentifier as Hash>::Bytes

§

fn all_zeros() -> XpubIdentifier

Implementors§

source§

impl Hash for TransactionId

source§

const LEN: usize = 32usize

source§

const DISPLAY_BACKWARD: bool = false

source§

type Engine = <Hash as Hash>::Engine

source§

type Bytes = <Hash as Hash>::Bytes

§

impl Hash for Hash

§

const LEN: usize = 20usize

§

const DISPLAY_BACKWARD: bool = false

§

type Engine = HashEngine

§

type Bytes = [u8; 20]

§

impl Hash for Hash

§

const LEN: usize = 20usize

§

const DISPLAY_BACKWARD: bool = false

§

type Engine = HashEngine

§

type Bytes = [u8; 20]

§

impl Hash for Hash

§

const LEN: usize = 20usize

§

const DISPLAY_BACKWARD: bool = false

§

type Engine = HashEngine

§

type Bytes = [u8; 20]

§

impl Hash for Hash

§

const LEN: usize = 32usize

§

const DISPLAY_BACKWARD: bool = false

§

type Engine = HashEngine

§

type Bytes = [u8; 32]

§

impl Hash for Hash

§

const LEN: usize = 32usize

§

const DISPLAY_BACKWARD: bool = true

§

type Engine = HashEngine

§

type Bytes = [u8; 32]

§

impl Hash for Hash

§

const LEN: usize = 8usize

§

const DISPLAY_BACKWARD: bool = false

§

type Engine = HashEngine

§

type Bytes = [u8; 8]

§

impl Hash for Hash

§

const LEN: usize = 64usize

§

const DISPLAY_BACKWARD: bool = false

§

type Engine = HashEngine

§

type Bytes = [u8; 64]

§

impl Hash for Hash

§

const LEN: usize = 32usize

§

const DISPLAY_BACKWARD: bool = false

§

type Engine = HashEngine

§

type Bytes = [u8; 32]

§

impl<T> Hash for Hash<T>
where T: Tag,

§

const LEN: usize = 32usize

§

const DISPLAY_BACKWARD: bool = true

§

type Engine = HashEngine

§

type Bytes = [u8; 32]

§

impl<T> Hash for Hmac<T>
where T: Hash,

§

const LEN: usize = T::LEN

§

type Engine = HmacEngine<T>

§

type Bytes = <T as Hash>::Bytes