interfaces::BlockTemplate Class Reference

Block template interface. More...

#include <mining.h>

Public Member Functions
virtual	~BlockTemplate ()=default
virtual CBlockHeader	getBlockHeader ()=0
virtual CBlock	getBlock ()=0
virtual std::vector< CAmount >	getTxFees ()=0
virtual std::vector< int64_t >	getTxSigops ()=0
virtual CTransactionRef	getCoinbaseTx ()=0
virtual std::vector< unsigned char >	getCoinbaseCommitment ()=0
virtual int	getWitnessCommitmentIndex ()=0
virtual std::vector< uint256 >	getCoinbaseMerklePath ()=0
	Compute merkle path to the coinbase transaction. More...
virtual bool	submitSolution (uint32_t version, uint32_t timestamp, uint32_t nonce, CTransactionRef coinbase)=0
	Construct and broadcast the block. More...
virtual std::unique_ptr< BlockTemplate >	waitNext (const node::BlockWaitOptions options={})=0
	Waits for fees in the next block to rise, a new tip or the timeout. More...
virtual void	interruptWait ()=0
	Interrupts the current wait for the next block template. More...

Detailed Description

Block template interface.

Definition at line 31 of file mining.h.

Constructor & Destructor Documentation

~BlockTemplate()

virtual interfaces::BlockTemplate::~BlockTemplate ( )

virtualdefault

Member Function Documentation

getBlock()

virtual CBlock interfaces::BlockTemplate::getBlock ( )

pure virtual

getBlockHeader()

virtual CBlockHeader interfaces::BlockTemplate::getBlockHeader ( )

pure virtual

getCoinbaseCommitment()

virtual std::vector< unsigned char > interfaces::BlockTemplate::getCoinbaseCommitment ( )

pure virtual

getCoinbaseMerklePath()

virtual std::vector< uint256 > interfaces::BlockTemplate::getCoinbaseMerklePath ( )

pure virtual

Compute merkle path to the coinbase transaction.

Returns

merkle path ordered from the deepest

getCoinbaseTx()

virtual CTransactionRef interfaces::BlockTemplate::getCoinbaseTx ( )

pure virtual

getTxFees()

virtual std::vector< CAmount > interfaces::BlockTemplate::getTxFees ( )

pure virtual

getTxSigops()

virtual std::vector< int64_t > interfaces::BlockTemplate::getTxSigops ( )

pure virtual

getWitnessCommitmentIndex()

virtual int interfaces::BlockTemplate::getWitnessCommitmentIndex ( )

pure virtual

interruptWait()

virtual void interfaces::BlockTemplate::interruptWait ( )

pure virtual

Interrupts the current wait for the next block template.

submitSolution()

virtual bool interfaces::BlockTemplate::submitSolution ( uint32_t  version, uint32_t  timestamp, uint32_t  nonce, CTransactionRef  coinbase  )

pure virtual

Construct and broadcast the block.

Modifies the template in place, updating the fields listed below as well as the merkle root.

Parameters

[in]	version	version block header field
[in]	timestamp	time block header field (unix timestamp)
[in]	nonce	nonce block header field
[in]	coinbase	complete coinbase transaction (including witness)

Note

unlike the submitblock RPC, this method does NOT add the coinbase witness automatically.

Returns

if the block was processed, does not necessarily indicate validity.

Note

Returns true if the block is already known, which can happen if the solved block is constructed and broadcast by multiple nodes (e.g. both the miner who constructed the template and the pool).

waitNext()

virtual std::unique_ptr< BlockTemplate > interfaces::BlockTemplate::waitNext ( const node::BlockWaitOptions  options = {} )

pure virtual

Waits for fees in the next block to rise, a new tip or the timeout.

Parameters

[in]

options

Control the timeout (default forever) and by how much total fees for the next block should rise (default infinite).

Returns

a new BlockTemplate or nothing if the timeout occurs.

On testnet this will additionally return a template with difficulty 1 if the tip is more than 20 minutes old.

---

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

• src/interfaces/mining.h