interfaces::Mining Class Reference

Interface giving clients (RPC, Stratum v2 Template Provider in the future) ability to create block templates. More...

#include <mining.h>

Public Member Functions
virtual	~Mining ()=default
virtual bool	isTestChain ()=0
	If this chain is exclusively used for testing. More...
virtual bool	isInitialBlockDownload ()=0
	Returns whether IBD is still in progress. More...
virtual std::optional< BlockRef >	getTip ()=0
	Returns the hash and height for the tip of this chain. More...
virtual std::optional< BlockRef >	waitTipChanged (uint256 current_tip, MillisecondsDouble timeout=MillisecondsDouble::max())=0
	Waits for the connected tip to change. More...
virtual std::unique_ptr< BlockTemplate >	createNewBlock (const node::BlockCreateOptions &options={})=0
	Construct a new block template. More...
virtual node::NodeContext *	context ()
	Get internal node context. More...

Detailed Description

Interface giving clients (RPC, Stratum v2 Template Provider in the future) ability to create block templates.

Definition at line 79 of file mining.h.

Constructor & Destructor Documentation

~Mining()

virtual interfaces::Mining::~Mining ( )

virtualdefault

Member Function Documentation

context()

virtual node::NodeContext * interfaces::Mining::context ( )

inlinevirtual

Get internal node context.

Useful for RPC and testing, but not accessible across processes.

Definition at line 119 of file mining.h.

createNewBlock()

virtual std::unique_ptr< BlockTemplate > interfaces::Mining::createNewBlock ( const node::BlockCreateOptions &  options = {} )

pure virtual

Construct a new block template.

During node initialization, this will wait until the tip is connected.

Parameters

[in]

options

options for creating the block

Return values

BlockTemplate	a block template.
std::nullptr	if the node is shut down.

Here is the caller graph for this function:

getTip()

virtual std::optional< BlockRef > interfaces::Mining::getTip ( )

pure virtual

Returns the hash and height for the tip of this chain.

Here is the caller graph for this function:

isInitialBlockDownload()

virtual bool interfaces::Mining::isInitialBlockDownload ( )

pure virtual

Returns whether IBD is still in progress.

Here is the caller graph for this function:

isTestChain()

virtual bool interfaces::Mining::isTestChain ( )

pure virtual

If this chain is exclusively used for testing.

Here is the caller graph for this function:

waitTipChanged()

virtual std::optional< BlockRef > interfaces::Mining::waitTipChanged ( uint256  current_tip, MillisecondsDouble  timeout = MillisecondsDouble::max()  )

pure virtual

Waits for the connected tip to change.

During node initialization, this will wait until the tip is connected (regardless of timeout).

Parameters

[in]	current_tip	block hash of the current chain tip. Function waits for the chain tip to differ from this.
[in]	timeout	how long to wait for a new tip (default is forever)

Return values

BlockRef	hash and height of the current chain tip after this call.
std::nullopt	if the node is shut down.

Here is the caller graph for this function:

---

The documentation for this class was generated from the following file:

• src/interfaces/mining.h