Struct TransactionInput 

pub struct TransactionInput {
    pub source_txid: [u8; 32],
    pub source_tx_out_index: u32,
    pub sequence_number: u32,
    pub unlocking_script: Option<Script>,
    pub source_transaction: Option<Box<Transaction>>,
    /* private fields */
}

A single input in a BSV transaction.

Each input references an output from a previous transaction by its transaction ID (source_txid) and output index (source_tx_out_index). The unlocking_script (scriptSig) supplies the data required to satisfy the referenced output’s locking script.

Source output information can be provided either via source_transaction (full previous tx) or set_source_output (just the relevant output). The direct source output takes priority when both are present.

Wire format (standard)

Field	Size
source_txid	32 bytes (LE)
source_tx_out_index	4 bytes (LE)
script length	VarInt
unlocking_script	variable
sequence_number	4 bytes (LE)

Fields

source_txid: [u8; 32]

The 32-byte transaction ID of the output being spent, in internal (little-endian) byte order.

source_tx_out_index: u32

Index of the output within the source transaction.

sequence_number: u32

Sequence number. Defaults to 0xFFFFFFFF (finalized).

unlocking_script: Option<Script>

The unlocking script (scriptSig) that proves authorization. None when the input has not yet been signed.

source_transaction: Option<Box<Transaction>>

Optional reference to the full source transaction. Used during signing to look up the previous output’s locking script and satoshi value.

Implementations

impl TransactionInput

pub fn new() -> Self

Create a new TransactionInput with default values.

The source txid is zeroed, output index is 0, sequence is finalized, and no unlocking script or source transaction is set.

Returns

A default TransactionInput.

pub fn read_from(reader: &mut BsvReader<'_>) -> Result<Self, TransactionError>

Deserialize a TransactionInput from a BsvReader.

Reads the standard wire format: 32-byte txid, 4-byte output index, varint-prefixed unlocking script, and 4-byte sequence number.

Arguments

• reader - The reader positioned at the start of an encoded input.

Returns

Ok(TransactionInput) on success, or a TransactionError if the data is truncated or malformed.

pub fn write_to(&self, writer: &mut BsvWriter)

Serialize this TransactionInput into a BsvWriter.

Writes the standard wire format: txid, output index, varint script length, script bytes, and sequence number.

Arguments

• writer - The writer to append serialized bytes to.

pub fn to_bytes_cleared(&self, clear: bool) -> Vec<u8>

Serialize this input to a byte vector.

If clear is true, the unlocking script is omitted (written as zero-length). This is used when constructing signature preimages.

Arguments

• clear - If true, omit the unlocking script from the output.

Returns

A Vec<u8> containing the serialized input.

pub fn set_source_output(&mut self, output: Option<TransactionOutput>)

Set a direct source output on this input.

This provides the satoshi value and locking script of the output being spent, without needing the full source transaction. Takes priority over source_transaction for lookups.

Arguments

• output - The source output, or None to clear.

pub fn source_tx_output(&self) -> Option<&TransactionOutput>

Look up the source transaction output, if available.

First checks the direct source_output field, then falls back to looking up the output by index in source_transaction.

Returns

Some(&TransactionOutput) if source info is available, otherwise None.

pub fn source_tx_satoshis(&self) -> Option<u64>

Return the satoshi value of the source output, if available.

Returns

Some(satoshis) if the source output info is available, otherwise None.

pub fn source_tx_script(&self) -> Option<&Script>

Return the locking script of the source output, if available.

Returns

Some(&Script) if the source output info is available, otherwise None.

Trait Implementations

impl Clone for TransactionInput

fn clone(&self) -> TransactionInput

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TransactionInput

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

Formats the value using the given formatter.

impl Default for TransactionInput

fn default() -> Self

Returns the “default value” for a type.