Bitcoin Core 29.99.0
P2P Digital Currency
blockfilterindex.cpp
Go to the documentation of this file.
1// Copyright (c) 2018-2022 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#include <map>
6
7#include <clientversion.h>
8#include <common/args.h>
9#include <dbwrapper.h>
10#include <hash.h>
12#include <logging.h>
13#include <node/blockstorage.h>
14#include <undo.h>
15#include <util/fs_helpers.h>
16
17/* The index database stores three items for each block: the disk location of the encoded filter,
18 * its dSHA256 hash, and the header. Those belonging to blocks on the active chain are indexed by
19 * height, and those belonging to blocks that have been reorganized out of the active chain are
20 * indexed by block hash. This ensures that filter data for any block that becomes part of the
21 * active chain can always be retrieved, alleviating timing concerns.
22 *
23 * The filters themselves are stored in flat files and referenced by the LevelDB entries. This
24 * minimizes the amount of data written to LevelDB and keeps the database values constant size. The
25 * disk location of the next block filter to be written (represented as a FlatFilePos) is stored
26 * under the DB_FILTER_POS key.
27 *
28 * Keys for the height index have the type [DB_BLOCK_HEIGHT, uint32 (BE)]. The height is represented
29 * as big-endian so that sequential reads of filters by height are fast.
30 * Keys for the hash index have the type [DB_BLOCK_HASH, uint256].
31 */
32constexpr uint8_t DB_BLOCK_HASH{'s'};
33constexpr uint8_t DB_BLOCK_HEIGHT{'t'};
34constexpr uint8_t DB_FILTER_POS{'P'};
35
36constexpr unsigned int MAX_FLTR_FILE_SIZE = 0x1000000; // 16 MiB
38constexpr unsigned int FLTR_FILE_CHUNK_SIZE = 0x100000; // 1 MiB
44constexpr size_t CF_HEADERS_CACHE_MAX_SZ{2000};
45
46namespace {
47
48struct DBVal {
49 uint256 hash;
50 uint256 header;
51 FlatFilePos pos;
52
53 SERIALIZE_METHODS(DBVal, obj) { READWRITE(obj.hash, obj.header, obj.pos); }
54};
55
56struct DBHeightKey {
57 int height;
58
59 explicit DBHeightKey(int height_in) : height(height_in) {}
60
61 template<typename Stream>
62 void Serialize(Stream& s) const
63 {
65 ser_writedata32be(s, height);
66 }
67
68 template<typename Stream>
69 void Unserialize(Stream& s)
70 {
71 const uint8_t prefix{ser_readdata8(s)};
72 if (prefix != DB_BLOCK_HEIGHT) {
73 throw std::ios_base::failure("Invalid format for block filter index DB height key");
74 }
75 height = ser_readdata32be(s);
76 }
77};
78
79struct DBHashKey {
80 uint256 hash;
81
82 explicit DBHashKey(const uint256& hash_in) : hash(hash_in) {}
83
84 SERIALIZE_METHODS(DBHashKey, obj) {
85 uint8_t prefix{DB_BLOCK_HASH};
87 if (prefix != DB_BLOCK_HASH) {
88 throw std::ios_base::failure("Invalid format for block filter index DB hash key");
89 }
90
91 READWRITE(obj.hash);
92 }
93};
94
95}; // namespace
96
97static std::map<BlockFilterType, BlockFilterIndex> g_filter_indexes;
98
99BlockFilterIndex::BlockFilterIndex(std::unique_ptr<interfaces::Chain> chain, BlockFilterType filter_type,
100 size_t n_cache_size, bool f_memory, bool f_wipe)
101 : BaseIndex(std::move(chain), BlockFilterTypeName(filter_type) + " block filter index")
102 , m_filter_type(filter_type)
103{
104 const std::string& filter_name = BlockFilterTypeName(filter_type);
105 if (filter_name.empty()) throw std::invalid_argument("unknown filter_type");
106
107 fs::path path = gArgs.GetDataDirNet() / "indexes" / "blockfilter" / fs::u8path(filter_name);
109
110 m_db = std::make_unique<BaseIndex::DB>(path / "db", n_cache_size, f_memory, f_wipe);
111 m_filter_fileseq = std::make_unique<FlatFileSeq>(std::move(path), "fltr", FLTR_FILE_CHUNK_SIZE);
112}
113
115{
117 options.connect_undo_data = true;
118 return options;
119}
120
121bool BlockFilterIndex::CustomInit(const std::optional<interfaces::BlockRef>& block)
122{
123 if (!m_db->Read(DB_FILTER_POS, m_next_filter_pos)) {
124 // Check that the cause of the read failure is that the key does not exist. Any other errors
125 // indicate database corruption or a disk failure, and starting the index would cause
126 // further corruption.
127 if (m_db->Exists(DB_FILTER_POS)) {
128 LogError("%s: Cannot read current %s state; index may be corrupted\n",
129 __func__, GetName());
130 return false;
131 }
132
133 // If the DB_FILTER_POS is not set, then initialize to the first location.
136 }
137
138 if (block) {
139 auto op_last_header = ReadFilterHeader(block->height, block->hash);
140 if (!op_last_header) {
141 LogError("Cannot read last block filter header; index may be corrupted\n");
142 return false;
143 }
144 m_last_header = *op_last_header;
145 }
146
147 return true;
148}
149
151{
152 const FlatFilePos& pos = m_next_filter_pos;
153
154 // Flush current filter file to disk.
155 AutoFile file{m_filter_fileseq->Open(pos)};
156 if (file.IsNull()) {
157 LogError("%s: Failed to open filter file %d\n", __func__, pos.nFile);
158 return false;
159 }
160 if (!file.Commit()) {
161 LogError("%s: Failed to commit filter file %d\n", __func__, pos.nFile);
162 return false;
163 }
164
165 batch.Write(DB_FILTER_POS, pos);
166 return true;
167}
168
169bool BlockFilterIndex::ReadFilterFromDisk(const FlatFilePos& pos, const uint256& hash, BlockFilter& filter) const
170{
171 AutoFile filein{m_filter_fileseq->Open(pos, true)};
172 if (filein.IsNull()) {
173 return false;
174 }
175
176 // Check that the hash of the encoded_filter matches the one stored in the db.
177 uint256 block_hash;
178 std::vector<uint8_t> encoded_filter;
179 try {
180 filein >> block_hash >> encoded_filter;
181 if (Hash(encoded_filter) != hash) {
182 LogError("Checksum mismatch in filter decode.\n");
183 return false;
184 }
185 filter = BlockFilter(GetFilterType(), block_hash, std::move(encoded_filter), /*skip_decode_check=*/true);
186 }
187 catch (const std::exception& e) {
188 LogError("%s: Failed to deserialize block filter from disk: %s\n", __func__, e.what());
189 return false;
190 }
191
192 return true;
193}
194
196{
197 assert(filter.GetFilterType() == GetFilterType());
198
199 size_t data_size =
202
203 // If writing the filter would overflow the file, flush and move to the next one.
204 if (pos.nPos + data_size > MAX_FLTR_FILE_SIZE) {
205 AutoFile last_file{m_filter_fileseq->Open(pos)};
206 if (last_file.IsNull()) {
207 LogPrintf("%s: Failed to open filter file %d\n", __func__, pos.nFile);
208 return 0;
209 }
210 if (!last_file.Truncate(pos.nPos)) {
211 LogPrintf("%s: Failed to truncate filter file %d\n", __func__, pos.nFile);
212 return 0;
213 }
214 if (!last_file.Commit()) {
215 LogPrintf("%s: Failed to commit filter file %d\n", __func__, pos.nFile);
216 return 0;
217 }
218
219 pos.nFile++;
220 pos.nPos = 0;
221 }
222
223 // Pre-allocate sufficient space for filter data.
224 bool out_of_space;
225 m_filter_fileseq->Allocate(pos, data_size, out_of_space);
226 if (out_of_space) {
227 LogPrintf("%s: out of disk space\n", __func__);
228 return 0;
229 }
230
231 AutoFile fileout{m_filter_fileseq->Open(pos)};
232 if (fileout.IsNull()) {
233 LogPrintf("%s: Failed to open filter file %d\n", __func__, pos.nFile);
234 return 0;
235 }
236
237 fileout << filter.GetBlockHash() << filter.GetEncodedFilter();
238 return data_size;
239}
240
241std::optional<uint256> BlockFilterIndex::ReadFilterHeader(int height, const uint256& expected_block_hash)
242{
243 std::pair<uint256, DBVal> read_out;
244 if (!m_db->Read(DBHeightKey(height), read_out)) {
245 return std::nullopt;
246 }
247
248 if (read_out.first != expected_block_hash) {
249 LogError("%s: previous block header belongs to unexpected block %s; expected %s\n",
250 __func__, read_out.first.ToString(), expected_block_hash.ToString());
251 return std::nullopt;
252 }
253
254 return read_out.second.header;
255}
256
258{
259 BlockFilter filter(m_filter_type, *Assert(block.data), *Assert(block.undo_data));
260 const uint256& header = filter.ComputeHeader(m_last_header);
261 bool res = Write(filter, block.height, header);
262 if (res) m_last_header = header; // update last header
263 return res;
264}
265
266bool BlockFilterIndex::Write(const BlockFilter& filter, uint32_t block_height, const uint256& filter_header)
267{
268 size_t bytes_written = WriteFilterToDisk(m_next_filter_pos, filter);
269 if (bytes_written == 0) return false;
270
271 std::pair<uint256, DBVal> value;
272 value.first = filter.GetBlockHash();
273 value.second.hash = filter.GetHash();
274 value.second.header = filter_header;
275 value.second.pos = m_next_filter_pos;
276
277 if (!m_db->Write(DBHeightKey(block_height), value)) {
278 return false;
279 }
280
281 m_next_filter_pos.nPos += bytes_written;
282 return true;
283}
284
285[[nodiscard]] static bool CopyHeightIndexToHashIndex(CDBIterator& db_it, CDBBatch& batch,
286 const std::string& index_name, int height)
287{
288 DBHeightKey key(height);
289 db_it.Seek(key);
290
291 if (!db_it.GetKey(key) || key.height != height) {
292 LogError("%s: unexpected key in %s: expected (%c, %d)\n",
293 __func__, index_name, DB_BLOCK_HEIGHT, height);
294 return false;
295 }
296
297 std::pair<uint256, DBVal> value;
298 if (!db_it.GetValue(value)) {
299 LogError("%s: unable to read value in %s at key (%c, %d)\n",
300 __func__, index_name, DB_BLOCK_HEIGHT, height);
301 return false;
302 }
303
304 batch.Write(DBHashKey(value.first), std::move(value.second));
305 return true;
306}
307
309{
310 CDBBatch batch(*m_db);
311 std::unique_ptr<CDBIterator> db_it(m_db->NewIterator());
312
313 // During a reorg, we need to copy block filter that is getting disconnected from the
314 // height index to the hash index so we can still find it when the height index entry
315 // is overwritten.
316 if (!CopyHeightIndexToHashIndex(*db_it, batch, m_name, block.height)) {
317 return false;
318 }
319
320 // The latest filter position gets written in Commit by the call to the BaseIndex::Rewind.
321 // But since this creates new references to the filter, the position should get updated here
322 // atomically as well in case Commit fails.
324 if (!m_db->WriteBatch(batch)) return false;
325
326 // Update cached header to the previous block hash
328 return true;
329}
330
331static bool LookupOne(const CDBWrapper& db, const CBlockIndex* block_index, DBVal& result)
332{
333 // First check if the result is stored under the height index and the value there matches the
334 // block hash. This should be the case if the block is on the active chain.
335 std::pair<uint256, DBVal> read_out;
336 if (!db.Read(DBHeightKey(block_index->nHeight), read_out)) {
337 return false;
338 }
339 if (read_out.first == block_index->GetBlockHash()) {
340 result = std::move(read_out.second);
341 return true;
342 }
343
344 // If value at the height index corresponds to an different block, the result will be stored in
345 // the hash index.
346 return db.Read(DBHashKey(block_index->GetBlockHash()), result);
347}
348
349static bool LookupRange(CDBWrapper& db, const std::string& index_name, int start_height,
350 const CBlockIndex* stop_index, std::vector<DBVal>& results)
351{
352 if (start_height < 0) {
353 LogError("%s: start height (%d) is negative\n", __func__, start_height);
354 return false;
355 }
356 if (start_height > stop_index->nHeight) {
357 LogError("%s: start height (%d) is greater than stop height (%d)\n",
358 __func__, start_height, stop_index->nHeight);
359 return false;
360 }
361
362 size_t results_size = static_cast<size_t>(stop_index->nHeight - start_height + 1);
363 std::vector<std::pair<uint256, DBVal>> values(results_size);
364
365 DBHeightKey key(start_height);
366 std::unique_ptr<CDBIterator> db_it(db.NewIterator());
367 db_it->Seek(DBHeightKey(start_height));
368 for (int height = start_height; height <= stop_index->nHeight; ++height) {
369 if (!db_it->Valid() || !db_it->GetKey(key) || key.height != height) {
370 return false;
371 }
372
373 size_t i = static_cast<size_t>(height - start_height);
374 if (!db_it->GetValue(values[i])) {
375 LogError("%s: unable to read value in %s at key (%c, %d)\n",
376 __func__, index_name, DB_BLOCK_HEIGHT, height);
377 return false;
378 }
379
380 db_it->Next();
381 }
382
383 results.resize(results_size);
384
385 // Iterate backwards through block indexes collecting results in order to access the block hash
386 // of each entry in case we need to look it up in the hash index.
387 for (const CBlockIndex* block_index = stop_index;
388 block_index && block_index->nHeight >= start_height;
389 block_index = block_index->pprev) {
390 uint256 block_hash = block_index->GetBlockHash();
391
392 size_t i = static_cast<size_t>(block_index->nHeight - start_height);
393 if (block_hash == values[i].first) {
394 results[i] = std::move(values[i].second);
395 continue;
396 }
397
398 if (!db.Read(DBHashKey(block_hash), results[i])) {
399 LogError("%s: unable to read value in %s at key (%c, %s)\n",
400 __func__, index_name, DB_BLOCK_HASH, block_hash.ToString());
401 return false;
402 }
403 }
404
405 return true;
406}
407
408bool BlockFilterIndex::LookupFilter(const CBlockIndex* block_index, BlockFilter& filter_out) const
409{
410 DBVal entry;
411 if (!LookupOne(*m_db, block_index, entry)) {
412 return false;
413 }
414
415 return ReadFilterFromDisk(entry.pos, entry.hash, filter_out);
416}
417
418bool BlockFilterIndex::LookupFilterHeader(const CBlockIndex* block_index, uint256& header_out)
419{
421
422 bool is_checkpoint{block_index->nHeight % CFCHECKPT_INTERVAL == 0};
423
424 if (is_checkpoint) {
425 // Try to find the block in the headers cache if this is a checkpoint height.
426 auto header = m_headers_cache.find(block_index->GetBlockHash());
427 if (header != m_headers_cache.end()) {
428 header_out = header->second;
429 return true;
430 }
431 }
432
433 DBVal entry;
434 if (!LookupOne(*m_db, block_index, entry)) {
435 return false;
436 }
437
438 if (is_checkpoint &&
439 m_headers_cache.size() < CF_HEADERS_CACHE_MAX_SZ) {
440 // Add to the headers cache if this is a checkpoint height.
441 m_headers_cache.emplace(block_index->GetBlockHash(), entry.header);
442 }
443
444 header_out = entry.header;
445 return true;
446}
447
448bool BlockFilterIndex::LookupFilterRange(int start_height, const CBlockIndex* stop_index,
449 std::vector<BlockFilter>& filters_out) const
450{
451 std::vector<DBVal> entries;
452 if (!LookupRange(*m_db, m_name, start_height, stop_index, entries)) {
453 return false;
454 }
455
456 filters_out.resize(entries.size());
457 auto filter_pos_it = filters_out.begin();
458 for (const auto& entry : entries) {
459 if (!ReadFilterFromDisk(entry.pos, entry.hash, *filter_pos_it)) {
460 return false;
461 }
462 ++filter_pos_it;
463 }
464
465 return true;
466}
467
468bool BlockFilterIndex::LookupFilterHashRange(int start_height, const CBlockIndex* stop_index,
469 std::vector<uint256>& hashes_out) const
470
471{
472 std::vector<DBVal> entries;
473 if (!LookupRange(*m_db, m_name, start_height, stop_index, entries)) {
474 return false;
475 }
476
477 hashes_out.clear();
478 hashes_out.reserve(entries.size());
479 for (const auto& entry : entries) {
480 hashes_out.push_back(entry.hash);
481 }
482 return true;
483}
484
486{
487 auto it = g_filter_indexes.find(filter_type);
488 return it != g_filter_indexes.end() ? &it->second : nullptr;
489}
490
491void ForEachBlockFilterIndex(std::function<void (BlockFilterIndex&)> fn)
492{
493 for (auto& entry : g_filter_indexes) fn(entry.second);
494}
495
496bool InitBlockFilterIndex(std::function<std::unique_ptr<interfaces::Chain>()> make_chain, BlockFilterType filter_type,
497 size_t n_cache_size, bool f_memory, bool f_wipe)
498{
499 auto result = g_filter_indexes.emplace(std::piecewise_construct,
500 std::forward_as_tuple(filter_type),
501 std::forward_as_tuple(make_chain(), filter_type,
502 n_cache_size, f_memory, f_wipe));
503 return result.second;
504}
505
507{
508 return g_filter_indexes.erase(filter_type);
509}
510
512{
513 g_filter_indexes.clear();
514}
ArgsManager gArgs
Definition: args.cpp:42
const std::string & BlockFilterTypeName(BlockFilterType filter_type)
Get the human-readable name for a filter type.
BlockFilterType
Definition: blockfilter.h:93
constexpr unsigned int FLTR_FILE_CHUNK_SIZE
The pre-allocation chunk size for fltr?????.dat files.
bool DestroyBlockFilterIndex(BlockFilterType filter_type)
Destroy the block filter index with the given type.
void DestroyAllBlockFilterIndexes()
Destroy all open block filter indexes.
BlockFilterIndex * GetBlockFilterIndex(BlockFilterType filter_type)
Get a block filter index by type.
constexpr uint8_t DB_FILTER_POS
static bool LookupOne(const CDBWrapper &db, const CBlockIndex *block_index, DBVal &result)
constexpr unsigned int MAX_FLTR_FILE_SIZE
constexpr uint8_t DB_BLOCK_HASH
void ForEachBlockFilterIndex(std::function< void(BlockFilterIndex &)> fn)
Iterate over all running block filter indexes, invoking fn on each.
static bool CopyHeightIndexToHashIndex(CDBIterator &db_it, CDBBatch &batch, const std::string &index_name, int height)
constexpr size_t CF_HEADERS_CACHE_MAX_SZ
Maximum size of the cfheaders cache We have a limit to prevent a bug in filling this cache potentiall...
bool InitBlockFilterIndex(std::function< std::unique_ptr< interfaces::Chain >()> make_chain, BlockFilterType filter_type, size_t n_cache_size, bool f_memory, bool f_wipe)
Initialize a block filter index for the given type if one does not already exist.
static bool LookupRange(CDBWrapper &db, const std::string &index_name, int start_height, const CBlockIndex *stop_index, std::vector< DBVal > &results)
constexpr uint8_t DB_BLOCK_HEIGHT
static std::map< BlockFilterType, BlockFilterIndex > g_filter_indexes
static constexpr int CFCHECKPT_INTERVAL
Interval between compact filter checkpoints.
#define Assert(val)
Identity function.
Definition: check.h:106
fs::path GetDataDirNet() const
Get data directory path with appended network identifier.
Definition: args.h:234
Non-refcounted RAII wrapper for FILE*.
Definition: streams.h:393
Base class for indices of blockchain data.
Definition: base.h:43
const std::string & GetName() const LIFETIMEBOUND
Get the name of the index for display in logs.
Definition: base.h:139
const std::string m_name
Definition: base.h:106
Complete block filter struct as defined in BIP 157.
Definition: blockfilter.h:115
const uint256 & GetBlockHash() const LIFETIMEBOUND
Definition: blockfilter.h:135
const std::vector< unsigned char > & GetEncodedFilter() const LIFETIMEBOUND
Definition: blockfilter.h:138
uint256 ComputeHeader(const uint256 &prev_header) const
Compute the filter header given the previous one.
BlockFilterType GetFilterType() const
Definition: blockfilter.h:134
uint256 GetHash() const
Compute the filter hash.
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 CustomInit(const std::optional< interfaces::BlockRef > &block) override
Initialize internal state from the database and block index.
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.
BlockFilterType GetFilterType() const
bool CustomRemove(const interfaces::BlockInfo &block) override
Rewind index by one block during a chain reorg.
bool CustomCommit(CDBBatch &batch) override
Virtual method called internally by Commit that can be overridden to atomically commit more index sta...
BlockFilterType m_filter_type
BlockFilterIndex(std::unique_ptr< interfaces::Chain > chain, 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.
interfaces::Chain::NotifyOptions CustomOptions() override
Return custom notification options for index.
std::unique_ptr< FlatFileSeq > m_filter_fileseq
bool LookupFilter(const CBlockIndex *block_index, BlockFilter &filter_out) const
Get a single filter by block.
bool ReadFilterFromDisk(const FlatFilePos &pos, const uint256 &hash, BlockFilter &filter) const
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.
bool CustomAppend(const interfaces::BlockInfo &block) override
Write update index entries for a newly connected block.
size_t WriteFilterToDisk(FlatFilePos &pos, const BlockFilter &filter)
bool LookupFilterHeader(const CBlockIndex *block_index, uint256 &header_out) EXCLUSIVE_LOCKS_REQUIRED(!m_cs_headers_cache)
Get a single filter header by block.
std::optional< uint256 > ReadFilterHeader(int height, const uint256 &expected_block_hash)
bool Write(const BlockFilter &filter, uint32_t block_height, const uint256 &filter_header)
FlatFilePos m_next_filter_pos
The block chain is a tree shaped structure starting with the genesis block at the root,...
Definition: chain.h:141
uint256 GetBlockHash() const
Definition: chain.h:243
int nHeight
height of the entry in the chain. The genesis block has height 0
Definition: chain.h:153
Batch of changes queued to be written to a CDBWrapper.
Definition: dbwrapper.h:74
void Write(const K &key, const V &value)
Definition: dbwrapper.h:98
bool GetValue(V &value)
Definition: dbwrapper.h:166
bool GetKey(K &key)
Definition: dbwrapper.h:156
void Seek(const K &key)
Definition: dbwrapper.h:147
bool Read(const K &key, V &value) const
Definition: dbwrapper.h:220
CDBIterator * NewIterator()
Definition: dbwrapper.cpp:387
std::string ToString() const
Definition: uint256.cpp:21
256-bit opaque blob.
Definition: uint256.h:196
static path u8path(const std::string &utf8_str)
Definition: fs.h:75
static bool create_directories(const std::filesystem::path &p)
Create directory (and if necessary its parents), unless the leaf directory already exists or is a sym...
Definition: fs.h:190
uint256 Hash(const T &in1)
Compute the 256-bit hash of an object.
Definition: hash.h:75
#define LogError(...)
Definition: logging.h:263
#define LogPrintf(...)
Definition: logging.h:266
const char * prefix
Definition: rest.cpp:1009
static const int64_t values[]
A selection of numbers that do not trigger int64_t overflow when added/subtracted.
size_t GetSerializeSize(const T &t)
Definition: serialize.h:1105
void Serialize(Stream &, V)=delete
uint8_t ser_readdata8(Stream &s)
Definition: serialize.h:83
void ser_writedata32be(Stream &s, uint32_t obj)
Definition: serialize.h:73
#define SERIALIZE_METHODS(cls, obj)
Implement the Serialize and Unserialize methods by delegating to a single templated static method tha...
Definition: serialize.h:240
void Unserialize(Stream &, V)=delete
void ser_writedata8(Stream &s, uint8_t obj)
Definition: serialize.h:54
uint32_t ser_readdata32be(Stream &s)
Definition: serialize.h:107
#define READWRITE(...)
Definition: serialize.h:156
int nFile
Definition: flatfile.h:16
unsigned int nPos
Definition: flatfile.h:17
Block data sent with blockConnected, blockDisconnected notifications.
Definition: chain.h:79
const uint256 * prev_hash
Definition: chain.h:81
const CBlock * data
Definition: chain.h:85
const CBlockUndo * undo_data
Definition: chain.h:86
Options specifying which chain notifications are required.
Definition: chain.h:332
bool connect_undo_data
Include undo data with block connected notifications.
Definition: chain.h:334
#define LOCK(cs)
Definition: sync.h:257
assert(!tx.IsCoinBase())