LCOV - code coverage report
Current view: top level - src/rpc - rawtransaction.cpp (source / functions) Coverage Total Hit
Test: test_bitcoin_coverage.info Lines: 25.3 % 1049 265
Test Date: 2025-06-01 05:54:06 Functions: 56.4 % 39 22
Branches: 26.5 % 4284 1137

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

Generated by: LCOV version 2.0-1