miner.h

Go to the documentation of this file.

// Copyright (c) 2009-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.
 
#ifndef BITCOIN_NODE_MINER_H
#define BITCOIN_NODE_MINER_H
 
#include <consensus/amount.h>
#include <node/mining_types.h>
#include <primitives/block.h>
#include <primitives/transaction.h>
#include <threadsafety.h>
#include <txmempool.h>
#include <util/feefrac.h>
 
#include <cstdint>
#include <memory>
#include <optional>
#include <vector>
 
class CBlockIndex;
class CChainParams;
class Chainstate;
class ChainstateManager;
 
namespace Consensus {
struct Params;
} // namespace Consensus
namespace node {
 
struct CBlockTemplate
{
    CBlock block;
    // Fees per transaction, not including coinbase transaction (unlike CBlock::vtx).
    std::vector<CAmount> vTxFees;
    // Sigops per transaction, not including coinbase transaction (unlike CBlock::vtx).
    std::vector<int64_t> vTxSigOpsCost;
    /* A vector of package fee rates, ordered by the sequence in which
     * packages are selected for inclusion in the block template.*/
    std::vector<FeePerVSize> m_package_feerates;
    /*
     * Template containing all coinbase transaction fields that are set by our
     * miner code.
     */
    CoinbaseTx m_coinbase_tx;
};
 
class BlockAssembler
{
private:
    // The constructed block template
    std::unique_ptr<CBlockTemplate> pblocktemplate;
 
    // Information on the current status of the block
    uint64_t nBlockWeight;
    uint64_t nBlockTx;
    uint64_t nBlockSigOpsCost;
    CAmount nFees;
 
    // Chain context for the block
    int nHeight;
    int64_t m_lock_time_cutoff;
 
    const CChainParams& chainparams;
    const CTxMemPool* const m_mempool;
    Chainstate& m_chainstate;
 
public:
    explicit BlockAssembler(Chainstate& chainstate,
                            const CTxMemPool* mempool,
                            BlockCreateOptions create_options);
 
    std::unique_ptr<CBlockTemplate> CreateNewBlock();
 
    inline static std::optional<int64_t> m_last_block_num_txs{};
    inline static std::optional<int64_t> m_last_block_weight{};
 
private:
    const BlockCreateOptions m_options;
 
    // utility functions
    void resetBlock();
    void AddToBlock(const CTxMemPoolEntry& entry);
 
    // Methods for how to add transactions to a block.
    void addChunks() EXCLUSIVE_LOCKS_REQUIRED(m_mempool->cs);
 
    // helper functions for addChunks()
    bool TestChunkBlockLimits(int64_t chunk_weight, int64_t chunk_sigops_cost) const;
    bool TestChunkTransactions(const std::vector<CTxMemPoolEntryRef>& txs) const;
};
 
int64_t GetMinimumTime(const CBlockIndex* pindexPrev, int64_t difficulty_adjustment_interval);
 
int64_t UpdateTime(CBlockHeader* pblock, const Consensus::Params& consensusParams, const CBlockIndex* pindexPrev);
 
void RegenerateCommitments(CBlock& block, ChainstateManager& chainman);
 
/* Compute the block's merkle root, insert or replace the coinbase transaction and the merkle root into the block */
void AddMerkleRootAndCoinbase(CBlock& block, CTransactionRef coinbase, uint32_t version, uint32_t timestamp, uint32_t nonce);
} // namespace node
 
#endif // BITCOIN_NODE_MINER_H