9#include <chainparams.h>
39 const int height{pindexPrev->
nHeight + 1};
42 if (height % difficulty_adjustment_interval == 0) {
50 int64_t nOldTime = pblock->
nTime;
54 if (nOldTime < nNewTime) {
55 pblock->
nTime = nNewTime;
63 return nNewTime - nOldTime;
90 : chainparams{chainstate.m_chainman.GetParams()},
91 m_mempool{options.use_mempool ? mempool : nullptr},
92 m_chainstate{chainstate},
101 if (
const auto blockmintxfee{
args.
GetArg(
"-blockmintxfee")}) {
104 options.print_modified_fee =
args.
GetBoolArg(
"-printpriority", options.print_modified_fee);
105 options.block_reserved_weight =
args.
GetIntArg(
"-blockreservedweight", options.block_reserved_weight);
108void BlockAssembler::resetBlock()
113 nBlockWeight = m_options.block_reserved_weight;
114 nBlockSigOpsCost = m_options.coinbase_output_max_additional_sigops;
121std::unique_ptr<CBlockTemplate> BlockAssembler::CreateNewBlock()
123 const auto time_start{SteadyClock::now()};
128 CBlock*
const pblock = &pblocktemplate->block;
132 pblock->
vtx.emplace_back();
135 CBlockIndex* pindexPrev = m_chainstate.m_chain.Tip();
136 assert(pindexPrev !=
nullptr);
139 pblock->
nVersion = m_chainstate.m_chainman.m_versionbitscache.ComputeBlockVersion(pindexPrev, chainparams.GetConsensus());
142 if (chainparams.MineBlocksOnDemand()) {
149 int nPackagesSelected = 0;
150 int nDescendantsUpdated = 0;
152 addPackageTxs(nPackagesSelected, nDescendantsUpdated);
155 const auto time_1{SteadyClock::now()};
157 m_last_block_num_txs = nBlockTx;
158 m_last_block_weight = nBlockWeight;
162 coinbaseTx.
vin.resize(1);
163 coinbaseTx.
vin[0].prevout.SetNull();
165 coinbaseTx.
vout.resize(1);
166 coinbaseTx.
vout[0].scriptPubKey = m_options.coinbase_output_script;
172 pblocktemplate->vchCoinbaseCommitment = m_chainstate.m_chainman.GenerateCoinbaseCommitment(*pblock, pindexPrev);
174 LogPrintf(
"CreateNewBlock(): block weight: %u txs: %u fees: %ld sigops %d\n",
GetBlockWeight(*pblock), nBlockTx, nFees, nBlockSigOpsCost);
178 UpdateTime(pblock, chainparams.GetConsensus(), pindexPrev);
183 if (m_options.test_block_validity && !
TestBlockValidity(state, chainparams, m_chainstate, *pblock, pindexPrev,
185 throw std::runtime_error(
strprintf(
"%s: TestBlockValidity failed: %s", __func__, state.
ToString()));
187 const auto time_2{SteadyClock::now()};
189 LogDebug(
BCLog::BENCH,
"CreateNewBlock() packages: %.2fms (%d packages, %d updated descendants), validity: %.2fms (total %.2fms)\n",
190 Ticks<MillisecondsDouble>(time_1 - time_start), nPackagesSelected, nDescendantsUpdated,
191 Ticks<MillisecondsDouble>(time_2 - time_1),
192 Ticks<MillisecondsDouble>(time_2 - time_start));
194 return std::move(pblocktemplate);
199 for (CTxMemPool::setEntries::iterator iit = testSet.begin(); iit != testSet.end(); ) {
201 if (inBlock.count((*iit)->GetSharedTx()->GetHash())) {
202 testSet.erase(iit++);
209bool BlockAssembler::TestPackage(uint64_t packageSize, int64_t packageSigOpsCost)
const
235 pblocktemplate->block.vtx.emplace_back(iter->GetSharedTx());
236 pblocktemplate->vTxFees.push_back(iter->GetFee());
237 pblocktemplate->vTxSigOpsCost.push_back(iter->GetSigOpCost());
238 nBlockWeight += iter->GetTxWeight();
240 nBlockSigOpsCost += iter->GetSigOpCost();
241 nFees += iter->GetFee();
242 inBlock.insert(iter->GetSharedTx()->GetHash());
244 if (m_options.print_modified_fee) {
247 iter->GetTx().GetHash().ToString());
260 int nDescendantsUpdated = 0;
263 mempool.CalculateDescendants(it, descendants);
266 if (alreadyAdded.count(desc)) {
269 ++nDescendantsUpdated;
270 modtxiter mit = mapModifiedTx.find(desc);
271 if (mit == mapModifiedTx.end()) {
273 mit = mapModifiedTx.insert(modEntry).first;
278 return nDescendantsUpdated;
287 sortedEntries.clear();
288 sortedEntries.insert(sortedEntries.begin(), package.begin(), package.end());
302void BlockAssembler::addPackageTxs(
int& nPackagesSelected,
int& nDescendantsUpdated)
304 const auto& mempool{*
Assert(m_mempool)};
311 std::set<Txid> failedTx;
313 CTxMemPool::indexed_transaction_set::index<ancestor_score>::type::iterator mi = mempool.mapTx.get<
ancestor_score>().begin();
319 const int64_t MAX_CONSECUTIVE_FAILURES = 1000;
320 constexpr int32_t BLOCK_FULL_ENOUGH_WEIGHT_DELTA = 4000;
321 int64_t nConsecutiveFailed = 0;
323 while (mi != mempool.mapTx.get<
ancestor_score>().end() || !mapModifiedTx.empty()) {
338 auto it = mempool.mapTx.project<0>(mi);
339 assert(it != mempool.mapTx.end());
340 if (mapModifiedTx.count(it) || inBlock.count(it->GetSharedTx()->GetHash()) || failedTx.count(it->GetSharedTx()->GetHash())) {
348 bool fUsingModified =
false;
354 fUsingModified =
true;
357 iter = mempool.mapTx.project<0>(mi);
364 fUsingModified =
true;
374 assert(!inBlock.count(iter->GetSharedTx()->GetHash()));
376 uint64_t packageSize = iter->GetSizeWithAncestors();
377 CAmount packageFees = iter->GetModFeesWithAncestors();
378 int64_t packageSigOpsCost = iter->GetSigOpCostWithAncestors();
379 if (fUsingModified) {
380 packageSize = modit->nSizeWithAncestors;
381 packageFees = modit->nModFeesWithAncestors;
382 packageSigOpsCost = modit->nSigOpCostWithAncestors;
385 if (packageFees < m_options.blockMinFeeRate.GetFee(packageSize)) {
390 if (!TestPackage(packageSize, packageSigOpsCost)) {
391 if (fUsingModified) {
396 failedTx.insert(iter->GetSharedTx()->GetHash());
399 ++nConsecutiveFailed;
401 if (nConsecutiveFailed > MAX_CONSECUTIVE_FAILURES && nBlockWeight >
402 m_options.nBlockMaxWeight - BLOCK_FULL_ENOUGH_WEIGHT_DELTA) {
411 onlyUnconfirmed(ancestors);
412 ancestors.insert(iter);
415 if (!TestPackageTransactions(ancestors)) {
416 if (fUsingModified) {
418 failedTx.insert(iter->GetSharedTx()->GetHash());
424 nConsecutiveFailed = 0;
427 std::vector<CTxMemPool::txiter> sortedEntries;
428 SortForBlock(ancestors, sortedEntries);
430 for (
size_t i = 0; i < sortedEntries.size(); ++i) {
431 AddToBlock(sortedEntries[i]);
433 mapModifiedTx.erase(sortedEntries[i]);
437 pblocktemplate->m_package_feerates.emplace_back(packageFees,
static_cast<int32_t
>(packageSize));
446 if (block.
vtx.size() == 0) {
447 block.
vtx.emplace_back(coinbase);
449 block.
vtx[0] = coinbase;
452 block.
nTime = timestamp;
460 const std::unique_ptr<CBlockTemplate>& block_template,
471 const auto deadline = now + options.
timeout;
476 bool tip_changed{
false};
481 AssertLockHeld(kernel_notifications.m_tip_block_mutex);
482 const auto tip_block{kernel_notifications.TipBlock()};
486 tip_changed =
Assume(tip_block) && tip_block != block_template->block.hashPrevBlock;
499 if (!tip_changed && allow_min_difficulty) {
501 if (now > tip_time + 20min) {
522 if (tip_changed)
return new_tmpl;
525 if (current_fees == -1) {
536 if (new_fees >= current_fees + options.
fee_threshold)
return new_tmpl;
541 }
while (now < deadline);
551 return BlockRef{tip->GetBlockHash(), tip->nHeight};
557 if (timeout < 0ms) timeout = 0ms;
558 if (timeout > std::chrono::years{100}) timeout = std::chrono::years{100};
559 auto deadline{std::chrono::steady_clock::now() + timeout};
567 return kernel_notifications.TipBlock() || chainman.m_interrupt;
573 return Assume(kernel_notifications.TipBlock()) != current_tip || chainman.m_interrupt;
static constexpr CAmount MAX_MONEY
No amount larger than this (in satoshi) is valid.
int64_t CAmount
Amount in satoshis (Can be negative)
#define Assert(val)
Identity function.
#define Assume(val)
Assume is the identity function.
int64_t GetIntArg(const std::string &strArg, int64_t nDefault) const
Return integer argument or default value.
std::string GetArg(const std::string &strArg, const std::string &strDefault) const
Return string argument or default value.
bool GetBoolArg(const std::string &strArg, bool fDefault) const
Return boolean argument or default value.
std::vector< CTransactionRef > vtx
The block chain is a tree shaped structure starting with the genesis block at the root,...
uint256 GetBlockHash() const
int64_t GetBlockTime() const
int64_t GetMedianTimePast() const
int nHeight
height of the entry in the chain. The genesis block has height 0
CBlockIndex * Tip() const
Returns the index entry for the tip of this chain, or nullptr if none.
const Consensus::Params & GetConsensus() const
Fee rate in satoshis per kilovirtualbyte: CAmount / kvB.
std::string ToString(const FeeEstimateMode &fee_estimate_mode=FeeEstimateMode::BTC_KVB) const
Serialized script, used inside transaction inputs and outputs.
static const uint32_t MAX_SEQUENCE_NONFINAL
This is the maximum sequence number that enables both nLockTime and OP_CHECKLOCKTIMEVERIFY (BIP 65).
CTxMemPool stores valid-according-to-the-current-best-chain transactions that may be included in the ...
std::set< txiter, CompareIteratorByHash > setEntries
indexed_transaction_set::nth_index< 0 >::type::const_iterator txiter
Chainstate stores and provides an API to update our local knowledge of the current best chain.
Provides an interface for creating and interacting with one or two chainstates: an IBD chainstate gen...
SnapshotCompletionResult MaybeCompleteSnapshotValidation() EXCLUSIVE_LOCKS_REQUIRED(const CBlockIndex *GetSnapshotBaseBlock() const EXCLUSIVE_LOCKS_REQUIRED(Chainstate ActiveChainstate)() const
Once the background validation chainstate has reached the height which is the base of the UTXO snapsh...
std::vector< unsigned char > GenerateCoinbaseCommitment(CBlock &block, const CBlockIndex *pindexPrev) const
Produce the necessary coinbase commitment for a block (modifies the hash, don't call for mined blocks...
const util::SignalInterrupt & m_interrupt
const CChainParams & GetParams() const
CChain & ActiveChain() const EXCLUSIVE_LOCKS_REQUIRED(GetMutex())
node::BlockManager m_blockman
A single BlockManager instance is shared across each constructed chainstate to avoid duplicating bloc...
std::string ToString() const
Generate a new block, without valid proof-of-work.
BlockAssembler(Chainstate &chainstate, const CTxMemPool *mempool, const Options &options)
CBlockIndex * LookupBlockIndex(const uint256 &hash) EXCLUSIVE_LOCKS_REQUIRED(cs_main)
static int64_t GetBlockWeight(const CBlock &block)
int GetWitnessCommitmentIndex(const CBlock &block)
Compute at which vout of the block's coinbase transaction the witness commitment occurs,...
static constexpr int64_t MAX_TIMEWARP
Maximum number of seconds that the timestamp of the first block of a difficulty adjustment period is ...
static const unsigned int MAX_BLOCK_WEIGHT
The maximum allowed weight for a block, see BIP 141 (network rule)
static const int64_t MAX_BLOCK_SIGOPS_COST
The maximum allowed number of signature check operations in a block (network rule)
static const int WITNESS_SCALE_FACTOR
RecursiveMutex cs_main
Mutex to guard access to validation specific variables, such as reading or changing the chainstate.
#define LogDebug(category,...)
uint256 BlockMerkleRoot(const CBlock &block, bool *mutated)
std::optional< CAmount > ParseMoney(const std::string &money_string)
Parse an amount denoted in full coins.
static BlockAssembler::Options ClampOptions(BlockAssembler::Options options)
boost::multi_index_container< CTxMemPoolModifiedEntry, CTxMemPoolModifiedEntry_Indices > indexed_modified_transaction_set
indexed_modified_transaction_set::nth_index< 0 >::type::iterator modtxiter
void RegenerateCommitments(CBlock &block, ChainstateManager &chainman)
Update an old GenerateCoinbaseCommitment from CreateNewBlock after the block txs have changed.
int64_t GetMinimumTime(const CBlockIndex *pindexPrev, const int64_t difficulty_adjustment_interval)
Get the minimum time a miner should use in the next block.
int64_t UpdateTime(CBlockHeader *pblock, const Consensus::Params &consensusParams, const CBlockIndex *pindexPrev)
indexed_modified_transaction_set::index< ancestor_score >::type::iterator modtxscoreiter
util::Result< void > ApplyArgsManOptions(const ArgsManager &args, BlockManager::Options &opts)
static int UpdatePackagesForAdded(const CTxMemPool &mempool, const CTxMemPool::setEntries &alreadyAdded, indexed_modified_transaction_set &mapModifiedTx) EXCLUSIVE_LOCKS_REQUIRED(mempool.cs)
Add descendants of given transactions to mapModifiedTx with ancestor state updated assuming given tra...
std::optional< BlockRef > WaitTipChanged(ChainstateManager &chainman, KernelNotifications &kernel_notifications, const uint256 ¤t_tip, MillisecondsDouble &timeout)
std::unique_ptr< CBlockTemplate > WaitAndCreateNewBlock(ChainstateManager &chainman, KernelNotifications &kernel_notifications, CTxMemPool *mempool, const std::unique_ptr< CBlockTemplate > &block_template, const BlockWaitOptions &options, const BlockAssembler::Options &assemble_options)
Return a new block template when fees rise to a certain threshold or after a new tip; return nullopt ...
void AddMerkleRootAndCoinbase(CBlock &block, CTransactionRef coinbase, uint32_t version, uint32_t timestamp, uint32_t nonce)
std::optional< BlockRef > GetTip(ChainstateManager &chainman)
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 ...
unsigned int GetNextWorkRequired(const CBlockIndex *pindexLast, const CBlockHeader *pblock, const Consensus::Params ¶ms)
static CTransactionRef MakeTransactionRef(Tx &&txIn)
std::shared_ptr< const CTransaction > CTransactionRef
A mutable version of CTransaction.
std::vector< CTxOut > vout
Parameters that influence chain consensus.
int64_t DifficultyAdjustmentInterval() const
bool fPowAllowMinDifficultyBlocks
static time_point now() noexcept
Return current system time or mocked time, if set.
std::chrono::time_point< NodeClock > time_point
Hash/height pair to help track and identify blocks.
static constexpr MemPoolLimits NoLimits()
size_t block_reserved_weight
The default reserved weight for the fixed-size block header, transaction count and coinbase transacti...
size_t coinbase_output_max_additional_sigops
The maximum additional sigops which the pool will add in coinbase transaction outputs.
MillisecondsDouble timeout
How long to wait before returning nullptr instead of a new template.
CAmount fee_threshold
The wait method will not return a new template unless it has fees at least fee_threshold sats higher ...
#define WAIT_LOCK(cs, name)
#define WITH_LOCK(cs, code)
Run code while locking a mutex.
#define EXCLUSIVE_LOCKS_REQUIRED(...)
bool IsFinalTx(const CTransaction &tx, int nBlockHeight, int64_t nBlockTime)
Check if transaction is final and can be included in a block with the specified height and time.
std::chrono::duration< double, std::chrono::milliseconds::period > MillisecondsDouble
CAmount GetBlockSubsidy(int nHeight, const Consensus::Params &consensusParams)
bool TestBlockValidity(BlockValidationState &state, const CChainParams &chainparams, Chainstate &chainstate, const CBlock &block, CBlockIndex *pindexPrev, bool fCheckPOW, bool fCheckMerkleRoot)
Check a block is completely valid from start to finish (only works on top of our current best block)