pub struct Transaction {
pub version: u32,
pub lock_time: u32,
pub input: Vec<TxIn>,
pub output: Vec<TxOut>,
}
A Bitcoin transaction, which describes an authenticated movement of coins.
If any inputs have nonempty witnesses, the entire transaction is serialized
in the post-BIP141 Segwit format which includes a list of witnesses. If all
inputs have empty witnesses, the transaction is serialized in the pre-BIP141
format.
There is one major exception to this: to avoid deserialization ambiguity,
if the transaction has no inputs, it is serialized in the BIP141 style. Be
aware that this differs from the transaction format in PSBT, which never
uses BIP141. (Ordinarily there is no conflict, since in PSBT transactions
are always unsigned and therefore their inputs have empty witnesses.)
The specific ambiguity is that Segwit uses the flag bytes 0001
where an old
serializer would read the number of transaction inputs. The old serializer
would interpret this as "no inputs, one output", which means the transaction
is invalid, and simply reject it. Segwit further specifies that this encoding
should only be used when some input has a nonempty witness; that is,
witness-less transactions should be encoded in the traditional format.
However, in protocols where transactions may legitimately have 0 inputs, e.g.
when parties are cooperatively funding a transaction, the "00 means Segwit"
heuristic does not work. Since Segwit requires such a transaction be encoded
in the the original transaction format (since it has no inputs and therefore
no input witnesses), a traditionally encoded transaction may have the 0001
Segwit flag in it, which confuses most Segwit parsers including the one in
Bitcoin Core.
We therefore deviate from the spec by always using the Segwit witness encoding
for 0-input transactions, which results in unambiguously parseable transactions.
The protocol version, is currently expected to be 1 or 2 (BIP 68).
Block number before which this transaction is valid, or 0 for
valid immediately.
Computes a "normalized TXID" which does not include any signatures.
This gives a way to identify a transaction that is ``the same'' as
another in the sense of having same inputs and outputs.
Computes the txid. For non-segwit transactions this will be identical
to the output of BitcoinHash::bitcoin_hash()
, but for segwit transactions,
this will give the correct txid (not including witnesses) while bitcoin_hash
will also hash witnesses.
Computes a signature hash for a given input index with a given sighash flag.
To actually produce a scriptSig, this hash needs to be run through an
ECDSA signer, the SigHashType appended to the resulting sig, and a
script written around this, but this is the general (and hard) part.
Warning This does NOT attempt to support OP_CODESEPARATOR. In general
this would require evaluating script_pubkey
to determine which separators
get evaluated and which don't, which we don't have the information to
determine.
Panics if input_index
is greater than or equal to self.input.len()
Gets the "weight" of this transaction, as defined by BIP141. For transactions with an empty
witness, this is simply the consensus-serialized size times 4. For transactions with a
witness, this is the non-witness consensus-serialized size multiplied by 3 plus the
with-witness consensus-serialized size.
Is this a coin base transaction?
Produces a Sha256dHash which can be used to refer to the object
Encode an object with a well-defined format, should only ever error if the underlying Encoder errors. Read more
Decode an object with a well-defined format
This method tests for self
and other
values to be equal, and is used by ==
. Read more
This method tests for !=
.
Performs copy-assignment from source
. Read more
Formats the value using the given formatter. Read more
Feeds this value into the given [Hasher
]. Read more
Feeds a slice of this type into the given [Hasher
]. Read more
Creates owned data from borrowed data, usually by cloning. Read more
🔬 This is a nightly-only experimental API. (toowned_clone_into
)
recently added
Uses borrowed data to replace owned data, usually by cloning. Read more
🔬 This is a nightly-only experimental API. (try_from
)
The type returned in the event of a conversion error.
🔬 This is a nightly-only experimental API. (try_from
)
Immutably borrows from an owned value. Read more
Mutably borrows from an owned value. Read more
🔬 This is a nightly-only experimental API. (try_from
)
The type returned in the event of a conversion error.
🔬 This is a nightly-only experimental API. (try_from
)
🔬 This is a nightly-only experimental API. (get_type_id
)
this method will likely be replaced by an associated static