chain.h File Reference

#include <arith_uint256.h>
#include <blockindex.h>
#include <blockstatus.h>
#include <blockvalidity.h>
#include <consensus/params.h>
#include <crypto/common.h>
#include <flatfile.h>
#include <kernel/cs_main.h>
#include <primitives/block.h>
#include <sync.h>
#include <uint256.h>
#include <unordered_map>
#include <vector>

Include dependency graph for chain.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Classes
class	CDiskBlockIndex
	Used to marshal pointers into hashes for db storage. More...
class	CChain
	An in-memory indexed chain of blocks. More...

Functions
arith_uint256	GetBlockProof (const CBlockIndex &block)
int64_t	GetBlockProofEquivalentTime (const CBlockIndex &to, const CBlockIndex &from, const CBlockIndex &tip, const Consensus::Params &)
	Return the time it would take to redo the work difference between from and to, assuming the current hashrate corresponds to the difficulty at tip, in seconds.
const CBlockIndex *	LastCommonAncestor (const CBlockIndex *pa, const CBlockIndex *pb)
	Find the forking point between two chain tips.
bool	AreOnTheSameFork (const CBlockIndex *pa, const CBlockIndex *pb)
	Check if two block index are on the same fork.
CBlockLocator	GetLocator (const CBlockIndex *index)
	Get a locator for a block index entry.
std::vector< BlockHash >	LocatorEntries (const CBlockIndex *index)
	Construct a list of hash entries to put in a locator.

Variables
static constexpr int64_t	MAX_FUTURE_BLOCK_TIME = 2 * 60 * 60
	Maximum amount of time that a block timestamp is allowed to exceed the current network-adjusted time before the block will be accepted.
static constexpr int64_t	TIMESTAMP_WINDOW = MAX_FUTURE_BLOCK_TIME
	Timestamp window used as a grace period by code that compares external timestamps (such as timestamps passed to RPCs, or wallet key creation times) to block timestamps.
static constexpr int64_t	MAX_BLOCK_TIME_GAP = 90 * 60
	Maximum gap between node time and block time used for the "Catching up..." mode in GUI.

Function Documentation

AreOnTheSameFork()

bool AreOnTheSameFork	(	const CBlockIndex *	pa,
		const CBlockIndex *	pb
	)

Check if two block index are on the same fork.

Definition at line 136 of file chain.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

GetBlockProof()

arith_uint256 GetBlockProof

(

const CBlockIndex &

block

)

Definition at line 74 of file chain.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

GetBlockProofEquivalentTime()

int64_t GetBlockProofEquivalentTime	(	const CBlockIndex &	to,
		const CBlockIndex &	from,
		const CBlockIndex &	tip,
		const Consensus::Params &	params
	)

Return the time it would take to redo the work difference between from and to, assuming the current hashrate corresponds to the difficulty at tip, in seconds.

Definition at line 89 of file chain.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

GetLocator()

CBlockLocator GetLocator

(

const CBlockIndex *

index

)

Get a locator for a block index entry.

Definition at line 41 of file chain.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

LastCommonAncestor()

const CBlockIndex * LastCommonAncestor	(	const CBlockIndex *	pa,
		const CBlockIndex *	pb
	)

Find the forking point between two chain tips.

Find the forking point between two chain tips.

Both pa and pb must be non null.

Definition at line 112 of file chain.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

LocatorEntries()

std::vector< BlockHash > LocatorEntries

(

const CBlockIndex *

index

)

Construct a list of hash entries to put in a locator.

Definition at line 17 of file chain.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

Variable Documentation

MAX_BLOCK_TIME_GAP

constexpr int64_t MAX_BLOCK_TIME_GAP = 90 * 60

staticconstexpr

Maximum gap between node time and block time used for the "Catching up..." mode in GUI.

Ref: https://github.com/bitcoin/bitcoin/pull/1026

Definition at line 44 of file chain.h.

MAX_FUTURE_BLOCK_TIME

constexpr int64_t MAX_FUTURE_BLOCK_TIME = 2 * 60 * 60

staticconstexpr

Maximum amount of time that a block timestamp is allowed to exceed the current network-adjusted time before the block will be accepted.

Definition at line 28 of file chain.h.

TIMESTAMP_WINDOW

constexpr int64_t TIMESTAMP_WINDOW = MAX_FUTURE_BLOCK_TIME

staticconstexpr

Timestamp window used as a grace period by code that compares external timestamps (such as timestamps passed to RPCs, or wallet key creation times) to block timestamps.

This should be set at least as high as MAX_FUTURE_BLOCK_TIME.

Definition at line 36 of file chain.h.