The block chain is a tree shaped structure starting with the genesis block at the root, with each block potentially having multiple candidates to be the next block. More...

#include <chain.h>

Inheritance diagram for CBlockIndex:

[legend]

Collaboration diagram for CBlockIndex:

[legend]

Public Member Functions
int nFile	GUARDED_BY (::cs_main)
	Which # file this block is stored in (blk?????.dat) More...

unsigned int nDataPos	GUARDED_BY (::cs_main)
	Byte offset within blk?????.dat where this block's data is stored. More...

unsigned int nUndoPos	GUARDED_BY (::cs_main)
	Byte offset within rev?????.dat where this block's undo data is stored. More...

uint32_t nStatus	GUARDED_BY (::cs_main)
	Verification status of this block. More...

	CBlockIndex (const CBlockHeader &block)

FlatFilePos	GetBlockPos () const EXCLUSIVE_LOCKS_REQUIRED(

FlatFilePos	GetUndoPos () const EXCLUSIVE_LOCKS_REQUIRED(

CBlockHeader	GetBlockHeader () const

uint256	GetBlockHash () const

bool	HaveTxsDownloaded () const
	Check whether this block's and all previous blocks' transactions have been downloaded (and stored to disk) at some point. More...

NodeSeconds	Time () const

int64_t	GetBlockTime () const

int64_t	GetBlockTimeMax () const

int64_t	GetMedianTimePast () const

std::string	ToString () const

bool	IsValid (enum BlockStatus nUpTo=BLOCK_VALID_TRANSACTIONS) const EXCLUSIVE_LOCKS_REQUIRED(
	Check whether this block index entry is valid up to the passed validity level. More...

bool	IsAssumedValid () const EXCLUSIVE_LOCKS_REQUIRED(

bool	RaiseValidity (enum BlockStatus nUpTo) EXCLUSIVE_LOCKS_REQUIRED(
	Raise the validity level of this block index entry. More...

void	BuildSkip ()
	Build the skiplist pointer for this entry. More...

CBlockIndex *	GetAncestor (int height)
	Efficiently find an ancestor of this block. More...

const CBlockIndex *	GetAncestor (int height) const

	CBlockIndex ()=default

	~CBlockIndex ()=default

Public Attributes
const uint256 *	phashBlock {nullptr}
	pointer to the hash of the block, if any. Memory is owned by this CBlockIndex More...

CBlockIndex *	pprev {nullptr}
	pointer to the index of the predecessor of this block More...

CBlockIndex *	pskip {nullptr}
	pointer to the index of some further predecessor of this block More...

int	nHeight {0}
	height of the entry in the chain. The genesis block has height 0 More...

arith_uint256	nChainWork {}
	(memory only) Total amount of work (expected number of hashes) in the chain up to and including this block More...

unsigned int	nTx {0}
	Number of transactions in this block. More...

unsigned int	nChainTx {0}
	(memory only) Number of transactions in the chain up to and including this block. More...

int32_t	nVersion {0}
	block header More...

uint256	hashMerkleRoot {}

uint32_t	nTime {0}

uint32_t	nBits {0}

uint32_t	nNonce {0}

int32_t	nSequenceId {0}
	(memory only) Sequential id assigned to distinguish order in which blocks are received. More...

unsigned int	nTimeMax {0}
	(memory only) Maximum nTime in the chain up to and including this block. More...

Static Public Attributes
static constexpr int	nMedianTimeSpan = 11

Protected Member Functions
	CBlockIndex (const CBlockIndex &)=default
	CBlockIndex should not allow public copy construction because equality comparison via pointer is very common throughout the codebase, making use of copy a footgun. More...

CBlockIndex &	operator= (const CBlockIndex &)=delete

	CBlockIndex (CBlockIndex &&)=delete

CBlockIndex &	operator= (CBlockIndex &&)=delete

Detailed Description

The block chain is a tree shaped structure starting with the genesis block at the root, with each block potentially having multiple candidates to be the next block.

A blockindex may have multiple pprev pointing to it, but at most one of them can be part of the currently active branch.

Definition at line 150 of file chain.h.

Constructor & Destructor Documentation

◆ CBlockIndex() [1/4]

CBlockIndex::CBlockIndex ( const CBlockHeader & block )

inlineexplicit

Definition at line 215 of file chain.h.

◆ CBlockIndex() [2/4]

CBlockIndex::CBlockIndex ( )

default

◆ ~CBlockIndex()

CBlockIndex::~CBlockIndex ( )

default

◆ CBlockIndex() [3/4]

CBlockIndex::CBlockIndex ( const CBlockIndex & )

protecteddefault

CBlockIndex should not allow public copy construction because equality comparison via pointer is very common throughout the codebase, making use of copy a footgun.

Also, use of copies do not have the benefit of simplifying lifetime considerations due to attributes like pprev and pskip, which are at risk of becoming dangling pointers in a copied instance.

We declare these protected instead of simply deleting them so that CDiskBlockIndex can reuse copy construction.

◆ CBlockIndex() [4/4]

CBlockIndex::CBlockIndex ( CBlockIndex && )

protecteddelete

Member Function Documentation

◆ BuildSkip()

void CBlockIndex::BuildSkip ( )

Build the skiplist pointer for this entry.

Definition at line 125 of file chain.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GetAncestor() [1/2]

CBlockIndex * CBlockIndex::GetAncestor ( int height )

Efficiently find an ancestor of this block.

Definition at line 120 of file chain.cpp.

Here is the caller graph for this function:

◆ GetAncestor() [2/2]

const CBlockIndex * CBlockIndex::GetAncestor ( int height ) const

Definition at line 93 of file chain.cpp.

Here is the call graph for this function:

◆ GetBlockHash()

uint256 CBlockIndex::GetBlockHash ( ) const

inline

Definition at line 259 of file chain.h.

Here is the call graph for this function:

◆ GetBlockHeader()

CBlockHeader CBlockIndex::GetBlockHeader ( ) const

inline

Definition at line 246 of file chain.h.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GetBlockPos()

FlatFilePos CBlockIndex::GetBlockPos ( ) const

inline

Definition at line 224 of file chain.h.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GetBlockTime()

int64_t CBlockIndex::GetBlockTime ( ) const

inline

Definition at line 279 of file chain.h.

Here is the caller graph for this function:

◆ GetBlockTimeMax()

int64_t CBlockIndex::GetBlockTimeMax ( ) const

inline

Definition at line 284 of file chain.h.

Here is the caller graph for this function:

◆ GetMedianTimePast()

int64_t CBlockIndex::GetMedianTimePast ( ) const

inline

Definition at line 291 of file chain.h.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GetUndoPos()

FlatFilePos CBlockIndex::GetUndoPos ( ) const

inline

Definition at line 235 of file chain.h.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GUARDED_BY() [1/4]

int nFile CBlockIndex::GUARDED_BY ( ::cs_main )

inline

Which # file this block is stored in (blk?????.dat)

Definition at line 166 of file chain.h.

◆ GUARDED_BY() [2/4]

unsigned int nDataPos CBlockIndex::GUARDED_BY ( ::cs_main )

inline

Byte offset within blk?????.dat where this block's data is stored.

Definition at line 169 of file chain.h.

◆ GUARDED_BY() [3/4]

unsigned int nUndoPos CBlockIndex::GUARDED_BY ( ::cs_main )

inline

Byte offset within rev?????.dat where this block's undo data is stored.

Definition at line 172 of file chain.h.

◆ GUARDED_BY() [4/4]

uint32_t nStatus CBlockIndex::GUARDED_BY ( ::cs_main )

inline

Verification status of this block.

See enum BlockStatus

Note: this value is modified to show BLOCK_OPT_WITNESS during UTXO snapshot load to avoid the block index being spuriously rewound.

See also: NeedsRedownload; ActivateSnapshot

Definition at line 200 of file chain.h.

◆ HaveTxsDownloaded()

bool CBlockIndex::HaveTxsDownloaded ( ) const

inline

Check whether this block's and all previous blocks' transactions have been downloaded (and stored to disk) at some point.

Does not imply the transactions are consensus-valid (ConnectTip might fail) Does not imply the transactions are still stored on disk. (IsBlockPruned might return true)

Definition at line 272 of file chain.h.

Here is the caller graph for this function:

◆ IsAssumedValid()

bool CBlockIndex::IsAssumedValid ( ) const

inline

Returns: true if the block is assumed-valid; this means it is queued to be validated by a background chainstate.

Definition at line 320 of file chain.h.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ IsValid()

bool CBlockIndex::IsValid ( enum BlockStatus nUpTo = BLOCK_VALID_TRANSACTIONS ) const

inline

Check whether this block index entry is valid up to the passed validity level.

Definition at line 308 of file chain.h.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ operator=() [1/2]

CBlockIndex& CBlockIndex::operator= ( CBlockIndex && )

protecteddelete

◆ operator=() [2/2]

CBlockIndex& CBlockIndex::operator= ( const CBlockIndex & )

protecteddelete

◆ RaiseValidity()

bool CBlockIndex::RaiseValidity ( enum BlockStatus nUpTo )

inline

Raise the validity level of this block index entry.

Returns true if the validity was changed.

Definition at line 328 of file chain.h.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ Time()

NodeSeconds CBlockIndex::Time ( ) const

inline

Definition at line 274 of file chain.h.

◆ ToString()

std::string CBlockIndex::ToString ( ) const

Definition at line 15 of file chain.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

Member Data Documentation

◆ hashMerkleRoot

uint256 CBlockIndex::hashMerkleRoot {}

Definition at line 204 of file chain.h.

◆ nBits

uint32_t CBlockIndex::nBits {0}

Definition at line 206 of file chain.h.

◆ nChainTx

unsigned int CBlockIndex::nChainTx {0}

(memory only) Number of transactions in the chain up to and including this block.

This value will be non-zero only if and only if transactions for this block and all its parents are available. Change to 64-bit type before 2024 (assuming worst case of 60 byte transactions).

Note: this value is faked during use of a UTXO snapshot because we don't have the underlying block data available during snapshot load.

See also: AssumeutxoData; ActivateSnapshot

Definition at line 192 of file chain.h.

◆ nChainWork

arith_uint256 CBlockIndex::nChainWork {}

(memory only) Total amount of work (expected number of hashes) in the chain up to and including this block

Definition at line 175 of file chain.h.

◆ nHeight

int CBlockIndex::nHeight {0}

height of the entry in the chain. The genesis block has height 0

Definition at line 163 of file chain.h.

◆ nMedianTimeSpan

constexpr int CBlockIndex::nMedianTimeSpan = 11

staticconstexpr

Definition at line 289 of file chain.h.

◆ nNonce

uint32_t CBlockIndex::nNonce {0}

Definition at line 207 of file chain.h.

◆ nSequenceId

int32_t CBlockIndex::nSequenceId {0}

(memory only) Sequential id assigned to distinguish order in which blocks are received.

Definition at line 210 of file chain.h.

◆ nTime

uint32_t CBlockIndex::nTime {0}

Definition at line 205 of file chain.h.

◆ nTimeMax

unsigned int CBlockIndex::nTimeMax {0}

(memory only) Maximum nTime in the chain up to and including this block.

Definition at line 213 of file chain.h.

◆ nTx

unsigned int CBlockIndex::nTx {0}

Number of transactions in this block.

Note: in a potential headers-first mode, this number cannot be relied upon Note: this value is faked during UTXO snapshot load to ensure that LoadBlockIndex() will load index entries for blocks that we lack data for.

See also: ActivateSnapshot

Definition at line 182 of file chain.h.

◆ nVersion

int32_t CBlockIndex::nVersion {0}

block header

Definition at line 203 of file chain.h.

◆ phashBlock

const uint256* CBlockIndex::phashBlock {nullptr}

pointer to the hash of the block, if any. Memory is owned by this CBlockIndex

Definition at line 154 of file chain.h.

◆ pprev

CBlockIndex* CBlockIndex::pprev {nullptr}

pointer to the index of the predecessor of this block

Definition at line 157 of file chain.h.

◆ pskip

CBlockIndex* CBlockIndex::pskip {nullptr}

pointer to the index of some further predecessor of this block

Definition at line 160 of file chain.h.

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

src/chain.h
src/chain.cpp

Public Member Functions

Public Attributes

Static Public Attributes

Protected Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ CBlockIndex() [1/4]

◆ CBlockIndex() [2/4]

◆ ~CBlockIndex()

◆ CBlockIndex() [3/4]

◆ CBlockIndex() [4/4]

Member Function Documentation

◆ BuildSkip()

◆ GetAncestor() [1/2]

◆ GetAncestor() [2/2]

◆ GetBlockHash()

◆ GetBlockHeader()

◆ GetBlockPos()

◆ GetBlockTime()

◆ GetBlockTimeMax()

◆ GetMedianTimePast()

◆ GetUndoPos()

◆ GUARDED_BY() [1/4]

◆ GUARDED_BY() [2/4]

◆ GUARDED_BY() [3/4]

◆ GUARDED_BY() [4/4]

◆ HaveTxsDownloaded()

◆ IsAssumedValid()

◆ IsValid()

◆ operator=() [1/2]

◆ operator=() [2/2]

◆ RaiseValidity()

◆ Time()

◆ ToString()

Member Data Documentation

◆ hashMerkleRoot

◆ nBits

◆ nChainTx

◆ nChainWork

◆ nHeight

◆ nMedianTimeSpan

◆ nNonce

◆ nSequenceId

◆ nTime

◆ nTimeMax

◆ nTx

◆ nVersion

◆ phashBlock

◆ pprev

◆ pskip