transaction.h File Reference

#include <attributes.h>
#include <policy/feerate.h>
#include <primitives/transaction.h>
#include <util/error.h>

Include dependency graph for transaction.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Namespaces
	Consensus
	Transaction validation functions.

Functions
TransactionError	BroadcastTransaction (NodeContext &node, CTransactionRef tx, std::string &err_string, const CAmount &max_tx_fee, bool relay, bool wait_callback)
	Submit a transaction to the mempool and (optionally) relay it to all P2P peers. More...
CTransactionRef	GetTransaction (const CBlockIndex *const block_index, const CTxMemPool *const mempool, const uint256 &hash, const Consensus::Params &consensusParams, uint256 &hashBlock)
	Return transaction with a given hash. More...

Variables
static const CFeeRate	DEFAULT_MAX_RAW_TX_FEE_RATE {COIN / 10}
	Maximum fee rate for sendrawtransaction and testmempoolaccept RPC calls. More...

Function Documentation

BroadcastTransaction()

TransactionError BroadcastTransaction	(	NodeContext &	node,
		CTransactionRef	tx,
		std::string &	err_string,
		const CAmount &	max_tx_fee,
		bool	relay,
		bool	wait_callback
	)

Submit a transaction to the mempool and (optionally) relay it to all P2P peers.

Mempool submission can be synchronous (will await mempool entry notification over the CValidationInterface) or asynchronous (will submit and not wait for notification), depending on the value of wait_callback. wait_callback MUST NOT be set while cs_main, cs_mempool or cs_wallet are held to avoid deadlock.

Parameters

[in]	node	reference to node context
[in]	tx	the transaction to broadcast
[out]	err_string	reference to std::string to fill with error string if available
[in]	max_tx_fee	reject txs with fees higher than this (if 0, accept any fee)
[in]	relay	flag if both mempool insertion and p2p relay are requested
[in]	wait_callback	wait until callbacks have been processed to avoid stale result due to a sequentially RPC. return error

Definition at line 32 of file transaction.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

GetTransaction()

CTransactionRef GetTransaction	(	const CBlockIndex *const	block_index,
		const CTxMemPool *const	mempool,
		const uint256 &	hash,
		const Consensus::Params &	consensusParams,
		uint256 &	hashBlock
	)

Return transaction with a given hash.

If mempool is provided and block_index is not provided, check it first for the tx. If -txindex is available, check it next for the tx. Finally, if block_index is provided, check for tx by reading entire block from disk.

Parameters

[in]	block_index	The block to read from disk, or nullptr
[in]	mempool	If provided, check mempool for tx
[in]	hash	The txid
[in]	consensusParams	The params
[out]	hashBlock	The block hash, if the tx was found via -txindex or block_index

Returns

The tx if found, otherwise nullptr

Definition at line 126 of file transaction.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

Variable Documentation

DEFAULT_MAX_RAW_TX_FEE_RATE

const CFeeRate DEFAULT_MAX_RAW_TX_FEE_RATE {COIN / 10}

static

Maximum fee rate for sendrawtransaction and testmempoolaccept RPC calls.

Also used by the GUI when broadcasting a completed PSBT. By default, a transaction with a fee rate higher than this will be rejected by these RPCs and the GUI. This can be overridden with the maxfeerate argument.

Definition at line 25 of file transaction.h.