Enum zebra_chain::transaction::unmined::UnminedTxId

pub enum UnminedTxId {
    Legacy(Hash),
    Witnessed(WtxId),
}

A unique identifier for an unmined transaction, regardless of version.

“The transaction ID of a version 4 or earlier transaction is the SHA-256d hash of the transaction encoding in the pre-v5 format described above.

The transaction ID of a version 5 transaction is as defined in ZIP-244.

A v5 transaction also has a wtxid (used for example in the peer-to-peer protocol) as defined in ZIP-239.“ Spec: Transaction Identifiers

Variants

Legacy(Hash)

A legacy unmined transaction identifier.

Used to uniquely identify unmined version 1-4 transactions. (After v1-4 transactions are mined, they can be uniquely identified using the same Hash.)

Witnessed(WtxId)

A witnessed unmined transaction identifier.

Used to uniquely identify unmined version 5 transactions. (After v5 transactions are mined, they can be uniquely identified using only the Hash in their WtxId.id.)

For more details, see WtxId.

Implementations

impl UnminedTxId

pub fn from_legacy_id(legacy_tx_id: Hash) -> UnminedTxId

Create a new UnminedTxId using a v1-v4 legacy transaction ID.

Correctness

This method must only be used for v1-v4 transaction IDs. Hash does not uniquely identify unmined v5 transactions.

pub fn mined_id(&self) -> Hash

Return the unique ID that will be used if this transaction gets mined into a block.

Correctness

For v1-v4 transactions, this method returns an ID which changes if this transaction’s effects (spends and outputs) change, or if its authorizing data changes (signatures, proofs, and scripts).

But for v5 transactions, this ID uniquely identifies the transaction’s effects.

pub fn mined_id_mut(&mut self) -> &mut Hash

Returns a mutable reference to the unique ID that will be used if this transaction gets mined into a block.

See Self::mined_id for details.

pub fn auth_digest(&self) -> Option<AuthDigest>

Return the digest of this transaction’s authorizing data, (signatures, proofs, and scripts), if it is a v5 transaction.

pub fn auth_digest_mut(&mut self) -> Option<&mut AuthDigest>

Returns a mutable reference to the digest of this transaction’s authorizing data, (signatures, proofs, and scripts), if it is a v5 transaction.

Trait Implementations

impl Arbitrary for UnminedTxId

type Parameters = (<Hash as Arbitrary>::Parameters, <WtxId as Arbitrary>::Parameters)

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

type Strategy = TupleUnion<((u32, Arc<Map<<Hash as Arbitrary>::Strategy, fn(_: Hash) -> UnminedTxId>>), (u32, Arc<Map<<WtxId as Arbitrary>::Strategy, fn(_: WtxId) -> UnminedTxId>>))>

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 UnminedTxId

fn clone(&self) -> UnminedTxId

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for UnminedTxId

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

Formats the value using the given formatter.

impl Display for UnminedTxId

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

Formats the value using the given formatter.

impl From<&Transaction> for UnminedTxId

fn from(transaction: &Transaction) -> Self

Converts to this type from the input type.

impl From<&WtxId> for UnminedTxId

fn from(wtx_id: &WtxId) -> Self

Converts to this type from the input type.

impl From<Arc<Transaction>> for UnminedTxId

fn from(transaction: Arc<Transaction>) -> Self

Converts to this type from the input type.

impl From<Transaction> for UnminedTxId

fn from(transaction: Transaction) -> Self

Converts to this type from the input type.

impl From<WtxId> for UnminedTxId

fn from(wtx_id: WtxId) -> Self

Converts to this type from the input type.

impl FromIterator<UnminedTxId> for AuthDataRoot

fn from_iter<I>(tx_ids: I) -> Self

where I: IntoIterator<Item = UnminedTxId>,

Creates a value from an iterator.

impl FromIterator<UnminedTxId> for Root

fn from_iter<I>(tx_ids: I) -> Self

where I: IntoIterator<Item = UnminedTxId>,

Creates a value from an iterator.

impl Hash for UnminedTxId

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 UnminedTxId

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for UnminedTxId

impl Eq for UnminedTxId

impl StructuralPartialEq for UnminedTxId