Struct bitcoin::blockdata::witness::Witness

source ·

pub struct Witness { /* private fields */ }

Expand description

The Witness is the data used to unlock bitcoin since the segwit upgrade.

Can be logically seen as an array of bytestrings, i.e. Vec<Vec<u8>>, and it is serialized on the wire in that format. You can convert between this type and Vec<Vec<u8>> by using Witness::from_slice and Witness::to_vec.

For serialization and deserialization performance it is stored internally as a single Vec, saving some allocations.

Implementations§

source §

impl Witness

source

pub fn new() -> Self

Creates a new empty Witness.

source

pub fn p2wpkh(signature: &Signature, pubkey: &PublicKey) -> Witness

Creates a witness required to spend a P2WPKH output.

The witness will be made up of the DER encoded signature + sighash_type followed by the serialized public key. Also useful for spending a P2SH-P2WPKH output.

It is expected that pubkey is related to the secret key used to create signature.

source

pub fn from_slice<T: AsRef<[u8]>>(slice: &[T]) -> Self

Creates a Witness object from a slice of bytes slices where each slice is a witness item.

source

pub fn to_vec(&self) -> Vec<Vec<u8>>

Convenience method to create an array of byte-arrays from this witness.

source

pub fn is_empty(&self) -> bool

Returns true if the witness contains no element.

source

pub fn iter(&self) -> Iter<'_> ⓘ

Returns a struct implementing Iterator.

source

pub fn len(&self) -> usize

Returns the number of elements this witness holds.

source

pub fn serialized_len(&self) -> usize

👎Deprecated since 0.31.0: use size instead

Returns the bytes required when this Witness is consensus encoded.

source

pub fn size(&self) -> usize

Returns the number of bytes this witness contributes to a transactions total size.

source

pub fn clear(&mut self)

Clear the witness.

source

pub fn push<T: AsRef<[u8]>>(&mut self, new_element: T)

Push a new element on the witness, requires an allocation.

source

pub fn push_bitcoin_signature( &mut self, signature: &SerializedSignature, hash_type: EcdsaSighashType )

👎Deprecated since 0.30.0: use push_ecdsa_signature instead

Pushes a DER-encoded ECDSA signature with a signature hash type as a new element on the witness, requires an allocation.

source

pub fn push_ecdsa_signature(&mut self, signature: &Signature)

Pushes, as a new element on the witness, an ECDSA signature.

Pushes the DER encoded signature + sighash_type, requires an allocation.

source

pub fn last(&self) -> Option<&[u8]>

Returns the last element in the witness, if any.

source

pub fn second_to_last(&self) -> Option<&[u8]>

Returns the second-to-last element in the witness, if any.

source

pub fn nth(&self, index: usize) -> Option<&[u8]>

Return the nth element in the witness, if any

source

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

Get Tapscript following BIP341 rules regarding accounting for an annex.

This does not guarantee that this represents a P2TR Witness. It merely gets the second to last or third to last element depending on the first byte of the last element being equal to 0x50. See Script::is_v1_p2tr to check whether this is actually a Taproot witness.