1 // Copyright (c) 2017-2020 The Bitcoin Core developers 2 // Distributed under the MIT software license, see the accompanying 3 // file COPYING or http://www.opensource.org/licenses/mit-license.php. 4 5 #ifndef BITCOIN_NODE_TRANSACTION_H 6 #define BITCOIN_NODE_TRANSACTION_H 7 8 #include <attributes.h> 9 #include <policy/feerate.h> 10 #include <primitives/transaction.h> 11 #include <util/error.h> 12 13 struct NodeContext; 14 15 /** Maximum fee rate for sendrawtransaction and testmempoolaccept RPC calls. 16 * Also used by the GUI when broadcasting a completed PSBT. 17 * By default, a transaction with a fee rate higher than this will be rejected 18 * by these RPCs and the GUI. This can be overridden with the maxfeerate argument. 19 */ 20 static const CFeeRate DEFAULT_MAX_RAW_TX_FEE_RATE{COIN / 10}; 21 22 /** 23 * Submit a transaction to the mempool and (optionally) relay it to all P2P peers. 24 * 25 * Mempool submission can be synchronous (will await mempool entry notification 26 * over the CValidationInterface) or asynchronous (will submit and not wait for 27 * notification), depending on the value of wait_callback. wait_callback MUST 28 * NOT be set while cs_main, cs_mempool or cs_wallet are held to avoid 29 * deadlock. 30 * 31 * @param[in] node reference to node context 32 * @param[in] tx the transaction to broadcast 33 * @param[out] err_string reference to std::string to fill with error string if available 34 * @param[in] max_tx_fee reject txs with fees higher than this (if 0, accept any fee) 35 * @param[in] relay flag if both mempool insertion and p2p relay are requested 36 * @param[in] wait_callback wait until callbacks have been processed to avoid stale result due to a sequentially RPC. 37 * return error 38 */ 39 [[nodiscard]] TransactionError BroadcastTransaction(NodeContext& node, CTransactionRef tx, std::string& err_string, const CAmount& max_tx_fee, bool relay, bool wait_callback); 40 41 #endif // BITCOIN_NODE_TRANSACTION_H 42