CChainState stores and provides an API to update our local knowledge of the current best chain. More...

#include <validation.h>

Inheritance diagram for CChainState:

Collaboration diagram for CChainState:

Public Member Functions
	CChainState (CTxMemPool *mempool, BlockManager &blockman, ChainstateManager &chainman, std::optional< uint256 > from_snapshot_blockhash=std::nullopt)

void	InitCoinsDB (size_t cache_size_bytes, bool in_memory, bool should_wipe, std::string leveldb_name="chainstate")
	Initialize the CoinsViews UTXO set database management data structures. More...

void InitCoinsCache(size_t cache_size_bytes) EXCLUSIVE_LOCKS_REQUIRED(bool	CanFlushToDisk () const EXCLUSIVE_LOCKS_REQUIRED(cs_main)
	Initialize the in-memory coins cache (to be done after the health of the on-disk database is verified). More...

CCoinsViewCache &	CoinsTip () EXCLUSIVE_LOCKS_REQUIRED(cs_main)

CCoinsViewDB &	CoinsDB () EXCLUSIVE_LOCKS_REQUIRED(cs_main)

CCoinsViewErrorCatcher &	CoinsErrorCatcher () EXCLUSIVE_LOCKS_REQUIRED(cs_main)

void	ResetCoinsViews ()
	Destructs all objects related to accessing the UTXO set. More...

bool ResizeCoinsCaches(size_t coinstip_size, size_t coinsdb_size) EXCLUSIVE_LOCKS_REQUIRED(void	LoadExternalBlockFile (FILE fileIn, FlatFilePos dbp=nullptr)
	Resize the CoinsViews caches dynamically and flush state to disk. More...

bool	FlushStateToDisk (BlockValidationState &state, FlushStateMode mode, int nManualPruneHeight=0)
	Update the on-disk chain state. More...

void	ForceFlushStateToDisk ()
	Unconditionally flush all changes to disk. More...

void	PruneAndFlush ()
	Prune blockfiles from the disk if necessary and then flush chainstate changes if we pruned. More...

bool	ActivateBestChain (BlockValidationState &state, std::shared_ptr< const CBlock > pblock=nullptr) LOCKS_EXCLUDED(cs_main)
	Find the best known block, and make it the tip of the block chain. More...

bool	AcceptBlock (const std::shared_ptr< const CBlock > &pblock, BlockValidationState &state, CBlockIndex *ppindex, bool fRequested, const FlatFilePos dbp, bool *fNewBlock) EXCLUSIVE_LOCKS_REQUIRED(cs_main)
	Store block on disk. More...

DisconnectResult	DisconnectBlock (const CBlock &block, const CBlockIndex *pindex, CCoinsViewCache &view)
	Undo the effects of this block (with given index) on the UTXO set represented by coins. More...

bool	ConnectBlock (const CBlock &block, BlockValidationState &state, CBlockIndex *pindex, CCoinsViewCache &view, bool fJustCheck=false) EXCLUSIVE_LOCKS_REQUIRED(cs_main)
	Apply the effects of this block (with given index) on the UTXO set represented by coins. More...

bool	DisconnectTip (BlockValidationState &state, DisconnectedBlockTransactions *disconnectpool) EXCLUSIVE_LOCKS_REQUIRED(cs_main
	Disconnect m_chain's tip. More...

bool	PreciousBlock (BlockValidationState &state, CBlockIndex *pindex) LOCKS_EXCLUDED(cs_main)
	Mark a block as precious and reorganize. More...

bool	InvalidateBlock (BlockValidationState &state, CBlockIndex *pindex) LOCKS_EXCLUDED(cs_main)
	Mark a block as invalid. More...

void	ResetBlockFailureFlags (CBlockIndex *pindex) EXCLUSIVE_LOCKS_REQUIRED(cs_main)
	Remove invalidity status from a block and its descendants. More...

bool	ReplayBlocks ()
	Replay blocks that aren't fully applied to the database. More...

bool	NeedsRedownload () const EXCLUSIVE_LOCKS_REQUIRED(cs_main)
	Whether the chain state needs to be redownloaded due to lack of witness data. More...

bool	LoadGenesisBlock ()
	Ensures we have a genesis block in the block tree, possibly writing one to disk. More...

void	PruneBlockIndexCandidates ()
	Delete all entries in setBlockIndexCandidates that are worse than the current tip. More...

void UnloadBlockIndex() EXCLUSIVE_LOCKS_REQUIRED(bool	IsInitialBlockDownload () const
	Check whether we are doing an initial block download (synchronizing from disk or network) More...

void	CheckBlockIndex ()
	Make various assertions about the state of the block index. More...

void	LoadMempool (const ArgsManager &args)
	Load the persisted mempool from disk. More...

bool	LoadChainTip () EXCLUSIVE_LOCKS_REQUIRED(cs_main)
	Update the chain tip based on database information, i.e. More...

Public Attributes
BlockManager &	m_blockman
	Reference to a BlockManager instance which itself is shared across all CChainState instances. More...

ChainstateManager &	m_chainman
	The chainstate manager that owns this chainstate. More...

CChain	m_chain
	The current chain of blockheaders we consult and build on. More...

const std::optional< uint256 >	m_from_snapshot_blockhash
	The blockhash which is the base of the snapshot this chainstate was created from. More...

std::set< CBlockIndex *, CBlockIndexWorkComparator >	setBlockIndexCandidates
	The set of all CBlockIndex entries with either BLOCK_VALID_TRANSACTIONS (for itself and all ancestors) or BLOCK_ASSUMED_VALID (if using background chainstates) and as good as our current tip or better. More...

size_t	m_coinsdb_cache_size_bytes {0}
	The cache size of the on-disk coins view. More...

size_t	m_coinstip_cache_size_bytes {0}
	The cache size of the in-memory coins view. More...

bool m_mempool	cs

Protected Member Functions
int32_t nBlockSequenceId	GUARDED_BY (::cs_main)
	Every received block is assigned a unique and increasing identifier, so we know which one to give priority in case of a fork. More...

Protected Attributes
int32_t	nBlockReverseSequenceId = -1
	Decreasing counter (used by subsequent preciousblock calls). More...

arith_uint256	nLastPreciousChainwork = 0
	chainwork for the last block that preciousblock has been applied to. More...

RecursiveMutex	m_cs_chainstate
	the ChainState CriticalSection A lock that must be held when modifying this ChainState - held in ActivateBestChain() More...

std::atomic< bool >	m_cached_finished_ibd {false}
	Whether this chainstate is undergoing initial block download. More...

CTxMemPool *	m_mempool
	Optional mempool that is kept in sync with the chain. More...

const CChainParams &	m_params

std::unique_ptr< CoinsViews >	m_coins_views
	Manages the UTXO set, which is a reflection of the contents of `m_chain`. More...

Private Member Functions
bool	ActivateBestChainStep (BlockValidationState &state, CBlockIndex *pindexMostWork, const std::shared_ptr< const CBlock > &pblock, bool &fInvalidFound, ConnectTrace &connectTrace) EXCLUSIVE_LOCKS_REQUIRED(cs_main
	Dictates whether we need to flush the cache to disk or not. More...

bool	ConnectTip (BlockValidationState &state, CBlockIndex *pindexNew, const std::shared_ptr< const CBlock > &pblock, ConnectTrace &connectTrace, DisconnectedBlockTransactions &disconnectpool) EXCLUSIVE_LOCKS_REQUIRED(cs_main
	Connect a new block to m_chain. More...

void	InvalidBlockFound (CBlockIndex *pindex, const BlockValidationState &state) EXCLUSIVE_LOCKS_REQUIRED(cs_main)

CBlockIndex *	FindMostWorkChain () EXCLUSIVE_LOCKS_REQUIRED(cs_main)
	Return the tip of the chain with the most work in it, that isn't known to be invalid (it's however far from certain to be valid). More...

void	ReceivedBlockTransactions (const CBlock &block, CBlockIndex *pindexNew, const FlatFilePos &pos) EXCLUSIVE_LOCKS_REQUIRED(cs_main)
	Mark a block as having its data received and checked (up to BLOCK_VALID_TRANSACTIONS). More...

bool	RollforwardBlock (const CBlockIndex *pindex, CCoinsViewCache &inputs) EXCLUSIVE_LOCKS_REQUIRED(cs_main)
	Apply the effects of a block on the utxo cache, ignoring that it may already have been applied. More...

void	CheckForkWarningConditions () EXCLUSIVE_LOCKS_REQUIRED(cs_main)

void	InvalidChainFound (CBlockIndex *pindexNew) EXCLUSIVE_LOCKS_REQUIRED(cs_main)

RecursiveMutex *	MempoolMutex () const LOCK_RETURNED(m_mempool -> cs)
	Indirection necessary to make lock annotations work with an optional mempool. More...

void	MaybeUpdateMempoolForReorg (DisconnectedBlockTransactions &disconnectpool, bool fAddToMempool) EXCLUSIVE_LOCKS_REQUIRED(cs_main
	Make mempool consistent after a reorg, by re-adding or recursively erasing disconnected block transactions from the mempool, and also removing any other transactions from the mempool that are no longer valid given the new tip/height. More...

Private Attributes
void m_mempool	cs

void UpdateTip(const CBlockIndex *pindexNew) EXCLUSIVE_LOCKS_REQUIRED(frien	ChainstateManager )
	Check warning conditions and do some notifications on new chain tip set. More...

Detailed Description

CChainState stores and provides an API to update our local knowledge of the current best chain.

Eventually, the API here is targeted at being exposed externally as a consumable libconsensus library, so any functions added must only call other class member functions, pure functions in other parts of the consensus library, callbacks via the validation interface, or read/write-to-disk functions (eventually this will also be via callbacks).

Anything that is contingent on the current tip of the chain is stored here, whereas block information and metadata independent of the current tip is kept in BlockManager.

Definition at line 543 of file validation.h.

Constructor & Destructor Documentation

◆ CChainState()

CChainState::CChainState	(	CTxMemPool *	mempool,
		BlockManager &	blockman,
		ChainstateManager &	chainman,
		std::optional< uint256 >	from_snapshot_blockhash = `std::nullopt`
	)

explicit

Definition at line 1094 of file validation.cpp.

Member Function Documentation

◆ AcceptBlock()

bool CChainState::AcceptBlock	(	const std::shared_ptr< const CBlock > &	pblock,
		BlockValidationState &	state,
		CBlockIndex **	ppindex,
		bool	fRequested,
		const FlatFilePos *	dbp,
		bool *	fNewBlock
	)

Store block on disk.

If dbp is non-nullptr, the file is known to already reside on disk

Definition at line 3305 of file validation.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ ActivateBestChain()

bool CChainState::ActivateBestChain	(	BlockValidationState &	state,
		std::shared_ptr< const CBlock >	pblock = `nullptr`
	)

Find the best known block, and make it the tip of the block chain.

The result is either failure or an activated best chain. pblock is either nullptr or a pointer to a block that is already loaded (to avoid loading it again from disk).

ActivateBestChain is split into steps (see ActivateBestChainStep) so that we avoid holding cs_main for an extended period of time; the length of this call may be quite long during reindexing or a substantial reorg.

May not be called with cs_main held. May not be called in a validationinterface callback.

Returns: true unless a system error occurred

Definition at line 2528 of file validation.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ ActivateBestChainStep()

bool CChainState::ActivateBestChainStep	(	BlockValidationState &	state,
		CBlockIndex *	pindexMostWork,
		const std::shared_ptr< const CBlock > &	pblock,
		bool &	fInvalidFound,
		ConnectTrace &	connectTrace
	)

private

Dictates whether we need to flush the cache to disk or not.

Try to make some progress towards making pindexMostWork the active block.

Returns: the state of the size of the coins cache.

pblock is either nullptr or a pointer to a CBlock corresponding to pindexMostWork.

Returns: true unless a system error occurred

Definition at line 2406 of file validation.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ CanFlushToDisk()

void InitCoinsCache(size_t cache_size_bytes) EXCLUSIVE_LOCKS_REQUIRED(bool CChainState::CanFlushToDisk ( ) const

inline

Initialize the in-memory coins cache (to be done after the health of the on-disk database is verified).

Returns: whether or not the CoinsViews object has been fully initialized and we can safely flush this object to disk.

Definition at line 614 of file validation.h.

Here is the caller graph for this function:

◆ CheckBlockIndex()

void CChainState::CheckBlockIndex ( )

Make various assertions about the state of the block index.

By default this only executes fully when using the Regtest chain; see: fCheckBlockIndex.

Definition at line 4186 of file validation.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ CheckForkWarningConditions()

void CChainState::CheckForkWarningConditions ( )

private

Definition at line 1173 of file validation.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ CoinsDB()

CCoinsViewDB & CChainState::CoinsDB ( )

inline

Returns: A reference to the on-disk UTXO set database.

Definition at line 645 of file validation.h.

Here is the caller graph for this function:

◆ CoinsErrorCatcher()

CCoinsViewErrorCatcher & CChainState::CoinsErrorCatcher ( )

inline

Returns: A reference to a wrapped view of the in-memory UTXO set that handles disk read errors gracefully.

Definition at line 652 of file validation.h.

◆ CoinsTip()

CCoinsViewCache & CChainState::CoinsTip ( )

inline

Returns: A reference to the in-memory cache of the UTXO set.

Definition at line 638 of file validation.h.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ ConnectBlock()

bool CChainState::ConnectBlock	(	const CBlock &	block,
		BlockValidationState &	state,
		CBlockIndex *	pindex,
		CCoinsViewCache &	view,
		bool	fJustCheck = `false`
	)

Apply the effects of this block (with given index) on the UTXO set represented by coins.

Validity checks that depend on the UTXO set are also done; ConnectBlock() can fail if those validity checks fail (among other reasons).

Definition at line 1576 of file validation.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ ConnectTip()

bool CChainState::ConnectTip	(	BlockValidationState &	state,
		CBlockIndex *	pindexNew,
		const std::shared_ptr< const CBlock > &	pblock,
		ConnectTrace &	connectTrace,
		DisconnectedBlockTransactions &	disconnectpool
	)

private

Connect a new block to m_chain.

pblock is either nullptr or a pointer to a CBlock corresponding to pindexNew, to bypass loading it again from disk.

The block is added to connectTrace if connection succeeds.

Definition at line 2266 of file validation.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ DisconnectBlock()

DisconnectResult CChainState::DisconnectBlock	(	const CBlock &	block,
		const CBlockIndex *	pindex,
		CCoinsViewCache &	view
	)

Undo the effects of this block (with given index) on the UTXO set represented by coins.

When FAILED is returned, view is left in an indeterminate state.

Definition at line 1422 of file validation.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ DisconnectTip()

bool CChainState::DisconnectTip	(	BlockValidationState &	state,
		DisconnectedBlockTransactions *	disconnectpool
	)

Disconnect m_chain's tip.

After calling, the mempool will be in an inconsistent state, with transactions from disconnected blocks being added to disconnectpool. You should make the mempool consistent again by calling MaybeUpdateMempoolForReorg. with cs_main held.

If disconnectpool is nullptr, then no disconnected transactions are added to disconnectpool (note that the caller is responsible for mempool consistency in any case).

Definition at line 2163 of file validation.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ FindMostWorkChain()

CBlockIndex * CChainState::FindMostWorkChain ( )

private

Return the tip of the chain with the most work in it, that isn't known to be invalid (it's however far from certain to be valid).

Definition at line 2333 of file validation.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ FlushStateToDisk()

bool CChainState::FlushStateToDisk	(	BlockValidationState &	state,
		FlushStateMode	mode,
		int	nManualPruneHeight = `0`
	)

Update the on-disk chain state.

The caches and indexes are flushed depending on the mode we're called with if they're too large, if it's been a while since the last write, or always and in all cases if we're in prune mode and are deleting files.

If FlushStateMode::NONE is used, then FlushStateToDisk(...) won't do anything besides checking if we need to prune.

Returns: true unless a system error occurred

Definition at line 1916 of file validation.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ ForceFlushStateToDisk()

void CChainState::ForceFlushStateToDisk ( )

Unconditionally flush all changes to disk.

Definition at line 2053 of file validation.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GUARDED_BY()

int32_t nBlockSequenceId CChainState::GUARDED_BY ( ::cs_main )

protected

Every received block is assigned a unique and increasing identifier, so we know which one to give priority in case of a fork.

Blocks loaded from disk are assigned id 0, so start the counter at 1.

◆ InitCoinsDB()

void CChainState::InitCoinsDB	(	size_t	cache_size_bytes,
		bool	in_memory,
		bool	should_wipe,
		std::string	leveldb_name = `"chainstate"`
	)

Initialize the CoinsViews UTXO set database management data structures.

The in-memory cache is initialized separately.

All parameters forwarded to CoinsViews.

Definition at line 1105 of file validation.cpp.

Here is the caller graph for this function:

◆ InvalidateBlock()

bool CChainState::InvalidateBlock	(	BlockValidationState &	state,
		CBlockIndex *	pindex
	)

Mark a block as invalid.

Definition at line 2657 of file validation.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ InvalidBlockFound()

void CChainState::InvalidBlockFound	(	CBlockIndex *	pindex,
		const BlockValidationState &	state
	)

private

Definition at line 1213 of file validation.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ InvalidChainFound()

void CChainState::InvalidChainFound ( CBlockIndex * pindexNew )

private

Definition at line 1192 of file validation.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ IsInitialBlockDownload()

bool CChainState::IsInitialBlockDownload ( ) const

Check whether we are doing an initial block download (synchronizing from disk or network)

Definition at line 1131 of file validation.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ LoadChainTip()

bool CChainState::LoadChainTip ( )

Update the chain tip based on database information, i.e.

CoinsTip()'s best block.

Definition at line 3740 of file validation.cpp.

Here is the call graph for this function:

◆ LoadExternalBlockFile()

void CChainState::LoadExternalBlockFile	(	FILE *	fileIn,
		FlatFilePos *	dbp = `nullptr`
	)

Resize the CoinsViews caches dynamically and flush state to disk.

Returns: true unless an error occurred during the flush. Import blocks from an external file

Definition at line 4068 of file validation.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ LoadGenesisBlock()

bool CChainState::LoadGenesisBlock ( )

Ensures we have a genesis block in the block tree, possibly writing one to disk.

Definition at line 4043 of file validation.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ LoadMempool()

void CChainState::LoadMempool ( const ArgsManager & args )

Load the persisted mempool from disk.

Definition at line 3731 of file validation.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ MaybeUpdateMempoolForReorg()

void CChainState::MaybeUpdateMempoolForReorg	(	DisconnectedBlockTransactions &	disconnectpool,
		bool	fAddToMempool
	)

private

Make mempool consistent after a reorg, by re-adding or recursively erasing disconnected block transactions from the mempool, and also removing any other transactions from the mempool that are no longer valid given the new tip/height.

Note: we assume that disconnectpool only contains transactions that are NOT confirmed in the current chain nor already in the mempool (otherwise, in-mempool descendants of such transactions would be removed).

Passing fAddToMempool=false will skip trying to add the transactions back, and instead just erase from the mempool as needed.

Definition at line 333 of file validation.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ MempoolMutex()

RecursiveMutex * CChainState::MempoolMutex ( ) const -> cs)

inlineprivate

Indirection necessary to make lock annotations work with an optional mempool.

Definition at line 790 of file validation.h.

Here is the caller graph for this function:

◆ NeedsRedownload()

bool CChainState::NeedsRedownload ( ) const

Whether the chain state needs to be redownloaded due to lack of witness data.

Definition at line 3976 of file validation.cpp.

Here is the call graph for this function:

◆ PreciousBlock()

bool CChainState::PreciousBlock	(	BlockValidationState &	state,
		CBlockIndex *	pindex
	)

Mark a block as precious and reorganize.

May not be called in a validationinterface callback.

Definition at line 2628 of file validation.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ PruneAndFlush()

void CChainState::PruneAndFlush ( )

Prune blockfiles from the disk if necessary and then flush chainstate changes if we pruned.

Definition at line 2061 of file validation.cpp.

Here is the call graph for this function:

◆ PruneBlockIndexCandidates()

void CChainState::PruneBlockIndexCandidates ( )

Delete all entries in setBlockIndexCandidates that are worse than the current tip.

Definition at line 2389 of file validation.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ ReceivedBlockTransactions()

void CChainState::ReceivedBlockTransactions	(	const CBlock &	block,
		CBlockIndex *	pindexNew,
		const FlatFilePos &	pos
	)

private

Mark a block as having its data received and checked (up to BLOCK_VALID_TRANSACTIONS).

Definition at line 2870 of file validation.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ ReplayBlocks()

bool CChainState::ReplayBlocks ( )

Replay blocks that aren't fully applied to the database.

Definition at line 3909 of file validation.cpp.

Here is the call graph for this function:

◆ ResetBlockFailureFlags()

void CChainState::ResetBlockFailureFlags ( CBlockIndex * pindex )

Remove invalidity status from a block and its descendants.

Definition at line 2799 of file validation.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ ResetCoinsViews()

void CChainState::ResetCoinsViews ( )

inline

Destructs all objects related to accessing the UTXO set.

Definition at line 658 of file validation.h.

◆ RollforwardBlock()

bool CChainState::RollforwardBlock	(	const CBlockIndex *	pindex,
		CCoinsViewCache &	inputs
	)

private

Apply the effects of a block on the utxo cache, ignoring that it may already have been applied.

Definition at line 3889 of file validation.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

Member Data Documentation

◆ ChainstateManager

void UpdateTip (const CBlockIndex* pindexNew) EXCLUSIVE_LOCKS_REQUIRED( frien CChainState::ChainstateManager)

private

Check warning conditions and do some notifications on new chain tip set.

Definition at line 816 of file validation.h.

◆ cs [1/2]

bool m_mempool CChainState::cs

Definition at line 724 of file validation.h.

◆ cs [2/2]

void m_mempool CChainState::cs

private

Definition at line 810 of file validation.h.

◆ m_blockman

BlockManager& CChainState::m_blockman

Reference to a BlockManager instance which itself is shared across all CChainState instances.

Definition at line 583 of file validation.h.

◆ m_cached_finished_ibd

std::atomic<bool> CChainState::m_cached_finished_ibd {false}

mutableprotected

Whether this chainstate is undergoing initial block download.

Mutable because we need to be able to mark IsInitialBlockDownload() const, which latches this for caching purposes.

Definition at line 569 of file validation.h.

◆ m_chain

CChain CChainState::m_chain

The current chain of blockheaders we consult and build on.

See also: CChain, CBlockIndex.

Definition at line 620 of file validation.h.

◆ m_chainman

ChainstateManager& CChainState::m_chainman

The chainstate manager that owns this chainstate.

The reference is necessary so that this instance can check whether it is the active chainstate within deeply nested method calls.

Definition at line 588 of file validation.h.

◆ m_coins_views

std::unique_ptr<CoinsViews> CChainState::m_coins_views

protected

Manages the UTXO set, which is a reflection of the contents of m_chain.

Definition at line 578 of file validation.h.

◆ m_coinsdb_cache_size_bytes

size_t CChainState::m_coinsdb_cache_size_bytes {0}

The cache size of the on-disk coins view.

Definition at line 661 of file validation.h.

◆ m_coinstip_cache_size_bytes

size_t CChainState::m_coinstip_cache_size_bytes {0}

The cache size of the in-memory coins view.

Definition at line 664 of file validation.h.

◆ m_cs_chainstate

RecursiveMutex CChainState::m_cs_chainstate

protected

the ChainState CriticalSection A lock that must be held when modifying this ChainState - held in ActivateBestChain()

Definition at line 561 of file validation.h.

◆ m_from_snapshot_blockhash

const std::optional<uint256> CChainState::m_from_snapshot_blockhash

The blockhash which is the base of the snapshot this chainstate was created from.

std::nullopt if this chainstate was not created from a snapshot.

Definition at line 627 of file validation.h.

◆ m_mempool

CTxMemPool* CChainState::m_mempool

protected

Optional mempool that is kept in sync with the chain.

Only the active chainstate has a mempool.

Definition at line 573 of file validation.h.

◆ m_params

const CChainParams& CChainState::m_params

protected

Definition at line 575 of file validation.h.

◆ nBlockReverseSequenceId

int32_t CChainState::nBlockReverseSequenceId = -1

protected

Decreasing counter (used by subsequent preciousblock calls).

Definition at line 553 of file validation.h.

◆ nLastPreciousChainwork

arith_uint256 CChainState::nLastPreciousChainwork = 0

protected

chainwork for the last block that preciousblock has been applied to.

Definition at line 555 of file validation.h.

◆ setBlockIndexCandidates

std::set<CBlockIndex*, CBlockIndexWorkComparator> CChainState::setBlockIndexCandidates

The set of all CBlockIndex entries with either BLOCK_VALID_TRANSACTIONS (for itself and all ancestors) or BLOCK_ASSUMED_VALID (if using background chainstates) and as good as our current tip or better.

Entries may be failed, though, and pruning nodes may be missing the data for the block.

Definition at line 635 of file validation.h.

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

src/validation.h
src/validation.cpp

Public Member Functions

Public Attributes

Protected Member Functions

Protected Attributes

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ CChainState()

Member Function Documentation

◆ AcceptBlock()

◆ ActivateBestChain()

◆ ActivateBestChainStep()

◆ CanFlushToDisk()

◆ CheckBlockIndex()

◆ CheckForkWarningConditions()

◆ CoinsDB()

◆ CoinsErrorCatcher()

◆ CoinsTip()

◆ ConnectBlock()

◆ ConnectTip()

◆ DisconnectBlock()

◆ DisconnectTip()

◆ FindMostWorkChain()

◆ FlushStateToDisk()

◆ ForceFlushStateToDisk()

◆ GUARDED_BY()

◆ InitCoinsDB()

◆ InvalidateBlock()

◆ InvalidBlockFound()

◆ InvalidChainFound()

◆ IsInitialBlockDownload()

◆ LoadChainTip()

◆ LoadExternalBlockFile()

◆ LoadGenesisBlock()

◆ LoadMempool()

◆ MaybeUpdateMempoolForReorg()

◆ MempoolMutex()

◆ NeedsRedownload()

◆ PreciousBlock()

◆ PruneAndFlush()

◆ PruneBlockIndexCandidates()

◆ ReceivedBlockTransactions()

◆ ReplayBlocks()

◆ ResetBlockFailureFlags()

◆ ResetCoinsViews()

◆ RollforwardBlock()

Member Data Documentation

◆ ChainstateManager

◆ cs [1/2]

◆ cs [2/2]

◆ m_blockman

◆ m_cached_finished_ibd

◆ m_chain

◆ m_chainman

◆ m_coins_views

◆ m_coinsdb_cache_size_bytes

◆ m_coinstip_cache_size_bytes

◆ m_cs_chainstate

◆ m_from_snapshot_blockhash

◆ m_mempool

◆ m_params

◆ nBlockReverseSequenceId

◆ nLastPreciousChainwork

◆ setBlockIndexCandidates