BlockFilterIndex is used to store and retrieve block filters, hashes, and headers for a range of blocks by height. More...

#include <blockfilterindex.h>

Inheritance diagram for BlockFilterIndex:

[legend]

Collaboration diagram for BlockFilterIndex:

[legend]

Public Member Functions
	BlockFilterIndex (BlockFilterType filter_type, size_t n_cache_size, bool f_memory=false, bool f_wipe=false)
	Constructs the index, which becomes available to be queried.

BlockFilterType	GetFilterType () const

bool	LookupFilter (const CBlockIndex *block_index, BlockFilter &filter_out) const
	Get a single filter by block.

bool	LookupFilterHeader (const CBlockIndex *block_index, uint256 &header_out) EXCLUSIVE_LOCKS_REQUIRED(!m_cs_headers_cache)
	Get a single filter header by block.

bool	LookupFilterRange (int start_height, const CBlockIndex *stop_index, std::vector< BlockFilter > &filters_out) const
	Get a range of filters between two heights on a chain.

bool	LookupFilterHashRange (int start_height, const CBlockIndex *stop_index, std::vector< uint256 > &hashes_out) const
	Get a range of filter hashes between two heights on a chain.

Public Member Functions inherited from BaseIndex
virtual	~BaseIndex ()
	Destructor interrupts sync thread if running and blocks until it exits.

bool BlockUntilSyncedToCurrentChain() const LOCKS_EXCLUDED(void	Interrupt ()
	Blocks the current thread until the index is caught up to the current state of the block chain.

bool	Start (Chainstate &active_chainstate)
	Start initializes the sync state and registers the instance as a ValidationInterface so that it stays in sync with blockchain updates.

void	Stop ()
	Stops the instance from staying in sync with blockchain updates.

IndexSummary	GetSummary () const
	Get a summary of the index and its state.

Protected Member Functions
bool	Init () override
	Initialize internal state from the database and block index.

bool	CommitInternal (CDBBatch &batch) override
	Virtual method called internally by Commit that can be overridden to atomically commit more index state.

bool	WriteBlock (const CBlock &block, const CBlockIndex *pindex) override
	Write update index entries for a newly connected block.

bool	Rewind (const CBlockIndex current_tip, const CBlockIndex new_tip) override
	Rewind index to an earlier chain tip during a chain reorg.

BaseIndex::DB &	GetDB () const override

const char *	GetName () const override
	Get the name of the index for display in logs.

Protected Member Functions inherited from BaseIndex
void	BlockConnected (const std::shared_ptr< const CBlock > &block, const CBlockIndex *pindex) override
	Notifies listeners of a block being connected.

void	ChainStateFlushed (const CBlockLocator &locator) override
	Notifies listeners of the new active block chain on-disk.

const CBlockIndex *	CurrentIndex ()

void	SetBestBlockIndex (const CBlockIndex *block)
	Update the internal best block index as well as the prune lock.

Protected Member Functions inherited from CValidationInterface
	~CValidationInterface ()=default
	Protected destructor so that instances can only be deleted by derived classes.

virtual void	UpdatedBlockTip (const CBlockIndex pindexNew, const CBlockIndex pindexFork, bool fInitialDownload)
	Notifies listeners when the block chain tip advances.

virtual void	TransactionAddedToMempool (const CTransactionRef &tx, std::shared_ptr< const std::vector< Coin > > spent_coins, uint64_t mempool_sequence)
	Notifies listeners of a transaction having been added to mempool.

virtual void	TransactionRemovedFromMempool (const CTransactionRef &tx, MemPoolRemovalReason reason, uint64_t mempool_sequence)
	Notifies listeners of a transaction leaving mempool.

virtual void	BlockDisconnected (const std::shared_ptr< const CBlock > &block, const CBlockIndex *pindex)
	Notifies listeners of a block being disconnected.

virtual void	BlockChecked (const CBlock &, const BlockValidationState &)
	Notifies listeners of a block validation result.

virtual void	NewPoWValidBlock (const CBlockIndex *pindex, const std::shared_ptr< const CBlock > &block)
	Notifies listeners that a block which builds directly on our current tip has been received and connected to the headers tree, though not validated yet.

virtual void	BlockFinalized (const CBlockIndex *pindex)

virtual void	BlockInvalidated (const CBlockIndex *pindex, const std::shared_ptr< const CBlock > &block)

Private Member Functions
bool	ReadFilterFromDisk (const FlatFilePos &pos, BlockFilter &filter) const

size_t	WriteFilterToDisk (FlatFilePos &pos, const BlockFilter &filter)

std::unordered_map< BlockHash, uint256, FilterHeaderHasher > m_headers_cache	GUARDED_BY (m_cs_headers_cache)
	Cache of block hash to filter header, to avoid disk access when responding to getcfcheckpt.

bool	AllowPrune () const override

Private Attributes
BlockFilterType	m_filter_type

std::string	m_name

std::unique_ptr< BaseIndex::DB >	m_db

FlatFilePos	m_next_filter_pos

std::unique_ptr< FlatFileSeq >	m_filter_fileseq

Mutex	m_cs_headers_cache

Additional Inherited Members
Protected Attributes inherited from BaseIndex
Chainstate *	m_chainstate {nullptr}

Detailed Description

BlockFilterIndex is used to store and retrieve block filters, hashes, and headers for a range of blocks by height.

An index is constructed for each supported filter type with its own database (ie. filter data for different types are stored in separate databases).

This index is used to serve BIP 157 net requests.

Definition at line 27 of file blockfilterindex.h.

Constructor & Destructor Documentation

◆ BlockFilterIndex()

BlockFilterIndex::BlockFilterIndex	(	BlockFilterType	filter_type,
		size_t	n_cache_size,
		bool	f_memory = `false`,
		bool	f_wipe = `false`
	)

explicit

Constructs the index, which becomes available to be queried.

Definition at line 105 of file blockfilterindex.cpp.

Here is the call graph for this function:

Member Function Documentation

◆ AllowPrune()

bool BlockFilterIndex::AllowPrune ( ) const

inlineoverrideprivatevirtual

Implements BaseIndex.

Definition at line 47 of file blockfilterindex.h.

◆ CommitInternal()

bool BlockFilterIndex::CommitInternal ( CDBBatch & batch )

overrideprotectedvirtual

Virtual method called internally by Commit that can be overridden to atomically commit more index state.

Reimplemented from BaseIndex.

Definition at line 144 of file blockfilterindex.cpp.

Here is the call graph for this function:

◆ GetDB()

BaseIndex::DB & BlockFilterIndex::GetDB ( ) const

inlineoverrideprotectedvirtual

Implements BaseIndex.

Definition at line 59 of file blockfilterindex.h.

◆ GetFilterType()

BlockFilterType BlockFilterIndex::GetFilterType ( ) const

inline

Definition at line 68 of file blockfilterindex.h.

Here is the caller graph for this function:

◆ GetName()

const char * BlockFilterIndex::GetName ( ) const

inlineoverrideprotectedvirtual

Get the name of the index for display in logs.

Implements BaseIndex.

Definition at line 61 of file blockfilterindex.h.

Here is the caller graph for this function:

◆ GUARDED_BY()

std::unordered_map< BlockHash, uint256, FilterHeaderHasher > m_headers_cache BlockFilterIndex::GUARDED_BY ( m_cs_headers_cache )

private

Cache of block hash to filter header, to avoid disk access when responding to getcfcheckpt.

◆ Init()

bool BlockFilterIndex::Init ( )

overrideprotectedvirtual

Initialize internal state from the database and block index.

Reimplemented from BaseIndex.

Definition at line 125 of file blockfilterindex.cpp.

Here is the call graph for this function:

◆ LookupFilter()

bool BlockFilterIndex::LookupFilter	(	const CBlockIndex *	block_index,
		BlockFilter &	filter_out
	)		const

Get a single filter by block.

Definition at line 409 of file blockfilterindex.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ LookupFilterHashRange()

bool BlockFilterIndex::LookupFilterHashRange	(	int	start_height,
		const CBlockIndex *	stop_index,
		std::vector< uint256 > &	hashes_out
	)		const

Get a range of filter hashes between two heights on a chain.

Definition at line 469 of file blockfilterindex.cpp.

Here is the call graph for this function:

◆ LookupFilterHeader()

bool BlockFilterIndex::LookupFilterHeader	(	const CBlockIndex *	block_index,
		uint256 &	header_out
	)

Get a single filter header by block.

Definition at line 419 of file blockfilterindex.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ LookupFilterRange()

bool BlockFilterIndex::LookupFilterRange	(	int	start_height,
		const CBlockIndex *	stop_index,
		std::vector< BlockFilter > &	filters_out
	)		const

Get a range of filters between two heights on a chain.

Definition at line 449 of file blockfilterindex.cpp.

Here is the call graph for this function:

◆ ReadFilterFromDisk()

bool BlockFilterIndex::ReadFilterFromDisk	(	const FlatFilePos &	pos,
		BlockFilter &	filter
	)		const

private

Definition at line 161 of file blockfilterindex.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ Rewind()

bool BlockFilterIndex::Rewind	(	const CBlockIndex *	current_tip,
		const CBlockIndex *	new_tip
	)

overrideprotectedvirtual

Rewind index to an earlier chain tip during a chain reorg.

The tip must be an ancestor of the current best block.

Reimplemented from BaseIndex.

Definition at line 304 of file blockfilterindex.cpp.

Here is the call graph for this function:

◆ WriteBlock()

bool BlockFilterIndex::WriteBlock	(	const CBlock &	block,
		const CBlockIndex *	pindex
	)

overrideprotectedvirtual

Write update index entries for a newly connected block.

Reimplemented from BaseIndex.

Definition at line 232 of file blockfilterindex.cpp.

Here is the call graph for this function:

◆ WriteFilterToDisk()

size_t BlockFilterIndex::WriteFilterToDisk	(	FlatFilePos &	pos,
		const BlockFilter &	filter
	)

private

Definition at line 182 of file blockfilterindex.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

Member Data Documentation

◆ m_cs_headers_cache

Mutex BlockFilterIndex::m_cs_headers_cache

private

Definition at line 39 of file blockfilterindex.h.

◆ m_db

std::unique_ptr<BaseIndex::DB> BlockFilterIndex::m_db

private

Definition at line 31 of file blockfilterindex.h.

◆ m_filter_fileseq

std::unique_ptr<FlatFileSeq> BlockFilterIndex::m_filter_fileseq

private

Definition at line 34 of file blockfilterindex.h.

◆ m_filter_type

BlockFilterType BlockFilterIndex::m_filter_type

private

Definition at line 29 of file blockfilterindex.h.

◆ m_name

std::string BlockFilterIndex::m_name

private

Definition at line 30 of file blockfilterindex.h.

◆ m_next_filter_pos

FlatFilePos BlockFilterIndex::m_next_filter_pos

private

Definition at line 33 of file blockfilterindex.h.

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

src/index/blockfilterindex.h
src/index/blockfilterindex.cpp

Public Member Functions

Protected Member Functions

Private Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ BlockFilterIndex()

Member Function Documentation

◆ AllowPrune()

◆ CommitInternal()

◆ GetDB()

◆ GetFilterType()

◆ GetName()

◆ GUARDED_BY()

◆ Init()

◆ LookupFilter()

◆ LookupFilterHashRange()

◆ LookupFilterHeader()

◆ LookupFilterRange()

◆ ReadFilterFromDisk()

◆ Rewind()

◆ WriteBlock()

◆ WriteFilterToDisk()

Member Data Documentation

◆ m_cs_headers_cache

◆ m_db

◆ m_filter_fileseq

◆ m_filter_type

◆ m_name

◆ m_next_filter_pos