// Copyright (c) 2010 Satoshi Nakamoto

// Copyright (c) 2009-present The Bitcoin Core developers

// Distributed under the MIT software license, see the accompanying

// file COPYING or http://www.opensource.org/licenses/mit-license.php.

#include <rpc/blockchain.h>

#include <node/mempool_persist.h>

#include <chainparams.h>

#include <common/args.h>

#include <consensus/validation.h>

#include <core_io.h>

#include <index/txospenderindex.h>

#include <kernel/mempool_entry.h>

#include <net_processing.h>

#include <netbase.h>

#include <node/mempool_persist_args.h>

#include <node/types.h>

#include <policy/rbf.h>

#include <policy/settings.h>

#include <primitives/transaction.h>

#include <rpc/server.h>

#include <rpc/server_util.h>

#include <rpc/util.h>

#include <txmempool.h>

#include <univalue.h>

#include <util/fs.h>

#include <util/moneystr.h>

#include <util/strencodings.h>

#include <util/time.h>

#include <util/vector.h>

#include <map>

#include <ranges>

#include <string_view>

#include <utility>

using node::DumpMempool;

using node::DEFAULT_MAX_BURN_AMOUNT;

using node::DEFAULT_MAX_RAW_TX_FEE_RATE;

using node::MempoolPath;

using node::NodeContext;

using node::TransactionError;

using util::ToString;

static RPCMethod sendrawtransaction()

{

    return RPCMethod{

        "sendrawtransaction",

        "Submit a raw transaction (serialized, hex-encoded) to the network.\n"

        "\nIf -privatebroadcast is disabled, then the transaction will be put into the\n"

        "local mempool of the node and will be sent unconditionally to all currently\n"

        "connected peers, so using sendrawtransaction for manual rebroadcast will degrade\n"

        "privacy by leaking the transaction's origin, as nodes will normally not\n"

        "rebroadcast non-wallet transactions already in their mempool.\n"

        "\nIf -privatebroadcast is enabled, then the transaction will be sent only via\n"

        "dedicated, short-lived connections to Tor or I2P peers or IPv4/IPv6 peers\n"

        "via the Tor network. This conceals the transaction's origin. The transaction\n"

        "will only enter the local mempool when it is received back from the network.\n"

        "The private broadcast queue is bounded: when it is full, this RPC fails and\n"

        "the transaction is not scheduled, until an existing one completes or is\n"

        "aborted. Use getprivatebroadcastinfo to inspect the queue and abortprivatebroadcast to abort.\n"

        "\nA specific exception, RPC_TRANSACTION_ALREADY_IN_UTXO_SET, may throw if the transaction cannot be added to the mempool.\n"

        "\nRelated RPCs: createrawtransaction, signrawtransactionwithkey\n",

        {

            {"hexstring", RPCArg::Type::STR_HEX, RPCArg::Optional::NO, "The hex string of the raw transaction"},

            {"maxfeerate", RPCArg::Type::AMOUNT, RPCArg::Default{FormatMoney(DEFAULT_MAX_RAW_TX_FEE_RATE.GetFeePerK())},

             "Reject transactions whose fee rate is higher than the specified value, expressed in " + CURRENCY_UNIT +

                 "/kvB.\nFee rates larger than 1BTC/kvB are rejected.\nSet to 0 to accept any fee rate."},

            {"maxburnamount", RPCArg::Type::AMOUNT, RPCArg::Default{FormatMoney(DEFAULT_MAX_BURN_AMOUNT)},

             "Reject transactions with provably unspendable outputs (e.g. 'datacarrier' outputs that use the OP_RETURN opcode) greater than the specified value, expressed in " + CURRENCY_UNIT + ".\n"

             "If burning funds through unspendable outputs is desired, increase this value.\n"

             "This check is based on heuristics and does not guarantee spendability of outputs.\n"},

        },

        RPCResult{

            RPCResult::Type::STR_HEX, "", "The transaction hash in hex"

        },

        RPCExamples{

            "\nCreate a transaction\n"

            + HelpExampleCli("createrawtransaction", "\"[{\\\"txid\\\" : \\\"mytxid\\\",\\\"vout\\\":0}]\" \"{\\\"myaddress\\\":0.01}\"") +

            "Sign the transaction, and get back the hex\n"

            + HelpExampleCli("signrawtransactionwithwallet", "\"myhex\"") +

            "\nSend the transaction (signed hex)\n"

            + HelpExampleCli("sendrawtransaction", "\"signedhex\"") +

            "\nAs a JSON-RPC call\n"

            + HelpExampleRpc("sendrawtransaction", "\"signedhex\"")

                },

        [](const RPCMethod& self, const JSONRPCRequest& request) -> UniValue

        {

            const CAmount max_burn_amount = request.params[2].isNull() ? 0 : AmountFromValue(request.params[2]);

            CMutableTransaction mtx;

            if (!DecodeHexTx(mtx, request.params[0].get_str())) {

                throw JSONRPCError(RPC_DESERIALIZATION_ERROR, "TX decode failed. Make sure the tx has at least one input.");

            }

            for (const auto& out : mtx.vout) {

                if((out.scriptPubKey.IsUnspendable() || !out.scriptPubKey.HasValidOps()) && out.nValue > max_burn_amount) {

                    throw JSONRPCTransactionError(TransactionError::MAX_BURN_EXCEEDED);

                }

            }

            CTransactionRef tx(MakeTransactionRef(std::move(mtx)));

            const CFeeRate max_raw_tx_fee_rate{ParseFeeRate(self.Arg<UniValue>("maxfeerate"))};

            int64_t virtual_size = GetVirtualTransactionSize(*tx);

            CAmount max_raw_tx_fee = max_raw_tx_fee_rate.GetFee(virtual_size);

            std::string err_string;

            AssertLockNotHeld(cs_main);

            NodeContext& node = EnsureAnyNodeContext(request.context);

            const bool private_broadcast_enabled{gArgs.GetBoolArg("-privatebroadcast", DEFAULT_PRIVATE_BROADCAST)};

            if (private_broadcast_enabled &&

                !g_reachable_nets.Contains(NET_ONION) &&

                !g_reachable_nets.Contains(NET_I2P)) {

                throw JSONRPCError(RPC_MISC_ERROR,

                                   "-privatebroadcast is enabled, but none of the Tor or I2P networks is "

                                   "reachable. Maybe the location of the Tor proxy couldn't be retrieved "

                                   "from the Tor daemon at startup. Check whether the Tor daemon is running "

                                   "and that -torcontrol, -torpassword and -i2psam are configured properly.");

            }

            const auto method = private_broadcast_enabled ? node::TxBroadcast::NO_MEMPOOL_PRIVATE_BROADCAST

                                                          : node::TxBroadcast::MEMPOOL_AND_BROADCAST_TO_ALL;

            const TransactionError err = BroadcastTransaction(node,

                                                              tx,

                                                              err_string,

                                                              max_raw_tx_fee,

                                                              method,

                                                              /*wait_callback=*/true);

            if (TransactionError::OK != err) {

                throw JSONRPCTransactionError(err, err_string);

            }

            return tx->GetHash().GetHex();

        },

    };

}

static RPCMethod getprivatebroadcastinfo()

{

    return RPCMethod{

        "getprivatebroadcastinfo",

        "Returns information about transactions that are currently being privately broadcast.\n"

        "This method is only available when running with -privatebroadcast enabled.\n",

        {},

        RPCResult{

            RPCResult::Type::OBJ, "", "",

            {

                {RPCResult::Type::ARR, "transactions", "",

                    {

                        {RPCResult::Type::OBJ, "", "",

                            {

                                {RPCResult::Type::STR_HEX, "txid", "The transaction hash in hex"},

                                {RPCResult::Type::STR_HEX, "wtxid", "The transaction witness hash in hex"},

                                {RPCResult::Type::STR_HEX, "hex", "The serialized, hex-encoded transaction data"},

                                {RPCResult::Type::NUM_TIME, "time_added", "The time this transaction was added to the private broadcast queue (seconds since epoch)"},

                                {RPCResult::Type::ARR, "peers", "Per-peer send and acknowledgment information for this transaction",

                                    {

                                        {RPCResult::Type::OBJ, "", "",

                                            {

                                                {RPCResult::Type::STR, "address", "The address of the peer to which the transaction was sent"},

                                                {RPCResult::Type::NUM_TIME, "sent", "The time this transaction was picked for sending to this peer via private broadcast (seconds since epoch)"},

                                                {RPCResult::Type::NUM_TIME, "received", /*optional=*/true, "The time this peer acknowledged reception of the transaction (seconds since epoch)"},

                                            }},

                                    }},

                            }},

                    }},

            }},

        RPCExamples{

            HelpExampleCli("getprivatebroadcastinfo", "")

            + HelpExampleRpc("getprivatebroadcastinfo", "")

        },

        [](const RPCMethod& self, const JSONRPCRequest& request) -> UniValue

        {

            const NodeContext& node{EnsureAnyNodeContext(request.context)};

            const PeerManager& peerman{EnsurePeerman(node)};

            if (!peerman.GetInfo().private_broadcast) {

                throw JSONRPCError(RPC_METHOD_NOT_FOUND, "Private broadcast is not enabled. Ensure you're running Bitcoin Core with -privatebroadcast=1.");

            }

            const auto txs{peerman.GetPrivateBroadcastInfo()};

            UniValue transactions(UniValue::VARR);

            for (const auto& tx_info : txs) {

                UniValue o(UniValue::VOBJ);

                o.pushKV("txid", tx_info.tx->GetHash().ToString());

                o.pushKV("wtxid", tx_info.tx->GetWitnessHash().ToString());

                o.pushKV("hex", EncodeHexTx(*tx_info.tx));

                o.pushKV("time_added", TicksSinceEpoch<std::chrono::seconds>(tx_info.time_added));

                UniValue peers(UniValue::VARR);

                for (const auto& peer : tx_info.peers) {

                    UniValue p(UniValue::VOBJ);

                    p.pushKV("address", peer.address.ToStringAddrPort());

                    p.pushKV("sent", TicksSinceEpoch<std::chrono::seconds>(peer.sent));

                    if (peer.received.has_value()) {

                        p.pushKV("received", TicksSinceEpoch<std::chrono::seconds>(*peer.received));

                    }

                    peers.push_back(std::move(p));

                }

                o.pushKV("peers", std::move(peers));

                transactions.push_back(std::move(o));

            }

            UniValue ret(UniValue::VOBJ);

            ret.pushKV("transactions", std::move(transactions));

            return ret;

        },

    };

}

static RPCMethod abortprivatebroadcast()

{

    return RPCMethod{

        "abortprivatebroadcast",

        "Abort private broadcast attempts for a transaction currently being privately broadcast.\n"

        "The transaction will be removed from the private broadcast queue.\n"

        "This method is only available when running with -privatebroadcast enabled.\n",

        {

            {"id", RPCArg::Type::STR_HEX, RPCArg::Optional::NO, "A transaction identifier to abort. It will be matched against both txid and wtxid for all transactions in the private broadcast queue.\n"

                                                                "If the provided id matches a txid that corresponds to multiple transactions with different wtxids, multiple transactions will be removed and returned."},

        },

        RPCResult{

            RPCResult::Type::OBJ, "", "",

            {

                {RPCResult::Type::ARR, "removed_transactions", "Transactions removed from the private broadcast queue",

                    {

                        {RPCResult::Type::OBJ, "", "",

                            {

                                {RPCResult::Type::STR_HEX, "txid", "The transaction hash in hex"},

                                {RPCResult::Type::STR_HEX, "wtxid", "The transaction witness hash in hex"},

                                {RPCResult::Type::STR_HEX, "hex", "The serialized, hex-encoded transaction data"},

                            }},

                    }},

            }

        },

        RPCExamples{

            HelpExampleCli("abortprivatebroadcast", "\"id\"")

            + HelpExampleRpc("abortprivatebroadcast", "\"id\"")

        },

        [](const RPCMethod& self, const JSONRPCRequest& request) -> UniValue

        {

            const NodeContext& node{EnsureAnyNodeContext(request.context)};

            PeerManager& peerman{EnsurePeerman(node)};

            if (!peerman.GetInfo().private_broadcast) {

                throw JSONRPCError(RPC_METHOD_NOT_FOUND, "Private broadcast is not enabled. Ensure you're running Bitcoin Core with -privatebroadcast=1.");

            }

            const uint256 id{ParseHashV(self.Arg<UniValue>("id"), "id")};

            const auto removed_txs{peerman.AbortPrivateBroadcast(id)};

            if (removed_txs.empty()) {

                throw JSONRPCError(RPC_INVALID_ADDRESS_OR_KEY, "Transaction not in private broadcast queue. Check getprivatebroadcastinfo.");

            }

            UniValue removed_transactions(UniValue::VARR);

            for (const auto& tx : removed_txs) {

                UniValue o(UniValue::VOBJ);

                o.pushKV("txid", tx->GetHash().ToString());

                o.pushKV("wtxid", tx->GetWitnessHash().ToString());

                o.pushKV("hex", EncodeHexTx(*tx));

                removed_transactions.push_back(std::move(o));

            }

            UniValue ret(UniValue::VOBJ);

            ret.pushKV("removed_transactions", std::move(removed_transactions));

            return ret;

        },

    };

}

static RPCMethod testmempoolaccept()

{

    return RPCMethod{

        "testmempoolaccept",

        "Returns result of mempool acceptance tests indicating if raw transaction(s) (serialized, hex-encoded) would be accepted by mempool.\n"

        "\nIf multiple transactions are passed in, parents must come before children and package policies apply: the transactions cannot conflict with any mempool transactions or each other.\n"

        "\nIf one transaction fails, other transactions may not be fully validated (the 'allowed' key will be blank).\n"

        "\nThe maximum number of transactions allowed is " + ToString(MAX_PACKAGE_COUNT) + ".\n"

        "\nThis checks if transactions violate the consensus or policy rules.\n"

        "\nSee sendrawtransaction call.\n",

        {

            {"rawtxs", RPCArg::Type::ARR, RPCArg::Optional::NO, "An array of hex strings of raw transactions.",

                {

                    {"rawtx", RPCArg::Type::STR_HEX, RPCArg::Optional::OMITTED, ""},

                },

            },

            {"maxfeerate", RPCArg::Type::AMOUNT, RPCArg::Default{FormatMoney(DEFAULT_MAX_RAW_TX_FEE_RATE.GetFeePerK())},

             "Reject transactions whose fee rate is higher than the specified value, expressed in " + CURRENCY_UNIT +

                 "/kvB.\nFee rates larger than 1BTC/kvB are rejected.\nSet to 0 to accept any fee rate."},

        },

        RPCResult{

            RPCResult::Type::ARR, "", "The result of the mempool acceptance test for each raw transaction in the input array.\n"

                                      "Returns results for each transaction in the same order they were passed in.\n"

                                      "Transactions that cannot be fully validated due to failures in other transactions will not contain an 'allowed' result.\n",

            {

                {RPCResult::Type::OBJ, "", "",

                {

                    {RPCResult::Type::STR_HEX, "txid", "The transaction hash in hex"},

                    {RPCResult::Type::STR_HEX, "wtxid", "The transaction witness hash in hex"},

                    {RPCResult::Type::STR, "package-error", /*optional=*/true, "Package validation error, if any (only possible if rawtxs had more than 1 transaction)."},

                    {RPCResult::Type::BOOL, "allowed", /*optional=*/true, "Whether this tx would be accepted to the mempool and pass client-specified maxfeerate. "

                                                       "If not present, the tx was not fully validated due to a failure in another tx in the list."},

                    {RPCResult::Type::NUM, "vsize_adjusted", /*optional=*/true, "Maximum of sigop-adjusted size (-bytespersigop) and virtual transaction size as defined in BIP 141 (only present when 'allowed' is true)."},

                    {RPCResult::Type::NUM, "vsize", /*optional=*/true, "(DEPRECATED) Was previously erroneously described as the BIP 141 vsize, but is actually sigops-adjusted vsize.\n"

                                                                "Use vsize_bip141 to actually get that behavior or switch to the explicit vsize_adjusted for retained behavior."},

                    {RPCResult::Type::NUM, "vsize_bip141", /*optional=*/true, "Virtual transaction size as defined in BIP 141.\n"

                                                                       "This is different from actual serialized size for witness transactions as witness data is discounted (only present when 'allowed' is true)."},

                    {RPCResult::Type::OBJ, "fees", /*optional=*/true, "Transaction fees (only present if 'allowed' is true)",

                    {

                        {RPCResult::Type::STR_AMOUNT, "base", "transaction fee in " + CURRENCY_UNIT},

                        {RPCResult::Type::STR_AMOUNT, "effective-feerate", /*optional=*/false, "the effective feerate in " + CURRENCY_UNIT + " per KvB. May differ from the base feerate if, for example, there are modified fees from prioritisetransaction or a package feerate was used."},

                        {RPCResult::Type::ARR, "effective-includes", /*optional=*/false, "transactions whose fees and vsizes are included in effective-feerate.",

                            {RPCResult{RPCResult::Type::STR_HEX, "", "transaction wtxid in hex"},

                        }},

                    }},

                    {RPCResult::Type::STR, "reject-reason", /*optional=*/true, "Rejection reason (only present when 'allowed' is false)"},

                    {RPCResult::Type::STR, "reject-details", /*optional=*/true, "Rejection details (only present when 'allowed' is false and rejection details exist)"},

                }},

            }

        },

        RPCExamples{

            "\nCreate a transaction\n"

            + HelpExampleCli("createrawtransaction", "\"[{\\\"txid\\\" : \\\"mytxid\\\",\\\"vout\\\":0}]\" \"{\\\"myaddress\\\":0.01}\"") +

            "Sign the transaction, and get back the hex\n"

            + HelpExampleCli("signrawtransactionwithwallet", "\"myhex\"") +

            "\nTest acceptance of the transaction (signed hex)\n"

            + HelpExampleCli("testmempoolaccept", R"('["signedhex"]')") +

            "\nAs a JSON-RPC call\n"

            + HelpExampleRpc("testmempoolaccept", "[\"signedhex\"]")

                },

        [](const RPCMethod& self, const JSONRPCRequest& request) -> UniValue

        {

            const UniValue raw_transactions = request.params[0].get_array();

            if (raw_transactions.size() < 1 || raw_transactions.size() > MAX_PACKAGE_COUNT) {

                throw JSONRPCError(RPC_INVALID_PARAMETER,

                                   "Array must contain between 1 and " + ToString(MAX_PACKAGE_COUNT) + " transactions.");

            }

            const CFeeRate max_raw_tx_fee_rate{ParseFeeRate(self.Arg<UniValue>("maxfeerate"))};

            std::vector<CTransactionRef> txns;

            txns.reserve(raw_transactions.size());

            for (const auto& rawtx : raw_transactions.getValues()) {

                CMutableTransaction mtx;

                if (!DecodeHexTx(mtx, rawtx.get_str())) {

                    throw JSONRPCError(RPC_DESERIALIZATION_ERROR,

                                       "TX decode failed: " + rawtx.get_str() + " Make sure the tx has at least one input.");

                }

                txns.emplace_back(MakeTransactionRef(std::move(mtx)));

            }

            NodeContext& node = EnsureAnyNodeContext(request.context);

            CTxMemPool& mempool = EnsureMemPool(node);

            ChainstateManager& chainman = EnsureChainman(node);

            Chainstate& chainstate = chainman.ActiveChainstate();

            const PackageMempoolAcceptResult package_result = [&] {

                LOCK(::cs_main);

                if (txns.size() > 1) return ProcessNewPackage(chainstate, mempool, txns, /*test_accept=*/true, /*client_maxfeerate=*/{});

                return PackageMempoolAcceptResult(txns[0]->GetWitnessHash(),

                                                  chainman.ProcessTransaction(txns[0], /*test_accept=*/true));

            }();

            UniValue rpc_result(UniValue::VARR);

            // We will check transaction fees while we iterate through txns in order. If any transaction fee

            // exceeds maxfeerate, we will leave the rest of the validation results blank, because it

            // doesn't make sense to return a validation result for a transaction if its ancestor(s) would

            // not be submitted.

            bool exit_early{false};

            for (const auto& tx : txns) {

                UniValue result_inner(UniValue::VOBJ);

                result_inner.pushKV("txid", tx->GetHash().GetHex());

                result_inner.pushKV("wtxid", tx->GetWitnessHash().GetHex());

                if (package_result.m_state.GetResult() == PackageValidationResult::PCKG_POLICY) {

                    result_inner.pushKV("package-error", package_result.m_state.ToString());

                }

                auto it = package_result.m_tx_results.find(tx->GetWitnessHash());

                if (exit_early || it == package_result.m_tx_results.end()) {

                    // Validation unfinished. Just return the txid and wtxid.

                    rpc_result.push_back(std::move(result_inner));

                    continue;

                }

                const auto& tx_result = it->second;

                // Package testmempoolaccept doesn't allow transactions to already be in the mempool.

                CHECK_NONFATAL(tx_result.m_result_type != MempoolAcceptResult::ResultType::MEMPOOL_ENTRY);

                if (tx_result.m_result_type == MempoolAcceptResult::ResultType::VALID) {

                    const CAmount fee = tx_result.m_base_fees.value();

                    // Check that fee does not exceed maximum fee

                    const int64_t virtual_size = tx_result.m_vsize.value();

                    const CAmount max_raw_tx_fee = max_raw_tx_fee_rate.GetFee(virtual_size);

                    if (max_raw_tx_fee && fee > max_raw_tx_fee) {

                        result_inner.pushKV("allowed", false);

                        result_inner.pushKV("reject-reason", "max-fee-exceeded");

                        exit_early = true;

                    } else {

                        // Only return the fee and vsize if the transaction would pass ATMP.

                        // These can be used to calculate the feerate.

                        result_inner.pushKV("allowed", true);

                        result_inner.pushKV("vsize_adjusted", virtual_size);

                        result_inner.pushKV("vsize", virtual_size);

                        result_inner.pushKV("vsize_bip141", GetVirtualTransactionSize(*tx));

                        UniValue fees(UniValue::VOBJ);

                        fees.pushKV("base", ValueFromAmount(fee));

                        fees.pushKV("effective-feerate", ValueFromAmount(tx_result.m_effective_feerate.value().GetFeePerK()));

                        UniValue effective_includes_res(UniValue::VARR);

                        for (const auto& wtxid : tx_result.m_wtxids_fee_calculations.value()) {

                            effective_includes_res.push_back(wtxid.ToString());

                        }

                        fees.pushKV("effective-includes", std::move(effective_includes_res));

                        result_inner.pushKV("fees", std::move(fees));

                    }

                } else {

                    result_inner.pushKV("allowed", false);

                    const TxValidationState state = tx_result.m_state;

                    if (state.GetResult() == TxValidationResult::TX_MISSING_INPUTS) {

                        result_inner.pushKV("reject-reason", "missing-inputs");

                    } else {

                        result_inner.pushKV("reject-reason", state.GetRejectReason());

                        result_inner.pushKV("reject-details", state.ToString());

                    }

                }

                rpc_result.push_back(std::move(result_inner));

            }

            return rpc_result;

        },

    };

}

static std::vector<RPCResult> ClusterDescription()

{

    return {

        RPCResult{RPCResult::Type::NUM, "clusterweight", "total sigops-adjusted weight (as defined in BIP 141 and modified by '-bytespersigop')"},

        RPCResult{RPCResult::Type::NUM, "txcount", "number of transactions"},

        RPCResult{RPCResult::Type::ARR, "chunks", "chunks in this cluster (in mining order)",

            {RPCResult{RPCResult::Type::OBJ, "chunk", "",

                {

                    RPCResult{RPCResult::Type::NUM, "chunkfee", "fees of the transactions in this chunk"},

                    RPCResult{RPCResult::Type::NUM, "chunkweight", "sigops-adjusted weight of all transactions in this chunk"},

                    RPCResult{RPCResult::Type::ARR, "txs", "transactions in this chunk in mining order",

                        {RPCResult{RPCResult::Type::STR_HEX, "txid", "transaction id"}}},

                }

            }}

        }

    };

}

static std::vector<RPCResult> MempoolEntryDescription()

{

    std::vector<RPCResult> list = {

        {RPCResult::Type::NUM, "vsize", "(DEPRECATED) Was previously erroneously described as the BIP 141 vsize, but is actually sigops-adjusted vsize.\n"

        "Use vsize_bip141 to actually get that behavior or switch to the explicit vsize_adjusted for retained behavior."},

        {RPCResult::Type::NUM, "vsize_bip141", "Virtual transaction size as defined in BIP 141.\n"

        "This is different from actual serialized size for witness transactions as witness data is discounted."},

        {RPCResult::Type::NUM, "vsize_adjusted", "Maximum of sigop-adjusted size (-bytespersigop) and virtual transaction size as defined in BIP 141."},

        RPCResult{RPCResult::Type::NUM, "weight", "transaction weight as defined in BIP 141."},

        RPCResult{RPCResult::Type::NUM_TIME, "time", "local time transaction entered pool in seconds since 1 Jan 1970 GMT"},

        RPCResult{RPCResult::Type::NUM, "height", "block height when transaction entered pool"},

        RPCResult{RPCResult::Type::NUM, "descendantcount", "number of in-mempool descendant transactions (including this one)"},

        RPCResult{RPCResult::Type::NUM, "descendantsize", "virtual transaction size of in-mempool descendants (including this one)"},

        RPCResult{RPCResult::Type::NUM, "ancestorcount", "number of in-mempool ancestor transactions (including this one)"},

        RPCResult{RPCResult::Type::NUM, "ancestorsize", "virtual transaction size of in-mempool ancestors (including this one)"},

        RPCResult{RPCResult::Type::NUM, "chunkweight", "sigops-adjusted weight (as defined in BIP 141 and modified by '-bytespersigop') of this transaction's chunk"},

        RPCResult{RPCResult::Type::STR_HEX, "wtxid", "hash of serialized transaction, including witness data"},

        RPCResult{RPCResult::Type::OBJ, "fees", "",

            {

                RPCResult{RPCResult::Type::STR_AMOUNT, "base", "transaction fee, denominated in " + CURRENCY_UNIT},

                RPCResult{RPCResult::Type::STR_AMOUNT, "modified", "transaction fee with fee deltas used for mining priority, denominated in " + CURRENCY_UNIT},

                RPCResult{RPCResult::Type::STR_AMOUNT, "ancestor", "transaction fees of in-mempool ancestors (including this one) with fee deltas used for mining priority, denominated in " + CURRENCY_UNIT},

                RPCResult{RPCResult::Type::STR_AMOUNT, "descendant", "transaction fees of in-mempool descendants (including this one) with fee deltas used for mining priority, denominated in " + CURRENCY_UNIT},

                RPCResult{RPCResult::Type::STR_AMOUNT, "chunk", "transaction fees of chunk, denominated in " + CURRENCY_UNIT},

            }},

        RPCResult{RPCResult::Type::ARR, "depends", "unconfirmed transactions used as inputs for this transaction",

            {RPCResult{RPCResult::Type::STR_HEX, "transactionid", "parent transaction id"}}},

        RPCResult{RPCResult::Type::ARR, "spentby", "unconfirmed transactions spending outputs from this transaction",

            {RPCResult{RPCResult::Type::STR_HEX, "transactionid", "child transaction id"}}},

        RPCResult{RPCResult::Type::BOOL, "unbroadcast", "Whether this transaction is currently unbroadcast (initial broadcast not yet acknowledged by any peers)"},

    };

    if (IsDeprecatedRPCEnabled("bip125")) {

        list.emplace_back(RPCResult::Type::BOOL, "bip125-replaceable", "Whether this transaction signals BIP125 replaceability or has an unconfirmed ancestor signaling BIP125 replaceability. (DEPRECATED)\n");

    }

    return list;

}

void AppendChunkInfo(UniValue& all_chunks, FeePerWeight chunk_feerate, std::vector<const CTxMemPoolEntry *> chunk_txs)

{

    UniValue chunk(UniValue::VOBJ);

    chunk.pushKV("chunkfee", ValueFromAmount(chunk_feerate.fee));

    chunk.pushKV("chunkweight", chunk_feerate.size);

    UniValue chunk_txids(UniValue::VARR);

    for (const auto& chunk_tx : chunk_txs) {

        chunk_txids.push_back(chunk_tx->GetTx().GetHash().ToString());

    }

    chunk.pushKV("txs", std::move(chunk_txids));

    all_chunks.push_back(std::move(chunk));

}

static void clusterToJSON(const CTxMemPool& pool, UniValue& info, std::vector<const CTxMemPoolEntry *> cluster) EXCLUSIVE_LOCKS_REQUIRED(pool.cs)

{

    AssertLockHeld(pool.cs);

    int total_weight{0};

    for (const auto& tx : cluster) {

        total_weight += tx->GetAdjustedWeight();

    }

    info.pushKV("clusterweight", total_weight);

    info.pushKV("txcount", cluster.size());

    // Output the cluster by chunk. This isn't handed to us by the mempool, but

    // we can calculate it by looking at the chunk feerates of each transaction

    // in the cluster.

    FeePerWeight current_chunk_feerate = pool.GetMainChunkFeerate(*cluster[0]);

    std::vector<const CTxMemPoolEntry *> current_chunk;

    current_chunk.reserve(cluster.size());

    UniValue all_chunks(UniValue::VARR);

    for (const auto& tx : cluster) {

        if (current_chunk_feerate.size == 0) {

            // We've iterated all the transactions in the previous chunk; so

            // append it to the output.

            AppendChunkInfo(all_chunks, pool.GetMainChunkFeerate(*current_chunk[0]), current_chunk);

            current_chunk.clear();

            current_chunk_feerate = pool.GetMainChunkFeerate(*tx);

        }

        current_chunk.push_back(tx);

        current_chunk_feerate.size -= tx->GetAdjustedWeight();

    }

    AppendChunkInfo(all_chunks, pool.GetMainChunkFeerate(*current_chunk[0]), current_chunk);

    current_chunk.clear();

    info.pushKV("chunks", std::move(all_chunks));

}

static void entryToJSON(const CTxMemPool& pool, UniValue& info, const CTxMemPoolEntry& e) EXCLUSIVE_LOCKS_REQUIRED(pool.cs)

{

    AssertLockHeld(pool.cs);

    auto [ancestor_count, ancestor_size, ancestor_fees] = pool.CalculateAncestorData(e);

    auto [descendant_count, descendant_size, descendant_fees] = pool.CalculateDescendantData(e);

    info.pushKV("vsize_adjusted", e.GetTxSize());

    info.pushKV("vsize", e.GetTxSize());

    info.pushKV("vsize_bip141", GetVirtualTransactionSize(e.GetTx()));

    info.pushKV("weight", e.GetTxWeight());

    info.pushKV("time", count_seconds(e.GetTime()));

    info.pushKV("height", e.GetHeight());

    info.pushKV("descendantcount", descendant_count);

    info.pushKV("descendantsize", descendant_size);

    info.pushKV("ancestorcount", ancestor_count);

    info.pushKV("ancestorsize", ancestor_size);

    info.pushKV("wtxid", e.GetTx().GetWitnessHash().ToString());

    auto feerate = pool.GetMainChunkFeerate(e);

    info.pushKV("chunkweight", feerate.size);

    UniValue fees(UniValue::VOBJ);

    fees.pushKV("base", ValueFromAmount(e.GetFee()));

    fees.pushKV("modified", ValueFromAmount(e.GetModifiedFee()));

    fees.pushKV("ancestor", ValueFromAmount(ancestor_fees));

    fees.pushKV("descendant", ValueFromAmount(descendant_fees));

    fees.pushKV("chunk", ValueFromAmount(feerate.fee));

    info.pushKV("fees", std::move(fees));

    const CTransaction& tx = e.GetTx();

    std::set<std::string> setDepends;

    for (const CTxIn& txin : tx.vin)

    {

        if (pool.exists(txin.prevout.hash))

            setDepends.insert(txin.prevout.hash.ToString());

    }

    UniValue depends(UniValue::VARR);

    for (const std::string& dep : setDepends)

    {

        depends.push_back(dep);

    }

    info.pushKV("depends", std::move(depends));

    UniValue spent(UniValue::VARR);

    for (const CTxMemPoolEntry& child : pool.GetChildren(e)) {

        spent.push_back(child.GetTx().GetHash().ToString());

    }

    info.pushKV("spentby", std::move(spent));

    info.pushKV("unbroadcast", pool.IsUnbroadcastTx(tx.GetHash()));

    // Add opt-in RBF status

    if (IsDeprecatedRPCEnabled("bip125")) {

        bool rbfStatus = false;

        RBFTransactionState rbfState = IsRBFOptIn(tx, pool);

        if (rbfState == RBFTransactionState::UNKNOWN) {

            throw JSONRPCError(RPC_MISC_ERROR, "Transaction is not in mempool");

        } else if (rbfState == RBFTransactionState::REPLACEABLE_BIP125) {

            rbfStatus = true;

        }

        info.pushKV("bip125-replaceable", rbfStatus);

    }

}

UniValue MempoolToJSON(const CTxMemPool& pool, bool verbose, bool include_mempool_sequence)

{

    if (verbose) {

        if (include_mempool_sequence) {

            throw JSONRPCError(RPC_INVALID_PARAMETER, "Verbose results cannot contain mempool sequence values.");

        }

        LOCK(pool.cs);

        UniValue o(UniValue::VOBJ);

        for (const CTxMemPoolEntry& e : pool.entryAll()) {

            UniValue info(UniValue::VOBJ);

            entryToJSON(pool, info, e);

            // Mempool has unique entries so there is no advantage in using

            // UniValue::pushKV, which checks if the key already exists in O(N).

            // UniValue::pushKVEnd is used instead which currently is O(1).

            o.pushKVEnd(e.GetTx().GetHash().ToString(), std::move(info));

        }

        return o;

    } else {

        UniValue a(UniValue::VARR);

        uint64_t mempool_sequence;

        {

            LOCK(pool.cs);

            for (const CTxMemPoolEntry& e : pool.entryAll()) {

                a.push_back(e.GetTx().GetHash().ToString());

            }

            mempool_sequence = pool.GetSequence();

        }

        if (!include_mempool_sequence) {

            return a;

        } else {

            UniValue o(UniValue::VOBJ);

            o.pushKV("txids", std::move(a));

            o.pushKV("mempool_sequence", mempool_sequence);

            return o;

        }

    }

}

static RPCMethod getmempoolfeeratediagram()

{

    return RPCMethod{"getmempoolfeeratediagram",

        "Returns the feerate diagram for the whole mempool.",

        {},

        {

            RPCResult{"mempool chunks",

                RPCResult::Type::ARR, "", "",

                {

                    {

                        RPCResult::Type::OBJ, "", "",

                        {

                            {RPCResult::Type::NUM, "weight", "cumulative sigops-adjusted weight"},

                            {RPCResult::Type::NUM, "fee", "cumulative fee"}

                        }

                    }

                }

            }

        },

        RPCExamples{

            HelpExampleCli("getmempoolfeeratediagram", "")

            + HelpExampleRpc("getmempoolfeeratediagram", "")

        },

        [](const RPCMethod& self, const JSONRPCRequest& request) -> UniValue

        {

            const CTxMemPool& mempool = EnsureAnyMemPool(request.context);

            LOCK(mempool.cs);

            UniValue result(UniValue::VARR);

            auto diagram = mempool.GetFeerateDiagram();

            for (auto f : diagram) {

                UniValue o(UniValue::VOBJ);

                o.pushKV("weight", f.size);

                o.pushKV("fee", ValueFromAmount(f.fee));

                result.push_back(o);

            }

            return result;

        }

    };

}

static RPCMethod getrawmempool()

{

    return RPCMethod{

        "getrawmempool",

        "Returns all transaction ids in memory pool as a json array of string transaction ids.\n"

        "\nHint: use getmempoolentry to fetch a specific transaction from the mempool.\n",

        {

            {"verbose", RPCArg::Type::BOOL, RPCArg::Default{false}, "True for a json object, false for array of transaction ids"},

            {"mempool_sequence", RPCArg::Type::BOOL, RPCArg::Default{false}, "If verbose=false, returns a json object with transaction list and mempool sequence number attached."},

        },

        {

            RPCResult{"for verbose = false",

                RPCResult::Type::ARR, "", "",

                {

                    {RPCResult::Type::STR_HEX, "", "The transaction id"},

                }},

            RPCResult{"for verbose = true",

                RPCResult::Type::OBJ_DYN, "", "",

                {

                    {RPCResult::Type::OBJ, "transactionid", "", MempoolEntryDescription()},

                }},

            RPCResult{"for verbose = false and mempool_sequence = true",

                RPCResult::Type::OBJ, "", "",

                {

                    {RPCResult::Type::ARR, "txids", "",

                    {

                        {RPCResult::Type::STR_HEX, "", "The transaction id"},

                    }},

                    {RPCResult::Type::NUM, "mempool_sequence", "The mempool sequence value."},

                }},

        },

        RPCExamples{

            HelpExampleCli("getrawmempool", "true")

            + HelpExampleRpc("getrawmempool", "true")

        },

        [](const RPCMethod& self, const JSONRPCRequest& request) -> UniValue

{

    bool fVerbose = false;

    if (!request.params[0].isNull())

        fVerbose = request.params[0].get_bool();

    bool include_mempool_sequence = false;

    if (!request.params[1].isNull()) {

        include_mempool_sequence = request.params[1].get_bool();

    }

    return MempoolToJSON(EnsureAnyMemPool(request.context), fVerbose, include_mempool_sequence);

},

    };

}

static RPCMethod getmempoolancestors()

{

    return RPCMethod{

        "getmempoolancestors",

        "If txid is in the mempool, returns all in-mempool ancestors.\n",

        {

            {"txid", RPCArg::Type::STR_HEX, RPCArg::Optional::NO, "The transaction id (must be in mempool)"},

            {"verbose", RPCArg::Type::BOOL, RPCArg::Default{false}, "True for a json object, false for array of transaction ids"},

        },

        {

            RPCResult{"for verbose = false",

                RPCResult::Type::ARR, "", "",

                {{RPCResult::Type::STR_HEX, "", "The transaction id of an in-mempool ancestor transaction"}}},

            RPCResult{"for verbose = true",

                RPCResult::Type::OBJ_DYN, "", "",

                {

                    {RPCResult::Type::OBJ, "transactionid", "", MempoolEntryDescription()},

                }},

        },

        RPCExamples{

            HelpExampleCli("getmempoolancestors", "\"mytxid\"")

            + HelpExampleRpc("getmempoolancestors", "\"mytxid\"")

        },

        [](const RPCMethod& self, const JSONRPCRequest& request) -> UniValue

{

    bool fVerbose = false;

    if (!request.params[1].isNull())

        fVerbose = request.params[1].get_bool();

    auto txid{Txid::FromUint256(ParseHashV(request.params[0], "txid"))};

    const CTxMemPool& mempool = EnsureAnyMemPool(request.context);

    LOCK(mempool.cs);

    const auto entry{mempool.GetEntry(txid)};

    if (entry == nullptr) {

        throw JSONRPCError(RPC_INVALID_ADDRESS_OR_KEY, "Transaction not in mempool");

    }

    auto ancestors{mempool.CalculateMemPoolAncestors(*entry)};

    if (!fVerbose) {

        UniValue o(UniValue::VARR);

        for (CTxMemPool::txiter ancestorIt : ancestors) {

            o.push_back(ancestorIt->GetTx().GetHash().ToString());

        }

        return o;

    } else {

        UniValue o(UniValue::VOBJ);

        for (CTxMemPool::txiter ancestorIt : ancestors) {

            const CTxMemPoolEntry &e = *ancestorIt;

            UniValue info(UniValue::VOBJ);

            entryToJSON(mempool, info, e);

            o.pushKV(e.GetTx().GetHash().ToString(), std::move(info));

        }

        return o;

    }

},

    };

}

static RPCMethod getmempooldescendants()

{

    return RPCMethod{

        "getmempooldescendants",

        "If txid is in the mempool, returns all in-mempool descendants.\n",

        {

            {"txid", RPCArg::Type::STR_HEX, RPCArg::Optional::NO, "The transaction id (must be in mempool)"},

            {"verbose", RPCArg::Type::BOOL, RPCArg::Default{false}, "True for a json object, false for array of transaction ids"},

        },

        {

            RPCResult{"for verbose = false",

                RPCResult::Type::ARR, "", "",

                {{RPCResult::Type::STR_HEX, "", "The transaction id of an in-mempool descendant transaction"}}},

            RPCResult{"for verbose = true",

                RPCResult::Type::OBJ_DYN, "", "",

                {

                    {RPCResult::Type::OBJ, "transactionid", "", MempoolEntryDescription()},

                }},

        },

        RPCExamples{

            HelpExampleCli("getmempooldescendants", "\"mytxid\"")

            + HelpExampleRpc("getmempooldescendants", "\"mytxid\"")

        },

        [](const RPCMethod& self, const JSONRPCRequest& request) -> UniValue

{

    bool fVerbose = false;

    if (!request.params[1].isNull())

        fVerbose = request.params[1].get_bool();

    auto txid{Txid::FromUint256(ParseHashV(request.params[0], "txid"))};

    const CTxMemPool& mempool = EnsureAnyMemPool(request.context);

    LOCK(mempool.cs);

    const auto it{mempool.GetIter(txid)};

    if (!it) {

        throw JSONRPCError(RPC_INVALID_ADDRESS_OR_KEY, "Transaction not in mempool");

    }

    CTxMemPool::setEntries setDescendants;

    mempool.CalculateDescendants(*it, setDescendants);

    // CTxMemPool::CalculateDescendants will include the given tx

    setDescendants.erase(*it);

    if (!fVerbose) {

        UniValue o(UniValue::VARR);

        for (CTxMemPool::txiter descendantIt : setDescendants) {

            o.push_back(descendantIt->GetTx().GetHash().ToString());

        }

        return o;

    } else {

        UniValue o(UniValue::VOBJ);

        for (CTxMemPool::txiter descendantIt : setDescendants) {

            const CTxMemPoolEntry &e = *descendantIt;

            UniValue info(UniValue::VOBJ);

            entryToJSON(mempool, info, e);

            o.pushKV(e.GetTx().GetHash().ToString(), std::move(info));

        }

        return o;

    }

},

    };

}

static RPCMethod getmempoolcluster()

{

    return RPCMethod{"getmempoolcluster",

        "Returns mempool data for given cluster\n",

        {

            {"txid", RPCArg::Type::STR_HEX, RPCArg::Optional::NO, "The txid of a transaction in the cluster"},

        },

        RPCResult{

            RPCResult::Type::OBJ, "", "", ClusterDescription()},

        RPCExamples{

            HelpExampleCli("getmempoolcluster", "txid")

            + HelpExampleRpc("getmempoolcluster", "txid")

        },

        [](const RPCMethod& self, const JSONRPCRequest& request) -> UniValue

{

    uint256 hash = ParseHashV(request.params[0], "txid");

    const CTxMemPool& mempool = EnsureAnyMemPool(request.context);

    LOCK(mempool.cs);

    auto txid = Txid::FromUint256(hash);

    const auto entry{mempool.GetEntry(txid)};

    if (entry == nullptr) {

        throw JSONRPCError(RPC_INVALID_ADDRESS_OR_KEY, "Transaction not in mempool");

    }

    auto cluster = mempool.GetCluster(txid);

    UniValue info(UniValue::VOBJ);

    clusterToJSON(mempool, info, cluster);

    return info;

},

    };

}

static RPCMethod getmempoolentry()

{

    return RPCMethod{

        "getmempoolentry",

        "Returns mempool data for given transaction\n",

        {

            {"txid", RPCArg::Type::STR_HEX, RPCArg::Optional::NO, "The transaction id (must be in mempool)"},

        },

        RPCResult{

            RPCResult::Type::OBJ, "", "", MempoolEntryDescription()},

        RPCExamples{

            HelpExampleCli("getmempoolentry", "\"mytxid\"")

            + HelpExampleRpc("getmempoolentry", "\"mytxid\"")

        },

        [](const RPCMethod& self, const JSONRPCRequest& request) -> UniValue

{

    auto txid{Txid::FromUint256(ParseHashV(request.params[0], "txid"))};

    const CTxMemPool& mempool = EnsureAnyMemPool(request.context);

    LOCK(mempool.cs);

    const auto entry{mempool.GetEntry(txid)};

    if (entry == nullptr) {

        throw JSONRPCError(RPC_INVALID_ADDRESS_OR_KEY, "Transaction not in mempool");

    }

    UniValue info(UniValue::VOBJ);

    entryToJSON(mempool, info, *entry);

    return info;

},

    };

}

static RPCMethod gettxspendingprevout()

{

    return RPCMethod{"gettxspendingprevout",

        "Scans the mempool (and the txospenderindex, if available) to find transactions spending any of the given outputs",

        {

            {"outputs", RPCArg::Type::ARR, RPCArg::Optional::NO, "The transaction outputs that we want to check, and within each, the txid (string) vout (numeric).",

                {

                    {"", RPCArg::Type::OBJ, RPCArg::Optional::OMITTED, "",

                        {

                            {"txid", RPCArg::Type::STR_HEX, RPCArg::Optional::NO, "The transaction id"},

                            {"vout", RPCArg::Type::NUM, RPCArg::Optional::NO, "The output number"},

                        },

                    },

                },

            },

            {"options", RPCArg::Type::OBJ_NAMED_PARAMS, RPCArg::Optional::OMITTED, "",

                {

                    {"mempool_only", RPCArg::Type::BOOL, RPCArg::DefaultHint{"true if txospenderindex unavailable, otherwise false"}, "If false and mempool lacks a relevant spend, use txospenderindex (throws an exception if not available)."},

                    {"return_spending_tx", RPCArg::Type::BOOL, RPCArg::DefaultHint{"false"}, "If true, return the full spending tx."},

                },

            },

        },

        RPCResult{

            RPCResult::Type::ARR, "", "",

            {

                {RPCResult::Type::OBJ, "", "",

                {

                    {RPCResult::Type::STR_HEX, "txid", "the transaction id of the checked output"},

                    {RPCResult::Type::NUM, "vout", "the vout value of the checked output"},

                    {RPCResult::Type::STR_HEX, "spendingtxid", /*optional=*/true, "the transaction id of the mempool transaction spending this output (omitted if unspent)"},

                    {RPCResult::Type::STR_HEX, "spendingtx", /*optional=*/true, "the transaction spending this output (only if return_spending_tx is set, omitted if unspent)"},

                    {RPCResult::Type::STR_HEX, "blockhash", /*optional=*/true, "the hash of the spending block (omitted if unspent or the spending tx is not confirmed)"},

                }},

            }

        },

        RPCExamples{

            HelpExampleCli("gettxspendingprevout", "\"[{\\\"txid\\\":\\\"a08e6907dbbd3d809776dbfc5d82e371b764ed838b5655e72f463568df1aadf0\\\",\\\"vout\\\":3}]\"")

            + HelpExampleRpc("gettxspendingprevout", "\"[{\\\"txid\\\":\\\"a08e6907dbbd3d809776dbfc5d82e371b764ed838b5655e72f463568df1aadf0\\\",\\\"vout\\\":3}]\"")

            + HelpExampleCliNamed("gettxspendingprevout", {{"outputs", "[{\"txid\":\"a08e6907dbbd3d809776dbfc5d82e371b764ed838b5655e72f463568df1aadf0\",\"vout\":3}]"}, {"return_spending_tx", true}})

        },

        [](const RPCMethod& self, const JSONRPCRequest& request) -> UniValue

        {

            const UniValue& output_params = request.params[0].get_array();

            if (output_params.empty()) {

                throw JSONRPCError(RPC_INVALID_PARAMETER, "Invalid parameter, outputs are missing");

            }

            const UniValue options{request.params[1].isNull() ? UniValue::VOBJ : request.params[1]};

            RPCTypeCheckObj(options,

                            {

                                {"mempool_only", UniValueType(UniValue::VBOOL)},

                                {"return_spending_tx", UniValueType(UniValue::VBOOL)},

                            }, /*fAllowNull=*/true, /*fStrict=*/true);

            const bool mempool_only{options.exists("mempool_only") ? options["mempool_only"].get_bool() : !g_txospenderindex};

            const bool return_spending_tx{options.exists("return_spending_tx") ? options["return_spending_tx"].get_bool() : false};

            // Worklist of outpoints to resolve

            struct Entry {

                COutPoint outpoint;

                size_t request_index;

            };

            std::vector<Entry> prevouts_to_process;

            prevouts_to_process.reserve(output_params.size());

            for (const size_t idx : std::views::iota(size_t{0}, output_params.size())) {

                const UniValue& o = output_params[idx].get_obj();

                RPCTypeCheckObj(o,

                                {

                                    {"txid", UniValueType(UniValue::VSTR)},

                                    {"vout", UniValueType(UniValue::VNUM)},

                                }, /*fAllowNull=*/false, /*fStrict=*/true);

                const Txid txid = Txid::FromUint256(ParseHashO(o, "txid"));

                const int nOutput{o.find_value("vout").getInt<int>()};

                if (nOutput < 0) {

                    throw JSONRPCError(RPC_INVALID_PARAMETER, "Invalid parameter, vout cannot be negative");

                }

                prevouts_to_process.emplace_back(COutPoint{txid, static_cast<uint32_t>(nOutput)}, idx);

            }

            auto make_output = [&output_params, return_spending_tx](const Entry& prevout, const CTransaction* spending_tx = nullptr) {

                UniValue o{output_params[prevout.request_index]};

                if (spending_tx) {

                    o.pushKV("spendingtxid", spending_tx->GetHash().ToString());

                    if (return_spending_tx) {

                        o.pushKV("spendingtx", EncodeHexTx(*spending_tx));

                    }