psbt

package module
v1.1.9 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Dec 19, 2023 License: ISC Imports: 15 Imported by: 113

Documentation

Overview

Package psbt is an implementation of Partially Signed Bitcoin Transactions (PSBT). The format is defined in BIP 174: https://github.com/bitcoin/bips/blob/master/bip-0174.mediawiki

Index

Constants

View Source 
const (
	// SignSuccesful indicates that the partial signature was successfully
	// attached.
	SignSuccesful = 0

	// SignFinalized  indicates that this input is already finalized, so the
	// provided signature was *not* attached
	SignFinalized = 1

	// SignInvalid indicates that the provided signature data was not valid.
	// In this case an error will also be returned.
	SignInvalid = -1
)
View Source 
const MaxPsbtKeyLength = 10000

MaxPsbtKeyLength is the length of the largest key that we'll successfully deserialize from the wire. Anything more will return ErrInvalidKeyData.

View Source 
const MaxPsbtValueLength = 4000000

MaxPsbtValueLength is the size of the largest transaction serialization that could be passed in a NonWitnessUtxo field. This is definitely less than 4M.

View Source 
const MinTxVersion = 1

MinTxVersion is the lowest transaction version that we'll permit.

Variables

View Source 
var (

	// ErrInvalidPsbtFormat is a generic error for any situation in which a
	// provided Psbt serialization does not conform to the rules of BIP174.
	ErrInvalidPsbtFormat = errors.New("Invalid PSBT serialization format")

	// ErrDuplicateKey indicates that a passed Psbt serialization is invalid
	// due to having the same key repeated in the same key-value pair.
	ErrDuplicateKey = errors.New("Invalid Psbt due to duplicate key")

	// ErrInvalidKeyData indicates that a key-value pair in the PSBT
	// serialization contains data in the key which is not valid.
	ErrInvalidKeyData = errors.New("Invalid key data")

	// ErrInvalidMagicBytes indicates that a passed Psbt serialization is
	// invalid due to having incorrect magic bytes.
	ErrInvalidMagicBytes = errors.New("Invalid Psbt due to incorrect " +
		"magic bytes")

	// ErrInvalidRawTxSigned indicates that the raw serialized transaction
	// in the global section of the passed Psbt serialization is invalid
	// because it contains scriptSigs/witnesses (i.e. is fully or partially
	// signed), which is not allowed by BIP174.
	ErrInvalidRawTxSigned = errors.New("Invalid Psbt, raw transaction " +
		"must be unsigned.")

	// ErrInvalidPrevOutNonWitnessTransaction indicates that the transaction
	// hash (i.e. SHA256^2) of the fully serialized previous transaction
	// provided in the NonWitnessUtxo key-value field doesn't match the
	// prevout hash in the UnsignedTx field in the PSBT itself.
	ErrInvalidPrevOutNonWitnessTransaction = errors.New("Prevout hash " +
		"does not match the provided non-witness utxo serialization")

	// ErrInvalidSignatureForInput indicates that the signature the user is
	// trying to append to the PSBT is invalid, either because it does
	// not correspond to the previous transaction hash, or redeem script,
	// or witness script.
	// NOTE this does not include ECDSA signature checking.
	ErrInvalidSignatureForInput = errors.New("Signature does not " +
		"correspond to this input")

	// ErrInputAlreadyFinalized indicates that the PSBT passed to a
	// Finalizer already contains the finalized scriptSig or witness.
	ErrInputAlreadyFinalized = errors.New("Cannot finalize PSBT, " +
		"finalized scriptSig or scriptWitnes already exists")

	// ErrIncompletePSBT indicates that the Extractor object
	// was unable to successfully extract the passed Psbt struct because
	// it is not complete
	ErrIncompletePSBT = errors.New("PSBT cannot be extracted as it is " +
		"incomplete")

	// ErrNotFinalizable indicates that the PSBT struct does not have
	// sufficient data (e.g. signatures) for finalization
	ErrNotFinalizable = errors.New("PSBT is not finalizable")

	// ErrInvalidSigHashFlags indicates that a signature added to the PSBT
	// uses Sighash flags that are not in accordance with the requirement
	// according to the entry in PsbtInSighashType, or otherwise not the
	// default value (SIGHASH_ALL)
	ErrInvalidSigHashFlags = errors.New("Invalid Sighash Flags")

	// ErrUnsupportedScriptType indicates that the redeem script or
	// script witness given is not supported by this codebase, or is
	// otherwise not valid.
	ErrUnsupportedScriptType = errors.New("Unsupported script type")
)

Functions

func Extract 

func Extract(p *Packet) (*wire.MsgTx, error)

Extract takes a finalized psbt.Packet and outputs a finalized transaction instance. Note that if the PSBT is in-complete, then an error ErrIncompletePSBT will be returned. As the extracted transaction has been fully finalized, it will be ready for network broadcast once returned.

func Finalize 

func Finalize(p *Packet, inIndex int) error

Finalize assumes that the provided psbt.Packet struct has all partial signatures and redeem scripts/witness scripts already prepared for the specified input, and so removes all temporary data and replaces them with completed sigScript and witness fields, which are stored in key-types 07 and 08. The witness/non-witness utxo fields in the inputs (key-types 00 and 01) are left intact as they may be needed for validation (?). If there is any invalid or incomplete data, an error is returned.

func InPlaceSort 

func InPlaceSort(packet *Packet) error

InPlaceSort modifies the passed packet's wire TX inputs and outputs to be sorted based on BIP 69. The sorting happens in a way that the packet's partial inputs and outputs are also modified to match the sorted TxIn and TxOuts of the wire transaction.

WARNING: This function must NOT be called with packages that already contain (partial) witness data since it will mutate the transaction if it's not already sorted. This can cause issues if you mutate a tx in a block, for example, which would invalidate the block. It could also cause cached hashes, such as in a btcutil.Tx to become invalidated.

The function should only be used if the caller is creating the transaction or is otherwise 100% positive mutating will not cause adverse affects due to other dependencies.

func InputsReadyToSign added in v1.1.8 

func InputsReadyToSign(packet *Packet) error

InputsReadyToSign makes sure that all input data have the previous output specified meaning that either nonwitness UTXO or the witness UTXO data is specified in the psbt package. This check is necessary because of 2 reasons. The sighash calculation is now different for witnessV0 and witnessV1 inputs this means we need to check the previous output pkScript for the specific type and the second reason is that the sighash calculation for taproot inputs include the previous output pkscripts.

func MaybeFinalize 

func MaybeFinalize(p *Packet, inIndex int) (bool, error)

MaybeFinalize attempts to finalize the input at index inIndex in the PSBT p, returning true with no error if it succeeds, OR if the input has already been finalized.

func MaybeFinalizeAll 

func MaybeFinalizeAll(p *Packet) error

MaybeFinalizeAll attempts to finalize all inputs of the psbt.Packet that are not already finalized, and returns an error if it fails to do so.

func ReadBip32Derivation added in v1.1.7 

func ReadBip32Derivation(path []byte) (uint32, []uint32, error)

ReadBip32Derivation deserializes a byte slice containing chunks of 4 byte little endian encodings of uint32 values, the first of which is the masterkeyfingerprint and the remainder of which are the derivation path.

func SerializeBIP32Derivation 

func SerializeBIP32Derivation(masterKeyFingerprint uint32,
	bip32Path []uint32) []byte

SerializeBIP32Derivation takes a master key fingerprint as defined in BIP32, along with a path specified as a list of uint32 values, and returns a bytestring specifying the derivation in the format required by BIP174: // master key fingerprint (4) || child index (4) || child index (4) || ....

func SerializeTaprootBip32Derivation added in v1.1.7 

func SerializeTaprootBip32Derivation(d *TaprootBip32Derivation) ([]byte,
	error)

SerializeTaprootBip32Derivation serializes a TaprootBip32Derivation to its raw byte representation.

func SumUtxoInputValues 

func SumUtxoInputValues(packet *Packet) (int64, error)

SumUtxoInputValues tries to extract the sum of all inputs specified in the UTXO fields of the PSBT. An error is returned if an input is specified that does not contain any UTXO information.

func TxOutsEqual 

func TxOutsEqual(out1, out2 *wire.TxOut) bool

TxOutsEqual returns true if two transaction outputs are equal.

func VerifyInputOutputLen 

func VerifyInputOutputLen(packet *Packet, needInputs, needOutputs bool) error

VerifyInputOutputLen makes sure a packet is non-nil, contains a non-nil wire transaction and that the wire input/output lengths match the partial input/ output lengths. A caller also can specify if they expect any inputs and/or outputs to be contained in the packet.

func VerifyInputPrevOutpointsEqual 

func VerifyInputPrevOutpointsEqual(ins1, ins2 []*wire.TxIn) error

VerifyInputPrevOutpointsEqual verifies that the previous outpoints of the two slices of transaction inputs are deep equal to each other. We do the length check and manual loop to provide better error messages to the user than just returning "not equal".

func VerifyOutputsEqual 

func VerifyOutputsEqual(outs1, outs2 []*wire.TxOut) error

VerifyOutputsEqual verifies that the two slices of transaction outputs are deep equal to each other. We do the length check and manual loop to provide better error messages to the user than just returning "not equal".

func WriteTxWitness 

func WriteTxWitness(w io.Writer, wit [][]byte) error

WriteTxWitness is a utility function due to non-exported witness serialization (writeTxWitness encodes the bitcoin protocol encoding for a transaction input's witness into w).

Types

type Bip32Derivation 

type Bip32Derivation struct {
	// PubKey is the raw pubkey serialized in compressed format.
	PubKey []byte

	// MasterKeyFingerprint is the fingerprint of the master pubkey.
	MasterKeyFingerprint uint32

	// Bip32Path is the BIP 32 path with child index as a distinct integer.
	Bip32Path []uint32
}

Bip32Derivation encapsulates the data for the input and output Bip32Derivation key-value fields.

TODO(roasbeef): use hdkeychain here instead?

type Bip32Sorter 

type Bip32Sorter []*Bip32Derivation

Bip32Sorter implements sort.Interface for the Bip32Derivation struct.

func (Bip32Sorter) Len 

func (s Bip32Sorter) Len() int

func (Bip32Sorter) Less 

func (s Bip32Sorter) Less(i, j int) bool

func (Bip32Sorter) Swap 

func (s Bip32Sorter) Swap(i, j int)

type GlobalType 

type GlobalType uint8

GlobalType is the set of types that are used at the global scope level within the PSBT. 

const (
	// UnsignedTxType is the global scope key that houses the unsigned
	// transaction of the PSBT. The value is a transaction in network
	// serialization. The scriptSigs and witnesses for each input must be
	// empty. The transaction must be in the old serialization format
	// (without witnesses). A PSBT must have a transaction, otherwise it is
	// invalid.
	UnsignedTxType GlobalType = 0

	// XpubType houses a global xpub for the entire PSBT packet.
	//
	// The key ({0x01}|{xpub}) is he 78 byte serialized extended public key
	// as defined by BIP 32.  Extended public keys are those that can be
	// used to derive public keys used in the inputs and outputs of this
	// transaction. It should be the public key at the highest hardened
	// derivation index so that
	// the unhardened child keys used in the transaction can be derived.
	//
	// The value is the master key fingerprint as defined by BIP 32
	// concatenated with the derivation path of the public key. The
	// derivation path is represented as 32-bit little endian unsigned
	// integer indexes concatenated with each other. The number of 32 bit
	// unsigned integer indexes must match the depth provided in the
	// extended public key.
	XpubType GlobalType = 1

	// VersionType houses the global version number of this PSBT. There is
	// no key (only contains the byte type), then the value if omitted, is
	// assumed to be zero.
	VersionType GlobalType = 0xFB

	// ProprietaryGlobalType is used to house any proper chary global-scope
	// keys within the PSBT.
	//
	// The key is ({0xFC}|<prefix>|{subtype}|{key data}) a variable length
	// identifier prefix, followed by a subtype, followed by the key data
	// itself.
	//
	// The value is any data as defined by the proprietary type user.
	ProprietaryGlobalType = 0xFC
)

type InputType 

type InputType uint32

InputType is the set of types that are defined for each input included within the PSBT. 

const (
	// NonWitnessUtxoType has no key ({0x00}) and houses the transaction in
	// network serialization format the current input spends from. This
	// should only be present for inputs which spend non-segwit outputs.
	// However, if it is unknown whether an input spends a segwit output,
	// this type should be used. The entire input transaction is needed in
	// order to be able to verify the values of the input (pre-segwit they
	// aren't in the signature digest).
	NonWitnessUtxoType InputType = 0

	// WitnessUtxoType has no key ({0x01}), and houses the entire
	// transaction output in network serialization which the current input
	// spends from.  This should only be present for inputs which spend
	// segwit outputs, including P2SH embedded ones (value || script).
	WitnessUtxoType InputType = 1

	// PartialSigType is used to include a partial signature with key
	// ({0x02}|{public key}).
	//
	// The value is the signature as would be pushed to the stack from a
	// scriptSig or witness..
	PartialSigType InputType = 2

	// SighashType is an empty key ({0x03}).
	//
	// The value contains the 32-bit unsigned integer specifying the
	// sighash type to be used for this input. Signatures for this input
	// must use the sighash type, finalizers must fail to finalize inputs
	// which have signatures that do not match the specified sighash type.
	// Signers who cannot produce signatures with the sighash type must not
	// provide a signature.
	SighashType InputType = 3

	// RedeemScriptInputType is an empty key ({0x40}).
	//
	// The value is the redeem script of the input if present.
	RedeemScriptInputType InputType = 4

	// WitnessScriptInputType is an empty key ({0x05}).
	//
	// The value is the witness script of this input, if it has one.
	WitnessScriptInputType InputType = 5

	// Bip32DerivationInputType is a type that carries the pubkey along
	// with the key ({0x06}|{public key}).
	//
	// The value is master key fingerprint as defined by BIP 32
	// concatenated with the derivation path of the public key. The
	// derivation path is represented as 32 bit unsigned integer indexes
	// concatenated with each other. Public keys are those that will be
	// needed to sign this input.
	Bip32DerivationInputType InputType = 6

	// FinalScriptSigType is an empty key ({0x07}).
	//
	// The value contains a fully constructed scriptSig with signatures and
	// any other scripts necessary for the input to pass validation.
	FinalScriptSigType InputType = 7

	// FinalScriptWitnessType is an empty key ({0x08}). The value is a
	// fully constructed scriptWitness with signatures and any other
	// scripts necessary for the input to pass validation.
	FinalScriptWitnessType InputType = 8

	// TaprootKeySpendSignatureType is an empty key ({0x13}). The value is
	// a 64-byte Schnorr signature or a 65-byte Schnorr signature with the
	// one byte sighash type appended to it.
	TaprootKeySpendSignatureType InputType = 0x13

	// TaprootScriptSpendSignatureType is a type that carries the
	// x-only pubkey and leaf hash along with the key
	// ({0x14}|{xonlypubkey}|{leafhash}).
	//
	// The value is a 64-byte Schnorr signature or a 65-byte Schnorr
	// signature with the one byte sighash type appended to it.
	TaprootScriptSpendSignatureType InputType = 0x14

	// TaprootLeafScriptType is a type that carries the control block along
	// with the key ({0x15}|{control block}).
	//
	// The value is a script followed by a one byte unsigned integer that
	// represents the leaf version.
	TaprootLeafScriptType InputType = 0x15

	// TaprootBip32DerivationInputType is a type that carries the x-only
	// pubkey along with the key ({0x16}|{xonlypubkey}).
	//
	// The value is a compact integer denoting the number of hashes,
	// followed by said number of 32-byte leaf hashes. The rest of the value
	// is then identical to the Bip32DerivationInputType value.
	TaprootBip32DerivationInputType InputType = 0x16

	// TaprootInternalKeyInputType is an empty key ({0x17}). The value is
	// an x-only pubkey denoting the internal public key used for
	// constructing a taproot key.
	TaprootInternalKeyInputType InputType = 0x17

	// TaprootMerkleRootType is an empty key ({0x18}). The value is a
	// 32-byte hash denoting the root hash of a merkle tree of scripts.
	TaprootMerkleRootType InputType = 0x18

	// ProprietaryInputType is a custom type for use by devs.
	//
	// The key ({0xFC}|<prefix>|{subtype}|{key data}), is a Variable length
	// identifier prefix, followed by a subtype, followed by the key data
	// itself.
	//
	// The value is any value data as defined by the proprietary type user.
	ProprietaryInputType InputType = 0xFC
)

type OutputType 

type OutputType uint32

OutputType is the set of types defined per output within the PSBT. 

const (
	// RedeemScriptOutputType is an empty key ({0x00}>
	//
	// The value is the redeemScript for this output if it has one.
	RedeemScriptOutputType OutputType = 0

	// WitnessScriptOutputType is an empty key ({0x01}).
	//
	// The value is the witness script of this input, if it has one.
	WitnessScriptOutputType OutputType = 1

	// Bip32DerivationOutputType is used to communicate derivation information
	// needed to spend this output. The key is ({0x02}|{public key}).
	//
	// The value is master key fingerprint concatenated with the derivation
	// path of the public key. The derivation path is represented as 32-bit
	// little endian unsigned integer indexes concatenated with each other.
	// Public keys are those needed to spend this output.
	Bip32DerivationOutputType OutputType = 2

	// TaprootInternalKeyOutputType is an empty key ({0x05}). The value is
	// an x-only pubkey denoting the internal public key used for
	// constructing a taproot key.
	TaprootInternalKeyOutputType OutputType = 5

	// TaprootTapTreeType is an empty key ({0x06}). The value is a
	// serialized taproot tree.
	TaprootTapTreeType OutputType = 6

	// TaprootBip32DerivationOutputType is a type that carries the x-only
	// pubkey along with the key ({0x07}|{xonlypubkey}).
	//
	// The value is a compact integer denoting the number of hashes,
	// followed by said number of 32-byte leaf hashes. The rest of the value
	// is then identical to the Bip32DerivationInputType value.
	TaprootBip32DerivationOutputType OutputType = 7
)

type PInput 

type PInput struct {
	NonWitnessUtxo         *wire.MsgTx
	WitnessUtxo            *wire.TxOut
	PartialSigs            []*PartialSig
	SighashType            txscript.SigHashType
	RedeemScript           []byte
	WitnessScript          []byte
	Bip32Derivation        []*Bip32Derivation
	FinalScriptSig         []byte
	FinalScriptWitness     []byte
	TaprootKeySpendSig     []byte
	TaprootScriptSpendSig  []*TaprootScriptSpendSig
	TaprootLeafScript      []*TaprootTapLeafScript
	TaprootBip32Derivation []*TaprootBip32Derivation
	TaprootInternalKey     []byte
	TaprootMerkleRoot      []byte
	Unknowns               []*Unknown
}

PInput is a struct encapsulating all the data that can be attached to any specific input of the PSBT.

func NewPsbtInput 

func NewPsbtInput(nonWitnessUtxo *wire.MsgTx, witnessUtxo *wire.TxOut) *PInput

NewPsbtInput creates an instance of PsbtInput given either a nonWitnessUtxo or a witnessUtxo.

NOTE: Only one of the two arguments should be specified, with the other being `nil`; otherwise the created PsbtInput object will fail IsSane() checks and will not be usable.

func (*PInput) IsSane 

func (pi *PInput) IsSane() bool

IsSane returns true only if there are no conflicting values in the Psbt PInput. For segwit v0 no checks are currently implemented.

type POutput 

type POutput struct {
	RedeemScript           []byte
	WitnessScript          []byte
	Bip32Derivation        []*Bip32Derivation
	TaprootInternalKey     []byte
	TaprootTapTree         []byte
	TaprootBip32Derivation []*TaprootBip32Derivation
	Unknowns               []*Unknown
}

POutput is a struct encapsulating all the data that can be attached to any specific output of the PSBT.

func NewPsbtOutput 

func NewPsbtOutput(redeemScript []byte, witnessScript []byte,
	bip32Derivation []*Bip32Derivation) *POutput

NewPsbtOutput creates an instance of PsbtOutput; the three parameters redeemScript, witnessScript and Bip32Derivation are all allowed to be `nil`.

type Packet 

type Packet struct {
	// UnsignedTx is the decoded unsigned transaction for this PSBT.
	UnsignedTx *wire.MsgTx // Deserialization of unsigned tx

	// Inputs contains all the information needed to properly sign this
	// target input within the above transaction.
	Inputs []PInput

	// Outputs contains all information required to spend any outputs
	// produced by this PSBT.
	Outputs []POutput

	// Unknowns are the set of custom types (global only) within this PSBT.
	Unknowns []*Unknown
}

Packet is the actual psbt representation. It is a set of 1 + N + M key-value pair lists, 1 global, defining the unsigned transaction structure with N inputs and M outputs. These key-value pairs can contain scripts, signatures, key derivations and other transaction-defining data.

func New 

func New(inputs []*wire.OutPoint,
	outputs []*wire.TxOut, version int32, nLockTime uint32,
	nSequences []uint32) (*Packet, error)

New on provision of an input and output 'skeleton' for the transaction, a new partially populated PBST packet. The populated packet will include the unsigned transaction, and the set of known inputs and outputs contained within the unsigned transaction. The values of nLockTime, nSequence (per input) and transaction version (must be 1 of 2) must be specified here. Note that the default nSequence value is wire.MaxTxInSequenceNum. Referencing the PSBT BIP, this function serves the roles of teh Creator.

func NewFromRawBytes 

func NewFromRawBytes(r io.Reader, b64 bool) (*Packet, error)

NewFromRawBytes returns a new instance of a Packet struct created by reading from a byte slice. If the format is invalid, an error is returned. If the argument b64 is true, the passed byte slice is decoded from base64 encoding before processing.

NOTE: To create a Packet from one's own data, rather than reading in a serialization from a counterparty, one should use a psbt.New.

func NewFromSignedTx 

func NewFromSignedTx(tx *wire.MsgTx) (*Packet, [][]byte,
	[]wire.TxWitness, error)

NewFromSignedTx is a utility function to create a packet from an already-signed transaction. Returned are: an unsigned transaction serialization, a list of scriptSigs, one per input, and a list of witnesses, one per input.

func NewFromUnsignedTx 

func NewFromUnsignedTx(tx *wire.MsgTx) (*Packet, error)

NewFromUnsignedTx creates a new Psbt struct, without any signatures (i.e. only the global section is non-empty) using the passed unsigned transaction.

func (*Packet) B64Encode 

func (p *Packet) B64Encode() (string, error)

B64Encode returns the base64 encoding of the serialization of the current PSBT, or an error if the encoding fails.

func (*Packet) GetTxFee added in v1.1.6 

func (p *Packet) GetTxFee() (btcutil.Amount, error)

GetTxFee returns the transaction fee. An error is returned if a transaction input does not contain any UTXO information.

func (*Packet) IsComplete 

func (p *Packet) IsComplete() bool

IsComplete returns true only if all of the inputs are finalized; this is particularly important in that it decides whether the final extraction to a network serialized signed transaction will be possible.

func (*Packet) SanityCheck 

func (p *Packet) SanityCheck() error

SanityCheck checks conditions on a PSBT to ensure that it obeys the rules of BIP174, and returns true if so, false if not.

func (*Packet) Serialize 

func (p *Packet) Serialize(w io.Writer) error

Serialize creates a binary serialization of the referenced Packet struct with lexicographical ordering (by key) of the subsections.

type PartialSig 

type PartialSig struct {
	PubKey    []byte
	Signature []byte
}

PartialSig encapsulate a (BTC public key, ECDSA signature) pair, note that the fields are stored as byte slices, not btcec.PublicKey or btcec.Signature (because manipulations will be with the former not the latter, here); compliance with consensus serialization is enforced with .checkValid()

type PartialSigSorter 

type PartialSigSorter []*PartialSig

PartialSigSorter implements sort.Interface for PartialSig.

func (PartialSigSorter) Len 

func (s PartialSigSorter) Len() int

func (PartialSigSorter) Less 

func (s PartialSigSorter) Less(i, j int) bool

func (PartialSigSorter) Swap 

func (s PartialSigSorter) Swap(i, j int)

type SignOutcome 

type SignOutcome int

SignOutcome is a enum-like value that expresses the outcome of a call to the Sign method.

type TaprootBip32Derivation added in v1.1.4 

type TaprootBip32Derivation struct {
	// XOnlyPubKey is the raw public key serialized in the x-only BIP-340
	// format.
	XOnlyPubKey []byte

	// LeafHashes is a list of leaf hashes that the given public key is
	// involved in.
	LeafHashes [][]byte

	// MasterKeyFingerprint is the fingerprint of the master pubkey.
	MasterKeyFingerprint uint32

	// Bip32Path is the BIP 32 path with child index as a distinct integer.
	Bip32Path []uint32
}

TaprootBip32Derivation encapsulates the data for the input and output taproot specific BIP-32 derivation key-value fields.

func ReadTaprootBip32Derivation added in v1.1.7 

func ReadTaprootBip32Derivation(xOnlyPubKey,
	value []byte) (*TaprootBip32Derivation, error)

ReadTaprootBip32Derivation deserializes a byte slice containing the Taproot BIP32 derivation info that consists of a list of leaf hashes as well as the normal BIP32 derivation info.

func (*TaprootBip32Derivation) SortBefore added in v1.1.4 

func (s *TaprootBip32Derivation) SortBefore(other *TaprootBip32Derivation) bool

SortBefore returns true if this derivation info's key is lexicographically smaller than the given other derivation info's key and should come first when being sorted.

type TaprootScriptSpendSig added in v1.1.4 

type TaprootScriptSpendSig struct {
	XOnlyPubKey []byte
	LeafHash    []byte
	Signature   []byte
	SigHash     txscript.SigHashType
}

TaprootScriptSpendSig encapsulates an individual Schnorr signature for a given public key and leaf hash.

func (*TaprootScriptSpendSig) EqualKey added in v1.1.4 

func (s *TaprootScriptSpendSig) EqualKey(other *TaprootScriptSpendSig) bool

EqualKey returns true if this script spend signature's key data is the same as the given script spend signature.

func (*TaprootScriptSpendSig) SortBefore added in v1.1.4 

func (s *TaprootScriptSpendSig) SortBefore(other *TaprootScriptSpendSig) bool

SortBefore returns true if this script spend signature's key is lexicographically smaller than the given other script spend signature's key and should come first when being sorted.

type TaprootTapLeafScript added in v1.1.4 

type TaprootTapLeafScript struct {
	ControlBlock []byte
	Script       []byte
	LeafVersion  txscript.TapscriptLeafVersion
}

TaprootTapLeafScript represents a single taproot leaf script that is identified by its control block.

func FindLeafScript added in v1.1.4 

func FindLeafScript(pInput *PInput,
	targetLeafHash []byte) (*TaprootTapLeafScript, error)

FindLeafScript attempts to locate the leaf script of a given target Tap Leaf hash in the list of leaf scripts of the given input.

func (*TaprootTapLeafScript) SortBefore added in v1.1.4 

func (s *TaprootTapLeafScript) SortBefore(other *TaprootTapLeafScript) bool

SortBefore returns true if this leaf script's key is lexicographically smaller than the given other leaf script's key and should come first when being sorted.

type Unknown 

type Unknown struct {
	Key   []byte
	Value []byte
}

Unknown is a struct encapsulating a key-value pair for which the key type is unknown by this package; these fields are allowed in both the 'Global' and the 'Input' section of a PSBT.

type Updater 

type Updater struct {
	Upsbt *Packet
}

Updater encapsulates the role 'Updater' as specified in BIP174; it accepts Psbt structs and has methods to add fields to the inputs and outputs.

func NewUpdater 

func NewUpdater(p *Packet) (*Updater, error)

NewUpdater returns a new instance of Updater, if the passed Psbt struct is in a valid form, else an error.

func (*Updater) AddInBip32Derivation 

func (u *Updater) AddInBip32Derivation(masterKeyFingerprint uint32,
	bip32Path []uint32, pubKeyData []byte, inIndex int) error

AddInBip32Derivation takes a master key fingerprint as defined in BIP32, a BIP32 path as a slice of uint32 values, and a serialized pubkey as a byte slice, along with the integer index of the input, and inserts this data into that input.

NOTE: This can be called multiple times for the same input. An error is returned if addition of this key-value pair to the Psbt fails.

func (*Updater) AddInNonWitnessUtxo 

func (u *Updater) AddInNonWitnessUtxo(tx *wire.MsgTx, inIndex int) error

AddInNonWitnessUtxo adds the utxo information for an input which is non-witness. This requires provision of a full transaction (which is the source of the corresponding prevOut), and the input index. If addition of this key-value pair to the Psbt fails, an error is returned.

func (*Updater) AddInRedeemScript 

func (u *Updater) AddInRedeemScript(redeemScript []byte,
	inIndex int) error

AddInRedeemScript adds the redeem script information for an input. The redeem script is passed serialized, as a byte slice, along with the index of the input. An error is returned if addition of this key-value pair to the Psbt fails.

func (*Updater) AddInSighashType 

func (u *Updater) AddInSighashType(sighashType txscript.SigHashType,
	inIndex int) error

AddInSighashType adds the sighash type information for an input. The sighash type is passed as a 32 bit unsigned integer, along with the index for the input. An error is returned if addition of this key-value pair to the Psbt fails.

func (*Updater) AddInWitnessScript 

func (u *Updater) AddInWitnessScript(witnessScript []byte,
	inIndex int) error

AddInWitnessScript adds the witness script information for an input. The witness script is passed serialized, as a byte slice, along with the index of the input. An error is returned if addition of this key-value pair to the Psbt fails.

func (*Updater) AddInWitnessUtxo 

func (u *Updater) AddInWitnessUtxo(txout *wire.TxOut, inIndex int) error

AddInWitnessUtxo adds the utxo information for an input which is witness. This requires provision of a full transaction *output* (which is the source of the corresponding prevOut); not the full transaction because BIP143 means the output information is sufficient, and the input index. If addition of this key-value pair to the Psbt fails, an error is returned.

func (*Updater) AddOutBip32Derivation 

func (u *Updater) AddOutBip32Derivation(masterKeyFingerprint uint32,
	bip32Path []uint32, pubKeyData []byte, outIndex int) error

AddOutBip32Derivation takes a master key fingerprint as defined in BIP32, a BIP32 path as a slice of uint32 values, and a serialized pubkey as a byte slice, along with the integer index of the output, and inserts this data into that output.

NOTE: That this can be called multiple times for the same output. An error is returned if addition of this key-value pair to the Psbt fails.

func (*Updater) AddOutRedeemScript 

func (u *Updater) AddOutRedeemScript(redeemScript []byte,
	outIndex int) error

AddOutRedeemScript takes a redeem script as a byte slice and appends it to the output at index outIndex.

func (*Updater) AddOutWitnessScript 

func (u *Updater) AddOutWitnessScript(witnessScript []byte,
	outIndex int) error

AddOutWitnessScript takes a witness script as a byte slice and appends it to the output at index outIndex.

func (*Updater) Sign 

func (u *Updater) Sign(inIndex int, sig []byte, pubKey []byte,
	redeemScript []byte, witnessScript []byte) (SignOutcome, error)

Sign allows the caller to sign a PSBT at a particular input; they must provide a signature and a pubkey, both as byte slices; they can also optionally provide both witnessScript and/or redeemScript, otherwise these arguments must be set as nil (and in that case, they must already be present in the PSBT if required for signing to succeed).

This serves as a wrapper around Updater.addPartialSignature; it ensures that the redeemScript and witnessScript are updated as needed (note that the Updater is allowed to add redeemScripts and witnessScripts independently, before signing), and ensures that the right form of utxo field (NonWitnessUtxo or WitnessUtxo) is included in the input so that signature insertion (and then finalization) can take place.

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.