mirror of
https://github.com/bitcoin/bitcoin.git
synced 2025-04-25 08:01:02 +02:00
6b4c817d4b
Rather than pass options individually to createNewBlock and then combining them into BlockAssembler::Options, this commit introduces BlockCreateOptions and passes that instead. Currently there's only one option (use_mempool) but the next commit adds more. Co-authored-by: Ryan Ofsky <ryan@ofsky.org>
87 lines
2.8 KiB
C++
87 lines
2.8 KiB
C++
// Copyright (c) 2024 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 <node/types.h>
|
|
#include <uint256.h>
|
|
|
|
#include <memory>
|
|
#include <optional>
|
|
|
|
namespace node {
|
|
struct CBlockTemplate;
|
|
struct NodeContext;
|
|
} // namespace node
|
|
|
|
class BlockValidationState;
|
|
class CBlock;
|
|
class CScript;
|
|
|
|
namespace interfaces {
|
|
|
|
//! Interface giving clients (RPC, Stratum v2 Template Provider in the future)
|
|
//! ability to create block templates.
|
|
|
|
class Mining
|
|
{
|
|
public:
|
|
virtual ~Mining() = default;
|
|
|
|
//! If this chain is exclusively used for testing
|
|
virtual bool isTestChain() = 0;
|
|
|
|
//! Returns whether IBD is still in progress.
|
|
virtual bool isInitialBlockDownload() = 0;
|
|
|
|
//! Returns the hash for the tip of this chain
|
|
virtual std::optional<uint256> getTipHash() = 0;
|
|
|
|
/**
|
|
* Construct a new block template
|
|
*
|
|
* @param[in] script_pub_key the coinbase output
|
|
* @param[in] options options for creating the block
|
|
* @returns a block template
|
|
*/
|
|
virtual std::unique_ptr<node::CBlockTemplate> createNewBlock(const CScript& script_pub_key, const node::BlockCreateOptions& options={}) = 0;
|
|
|
|
/**
|
|
* Processes new block. A valid new block is automatically relayed to peers.
|
|
*
|
|
* @param[in] block The block we want to process.
|
|
* @param[out] new_block A boolean which is set to indicate if the block was first received via this call
|
|
* @returns If the block was processed, independently of block validity
|
|
*/
|
|
virtual bool processNewBlock(const std::shared_ptr<const CBlock>& block, bool* new_block) = 0;
|
|
|
|
//! Return the number of transaction updates in the mempool,
|
|
//! used to decide whether to make a new block template.
|
|
virtual unsigned int getTransactionsUpdated() = 0;
|
|
|
|
/**
|
|
* Check a block is completely valid from start to finish.
|
|
* Only works on top of our current best block.
|
|
* Does not check proof-of-work.
|
|
*
|
|
* @param[in] block the block to validate
|
|
* @param[in] check_merkle_root call CheckMerkleRoot()
|
|
* @param[out] state details of why a block failed to validate
|
|
* @returns false if it does not build on the current tip, or any of the checks fail
|
|
*/
|
|
virtual bool testBlockValidity(const CBlock& block, bool check_merkle_root, BlockValidationState& state) = 0;
|
|
|
|
//! Get internal node context. Useful for RPC and testing,
|
|
//! but not accessible across processes.
|
|
virtual node::NodeContext* context() { return nullptr; }
|
|
};
|
|
|
|
//! Return implementation of Mining interface.
|
|
std::unique_ptr<Mining> MakeMining(node::NodeContext& node);
|
|
|
|
} // namespace interfaces
|
|
|
|
#endif // BITCOIN_INTERFACES_MINING_H
|