Bitcoin Core Fuzz Coverage Report

Coverage Report

Created: 2026-06-01 16:00

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