Branch data Line data Source code
1 : : // Copyright (c) 2022-present 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 <chain.h>
6 : : #include <chainparams.h>
7 : : #include <clientversion.h>
8 : : #include <node/blockstorage.h>
9 : : #include <node/context.h>
10 : : #include <node/kernel_notifications.h>
11 : : #include <script/solver.h>
12 : : #include <primitives/block.h>
13 : : #include <util/chaintype.h>
14 : : #include <validation.h>
15 : :
16 : : #include <boost/test/unit_test.hpp>
17 : : #include <test/util/logging.h>
18 : : #include <test/util/setup_common.h>
19 : :
20 : : using kernel::CBlockFileInfo;
21 : : using node::STORAGE_HEADER_BYTES;
22 : : using node::BlockManager;
23 : : using node::KernelNotifications;
24 : : using node::MAX_BLOCKFILE_SIZE;
25 : :
26 : : // use BasicTestingSetup here for the data directory configuration, setup, and cleanup
27 : : BOOST_FIXTURE_TEST_SUITE(blockmanager_tests, BasicTestingSetup)
28 : :
29 [ + - + - : 7 : BOOST_AUTO_TEST_CASE(blockmanager_find_block_pos)
+ - + - -
+ + - + -
+ - + - +
- + - - +
+ - + - +
- + - + -
+ - - + +
- + - + -
+ - + - +
- + - - +
+ - + - +
- + - + -
+ - - + +
- ]
30 : : {
31 [ + - ]: 1 : const auto params {CreateChainParams(ArgsManager{}, ChainType::MAIN)};
32 [ - + - + ]: 1 : KernelNotifications notifications{Assert(m_node.shutdown_request), m_node.exit_status, *Assert(m_node.warnings)};
33 [ + - ]: 1 : const BlockManager::Options blockman_opts{
34 : 1 : .chainparams = *params,
35 : : .blocks_dir = m_args.GetBlocksDirPath(),
36 : : .notifications = notifications,
37 : : .block_tree_db_params = DBParams{
38 [ + - + - ]: 3 : .path = m_args.GetDataDirNet() / "blocks" / "index",
39 : : .cache_bytes = 0,
40 : : },
41 [ + - + - ]: 2 : };
42 [ - + + - : 1 : BlockManager blockman{*Assert(m_node.shutdown_signal), blockman_opts};
+ - ]
43 : : // simulate adding a genesis block normally
44 [ + - + - : 1 : BOOST_CHECK_EQUAL(blockman.WriteBlock(params->GenesisBlock(), 0).nPos, STORAGE_HEADER_BYTES);
+ - ]
45 : : // simulate what happens during reindex
46 : : // simulate a well-formed genesis block being found at offset 8 in the blk00000.dat file
47 : : // the block is found at offset 8 because there is an 8 byte serialization header
48 : : // consisting of 4 magic bytes + 4 length bytes before each block in a well-formed blk file.
49 [ + - ]: 1 : const FlatFilePos pos{0, STORAGE_HEADER_BYTES};
50 [ + - ]: 1 : blockman.UpdateBlockInfo(params->GenesisBlock(), 0, pos);
51 : : // now simulate what happens after reindex for the first new block processed
52 : : // the actual block contents don't matter, just that it's a block.
53 : : // verify that the write position is at offset 0x12d.
54 : : // this is a check to make sure that https://github.com/bitcoin/bitcoin/issues/21379 does not recur
55 : : // 8 bytes (for serialization header) + 285 (for serialized genesis block) = 293
56 : : // add another 8 bytes for the second block's serialization header and we get 293 + 8 = 301
57 [ + - ]: 1 : FlatFilePos actual{blockman.WriteBlock(params->GenesisBlock(), 1)};
58 [ + - + - ]: 1 : BOOST_CHECK_EQUAL(actual.nPos, STORAGE_HEADER_BYTES + ::GetSerializeSize(TX_WITH_WITNESS(params->GenesisBlock())) + STORAGE_HEADER_BYTES);
59 : 1 : }
60 : :
61 [ + - + - : 7 : BOOST_FIXTURE_TEST_CASE(blockmanager_scan_unlink_already_pruned_files, TestChain100Setup)
+ - + - -
+ + - + -
+ - + - +
- + - - +
+ - + - +
- + - + -
+ - - + +
- + - + -
+ - + - +
- + - - +
+ - + - +
- + - + -
+ - - + +
- ]
62 : : {
63 : : // Cap last block file size, and mine new block in a new block file.
64 [ - + ]: 1 : auto& chainman{*Assert(m_node.chainman)};
65 : 1 : auto& blockman{chainman.m_blockman};
66 [ + - - + : 4 : const CBlockIndex* old_tip{WITH_LOCK(chainman.GetMutex(), return chainman.ActiveChain().Tip())};
+ - ]
67 [ + - + - ]: 3 : WITH_LOCK(chainman.GetMutex(), blockman.GetBlockFileInfo(old_tip->GetBlockPos().nFile)->nSize = MAX_BLOCKFILE_SIZE);
68 [ + - ]: 2 : CreateAndProcessBlock({}, GetScriptForRawPubKey(coinbaseKey.GetPubKey()));
69 : :
70 : : // Prune the older block file, but don't unlink it
71 : 1 : int file_number;
72 : 1 : {
73 : 1 : LOCK(chainman.GetMutex());
74 : 1 : file_number = old_tip->GetBlockPos().nFile;
75 [ + - ]: 1 : blockman.PruneOneBlockFile(file_number);
76 : 0 : }
77 : :
78 : 1 : const FlatFilePos pos(file_number, 0);
79 : :
80 : : // Check that the file is not unlinked after ScanAndUnlinkAlreadyPrunedFiles
81 : : // if m_have_pruned is not yet set
82 [ + - ]: 3 : WITH_LOCK(chainman.GetMutex(), blockman.ScanAndUnlinkAlreadyPrunedFiles());
83 [ + - + - : 2 : BOOST_CHECK(!blockman.OpenBlockFile(pos, true).IsNull());
+ - ]
84 : :
85 : : // Check that the file is unlinked after ScanAndUnlinkAlreadyPrunedFiles
86 : : // once m_have_pruned is set
87 : 1 : blockman.m_have_pruned = true;
88 [ + - ]: 3 : WITH_LOCK(chainman.GetMutex(), blockman.ScanAndUnlinkAlreadyPrunedFiles());
89 [ + - + - ]: 2 : BOOST_CHECK(blockman.OpenBlockFile(pos, true).IsNull());
90 : :
91 : : // Check that calling with already pruned files doesn't cause an error
92 [ + - ]: 3 : WITH_LOCK(chainman.GetMutex(), blockman.ScanAndUnlinkAlreadyPrunedFiles());
93 : :
94 : : // Check that the new tip file has not been removed
95 [ + - - + : 4 : const CBlockIndex* new_tip{WITH_LOCK(chainman.GetMutex(), return chainman.ActiveChain().Tip())};
+ - ]
96 [ + - ]: 1 : BOOST_CHECK_NE(old_tip, new_tip);
97 [ + - ]: 2 : const int new_file_number{WITH_LOCK(chainman.GetMutex(), return new_tip->GetBlockPos().nFile)};
98 : 1 : const FlatFilePos new_pos(new_file_number, 0);
99 [ + - + - ]: 2 : BOOST_CHECK(!blockman.OpenBlockFile(new_pos, true).IsNull());
100 : 1 : }
101 : :
102 [ + - + - : 7 : BOOST_FIXTURE_TEST_CASE(blockmanager_block_data_availability, TestChain100Setup)
+ - + - -
+ + - + -
+ - + - +
- + - - +
+ - + - +
- + - + -
+ - - + +
- + - + -
+ - + - +
- + - - +
+ - + - +
- + - + -
+ - - + +
- ]
103 : : {
104 : : // The goal of the function is to return the first not pruned block in the range [upper_block, lower_block].
105 : 1 : LOCK(::cs_main);
106 : 1 : auto& chainman = m_node.chainman;
107 [ + - ]: 1 : auto& blockman = chainman->m_blockman;
108 [ + - ]: 1 : const CBlockIndex& tip = *chainman->ActiveTip();
109 : :
110 : : // Function to prune all blocks from 'last_pruned_block' down to the genesis block
111 : 2 : const auto& func_prune_blocks = [&](CBlockIndex* last_pruned_block)
112 : : {
113 : 1 : LOCK(::cs_main);
114 : 1 : CBlockIndex* it = last_pruned_block;
115 [ + + + - ]: 53 : while (it != nullptr && it->nStatus & BLOCK_HAVE_DATA) {
116 : 51 : it->nStatus &= ~BLOCK_HAVE_DATA;
117 : 51 : it = it->pprev;
118 : : }
119 : 1 : };
120 : :
121 : : // 1) Return genesis block when all blocks are available
122 [ + - + - : 2 : BOOST_CHECK_EQUAL(&blockman.GetFirstBlock(tip, BLOCK_HAVE_DATA), chainman->ActiveChain()[0]);
- + + - +
- ]
123 [ + - + - : 3 : BOOST_CHECK(blockman.CheckBlockDataAvailability(tip, *chainman->ActiveChain()[0]));
- + + - +
- + - ]
124 : :
125 : : // 2) Check lower_block when all blocks are available
126 [ + - + - ]: 1 : CBlockIndex* lower_block = chainman->ActiveChain()[tip.nHeight / 2];
127 [ + - + - : 2 : BOOST_CHECK(blockman.CheckBlockDataAvailability(tip, *lower_block));
+ - + - ]
128 : :
129 : : // Ensure we don't fail due to the expected absence of undo data in the genesis block
130 [ + - - + ]: 1 : CBlockIndex* upper_block = chainman->ActiveChain()[2];
131 [ + - - + ]: 1 : CBlockIndex* genesis = chainman->ActiveChain()[0];
132 [ + - + - : 2 : BOOST_CHECK(blockman.CheckBlockDataAvailability(*upper_block, *genesis, BlockStatus{BLOCK_HAVE_DATA | BLOCK_HAVE_UNDO}));
+ - + - ]
133 : : // Ensure we detect absence of undo data in the first block
134 [ + - - + ]: 1 : chainman->ActiveChain()[1]->nStatus &= ~BLOCK_HAVE_UNDO;
135 [ + - + - : 2 : BOOST_CHECK(!blockman.CheckBlockDataAvailability(tip, *genesis, BlockStatus{BLOCK_HAVE_DATA | BLOCK_HAVE_UNDO}));
+ - + - ]
136 : :
137 : : // Prune half of the blocks
138 : 1 : int height_to_prune = tip.nHeight / 2;
139 [ + - + - ]: 1 : CBlockIndex* first_available_block = chainman->ActiveChain()[height_to_prune + 1];
140 : 1 : CBlockIndex* last_pruned_block = first_available_block->pprev;
141 [ + - ]: 1 : func_prune_blocks(last_pruned_block);
142 : :
143 : : // 3) The last block not pruned is in-between upper-block and the genesis block
144 [ + - + - : 1 : BOOST_CHECK_EQUAL(&blockman.GetFirstBlock(tip, BLOCK_HAVE_DATA), first_available_block);
+ - ]
145 [ + - + - : 2 : BOOST_CHECK(blockman.CheckBlockDataAvailability(tip, *first_available_block));
+ - + - ]
146 [ + - + - : 2 : BOOST_CHECK(!blockman.CheckBlockDataAvailability(tip, *last_pruned_block));
+ - + - ]
147 : :
148 : : // Simulate that the first available block is missing undo data and
149 : : // detect this by using a status mask.
150 : 1 : first_available_block->nStatus &= ~BLOCK_HAVE_UNDO;
151 [ + - + - : 2 : BOOST_CHECK(!blockman.CheckBlockDataAvailability(tip, *first_available_block, BlockStatus{BLOCK_HAVE_DATA | BLOCK_HAVE_UNDO}));
+ - + - ]
152 [ + - + - : 2 : BOOST_CHECK(blockman.CheckBlockDataAvailability(tip, *first_available_block, BlockStatus{BLOCK_HAVE_DATA}));
+ - + - ]
153 : 1 : }
154 : :
155 [ + - + - : 7 : BOOST_FIXTURE_TEST_CASE(blockmanager_block_data_part, TestChain100Setup)
+ - + - -
+ + - + -
+ - + - +
- + - - +
+ - + - +
- + - + -
+ - - + +
- + - + -
+ - + - +
- + - - +
+ - + - +
- + - + -
+ - - + +
- ]
156 : : {
157 : 1 : LOCK(::cs_main);
158 : 1 : auto& chainman{m_node.chainman};
159 [ + - ]: 1 : auto& blockman{chainman->m_blockman};
160 [ + - ]: 1 : const CBlockIndex& tip{*chainman->ActiveTip()};
161 : 1 : const FlatFilePos tip_block_pos{tip.GetBlockPos()};
162 : :
163 [ + - ]: 1 : auto block{blockman.ReadRawBlock(tip_block_pos)};
164 [ + - + - : 2 : BOOST_REQUIRE(block);
+ - ]
165 [ + - - + : 1 : BOOST_REQUIRE_GE(block->size(), 200);
+ - ]
166 : :
167 : 8 : const auto expect_part{[&](size_t offset, size_t size) {
168 : 7 : auto res{blockman.ReadRawBlock(tip_block_pos, std::pair{offset, size})};
169 [ + - + - : 14 : BOOST_CHECK(res);
+ - ]
170 [ + - ]: 7 : const auto& part{res.value()};
171 [ + - + - : 14 : BOOST_CHECK_EQUAL_COLLECTIONS(part.begin(), part.end(), block->begin() + offset, block->begin() + offset + size);
+ - ]
172 : 8 : }};
173 : :
174 [ + - ]: 1 : expect_part(0, 20);
175 [ - + + - ]: 1 : expect_part(0, block->size() - 1);
176 [ - + + - ]: 1 : expect_part(0, block->size() - 10);
177 [ - + + - ]: 1 : expect_part(0, block->size());
178 [ - + + - ]: 1 : expect_part(1, block->size() - 1);
179 [ + - ]: 1 : expect_part(10, 20);
180 [ - + + - ]: 1 : expect_part(block->size() - 1, 1);
181 [ + - ]: 2 : }
182 : :
183 [ + - + - : 7 : BOOST_FIXTURE_TEST_CASE(blockmanager_block_data_part_error, TestChain100Setup)
+ - + - -
+ + - + -
+ - + - +
- + - - +
+ - + - +
- + - + -
+ - - + +
- + - + -
+ - + - +
- + - - +
+ - + - +
- + - + -
+ - - + +
- ]
184 : : {
185 : 1 : LOCK(::cs_main);
186 : 1 : auto& chainman{m_node.chainman};
187 [ + - ]: 1 : auto& blockman{chainman->m_blockman};
188 [ + - ]: 1 : const CBlockIndex& tip{*chainman->ActiveTip()};
189 : 1 : const FlatFilePos tip_block_pos{tip.GetBlockPos()};
190 : :
191 [ + - ]: 1 : auto block{blockman.ReadRawBlock(tip_block_pos)};
192 [ + - + - : 2 : BOOST_REQUIRE(block);
+ - ]
193 [ + - - + : 1 : BOOST_REQUIRE_GE(block->size(), 200);
+ - ]
194 : :
195 : 15 : const auto expect_part_error{[&](size_t offset, size_t size) {
196 : 14 : auto res{blockman.ReadRawBlock(tip_block_pos, std::pair{offset, size})};
197 [ + - + - : 28 : BOOST_CHECK(!res);
+ - ]
198 [ + - + - ]: 14 : BOOST_CHECK_EQUAL(res.error(), node::ReadRawError::BadPartRange);
199 : 15 : }};
200 : :
201 [ + - ]: 1 : expect_part_error(0, 0);
202 [ - + + - ]: 1 : expect_part_error(0, block->size() + 1);
203 [ + - ]: 1 : expect_part_error(0, std::numeric_limits<size_t>::max());
204 [ - + + - ]: 1 : expect_part_error(1, block->size());
205 [ - + + - ]: 1 : expect_part_error(2, block->size() - 1);
206 [ - + + - ]: 1 : expect_part_error(block->size() - 1, 2);
207 [ - + + - ]: 1 : expect_part_error(block->size() - 2, 3);
208 [ - + + - ]: 1 : expect_part_error(block->size() + 1, 0);
209 [ - + + - ]: 1 : expect_part_error(block->size() + 1, 1);
210 [ - + + - ]: 1 : expect_part_error(block->size() + 2, 2);
211 [ - + + - ]: 1 : expect_part_error(block->size(), 0);
212 [ - + + - ]: 1 : expect_part_error(block->size(), 1);
213 [ + - ]: 1 : expect_part_error(std::numeric_limits<size_t>::max(), 1);
214 [ + - ]: 1 : expect_part_error(std::numeric_limits<size_t>::max(), std::numeric_limits<size_t>::max());
215 [ + - ]: 2 : }
216 : :
217 [ + - + - : 7 : BOOST_FIXTURE_TEST_CASE(blockmanager_readblock_hash_mismatch, TestingSetup)
+ - + - -
+ + - + -
+ - + - +
- + - - +
+ - + - +
- + - + -
+ - - + +
- + - + -
+ - + - +
- + - - +
+ - + - +
- + - + -
+ - - + +
- ]
218 : : {
219 : 1 : CBlockIndex index;
220 : 1 : {
221 : 1 : LOCK(cs_main);
222 [ + - ]: 1 : const auto tip{m_node.chainman->ActiveTip()};
223 : 1 : index.nStatus = tip->nStatus;
224 : 1 : index.nDataPos = tip->nDataPos;
225 [ + - ]: 1 : index.phashBlock = &uint256::ONE; // mismatched block hash
226 : 0 : }
227 : :
228 [ + - + - ]: 2 : ASSERT_DEBUG_LOG("GetHash() doesn't match index");
229 : 1 : CBlock block;
230 [ + - + - : 2 : BOOST_CHECK(!m_node.chainman->m_blockman.ReadBlock(block, index));
+ - ]
231 : 1 : }
232 : :
233 [ + - + - : 7 : BOOST_AUTO_TEST_CASE(blockmanager_flush_block_file)
+ - + - -
+ + - + -
+ - + - +
- + - - +
+ - + - +
- + - + -
+ - - + +
- + - + -
+ - + - +
- + - - +
+ - + - +
- + - + -
+ - - + +
- ]
234 : : {
235 [ - + - + ]: 1 : KernelNotifications notifications{Assert(m_node.shutdown_request), m_node.exit_status, *Assert(m_node.warnings)};
236 : 1 : node::BlockManager::Options blockman_opts{
237 [ + - ]: 1 : .chainparams = Params(),
238 : : .blocks_dir = m_args.GetBlocksDirPath(),
239 : : .notifications = notifications,
240 : : .block_tree_db_params = DBParams{
241 [ + - + - ]: 3 : .path = m_args.GetDataDirNet() / "blocks" / "index",
242 : : .cache_bytes = 0,
243 : : },
244 [ + - + - ]: 2 : };
245 [ - + + - : 1 : BlockManager blockman{*Assert(m_node.shutdown_signal), blockman_opts};
+ - ]
246 : :
247 : : // Test blocks with no transactions, not even a coinbase
248 : 1 : CBlock block1;
249 : 1 : block1.nVersion = 1;
250 : 1 : CBlock block2;
251 : 1 : block2.nVersion = 2;
252 : 1 : CBlock block3;
253 : 1 : block3.nVersion = 3;
254 : :
255 : : // They are 80 bytes header + 1 byte 0x00 for vtx length
256 : 1 : constexpr int TEST_BLOCK_SIZE{81};
257 : :
258 : : // Blockstore is empty
259 [ + - + - : 1 : BOOST_CHECK_EQUAL(blockman.CalculateCurrentUsage(), 0);
+ - ]
260 : :
261 : : // Write the first block to a new location.
262 [ + - ]: 1 : FlatFilePos pos1{blockman.WriteBlock(block1, /*nHeight=*/1)};
263 : :
264 : : // Write second block
265 [ + - ]: 1 : FlatFilePos pos2{blockman.WriteBlock(block2, /*nHeight=*/2)};
266 : :
267 : : // Two blocks in the file
268 [ + - + - : 1 : BOOST_CHECK_EQUAL(blockman.CalculateCurrentUsage(), (TEST_BLOCK_SIZE + STORAGE_HEADER_BYTES) * 2);
+ - ]
269 : :
270 : : // First two blocks are written as expected
271 : : // Errors are expected because block data is junk, thrown AFTER successful read
272 : 1 : CBlock read_block;
273 [ + - + - ]: 1 : BOOST_CHECK_EQUAL(read_block.nVersion, 0);
274 : 1 : {
275 [ + - + - ]: 2 : ASSERT_DEBUG_LOG("Errors in block header");
276 [ + - + - : 2 : BOOST_CHECK(!blockman.ReadBlock(read_block, pos1, {}));
+ - + - ]
277 [ + - + - ]: 1 : BOOST_CHECK_EQUAL(read_block.nVersion, 1);
278 : 1 : }
279 : 1 : {
280 [ + - + - ]: 2 : ASSERT_DEBUG_LOG("Errors in block header");
281 [ + - + - : 2 : BOOST_CHECK(!blockman.ReadBlock(read_block, pos2, {}));
+ - + - ]
282 [ + - + - ]: 1 : BOOST_CHECK_EQUAL(read_block.nVersion, 2);
283 : 1 : }
284 : :
285 : : // During reindex, the flat file block storage will not be written to.
286 : : // UpdateBlockInfo will, however, update the blockfile metadata.
287 : : // Verify this behavior by attempting (and failing) to write block 3 data
288 : : // to block 2 location.
289 [ + - ]: 1 : CBlockFileInfo* block_data = blockman.GetBlockFileInfo(0);
290 [ + - + - ]: 1 : BOOST_CHECK_EQUAL(block_data->nBlocks, 2);
291 [ + - ]: 1 : blockman.UpdateBlockInfo(block3, /*nHeight=*/3, /*pos=*/pos2);
292 : : // Metadata is updated...
293 [ + - + - ]: 1 : BOOST_CHECK_EQUAL(block_data->nBlocks, 3);
294 : : // ...but there are still only two blocks in the file
295 [ + - + - : 1 : BOOST_CHECK_EQUAL(blockman.CalculateCurrentUsage(), (TEST_BLOCK_SIZE + STORAGE_HEADER_BYTES) * 2);
+ - ]
296 : :
297 : : // Block 2 was not overwritten:
298 [ + - + - : 2 : BOOST_CHECK(!blockman.ReadBlock(read_block, pos2, {}));
+ - + - ]
299 [ + - + - ]: 1 : BOOST_CHECK_EQUAL(read_block.nVersion, 2);
300 : 1 : }
301 : :
302 : : BOOST_AUTO_TEST_SUITE_END()
|