Branch data Line data Source code
1 : : // Copyright (c) 2010 Satoshi Nakamoto
2 : : // Copyright (c) 2009-present The Bitcoin Core developers
3 : : // Distributed under the MIT software license, see the accompanying
4 : : // file COPYING or http://www.opensource.org/licenses/mit-license.php.
5 : :
6 : : #include <rpc/register.h> // IWYU pragma: associated
7 : :
8 : : #include <addresstype.h>
9 : : #include <base58.h>
10 : : #include <chain.h>
11 : : #include <coins.h>
12 : : #include <common/types.h>
13 : : #include <consensus/amount.h>
14 : : #include <core_io.h>
15 : : #include <crypto/common.h>
16 : : #include <crypto/hex_base.h>
17 : : #include <hash.h>
18 : : #include <index/txindex.h>
19 : : #include <kernel/chainparams.h>
20 : : #include <key.h>
21 : : #include <key_io.h>
22 : : #include <node/blockstorage.h>
23 : : #include <node/coin.h>
24 : : #include <node/context.h>
25 : : #include <node/psbt.h>
26 : : #include <node/transaction.h>
27 : : #include <policy/feerate.h>
28 : : #include <primitives/block.h>
29 : : #include <primitives/transaction.h>
30 : : #include <psbt.h>
31 : : #include <pubkey.h>
32 : : #include <random.h>
33 : : #include <rpc/protocol.h>
34 : : #include <rpc/rawtransaction_util.h>
35 : : #include <rpc/request.h>
36 : : #include <rpc/server.h>
37 : : #include <rpc/server_util.h>
38 : : #include <rpc/util.h>
39 : : #include <script/interpreter.h>
40 : : #include <script/keyorigin.h>
41 : : #include <script/script.h>
42 : : #include <script/sign.h>
43 : : #include <script/signingprovider.h>
44 : : #include <script/solver.h>
45 : : #include <serialize.h>
46 : : #include <streams.h>
47 : : #include <sync.h>
48 : : #include <tinyformat.h>
49 : : #include <txmempool.h>
50 : : #include <uint256.h>
51 : : #include <undo.h>
52 : : #include <univalue.h>
53 : : #include <util/bip32.h>
54 : : #include <util/check.h>
55 : : #include <util/expected.h>
56 : : #include <util/result.h>
57 : : #include <util/strencodings.h>
58 : : #include <util/translation.h>
59 : : #include <util/vector.h>
60 : : #include <validation.h>
61 : :
62 : : #include <algorithm>
63 : : #include <any>
64 : : #include <bitset>
65 : : #include <cstddef>
66 : : #include <cstdint>
67 : : #include <map>
68 : : #include <memory>
69 : : #include <optional>
70 : : #include <set>
71 : : #include <span>
72 : : #include <tuple>
73 : : #include <utility>
74 : : #include <vector>
75 : :
76 : : using node::AnalyzePSBT;
77 : : using node::FindCoins;
78 : : using node::GetTransaction;
79 : : using node::NodeContext;
80 : : using node::PSBTAnalysis;
81 : :
82 : : static constexpr decltype(CTransaction::version) DEFAULT_RAWTX_VERSION{CTransaction::CURRENT_VERSION};
83 : :
84 : 3399 : static void TxToJSON(const CTransaction& tx, const uint256 hashBlock, UniValue& entry,
85 : : Chainstate& active_chainstate, const CTxUndo* txundo = nullptr,
86 : : TxVerbosity verbosity = TxVerbosity::SHOW_DETAILS)
87 : : {
88 : 3399 : CHECK_NONFATAL(verbosity >= TxVerbosity::SHOW_DETAILS);
89 : : // Call into TxToUniv() in bitcoin-common to decode the transaction hex.
90 : : //
91 : : // Blockchain contextual information (confirmations and blocktime) is not
92 : : // available to code in bitcoin-common, so we query them here and push the
93 : : // data into the returned UniValue.
94 [ + - ]: 3399 : TxToUniv(tx, /*block_hash=*/uint256(), entry, /*include_hex=*/true, txundo, verbosity);
95 : :
96 [ + + ]: 6798 : if (!hashBlock.IsNull()) {
97 : 54 : LOCK(cs_main);
98 : :
99 [ + - + - : 108 : entry.pushKV("blockhash", hashBlock.GetHex());
+ - + - ]
100 [ + - ]: 54 : const CBlockIndex* pindex = active_chainstate.m_blockman.LookupBlockIndex(hashBlock);
101 [ + - ]: 54 : if (pindex) {
102 [ + + ]: 54 : if (active_chainstate.m_chain.Contains(*pindex)) {
103 [ - + + - : 100 : entry.pushKV("confirmations", 1 + active_chainstate.m_chain.Height() - pindex->nHeight);
+ - + - ]
104 [ + - + - : 100 : entry.pushKV("time", pindex->GetBlockTime());
+ - ]
105 [ + - + - : 100 : entry.pushKV("blocktime", pindex->GetBlockTime());
+ - ]
106 : : }
107 : : else
108 [ + - + - : 8 : entry.pushKV("confirmations", 0);
+ - ]
109 : : }
110 : 54 : }
111 : 3399 : }
112 : :
113 : 5662 : static std::vector<RPCArg> CreateTxDoc()
114 : : {
115 : 5662 : return {
116 [ + - + - ]: 11324 : {"inputs", RPCArg::Type::ARR, RPCArg::Optional::NO, "The inputs",
117 : : {
118 [ + - + - ]: 11324 : {"", RPCArg::Type::OBJ, RPCArg::Optional::OMITTED, "",
119 : : {
120 [ + - + - ]: 11324 : {"txid", RPCArg::Type::STR_HEX, RPCArg::Optional::NO, "The transaction id"},
121 [ + - + - ]: 11324 : {"vout", RPCArg::Type::NUM, RPCArg::Optional::NO, "The output number"},
122 [ + - + - : 16986 : {"sequence", RPCArg::Type::NUM, RPCArg::DefaultHint{"depends on the value of the 'replaceable' and 'locktime' arguments"}, "The sequence number"},
+ - ]
123 : : },
124 : : },
125 : : },
126 : : },
127 [ + - + - ]: 11324 : {"outputs", RPCArg::Type::ARR, RPCArg::Optional::NO, "The outputs specified as key-value pairs.\n"
128 : : "Each key may only appear once, i.e. there can only be one 'data' output, and no address may be duplicated.\n"
129 : : "At least one output of either type must be specified.\n"
130 : : "For compatibility reasons, a dictionary, which holds the key-value pairs directly, is also\n"
131 : : " accepted as second parameter.",
132 : : {
133 [ + - + - ]: 11324 : {"", RPCArg::Type::OBJ_USER_KEYS, RPCArg::Optional::OMITTED, "",
134 : : {
135 [ + - + - ]: 11324 : {"address", RPCArg::Type::AMOUNT, RPCArg::Optional::NO, "A key-value pair. The key (string) is the bitcoin address, the value (float or string) is the amount in " + CURRENCY_UNIT},
136 : : },
137 : : },
138 [ + - + - ]: 11324 : {"", RPCArg::Type::OBJ, RPCArg::Optional::OMITTED, "",
139 : : {
140 [ + - + - ]: 11324 : {"data", RPCArg::Type::STR_HEX, RPCArg::Optional::NO, "A key-value pair. The key must be \"data\", the value is hex-encoded data that becomes a part of an OP_RETURN output"},
141 : : },
142 : : },
143 : : },
144 [ + - ]: 5662 : RPCArgOptions{.skip_type_check = true}},
145 [ + - + - : 16986 : {"locktime", RPCArg::Type::NUM, RPCArg::Default{0}, "Raw locktime. Non-0 value also locktime-activates inputs"},
+ - ]
146 [ + - + - : 16986 : {"replaceable", RPCArg::Type::BOOL, RPCArg::Default{true}, "Marks this transaction as BIP125-replaceable.\n"
+ - ]
147 : : "Allows this transaction to be replaced by a transaction with higher fees. If provided, it is an error if explicit sequence numbers are incompatible."},
148 [ + - + - : 16986 : {"version", RPCArg::Type::NUM, RPCArg::Default{DEFAULT_RAWTX_VERSION}, "Transaction version"},
+ - ]
149 [ + - + - : 147212 : };
+ - + - +
- + - + +
+ + + + +
+ + + + +
- - - - -
- - - - -
- - ]
150 [ + - + - : 141550 : }
+ - + - +
- + - + -
+ - + - +
- + - + -
+ - - - -
- - - ]
151 : :
152 : : // Update PSBT with information from the mempool, the UTXO set, the txindex, and the provided descriptors.
153 : : // Optionally, sign the inputs that we can using information from the descriptors.
154 : 25 : PartiallySignedTransaction ProcessPSBT(const std::string& psbt_string, const std::any& context, const HidingSigningProvider& provider, std::optional<int> sighash_type, bool finalize)
155 : : {
156 : : // Unserialize the transactions
157 : 25 : util::Result<PartiallySignedTransaction> psbt_res = DecodeBase64PSBT(psbt_string);
158 [ - + ]: 25 : if (!psbt_res) {
159 [ # # # # : 0 : throw JSONRPCError(RPC_DESERIALIZATION_ERROR, strprintf("TX decode failed %s", util::ErrorString(psbt_res).original));
# # ]
160 : : }
161 [ + - ]: 25 : PartiallySignedTransaction psbtx = *psbt_res;
162 : :
163 [ - + - - ]: 25 : if (g_txindex) g_txindex->BlockUntilSyncedToCurrentChain();
164 [ + - ]: 25 : const NodeContext& node = EnsureAnyNodeContext(context);
165 : :
166 : : // If we can't find the corresponding full transaction for all of our inputs,
167 : : // this will be used to find just the utxos for the segwit inputs for which
168 : : // the full transaction isn't found
169 : 25 : std::map<COutPoint, Coin> coins;
170 : :
171 : : // Fetch previous transactions:
172 : : // First, look in the txindex and the mempool
173 [ + + ]: 63 : for (PSBTInput& psbt_input : psbtx.inputs) {
174 : : // The `non_witness_utxo` is the whole previous transaction
175 [ + + ]: 38 : if (psbt_input.non_witness_utxo) continue;
176 : :
177 : 24 : CTransactionRef tx;
178 : :
179 : : // Look in the txindex
180 [ - + ]: 24 : if (g_txindex) {
181 [ # # # # ]: 0 : if (auto result{g_txindex->FindTx(psbt_input.prev_txid)}) tx = result->tx;
182 : : }
183 : : // If we still don't have it look in the mempool
184 [ + - ]: 24 : if (!tx) {
185 [ + - - + ]: 48 : tx = node.mempool->get(psbt_input.prev_txid);
186 : : }
187 [ + + ]: 24 : if (tx) {
188 : 10 : psbt_input.non_witness_utxo = tx;
189 : : } else {
190 [ + - + - ]: 14 : coins[psbt_input.GetOutPoint()]; // Create empty map entry keyed by prevout
191 : : }
192 : 24 : }
193 : :
194 : : // If we still haven't found all of the inputs, look for the missing ones in the utxo set
195 [ + + ]: 25 : if (!coins.empty()) {
196 [ + - ]: 5 : FindCoins(node, coins);
197 [ + + ]: 19 : for (PSBTInput& input : psbtx.inputs) {
198 : : // If there are still missing utxos, add them if they were found in the utxo set
199 [ + - ]: 14 : if (!input.non_witness_utxo) {
200 [ + - + - ]: 14 : const Coin& coin = coins.at(input.GetOutPoint());
201 [ + + + - : 14 : if (!coin.out.IsNull() && IsSegWitOutput(provider, coin.out.scriptPubKey)) {
+ - ]
202 : 12 : input.witness_utxo = coin.out;
203 : : }
204 : : }
205 : : }
206 : : }
207 : :
208 [ + - ]: 25 : std::optional<PrecomputedTransactionData> txdata_res = PrecomputePSBTData(psbtx);
209 [ - + ]: 25 : if (!txdata_res) {
210 [ # # ]: 0 : throw JSONRPCPSBTError(common::PSBTError::INVALID_TX);
211 : : }
212 : : const PrecomputedTransactionData& txdata = *txdata_res;
213 : :
214 [ - + + + ]: 56 : for (unsigned int i = 0; i < psbtx.inputs.size(); ++i) {
215 [ + - + - : 38 : if (PSBTInputSigned(psbtx.inputs.at(i))) {
+ + ]
216 : 5 : continue;
217 : : }
218 : :
219 : : // Update script/keypath information using descriptor data.
220 : : // Note that SignPSBTInput does a lot more than just constructing ECDSA signatures.
221 : : // We only actually care about those if our signing provider doesn't hide private
222 : : // information, as is the case with `descriptorprocesspsbt`
223 : : // Only error for mismatching sighash types as it is critical that the sighash to sign with matches the PSBT's
224 [ + - ]: 33 : const auto sign_result = SignPSBTInput(provider, psbtx, /*index=*/i, &txdata, {.sighash_type = sighash_type, .finalize = finalize}, /*out_sigdata=*/nullptr);
225 [ + + + + ]: 33 : if (!sign_result.has_value() && sign_result.error() == common::PSBTError::SIGHASH_MISMATCH) {
226 [ + - ]: 7 : throw JSONRPCPSBTError(common::PSBTError::SIGHASH_MISMATCH);
227 : : }
228 : : }
229 : :
230 : : // Update script/keypath information using descriptor data.
231 [ - + + + ]: 47 : for (unsigned int i = 0; i < psbtx.outputs.size(); ++i) {
232 [ + - ]: 29 : UpdatePSBTOutput(provider, psbtx, i);
233 : : }
234 : :
235 [ + - ]: 18 : RemoveUnnecessaryTransactions(psbtx);
236 : :
237 : 18 : return psbtx;
238 : 32 : }
239 : :
240 : 6047 : static RPCMethod getrawtransaction()
241 : : {
242 : 6047 : const std::vector<RPCResult> verbosity_1_block{
243 [ + - + - ]: 12094 : {RPCResult::Type::BOOL, "in_active_chain", /*optional=*/true, "Whether specified block is in the active chain or not (only present with explicit \"blockhash\" argument)"},
244 [ + - + - ]: 12094 : {RPCResult::Type::STR_HEX, "blockhash", /*optional=*/true, "the block hash"},
245 [ + - + - ]: 12094 : {RPCResult::Type::NUM, "vsize_adjusted", /*optional=*/true, "Sigop-adjusted virtual size in bytes, present for mempool transactions."},
246 [ + - + - ]: 12094 : {RPCResult::Type::NUM, "confirmations", /*optional=*/true, "The confirmations"},
247 [ + - + - ]: 12094 : {RPCResult::Type::NUM_TIME, "blocktime", /*optional=*/true, "The block time expressed in " + UNIX_EPOCH_TIME},
248 [ + - + - ]: 12094 : {RPCResult::Type::NUM, "time", /*optional=*/true, "Same as \"blocktime\""},
249 [ + - + - ]: 12094 : {RPCResult::Type::STR_HEX, "hex", "The serialized, hex-encoded data for 'txid'"},
250 [ + - + + : 96752 : };
- - ]
251 : 6047 : const auto v2_extras = Cat<std::vector<RPCResult>>(
252 : 6047 : std::vector<RPCResult>{{
253 [ + - ]: 6047 : RPCResult::Type::NUM, "fee", /*optional=*/true,
254 [ + - ]: 12094 : "transaction fee in " + CURRENCY_UNIT + ", omitted if block undo data is not available"
255 [ + - + + : 24188 : }},
- - ]
256 : 6047 : TxDoc({.elision_mode = ElisionMode::Silent,
257 : : .prevout = true,
258 : : .prevout_optional = true,
259 [ + - ]: 6047 : .vin_inner_elision = "Same vin fields as verbosity = 1"}));
260 : 6047 : return RPCMethod{
261 [ + - ]: 6047 : "getrawtransaction",
262 : :
263 [ + - ]: 12094 : "By default, this call only returns a transaction if it is in the mempool. If -txindex is enabled\n"
264 : : "and no blockhash argument is passed, it will return the transaction if it is in the mempool or any block.\n"
265 : : "If a blockhash argument is passed, it will return the transaction if\n"
266 : : "the specified block is available and the transaction is in that block.\n\n"
267 : : "Hint: Use gettransaction for wallet transactions.\n\n"
268 : :
269 : : "If verbosity is 0 or omitted, returns the serialized transaction as a hex-encoded string.\n"
270 : : "If verbosity is 1, returns a JSON Object with information about the transaction.\n"
271 : : "If verbosity is 2, returns a JSON Object with information about the transaction, including fee and prevout information.",
272 : : {
273 [ + - + - ]: 12094 : {"txid", RPCArg::Type::STR_HEX, RPCArg::Optional::NO, "The transaction id"},
274 [ + - + - : 18141 : {"verbosity|verbose", RPCArg::Type::NUM, RPCArg::Default{0}, "0 for hex-encoded data, 1 for a JSON object, and 2 for JSON object with fee and prevout",
+ - ]
275 [ + - ]: 12094 : RPCArgOptions{.skip_type_check = true}},
276 [ + - + - ]: 12094 : {"blockhash", RPCArg::Type::STR_HEX, RPCArg::Optional::OMITTED, "The block in which to look for the transaction"},
277 : : },
278 : : {
279 [ + - ]: 6047 : RPCResult{"if verbosity is not set or set to 0",
280 [ + - + - ]: 12094 : RPCResult::Type::STR, "data", "The serialized transaction as a hex-encoded string for 'txid'"
281 : 6047 : },
282 [ + - ]: 12094 : RPCResult{"if verbosity is set to 1",
283 [ + - + - ]: 12094 : RPCResult::Type::OBJ, "", "",
284 [ + - + - ]: 12094 : Cat<std::vector<RPCResult>>(
285 : : verbosity_1_block,
286 : 6047 : TxDoc({.txid_field_doc="The transaction id (same as provided)"})),
287 : : },
288 [ + - + - : 12094 : RPCResult{"for verbosity = 2", RPCResult::Type::OBJ, "", "",
+ - ]
289 [ + - + - : 12094 : Cat(ElideGroup(verbosity_1_block, "Same output as verbosity = 1"), v2_extras)},
+ - + - ]
290 : : },
291 : 6047 : RPCExamples{
292 [ + - + - : 12094 : HelpExampleCli("getrawtransaction", "\"mytxid\"")
+ - ]
293 [ + - + - : 24188 : + HelpExampleCli("getrawtransaction", "\"mytxid\" 1")
+ - + - ]
294 [ + - + - : 24188 : + HelpExampleRpc("getrawtransaction", "\"mytxid\", 1")
+ - + - ]
295 [ + - + - : 24188 : + HelpExampleCli("getrawtransaction", "\"mytxid\" 0 \"myblockhash\"")
+ - + - ]
296 [ + - + - : 24188 : + HelpExampleCli("getrawtransaction", "\"mytxid\" 1 \"myblockhash\"")
+ - + - ]
297 [ + - + - : 24188 : + HelpExampleCli("getrawtransaction", "\"mytxid\" 2 \"myblockhash\"")
+ - ]
298 [ + - ]: 6047 : },
299 : 6047 : [](const RPCMethod& self, const JSONRPCRequest& request) -> UniValue
300 : : {
301 : 3486 : const NodeContext& node = EnsureAnyNodeContext(request.context);
302 : 3486 : ChainstateManager& chainman = EnsureChainman(node);
303 : :
304 [ + + ]: 3486 : auto txid{Txid::FromUint256(ParseHashV(request.params[0], "parameter 1"))};
305 : 3485 : const CBlockIndex* blockindex = nullptr;
306 : :
307 [ + + ]: 3485 : if (txid.ToUint256() == chainman.GetParams().GenesisBlock().hashMerkleRoot) {
308 : : // Special exception for the genesis block coinbase transaction
309 [ + - + - ]: 2 : throw JSONRPCError(RPC_INVALID_ADDRESS_OR_KEY, "The genesis block coinbase is not considered an ordinary transaction and cannot be retrieved");
310 : : }
311 : :
312 : 3484 : int verbosity{ParseVerbosity(request.params[1], /*default_verbosity=*/0, /*allow_bool=*/true)};
313 : :
314 [ + + ]: 3472 : if (!request.params[2].isNull()) {
315 : 42 : LOCK(cs_main);
316 : :
317 [ + - + + ]: 42 : uint256 blockhash = ParseHashV(request.params[2], "parameter 3");
318 [ + - ]: 36 : blockindex = chainman.m_blockman.LookupBlockIndex(blockhash);
319 [ + + ]: 36 : if (!blockindex) {
320 [ + - + - ]: 4 : throw JSONRPCError(RPC_INVALID_ADDRESS_OR_KEY, "Block hash not found");
321 : : }
322 : 42 : }
323 : :
324 : 3464 : bool f_txindex_ready = false;
325 [ + + + + ]: 3464 : if (g_txindex && !blockindex) {
326 : 38 : f_txindex_ready = g_txindex->BlockUntilSyncedToCurrentChain();
327 : : }
328 : :
329 : 3464 : uint256 hash_block;
330 : 3464 : const CTransactionRef tx = GetTransaction(blockindex, node.mempool.get(), txid, chainman.m_blockman, hash_block);
331 [ + + ]: 3464 : if (!tx) {
332 [ + + ]: 10 : std::string errmsg;
333 [ + + ]: 10 : if (blockindex) {
334 [ + - + - ]: 4 : const bool block_has_data = WITH_LOCK(::cs_main, return blockindex->nStatus & BLOCK_HAVE_DATA);
335 [ - + ]: 2 : if (!block_has_data) {
336 [ # # # # ]: 0 : throw JSONRPCError(RPC_MISC_ERROR, "Block not available");
337 : : }
338 [ + - ]: 2 : errmsg = "No such transaction found in the provided block";
339 [ + - ]: 8 : } else if (!g_txindex) {
340 [ + - ]: 8 : errmsg = "No such mempool transaction. Use -txindex or provide a block hash to enable blockchain transaction queries";
341 [ # # ]: 0 : } else if (!f_txindex_ready) {
342 [ # # ]: 0 : errmsg = "No such mempool transaction. Blockchain transactions are still in the process of being indexed";
343 : : } else {
344 [ # # ]: 0 : errmsg = "No such mempool or blockchain transaction";
345 : : }
346 [ + - + - ]: 20 : throw JSONRPCError(RPC_INVALID_ADDRESS_OR_KEY, errmsg + ". Use gettransaction for wallet transactions.");
347 : 10 : }
348 : :
349 [ + + ]: 3454 : if (verbosity <= 0) {
350 [ + - + - ]: 110 : return EncodeHexTx(*tx);
351 : : }
352 : :
353 : 3399 : UniValue result(UniValue::VOBJ);
354 [ + + ]: 3399 : if (blockindex) {
355 [ + - ]: 31 : LOCK(cs_main);
356 [ + - + - : 62 : result.pushKV("in_active_chain", chainman.ActiveChain().Contains(*blockindex));
+ - + - +
- ]
357 : 31 : }
358 : : // If request is verbosity >= 1 but no blockhash was given, then look up the blockindex
359 [ + - + + ]: 3399 : if (request.params[2].isNull()) {
360 [ + - ]: 3368 : LOCK(cs_main);
361 [ + - + - ]: 3368 : blockindex = chainman.m_blockman.LookupBlockIndex(hash_block); // May be nullptr for mempool transactions
362 : 3368 : }
363 : :
364 : : // Add sigop-adjusted virtual size if the transaction exists in the mempool.
365 [ + + + - : 6744 : if (blockindex == nullptr && hash_block.IsNull() && node.mempool) {
+ - ]
366 [ + - ]: 3345 : auto info = node.mempool->info(tx->GetHash());
367 [ + - ]: 3345 : if (info.tx) {
368 [ + - + - : 6690 : result.pushKV("vsize_adjusted", info.vsize);
+ - ]
369 : : }
370 : 3345 : }
371 : :
372 [ + + ]: 3399 : if (verbosity == 1) {
373 [ + - + - ]: 3392 : TxToJSON(*tx, hash_block, result, chainman.ActiveChainstate());
374 : 3392 : return result;
375 : : }
376 : :
377 : 7 : CBlockUndo blockUndo;
378 : 7 : CBlock block;
379 : :
380 [ + + + + : 12 : if (tx->IsCoinBase() || !blockindex || WITH_LOCK(::cs_main, return !(blockindex->nStatus & BLOCK_HAVE_MASK))) {
+ - + - +
- ]
381 [ + - + - ]: 2 : TxToJSON(*tx, hash_block, result, chainman.ActiveChainstate());
382 : 2 : return result;
383 : : }
384 [ + - - + ]: 5 : if (!chainman.m_blockman.ReadBlockUndo(blockUndo, *blockindex)) {
385 [ # # # # ]: 0 : throw JSONRPCError(RPC_INTERNAL_ERROR, "Undo data expected but can't be read. This could be due to disk corruption or a conflict with a pruning event.");
386 : : }
387 [ + - - + ]: 5 : if (!chainman.m_blockman.ReadBlock(block, *blockindex)) {
388 [ # # # # ]: 0 : throw JSONRPCError(RPC_INTERNAL_ERROR, "Block data expected but can't be read. This could be due to disk corruption or a conflict with a pruning event.");
389 : : }
390 : :
391 : 5 : CTxUndo* undoTX {nullptr};
392 [ + - + - : 55 : auto it = std::find_if(block.vtx.begin(), block.vtx.end(), [tx](CTransactionRef t){ return t->Equals(*tx); });
+ - + - +
- + - + -
+ - ]
393 [ + - ]: 5 : if (it != block.vtx.end()) {
394 : : // -1 as blockundo does not have coinbase tx
395 [ + - ]: 5 : undoTX = &blockUndo.vtxundo.at(it - block.vtx.begin() - 1);
396 : : }
397 [ + - + - ]: 5 : TxToJSON(*tx, hash_block, result, chainman.ActiveChainstate(), undoTX, TxVerbosity::SHOW_DETAILS_AND_PREVOUT);
398 : 5 : return result;
399 : 6853 : },
400 [ + - + - : 78611 : };
+ - + - +
+ + + - -
- - ]
401 [ + - + - : 181410 : }
+ - + - +
- + - + -
+ - + - +
- + - + -
+ - + - +
- + - + -
+ - + - -
- - - - -
- - - - -
- - - ]
402 : :
403 : 3033 : static RPCMethod createrawtransaction()
404 : : {
405 : 3033 : return RPCMethod{
406 : 3033 : "createrawtransaction",
407 [ + - ]: 6066 : "Create a transaction spending the given inputs and creating new outputs.\n"
408 : : "Outputs can be addresses or data.\n"
409 : : "Returns hex-encoded raw transaction.\n"
410 : : "Note that the transaction's inputs are not signed, and\n"
411 : : "it is not stored in the wallet or transmitted to the network.\n",
412 [ + - ]: 6066 : CreateTxDoc(),
413 [ + - ]: 6066 : RPCResult{
414 [ + - + - ]: 6066 : RPCResult::Type::STR_HEX, "transaction", "hex string of the transaction"
415 [ + - ]: 6066 : },
416 : 3033 : RPCExamples{
417 [ + - + - : 6066 : HelpExampleCli("createrawtransaction", "\"[{\\\"txid\\\":\\\"myid\\\",\\\"vout\\\":0}]\" \"[{\\\"address\\\":0.01}]\"")
+ - ]
418 [ + - + - : 12132 : + HelpExampleCli("createrawtransaction", "\"[{\\\"txid\\\":\\\"myid\\\",\\\"vout\\\":0}]\" \"[{\\\"data\\\":\\\"00010203\\\"}]\"")
+ - + - ]
419 [ + - + - : 12132 : + HelpExampleRpc("createrawtransaction", "\"[{\\\"txid\\\":\\\"myid\\\",\\\"vout\\\":0}]\", \"[{\\\"address\\\":0.01}]\"")
+ - + - ]
420 [ + - + - : 12132 : + HelpExampleRpc("createrawtransaction", "\"[{\\\"txid\\\":\\\"myid\\\",\\\"vout\\\":0}]\", \"[{\\\"data\\\":\\\"00010203\\\"}]\"")
+ - + - ]
421 [ + - ]: 3033 : },
422 : 3033 : [](const RPCMethod& self, const JSONRPCRequest& request) -> UniValue
423 : : {
424 : 466 : std::optional<bool> rbf;
425 [ + + ]: 466 : if (!request.params[3].isNull()) {
426 : 10 : rbf = request.params[3].get_bool();
427 : : }
428 : 466 : CMutableTransaction rawTx = ConstructTransaction(request.params[0], request.params[1], request.params[2], rbf, self.Arg<uint32_t>("version"));
429 : :
430 [ + - + - : 1314 : return EncodeHexTx(CTransaction(rawTx));
+ - ]
431 : 438 : },
432 [ + - ]: 6066 : };
433 : : }
434 : :
435 : 6648 : static RPCMethod decoderawtransaction()
436 : : {
437 : 6648 : return RPCMethod{"decoderawtransaction",
438 [ + - ]: 13296 : "Return a JSON object representing the serialized, hex-encoded transaction.",
439 : : {
440 [ + - + - ]: 13296 : {"hexstring", RPCArg::Type::STR_HEX, RPCArg::Optional::NO, "The transaction hex string"},
441 [ + - + - : 19944 : {"iswitness", RPCArg::Type::BOOL, RPCArg::DefaultHint{"depends on heuristic tests"}, "Whether the transaction hex is a serialized witness transaction.\n"
+ - ]
442 : : "If iswitness is not present, heuristic tests will be used in decoding.\n"
443 : : "If true, only witness deserialization will be tried.\n"
444 : : "If false, only non-witness deserialization will be tried.\n"
445 : : "This boolean should reflect whether the transaction has inputs\n"
446 : : "(e.g. fully valid, or on-chain transactions), if known by the caller."
447 : : },
448 : : },
449 [ + - ]: 13296 : RPCResult{
450 [ + - + - ]: 13296 : RPCResult::Type::OBJ, "", "",
451 : 6648 : TxDoc(),
452 [ + - ]: 13296 : },
453 : 6648 : RPCExamples{
454 [ + - + - : 13296 : HelpExampleCli("decoderawtransaction", "\"hexstring\"")
+ - ]
455 [ + - + - : 26592 : + HelpExampleRpc("decoderawtransaction", "\"hexstring\"")
+ - + - ]
456 [ + - ]: 6648 : },
457 : 6648 : [](const RPCMethod& self, const JSONRPCRequest& request) -> UniValue
458 : : {
459 : 4088 : CMutableTransaction mtx;
460 : :
461 [ + - + + : 4088 : bool try_witness = request.params[1].isNull() ? true : request.params[1].get_bool();
+ - + - ]
462 [ + - + + : 4088 : bool try_no_witness = request.params[1].isNull() ? true : !request.params[1].get_bool();
+ - + - ]
463 : :
464 [ + - + - : 4088 : if (!DecodeHexTx(mtx, request.params[0].get_str(), try_no_witness, try_witness)) {
+ - + + ]
465 [ + - + - ]: 14 : throw JSONRPCError(RPC_DESERIALIZATION_ERROR, "TX decode failed");
466 : : }
467 : :
468 : 4081 : UniValue result(UniValue::VOBJ);
469 [ + - + - ]: 8162 : TxToUniv(CTransaction(std::move(mtx)), /*block_hash=*/uint256(), /*entry=*/result, /*include_hex=*/false);
470 : :
471 : 4081 : return result;
472 : 4081 : },
473 [ + - + - : 39888 : };
+ + - - ]
474 [ + - + - : 33240 : }
+ - + - -
- ]
475 : :
476 : 2589 : static RPCMethod decodescript()
477 : : {
478 : 2589 : return RPCMethod{
479 : 2589 : "decodescript",
480 [ + - ]: 5178 : "Decode a hex-encoded script.\n",
481 : : {
482 [ + - + - ]: 5178 : {"hexstring", RPCArg::Type::STR_HEX, RPCArg::Optional::NO, "the hex-encoded script"},
483 : : },
484 [ + - ]: 5178 : RPCResult{
485 [ + - + - ]: 5178 : RPCResult::Type::OBJ, "", "",
486 : : {
487 [ + - + - ]: 5178 : {RPCResult::Type::STR, "asm", "Disassembly of the script"},
488 [ + - + - ]: 5178 : {RPCResult::Type::STR, "desc", "Inferred descriptor for the script"},
489 [ + - + - : 5178 : {RPCResult::Type::STR, "type", "The output type (e.g. " + GetAllOutputTypes() + ")"},
+ - ]
490 [ + - + - ]: 5178 : {RPCResult::Type::STR, "address", /*optional=*/true, "The Bitcoin address (only if a well-defined address exists)"},
491 [ + - ]: 5178 : {RPCResult::Type::STR, "p2sh", /*optional=*/true,
492 [ + - ]: 5178 : "address of P2SH script wrapping this redeem script (not returned for types that should not be wrapped)"},
493 [ + - ]: 5178 : {RPCResult::Type::OBJ, "segwit", /*optional=*/true,
494 [ + - ]: 5178 : "Result of a witness output script wrapping this redeem script (not returned for types that should not be wrapped)",
495 : : {
496 [ + - + - ]: 5178 : {RPCResult::Type::STR, "asm", "Disassembly of the output script"},
497 [ + - + - ]: 5178 : {RPCResult::Type::STR_HEX, "hex", "The raw output script bytes, hex-encoded"},
498 [ + - + - ]: 5178 : {RPCResult::Type::STR, "type", "The type of the output script (e.g. witness_v0_keyhash or witness_v0_scripthash)"},
499 [ + - + - ]: 5178 : {RPCResult::Type::STR, "address", /*optional=*/true, "The Bitcoin address (only if a well-defined address exists)"},
500 [ + - + - ]: 5178 : {RPCResult::Type::STR, "desc", "Inferred descriptor for the script"},
501 [ + - + - ]: 5178 : {RPCResult::Type::STR, "p2sh-segwit", "address of the P2SH script wrapping this witness redeem script"},
502 : : }},
503 : : },
504 [ + - + - : 69903 : },
+ - + + +
+ - - -
- ]
505 : 2589 : RPCExamples{
506 [ + - + - : 5178 : HelpExampleCli("decodescript", "\"hexstring\"")
+ - ]
507 [ + - + - : 10356 : + HelpExampleRpc("decodescript", "\"hexstring\"")
+ - + - ]
508 [ + - ]: 2589 : },
509 : 2589 : [](const RPCMethod& self, const JSONRPCRequest& request) -> UniValue
510 : : {
511 : 31 : UniValue r(UniValue::VOBJ);
512 : 31 : CScript script;
513 [ + - + - : 31 : if (request.params[0].get_str().size() > 0){
- + + - ]
514 [ + - + - ]: 31 : std::vector<unsigned char> scriptData(ParseHexV(request.params[0], "argument"));
515 : 31 : script = CScript(scriptData.begin(), scriptData.end());
516 : 31 : } else {
517 : : // Empty scripts are valid
518 : : }
519 [ + - ]: 31 : ScriptToUniv(script, /*out=*/r, /*include_hex=*/false, /*include_address=*/true);
520 : :
521 : 31 : std::vector<std::vector<unsigned char>> solutions_data;
522 [ + - ]: 31 : const TxoutType which_type{Solver(script, solutions_data)};
523 : :
524 : 62 : const bool can_wrap{[&] {
525 [ + + ]: 31 : switch (which_type) {
526 : : case TxoutType::MULTISIG:
527 : : case TxoutType::NONSTANDARD:
528 : : case TxoutType::PUBKEY:
529 : : case TxoutType::PUBKEYHASH:
530 : : case TxoutType::WITNESS_V0_KEYHASH:
531 : : case TxoutType::WITNESS_V0_SCRIPTHASH:
532 : : // Can be wrapped if the checks below pass
533 : : break;
534 : : case TxoutType::NULL_DATA:
535 : : case TxoutType::SCRIPTHASH:
536 : : case TxoutType::WITNESS_UNKNOWN:
537 : : case TxoutType::WITNESS_V1_TAPROOT:
538 : : case TxoutType::ANCHOR:
539 : : // Should not be wrapped
540 : : return false;
541 : : } // no default case, so the compiler can warn about missing cases
542 [ + + + - ]: 21 : if (!script.HasValidOps() || script.IsUnspendable()) {
543 : : return false;
544 : : }
545 [ + + + + ]: 130 : for (CScript::const_iterator it{script.begin()}; it != script.end();) {
546 : 95 : opcodetype op;
547 : 95 : CHECK_NONFATAL(script.GetOp(it, op));
548 [ + - + + : 96 : if (op == OP_CHECKSIGADD || IsOpSuccess(op)) {
+ + ]
549 : : return false;
550 : : }
551 : : }
552 : : return true;
553 [ + - ]: 31 : }()};
554 : :
555 [ + + ]: 31 : if (can_wrap) {
556 [ + - + - : 34 : r.pushKV("p2sh", EncodeDestination(ScriptHash(script)));
+ - + - +
- ]
557 : : // P2SH and witness programs cannot be wrapped in P2WSH, if this script
558 : : // is a witness program, don't return addresses for a segwit programs.
559 : 34 : const bool can_wrap_P2WSH{[&] {
560 [ + + - + ]: 17 : switch (which_type) {
561 : 4 : case TxoutType::MULTISIG:
562 : 4 : case TxoutType::PUBKEY:
563 : : // Uncompressed pubkeys cannot be used with segwit checksigs.
564 : : // If the script contains an uncompressed pubkey, skip encoding of a segwit program.
565 [ + + ]: 12 : for (const auto& solution : solutions_data) {
566 [ - + + + : 10 : if ((solution.size() != 1) && !CPubKey(solution).IsCompressed()) {
+ + ]
567 : : return false;
568 : : }
569 : : }
570 : : return true;
571 : : case TxoutType::NONSTANDARD:
572 : : case TxoutType::PUBKEYHASH:
573 : : // Can be P2WSH wrapped
574 : : return true;
575 : 3 : case TxoutType::NULL_DATA:
576 : 3 : case TxoutType::SCRIPTHASH:
577 : 3 : case TxoutType::WITNESS_UNKNOWN:
578 : 3 : case TxoutType::WITNESS_V0_KEYHASH:
579 : 3 : case TxoutType::WITNESS_V0_SCRIPTHASH:
580 : 3 : case TxoutType::WITNESS_V1_TAPROOT:
581 : 3 : case TxoutType::ANCHOR:
582 : : // Should not be wrapped
583 : 3 : return false;
584 : : } // no default case, so the compiler can warn about missing cases
585 [ # # ]: 0 : NONFATAL_UNREACHABLE();
586 [ + - ]: 17 : }()};
587 [ + + ]: 17 : if (can_wrap_P2WSH) {
588 : 12 : UniValue sr(UniValue::VOBJ);
589 : 12 : CScript segwitScr;
590 : 12 : FlatSigningProvider provider;
591 [ + + ]: 12 : if (which_type == TxoutType::PUBKEY) {
592 [ + - + - ]: 2 : segwitScr = GetScriptForDestination(WitnessV0KeyHash(Hash160(solutions_data[0])));
593 [ + + ]: 11 : } else if (which_type == TxoutType::PUBKEYHASH) {
594 [ - + + - ]: 2 : segwitScr = GetScriptForDestination(WitnessV0KeyHash(uint160{solutions_data[0]}));
595 : : } else {
596 : : // Scripts that are not fit for P2WPKH are encoded as P2WSH.
597 [ + - + - ]: 10 : provider.scripts[CScriptID(script)] = script;
598 [ + - + - ]: 20 : segwitScr = GetScriptForDestination(WitnessV0ScriptHash(script));
599 : : }
600 [ + - ]: 12 : ScriptToUniv(segwitScr, /*out=*/sr, /*include_hex=*/true, /*include_address=*/true, /*provider=*/&provider);
601 [ + - + - : 24 : sr.pushKV("p2sh-segwit", EncodeDestination(ScriptHash(segwitScr)));
+ - + - +
- ]
602 [ + - + - ]: 24 : r.pushKV("segwit", std::move(sr));
603 : 12 : }
604 : : }
605 : :
606 : 62 : return r;
607 : 31 : },
608 [ + - + - : 12945 : };
+ + - - ]
609 [ + - + - : 67314 : }
+ - + - +
- + - + -
+ - + - +
- + - + -
+ - - - -
- ]
610 : :
611 : 2610 : static RPCMethod combinerawtransaction()
612 : : {
613 : 2610 : return RPCMethod{
614 : 2610 : "combinerawtransaction",
615 [ + - ]: 5220 : "Combine multiple partially signed transactions into one transaction.\n"
616 : : "The combined transaction may be another partially signed transaction or a \n"
617 : : "fully signed transaction.",
618 : : {
619 [ + - + - ]: 5220 : {"txs", RPCArg::Type::ARR, RPCArg::Optional::NO, "The hex strings of partially signed transactions",
620 : : {
621 [ + - + - ]: 5220 : {"hexstring", RPCArg::Type::STR_HEX, RPCArg::Optional::OMITTED, "A hex-encoded raw transaction"},
622 : : },
623 : : },
624 : : },
625 [ + - ]: 5220 : RPCResult{
626 [ + - + - ]: 5220 : RPCResult::Type::STR, "", "The hex-encoded raw transaction with signature(s)"
627 [ + - ]: 5220 : },
628 : 2610 : RPCExamples{
629 [ + - + - : 5220 : HelpExampleCli("combinerawtransaction", R"('["myhex1", "myhex2", "myhex3"]')")
+ - ]
630 [ + - ]: 2610 : },
631 : 2610 : [](const RPCMethod& self, const JSONRPCRequest& request) -> UniValue
632 : : {
633 : :
634 : 52 : UniValue txs = request.params[0].get_array();
635 : :
636 : : // Can't merge < 2 items
637 [ - + + + ]: 52 : if (txs.size() < 2) {
638 [ + - + - ]: 4 : throw JSONRPCError(RPC_DESERIALIZATION_ERROR, "Missing transactions. At least two transactions required.");
639 : : }
640 : :
641 [ + - ]: 50 : std::vector<CMutableTransaction> txVariants(txs.size());
642 : :
643 [ - + + + ]: 149 : for (unsigned int idx = 0; idx < txs.size(); idx++) {
644 [ + - + - : 100 : if (!DecodeHexTx(txVariants[idx], txs[idx].get_str())) {
+ - + + ]
645 [ + - + - ]: 2 : throw JSONRPCError(RPC_DESERIALIZATION_ERROR, strprintf("TX decode failed for tx %d. Make sure the tx has at least one input.", idx));
646 : : }
647 : : }
648 : :
649 : 49 : { // Test Tx relation for mergeability. Strip scriptSigs and scriptWitnesses to facilitate txId comparison
650 [ + - ]: 49 : std::vector<CMutableTransaction> tx_variants_copy(txVariants);
651 : 49 : Txid first_txid{};
652 [ - + + + ]: 141 : for (unsigned int k{0}; k < tx_variants_copy.size(); ++k) {
653 : : // Remove all scriptSigs and scriptWitnesses from inputs
654 [ + + ]: 196 : for (CTxIn& input : tx_variants_copy[k].vin) {
655 : 98 : input.scriptSig.clear();
656 : 98 : input.scriptWitness.SetNull();
657 : : }
658 [ + + ]: 98 : if (k == 0) {
659 [ + - ]: 49 : first_txid = tx_variants_copy[k].GetHash();
660 [ + - ]: 141 : } else if (first_txid != tx_variants_copy[k].GetHash()) {
661 [ + - + - ]: 12 : throw JSONRPCError(RPC_INVALID_PARAMETER, strprintf("Transaction number %d not compatible with first transaction", k+1));
662 : : }
663 : : }
664 : 49 : }
665 : :
666 : : // mergedTx will end up with all the signatures; it
667 : : // starts as a clone of the rawtx:
668 [ + - ]: 43 : CMutableTransaction mergedTx(txVariants[0]);
669 : :
670 : : // Fetch previous transactions (inputs):
671 [ + - + - ]: 43 : CCoinsViewCache view{&CoinsViewEmpty::Get()};
672 : 43 : {
673 [ + - ]: 43 : NodeContext& node = EnsureAnyNodeContext(request.context);
674 [ + - ]: 43 : const CTxMemPool& mempool = EnsureMemPool(node);
675 [ + - ]: 43 : ChainstateManager& chainman = EnsureChainman(node);
676 [ + - + - ]: 43 : LOCK2(cs_main, mempool.cs);
677 [ + - + - ]: 43 : CCoinsViewCache &viewChain = chainman.ActiveChainstate().CoinsTip();
678 [ + - ]: 43 : CCoinsViewMemPool viewMempool(&viewChain, mempool);
679 : 43 : view.SetBackend(viewMempool); // temporarily switch cache backend to db+mempool view
680 : :
681 [ + + ]: 86 : for (const CTxIn& txin : mergedTx.vin) {
682 [ + - ]: 43 : view.AccessCoin(txin.prevout); // Load entries from viewChain into view; can fail.
683 : : }
684 : :
685 [ + - ]: 43 : view.SetBackend(CoinsViewEmpty::Get()); // switch back to avoid locking mempool for too long
686 [ + - + - ]: 86 : }
687 : :
688 : : // Use CTransaction for the constant parts of the
689 : : // transaction to avoid rehashing.
690 [ + - ]: 43 : const CTransaction txConst(mergedTx);
691 : : // Sign what we can:
692 [ - + + + ]: 65 : for (unsigned int i = 0; i < mergedTx.vin.size(); i++) {
693 [ + - ]: 43 : CTxIn& txin = mergedTx.vin[i];
694 [ + - ]: 43 : const Coin& coin = view.AccessCoin(txin.prevout);
695 [ + + ]: 43 : if (coin.IsSpent()) {
696 [ + - + - ]: 42 : throw JSONRPCError(RPC_VERIFY_ERROR, "Input not found or already spent");
697 : : }
698 : 22 : SignatureData sigdata;
699 : :
700 : : // ... and merge in other signatures:
701 [ + + ]: 66 : for (const CMutableTransaction& txv : txVariants) {
702 [ - + + - ]: 44 : if (txv.vin.size() > i) {
703 [ + - + - ]: 44 : sigdata.MergeSignatureData(DataFromTransaction(txv, i, coin.out));
704 : : }
705 : : }
706 [ + - + - ]: 22 : ProduceSignature(DUMMY_SIGNING_PROVIDER, MutableTransactionSignatureCreator(mergedTx, i, coin.out.nValue, {.sighash_type = SIGHASH_ALL}), coin.out.scriptPubKey, sigdata);
707 : :
708 [ + - ]: 22 : UpdateInput(txin, sigdata);
709 : 22 : }
710 : :
711 [ + - + - : 88 : return EncodeHexTx(CTransaction(mergedTx));
+ - ]
712 : 123 : },
713 [ + - + - : 20880 : };
+ - + + +
+ - - -
- ]
714 [ + - + - ]: 10440 : }
715 : :
716 : 2757 : static RPCMethod signrawtransactionwithkey()
717 : : {
718 : 2757 : return RPCMethod{
719 : 2757 : "signrawtransactionwithkey",
720 [ + - ]: 5514 : "Sign inputs for raw transaction (serialized, hex-encoded).\n"
721 : : "The second argument is an array of base58-encoded private\n"
722 : : "keys that will be the only keys used to sign the transaction.\n"
723 : : "The third optional argument (may be null) is an array of previous transaction outputs that\n"
724 : : "this transaction depends on but may not yet be in the block chain.\n",
725 : : {
726 [ + - + - ]: 5514 : {"hexstring", RPCArg::Type::STR, RPCArg::Optional::NO, "The transaction hex string"},
727 [ + - + - ]: 5514 : {"privkeys", RPCArg::Type::ARR, RPCArg::Optional::NO, "The base58-encoded private keys for signing",
728 : : {
729 [ + - + - ]: 5514 : {"privatekey", RPCArg::Type::STR, RPCArg::Optional::OMITTED, "private key in base58-encoding"},
730 : : },
731 : : },
732 [ + - + - ]: 5514 : {"prevtxs", RPCArg::Type::ARR, RPCArg::Optional::OMITTED, "The previous dependent transaction outputs",
733 : : {
734 [ + - + - ]: 5514 : {"", RPCArg::Type::OBJ, RPCArg::Optional::OMITTED, "",
735 : : {
736 [ + - + - ]: 5514 : {"txid", RPCArg::Type::STR_HEX, RPCArg::Optional::NO, "The transaction id"},
737 [ + - + - ]: 5514 : {"vout", RPCArg::Type::NUM, RPCArg::Optional::NO, "The output number"},
738 [ + - + - ]: 5514 : {"scriptPubKey", RPCArg::Type::STR_HEX, RPCArg::Optional::NO, "output script"},
739 [ + - + - ]: 5514 : {"redeemScript", RPCArg::Type::STR_HEX, RPCArg::Optional::OMITTED, "(required for P2SH) redeem script"},
740 [ + - + - ]: 5514 : {"witnessScript", RPCArg::Type::STR_HEX, RPCArg::Optional::OMITTED, "(required for P2WSH or P2SH-P2WSH) witness script"},
741 [ + - + - ]: 5514 : {"amount", RPCArg::Type::AMOUNT, RPCArg::Optional::OMITTED, "(required for Segwit inputs) the amount spent"},
742 : : },
743 : : },
744 : : },
745 : : },
746 [ + - + - : 8271 : {"sighashtype", RPCArg::Type::STR, RPCArg::DefaultHint{"DEFAULT for Taproot, ALL otherwise"}, "The signature hash type. Must be one of:\n"
+ - ]
747 : : " \"DEFAULT\"\n"
748 : : " \"ALL\"\n"
749 : : " \"NONE\"\n"
750 : : " \"SINGLE\"\n"
751 : : " \"ALL|ANYONECANPAY\"\n"
752 : : " \"NONE|ANYONECANPAY\"\n"
753 : : " \"SINGLE|ANYONECANPAY\"\n"
754 : : },
755 : : },
756 [ + - ]: 5514 : RPCResult{
757 [ + - + - ]: 5514 : RPCResult::Type::OBJ, "", "",
758 : : {
759 [ + - + - ]: 5514 : {RPCResult::Type::STR_HEX, "hex", "The hex-encoded raw transaction with signature(s)"},
760 [ + - + - ]: 5514 : {RPCResult::Type::BOOL, "complete", "If the transaction has a complete set of signatures"},
761 [ + - + - ]: 5514 : {RPCResult::Type::ARR, "errors", /*optional=*/true, "Script verification errors (if there are any)",
762 : : {
763 [ + - + - ]: 5514 : {RPCResult::Type::OBJ, "", "",
764 : : {
765 [ + - + - ]: 5514 : {RPCResult::Type::STR_HEX, "txid", "The hash of the referenced, previous transaction"},
766 [ + - + - ]: 5514 : {RPCResult::Type::NUM, "vout", "The index of the output to spent and used as input"},
767 [ + - + - ]: 5514 : {RPCResult::Type::ARR, "witness", "",
768 : : {
769 [ + - + - ]: 5514 : {RPCResult::Type::STR_HEX, "witness", ""},
770 : : }},
771 [ + - + - ]: 5514 : {RPCResult::Type::STR_HEX, "scriptSig", "The hex-encoded signature script"},
772 [ + - + - ]: 5514 : {RPCResult::Type::NUM, "sequence", "Script sequence number"},
773 [ + - + - ]: 5514 : {RPCResult::Type::STR, "error", "Verification or signing error related to the input"},
774 : : }},
775 : : }},
776 : : }
777 [ + - + - : 74439 : },
+ - + - +
- + + + +
+ + + + -
- - - - -
- - ]
778 : 2757 : RPCExamples{
779 [ + - + - : 5514 : HelpExampleCli("signrawtransactionwithkey", "\"myhex\" \"[\\\"key1\\\",\\\"key2\\\"]\"")
+ - ]
780 [ + - + - : 11028 : + HelpExampleRpc("signrawtransactionwithkey", "\"myhex\", \"[\\\"key1\\\",\\\"key2\\\"]\"")
+ - + - ]
781 [ + - ]: 2757 : },
782 : 2757 : [](const RPCMethod& self, const JSONRPCRequest& request) -> UniValue
783 : : {
784 : 199 : CMutableTransaction mtx;
785 [ + - + - : 199 : if (!DecodeHexTx(mtx, request.params[0].get_str())) {
+ - + + ]
786 [ + - + - ]: 2 : throw JSONRPCError(RPC_DESERIALIZATION_ERROR, "TX decode failed. Make sure the tx has at least one input.");
787 : : }
788 : :
789 : 198 : FlatSigningProvider keystore;
790 [ + - + - ]: 198 : const UniValue& keys = request.params[1].get_array();
791 [ - + + + ]: 1179 : for (unsigned int idx = 0; idx < keys.size(); ++idx) {
792 [ + - + - ]: 982 : UniValue k = keys[idx];
793 [ + - + - ]: 982 : CKey key = DecodeSecret(k.get_str());
794 [ + + ]: 982 : if (!key.IsValid()) {
795 [ + - + - ]: 2 : throw JSONRPCError(RPC_INVALID_ADDRESS_OR_KEY, "Invalid private key");
796 : : }
797 : :
798 [ + - ]: 981 : CPubKey pubkey = key.GetPubKey();
799 [ + - ]: 981 : CKeyID key_id = pubkey.GetID();
800 [ + - ]: 981 : keystore.pubkeys.emplace(key_id, pubkey);
801 [ + - ]: 981 : keystore.keys.emplace(key_id, key);
802 : 982 : }
803 : :
804 : : // Fetch previous transactions (inputs):
805 : 197 : std::map<COutPoint, Coin> coins;
806 [ + + ]: 796 : for (const CTxIn& txin : mtx.vin) {
807 [ + - ]: 599 : coins[txin.prevout]; // Create empty map entry keyed by prevout.
808 : : }
809 [ + - ]: 197 : NodeContext& node = EnsureAnyNodeContext(request.context);
810 [ + - ]: 197 : FindCoins(node, coins);
811 : :
812 : : // Parse the prevtxs array
813 [ + - + + ]: 197 : ParsePrevouts(request.params[2], &keystore, coins);
814 : :
815 : 113 : UniValue result(UniValue::VOBJ);
816 [ + - + + ]: 113 : SignTransaction(mtx, &keystore, coins, request.params[3], result);
817 : 112 : return result;
818 : 311 : },
819 [ + - + - : 60654 : };
+ - + - +
- + + + +
+ + + + -
- - - - -
- - ]
820 [ + - + - : 126822 : }
+ - + - +
- + - + -
+ - + - +
- + - + -
+ - + - +
- + - + -
+ - + - +
- + - + -
+ - - - -
- - - -
- ]
821 : :
822 : 3125 : const RPCResult& DecodePSBTInputs()
823 : : {
824 : 3125 : static const RPCResult decodepsbt_inputs{
825 [ + - + - ]: 2544 : RPCResult::Type::ARR, "inputs", "",
826 : : {
827 [ + - + - ]: 2544 : {RPCResult::Type::OBJ, "", "",
828 : : {
829 [ + - + - ]: 2544 : {RPCResult::Type::OBJ, "non_witness_utxo", /*optional=*/true, "Decoded network transaction for non-witness UTXOs",
830 : 1272 : TxDoc({.elision_mode = ElisionMode::WithSummary, .elision_summary = "The layout is the same as the output of decoderawtransaction."})
831 : : },
832 [ + - + - ]: 2544 : {RPCResult::Type::OBJ, "witness_utxo", /*optional=*/true, "Transaction output for witness UTXOs",
833 : : {
834 [ + - + - ]: 2544 : {RPCResult::Type::NUM, "amount", "The value in " + CURRENCY_UNIT},
835 [ + - + - ]: 2544 : {RPCResult::Type::OBJ, "scriptPubKey", "",
836 : : {
837 [ + - + - ]: 2544 : {RPCResult::Type::STR, "asm", "Disassembly of the output script"},
838 [ + - + - ]: 2544 : {RPCResult::Type::STR, "desc", "Inferred descriptor for the output"},
839 [ + - + - ]: 2544 : {RPCResult::Type::STR_HEX, "hex", "The raw output script bytes, hex-encoded"},
840 [ + - + - ]: 2544 : {RPCResult::Type::STR, "type", "The type, eg 'pubkeyhash'"},
841 [ + - + - ]: 2544 : {RPCResult::Type::STR, "address", /*optional=*/true, "The Bitcoin address (only if a well-defined address exists)"},
842 : : }},
843 : : }},
844 [ + - + - ]: 2544 : {RPCResult::Type::OBJ_DYN, "partial_signatures", /*optional=*/true, "",
845 : : {
846 [ + - + - ]: 2544 : {RPCResult::Type::STR, "pubkey", "The public key and signature that corresponds to it."},
847 : : }},
848 [ + - + - ]: 2544 : {RPCResult::Type::STR, "sighash", /*optional=*/true, "The sighash type to be used"},
849 [ + - + - ]: 2544 : {RPCResult::Type::OBJ, "redeem_script", /*optional=*/true, "",
850 : : {
851 [ + - + - ]: 2544 : {RPCResult::Type::STR, "asm", "Disassembly of the redeem script"},
852 [ + - + - ]: 2544 : {RPCResult::Type::STR_HEX, "hex", "The raw redeem script bytes, hex-encoded"},
853 [ + - + - ]: 2544 : {RPCResult::Type::STR, "type", "The type, eg 'pubkeyhash'"},
854 : : }},
855 [ + - + - ]: 2544 : {RPCResult::Type::OBJ, "witness_script", /*optional=*/true, "",
856 : : {
857 [ + - + - ]: 2544 : {RPCResult::Type::STR, "asm", "Disassembly of the witness script"},
858 [ + - + - ]: 2544 : {RPCResult::Type::STR_HEX, "hex", "The raw witness script bytes, hex-encoded"},
859 [ + - + - ]: 2544 : {RPCResult::Type::STR, "type", "The type, eg 'pubkeyhash'"},
860 : : }},
861 [ + - + - ]: 2544 : {RPCResult::Type::ARR, "bip32_derivs", /*optional=*/true, "",
862 : : {
863 [ + - + - ]: 2544 : {RPCResult::Type::OBJ, "", "",
864 : : {
865 [ + - + - ]: 2544 : {RPCResult::Type::STR, "pubkey", "The public key with the derivation path as the value."},
866 [ + - + - ]: 2544 : {RPCResult::Type::STR, "master_fingerprint", "The fingerprint of the master key"},
867 [ + - + - ]: 2544 : {RPCResult::Type::STR, "path", "The path"},
868 : : }},
869 : : }},
870 [ + - + - ]: 2544 : {RPCResult::Type::OBJ, "final_scriptSig", /*optional=*/true, "",
871 : : {
872 [ + - + - ]: 2544 : {RPCResult::Type::STR, "asm", "Disassembly of the final signature script"},
873 [ + - + - ]: 2544 : {RPCResult::Type::STR_HEX, "hex", "The raw final signature script bytes, hex-encoded"},
874 : : }},
875 [ + - + - ]: 2544 : {RPCResult::Type::ARR, "final_scriptwitness", /*optional=*/true, "",
876 : : {
877 [ + - + - ]: 2544 : {RPCResult::Type::STR_HEX, "", "hex-encoded witness data (if any)"},
878 : : }},
879 [ + - + - ]: 2544 : {RPCResult::Type::OBJ_DYN, "ripemd160_preimages", /*optional=*/ true, "",
880 : : {
881 [ + - + - ]: 2544 : {RPCResult::Type::STR, "hash", "The hash and preimage that corresponds to it."},
882 : : }},
883 [ + - + - ]: 2544 : {RPCResult::Type::OBJ_DYN, "sha256_preimages", /*optional=*/ true, "",
884 : : {
885 [ + - + - ]: 2544 : {RPCResult::Type::STR, "hash", "The hash and preimage that corresponds to it."},
886 : : }},
887 [ + - + - ]: 2544 : {RPCResult::Type::OBJ_DYN, "hash160_preimages", /*optional=*/ true, "",
888 : : {
889 [ + - + - ]: 2544 : {RPCResult::Type::STR, "hash", "The hash and preimage that corresponds to it."},
890 : : }},
891 [ + - + - ]: 2544 : {RPCResult::Type::OBJ_DYN, "hash256_preimages", /*optional=*/ true, "",
892 : : {
893 [ + - + - ]: 2544 : {RPCResult::Type::STR, "hash", "The hash and preimage that corresponds to it."},
894 : : }},
895 [ + - + - ]: 3816 : {RPCResult::Type::STR_HEX, "previous_txid", /*optional=*/true, "TXID of the transaction containing the output being spent by this input"},
896 [ + - + - ]: 2544 : {RPCResult::Type::NUM, "previous_vout", /*optional=*/true, "Index of the output being spent"},
897 [ + - + - ]: 2544 : {RPCResult::Type::NUM, "sequence", /*optional=*/true, "Sequence number for this input"},
898 [ + - + - ]: 2544 : {RPCResult::Type::NUM, "time_locktime", /*optional=*/true, "Time-based locktime required for this input"},
899 [ + - + - ]: 2544 : {RPCResult::Type::NUM, "height_locktime", /*optional=*/true, "Height-based locktime required for this input"},
900 [ + - + - ]: 2544 : {RPCResult::Type::STR_HEX, "taproot_key_path_sig", /*optional=*/ true, "hex-encoded signature for the Taproot key path spend"},
901 [ + - + - ]: 2544 : {RPCResult::Type::ARR, "taproot_script_path_sigs", /*optional=*/ true, "",
902 : : {
903 [ + - + - ]: 2544 : {RPCResult::Type::OBJ, "signature", /*optional=*/ true, "The signature for the pubkey and leaf hash combination",
904 : : {
905 [ + - + - ]: 2544 : {RPCResult::Type::STR, "pubkey", "The x-only pubkey for this signature"},
906 [ + - + - ]: 2544 : {RPCResult::Type::STR, "leaf_hash", "The leaf hash for this signature"},
907 [ + - + - ]: 2544 : {RPCResult::Type::STR, "sig", "The signature itself"},
908 : : }},
909 : : }},
910 [ + - + - ]: 2544 : {RPCResult::Type::ARR, "taproot_scripts", /*optional=*/ true, "",
911 : : {
912 [ + - + - ]: 2544 : {RPCResult::Type::OBJ, "", "",
913 : : {
914 [ + - + - ]: 2544 : {RPCResult::Type::STR_HEX, "script", "A leaf script"},
915 [ + - + - ]: 2544 : {RPCResult::Type::NUM, "leaf_ver", "The version number for the leaf script"},
916 [ + - + - ]: 2544 : {RPCResult::Type::ARR, "control_blocks", "The control blocks for this script",
917 : : {
918 [ + - + - ]: 2544 : {RPCResult::Type::STR_HEX, "control_block", "A hex-encoded control block for this script"},
919 : : }},
920 : : }},
921 : : }},
922 [ + - + - ]: 2544 : {RPCResult::Type::ARR, "taproot_bip32_derivs", /*optional=*/ true, "",
923 : : {
924 [ + - + - ]: 2544 : {RPCResult::Type::OBJ, "", "",
925 : : {
926 [ + - + - ]: 2544 : {RPCResult::Type::STR, "pubkey", "The x-only public key this path corresponds to"},
927 [ + - + - ]: 2544 : {RPCResult::Type::STR, "master_fingerprint", "The fingerprint of the master key"},
928 [ + - + - ]: 2544 : {RPCResult::Type::STR, "path", "The path"},
929 [ + - + - ]: 2544 : {RPCResult::Type::ARR, "leaf_hashes", "The hashes of the leaves this pubkey appears in",
930 : : {
931 [ + - + - ]: 2544 : {RPCResult::Type::STR_HEX, "hash", "The hash of a leaf this pubkey appears in"},
932 : : }},
933 : : }},
934 : : }},
935 [ + - + - ]: 2544 : {RPCResult::Type::STR_HEX, "taproot_internal_key", /*optional=*/ true, "The hex-encoded Taproot x-only internal key"},
936 [ + - + - ]: 2544 : {RPCResult::Type::STR_HEX, "taproot_merkle_root", /*optional=*/ true, "The hex-encoded Taproot merkle root"},
937 [ + - + - ]: 2544 : {RPCResult::Type::ARR, "musig2_participant_pubkeys", /*optional=*/true, "",
938 : : {
939 [ + - + - ]: 2544 : {RPCResult::Type::OBJ, "", "",
940 : : {
941 [ + - + - ]: 2544 : {RPCResult::Type::STR_HEX, "aggregate_pubkey", "The compressed aggregate public key for which the participants create."},
942 [ + - + - ]: 2544 : {RPCResult::Type::ARR, "participant_pubkeys", "",
943 : : {
944 [ + - + - ]: 2544 : {RPCResult::Type::STR_HEX, "pubkey", "The compressed public keys that are aggregated for aggregate_pubkey."},
945 : : }},
946 : : }},
947 : : }},
948 [ + - + - ]: 2544 : {RPCResult::Type::ARR, "musig2_pubnonces", /*optional=*/true, "",
949 : : {
950 [ + - + - ]: 2544 : {RPCResult::Type::OBJ, "", "",
951 : : {
952 [ + - + - ]: 2544 : {RPCResult::Type::STR_HEX, "participant_pubkey", "The compressed public key of the participant that created this pubnonce."},
953 [ + - + - ]: 2544 : {RPCResult::Type::STR_HEX, "aggregate_pubkey", "The compressed aggregate public key for which this pubnonce is for."},
954 [ + - + - ]: 2544 : {RPCResult::Type::STR_HEX, "leaf_hash", /*optional=*/true, "The hash of the leaf script that contains the aggregate pubkey being signed for. Omitted when signing for the internal key."},
955 [ + - + - ]: 2544 : {RPCResult::Type::STR_HEX, "pubnonce", "The public nonce itself."},
956 : : }},
957 : : }},
958 [ + - + - ]: 2544 : {RPCResult::Type::ARR, "musig2_partial_sigs", /*optional=*/true, "",
959 : : {
960 [ + - + - ]: 2544 : {RPCResult::Type::OBJ, "", "",
961 : : {
962 [ + - + - ]: 2544 : {RPCResult::Type::STR_HEX, "participant_pubkey", "The compressed public key of the participant that created this partial signature."},
963 [ + - + - ]: 2544 : {RPCResult::Type::STR_HEX, "aggregate_pubkey", "The compressed aggregate public key for which this partial signature is for."},
964 [ + - + - ]: 2544 : {RPCResult::Type::STR_HEX, "leaf_hash", /*optional=*/true, "The hash of the leaf script that contains the aggregate pubkey being signed for. Omitted when signing for the internal key."},
965 [ + - + - ]: 2544 : {RPCResult::Type::STR_HEX, "partial_sig", "The partial signature itself."},
966 : : }},
967 : : }},
968 [ + - + - ]: 2544 : {RPCResult::Type::OBJ_DYN, "unknown", /*optional=*/ true, "The unknown input fields",
969 : : {
970 [ + - + - ]: 2544 : {RPCResult::Type::STR_HEX, "key", "(key-value pair) An unknown key-value pair"},
971 : : }},
972 [ + - + - ]: 2544 : {RPCResult::Type::ARR, "proprietary", /*optional=*/true, "The input proprietary map",
973 : : {
974 [ + - + - ]: 2544 : {RPCResult::Type::OBJ, "", "",
975 : : {
976 [ + - + - ]: 2544 : {RPCResult::Type::STR_HEX, "identifier", "The hex string for the proprietary identifier"},
977 [ + - + - ]: 2544 : {RPCResult::Type::NUM, "subtype", "The number for the subtype"},
978 [ + - + - ]: 2544 : {RPCResult::Type::STR_HEX, "key", "The hex for the key"},
979 [ + - + - ]: 2544 : {RPCResult::Type::STR_HEX, "value", "The hex for the value"},
980 : : }},
981 : : }},
982 : : }},
983 : : }
984 [ + + + - : 275333 : };
+ - + - +
- + - + -
+ - + - +
- + - + -
+ - + - +
- + - + -
+ - + - +
- + - + -
+ - + - +
- + - + -
+ - + - +
- + - + -
+ - + - +
- + - + +
+ + + + +
+ + + + +
+ + + + +
+ + + + +
+ + + + +
+ + + + +
+ + + + +
+ + + + +
+ + + + +
+ + + + +
+ + + + +
+ + + + +
+ + + + -
- - - - -
- - - - -
- - - - -
- - - - -
- - - - -
- - - - -
- - - - -
- - - - -
- - - - -
- - - - -
- - - - -
- - - - -
- - - -
- ]
985 : 3125 : return decodepsbt_inputs;
986 [ + - + - : 228960 : }
+ - + - +
- + - + -
+ - + - +
- + - + -
+ - + - +
- + - + -
+ - + - +
- + - + -
+ - + - +
- + - + -
+ - + - +
- + - + -
+ - + - +
- + - + -
+ - + - +
- + - + -
+ - + - +
- + - + -
+ - + - +
- + - + -
+ - + - +
- + - + -
+ - + - +
- + - + -
+ - + - +
- + - + -
+ - + - +
- + - + -
+ - + - +
- + - + -
+ - + - +
- + - + -
+ - + - +
- + - + -
+ - + - +
- + - + -
+ - - - -
- - - - -
- - - - -
- - - - -
- - - - -
- - - -
- ]
987 : :
988 : 3125 : const RPCResult& DecodePSBTOutputs()
989 : : {
990 : 3125 : static const RPCResult decodepsbt_outputs{
991 [ + - + - ]: 2544 : RPCResult::Type::ARR, "outputs", "",
992 : : {
993 [ + - + - ]: 2544 : {RPCResult::Type::OBJ, "", "",
994 : : {
995 [ + - + - ]: 2544 : {RPCResult::Type::OBJ, "redeem_script", /*optional=*/true, "",
996 : : {
997 [ + - + - ]: 2544 : {RPCResult::Type::STR, "asm", "Disassembly of the redeem script"},
998 [ + - + - ]: 2544 : {RPCResult::Type::STR_HEX, "hex", "The raw redeem script bytes, hex-encoded"},
999 [ + - + - ]: 2544 : {RPCResult::Type::STR, "type", "The type, eg 'pubkeyhash'"},
1000 : : }},
1001 [ + - + - ]: 2544 : {RPCResult::Type::OBJ, "witness_script", /*optional=*/true, "",
1002 : : {
1003 [ + - + - ]: 2544 : {RPCResult::Type::STR, "asm", "Disassembly of the witness script"},
1004 [ + - + - ]: 2544 : {RPCResult::Type::STR_HEX, "hex", "The raw witness script bytes, hex-encoded"},
1005 [ + - + - ]: 2544 : {RPCResult::Type::STR, "type", "The type, eg 'pubkeyhash'"},
1006 : : }},
1007 [ + - + - ]: 2544 : {RPCResult::Type::ARR, "bip32_derivs", /*optional=*/true, "",
1008 : : {
1009 [ + - + - ]: 2544 : {RPCResult::Type::OBJ, "", "",
1010 : : {
1011 [ + - + - ]: 2544 : {RPCResult::Type::STR, "pubkey", "The public key this path corresponds to"},
1012 [ + - + - ]: 2544 : {RPCResult::Type::STR, "master_fingerprint", "The fingerprint of the master key"},
1013 [ + - + - ]: 2544 : {RPCResult::Type::STR, "path", "The path"},
1014 : : }},
1015 : : }},
1016 [ + - + - ]: 2544 : {RPCResult::Type::NUM, "amount", /* optional=*/ true, "The amount (nValue) for this output"},
1017 [ + - + - ]: 2544 : {RPCResult::Type::OBJ, "script", /* optional=*/ true, "The output script (scriptPubKey) for this output",
1018 [ + - + - : 2544 : ElideGroup(ScriptPubKeyDoc(), "The layout is the same as the output of scriptPubKeys in decoderawtransaction."),
+ - ]
1019 : : },
1020 [ + - + - ]: 2544 : {RPCResult::Type::STR_HEX, "taproot_internal_key", /*optional=*/ true, "The hex-encoded Taproot x-only internal key"},
1021 [ + - + - ]: 2544 : {RPCResult::Type::ARR, "taproot_tree", /*optional=*/ true, "The tuples that make up the Taproot tree, in depth first search order",
1022 : : {
1023 [ + - + - ]: 2544 : {RPCResult::Type::OBJ, "tuple", /*optional=*/ true, "A single leaf script in the taproot tree",
1024 : : {
1025 [ + - + - ]: 2544 : {RPCResult::Type::NUM, "depth", "The depth of this element in the tree"},
1026 [ + - + - ]: 2544 : {RPCResult::Type::NUM, "leaf_ver", "The version of this leaf"},
1027 [ + - + - ]: 2544 : {RPCResult::Type::STR, "script", "The hex-encoded script itself"},
1028 : : }},
1029 : : }},
1030 [ + - + - ]: 2544 : {RPCResult::Type::ARR, "taproot_bip32_derivs", /*optional=*/ true, "",
1031 : : {
1032 [ + - + - ]: 2544 : {RPCResult::Type::OBJ, "", "",
1033 : : {
1034 [ + - + - ]: 2544 : {RPCResult::Type::STR, "pubkey", "The x-only public key this path corresponds to"},
1035 [ + - + - ]: 2544 : {RPCResult::Type::STR, "master_fingerprint", "The fingerprint of the master key"},
1036 [ + - + - ]: 2544 : {RPCResult::Type::STR, "path", "The path"},
1037 [ + - + - ]: 2544 : {RPCResult::Type::ARR, "leaf_hashes", "The hashes of the leaves this pubkey appears in",
1038 : : {
1039 [ + - + - ]: 2544 : {RPCResult::Type::STR_HEX, "hash", "The hash of a leaf this pubkey appears in"},
1040 : : }},
1041 : : }},
1042 : : }},
1043 [ + - + - ]: 2544 : {RPCResult::Type::ARR, "musig2_participant_pubkeys", /*optional=*/true, "",
1044 : : {
1045 [ + - + - ]: 2544 : {RPCResult::Type::OBJ, "", "",
1046 : : {
1047 [ + - + - ]: 2544 : {RPCResult::Type::STR_HEX, "aggregate_pubkey", "The compressed aggregate public key for which the participants create."},
1048 [ + - + - ]: 2544 : {RPCResult::Type::ARR, "participant_pubkeys", "",
1049 : : {
1050 [ + - + - ]: 2544 : {RPCResult::Type::STR_HEX, "pubkey", "The compressed public keys that are aggregated for aggregate_pubkey."},
1051 : : }},
1052 : : }},
1053 : : }},
1054 [ + - + - ]: 2544 : {RPCResult::Type::OBJ_DYN, "unknown", /*optional=*/true, "The unknown output fields",
1055 : : {
1056 [ + - + - ]: 2544 : {RPCResult::Type::STR_HEX, "key", "(key-value pair) An unknown key-value pair"},
1057 : : }},
1058 [ + - + - ]: 2544 : {RPCResult::Type::ARR, "proprietary", /*optional=*/true, "The output proprietary map",
1059 : : {
1060 [ + - + - ]: 2544 : {RPCResult::Type::OBJ, "", "",
1061 : : {
1062 [ + - + - ]: 2544 : {RPCResult::Type::STR_HEX, "identifier", "The hex string for the proprietary identifier"},
1063 [ + - + - ]: 2544 : {RPCResult::Type::NUM, "subtype", "The number for the subtype"},
1064 [ + - + - ]: 2544 : {RPCResult::Type::STR_HEX, "key", "The hex for the key"},
1065 [ + - + - ]: 2544 : {RPCResult::Type::STR_HEX, "value", "The hex for the value"},
1066 : : }},
1067 : : }},
1068 : : }},
1069 : : }
1070 [ + + + - : 131597 : };
+ - + - +
- + - + -
+ - + - +
- + - + -
+ - + - +
- + - + -
+ - + - +
- + + + +
+ + + + +
+ + + + +
+ + + + +
+ + + + +
+ + + + +
+ + + + +
- - - - -
- - - - -
- - - - -
- - - - -
- - - - -
- - - - -
- - - - ]
1071 : 3125 : return decodepsbt_outputs;
1072 [ + - + - : 106848 : }
+ - + - +
- + - + -
+ - + - +
- + - + -
+ - + - +
- + - + -
+ - + - +
- + - + -
+ - + - +
- + - + -
+ - + - +
- + - + -
+ - + - +
- + - + -
+ - + - +
- + - + -
- - - - -
- - - - -
- - - - -
- ]
1073 : :
1074 : 3125 : static RPCMethod decodepsbt()
1075 : : {
1076 : 3125 : return RPCMethod{
1077 : 3125 : "decodepsbt",
1078 [ + - ]: 6250 : "Return a JSON object representing the serialized, base64-encoded partially signed Bitcoin transaction.",
1079 : : {
1080 [ + - + - ]: 6250 : {"psbt", RPCArg::Type::STR, RPCArg::Optional::NO, "The PSBT base64 string"},
1081 : : },
1082 [ + - ]: 6250 : RPCResult{
1083 [ + - + - ]: 6250 : RPCResult::Type::OBJ, "", "",
1084 : : {
1085 [ + - + - ]: 6250 : {RPCResult::Type::OBJ, "tx", /*optional=*/true, "The decoded network-serialized unsigned transaction.",
1086 : 3125 : TxDoc({.elision_mode = ElisionMode::WithSummary, .elision_summary = "The layout is the same as the output of decoderawtransaction."})
1087 : : },
1088 [ + - + - ]: 6250 : {RPCResult::Type::ARR, "global_xpubs", "",
1089 : : {
1090 [ + - + - ]: 6250 : {RPCResult::Type::OBJ, "", "",
1091 : : {
1092 [ + - + - ]: 6250 : {RPCResult::Type::STR, "xpub", "The extended public key this path corresponds to"},
1093 [ + - + - ]: 6250 : {RPCResult::Type::STR_HEX, "master_fingerprint", "The fingerprint of the master key"},
1094 [ + - + - ]: 6250 : {RPCResult::Type::STR, "path", "The path"},
1095 : : }},
1096 : : }},
1097 [ + - + - ]: 6250 : {RPCResult::Type::NUM, "tx_version", /* optional */ true, "The version number of the unsigned transaction. Not to be confused with PSBT version"},
1098 [ + - + - ]: 6250 : {RPCResult::Type::NUM, "fallback_locktime", /* optional */ true, "The locktime to fallback to if no inputs specify a required locktime."},
1099 [ + - + - ]: 6250 : {RPCResult::Type::NUM, "input_count", /* optional */ true, "The number of inputs in this psbt"},
1100 [ + - + - ]: 6250 : {RPCResult::Type::NUM, "output_count", /* optional */ true, "The number of outputs in this psbt."},
1101 [ + - + - ]: 6250 : {RPCResult::Type::BOOL, "inputs_modifiable", /* optional */ true, "Whether inputs can be modified"},
1102 [ + - + - ]: 6250 : {RPCResult::Type::BOOL, "outputs_modifiable", /* optional */ true, "Whether outputs can be modified"},
1103 [ + - + - ]: 6250 : {RPCResult::Type::BOOL, "has_sighash_single", /* optional */ true, "Whether this PSBT has SIGHASH_SINGLE inputs"},
1104 [ + - + - ]: 6250 : {RPCResult::Type::NUM, "psbt_version", /* optional */ true, "The PSBT version number. Not to be confused with the unsigned transaction version"},
1105 [ + - + - ]: 6250 : {RPCResult::Type::ARR, "proprietary", "The global proprietary map",
1106 : : {
1107 [ + - + - ]: 6250 : {RPCResult::Type::OBJ, "", "",
1108 : : {
1109 [ + - + - ]: 6250 : {RPCResult::Type::STR_HEX, "identifier", "The hex string for the proprietary identifier"},
1110 [ + - + - ]: 6250 : {RPCResult::Type::NUM, "subtype", "The number for the subtype"},
1111 [ + - + - ]: 6250 : {RPCResult::Type::STR_HEX, "key", "The hex for the key"},
1112 [ + - + - ]: 6250 : {RPCResult::Type::STR_HEX, "value", "The hex for the value"},
1113 : : }},
1114 : : }},
1115 [ + - + - ]: 6250 : {RPCResult::Type::OBJ_DYN, "unknown", "The unknown global fields",
1116 : : {
1117 [ + - + - ]: 6250 : {RPCResult::Type::STR_HEX, "key", "(key-value pair) An unknown key-value pair"},
1118 : : }},
1119 : : DecodePSBTInputs(),
1120 : : DecodePSBTOutputs(),
1121 [ + - + - ]: 6250 : {RPCResult::Type::STR_AMOUNT, "fee", /*optional=*/true, "The transaction fee paid if all UTXOs slots in the PSBT have been filled."},
1122 : : }
1123 [ + - + - : 168750 : },
+ - + - +
- + - + -
+ + + + +
+ + + + +
+ + - - -
- - - - -
- - - - ]
1124 : 3125 : RPCExamples{
1125 [ + - + - : 6250 : HelpExampleCli("decodepsbt", "\"psbt\"")
+ - ]
1126 [ + - ]: 3125 : },
1127 : 3125 : [](const RPCMethod& self, const JSONRPCRequest& request) -> UniValue
1128 : : {
1129 : : // Unserialize the transactions
1130 : 567 : util::Result<PartiallySignedTransaction> psbt_res = DecodeBase64PSBT(request.params[0].get_str());
1131 [ + + ]: 567 : if (!psbt_res) {
1132 [ + - + - : 261 : throw JSONRPCError(RPC_DESERIALIZATION_ERROR, strprintf("TX decode failed %s", util::ErrorString(psbt_res).original));
+ - ]
1133 : : }
1134 [ + - ]: 480 : PartiallySignedTransaction psbtx = *psbt_res;
1135 : :
1136 : 480 : UniValue result(UniValue::VOBJ);
1137 : :
1138 [ + - + + ]: 480 : if (psbtx.GetVersion() < 2) {
1139 : : // Add the decoded tx
1140 : 58 : UniValue tx_univ(UniValue::VOBJ);
1141 [ + - + - : 174 : TxToUniv(CTransaction(*CHECK_NONFATAL(psbtx.GetUnsignedTx())), /*block_hash=*/uint256(), /*entry=*/tx_univ, /*include_hex=*/false);
+ - + - +
- ]
1142 [ + - + - ]: 116 : result.pushKV("tx", std::move(tx_univ));
1143 : 58 : }
1144 : :
1145 : : // Add the global xpubs
1146 : 480 : UniValue global_xpubs(UniValue::VARR);
1147 [ + - + + ]: 485 : for (std::pair<KeyOriginInfo, std::set<CExtPubKey>> xpub_pair : psbtx.m_xpubs) {
1148 [ + + ]: 10 : for (auto& xpub : xpub_pair.second) {
1149 : 5 : std::vector<unsigned char> ser_xpub;
1150 [ + - ]: 5 : VectorWriter{ser_xpub, 0, xpub.version, xpub};
1151 : :
1152 : 5 : UniValue keypath(UniValue::VOBJ);
1153 [ - + + - : 10 : keypath.pushKV("xpub", EncodeBase58Check(ser_xpub));
+ - + - +
- ]
1154 [ + - + - : 10 : keypath.pushKV("master_fingerprint", HexStr(xpub_pair.first.fingerprint));
+ - + - ]
1155 [ + - + - : 10 : keypath.pushKV("path", WriteHDKeypath(xpub_pair.first.path));
+ - + - ]
1156 [ + - ]: 5 : global_xpubs.push_back(std::move(keypath));
1157 : 5 : }
1158 : 5 : }
1159 [ + - + - ]: 960 : result.pushKV("global_xpubs", std::move(global_xpubs));
1160 : :
1161 : : // Add PSBTv2 stuff
1162 [ + - + + ]: 480 : if (psbtx.GetVersion() >= 2) {
1163 [ + - + - : 844 : result.pushKV("tx_version", psbtx.tx_version);
+ - ]
1164 [ + + ]: 422 : if (psbtx.fallback_locktime.has_value()) {
1165 [ + - + - : 820 : result.pushKV("fallback_locktime", static_cast<uint64_t>(*psbtx.fallback_locktime));
+ - ]
1166 : : }
1167 [ - + + - : 844 : result.pushKV("input_count", (uint64_t)psbtx.inputs.size());
+ - + - ]
1168 [ - + + - : 844 : result.pushKV("output_count", (uint64_t)psbtx.outputs.size());
+ - + - ]
1169 [ + + ]: 422 : if (psbtx.m_tx_modifiable.has_value()) {
1170 [ + - + - : 20 : result.pushKV("inputs_modifiable", psbtx.m_tx_modifiable->test(0));
+ - ]
1171 [ + - + - : 20 : result.pushKV("outputs_modifiable", psbtx.m_tx_modifiable->test(1));
+ - ]
1172 [ + - + - : 20 : result.pushKV("has_sighash_single", psbtx.m_tx_modifiable->test(2));
+ - ]
1173 : : }
1174 : : }
1175 : :
1176 : : // PSBT version
1177 [ + - + - : 960 : result.pushKV("psbt_version", psbtx.GetVersion());
+ - + - ]
1178 : :
1179 : : // Proprietary
1180 : 480 : UniValue proprietary(UniValue::VARR);
1181 [ + + ]: 484 : for (const auto& entry : psbtx.m_proprietary) {
1182 : 4 : UniValue this_prop(UniValue::VOBJ);
1183 [ - + + - : 8 : this_prop.pushKV("identifier", HexStr(entry.identifier));
+ - + - +
- ]
1184 [ + - + - : 8 : this_prop.pushKV("subtype", entry.subtype);
+ - ]
1185 [ - + + - : 8 : this_prop.pushKV("key", HexStr(entry.key));
+ - + - +
- ]
1186 [ - + + - : 8 : this_prop.pushKV("value", HexStr(entry.value));
+ - + - +
- ]
1187 [ + - ]: 4 : proprietary.push_back(std::move(this_prop));
1188 : 4 : }
1189 [ + - + - ]: 960 : result.pushKV("proprietary", std::move(proprietary));
1190 : :
1191 : : // Unknown data
1192 : 480 : UniValue unknowns(UniValue::VOBJ);
1193 [ + - - + : 494 : for (auto [key, value] : psbtx.unknown) {
+ + ]
1194 [ - + + - : 42 : unknowns.pushKVEnd(HexStr(key), HexStr(value));
+ - + - +
- ]
1195 [ - - ]: 14 : }
1196 [ + - + - ]: 960 : result.pushKV("unknown", std::move(unknowns));
1197 : :
1198 : : // inputs
1199 : 480 : CAmount total_in = 0;
1200 : 480 : bool have_all_utxos = true;
1201 : 480 : UniValue inputs(UniValue::VARR);
1202 [ - + + + ]: 1034 : for (unsigned int i = 0; i < psbtx.inputs.size(); ++i) {
1203 : 554 : const PSBTInput& input = psbtx.inputs[i];
1204 : 554 : UniValue in(UniValue::VOBJ);
1205 : : // UTXOs
1206 : 554 : bool have_a_utxo = false;
1207 : 554 : CTxOut txout;
1208 [ + + ]: 554 : if (!input.witness_utxo.IsNull()) {
1209 : 461 : txout = input.witness_utxo;
1210 : :
1211 : 461 : UniValue o(UniValue::VOBJ);
1212 [ + - ]: 461 : ScriptToUniv(txout.scriptPubKey, /*out=*/o, /*include_hex=*/true, /*include_address=*/true);
1213 : :
1214 : 461 : UniValue out(UniValue::VOBJ);
1215 [ + - + - : 922 : out.pushKV("amount", ValueFromAmount(txout.nValue));
+ - ]
1216 [ + - + - ]: 922 : out.pushKV("scriptPubKey", std::move(o));
1217 : :
1218 [ + - + - ]: 922 : in.pushKV("witness_utxo", std::move(out));
1219 : :
1220 : 461 : have_a_utxo = true;
1221 : 461 : }
1222 [ + + ]: 554 : if (input.non_witness_utxo) {
1223 : 173 : txout = input.non_witness_utxo->vout[input.prev_out];
1224 : :
1225 : 173 : UniValue non_wit(UniValue::VOBJ);
1226 [ + - ]: 173 : TxToUniv(*input.non_witness_utxo, /*block_hash=*/uint256(), /*entry=*/non_wit, /*include_hex=*/false);
1227 [ + - + - ]: 346 : in.pushKV("non_witness_utxo", std::move(non_wit));
1228 : :
1229 : 173 : have_a_utxo = true;
1230 : 0 : }
1231 [ + + ]: 554 : if (have_a_utxo) {
1232 [ + - - + ]: 502 : if (MoneyRange(txout.nValue) && MoneyRange(total_in + txout.nValue)) {
1233 : : total_in += txout.nValue;
1234 : : } else {
1235 : : // Hack to just not show fee later
1236 : : have_all_utxos = false;
1237 : : }
1238 : : } else {
1239 : : have_all_utxos = false;
1240 : : }
1241 : :
1242 : : // Partial sigs
1243 [ + + ]: 554 : if (!input.partial_sigs.empty()) {
1244 : 44 : UniValue partial_sigs(UniValue::VOBJ);
1245 [ + + ]: 106 : for (const auto& sig : input.partial_sigs) {
1246 [ - + + - : 124 : partial_sigs.pushKV(HexStr(sig.second.first), HexStr(sig.second.second));
+ - + - +
- ]
1247 : : }
1248 [ + - + - ]: 88 : in.pushKV("partial_signatures", std::move(partial_sigs));
1249 : 44 : }
1250 : :
1251 : : // Sighash
1252 [ + + ]: 554 : if (input.sighash_type != std::nullopt) {
1253 [ + - + - : 26 : in.pushKV("sighash", SighashToStr(*input.sighash_type));
+ - + - ]
1254 : : }
1255 : :
1256 : : // Redeem script and witness script
1257 [ - + + + ]: 554 : if (!input.redeem_script.empty()) {
1258 : 19 : UniValue r(UniValue::VOBJ);
1259 [ + - ]: 19 : ScriptToUniv(input.redeem_script, /*out=*/r);
1260 [ + - + - ]: 38 : in.pushKV("redeem_script", std::move(r));
1261 : 19 : }
1262 [ + + + + ]: 583 : if (!input.witness_script.empty()) {
1263 : 29 : UniValue r(UniValue::VOBJ);
1264 [ + - ]: 29 : ScriptToUniv(input.witness_script, /*out=*/r);
1265 [ + - + - ]: 58 : in.pushKV("witness_script", std::move(r));
1266 : 29 : }
1267 : :
1268 : : // keypaths
1269 [ + + ]: 554 : if (!input.hd_keypaths.empty()) {
1270 : 112 : UniValue keypaths(UniValue::VARR);
1271 [ + - + + ]: 267 : for (auto entry : input.hd_keypaths) {
1272 : 155 : UniValue keypath(UniValue::VOBJ);
1273 [ + - + - : 310 : keypath.pushKV("pubkey", HexStr(entry.first));
+ - + - ]
1274 : :
1275 [ + - + - : 310 : keypath.pushKV("master_fingerprint", strprintf("%08x", ReadBE32(entry.second.fingerprint.data())));
+ - + - ]
1276 [ + - + - : 310 : keypath.pushKV("path", WriteHDKeypath(entry.second.path));
+ - + - ]
1277 [ + - ]: 155 : keypaths.push_back(std::move(keypath));
1278 : 155 : }
1279 [ + - + - ]: 224 : in.pushKV("bip32_derivs", std::move(keypaths));
1280 : 112 : }
1281 : :
1282 : : // Final scriptSig and scriptwitness
1283 [ + + + + ]: 567 : if (!input.final_script_sig.empty()) {
1284 : 17 : UniValue scriptsig(UniValue::VOBJ);
1285 [ + - + - : 34 : scriptsig.pushKV("asm", ScriptToAsmStr(input.final_script_sig, true));
+ - + - ]
1286 [ + + + - : 51 : scriptsig.pushKV("hex", HexStr(input.final_script_sig));
+ - + - +
- ]
1287 [ + - + - ]: 34 : in.pushKV("final_scriptSig", std::move(scriptsig));
1288 : 17 : }
1289 [ + + ]: 554 : if (!input.final_script_witness.IsNull()) {
1290 : 54 : UniValue txinwitness(UniValue::VARR);
1291 [ + + ]: 171 : for (const auto& item : input.final_script_witness.stack) {
1292 [ - + + - : 117 : txinwitness.push_back(HexStr(item));
+ - + - ]
1293 : : }
1294 [ + - + - ]: 108 : in.pushKV("final_scriptwitness", std::move(txinwitness));
1295 : 54 : }
1296 : :
1297 : : // Ripemd160 hash preimages
1298 [ + + ]: 554 : if (!input.ripemd160_preimages.empty()) {
1299 : 2 : UniValue ripemd160_preimages(UniValue::VOBJ);
1300 [ - + + + ]: 5 : for (const auto& [hash, preimage] : input.ripemd160_preimages) {
1301 [ - + + - : 6 : ripemd160_preimages.pushKVEnd(HexStr(hash), HexStr(preimage));
+ - + - +
- ]
1302 : : }
1303 [ + - + - ]: 4 : in.pushKV("ripemd160_preimages", std::move(ripemd160_preimages));
1304 : 2 : }
1305 : :
1306 : : // Sha256 hash preimages
1307 [ + + ]: 554 : if (!input.sha256_preimages.empty()) {
1308 : 3 : UniValue sha256_preimages(UniValue::VOBJ);
1309 [ - + + + ]: 7 : for (const auto& [hash, preimage] : input.sha256_preimages) {
1310 [ - + + - : 8 : sha256_preimages.pushKVEnd(HexStr(hash), HexStr(preimage));
+ - + - +
- ]
1311 : : }
1312 [ + - + - ]: 6 : in.pushKV("sha256_preimages", std::move(sha256_preimages));
1313 : 3 : }
1314 : :
1315 : : // Hash160 hash preimages
1316 [ + + ]: 554 : if (!input.hash160_preimages.empty()) {
1317 : 2 : UniValue hash160_preimages(UniValue::VOBJ);
1318 [ - + + + ]: 5 : for (const auto& [hash, preimage] : input.hash160_preimages) {
1319 [ - + + - : 6 : hash160_preimages.pushKVEnd(HexStr(hash), HexStr(preimage));
+ - + - +
- ]
1320 : : }
1321 [ + - + - ]: 4 : in.pushKV("hash160_preimages", std::move(hash160_preimages));
1322 : 2 : }
1323 : :
1324 : : // Hash256 hash preimages
1325 [ + + ]: 554 : if (!input.hash256_preimages.empty()) {
1326 : 2 : UniValue hash256_preimages(UniValue::VOBJ);
1327 [ - + + + ]: 5 : for (const auto& [hash, preimage] : input.hash256_preimages) {
1328 [ - + + - : 6 : hash256_preimages.pushKVEnd(HexStr(hash), HexStr(preimage));
+ - + - +
- ]
1329 : : }
1330 [ + - + - ]: 4 : in.pushKV("hash256_preimages", std::move(hash256_preimages));
1331 : 2 : }
1332 : :
1333 : : // PSBTv2
1334 [ + - + + ]: 554 : if (psbtx.GetVersion() >= 2) {
1335 [ + - + - : 966 : in.pushKV("previous_txid", input.prev_txid.GetHex());
+ - + - ]
1336 [ + - + - : 966 : in.pushKV("previous_vout", static_cast<uint64_t>(input.prev_out));
+ - ]
1337 [ + + ]: 483 : if (input.sequence.has_value()) {
1338 [ + - + - : 944 : in.pushKV("sequence", static_cast<uint64_t>(*input.sequence));
+ - ]
1339 : : }
1340 [ + + ]: 483 : if (input.time_locktime.has_value()) {
1341 [ + - + - : 4 : in.pushKV("time_locktime", static_cast<uint64_t>(*input.time_locktime));
+ - ]
1342 : : }
1343 [ + + ]: 483 : if (input.height_locktime.has_value()) {
1344 [ + - + - : 4 : in.pushKV("height_locktime", static_cast<uint64_t>(*input.height_locktime));
+ - ]
1345 : : }
1346 : : }
1347 : :
1348 : : // Taproot key path signature
1349 [ + + ]: 554 : if (!input.m_tap_key_sig.empty()) {
1350 [ - + + - : 166 : in.pushKV("taproot_key_path_sig", HexStr(input.m_tap_key_sig));
+ - + - +
- ]
1351 : : }
1352 : :
1353 : : // Taproot script path signatures
1354 [ + + ]: 554 : if (!input.m_tap_script_sigs.empty()) {
1355 : 100 : UniValue script_sigs(UniValue::VARR);
1356 [ + + ]: 257 : for (const auto& [pubkey_leaf, sig] : input.m_tap_script_sigs) {
1357 : 157 : const auto& [xonly, leaf_hash] = pubkey_leaf;
1358 : 157 : UniValue sigobj(UniValue::VOBJ);
1359 [ + - + - : 314 : sigobj.pushKV("pubkey", HexStr(xonly));
+ - + - ]
1360 [ + - + - : 314 : sigobj.pushKV("leaf_hash", HexStr(leaf_hash));
+ - + - ]
1361 [ - + + - : 314 : sigobj.pushKV("sig", HexStr(sig));
+ - + - +
- ]
1362 [ + - ]: 157 : script_sigs.push_back(std::move(sigobj));
1363 : 157 : }
1364 [ + - + - ]: 200 : in.pushKV("taproot_script_path_sigs", std::move(script_sigs));
1365 : 100 : }
1366 : :
1367 : : // Taproot leaf scripts
1368 [ + + ]: 554 : if (!input.m_tap_scripts.empty()) {
1369 : 211 : UniValue tap_scripts(UniValue::VARR);
1370 [ + + ]: 530 : for (const auto& [leaf, control_blocks] : input.m_tap_scripts) {
1371 : 319 : const auto& [script, leaf_ver] = leaf;
1372 : 319 : UniValue script_info(UniValue::VOBJ);
1373 [ - + + - : 638 : script_info.pushKV("script", HexStr(script));
+ - + - +
- ]
1374 [ + - + - : 638 : script_info.pushKV("leaf_ver", leaf_ver);
+ - ]
1375 : 319 : UniValue control_blocks_univ(UniValue::VARR);
1376 [ + + ]: 714 : for (const auto& control_block : control_blocks) {
1377 [ - + + - : 395 : control_blocks_univ.push_back(HexStr(control_block));
+ - + - ]
1378 : : }
1379 [ + - + - ]: 638 : script_info.pushKV("control_blocks", std::move(control_blocks_univ));
1380 [ + - ]: 319 : tap_scripts.push_back(std::move(script_info));
1381 : 319 : }
1382 [ + - + - ]: 422 : in.pushKV("taproot_scripts", std::move(tap_scripts));
1383 : 211 : }
1384 : :
1385 : : // Taproot bip32 keypaths
1386 [ + + ]: 554 : if (!input.m_tap_bip32_paths.empty()) {
1387 : 291 : UniValue keypaths(UniValue::VARR);
1388 [ + + ]: 1352 : for (const auto& [xonly, leaf_origin] : input.m_tap_bip32_paths) {
1389 : 1061 : const auto& [leaf_hashes, origin] = leaf_origin;
1390 : 1061 : UniValue path_obj(UniValue::VOBJ);
1391 [ + - + - : 2122 : path_obj.pushKV("pubkey", HexStr(xonly));
+ - + - ]
1392 [ + - + - : 2122 : path_obj.pushKV("master_fingerprint", strprintf("%08x", ReadBE32(origin.fingerprint.data())));
+ - + - ]
1393 [ + - + - : 2122 : path_obj.pushKV("path", WriteHDKeypath(origin.path));
+ - + - ]
1394 : 1061 : UniValue leaf_hashes_arr(UniValue::VARR);
1395 [ + + ]: 1780 : for (const auto& leaf_hash : leaf_hashes) {
1396 [ + - + - : 719 : leaf_hashes_arr.push_back(HexStr(leaf_hash));
+ - ]
1397 : : }
1398 [ + - + - ]: 2122 : path_obj.pushKV("leaf_hashes", std::move(leaf_hashes_arr));
1399 [ + - ]: 1061 : keypaths.push_back(std::move(path_obj));
1400 : 1061 : }
1401 [ + - + - ]: 582 : in.pushKV("taproot_bip32_derivs", std::move(keypaths));
1402 : 291 : }
1403 : :
1404 : : // Taproot internal key
1405 [ + + ]: 1108 : if (!input.m_tap_internal_key.IsNull()) {
1406 [ + - + - : 516 : in.pushKV("taproot_internal_key", HexStr(input.m_tap_internal_key));
+ - + - ]
1407 : : }
1408 : :
1409 : : // Write taproot merkle root
1410 [ + + ]: 1108 : if (!input.m_tap_merkle_root.IsNull()) {
1411 [ + - + - : 410 : in.pushKV("taproot_merkle_root", HexStr(input.m_tap_merkle_root));
+ - + - ]
1412 : : }
1413 : :
1414 : : // Write MuSig2 fields
1415 [ + + ]: 554 : if (!input.m_musig2_participants.empty()) {
1416 : 122 : UniValue musig_pubkeys(UniValue::VARR);
1417 [ + + ]: 279 : for (const auto& [agg, parts] : input.m_musig2_participants) {
1418 : 157 : UniValue musig_part(UniValue::VOBJ);
1419 [ + - + - : 314 : musig_part.pushKV("aggregate_pubkey", HexStr(agg));
+ - + - ]
1420 : 157 : UniValue part_pubkeys(UniValue::VARR);
1421 [ + + ]: 591 : for (const auto& pub : parts) {
1422 [ + - + - : 434 : part_pubkeys.push_back(HexStr(pub));
+ - ]
1423 : : }
1424 [ + - + - : 314 : musig_part.pushKV("participant_pubkeys", part_pubkeys);
+ - ]
1425 [ + - + - ]: 157 : musig_pubkeys.push_back(musig_part);
1426 : 157 : }
1427 [ + - + - : 244 : in.pushKV("musig2_participant_pubkeys", musig_pubkeys);
+ - ]
1428 : 122 : }
1429 [ + + ]: 554 : if (!input.m_musig2_pubnonces.empty()) {
1430 : 97 : UniValue musig_pubnonces(UniValue::VARR);
1431 [ + + ]: 226 : for (const auto& [agg_lh, part_pubnonce] : input.m_musig2_pubnonces) {
1432 : 129 : const auto& [agg, lh] = agg_lh;
1433 [ + + ]: 475 : for (const auto& [part, pubnonce] : part_pubnonce) {
1434 : 346 : UniValue info(UniValue::VOBJ);
1435 [ + - + - : 692 : info.pushKV("participant_pubkey", HexStr(part));
+ - + - ]
1436 [ + - + - : 692 : info.pushKV("aggregate_pubkey", HexStr(agg));
+ - + - ]
1437 [ + + + - : 883 : if (!lh.IsNull()) info.pushKV("leaf_hash", HexStr(lh));
+ - + - +
- ]
1438 [ - + + - : 692 : info.pushKV("pubnonce", HexStr(pubnonce));
+ - + - +
- ]
1439 [ + - + - ]: 346 : musig_pubnonces.push_back(info);
1440 : 346 : }
1441 : : }
1442 [ + - + - : 194 : in.pushKV("musig2_pubnonces", musig_pubnonces);
+ - ]
1443 : 97 : }
1444 [ + + ]: 554 : if (!input.m_musig2_partial_sigs.empty()) {
1445 : 48 : UniValue musig_partial_sigs(UniValue::VARR);
1446 [ + + ]: 108 : for (const auto& [agg_lh, part_psig] : input.m_musig2_partial_sigs) {
1447 : 60 : const auto& [agg, lh] = agg_lh;
1448 [ + + ]: 225 : for (const auto& [part, psig] : part_psig) {
1449 : 165 : UniValue info(UniValue::VOBJ);
1450 [ + - + - : 330 : info.pushKV("participant_pubkey", HexStr(part));
+ - + - ]
1451 [ + - + - : 330 : info.pushKV("aggregate_pubkey", HexStr(agg));
+ - + - ]
1452 [ + + + - : 424 : if (!lh.IsNull()) info.pushKV("leaf_hash", HexStr(lh));
+ - + - +
- ]
1453 [ + - + - : 330 : info.pushKV("partial_sig", HexStr(psig));
+ - + - ]
1454 [ + - + - ]: 165 : musig_partial_sigs.push_back(info);
1455 : 165 : }
1456 : : }
1457 [ + - + - : 96 : in.pushKV("musig2_partial_sigs", musig_partial_sigs);
+ - ]
1458 : 48 : }
1459 : :
1460 : : // Proprietary
1461 [ + + ]: 554 : if (!input.m_proprietary.empty()) {
1462 : 2 : UniValue proprietary(UniValue::VARR);
1463 [ + + ]: 5 : for (const auto& entry : input.m_proprietary) {
1464 : 3 : UniValue this_prop(UniValue::VOBJ);
1465 [ - + + - : 6 : this_prop.pushKV("identifier", HexStr(entry.identifier));
+ - + - +
- ]
1466 [ + - + - : 6 : this_prop.pushKV("subtype", entry.subtype);
+ - ]
1467 [ - + + - : 6 : this_prop.pushKV("key", HexStr(entry.key));
+ - + - +
- ]
1468 [ - + + - : 6 : this_prop.pushKV("value", HexStr(entry.value));
+ - + - +
- ]
1469 [ + - ]: 3 : proprietary.push_back(std::move(this_prop));
1470 : 3 : }
1471 [ + - + - ]: 4 : in.pushKV("proprietary", std::move(proprietary));
1472 : 2 : }
1473 : :
1474 : : // Unknown data
1475 [ + + ]: 554 : if (input.unknown.size() > 0) {
1476 : 10 : UniValue unknowns(UniValue::VOBJ);
1477 [ + - - + : 24 : for (auto [key, value] : input.unknown) {
+ + ]
1478 [ - + + - : 42 : unknowns.pushKVEnd(HexStr(key), HexStr(value));
+ - + - +
- ]
1479 [ - - ]: 14 : }
1480 [ + - + - ]: 20 : in.pushKV("unknown", std::move(unknowns));
1481 : 10 : }
1482 : :
1483 [ + - ]: 554 : inputs.push_back(std::move(in));
1484 : 554 : }
1485 [ + - + - ]: 960 : result.pushKV("inputs", std::move(inputs));
1486 : :
1487 : : // outputs
1488 : 480 : CAmount output_value = 0;
1489 : 480 : UniValue outputs(UniValue::VARR);
1490 [ - + + + ]: 1325 : for (unsigned int i = 0; i < psbtx.outputs.size(); ++i) {
1491 : 845 : const PSBTOutput& output = psbtx.outputs[i];
1492 : 845 : UniValue out(UniValue::VOBJ);
1493 : : // Redeem script and witness script
1494 [ - + + + ]: 845 : if (!output.redeem_script.empty()) {
1495 : 16 : UniValue r(UniValue::VOBJ);
1496 [ + - ]: 16 : ScriptToUniv(output.redeem_script, /*out=*/r);
1497 [ + - + - ]: 32 : out.pushKV("redeem_script", std::move(r));
1498 : 16 : }
1499 [ + + + + ]: 857 : if (!output.witness_script.empty()) {
1500 : 12 : UniValue r(UniValue::VOBJ);
1501 [ + - ]: 12 : ScriptToUniv(output.witness_script, /*out=*/r);
1502 [ + - + - ]: 24 : out.pushKV("witness_script", std::move(r));
1503 : 12 : }
1504 : :
1505 : : // keypaths
1506 [ + + ]: 845 : if (!output.hd_keypaths.empty()) {
1507 : 136 : UniValue keypaths(UniValue::VARR);
1508 [ + - + + ]: 288 : for (auto entry : output.hd_keypaths) {
1509 : 152 : UniValue keypath(UniValue::VOBJ);
1510 [ + - + - : 304 : keypath.pushKV("pubkey", HexStr(entry.first));
+ - + - ]
1511 [ + - + - : 304 : keypath.pushKV("master_fingerprint", strprintf("%08x", ReadBE32(entry.second.fingerprint.data())));
+ - + - ]
1512 [ + - + - : 304 : keypath.pushKV("path", WriteHDKeypath(entry.second.path));
+ - + - ]
1513 [ + - ]: 152 : keypaths.push_back(std::move(keypath));
1514 : 152 : }
1515 [ + - + - ]: 272 : out.pushKV("bip32_derivs", std::move(keypaths));
1516 : 136 : }
1517 : :
1518 : : // PSBTv2 stuff
1519 [ + - + + ]: 845 : if (psbtx.GetVersion() >= 2) {
1520 [ + - + - : 1536 : out.pushKV("amount", ValueFromAmount(output.amount));
+ - ]
1521 : 768 : UniValue spk(UniValue::VOBJ);
1522 [ + - ]: 768 : ScriptToUniv(output.script, spk, /*include_hex=*/true, /*include_address=*/true);
1523 [ + - + - : 1536 : out.pushKV("script", spk);
+ - ]
1524 : 768 : }
1525 : :
1526 : : // Taproot internal key
1527 [ + + ]: 1690 : if (!output.m_tap_internal_key.IsNull()) {
1528 [ + - + - : 480 : out.pushKV("taproot_internal_key", HexStr(output.m_tap_internal_key));
+ - + - ]
1529 : : }
1530 : :
1531 : : // Taproot tree
1532 [ + + ]: 845 : if (!output.m_tap_tree.empty()) {
1533 : 183 : UniValue tree(UniValue::VARR);
1534 [ + + ]: 564 : for (const auto& [depth, leaf_ver, script] : output.m_tap_tree) {
1535 : 381 : UniValue elem(UniValue::VOBJ);
1536 [ + - + - : 762 : elem.pushKV("depth", depth);
+ - ]
1537 [ + - + - : 762 : elem.pushKV("leaf_ver", leaf_ver);
+ - ]
1538 [ - + + - : 762 : elem.pushKV("script", HexStr(script));
+ - + - +
- ]
1539 [ + - ]: 381 : tree.push_back(std::move(elem));
1540 : 381 : }
1541 [ + - + - ]: 366 : out.pushKV("taproot_tree", std::move(tree));
1542 : 183 : }
1543 : :
1544 : : // Taproot bip32 keypaths
1545 [ + + ]: 845 : if (!output.m_tap_bip32_paths.empty()) {
1546 : 278 : UniValue keypaths(UniValue::VARR);
1547 [ + + ]: 1296 : for (const auto& [xonly, leaf_origin] : output.m_tap_bip32_paths) {
1548 : 1018 : const auto& [leaf_hashes, origin] = leaf_origin;
1549 : 1018 : UniValue path_obj(UniValue::VOBJ);
1550 [ + - + - : 2036 : path_obj.pushKV("pubkey", HexStr(xonly));
+ - + - ]
1551 [ + - + - : 2036 : path_obj.pushKV("master_fingerprint", strprintf("%08x", ReadBE32(origin.fingerprint.data())));
+ - + - ]
1552 [ + - + - : 2036 : path_obj.pushKV("path", WriteHDKeypath(origin.path));
+ - + - ]
1553 : 1018 : UniValue leaf_hashes_arr(UniValue::VARR);
1554 [ + + ]: 1723 : for (const auto& leaf_hash : leaf_hashes) {
1555 [ + - + - : 705 : leaf_hashes_arr.push_back(HexStr(leaf_hash));
+ - ]
1556 : : }
1557 [ + - + - ]: 2036 : path_obj.pushKV("leaf_hashes", std::move(leaf_hashes_arr));
1558 [ + - ]: 1018 : keypaths.push_back(std::move(path_obj));
1559 : 1018 : }
1560 [ + - + - ]: 556 : out.pushKV("taproot_bip32_derivs", std::move(keypaths));
1561 : 278 : }
1562 : :
1563 : : // Write MuSig2 fields
1564 [ + + ]: 845 : if (!output.m_musig2_participants.empty()) {
1565 : 133 : UniValue musig_pubkeys(UniValue::VARR);
1566 [ + + ]: 308 : for (const auto& [agg, parts] : output.m_musig2_participants) {
1567 : 175 : UniValue musig_part(UniValue::VOBJ);
1568 [ + - + - : 350 : musig_part.pushKV("aggregate_pubkey", HexStr(agg));
+ - + - ]
1569 : 175 : UniValue part_pubkeys(UniValue::VARR);
1570 [ + + ]: 663 : for (const auto& pub : parts) {
1571 [ + - + - : 488 : part_pubkeys.push_back(HexStr(pub));
+ - ]
1572 : : }
1573 [ + - + - : 350 : musig_part.pushKV("participant_pubkeys", part_pubkeys);
+ - ]
1574 [ + - + - ]: 175 : musig_pubkeys.push_back(musig_part);
1575 : 175 : }
1576 [ + - + - : 266 : out.pushKV("musig2_participant_pubkeys", musig_pubkeys);
+ - ]
1577 : 133 : }
1578 : :
1579 : : // Proprietary
1580 [ + + ]: 845 : if (!output.m_proprietary.empty()) {
1581 : 2 : UniValue proprietary(UniValue::VARR);
1582 [ + + ]: 5 : for (const auto& entry : output.m_proprietary) {
1583 : 3 : UniValue this_prop(UniValue::VOBJ);
1584 [ - + + - : 6 : this_prop.pushKV("identifier", HexStr(entry.identifier));
+ - + - +
- ]
1585 [ + - + - : 6 : this_prop.pushKV("subtype", entry.subtype);
+ - ]
1586 [ - + + - : 6 : this_prop.pushKV("key", HexStr(entry.key));
+ - + - +
- ]
1587 [ - + + - : 6 : this_prop.pushKV("value", HexStr(entry.value));
+ - + - +
- ]
1588 [ + - ]: 3 : proprietary.push_back(std::move(this_prop));
1589 : 3 : }
1590 [ + - + - ]: 4 : out.pushKV("proprietary", std::move(proprietary));
1591 : 2 : }
1592 : :
1593 : : // Unknown data
1594 [ + + ]: 845 : if (output.unknown.size() > 0) {
1595 : 10 : UniValue unknowns(UniValue::VOBJ);
1596 [ + - - + : 24 : for (auto [key, value] : output.unknown) {
+ + ]
1597 [ - + + - : 42 : unknowns.pushKVEnd(HexStr(key), HexStr(value));
+ - + - +
- ]
1598 [ - - ]: 14 : }
1599 [ + - + - ]: 20 : out.pushKV("unknown", std::move(unknowns));
1600 : 10 : }
1601 : :
1602 [ + - ]: 845 : outputs.push_back(std::move(out));
1603 : :
1604 : : // Fee calculation
1605 [ + - - + ]: 845 : if (MoneyRange(output.amount) && MoneyRange(output_value + output.amount)) {
1606 : : output_value += output.amount;
1607 : : } else {
1608 : : // Hack to just not show fee later
1609 : : have_all_utxos = false;
1610 : : }
1611 : 845 : }
1612 [ + - + - ]: 960 : result.pushKV("outputs", std::move(outputs));
1613 [ + + ]: 480 : if (have_all_utxos) {
1614 [ + - + - : 882 : result.pushKV("fee", ValueFromAmount(total_in - output_value));
+ - ]
1615 : : }
1616 : :
1617 : 960 : return result;
1618 : 480 : },
1619 [ + - + - : 15625 : };
+ + - - ]
1620 [ + - + - : 150000 : }
+ - + - +
- + - + -
+ - + - +
- + - + -
+ - + - +
- + - + -
+ - + - +
- + - + -
+ - + - +
- + - + -
+ - + - +
- + - - -
- - - - ]
1621 : :
1622 : 2679 : static RPCMethod combinepsbt()
1623 : : {
1624 : 2679 : return RPCMethod{
1625 : 2679 : "combinepsbt",
1626 [ + - ]: 5358 : "Combine multiple partially signed Bitcoin transactions into one transaction.\n"
1627 : : "Implements the Combiner role.\n",
1628 : : {
1629 [ + - + - ]: 5358 : {"txs", RPCArg::Type::ARR, RPCArg::Optional::NO, "The base64 strings of partially signed transactions",
1630 : : {
1631 [ + - + - ]: 5358 : {"psbt", RPCArg::Type::STR, RPCArg::Optional::OMITTED, "A base64 string of a PSBT"},
1632 : : },
1633 : : },
1634 : : },
1635 [ + - ]: 5358 : RPCResult{
1636 [ + - + - ]: 5358 : RPCResult::Type::STR, "", "The base64-encoded partially signed transaction"
1637 [ + - ]: 5358 : },
1638 : 2679 : RPCExamples{
1639 [ + - + - : 5358 : HelpExampleCli("combinepsbt", R"('["mybase64_1", "mybase64_2", "mybase64_3"]')")
+ - ]
1640 [ + - ]: 2679 : },
1641 : 2679 : [](const RPCMethod& self, const JSONRPCRequest& request) -> UniValue
1642 : : {
1643 : : // Unserialize the transactions
1644 : 121 : std::vector<PartiallySignedTransaction> psbtxs;
1645 [ + - + - : 121 : UniValue txs = request.params[0].get_array();
+ - ]
1646 [ - + + + ]: 121 : if (txs.empty()) {
1647 [ + - + - ]: 2 : throw JSONRPCError(RPC_INVALID_PARAMETER, "Parameter 'txs' cannot be empty");
1648 : : }
1649 [ - + + + ]: 454 : for (unsigned int i = 0; i < txs.size(); ++i) {
1650 [ + - + - : 334 : util::Result<PartiallySignedTransaction> psbt_res = DecodeBase64PSBT(txs[i].get_str());
+ - ]
1651 [ - + ]: 334 : if (!psbt_res) {
1652 [ # # # # : 0 : throw JSONRPCError(RPC_DESERIALIZATION_ERROR, strprintf("TX decode failed %s", util::ErrorString(psbt_res).original));
# # ]
1653 : : }
1654 [ + - ]: 334 : psbtxs.push_back(*psbt_res);
1655 : 334 : }
1656 : :
1657 [ + - ]: 120 : std::optional<PartiallySignedTransaction> merged_psbt = CombinePSBTs(psbtxs);
1658 [ + + ]: 120 : if (!merged_psbt) {
1659 [ + - + - ]: 2 : throw JSONRPCError(RPC_INVALID_PARAMETER, "PSBTs not compatible (different transactions)");
1660 : : }
1661 : :
1662 : 119 : DataStream ssTx{};
1663 [ + - ]: 119 : ssTx << *merged_psbt;
1664 [ - + + - : 357 : return EncodeBase64(ssTx);
+ - ]
1665 : 123 : },
1666 [ + - + - : 21432 : };
+ - + + +
+ - - -
- ]
1667 [ + - + - ]: 10716 : }
1668 : :
1669 : 2821 : static RPCMethod finalizepsbt()
1670 : : {
1671 : 2821 : return RPCMethod{"finalizepsbt",
1672 [ + - ]: 5642 : "Finalize the inputs of a PSBT. If the transaction is fully signed, it will produce a\n"
1673 : : "network serialized transaction which can be broadcast with sendrawtransaction. Otherwise a PSBT will be\n"
1674 : : "created which has the final_scriptSig and final_scriptwitness fields filled for inputs that are complete.\n"
1675 : : "Implements the Finalizer and Extractor roles.\n",
1676 : : {
1677 [ + - + - ]: 5642 : {"psbt", RPCArg::Type::STR, RPCArg::Optional::NO, "A base64 string of a PSBT"},
1678 [ + - + - : 8463 : {"extract", RPCArg::Type::BOOL, RPCArg::Default{true}, "If true and the transaction is complete,\n"
+ - ]
1679 : : " extract and return the complete transaction in normal network serialization instead of the PSBT."},
1680 : : },
1681 [ + - ]: 5642 : RPCResult{
1682 [ + - + - ]: 5642 : RPCResult::Type::OBJ, "", "",
1683 : : {
1684 [ + - + - ]: 5642 : {RPCResult::Type::STR, "psbt", /*optional=*/true, "The base64-encoded partially signed transaction if not extracted"},
1685 [ + - + - ]: 5642 : {RPCResult::Type::STR_HEX, "hex", /*optional=*/true, "The hex-encoded network transaction if extracted"},
1686 [ + - + - ]: 5642 : {RPCResult::Type::BOOL, "complete", "If the transaction has a complete set of signatures"},
1687 : : }
1688 [ + - + - : 22568 : },
+ + - - ]
1689 : 2821 : RPCExamples{
1690 [ + - + - : 5642 : HelpExampleCli("finalizepsbt", "\"psbt\"")
+ - ]
1691 [ + - ]: 2821 : },
1692 : 2821 : [](const RPCMethod& self, const JSONRPCRequest& request) -> UniValue
1693 : : {
1694 : : // Unserialize the transactions
1695 : 263 : util::Result<PartiallySignedTransaction> psbt_res = DecodeBase64PSBT(request.params[0].get_str());
1696 [ + + ]: 263 : if (!psbt_res) {
1697 [ + - + - : 3 : throw JSONRPCError(RPC_DESERIALIZATION_ERROR, strprintf("TX decode failed %s", util::ErrorString(psbt_res).original));
+ - ]
1698 : : }
1699 [ + - ]: 262 : PartiallySignedTransaction psbtx = *psbt_res;
1700 : :
1701 [ + - + + : 262 : bool extract = request.params[1].isNull() || (!request.params[1].isNull() && request.params[1].get_bool());
+ - + - +
- + - +
+ ]
1702 : :
1703 [ + - ]: 262 : CMutableTransaction mtx;
1704 [ + - ]: 262 : bool complete = FinalizeAndExtractPSBT(psbtx, mtx);
1705 : :
1706 : 262 : UniValue result(UniValue::VOBJ);
1707 : 262 : DataStream ssTx{};
1708 [ + + ]: 262 : std::string result_str;
1709 : :
1710 [ + + + + ]: 262 : if (complete && extract) {
1711 [ + - ]: 206 : ssTx << TX_WITH_WITNESS(mtx);
1712 [ - + + - ]: 206 : result_str = HexStr(ssTx);
1713 [ + - + - : 412 : result.pushKV("hex", result_str);
+ - ]
1714 : : } else {
1715 [ + - ]: 56 : ssTx << psbtx;
1716 [ + - + - ]: 112 : result_str = EncodeBase64(ssTx.str());
1717 [ + - + - : 112 : result.pushKV("psbt", result_str);
+ - ]
1718 : : }
1719 [ + - + - : 524 : result.pushKV("complete", complete);
+ - ]
1720 : :
1721 : 262 : return result;
1722 : 524 : },
1723 [ + - + - : 16926 : };
+ + - - ]
1724 [ + - + - : 28210 : }
+ - + - +
- - - -
- ]
1725 : :
1726 : 2629 : static RPCMethod createpsbt()
1727 : : {
1728 : 2629 : return RPCMethod{
1729 : 2629 : "createpsbt",
1730 [ + - ]: 5258 : "Creates a transaction in the Partially Signed Transaction format.\n"
1731 : : "Implements the Creator role.\n"
1732 : : "Note that the transaction's inputs are not signed, and\n"
1733 : : "it is not stored in the wallet or transmitted to the network.\n",
1734 [ + - + - : 10516 : Cat<std::vector<RPCArg>>(
+ + - - ]
1735 [ + - ]: 5258 : CreateTxDoc(),
1736 : : {
1737 [ + - + - : 7887 : {"psbt_version", RPCArg::Type::NUM, RPCArg::Default{2}, "The PSBT version number to use."},
+ - ]
1738 : : }
1739 : : ),
1740 [ + - ]: 5258 : RPCResult{
1741 [ + - + - ]: 5258 : RPCResult::Type::STR, "", "The resulting raw transaction (base64-encoded string)"
1742 [ + - ]: 5258 : },
1743 : 2629 : RPCExamples{
1744 [ + - + - : 5258 : HelpExampleCli("createpsbt", "\"[{\\\"txid\\\":\\\"myid\\\",\\\"vout\\\":0}]\" \"[{\\\"address\\\":0.01}]\"")
+ - ]
1745 [ + - ]: 2629 : },
1746 : 2629 : [](const RPCMethod& self, const JSONRPCRequest& request) -> UniValue
1747 : : {
1748 : 71 : std::optional<bool> rbf;
1749 [ + + ]: 71 : if (!request.params[3].isNull()) {
1750 : 1 : rbf = request.params[3].get_bool();
1751 : : }
1752 : 71 : CMutableTransaction rawTx = ConstructTransaction(request.params[0], request.params[1], request.params[2], rbf, self.Arg<uint32_t>("version"));
1753 : :
1754 : : // Make a blank psbt
1755 : 71 : uint32_t psbt_version = 2;
1756 [ + - + + ]: 71 : if (!request.params[5].isNull()) {
1757 [ + - + - ]: 11 : psbt_version = request.params[5].getInt<uint32_t>();
1758 : : }
1759 [ + + ]: 71 : if (psbt_version != 2 && psbt_version != 0) {
1760 [ + - + - ]: 2 : throw JSONRPCError(RPC_INVALID_PARAMETER, "The PSBT version can only be 2 or 0");
1761 : : }
1762 [ + - ]: 70 : PartiallySignedTransaction psbtx(rawTx, psbt_version);
1763 : :
1764 : : // Serialize the PSBT
1765 : 70 : DataStream ssTx{};
1766 [ + - ]: 70 : ssTx << psbtx;
1767 : :
1768 [ - + + - : 140 : return EncodeBase64(ssTx);
+ - ]
1769 : 140 : },
1770 [ + - ]: 5258 : };
1771 [ + - ]: 5258 : }
1772 : :
1773 : 2570 : static RPCMethod converttopsbt()
1774 : : {
1775 : 2570 : return RPCMethod{
1776 : 2570 : "converttopsbt",
1777 [ + - ]: 5140 : "Converts a network serialized transaction to a PSBT. This should be used only with createrawtransaction and fundrawtransaction\n"
1778 : : "createpsbt and walletcreatefundedpsbt should be used for new applications.\n",
1779 : : {
1780 [ + - + - ]: 5140 : {"hexstring", RPCArg::Type::STR_HEX, RPCArg::Optional::NO, "The hex string of a raw transaction"},
1781 [ + - + - : 7710 : {"permitsigdata", RPCArg::Type::BOOL, RPCArg::Default{false}, "If true, any signatures in the input will be discarded and conversion\n"
+ - ]
1782 : : " will continue. If false, RPC will fail if any signatures are present."},
1783 [ + - + - : 7710 : {"iswitness", RPCArg::Type::BOOL, RPCArg::DefaultHint{"depends on heuristic tests"}, "Whether the transaction hex is a serialized witness transaction.\n"
+ - ]
1784 : : "If iswitness is not present, heuristic tests will be used in decoding.\n"
1785 : : "If true, only witness deserialization will be tried.\n"
1786 : : "If false, only non-witness deserialization will be tried.\n"
1787 : : "This boolean should reflect whether the transaction has inputs\n"
1788 : : "(e.g. fully valid, or on-chain transactions), if known by the caller."
1789 : : },
1790 [ + - + - : 7710 : {"psbt_version", RPCArg::Type::NUM, RPCArg::Default{2}, "The PSBT version number to use."},
+ - ]
1791 : : },
1792 [ + - ]: 5140 : RPCResult{
1793 [ + - + - ]: 5140 : RPCResult::Type::STR, "", "The resulting raw transaction (base64-encoded string)"
1794 [ + - ]: 5140 : },
1795 : 2570 : RPCExamples{
1796 : : "\nCreate a transaction\n"
1797 [ + - + - : 5140 : + HelpExampleCli("createrawtransaction", "\"[{\\\"txid\\\":\\\"myid\\\",\\\"vout\\\":0}]\" \"[{\\\"data\\\":\\\"00010203\\\"}]\"") +
+ - + - ]
1798 : 2570 : "\nConvert the transaction to a PSBT\n"
1799 [ + - + - : 10280 : + HelpExampleCli("converttopsbt", "\"rawtransaction\"")
+ - + - ]
1800 [ + - ]: 2570 : },
1801 : 2570 : [](const RPCMethod& self, const JSONRPCRequest& request) -> UniValue
1802 : : {
1803 : : // parse hex string from parameter
1804 : 12 : CMutableTransaction tx;
1805 [ + - + + : 12 : bool permitsigdata = request.params[1].isNull() ? false : request.params[1].get_bool();
+ - + - ]
1806 [ + - + + ]: 12 : bool witness_specified = !request.params[2].isNull();
1807 [ + + + - : 12 : bool iswitness = witness_specified ? request.params[2].get_bool() : false;
+ - ]
1808 : 1 : const bool try_witness = witness_specified ? iswitness : true;
1809 : 1 : const bool try_no_witness = witness_specified ? !iswitness : true;
1810 [ + - + - : 12 : if (!DecodeHexTx(tx, request.params[0].get_str(), try_no_witness, try_witness)) {
+ - - + ]
1811 [ # # # # ]: 0 : throw JSONRPCError(RPC_DESERIALIZATION_ERROR, "TX decode failed");
1812 : : }
1813 : :
1814 : : // Remove all scriptSigs and scriptWitnesses from inputs
1815 [ + + ]: 24 : for (CTxIn& input : tx.vin) {
1816 [ - + + - : 15 : if ((!input.scriptSig.empty() || !input.scriptWitness.IsNull()) && !permitsigdata) {
+ + + + ]
1817 [ + - + - ]: 6 : throw JSONRPCError(RPC_DESERIALIZATION_ERROR, "Inputs must not have scriptSigs and scriptWitnesses");
1818 : : }
1819 : 12 : input.scriptSig.clear();
1820 : 12 : input.scriptWitness.SetNull();
1821 : : }
1822 : :
1823 : : // Make a blank psbt
1824 : 9 : uint32_t psbt_version = 2;
1825 [ + - + + ]: 9 : if (!request.params[3].isNull()) {
1826 [ + - + - ]: 3 : psbt_version = request.params[3].getInt<uint32_t>();
1827 : : }
1828 [ + + ]: 9 : if (psbt_version != 2 && psbt_version != 0) {
1829 [ + - + - ]: 2 : throw JSONRPCError(RPC_INVALID_PARAMETER, "The PSBT version can only be 2 or 0");
1830 : : }
1831 [ + - ]: 8 : PartiallySignedTransaction psbtx(tx, psbt_version);
1832 : :
1833 : : // Serialize the PSBT
1834 : 8 : DataStream ssTx{};
1835 [ + - ]: 8 : ssTx << psbtx;
1836 : :
1837 [ - + + - : 16 : return EncodeBase64(ssTx);
+ - ]
1838 : 16 : },
1839 [ + - + - : 20560 : };
+ + - - ]
1840 [ + - + - : 20560 : }
+ - + - -
- ]
1841 : :
1842 : 2563 : static RPCMethod utxoupdatepsbt()
1843 : : {
1844 : 2563 : return RPCMethod{
1845 : 2563 : "utxoupdatepsbt",
1846 [ + - ]: 5126 : "Updates all segwit inputs and outputs in a PSBT with data from output descriptors, the UTXO set, txindex, or the mempool.\n",
1847 : : {
1848 [ + - + - ]: 5126 : {"psbt", RPCArg::Type::STR, RPCArg::Optional::NO, "A base64 string of a PSBT"},
1849 [ + - + - ]: 5126 : {"descriptors", RPCArg::Type::ARR, RPCArg::Optional::OMITTED, "An array of either strings or objects", {
1850 [ + - + - ]: 5126 : {"", RPCArg::Type::STR, RPCArg::Optional::OMITTED, "An output descriptor"},
1851 [ + - + - ]: 5126 : {"", RPCArg::Type::OBJ, RPCArg::Optional::OMITTED, "An object with an output descriptor and extra information", {
1852 [ + - + - ]: 5126 : {"desc", RPCArg::Type::STR, RPCArg::Optional::NO, "An output descriptor"},
1853 [ + - + - : 7689 : {"range", RPCArg::Type::RANGE, RPCArg::Default{1000}, "Up to what index HD chains should be explored (either end or [begin,end])"},
+ - ]
1854 : : }},
1855 : : }},
1856 : : },
1857 [ + - ]: 5126 : RPCResult {
1858 [ + - + - ]: 5126 : RPCResult::Type::STR, "", "The base64-encoded partially signed transaction with inputs updated"
1859 [ + - ]: 5126 : },
1860 : 2563 : RPCExamples {
1861 [ + - + - : 5126 : HelpExampleCli("utxoupdatepsbt", "\"psbt\"")
+ - ]
1862 [ + - ]: 2563 : },
1863 : 2563 : [](const RPCMethod& self, const JSONRPCRequest& request) -> UniValue
1864 : : {
1865 : : // Parse descriptors, if any.
1866 : 5 : FlatSigningProvider provider;
1867 [ + - + + ]: 5 : if (!request.params[1].isNull()) {
1868 [ + - + - : 1 : auto descs = request.params[1].get_array();
+ - ]
1869 [ - + + + ]: 4 : for (size_t i = 0; i < descs.size(); ++i) {
1870 [ + - + - ]: 3 : EvalDescriptorStringOrObject(descs[i], provider);
1871 : : }
1872 : 1 : }
1873 : :
1874 : : // We don't actually need private keys further on; hide them as a precaution.
1875 : 5 : const PartiallySignedTransaction& psbtx = ProcessPSBT(
1876 : 5 : request.params[0].get_str(),
1877 : 5 : request.context,
1878 [ + - ]: 5 : HidingSigningProvider(&provider, /*hide_secret=*/true, /*hide_origin=*/false),
1879 : : /*sighash_type=*/std::nullopt,
1880 [ + - + - : 5 : /*finalize=*/false);
+ - + - ]
1881 : :
1882 : 5 : DataStream ssTx{};
1883 [ + - ]: 5 : ssTx << psbtx;
1884 [ - + + - : 15 : return EncodeBase64(ssTx);
+ - ]
1885 : 5 : },
1886 [ + - + - : 35882 : };
+ - + - +
+ + + + +
- - - - -
- ]
1887 [ + - + - : 30756 : }
+ - + - +
- + - - -
- - - - ]
1888 : :
1889 : 2565 : static RPCMethod joinpsbts()
1890 : : {
1891 : 2565 : return RPCMethod{
1892 : 2565 : "joinpsbts",
1893 [ + - ]: 5130 : "Joins multiple distinct version 0 PSBTs with different inputs and outputs into one version 0 PSBT with inputs and outputs from all of the PSBTs\n"
1894 : : "No input in any of the PSBTs can be in more than one of the PSBTs.\n",
1895 : : {
1896 [ + - + - ]: 5130 : {"txs", RPCArg::Type::ARR, RPCArg::Optional::NO, "The base64 strings of partially signed transactions",
1897 : : {
1898 [ + - + - ]: 5130 : {"psbt", RPCArg::Type::STR, RPCArg::Optional::NO, "A base64 string of a PSBT"}
1899 : : }}
1900 : : },
1901 [ + - ]: 5130 : RPCResult {
1902 [ + - + - ]: 5130 : RPCResult::Type::STR, "", "The base64-encoded partially signed transaction"
1903 [ + - ]: 5130 : },
1904 : 2565 : RPCExamples {
1905 [ + - + - : 5130 : HelpExampleCli("joinpsbts", "\"psbt\"")
+ - ]
1906 [ + - ]: 2565 : },
1907 : 2565 : [](const RPCMethod& self, const JSONRPCRequest& request) -> UniValue
1908 : : {
1909 : : // Unserialize the transactions
1910 : 7 : std::vector<PartiallySignedTransaction> psbtxs;
1911 [ + - + - : 7 : UniValue txs = request.params[0].get_array();
+ - ]
1912 : :
1913 [ - + - + ]: 7 : if (txs.size() <= 1) {
1914 [ # # # # ]: 0 : throw JSONRPCError(RPC_INVALID_PARAMETER, "At least two PSBTs are required to join PSBTs.");
1915 : : }
1916 : :
1917 : : uint32_t best_version = 1;
1918 : : uint32_t best_locktime = 0xffffffff;
1919 [ - + + + ]: 20 : for (unsigned int i = 0; i < txs.size(); ++i) {
1920 [ + - + - : 14 : util::Result<PartiallySignedTransaction> psbt_res = DecodeBase64PSBT(txs[i].get_str());
+ - ]
1921 [ - + ]: 14 : if (!psbt_res) {
1922 [ # # # # : 0 : throw JSONRPCError(RPC_DESERIALIZATION_ERROR, strprintf("TX decode failed %s", util::ErrorString(psbt_res).original));
# # ]
1923 : : }
1924 [ + - ]: 14 : psbtxs.push_back(*psbt_res);
1925 : 14 : const PartiallySignedTransaction& psbtx = psbtxs.back();
1926 [ + - + + ]: 14 : if (psbtx.GetVersion() != 0) {
1927 [ + - + - ]: 2 : throw JSONRPCError(RPC_INVALID_PARAMETER, "joinpsbts only operates on version 0 PSBTs");
1928 : : }
1929 : : // Choose the highest version number
1930 [ + + ]: 13 : if (psbtx.tx_version > best_version) {
1931 : 7 : best_version = psbtx.tx_version;
1932 : : }
1933 : : // Choose the lowest lock time
1934 [ + - ]: 13 : uint32_t psbt_locktime = psbtx.fallback_locktime.value_or(0);
1935 [ + + ]: 13 : if (psbt_locktime < best_locktime) {
1936 : 7 : best_locktime = psbt_locktime;
1937 : : }
1938 : 14 : }
1939 : :
1940 : : // Create a blank psbt where everything will be added
1941 [ + - ]: 6 : CMutableTransaction tx;
1942 : 6 : tx.version = best_version;
1943 : 6 : tx.nLockTime = best_locktime;
1944 [ + - + - : 6 : PartiallySignedTransaction merged_psbt(tx, psbtxs.at(0).GetVersion());
+ - ]
1945 : :
1946 : : // Merge
1947 [ + + ]: 17 : for (auto& psbt : psbtxs) {
1948 [ + + ]: 33 : for (const PSBTInput& input : psbt.inputs) {
1949 [ + - + + ]: 22 : if (!merged_psbt.AddInput(input)) {
1950 [ + - + - : 2 : throw JSONRPCError(RPC_INVALID_PARAMETER, strprintf("Input %s:%d exists in multiple PSBTs", input.prev_txid.ToString(), input.prev_out));
+ - ]
1951 : : }
1952 : : }
1953 [ + + ]: 22 : for (const PSBTOutput& output : psbt.outputs) {
1954 [ + - ]: 11 : merged_psbt.AddOutput(output);
1955 : : }
1956 [ + - ]: 11 : merged_psbt.MergeGlobalXPubs(psbt);
1957 [ + - ]: 11 : merged_psbt.m_proprietary.insert(psbt.m_proprietary.begin(), psbt.m_proprietary.end());
1958 [ + - ]: 11 : merged_psbt.unknown.insert(psbt.unknown.begin(), psbt.unknown.end());
1959 : : }
1960 : :
1961 : : // Shuffle the inputs and outputs for privacy
1962 : 5 : std::shuffle(merged_psbt.inputs.begin(), merged_psbt.inputs.end(), FastRandomContext());
1963 : 5 : std::shuffle(merged_psbt.outputs.begin(), merged_psbt.outputs.end(), FastRandomContext());
1964 : :
1965 : 5 : DataStream ssTx{};
1966 [ + - ]: 5 : ssTx << merged_psbt;
1967 [ - + + - : 15 : return EncodeBase64(ssTx);
+ - ]
1968 : 15 : },
1969 [ + - + - : 20520 : };
+ - + + +
+ - - -
- ]
1970 [ + - + - ]: 10260 : }
1971 : :
1972 : 2573 : static RPCMethod analyzepsbt()
1973 : : {
1974 : 2573 : return RPCMethod{
1975 : 2573 : "analyzepsbt",
1976 [ + - ]: 5146 : "Analyzes and provides information about the current status of a PSBT and its inputs\n",
1977 : : {
1978 [ + - + - ]: 5146 : {"psbt", RPCArg::Type::STR, RPCArg::Optional::NO, "A base64 string of a PSBT"}
1979 : : },
1980 [ + - ]: 5146 : RPCResult {
1981 [ + - + - ]: 5146 : RPCResult::Type::OBJ, "", "",
1982 : : {
1983 [ + - + - ]: 5146 : {RPCResult::Type::ARR, "inputs", /*optional=*/true, "",
1984 : : {
1985 [ + - + - ]: 5146 : {RPCResult::Type::OBJ, "", "",
1986 : : {
1987 [ + - + - ]: 5146 : {RPCResult::Type::BOOL, "has_utxo", "Whether a UTXO is provided"},
1988 [ + - + - ]: 5146 : {RPCResult::Type::BOOL, "is_final", "Whether the input is finalized"},
1989 [ + - + - ]: 5146 : {RPCResult::Type::OBJ, "missing", /*optional=*/true, "Things that are missing that are required to complete this input",
1990 : : {
1991 [ + - + - ]: 5146 : {RPCResult::Type::ARR, "pubkeys", /*optional=*/true, "",
1992 : : {
1993 [ + - + - ]: 5146 : {RPCResult::Type::STR_HEX, "keyid", "Public key ID, hash160 of the public key, of a public key whose BIP 32 derivation path is missing"},
1994 : : }},
1995 [ + - + - ]: 5146 : {RPCResult::Type::ARR, "signatures", /*optional=*/true, "",
1996 : : {
1997 [ + - + - ]: 5146 : {RPCResult::Type::STR_HEX, "keyid", "Public key ID, hash160 of the public key, of a public key whose signature is missing"},
1998 : : }},
1999 [ + - + - ]: 5146 : {RPCResult::Type::STR_HEX, "redeemscript", /*optional=*/true, "Hash160 of the redeem script that is missing"},
2000 [ + - + - ]: 5146 : {RPCResult::Type::STR_HEX, "witnessscript", /*optional=*/true, "SHA256 of the witness script that is missing"},
2001 : : }},
2002 [ + - + - ]: 5146 : {RPCResult::Type::STR, "next", /*optional=*/true, "Role of the next person that this input needs to go to"},
2003 : : }},
2004 : : }},
2005 [ + - + - ]: 5146 : {RPCResult::Type::NUM, "estimated_vsize", /*optional=*/true, "Estimated vsize of the final signed transaction"},
2006 [ + - + - ]: 5146 : {RPCResult::Type::STR_AMOUNT, "estimated_feerate", /*optional=*/true, "Estimated feerate of the final signed transaction in " + CURRENCY_UNIT + "/kvB. Shown only if all UTXO slots in the PSBT have been filled"},
2007 [ + - + - ]: 5146 : {RPCResult::Type::STR_AMOUNT, "fee", /*optional=*/true, "The transaction fee paid. Shown only if all UTXO slots in the PSBT have been filled"},
2008 [ + - + - ]: 5146 : {RPCResult::Type::STR, "next", "Role of the next person that this psbt needs to go to"},
2009 [ + - + - ]: 5146 : {RPCResult::Type::STR, "error", /*optional=*/true, "Error message (if there is one)"},
2010 : : }
2011 [ + - + - : 105493 : },
+ - + - +
- + - + -
+ + + + +
+ + + + +
+ + - - -
- - - - -
- - - - ]
2012 : 2573 : RPCExamples {
2013 [ + - + - : 5146 : HelpExampleCli("analyzepsbt", "\"psbt\"")
+ - ]
2014 [ + - ]: 2573 : },
2015 : 2573 : [](const RPCMethod& self, const JSONRPCRequest& request) -> UniValue
2016 : : {
2017 : : // Unserialize the transaction
2018 : 15 : util::Result<PartiallySignedTransaction> psbt_res = DecodeBase64PSBT(request.params[0].get_str());
2019 [ + + ]: 15 : if (!psbt_res) {
2020 [ + - + - : 3 : throw JSONRPCError(RPC_DESERIALIZATION_ERROR, strprintf("TX decode failed %s", util::ErrorString(psbt_res).original));
+ - ]
2021 : : }
2022 : 14 : const PartiallySignedTransaction& psbtx = *psbt_res;
2023 : :
2024 [ + - + - ]: 14 : PSBTAnalysis psbta = AnalyzePSBT(psbtx);
2025 : :
2026 : 14 : UniValue result(UniValue::VOBJ);
2027 : 14 : UniValue inputs_result(UniValue::VARR);
2028 [ + + ]: 29 : for (const auto& input : psbta.inputs) {
2029 : 15 : UniValue input_univ(UniValue::VOBJ);
2030 : 15 : UniValue missing(UniValue::VOBJ);
2031 : :
2032 [ + - + - : 30 : input_univ.pushKV("has_utxo", input.has_utxo);
+ - ]
2033 [ + - + - : 30 : input_univ.pushKV("is_final", input.is_final);
+ - ]
2034 [ + - + - : 30 : input_univ.pushKV("next", PSBTRoleName(input.next));
+ - + - ]
2035 : :
2036 [ - + ]: 15 : if (!input.missing_pubkeys.empty()) {
2037 : 0 : UniValue missing_pubkeys_univ(UniValue::VARR);
2038 [ # # ]: 0 : for (const CKeyID& pubkey : input.missing_pubkeys) {
2039 [ # # # # : 0 : missing_pubkeys_univ.push_back(HexStr(pubkey));
# # ]
2040 : : }
2041 [ # # # # ]: 0 : missing.pushKV("pubkeys", std::move(missing_pubkeys_univ));
2042 : 0 : }
2043 [ - + ]: 30 : if (!input.missing_redeem_script.IsNull()) {
2044 [ # # # # : 0 : missing.pushKV("redeemscript", HexStr(input.missing_redeem_script));
# # # # ]
2045 : : }
2046 [ - + ]: 30 : if (!input.missing_witness_script.IsNull()) {
2047 [ # # # # : 0 : missing.pushKV("witnessscript", HexStr(input.missing_witness_script));
# # # # ]
2048 : : }
2049 [ + + ]: 15 : if (!input.missing_sigs.empty()) {
2050 : 1 : UniValue missing_sigs_univ(UniValue::VARR);
2051 [ + + ]: 2 : for (const CKeyID& pubkey : input.missing_sigs) {
2052 [ + - + - : 1 : missing_sigs_univ.push_back(HexStr(pubkey));
+ - ]
2053 : : }
2054 [ + - + - ]: 2 : missing.pushKV("signatures", std::move(missing_sigs_univ));
2055 : 1 : }
2056 [ + - + + ]: 15 : if (!missing.getKeys().empty()) {
2057 [ + - + - ]: 2 : input_univ.pushKV("missing", std::move(missing));
2058 : : }
2059 [ + - ]: 15 : inputs_result.push_back(std::move(input_univ));
2060 : 15 : }
2061 [ - + + + : 25 : if (!inputs_result.empty()) result.pushKV("inputs", std::move(inputs_result));
+ - + - ]
2062 : :
2063 [ + + ]: 14 : if (psbta.estimated_vsize != std::nullopt) {
2064 [ + - + - : 12 : result.pushKV("estimated_vsize", *psbta.estimated_vsize);
+ - ]
2065 : : }
2066 [ + + ]: 14 : if (psbta.estimated_feerate != std::nullopt) {
2067 [ + - + - : 12 : result.pushKV("estimated_feerate", ValueFromAmount(psbta.estimated_feerate->GetFeePerK()));
+ - ]
2068 : : }
2069 [ + + ]: 14 : if (psbta.fee != std::nullopt) {
2070 [ + - + - : 18 : result.pushKV("fee", ValueFromAmount(*psbta.fee));
+ - ]
2071 : : }
2072 [ + - + - : 28 : result.pushKV("next", PSBTRoleName(psbta.next));
+ - + - ]
2073 [ + + ]: 14 : if (!psbta.error.empty()) {
2074 [ + - + - : 6 : result.pushKV("error", psbta.error);
+ - ]
2075 : : }
2076 : :
2077 : 28 : return result;
2078 : 28 : },
2079 [ + - + - : 12865 : };
+ + - - ]
2080 [ + - + - : 92628 : }
+ - + - +
- + - + -
+ - + - +
- + - + -
+ - + - +
- + - + -
+ - - - -
- - - ]
2081 : :
2082 : 2579 : RPCMethod descriptorprocesspsbt()
2083 : : {
2084 : 2579 : return RPCMethod{
2085 : 2579 : "descriptorprocesspsbt",
2086 [ + - ]: 5158 : "Update all segwit inputs in a PSBT with information from output descriptors, the UTXO set or the mempool. \n"
2087 : : "Then, sign the inputs we are able to with information from the output descriptors. ",
2088 : : {
2089 [ + - + - ]: 5158 : {"psbt", RPCArg::Type::STR, RPCArg::Optional::NO, "The transaction base64 string"},
2090 [ + - + - ]: 5158 : {"descriptors", RPCArg::Type::ARR, RPCArg::Optional::NO, "An array of either strings or objects", {
2091 [ + - + - ]: 5158 : {"", RPCArg::Type::STR, RPCArg::Optional::OMITTED, "An output descriptor"},
2092 [ + - + - ]: 5158 : {"", RPCArg::Type::OBJ, RPCArg::Optional::OMITTED, "An object with an output descriptor and extra information", {
2093 [ + - + - ]: 5158 : {"desc", RPCArg::Type::STR, RPCArg::Optional::NO, "An output descriptor"},
2094 [ + - + - : 7737 : {"range", RPCArg::Type::RANGE, RPCArg::Default{1000}, "Up to what index HD chains should be explored (either end or [begin,end])"},
+ - ]
2095 : : }},
2096 : : }},
2097 [ + - + - : 7737 : {"sighashtype", RPCArg::Type::STR, RPCArg::DefaultHint{"DEFAULT for Taproot, ALL otherwise"}, "The signature hash type to sign with if not specified by the PSBT. Must be one of\n"
+ - ]
2098 : : " \"DEFAULT\"\n"
2099 : : " \"ALL\"\n"
2100 : : " \"NONE\"\n"
2101 : : " \"SINGLE\"\n"
2102 : : " \"ALL|ANYONECANPAY\"\n"
2103 : : " \"NONE|ANYONECANPAY\"\n"
2104 : : " \"SINGLE|ANYONECANPAY\""},
2105 [ + - + - : 7737 : {"bip32derivs", RPCArg::Type::BOOL, RPCArg::Default{true}, "Include BIP 32 derivation paths for public keys if we know them"},
+ - ]
2106 [ + - + - : 7737 : {"finalize", RPCArg::Type::BOOL, RPCArg::Default{true}, "Also finalize inputs if possible"},
+ - ]
2107 : : },
2108 [ + - ]: 5158 : RPCResult{
2109 [ + - + - ]: 5158 : RPCResult::Type::OBJ, "", "",
2110 : : {
2111 [ + - + - ]: 5158 : {RPCResult::Type::STR, "psbt", "The base64-encoded partially signed transaction"},
2112 [ + - + - ]: 5158 : {RPCResult::Type::BOOL, "complete", "If the transaction has a complete set of signatures"},
2113 [ + - + - ]: 5158 : {RPCResult::Type::STR_HEX, "hex", /*optional=*/true, "The hex-encoded network transaction if complete"},
2114 : : }
2115 [ + - + - : 20632 : },
+ + - - ]
2116 : 2579 : RPCExamples{
2117 [ + - + - : 5158 : HelpExampleCli("descriptorprocesspsbt", "\"psbt\" \"[\\\"descriptor1\\\", \\\"descriptor2\\\"]\"") +
+ - ]
2118 [ + - + - : 7737 : HelpExampleCli("descriptorprocesspsbt", "\"psbt\" \"[{\\\"desc\\\":\\\"mydescriptor\\\", \\\"range\\\":21}]\"")
+ - + - ]
2119 [ + - ]: 2579 : },
2120 : 2579 : [](const RPCMethod& self, const JSONRPCRequest& request) -> UniValue
2121 : : {
2122 : : // Add descriptor information to a signing provider
2123 : 21 : FlatSigningProvider provider;
2124 : :
2125 [ + - + - : 21 : auto descs = request.params[1].get_array();
+ - ]
2126 [ - + + + ]: 111 : for (size_t i = 0; i < descs.size(); ++i) {
2127 [ + - + - ]: 90 : EvalDescriptorStringOrObject(descs[i], provider, /*expand_priv=*/true);
2128 : : }
2129 : :
2130 [ + - + + ]: 21 : std::optional<int> sighash_type = ParseSighashString(request.params[2]);
2131 [ + - + + : 20 : bool bip32derivs = request.params[3].isNull() ? true : request.params[3].get_bool();
+ - + - ]
2132 [ + - + + : 20 : bool finalize = request.params[4].isNull() ? true : request.params[4].get_bool();
+ - + - ]
2133 : :
2134 : 20 : const PartiallySignedTransaction& psbtx = ProcessPSBT(
2135 : 20 : request.params[0].get_str(),
2136 [ + - ]: 20 : request.context,
2137 : 7 : HidingSigningProvider(&provider, /*hide_secret=*/false, !bip32derivs),
2138 : : sighash_type,
2139 [ + - + - : 20 : finalize);
+ + + - ]
2140 : :
2141 : : // Check whether or not all of the inputs are now correctly signed
2142 : 13 : bool complete = true;
2143 [ + - ]: 13 : const std::optional<PrecomputedTransactionData> txdata_opt{PrecomputePSBTData(psbtx)};
2144 [ + - + - ]: 13 : const PrecomputedTransactionData txdata{*CHECK_NONFATAL(txdata_opt)};
2145 [ - + + + ]: 34 : for (unsigned int i = 0; i < psbtx.inputs.size(); ++i) {
2146 [ + + + - : 30 : complete = complete && PSBTInputSignedAndVerified(psbtx, i, &txdata);
+ + ]
2147 : : }
2148 : :
2149 : 13 : DataStream ssTx{};
2150 [ + - ]: 13 : ssTx << psbtx;
2151 : :
2152 : 13 : UniValue result(UniValue::VOBJ);
2153 : :
2154 [ - + + - : 26 : result.pushKV("psbt", EncodeBase64(ssTx));
+ - + - +
- ]
2155 [ + - + - : 26 : result.pushKV("complete", complete);
+ - ]
2156 [ + + ]: 13 : if (complete) {
2157 [ + - ]: 4 : CMutableTransaction mtx;
2158 [ + - ]: 4 : PartiallySignedTransaction psbtx_copy = psbtx;
2159 [ + - + - ]: 4 : CHECK_NONFATAL(FinalizeAndExtractPSBT(psbtx_copy, mtx));
2160 : 4 : DataStream ssTx_final;
2161 [ + - ]: 4 : ssTx_final << TX_WITH_WITNESS(mtx);
2162 [ - + + - : 8 : result.pushKV("hex", HexStr(ssTx_final));
+ - + - +
- ]
2163 : 8 : }
2164 : 26 : return result;
2165 : 29 : },
2166 [ + - + - : 43843 : };
+ - + - +
+ + + + +
- - - - -
- ]
2167 [ + - + - : 61896 : }
+ - + - +
- + - + -
+ - + - +
- + - + -
- - - - -
- - - ]
2168 : :
2169 : 1418 : void RegisterRawTransactionRPCCommands(CRPCTable& t)
2170 : : {
2171 : 1418 : static const CRPCCommand commands[]{
2172 [ + - ]: 2544 : {"rawtransactions", &getrawtransaction},
2173 [ + - ]: 2544 : {"rawtransactions", &createrawtransaction},
2174 [ + - ]: 2544 : {"rawtransactions", &decoderawtransaction},
2175 [ + - ]: 2544 : {"rawtransactions", &decodescript},
2176 [ + - ]: 2544 : {"rawtransactions", &combinerawtransaction},
2177 [ + - ]: 2544 : {"rawtransactions", &signrawtransactionwithkey},
2178 [ + - ]: 2544 : {"rawtransactions", &decodepsbt},
2179 [ + - ]: 2544 : {"rawtransactions", &combinepsbt},
2180 [ + - ]: 2544 : {"rawtransactions", &finalizepsbt},
2181 [ + - ]: 2544 : {"rawtransactions", &createpsbt},
2182 [ + - ]: 2544 : {"rawtransactions", &converttopsbt},
2183 [ + - ]: 2544 : {"rawtransactions", &utxoupdatepsbt},
2184 [ + - ]: 2544 : {"rawtransactions", &descriptorprocesspsbt},
2185 [ + - ]: 2544 : {"rawtransactions", &joinpsbts},
2186 [ + - ]: 2544 : {"rawtransactions", &analyzepsbt},
2187 [ + + + - : 21770 : };
+ - + - +
- + - + -
+ - + - +
- + - + -
+ - + - +
- + - + -
- - ]
2188 [ + + ]: 22688 : for (const auto& c : commands) {
2189 : 21270 : t.appendCommand(c.name, &c);
2190 : : }
2191 : 1418 : }
|
