Bitcoin Core 31.99.0
P2P Digital Currency
psbt.cpp
Go to the documentation of this file.
1// Copyright (c) 2019-present The Bitcoin Core developers
2// Distributed under the MIT software license, see the accompanying
3// file COPYING or http://www.opensource.org/licenses/mit-license.php.
4
5#include <node/psbt.h>
6#include <psbt.h>
7#include <pubkey.h>
8#include <script/script.h>
9#include <streams.h>
11#include <test/fuzz/fuzz.h>
12#include <test/util/random.h>
13#include <util/check.h>
14
15#include <cstdint>
16#include <optional>
17#include <string>
18#include <vector>
19
23
25{
27 FuzzedDataProvider fuzzed_data_provider{buffer.data(), buffer.size()};
30 if (!psbt_res) {
31 return;
32 }
33 PartiallySignedTransaction psbt_mut = *psbt_res;
34 const PartiallySignedTransaction psbt = psbt_mut;
35
36 // We are on purpose not forward compatible, and version 1 is disabled.
37 const auto psbt_version{psbt.GetVersion()};
38 Assert(psbt_version == 0 || psbt_version == 2);
39
40 // A PSBT must roundtrip.
41 std::vector<uint8_t> psbt_ser;
42 VectorWriter{psbt_ser, 0, psbt};
43 SpanReader reader{psbt_ser};
44 PartiallySignedTransaction psbt_roundtrip(deserialize, reader);
45
46 // And be stable across roundtrips.
47 std::vector<uint8_t> roundtrip_ser;
48 VectorWriter{roundtrip_ser, 0, psbt_roundtrip};
49 Assert(psbt_ser == roundtrip_ser);
50
51 const PSBTAnalysis analysis = AnalyzePSBT(psbt);
52 (void)PSBTRoleName(analysis.next);
53 for (const PSBTInputAnalysis& input_analysis : analysis.inputs) {
54 (void)PSBTRoleName(input_analysis.next);
55 }
56
57 (void)psbt.IsNull();
58 (void)psbt.GetUnsignedTx();
59
60 for (const PSBTInput& input : psbt.inputs) {
61 (void)PSBTInputSigned(input);
62 (void)input.IsNull();
63 PSBTInput input_mod = input;
64 CTxOut tx_out;
65 if (input.GetUTXO(tx_out)) {
66 (void)tx_out.IsNull();
67 (void)tx_out.ToString();
68 }
69 // A PSBT input must roundtrip to signature data.
70 PSBTInput input_fill{psbt_version, input_mod.prev_txid, input_mod.prev_out, input_mod.sequence};
71 SignatureData sig_data;
72 input_mod.FillSignatureData(sig_data);
73 input_fill.FromSignatureData(sig_data);
74
75 // Only final_script_sig and final_script_witness are filled when sigdata is complete
76 if (sig_data.complete) {
77 Assert(input_mod.final_script_sig == input_fill.final_script_sig);
78 Assert(input_mod.final_script_witness == input_fill.final_script_witness);
79 } else {
80 // UTXOs don't go into SignatureData
81 input_mod.non_witness_utxo.reset();
82 input_mod.witness_utxo.SetNull();
83 // Sighash type doesn't go into SignatureData
84 input_mod.sighash_type.reset();
85 // Timelocks don't go into SignatureData
86 input_mod.time_locktime.reset();
87 input_mod.height_locktime.reset();
88 // Proprietary fields are not included in SignatureData
89 input_mod.m_proprietary.clear();
90 // Unknown fields are not included in SignatureData
91 input_mod.unknown.clear();
92
93 Assert(input_mod == input_fill);
94 }
95 }
96 (void)CountPSBTUnsignedInputs(psbt);
97
98 for (const PSBTOutput& output : psbt.outputs) {
99 (void)output.IsNull();
100 PSBTOutput output_mod = output;
101 // A PSBT output must roundtrip to signature data.
102 PSBTOutput output_fill{psbt_version, output_mod.amount, output_mod.script};
103 SignatureData sig_data;
104 output_mod.FillSignatureData(sig_data);
105 output_fill.FromSignatureData(sig_data);
106
107 // FillSignatureData will not fill tap tree or internal key if the tree is empty or
108 // the key is not fully valid. These need to be cleared before checking for equivalence
109 if (output_mod.m_tap_tree.empty() || !output_mod.m_tap_internal_key.IsFullyValid()) {
110 output_mod.m_tap_tree.clear();
111 std::fill(output_mod.m_tap_internal_key.begin(), output_mod.m_tap_internal_key.end(), 0);
112 }
113 // Sort m_tap_tree to ensure the vectors match
114 std::sort(output_mod.m_tap_tree.begin(), output_mod.m_tap_tree.end());
115 std::sort(output_fill.m_tap_tree.begin(), output_fill.m_tap_tree.end());
116 // Proprietary fields are not included in SignatureData
117 output_mod.m_proprietary.clear();
118 // Unknown fields are not included in SignatureData
119 output_mod.unknown.clear();
120
121 Assert(output_mod.m_tap_internal_key == output_fill.m_tap_internal_key);
122 Assert(output_mod == output_fill);
123 }
124
125 psbt_mut = psbt;
126 (void)FinalizePSBT(psbt_mut);
127
128 psbt_mut = psbt;
129 CMutableTransaction result;
130 if (FinalizeAndExtractPSBT(psbt_mut, result)) {
131 const PartiallySignedTransaction psbt_from_tx{result};
132 }
133
134 PartiallySignedTransaction psbt_merge = psbt;
137 if (psbt_merge_res) {
138 psbt_merge = *psbt_merge_res;
139 }
140 psbt_mut = psbt;
141 (void)psbt_mut.Merge(psbt_merge);
142 psbt_mut = psbt;
143 std::optional<PartiallySignedTransaction> comb_res = CombinePSBTs({psbt_mut, psbt_merge});
144 if (comb_res) {
145 psbt_mut = *comb_res;
146 }
147 for (const auto& psbt_in : psbt_merge.inputs) {
148 (void)psbt_mut.AddInput(psbt_in);
149 }
150 for (const auto& psbt_out : psbt_merge.outputs) {
151 (void)psbt_mut.AddOutput(psbt_out);
152 }
153 psbt_mut.unknown.insert(psbt_merge.unknown.begin(), psbt_merge.unknown.end());
154
156}
#define Assert(val)
Identity function.
Definition: check.h:116
An output of a transaction.
Definition: transaction.h:140
void SetNull()
Definition: transaction.h:154
bool IsNull() const
Definition: transaction.h:160
std::string ToString() const
Definition: transaction.cpp:61
std::string ConsumeRandomLengthString(size_t max_length)
A structure for PSBTs which contain per-input information.
Definition: psbt.h:280
CScriptWitness final_script_witness
Definition: psbt.h:290
std::optional< uint32_t > sequence
Definition: psbt.h:300
bool GetUTXO(CTxOut &utxo) const
Retrieves the UTXO for this input.
Definition: psbt.cpp:269
CTransactionRef non_witness_utxo
Definition: psbt.h:285
Txid prev_txid
Definition: psbt.h:298
std::optional< int > sighash_type
Definition: psbt.h:321
std::optional< uint32_t > time_locktime
Definition: psbt.h:301
void FillSignatureData(SignatureData &sigdata) const
Definition: psbt.cpp:297
bool IsNull() const
Definition: psbt.cpp:292
uint32_t prev_out
Definition: psbt.h:299
std::set< PSBTProprietary > m_proprietary
Definition: psbt.h:320
CScript final_script_sig
Definition: psbt.h:289
std::optional< uint32_t > height_locktime
Definition: psbt.h:302
std::map< std::vector< unsigned char >, std::vector< unsigned char > > unknown
Definition: psbt.h:319
CTxOut witness_utxo
Definition: psbt.h:286
A structure for PSBTs which contains per output information.
Definition: psbt.h:938
XOnlyPubKey m_tap_internal_key
Definition: psbt.h:947
bool IsNull() const
Definition: psbt.cpp:531
std::set< PSBTProprietary > m_proprietary
Definition: psbt.h:953
CAmount amount
Definition: psbt.h:955
CScript script
Definition: psbt.h:956
std::vector< std::tuple< uint8_t, uint8_t, std::vector< unsigned char > > > m_tap_tree
Definition: psbt.h:948
std::map< std::vector< unsigned char >, std::vector< unsigned char > > unknown
Definition: psbt.h:952
void FillSignatureData(SignatureData &sigdata) const
Definition: psbt.cpp:477
A version of CTransaction with the PSBT format.
Definition: psbt.h:1239
uint32_t GetVersion() const
Definition: psbt.cpp:887
bool Merge(const PartiallySignedTransaction &psbt)
Merge psbt into this.
Definition: psbt.cpp:39
bool IsNull() const
Definition: psbt.cpp:34
std::map< std::vector< unsigned char >, std::vector< unsigned char > > unknown
Definition: psbt.h:1250
std::vector< PSBTInput > inputs
Definition: psbt.h:1248
std::optional< CMutableTransaction > GetUnsignedTx() const
Definition: psbt.cpp:122
std::vector< PSBTOutput > outputs
Definition: psbt.h:1249
bool AddOutput(const PSBTOutput &psbtout)
Definition: psbt.cpp:246
bool AddInput(const PSBTInput &psbtin)
Definition: psbt.cpp:163
Minimal stream for reading from an existing byte array by std::span.
Definition: streams.h:83
const unsigned char * end() const
Definition: pubkey.h:296
const unsigned char * begin() const
Definition: pubkey.h:295
bool IsFullyValid() const
Determine if this pubkey is fully valid.
Definition: pubkey.cpp:230
PSBTAnalysis AnalyzePSBT(PartiallySignedTransaction psbtx)
Provides helpful miscellaneous information about where a PSBT is in the signing workflow.
Definition: psbt.cpp:16
std::string PSBTRoleName(PSBTRole role)
Definition: psbt.cpp:853
std::optional< PartiallySignedTransaction > CombinePSBTs(const std::vector< PartiallySignedTransaction > &psbtxs)
Combines PSBTs with the same underlying transaction, resulting in a single PSBT with all partial sign...
Definition: psbt.cpp:840
void RemoveUnnecessaryTransactions(PartiallySignedTransaction &psbtx)
Reduces the size of the PSBT by dropping unnecessary non_witness_utxos (i.e.
Definition: psbt.cpp:763
size_t CountPSBTUnsignedInputs(const PartiallySignedTransaction &psbt)
Counts the unsigned inputs of a PSBT.
Definition: psbt.cpp:591
bool FinalizeAndExtractPSBT(PartiallySignedTransaction &psbtx, CMutableTransaction &result)
Finalizes a PSBT if possible, and extracts it to a CMutableTransaction if it could be finalized.
Definition: psbt.cpp:820
bool PSBTInputSigned(const PSBTInput &input)
Checks whether a PSBTInput is already signed by checking for non-null finalized fields.
Definition: psbt.cpp:552
bool FinalizePSBT(PartiallySignedTransaction &psbtx)
Finalizes a PSBT if possible, combining partial signatures.
Definition: psbt.cpp:800
util::Result< PartiallySignedTransaction > DecodeRawPSBT(std::span< const std::byte > tx_data)
Decode a raw (binary blob) PSBT into a PartiallySignedTransaction.
Definition: psbt.cpp:873
constexpr deserialize_type deserialize
Definition: serialize.h:51
auto MakeByteSpan(const V &v) noexcept
Definition: span.h:84
A mutable version of CTransaction.
Definition: transaction.h:358
bool complete
Stores whether the scriptSig and scriptWitness are complete.
Definition: sign.h:82
Holds the results of AnalyzePSBT (miscellaneous information about a PSBT)
Definition: psbt.h:30
std::vector< PSBTInputAnalysis > inputs
More information about the individual inputs of the transaction.
Definition: psbt.h:34
PSBTRole next
Which of the BIP 174 roles needs to handle the transaction next.
Definition: psbt.h:35
Holds an analysis of one input from a PSBT.
Definition: psbt.h:16
PSBTRole next
Which of the BIP 174 roles needs to handle this input next.
Definition: psbt.h:19
FUZZ_TARGET(psbt)
Definition: psbt.cpp:24
void SeedRandomStateForTest(SeedRand seedtype)
Seed the global RNG state for testing and log the seed value.
Definition: random.cpp:19
@ ZEROS
Seed with a compile time constant of zeros.
FuzzedDataProvider & fuzzed_data_provider
Definition: fees.cpp:39