Struct bitcoins::types::txin::Outpoint

pub struct Outpoint<M> where
    M: MarkedDigestOutput, {
    pub txid: M,
    pub idx: u32,
}

An Outpoint. This is a unique identifier for a UTXO, and is composed of a transaction ID (in Bitcoin-style LE format), and the index of the output being spent within that transactions output vectour (vout).

Outpoint::null() and Outpoint::default() return the null Outpoint, which references a txid of all 0, and a index 0xffff_ffff. This null outpoint is used in every coinbase transaction.

Fields

txid: M

The txid that created the UTXO being pointed to.

idx: u32

The index of that UTXO in the transaction’s output vector.

Implementations

impl<M> Outpoint<M> where
    M: MarkedDigestOutput, 

pub fn new(txid: M, idx: u32) -> Self

Returns a new Outpoint from a digest and index

pub fn null() -> Self

Returns the default, or null Outpoint. This is used in the coinbase input.

pub fn txid_be_hex(&self) -> String

Return the BE txid as hex, suitable for block explorers

pub fn from_explorer_format(txid_be: M, idx: u32) -> Self

Instantiate an outpoint from the Block Explorer (big-endian) TXID format and integer index

Trait Implementations

impl<M> ByteFormat for Outpoint<M> where
    M: MarkedDigestOutput + ByteFormat, 

type Error = SerError

An associated error type

fn serialized_length(&self) -> usize

Returns the byte-length of the serialized data structure.

fn read_from<T>(reader: &mut T) -> SerResult<Self> where
    T: Read,
    Self: Sized, 

Deserializes an instance of Self from a std::io::Read. The limit argument is used only when deserializing collections, and specifies a maximum number of instances of the underlying type to read.

fn write_to<T>(&self, writer: &mut T) -> SerResult<usize> where
    T: Write, 

Serializes self to a std::io::Write. Following Write trait conventions, its Ok type must be a usize denoting the number of bytes written.

fn read_seq_from<R>(
    reader: &mut R,
    mode: ReadSeqMode
) -> Result<Vec<Self, Global>, Self::Error> where
    R: Read, 

Read a sequence of exactly limit objects from the reader.

fn write_seq_to<'a, W, E, Iter, Item>(
    writer: &mut W,
    iter: Iter
) -> Result<usize, Self::Error> where
    W: Write,
    E: Into<Self::Error> + From<SerError> + From<Error> + Error,
    Item: 'a + ByteFormat<Error = E>,
    Iter: IntoIterator<Item = &'a Item>, 

Write a sequence of ByteFormat objects to a writer. The iter argument may be any object that implements IntoIterator<Item = &Item>. This means we can seamlessly use vectors, slices, etc.

fn deserialize_hex(s: &str) -> Result<Self, Self::Error>

Decodes a hex string to a Vec<u8>, deserializes an instance of Self from that vector.

fn deserialize_base64(s: &str) -> Result<Self, Self::Error>

Serialize self to a base64 string, using standard RFC4648 non-url safe characters

fn serialize_hex(&self) -> String

Serializes self to a vector, returns the hex-encoded vector

fn serialize_base64(&self) -> String

Serialize self to a base64 string, using standard RFC4648 non-url safe characters

impl<M: Clone> Clone for Outpoint<M> where
    M: MarkedDigestOutput, 

fn clone(&self) -> Outpoint<M>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<M: Debug> Debug for Outpoint<M> where
    M: MarkedDigestOutput, 

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

Formats the value using the given formatter.

impl<M> Default for Outpoint<M> where
    M: MarkedDigestOutput, 

fn default() -> Self

Returns the “default value” for a type.

impl<'de, M> Deserialize<'de> for Outpoint<M> where
    M: MarkedDigestOutput,
    M: Deserialize<'de>, 

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error> where
    __D: Deserializer<'de>, 

Deserialize this value from the given Serde deserializer.

impl<M: Hash> Hash for Outpoint<M> where
    M: MarkedDigestOutput, 

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, 

Feeds a slice of this type into the given Hasher.

impl<M: PartialEq> PartialEq<Outpoint<M>> for Outpoint<M> where
    M: MarkedDigestOutput, 

fn eq(&self, other: &Outpoint<M>) -> bool

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

fn ne(&self, other: &Outpoint<M>) -> bool

This method tests for !=.

impl<M> Serialize for Outpoint<M> where
    M: MarkedDigestOutput,
    M: Serialize, 

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

Serialize this value into the given Serde serializer.

impl<M: Copy> Copy for Outpoint<M> where
    M: MarkedDigestOutput, 

impl<M: Eq> Eq for Outpoint<M> where
    M: MarkedDigestOutput, 

impl<M> StructuralEq for Outpoint<M> where
    M: MarkedDigestOutput, 

impl<M> StructuralPartialEq for Outpoint<M> where
    M: MarkedDigestOutput, 

impl<M> TxoIdentifier for Outpoint<M> where
    M: MarkedDigestOutput,