Bitcoin Core 31.99.0
P2P Digital Currency
policy.h
Go to the documentation of this file.
1// Copyright (c) 2009-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#ifndef BITCOIN_POLICY_POLICY_H
7#define BITCOIN_POLICY_POLICY_H
8
9#include <consensus/amount.h>
10#include <consensus/consensus.h>
13#include <script/interpreter.h>
14#include <script/solver.h>
15#include <util/feefrac.h>
16
17#include <cstdint>
18#include <string>
19
20class CCoinsViewCache;
21class CFeeRate;
22class CScript;
23
25static constexpr unsigned int DEFAULT_BLOCK_MAX_WEIGHT{MAX_BLOCK_WEIGHT};
27static constexpr unsigned int DEFAULT_BLOCK_RESERVED_WEIGHT{8000};
29static constexpr unsigned int DEFAULT_COINBASE_OUTPUT_MAX_ADDITIONAL_SIGOPS{400};
34static constexpr unsigned int MINIMUM_BLOCK_RESERVED_WEIGHT{2000};
36static constexpr unsigned int DEFAULT_BLOCK_MIN_TX_FEE{1};
38static constexpr int32_t MAX_STANDARD_TX_WEIGHT{400000};
40static constexpr unsigned int MIN_STANDARD_TX_NONWITNESS_SIZE{65};
42static constexpr unsigned int MAX_P2SH_SIGOPS{15};
44static constexpr unsigned int MAX_STANDARD_TX_SIGOPS_COST{MAX_BLOCK_SIGOPS_COST/5};
46static constexpr unsigned int MAX_TX_LEGACY_SIGOPS{2'500};
48static constexpr unsigned int DEFAULT_INCREMENTAL_RELAY_FEE{100};
50static constexpr unsigned int DEFAULT_BYTES_PER_SIGOP{20};
52static constexpr bool DEFAULT_PERMIT_BAREMULTISIG{true};
54static constexpr unsigned int MAX_STANDARD_P2WSH_STACK_ITEMS{100};
56static constexpr unsigned int MAX_STANDARD_P2WSH_STACK_ITEM_SIZE{80};
58static constexpr unsigned int MAX_STANDARD_TAPSCRIPT_STACK_ITEM_SIZE{80};
60static constexpr unsigned int MAX_STANDARD_P2WSH_SCRIPT_SIZE{3600};
62static constexpr unsigned int MAX_STANDARD_SCRIPTSIG_SIZE{1650};
68static constexpr unsigned int DUST_RELAY_TX_FEE{3000};
70static constexpr unsigned int DEFAULT_MIN_RELAY_TX_FEE{100};
72static constexpr unsigned int DEFAULT_CLUSTER_LIMIT{64};
74static constexpr unsigned int DEFAULT_CLUSTER_SIZE_LIMIT_KVB{101};
76static constexpr unsigned int DEFAULT_ANCESTOR_LIMIT{25};
78static constexpr unsigned int DEFAULT_DESCENDANT_LIMIT{25};
80static const bool DEFAULT_ACCEPT_DATACARRIER = true;
90static constexpr unsigned int EXTRA_DESCENDANT_TX_SIZE_LIMIT{10000};
91
95static constexpr unsigned int MAX_DUST_OUTPUTS_PER_TX{1};
96
112
133
136
139
140CAmount GetDustThreshold(const CTxOut& txout, const CFeeRate& dustRelayFee);
141
142bool IsDust(const CTxOut& txout, const CFeeRate& dustRelayFee);
143
144bool IsStandard(const CScript& scriptPubKey, TxoutType& whichType);
145
147std::vector<uint32_t> GetDust(const CTransaction& tx, CFeeRate dust_relay_rate);
148
149// Changing the default transaction version requires a two step process: first
150// adapting relay policy by bumping TX_MAX_STANDARD_VERSION, and then later
151// allowing the new transaction version in the wallet/RPC.
152static constexpr decltype(CTransaction::version) TX_MIN_STANDARD_VERSION{1};
153static constexpr decltype(CTransaction::version) TX_MAX_STANDARD_VERSION{3};
154
159bool IsStandardTx(const CTransaction& tx, const std::optional<unsigned>& max_datacarrier_bytes, bool permit_bare_multisig, const CFeeRate& dust_relay_fee, std::string& reason);
174bool IsWitnessStandard(const CTransaction& tx, const CCoinsViewCache& mapInputs);
179bool SpendsNonAnchorWitnessProg(const CTransaction& tx, const CCoinsViewCache& prevouts);
180
182int64_t GetVirtualTransactionSize(int64_t nWeight, int64_t nSigOpCost, unsigned int bytes_per_sigop);
183int64_t GetVirtualTransactionSize(const CTransaction& tx, int64_t nSigOpCost, unsigned int bytes_per_sigop);
184int64_t GetVirtualTransactionInputSize(const CTxIn& tx, int64_t nSigOpCost, unsigned int bytes_per_sigop);
185
186static inline int64_t GetVirtualTransactionSize(const CTransaction& tx)
187{
188 return GetVirtualTransactionSize(tx, 0, 0);
189}
190
191static inline int64_t GetVirtualTransactionInputSize(const CTxIn& tx)
192{
193 return GetVirtualTransactionInputSize(tx, 0, 0);
194}
195
196int64_t GetSigOpsAdjustedWeight(int64_t weight, int64_t sigop_cost, unsigned int bytes_per_sigop);
197
198static inline FeePerVSize ToFeePerVSize(FeePerWeight feerate) { return {feerate.fee, (feerate.size + WITNESS_SCALE_FACTOR - 1) / WITNESS_SCALE_FACTOR}; }
199
200#endif // BITCOIN_POLICY_POLICY_H
int64_t CAmount
Amount in satoshis (Can be negative)
Definition: amount.h:12
CCoinsView that adds a memory cache for transactions to another CCoinsView.
Definition: coins.h:368
Fee rate in satoshis per virtualbyte: CAmount / vB the feerate is represented internally as FeeFrac.
Definition: feerate.h:32
Serialized script, used inside transaction inputs and outputs.
Definition: script.h:405
The basic transaction that is broadcasted on the network and contained in blocks.
Definition: transaction.h:281
const uint32_t version
Definition: transaction.h:293
An input of a transaction.
Definition: transaction.h:62
An output of a transaction.
Definition: transaction.h:140
static constexpr unsigned int LOCKTIME_VERIFY_SEQUENCE
Flags for nSequence and nLockTime locks.
Definition: consensus.h:28
static const unsigned int MAX_BLOCK_WEIGHT
The maximum allowed weight for a block, see BIP 141 (network rule)
Definition: consensus.h:15
static const int64_t MAX_BLOCK_SIGOPS_COST
The maximum allowed number of signature check operations in a block (network rule)
Definition: consensus.h:17
static const int WITNESS_SCALE_FACTOR
Definition: consensus.h:21
@ SCRIPT_VERIFY_DISCOURAGE_UPGRADABLE_TAPROOT_VERSION
@ SCRIPT_VERIFY_DISCOURAGE_UPGRADABLE_WITNESS_PROGRAM
@ SCRIPT_VERIFY_DISCOURAGE_UPGRADABLE_PUBKEYTYPE
int64_t GetVirtualTransactionInputSize(const CTxIn &tx, int64_t nSigOpCost, unsigned int bytes_per_sigop)
Definition: policy.cpp:405
static constexpr unsigned int DEFAULT_COINBASE_OUTPUT_MAX_ADDITIONAL_SIGOPS
Default sigops cost to reserve for coinbase transaction outputs when creating block templates.
Definition: policy.h:29
static const unsigned int MAX_OP_RETURN_RELAY
Default setting for -datacarriersize in vbytes.
Definition: policy.h:84
static constexpr decltype(CTransaction::version) TX_MIN_STANDARD_VERSION
Definition: policy.h:152
static constexpr unsigned int DEFAULT_BLOCK_MIN_TX_FEE
Default for -blockmintxfee, which sets the minimum feerate for a transaction in blocks created by min...
Definition: policy.h:36
static constexpr unsigned int EXTRA_DESCENDANT_TX_SIZE_LIMIT
An extra transaction can be added to a package, as long as it only has one ancestor and is no larger ...
Definition: policy.h:90
TxValidationState ValidateInputsStandardness(const CTransaction &tx, const CCoinsViewCache &mapInputs)
Check for standard transaction types.
Definition: policy.cpp:214
static constexpr unsigned int MAX_TX_LEGACY_SIGOPS
The maximum number of potentially executed legacy signature operations in a single standard tx.
Definition: policy.h:46
static constexpr script_verify_flags STANDARD_SCRIPT_VERIFY_FLAGS
Standard script verification flags that standard transactions will comply with.
Definition: policy.h:119
static constexpr unsigned int DEFAULT_INCREMENTAL_RELAY_FEE
Default for -incrementalrelayfee, which sets the minimum feerate increase for mempool limiting or rep...
Definition: policy.h:48
static constexpr decltype(CTransaction::version) TX_MAX_STANDARD_VERSION
Definition: policy.h:153
static constexpr bool DEFAULT_PERMIT_BAREMULTISIG
Default for -permitbaremultisig.
Definition: policy.h:52
static constexpr unsigned int MAX_STANDARD_P2WSH_STACK_ITEMS
The maximum number of witness stack items in a standard P2WSH script.
Definition: policy.h:54
static constexpr unsigned int STANDARD_LOCKTIME_VERIFY_FLAGS
Used as the flags parameter to sequence and nLocktime checks in non-consensus code.
Definition: policy.h:138
static constexpr unsigned int DUST_RELAY_TX_FEE
Min feerate for defining dust.
Definition: policy.h:68
bool SpendsNonAnchorWitnessProg(const CTransaction &tx, const CCoinsViewCache &prevouts)
Check whether this transaction spends any witness program but P2A, including not-yet-defined ones.
Definition: policy.cpp:354
int64_t GetVirtualTransactionSize(int64_t nWeight, int64_t nSigOpCost, unsigned int bytes_per_sigop)
Compute the virtual transaction size (weight reinterpreted as bytes).
Definition: policy.cpp:395
static constexpr unsigned int DEFAULT_DESCENDANT_LIMIT
Default for -limitdescendantcount, max number of in-mempool descendants.
Definition: policy.h:78
static constexpr script_verify_flags MANDATORY_SCRIPT_VERIFY_FLAGS
Mandatory script verification flags that all new transactions must comply with for them to be valid.
Definition: policy.h:105
bool IsWitnessStandard(const CTransaction &tx, const CCoinsViewCache &mapInputs)
Check if the transaction is over standard P2WSH resources limit: 3600bytes witnessScript size,...
Definition: policy.cpp:265
static constexpr unsigned int MAX_STANDARD_TAPSCRIPT_STACK_ITEM_SIZE
The maximum size in bytes of each witness stack item in a standard BIP 342 script (Taproot,...
Definition: policy.h:58
static constexpr unsigned int DEFAULT_BYTES_PER_SIGOP
Default for -bytespersigop.
Definition: policy.h:50
static constexpr unsigned int MAX_STANDARD_TX_SIGOPS_COST
The maximum number of sigops we're willing to relay/mine in a single tx.
Definition: policy.h:44
bool IsDust(const CTxOut &txout, const CFeeRate &dustRelayFee)
Definition: policy.cpp:66
static constexpr unsigned int DEFAULT_BLOCK_MAX_WEIGHT
Default for -blockmaxweight, which controls the range of block weights the mining code will create.
Definition: policy.h:25
static constexpr unsigned int MIN_STANDARD_TX_NONWITNESS_SIZE
The minimum non-witness size for transactions we're willing to relay/mine: one larger than 64
Definition: policy.h:40
static constexpr unsigned int MAX_DUST_OUTPUTS_PER_TX
Maximum number of ephemeral dust outputs allowed.
Definition: policy.h:95
bool IsStandard(const CScript &scriptPubKey, TxoutType &whichType)
Definition: policy.cpp:80
bool IsStandardTx(const CTransaction &tx, const std::optional< unsigned > &max_datacarrier_bytes, bool permit_bare_multisig, const CFeeRate &dust_relay_fee, std::string &reason)
Check for standard transaction types.
Definition: policy.cpp:100
static constexpr unsigned int DEFAULT_CLUSTER_SIZE_LIMIT_KVB
Maximum size of cluster in virtual kilobytes.
Definition: policy.h:74
std::vector< uint32_t > GetDust(const CTransaction &tx, CFeeRate dust_relay_rate)
Get the vout index numbers of all dust outputs.
Definition: policy.cpp:71
static constexpr unsigned int MAX_STANDARD_P2WSH_STACK_ITEM_SIZE
The maximum size in bytes of each witness stack item in a standard P2WSH script.
Definition: policy.h:56
static constexpr unsigned int DEFAULT_BLOCK_RESERVED_WEIGHT
Default for -blockreservedweight.
Definition: policy.h:27
static constexpr int32_t MAX_STANDARD_TX_WEIGHT
The maximum weight for transactions we're willing to relay/mine.
Definition: policy.h:38
static FeePerVSize ToFeePerVSize(FeePerWeight feerate)
Definition: policy.h:198
int64_t GetSigOpsAdjustedWeight(int64_t weight, int64_t sigop_cost, unsigned int bytes_per_sigop)
Definition: policy.cpp:390
CAmount GetDustThreshold(const CTxOut &txout, const CFeeRate &dustRelayFee)
Definition: policy.cpp:27
static constexpr unsigned int MAX_P2SH_SIGOPS
Maximum number of signature check operations in an IsStandard() P2SH script.
Definition: policy.h:42
static constexpr script_verify_flags STANDARD_NOT_MANDATORY_VERIFY_FLAGS
For convenience, standard but not mandatory verify flags.
Definition: policy.h:135
static const bool DEFAULT_ACCEPT_DATACARRIER
Default for -datacarrier.
Definition: policy.h:80
static constexpr unsigned int MAX_STANDARD_P2WSH_SCRIPT_SIZE
The maximum size in bytes of a standard witnessScript.
Definition: policy.h:60
static constexpr unsigned int DEFAULT_ANCESTOR_LIMIT
Default for -limitancestorcount, max number of in-mempool ancestors.
Definition: policy.h:76
static constexpr unsigned int MINIMUM_BLOCK_RESERVED_WEIGHT
This accounts for the block header, var_int encoding of the transaction count and a minimally viable ...
Definition: policy.h:34
static constexpr unsigned int MAX_STANDARD_SCRIPTSIG_SIZE
The maximum size of a standard ScriptSig.
Definition: policy.h:62
static constexpr unsigned int DEFAULT_CLUSTER_LIMIT
Maximum number of transactions per cluster (default)
Definition: policy.h:72
static constexpr unsigned int DEFAULT_MIN_RELAY_TX_FEE
Default for -minrelaytxfee, minimum relay fee for transactions.
Definition: policy.h:70
TxoutType
Definition: solver.h:22
int64_t fee
Definition: feefrac.h:108
int32_t size
Definition: feefrac.h:109