#include <rpc/blockchain.h>
#include <amount.h>
#include <blockdb.h>
#include <blockfilter.h>
#include <chain.h>
#include <chainparams.h>
#include <checkpoints.h>
#include <coins.h>
#include <config.h>
#include <consensus/validation.h>
#include <core_io.h>
#include <hash.h>
#include <index/blockfilterindex.h>
#include <network.h>
#include <node/coinstats.h>
#include <node/context.h>
#include <node/utxo_snapshot.h>
#include <policy/policy.h>
#include <primitives/transaction.h>
#include <rpc/server.h>
#include <rpc/util.h>
#include <script/descriptor.h>
#include <streams.h>
#include <txdb.h>
#include <txmempool.h>
#include <undo.h>
#include <util/ref.h>
#include <util/strencodings.h>
#include <util/system.h>
#include <validation.h>
#include <validationinterface.h>
#include <versionbitsinfo.h>
#include <warnings.h>
#include <condition_variable>
#include <cstdint>
#include <memory>
#include <mutex>

Include dependency graph for blockchain.cpp:

Classes
struct	CUpdatedBlock

struct	CompareBlocksByHeight
	Comparison function for sorting the getchaintips heads. More...

class	CoinsViewScanReserver

Functions
static CUpdatedBlock latestblock	GUARDED_BY (cs_blockchange)

NodeContext &	EnsureNodeContext (const util::Ref &context)

CTxMemPool &	EnsureMemPool (const util::Ref &context)

ChainstateManager &	EnsureChainman (const util::Ref &context)

double	GetDifficulty (const CBlockIndex *blockindex)
	Calculate the difficulty for a given block index. More...

static int	ComputeNextBlockAndDepth (const CBlockIndex tip, const CBlockIndex blockindex, const CBlockIndex *&next)

UniValue	blockheaderToJSON (const CBlockIndex tip, const CBlockIndex blockindex)
	Block header to JSON. More...

UniValue	blockToJSON (const CBlock &block, const CBlockIndex tip, const CBlockIndex blockindex, bool txDetails)
	Block description to JSON. More...

static UniValue	getblockcount (const Config &config, const JSONRPCRequest &request)

static UniValue	getbestblockhash (const Config &config, const JSONRPCRequest &request)

UniValue	getfinalizedblockhash (const Config &config, const JSONRPCRequest &request)

void	RPCNotifyBlockChange (const CBlockIndex *pindex)
	Callback for when block tip changed. More...

static UniValue	waitfornewblock (const Config &config, const JSONRPCRequest &request)

static UniValue	waitforblock (const Config &config, const JSONRPCRequest &request)

static UniValue	waitforblockheight (const Config &config, const JSONRPCRequest &request)

static UniValue	syncwithvalidationinterfacequeue (const Config &config, const JSONRPCRequest &request)

static UniValue	getdifficulty (const Config &config, const JSONRPCRequest &request)

static std::vector< RPCResult >	MempoolEntryDescription ()

static void	entryToJSON (const CTxMemPool &pool, UniValue &info, const CTxMemPoolEntry &e) EXCLUSIVE_LOCKS_REQUIRED(pool.cs)

UniValue	MempoolToJSON (const CTxMemPool &pool, bool verbose)
	Mempool to JSON. More...

static UniValue	getrawmempool (const Config &config, const JSONRPCRequest &request)

static UniValue	getmempoolancestors (const Config &config, const JSONRPCRequest &request)

static UniValue	getmempooldescendants (const Config &config, const JSONRPCRequest &request)

static UniValue	getmempoolentry (const Config &config, const JSONRPCRequest &request)

static UniValue	getblockhash (const Config &config, const JSONRPCRequest &request)

static UniValue	getblockheader (const Config &config, const JSONRPCRequest &request)

static CBlock	GetBlockChecked (const Config &config, const CBlockIndex *pblockindex)

static CBlockUndo	GetUndoChecked (const CBlockIndex *pblockindex)

static UniValue	getblock (const Config &config, const JSONRPCRequest &request)

static UniValue	pruneblockchain (const Config &config, const JSONRPCRequest &request)

static UniValue	gettxoutsetinfo (const Config &config, const JSONRPCRequest &request)

UniValue	gettxout (const Config &config, const JSONRPCRequest &request)

static UniValue	verifychain (const Config &config, const JSONRPCRequest &request)

static void	BIP9SoftForkDescPushBack (UniValue &softforks, const Consensus::Params &consensusParams, Consensus::DeploymentPos id) EXCLUSIVE_LOCKS_REQUIRED(cs_main)

UniValue	getblockchaininfo (const Config &config, const JSONRPCRequest &request)

static UniValue	getchaintips (const Config &config, const JSONRPCRequest &request)

UniValue	MempoolInfoToJSON (const CTxMemPool &pool)
	Mempool information to JSON. More...

static UniValue	getmempoolinfo (const Config &config, const JSONRPCRequest &request)

static UniValue	preciousblock (const Config &config, const JSONRPCRequest &request)

UniValue	finalizeblock (const Config &config, const JSONRPCRequest &request)

static UniValue	invalidateblock (const Config &config, const JSONRPCRequest &request)

UniValue	parkblock (const Config &config, const JSONRPCRequest &request)

static UniValue	reconsiderblock (const Config &config, const JSONRPCRequest &request)

UniValue	unparkblock (const Config &config, const JSONRPCRequest &request)

static UniValue	getchaintxstats (const Config &config, const JSONRPCRequest &request)

template<typename T >
static T	CalculateTruncatedMedian (std::vector< T > &scores)

template<typename T >
static bool	SetHasKeys (const std::set< T > &set)

template<typename T , typename Tk , typename... Args>
static bool	SetHasKeys (const std::set< T > &set, const Tk &key, const Args &... args)

static UniValue	getblockstats (const Config &config, const JSONRPCRequest &request)

static UniValue	savemempool (const Config &config, const JSONRPCRequest &request)

static UniValue	scantxoutset (const Config &config, const JSONRPCRequest &request)

static UniValue	getblockfilter (const Config &config, const JSONRPCRequest &request)

static UniValue	dumptxoutset (const Config &config, const JSONRPCRequest &request)
	Serialize the UTXO set to a file for loading elsewhere. More...

void	RegisterBlockchainRPCCommands (CRPCTable &t)
	Register block chain RPC commands. More...

Variables
static Mutex	cs_blockchange

static std::condition_variable	cond_blockchange

static constexpr size_t	PER_UTXO_OVERHEAD

static std::atomic< int >	g_scan_progress
	RAII object to prevent concurrency issue when scanning the txout set. More...

static std::atomic< bool >	g_scan_in_progress

static std::atomic< bool >	g_should_abort_scan

Function Documentation

◆ BIP9SoftForkDescPushBack()

static void BIP9SoftForkDescPushBack	(	UniValue &	softforks,
		const Consensus::Params &	consensusParams,
		Consensus::DeploymentPos	id
	)

static

Definition at line 1357 of file blockchain.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ blockheaderToJSON()

UniValue blockheaderToJSON	(	const CBlockIndex *	tip,
		const CBlockIndex *	blockindex
	)

Block header to JSON.

Definition at line 111 of file blockchain.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ blockToJSON()

UniValue blockToJSON	(	const CBlock &	block,
		const CBlockIndex *	tip,
		const CBlockIndex *	blockindex,
		bool	txDetails
	)

Block description to JSON.

Definition at line 145 of file blockchain.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ CalculateTruncatedMedian()

template<typename T >

static T CalculateTruncatedMedian ( std::vector< T > & scores )

static

Definition at line 2119 of file blockchain.cpp.

Here is the caller graph for this function:

◆ ComputeNextBlockAndDepth()

static int ComputeNextBlockAndDepth	(	const CBlockIndex *	tip,
		const CBlockIndex *	blockindex,
		const CBlockIndex *&	next
	)

static

Definition at line 100 of file blockchain.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ dumptxoutset()

static UniValue dumptxoutset	(	const Config &	config,
		const JSONRPCRequest &	request
	)

static

Serialize the UTXO set to a file for loading elsewhere.

See also: SnapshotMetadata

Definition at line 2829 of file blockchain.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ EnsureChainman()

ChainstateManager& EnsureChainman ( const util::Ref & context )

Definition at line 71 of file blockchain.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ EnsureMemPool()

CTxMemPool& EnsureMemPool ( const util::Ref & context )

Definition at line 62 of file blockchain.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ EnsureNodeContext()

NodeContext& EnsureNodeContext ( const util::Ref & context )

Definition at line 55 of file blockchain.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ entryToJSON()

static void entryToJSON	(	const CTxMemPool &	pool,
		UniValue &	info,
		const CTxMemPoolEntry &	e
	)

static

Definition at line 532 of file blockchain.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ finalizeblock()

UniValue finalizeblock	(	const Config &	config,
		const JSONRPCRequest &	request
	)

Definition at line 1813 of file blockchain.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getbestblockhash()

static UniValue getbestblockhash	(	const Config &	config,
		const JSONRPCRequest &	request
	)

static

Definition at line 208 of file blockchain.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getblock()

static UniValue getblock	(	const Config &	config,
		const JSONRPCRequest &	request
	)

static

Definition at line 975 of file blockchain.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getblockchaininfo()

UniValue getblockchaininfo	(	const Config &	config,
		const JSONRPCRequest &	request
	)

Definition at line 1419 of file blockchain.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GetBlockChecked()

static CBlock GetBlockChecked	(	const Config &	config,
		const CBlockIndex *	pblockindex
	)

static

Definition at line 942 of file blockchain.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getblockcount()

static UniValue getblockcount	(	const Config &	config,
		const JSONRPCRequest &	request
	)

static

Definition at line 191 of file blockchain.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getblockfilter()

static UniValue getblockfilter	(	const Config &	config,
		const JSONRPCRequest &	request
	)

static

Definition at line 2735 of file blockchain.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getblockhash()

static UniValue getblockhash	(	const Config &	config,
		const JSONRPCRequest &	request
	)

static

Definition at line 825 of file blockchain.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getblockheader()

static UniValue getblockheader	(	const Config &	config,
		const JSONRPCRequest &	request
	)

static

Definition at line 851 of file blockchain.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getblockstats()

static UniValue getblockstats	(	const Config &	config,
		const JSONRPCRequest &	request
	)

static

Definition at line 2146 of file blockchain.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getchaintips()

static UniValue getchaintips	(	const Config &	config,
		const JSONRPCRequest &	request
	)

static

Idea: the set of chain tips is ChainActive().tip, plus orphan blocks which do not have another orphan building off of them. Algorithm:

Make one pass through BlockIndex(), picking out the orphan blocks, and also storing a set of the orphan block's pprev pointers.
Iterate through the orphan blocks. If the block isn't pointed to by another orphan, it is a chain tip.
add ChainActive().Tip()

Definition at line 1596 of file blockchain.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getchaintxstats()

static UniValue getchaintxstats	(	const Config &	config,
		const JSONRPCRequest &	request
	)

static

Definition at line 2014 of file blockchain.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GetDifficulty()

double GetDifficulty ( const CBlockIndex * blockindex )

Calculate the difficulty for a given block index.

Get the required difficulty of the next block w/r/t the given block index.

Definition at line 82 of file blockchain.cpp.

Here is the caller graph for this function:

◆ getdifficulty()

static UniValue getdifficulty	(	const Config &	config,
		const JSONRPCRequest &	request
	)

static

Definition at line 445 of file blockchain.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getfinalizedblockhash()

UniValue getfinalizedblockhash	(	const Config &	config,
		const JSONRPCRequest &	request
	)

Definition at line 225 of file blockchain.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getmempoolancestors()

static UniValue getmempoolancestors	(	const Config &	config,
		const JSONRPCRequest &	request
	)

static

Definition at line 650 of file blockchain.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getmempooldescendants()

static UniValue getmempooldescendants	(	const Config &	config,
		const JSONRPCRequest &	request
	)

static

Definition at line 719 of file blockchain.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getmempoolentry()

static UniValue getmempoolentry	(	const Config &	config,
		const JSONRPCRequest &	request
	)

static

Definition at line 793 of file blockchain.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getmempoolinfo()

static UniValue getmempoolinfo	(	const Config &	config,
		const JSONRPCRequest &	request
	)

static

Definition at line 1736 of file blockchain.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getrawmempool()

static UniValue getrawmempool	(	const Config &	config,
		const JSONRPCRequest &	request
	)

static

Definition at line 608 of file blockchain.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ gettxout()

UniValue gettxout	(	const Config &	config,
		const JSONRPCRequest &	request
	)

Definition at line 1232 of file blockchain.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ gettxoutsetinfo()

static UniValue gettxoutsetinfo	(	const Config &	config,
		const JSONRPCRequest &	request
	)

static

Definition at line 1176 of file blockchain.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GetUndoChecked()

static CBlockUndo GetUndoChecked ( const CBlockIndex * pblockindex )

static

Definition at line 961 of file blockchain.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GUARDED_BY()

static CUpdatedBlock latestblock GUARDED_BY ( cs_blockchange )

static

◆ invalidateblock()

static UniValue invalidateblock	(	const Config &	config,
		const JSONRPCRequest &	request
	)

static

Definition at line 1856 of file blockchain.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ MempoolEntryDescription()

static std::vector<RPCResult> MempoolEntryDescription ( )

static

Definition at line 464 of file blockchain.cpp.

Here is the caller graph for this function:

◆ MempoolInfoToJSON()

UniValue MempoolInfoToJSON ( const CTxMemPool & pool )

Mempool information to JSON.

Definition at line 1716 of file blockchain.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ MempoolToJSON()

UniValue MempoolToJSON	(	const CTxMemPool &	pool,
		bool	verbose
	)

Mempool to JSON.

Definition at line 581 of file blockchain.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ parkblock()

UniValue parkblock	(	const Config &	config,
		const JSONRPCRequest &	request
	)

Definition at line 1896 of file blockchain.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ preciousblock()

static UniValue preciousblock	(	const Config &	config,
		const JSONRPCRequest &	request
	)

static

Definition at line 1773 of file blockchain.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ pruneblockchain()

static UniValue pruneblockchain	(	const Config &	config,
		const JSONRPCRequest &	request
	)

static

Definition at line 1104 of file blockchain.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ reconsiderblock()

static UniValue reconsiderblock	(	const Config &	config,
		const JSONRPCRequest &	request
	)

static

Definition at line 1935 of file blockchain.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ RegisterBlockchainRPCCommands()

void RegisterBlockchainRPCCommands ( CRPCTable & t )

Register block chain RPC commands.

Definition at line 2939 of file blockchain.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ RPCNotifyBlockChange()

void RPCNotifyBlockChange ( const CBlockIndex * pindex )

Callback for when block tip changed.

Definition at line 246 of file blockchain.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ savemempool()

static UniValue savemempool	(	const Config &	config,
		const JSONRPCRequest &	request
	)

static

Definition at line 2433 of file blockchain.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ scantxoutset()

static UniValue scantxoutset	(	const Config &	config,
		const JSONRPCRequest &	request
	)

static

Definition at line 2525 of file blockchain.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ SetHasKeys() [1/2]

template<typename T >

static bool SetHasKeys ( const std::set< T > & set )

inlinestatic

Definition at line 2133 of file blockchain.cpp.

Here is the caller graph for this function:

◆ SetHasKeys() [2/2]

template<typename T , typename Tk , typename... Args>

static bool SetHasKeys	(	const std::set< T > &	set,
		const Tk &	key,
		const Args &...	args
	)

inlinestatic

Definition at line 2137 of file blockchain.cpp.

Here is the call graph for this function:

◆ syncwithvalidationinterfacequeue()

static UniValue syncwithvalidationinterfacequeue	(	const Config &	config,
		const JSONRPCRequest &	request
	)

static

Definition at line 428 of file blockchain.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ unparkblock()

UniValue unparkblock	(	const Config &	config,
		const JSONRPCRequest &	request
	)

Definition at line 1974 of file blockchain.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ verifychain()

static UniValue verifychain	(	const Config &	config,
		const JSONRPCRequest &	request
	)

static

Definition at line 1325 of file blockchain.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ waitforblock()

static UniValue waitforblock	(	const Config &	config,
		const JSONRPCRequest &	request
	)

static

Definition at line 309 of file blockchain.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ waitforblockheight()

static UniValue waitforblockheight	(	const Config &	config,
		const JSONRPCRequest &	request
	)

static

Definition at line 370 of file blockchain.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ waitfornewblock()

static UniValue waitfornewblock	(	const Config &	config,
		const JSONRPCRequest &	request
	)

static

Definition at line 255 of file blockchain.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

Variable Documentation

◆ cond_blockchange

std::condition_variable cond_blockchange

static

Definition at line 52 of file blockchain.cpp.

◆ cs_blockchange

Mutex cs_blockchange

static

Definition at line 51 of file blockchain.cpp.

◆ g_scan_in_progress

std::atomic<bool> g_scan_in_progress

static

Definition at line 2500 of file blockchain.cpp.

◆ g_scan_progress

std::atomic<int> g_scan_progress

static

RAII object to prevent concurrency issue when scanning the txout set.

Definition at line 2499 of file blockchain.cpp.

◆ g_should_abort_scan

std::atomic<bool> g_should_abort_scan

static

Definition at line 2501 of file blockchain.cpp.

◆ PER_UTXO_OVERHEAD

constexpr size_t PER_UTXO_OVERHEAD

static

Initial value:

=

sizeof(COutPoint) + sizeof(uint32_t) + sizeof(bool)

COutPoint

An outpoint - a combination of a transaction hash and an index n into its vout.

Definition: transaction.h:22

Definition at line 2143 of file blockchain.cpp.

Classes

Functions

Variables

Function Documentation

◆ BIP9SoftForkDescPushBack()

◆ blockheaderToJSON()

◆ blockToJSON()

◆ CalculateTruncatedMedian()

◆ ComputeNextBlockAndDepth()

◆ dumptxoutset()

◆ EnsureChainman()

◆ EnsureMemPool()

◆ EnsureNodeContext()

◆ entryToJSON()

◆ finalizeblock()

◆ getbestblockhash()

◆ getblock()

◆ getblockchaininfo()

◆ GetBlockChecked()

◆ getblockcount()

◆ getblockfilter()

◆ getblockhash()

◆ getblockheader()

◆ getblockstats()

◆ getchaintips()

◆ getchaintxstats()

◆ GetDifficulty()

◆ getdifficulty()

◆ getfinalizedblockhash()

◆ getmempoolancestors()

◆ getmempooldescendants()

◆ getmempoolentry()

◆ getmempoolinfo()

◆ getrawmempool()

◆ gettxout()

◆ gettxoutsetinfo()

◆ GetUndoChecked()

◆ GUARDED_BY()

◆ invalidateblock()

◆ MempoolEntryDescription()

◆ MempoolInfoToJSON()

◆ MempoolToJSON()

◆ parkblock()

◆ preciousblock()

◆ pruneblockchain()

◆ reconsiderblock()

◆ RegisterBlockchainRPCCommands()

◆ RPCNotifyBlockChange()

◆ savemempool()

◆ scantxoutset()

◆ SetHasKeys() [1/2]

◆ SetHasKeys() [2/2]

◆ syncwithvalidationinterfacequeue()

◆ unparkblock()

◆ verifychain()

◆ waitforblock()

◆ waitforblockheight()

◆ waitfornewblock()

Variable Documentation

◆ cond_blockchange

◆ cs_blockchange

◆ g_scan_in_progress

◆ g_scan_progress

◆ g_should_abort_scan

◆ PER_UTXO_OVERHEAD