Bitcoin Core 22.99.0
P2P Digital Currency
blockfilterindex.h
Go to the documentation of this file.
1// Copyright (c) 2018-2020 The Bitcoin Core developers
2// Distributed under the MIT software license, see the accompanying
3// file COPYING or http://www.opensource.org/licenses/mit-license.php.
4
5#ifndef BITCOIN_INDEX_BLOCKFILTERINDEX_H
6#define BITCOIN_INDEX_BLOCKFILTERINDEX_H
7
8#include <blockfilter.h>
9#include <chain.h>
10#include <flatfile.h>
11#include <index/base.h>
12#include <util/hasher.h>
13
15static constexpr int CFCHECKPT_INTERVAL = 1000;
16
24class BlockFilterIndex final : public BaseIndex
25{
26private:
28 std::string m_name;
29 std::unique_ptr<BaseIndex::DB> m_db;
30
32 std::unique_ptr<FlatFileSeq> m_filter_fileseq;
33
34 bool ReadFilterFromDisk(const FlatFilePos& pos, BlockFilter& filter) const;
35 size_t WriteFilterToDisk(FlatFilePos& pos, const BlockFilter& filter);
36
39 std::unordered_map<uint256, uint256, FilterHeaderHasher> m_headers_cache GUARDED_BY(m_cs_headers_cache);
40
41protected:
42 bool Init() override;
43
44 bool CommitInternal(CDBBatch& batch) override;
45
46 bool WriteBlock(const CBlock& block, const CBlockIndex* pindex) override;
47
48 bool Rewind(const CBlockIndex* current_tip, const CBlockIndex* new_tip) override;
49
50 BaseIndex::DB& GetDB() const override { return *m_db; }
51
52 const char* GetName() const override { return m_name.c_str(); }
53
54public:
56 explicit BlockFilterIndex(BlockFilterType filter_type,
57 size_t n_cache_size, bool f_memory = false, bool f_wipe = false);
58
60
62 bool LookupFilter(const CBlockIndex* block_index, BlockFilter& filter_out) const;
63
65 bool LookupFilterHeader(const CBlockIndex* block_index, uint256& header_out);
66
68 bool LookupFilterRange(int start_height, const CBlockIndex* stop_index,
69 std::vector<BlockFilter>& filters_out) const;
70
72 bool LookupFilterHashRange(int start_height, const CBlockIndex* stop_index,
73 std::vector<uint256>& hashes_out) const;
74};
75
81
83void ForEachBlockFilterIndex(std::function<void (BlockFilterIndex&)> fn);
84
90 size_t n_cache_size, bool f_memory = false, bool f_wipe = false);
91
98
101
102#endif // BITCOIN_INDEX_BLOCKFILTERINDEX_H
BlockFilterType
Definition: blockfilter.h:89
bool DestroyBlockFilterIndex(BlockFilterType filter_type)
Destroy the block filter index with the given type.
void DestroyAllBlockFilterIndexes()
Destroy all open block filter indexes.
bool InitBlockFilterIndex(BlockFilterType filter_type, size_t n_cache_size, bool f_memory=false, bool f_wipe=false)
Initialize a block filter index for the given type if one does not already exist.
BlockFilterIndex * GetBlockFilterIndex(BlockFilterType filter_type)
Get a block filter index by type.
static constexpr int CFCHECKPT_INTERVAL
Interval between compact filter checkpoints.
void ForEachBlockFilterIndex(std::function< void(BlockFilterIndex &)> fn)
Iterate over all running block filter indexes, invoking fn on each.
The database stores a block locator of the chain the database is synced to so that the index can effi...
Definition: base.h:38
Base class for indices of blockchain data.
Definition: base.h:28
Complete block filter struct as defined in BIP 157.
Definition: blockfilter.h:111
BlockFilterIndex is used to store and retrieve block filters, hashes, and headers for a range of bloc...
std::unique_ptr< BaseIndex::DB > m_db
bool CommitInternal(CDBBatch &batch) override
Virtual method called internally by Commit that can be overridden to atomically commit more index sta...
std::unordered_map< uint256, 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 Rewind(const CBlockIndex *current_tip, const CBlockIndex *new_tip) override
Rewind index to an earlier chain tip during a chain reorg.
bool ReadFilterFromDisk(const FlatFilePos &pos, BlockFilter &filter) const
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.
const char * GetName() const override
Get the name of the index for display in logs.
BlockFilterType GetFilterType() const
bool LookupFilterHeader(const CBlockIndex *block_index, uint256 &header_out)
Get a single filter header by block.
BlockFilterType m_filter_type
bool Init() override
Initialize internal state from the database and block index.
bool WriteBlock(const CBlock &block, const CBlockIndex *pindex) override
Write update index entries for a newly connected block.
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.
std::unique_ptr< FlatFileSeq > m_filter_fileseq
bool LookupFilter(const CBlockIndex *block_index, BlockFilter &filter_out) const
Get a single filter by block.
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.
size_t WriteFilterToDisk(FlatFilePos &pos, const BlockFilter &filter)
BaseIndex::DB & GetDB() const override
std::string m_name
FlatFilePos m_next_filter_pos
Definition: block.h:63
The block chain is a tree shaped structure starting with the genesis block at the root,...
Definition: chain.h:146
Batch of changes queued to be written to a CDBWrapper.
Definition: dbwrapper.h:48
256-bit opaque blob.
Definition: uint256.h:124