mining.h

Go to the documentation of this file.

// Copyright (c) 2024-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_INTERFACES_MINING_H
#define BITCOIN_INTERFACES_MINING_H
 
#include <consensus/amount.h>
#include <interfaces/types.h>
#include <node/mining_types.h>
#include <primitives/block.h>
#include <primitives/transaction.h>
#include <uint256.h>
#include <util/time.h>
 
#include <cstdint>
#include <memory>
#include <optional>
#include <stdexcept>
#include <string>
#include <vector>
 
namespace node {
struct NodeContext;
} // namespace node
 
namespace interfaces {
 
class BlockTemplate
{
public:
    virtual ~BlockTemplate() = default;
 
    virtual CBlockHeader getBlockHeader() = 0;
    // Block contains a dummy coinbase transaction that should not be used and
    // it may not match a transaction constructed from getCoinbaseTx().
    virtual CBlock getBlock() = 0;
 
    // Fees per transaction, not including coinbase transaction.
    virtual std::vector<CAmount> getTxFees() = 0;
    // Sigop cost per transaction, not including coinbase transaction.
    virtual std::vector<int64_t> getTxSigops() = 0;
 
    virtual node::CoinbaseTx getCoinbaseTx() = 0;
 
    virtual std::vector<uint256> getCoinbaseMerklePath() = 0;
 
    virtual bool submitSolution(uint32_t version, uint32_t timestamp, uint32_t nonce, CTransactionRef coinbase, std::string& reason, std::string& debug) = 0;
 
    virtual bool submitSolutionOld7(uint32_t, uint32_t, uint32_t, CTransactionRef)
    {
        throw std::runtime_error("Old submitSolution (@7) not supported. Please update your client!");
    }
 
    virtual std::unique_ptr<BlockTemplate> waitNext(node::BlockWaitOptions options = {}) = 0;
 
    virtual void interruptWait() = 0;
};
 
class Mining
{
public:
    virtual ~Mining() = default;
 
    virtual bool isTestChain() = 0;
 
    virtual bool isInitialBlockDownload() = 0;
 
    virtual std::optional<BlockRef> getTip() = 0;
 
    virtual std::optional<BlockRef> waitTipChanged(uint256 current_tip, MillisecondsDouble timeout = MillisecondsDouble::max()) = 0;
 
    virtual std::unique_ptr<BlockTemplate> createNewBlock(const node::BlockCreateOptions& options = {}, bool cooldown = true) = 0;
 
    virtual void interrupt() = 0;
 
    virtual bool checkBlock(const CBlock& block, const node::BlockCheckOptions& options, std::string& reason, std::string& debug) = 0;
 
    virtual bool submitBlock(const CBlock& block, std::string& reason, std::string& debug) = 0;
 
    virtual std::vector<CTransactionRef> getTransactionsByTxID(const std::vector<Txid>& txids) = 0;
 
    virtual std::vector<CTransactionRef> getTransactionsByWitnessID(const std::vector<Wtxid>& wtxids) = 0;
 
    virtual const node::NodeContext* context() { return nullptr; }
};
 
std::unique_ptr<Mining> MakeMining(const node::NodeContext& node, bool wait_loaded=true);
 
} // namespace interfaces
 
#endif // BITCOIN_INTERFACES_MINING_H