Bitcoin Core 28.99.0
P2P Digital Currency
p2p_headers_presync.cpp
Go to the documentation of this file.
1// Copyright (c) 2024-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 <arith_uint256.h>
6#include <blockencodings.h>
7#include <net.h>
8#include <net_processing.h>
9#include <netmessagemaker.h>
10#include <node/peerman_args.h>
11#include <pow.h>
13#include <test/fuzz/fuzz.h>
14#include <test/fuzz/util.h>
15#include <test/util/net.h>
16#include <test/util/script.h>
18#include <uint256.h>
19#include <validation.h>
20
21namespace {
22constexpr uint32_t FUZZ_MAX_HEADERS_RESULTS{16};
23
24class HeadersSyncSetup : public TestingSetup
25{
26 std::vector<CNode*> m_connections;
27
28public:
29 HeadersSyncSetup(const ChainType chain_type, TestOpts opts) : TestingSetup(chain_type, opts)
30 {
31 PeerManager::Options peerman_opts;
33 peerman_opts.max_headers_result = FUZZ_MAX_HEADERS_RESULTS;
36 *m_node.mempool, *m_node.warnings, peerman_opts);
37
38 CConnman::Options options;
39 options.m_msgproc = m_node.peerman.get();
40 m_node.connman->Init(options);
41 }
42
43 void ResetAndInitialize() EXCLUSIVE_LOCKS_REQUIRED(NetEventsInterface::g_msgproc_mutex);
44 void SendMessage(FuzzedDataProvider& fuzzed_data_provider, CSerializedNetMsg&& msg)
46};
47
48void HeadersSyncSetup::ResetAndInitialize()
49{
50 m_connections.clear();
51 auto& connman = static_cast<ConnmanTestMsg&>(*m_node.connman);
52 connman.StopNodes();
53
54 NodeId id{0};
55 std::vector<ConnectionType> conn_types = {
59 };
60
61 for (auto conn_type : conn_types) {
62 CAddress addr{};
63 m_connections.push_back(new CNode(id++, nullptr, addr, 0, 0, addr, "", conn_type, false));
64 CNode& p2p_node = *m_connections.back();
65
66 connman.Handshake(
67 /*node=*/p2p_node,
68 /*successfully_connected=*/true,
69 /*remote_services=*/ServiceFlags(NODE_NETWORK | NODE_WITNESS),
70 /*local_services=*/ServiceFlags(NODE_NETWORK | NODE_WITNESS),
71 /*version=*/PROTOCOL_VERSION,
72 /*relay_txs=*/true);
73
74 connman.AddTestNode(p2p_node);
75 }
76}
77
78void HeadersSyncSetup::SendMessage(FuzzedDataProvider& fuzzed_data_provider, CSerializedNetMsg&& msg)
79{
80 auto& connman = static_cast<ConnmanTestMsg&>(*m_node.connman);
81 CNode& connection = *PickValue(fuzzed_data_provider, m_connections);
82
83 connman.FlushSendBuffer(connection);
84 (void)connman.ReceiveMsgFrom(connection, std::move(msg));
85 connection.fPauseSend = false;
86 try {
87 connman.ProcessMessagesOnce(connection);
88 } catch (const std::ios_base::failure&) {
89 }
90 m_node.peerman->SendMessages(&connection);
91}
92
93CBlockHeader ConsumeHeader(FuzzedDataProvider& fuzzed_data_provider, const uint256& prev_hash, uint32_t prev_nbits)
94{
95 CBlockHeader header;
96 header.nNonce = 0;
97 // Either use the previous difficulty or let the fuzzer choose. The upper target in the
98 // range comes from the bits value of the genesis block, which is 0x1d00ffff. The lower
99 // target comes from the bits value of mainnet block 840000, which is 0x17034219.
100 // Calling lower_target.SetCompact(0x17034219) and upper_target.SetCompact(0x1d00ffff)
101 // should return the values below.
102 //
103 // RPC commands to verify:
104 // getblockheader 000000000019d6689c085ae165831e934ff763ae46a2a6c172b3f1b60a8ce26f
105 // getblockheader 0000000000000000000320283a032748cef8227873ff4872689bf23f1cda83a5
106 if (fuzzed_data_provider.ConsumeBool()) {
107 header.nBits = prev_nbits;
108 } else {
109 arith_uint256 lower_target = UintToArith256(uint256{"0000000000000000000342190000000000000000000000000000000000000000"});
110 arith_uint256 upper_target = UintToArith256(uint256{"00000000ffff0000000000000000000000000000000000000000000000000000"});
111 arith_uint256 target = ConsumeArithUInt256InRange(fuzzed_data_provider, lower_target, upper_target);
112 header.nBits = target.GetCompact();
113 }
114 header.nTime = ConsumeTime(fuzzed_data_provider);
115 header.hashPrevBlock = prev_hash;
116 header.nVersion = fuzzed_data_provider.ConsumeIntegral<int32_t>();
117 return header;
118}
119
120CBlock ConsumeBlock(FuzzedDataProvider& fuzzed_data_provider, const uint256& prev_hash, uint32_t prev_nbits)
121{
122 auto header = ConsumeHeader(fuzzed_data_provider, prev_hash, prev_nbits);
123 // In order to reach the headers acceptance logic, the block is
124 // constructed in a way that will pass the mutation checks.
125 CBlock block{header};
127 tx.vin.resize(1);
128 tx.vout.resize(1);
129 tx.vout[0].nValue = 0;
130 tx.vin[0].scriptSig.resize(2);
131 block.vtx.push_back(MakeTransactionRef(tx));
132 block.hashMerkleRoot = block.vtx[0]->GetHash();
133 return block;
134}
135
136void FinalizeHeader(CBlockHeader& header, const ChainstateManager& chainman)
137{
138 while (!CheckProofOfWork(header.GetHash(), header.nBits, chainman.GetParams().GetConsensus())) {
139 ++(header.nNonce);
140 }
141}
142
143// Global setup works for this test as state modification (specifically in the
144// block index) would indicate a bug.
145HeadersSyncSetup* g_testing_setup;
146
147void initialize()
148{
149 static auto setup = MakeNoLogFileContext<HeadersSyncSetup>(ChainType::MAIN, {.extra_args = {"-checkpoints=0"}});
150 g_testing_setup = setup.get();
151}
152} // namespace
153
154FUZZ_TARGET(p2p_headers_presync, .init = initialize)
155{
157 ChainstateManager& chainman = *g_testing_setup->m_node.chainman;
158
160
161 g_testing_setup->ResetAndInitialize();
162
163 FuzzedDataProvider fuzzed_data_provider{buffer.data(), buffer.size()};
164
165 CBlockHeader base{chainman.GetParams().GenesisBlock()};
166 SetMockTime(base.nTime);
167
168 // The chain is just a single block, so this is equal to 1
169 size_t original_index_size{WITH_LOCK(cs_main, return chainman.m_blockman.m_block_index.size())};
170 arith_uint256 total_work{WITH_LOCK(cs_main, return chainman.m_best_header->nChainWork)};
171
172 std::vector<CBlockHeader> all_headers;
173
174 LIMITED_WHILE(fuzzed_data_provider.ConsumeBool(), 100)
175 {
176 auto finalized_block = [&]() {
177 CBlock block = ConsumeBlock(fuzzed_data_provider, base.GetHash(), base.nBits);
178 FinalizeHeader(block, chainman);
179 return block;
180 };
181
182 // Send low-work headers, compact blocks, and blocks
183 CallOneOf(
184 fuzzed_data_provider,
186 // Send FUZZ_MAX_HEADERS_RESULTS headers
187 std::vector<CBlock> headers;
188 headers.resize(FUZZ_MAX_HEADERS_RESULTS);
189 for (CBlock& header : headers) {
190 header = ConsumeHeader(fuzzed_data_provider, base.GetHash(), base.nBits);
191 FinalizeHeader(header, chainman);
192 base = header;
193 }
194
195 all_headers.insert(all_headers.end(), headers.begin(), headers.end());
196
197 auto headers_msg = NetMsg::Make(NetMsgType::HEADERS, TX_WITH_WITNESS(headers));
198 g_testing_setup->SendMessage(fuzzed_data_provider, std::move(headers_msg));
199 },
201 // Send a compact block
202 auto block = finalized_block();
203 CBlockHeaderAndShortTxIDs cmpct_block{block, fuzzed_data_provider.ConsumeIntegral<uint64_t>()};
204
205 all_headers.push_back(block);
206
207 auto headers_msg = NetMsg::Make(NetMsgType::CMPCTBLOCK, TX_WITH_WITNESS(cmpct_block));
208 g_testing_setup->SendMessage(fuzzed_data_provider, std::move(headers_msg));
209 },
211 // Send a block
212 auto block = finalized_block();
213
214 all_headers.push_back(block);
215
216 auto headers_msg = NetMsg::Make(NetMsgType::BLOCK, TX_WITH_WITNESS(block));
217 g_testing_setup->SendMessage(fuzzed_data_provider, std::move(headers_msg));
218 });
219 }
220
221 // This is a conservative overestimate, as base is only moved forward when sending headers. In theory,
222 // the longest chain generated by this test is 1600 (FUZZ_MAX_HEADERS_RESULTS * 100) headers. In that case,
223 // this variable will accurately reflect the chain's total work.
224 total_work += CalculateClaimedHeadersWork(all_headers);
225
226 // This test should never create a chain with more work than MinimumChainWork.
227 assert(total_work < chainman.MinimumChainWork());
228
229 // The headers/blocks sent in this test should never be stored, as the chains don't have the work required
230 // to meet the anti-DoS work threshold. So, if at any point the block index grew in size, then there's a bug
231 // in the headers pre-sync logic.
232 assert(WITH_LOCK(cs_main, return chainman.m_blockman.m_block_index.size()) == original_index_size);
233
234 g_testing_setup->m_node.validation_signals->SyncWithValidationInterfaceQueue();
235}
arith_uint256 UintToArith256(const uint256 &a)
node::NodeContext m_node
Definition: bitcoin-gui.cpp:42
ChainType
Definition: chaintype.h:11
A CService with information about it as peer.
Definition: protocol.h:367
Nodes collect new transactions into a block, hash them into a hash tree, and scan through nonce value...
Definition: block.h:22
uint32_t nNonce
Definition: block.h:30
uint32_t nBits
Definition: block.h:29
uint32_t nTime
Definition: block.h:28
int32_t nVersion
Definition: block.h:25
uint256 hashPrevBlock
Definition: block.h:26
uint256 GetHash() const
Definition: block.cpp:11
Definition: block.h:69
const CBlock & GenesisBlock() const
Definition: chainparams.h:98
const Consensus::Params & GetConsensus() const
Definition: chainparams.h:93
void StopNodes()
Definition: net.cpp:3394
Information about a peer.
Definition: net.h:673
std::atomic_bool fPauseSend
Definition: net.h:737
Provides an interface for creating and interacting with one or two chainstates: an IBD chainstate gen...
Definition: validation.h:866
const CChainParams & GetParams() const
Definition: validation.h:976
const arith_uint256 & MinimumChainWork() const
Definition: validation.h:979
node::BlockManager m_blockman
A single BlockManager instance is shared across each constructed chainstate to avoid duplicating bloc...
Definition: validation.h:1007
Interface for message handling.
Definition: net.h:992
static Mutex g_msgproc_mutex
Mutex for anything that is only accessed via the msg processing thread.
Definition: net.h:995
static std::unique_ptr< PeerManager > make(CConnman &connman, AddrMan &addrman, BanMan *banman, ChainstateManager &chainman, CTxMemPool &pool, node::Warnings &warnings, Options opts)
256-bit unsigned big integer.
256-bit opaque blob.
Definition: uint256.h:190
@ BLOCK_RELAY
We use block-relay-only connections to help prevent against partition attacks.
@ OUTBOUND_FULL_RELAY
These are the default connections that we use to connect with the network.
@ INBOUND
Inbound connections are those initiated by a peer.
RecursiveMutex cs_main
Mutex to guard access to validation specific variables, such as reading or changing the chainstate.
Definition: cs_main.cpp:8
void initialize()
Definition: fuzz.cpp:111
#define LIMITED_WHILE(condition, limit)
Can be used to limit a theoretically unbounded loop.
Definition: fuzz.h:22
CSerializedNetMsg Make(std::string msg_type, Args &&... args)
constexpr const char * HEADERS
The headers message sends one or more block headers to a node which previously requested certain head...
Definition: protocol.h:123
constexpr const char * CMPCTBLOCK
Contains a CBlockHeaderAndShortTxIDs object - providing a header and list of "short txids".
Definition: protocol.h:206
constexpr const char * BLOCK
The block message transmits a single serialized block.
Definition: protocol.h:127
util::Result< void > ApplyArgsManOptions(const ArgsManager &args, BlockManager::Options &opts)
int64_t NodeId
Definition: net.h:97
FUZZ_TARGET(p2p_headers_presync,.init=initialize)
bool CheckProofOfWork(uint256 hash, unsigned int nBits, const Consensus::Params &params)
Check whether a block hash satisfies the proof-of-work requirement specified by nBits.
Definition: pow.cpp:140
static constexpr TransactionSerParams TX_WITH_WITNESS
Definition: transaction.h:195
static CTransactionRef MakeTransactionRef(Tx &&txIn)
Definition: transaction.h:424
ServiceFlags
nServices flags
Definition: protocol.h:309
@ NODE_WITNESS
Definition: protocol.h:320
@ NODE_NETWORK
Definition: protocol.h:315
static const int PROTOCOL_VERSION
network protocol versioning
NetEventsInterface * m_msgproc
Definition: net.h:1044
A mutable version of CTransaction.
Definition: transaction.h:378
std::vector< CTxOut > vout
Definition: transaction.h:380
std::vector< CTxIn > vin
Definition: transaction.h:379
uint32_t max_headers_result
Number of headers sent in one getheaders message result (this is a test-only option).
Testing setup that configures a complete environment.
Definition: setup_common.h:120
std::unique_ptr< CConnman > connman
Definition: context.h:67
std::unique_ptr< CTxMemPool > mempool
Definition: context.h:68
std::unique_ptr< BanMan > banman
Definition: context.h:73
std::unique_ptr< AddrMan > addrman
Definition: context.h:66
std::unique_ptr< ChainstateManager > chainman
Definition: context.h:72
std::unique_ptr< node::Warnings > warnings
Manages all the node warnings.
Definition: context.h:91
std::unique_ptr< PeerManager > peerman
Definition: context.h:71
ArgsManager * args
Definition: context.h:74
#define LOCK(cs)
Definition: sync.h:257
#define WITH_LOCK(cs, code)
Run code while locking a mutex.
Definition: sync.h:301
int64_t ConsumeTime(FuzzedDataProvider &fuzzed_data_provider, const std::optional< int64_t > &min, const std::optional< int64_t > &max) noexcept
Definition: util.cpp:34
auto & PickValue(FuzzedDataProvider &fuzzed_data_provider, Collection &col)
Definition: util.h:47
size_t CallOneOf(FuzzedDataProvider &fuzzed_data_provider, Callables... callables)
Definition: util.h:35
arith_uint256 ConsumeArithUInt256InRange(FuzzedDataProvider &fuzzed_data_provider, const arith_uint256 &min, const arith_uint256 &max) noexcept
Definition: util.h:185
void SeedRandomStateForTest(SeedRand seedtype)
Seed the global RNG state for testing and log the seed value.
Definition: random.cpp:19
@ ZEROS
Seed with a compile time constant of zeros.
#define EXCLUSIVE_LOCKS_REQUIRED(...)
Definition: threadsafety.h:49
#define NO_THREAD_SAFETY_ANALYSIS
Definition: threadsafety.h:51
void SetMockTime(int64_t nMockTimeIn)
DEPRECATED Use SetMockTime with chrono type.
Definition: time.cpp:35
arith_uint256 CalculateClaimedHeadersWork(std::span< const CBlockHeader > headers)
Return the sum of the claimed work on a given set of headers.
assert(!tx.IsCoinBase())