Bitcoin Core  27.99.0
P2P Digital Currency
net_tests.cpp
Go to the documentation of this file.
1 // Copyright (c) 2012-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 <chainparams.h>
6 #include <clientversion.h>
7 #include <common/args.h>
8 #include <compat/compat.h>
9 #include <cstdint>
10 #include <net.h>
11 #include <net_processing.h>
12 #include <netaddress.h>
13 #include <netbase.h>
14 #include <netmessagemaker.h>
15 #include <node/protocol_version.h>
16 #include <serialize.h>
17 #include <span.h>
18 #include <streams.h>
19 #include <test/util/random.h>
20 #include <test/util/setup_common.h>
21 #include <test/util/validation.h>
22 #include <util/strencodings.h>
23 #include <util/string.h>
24 #include <validation.h>
25 
26 #include <boost/test/unit_test.hpp>
27 
28 #include <algorithm>
29 #include <ios>
30 #include <memory>
31 #include <optional>
32 #include <string>
33 
34 using namespace std::literals;
35 
36 BOOST_FIXTURE_TEST_SUITE(net_tests, RegTestingSetup)
37 
38 BOOST_AUTO_TEST_CASE(cnode_listen_port)
39 {
40  // test default
41  uint16_t port{GetListenPort()};
42  BOOST_CHECK(port == Params().GetDefaultPort());
43  // test set port
44  uint16_t altPort = 12345;
45  BOOST_CHECK(gArgs.SoftSetArg("-port", ToString(altPort)));
46  port = GetListenPort();
47  BOOST_CHECK(port == altPort);
48 }
49 
50 BOOST_AUTO_TEST_CASE(cnode_simple_test)
51 {
52  NodeId id = 0;
53 
54  in_addr ipv4Addr;
55  ipv4Addr.s_addr = 0xa0b0c001;
56 
57  CAddress addr = CAddress(CService(ipv4Addr, 7777), NODE_NETWORK);
58  std::string pszDest;
59 
60  std::unique_ptr<CNode> pnode1 = std::make_unique<CNode>(id++,
61  /*sock=*/nullptr,
62  addr,
63  /*nKeyedNetGroupIn=*/0,
64  /*nLocalHostNonceIn=*/0,
65  CAddress(),
66  pszDest,
68  /*inbound_onion=*/false);
69  BOOST_CHECK(pnode1->IsFullOutboundConn() == true);
70  BOOST_CHECK(pnode1->IsManualConn() == false);
71  BOOST_CHECK(pnode1->IsBlockOnlyConn() == false);
72  BOOST_CHECK(pnode1->IsFeelerConn() == false);
73  BOOST_CHECK(pnode1->IsAddrFetchConn() == false);
74  BOOST_CHECK(pnode1->IsInboundConn() == false);
75  BOOST_CHECK(pnode1->m_inbound_onion == false);
76  BOOST_CHECK_EQUAL(pnode1->ConnectedThroughNetwork(), Network::NET_IPV4);
77 
78  std::unique_ptr<CNode> pnode2 = std::make_unique<CNode>(id++,
79  /*sock=*/nullptr,
80  addr,
81  /*nKeyedNetGroupIn=*/1,
82  /*nLocalHostNonceIn=*/1,
83  CAddress(),
84  pszDest,
86  /*inbound_onion=*/false);
87  BOOST_CHECK(pnode2->IsFullOutboundConn() == false);
88  BOOST_CHECK(pnode2->IsManualConn() == false);
89  BOOST_CHECK(pnode2->IsBlockOnlyConn() == false);
90  BOOST_CHECK(pnode2->IsFeelerConn() == false);
91  BOOST_CHECK(pnode2->IsAddrFetchConn() == false);
92  BOOST_CHECK(pnode2->IsInboundConn() == true);
93  BOOST_CHECK(pnode2->m_inbound_onion == false);
94  BOOST_CHECK_EQUAL(pnode2->ConnectedThroughNetwork(), Network::NET_IPV4);
95 
96  std::unique_ptr<CNode> pnode3 = std::make_unique<CNode>(id++,
97  /*sock=*/nullptr,
98  addr,
99  /*nKeyedNetGroupIn=*/0,
100  /*nLocalHostNonceIn=*/0,
101  CAddress(),
102  pszDest,
104  /*inbound_onion=*/false);
105  BOOST_CHECK(pnode3->IsFullOutboundConn() == true);
106  BOOST_CHECK(pnode3->IsManualConn() == false);
107  BOOST_CHECK(pnode3->IsBlockOnlyConn() == false);
108  BOOST_CHECK(pnode3->IsFeelerConn() == false);
109  BOOST_CHECK(pnode3->IsAddrFetchConn() == false);
110  BOOST_CHECK(pnode3->IsInboundConn() == false);
111  BOOST_CHECK(pnode3->m_inbound_onion == false);
112  BOOST_CHECK_EQUAL(pnode3->ConnectedThroughNetwork(), Network::NET_IPV4);
113 
114  std::unique_ptr<CNode> pnode4 = std::make_unique<CNode>(id++,
115  /*sock=*/nullptr,
116  addr,
117  /*nKeyedNetGroupIn=*/1,
118  /*nLocalHostNonceIn=*/1,
119  CAddress(),
120  pszDest,
122  /*inbound_onion=*/true);
123  BOOST_CHECK(pnode4->IsFullOutboundConn() == false);
124  BOOST_CHECK(pnode4->IsManualConn() == false);
125  BOOST_CHECK(pnode4->IsBlockOnlyConn() == false);
126  BOOST_CHECK(pnode4->IsFeelerConn() == false);
127  BOOST_CHECK(pnode4->IsAddrFetchConn() == false);
128  BOOST_CHECK(pnode4->IsInboundConn() == true);
129  BOOST_CHECK(pnode4->m_inbound_onion == true);
130  BOOST_CHECK_EQUAL(pnode4->ConnectedThroughNetwork(), Network::NET_ONION);
131 }
132 
133 BOOST_AUTO_TEST_CASE(cnetaddr_basic)
134 {
135  CNetAddr addr;
136 
137  // IPv4, INADDR_ANY
138  addr = LookupHost("0.0.0.0", false).value();
139  BOOST_REQUIRE(!addr.IsValid());
140  BOOST_REQUIRE(addr.IsIPv4());
141 
142  BOOST_CHECK(addr.IsBindAny());
144  BOOST_CHECK_EQUAL(addr.ToStringAddr(), "0.0.0.0");
145 
146  // IPv4, INADDR_NONE
147  addr = LookupHost("255.255.255.255", false).value();
148  BOOST_REQUIRE(!addr.IsValid());
149  BOOST_REQUIRE(addr.IsIPv4());
150 
151  BOOST_CHECK(!addr.IsBindAny());
153  BOOST_CHECK_EQUAL(addr.ToStringAddr(), "255.255.255.255");
154 
155  // IPv4, casual
156  addr = LookupHost("12.34.56.78", false).value();
157  BOOST_REQUIRE(addr.IsValid());
158  BOOST_REQUIRE(addr.IsIPv4());
159 
160  BOOST_CHECK(!addr.IsBindAny());
162  BOOST_CHECK_EQUAL(addr.ToStringAddr(), "12.34.56.78");
163 
164  // IPv6, in6addr_any
165  addr = LookupHost("::", false).value();
166  BOOST_REQUIRE(!addr.IsValid());
167  BOOST_REQUIRE(addr.IsIPv6());
168 
169  BOOST_CHECK(addr.IsBindAny());
171  BOOST_CHECK_EQUAL(addr.ToStringAddr(), "::");
172 
173  // IPv6, casual
174  addr = LookupHost("1122:3344:5566:7788:9900:aabb:ccdd:eeff", false).value();
175  BOOST_REQUIRE(addr.IsValid());
176  BOOST_REQUIRE(addr.IsIPv6());
177 
178  BOOST_CHECK(!addr.IsBindAny());
180  BOOST_CHECK_EQUAL(addr.ToStringAddr(), "1122:3344:5566:7788:9900:aabb:ccdd:eeff");
181 
182  // IPv6, scoped/link-local. See https://tools.ietf.org/html/rfc4007
183  // We support non-negative decimal integers (uint32_t) as zone id indices.
184  // Normal link-local scoped address functionality is to append "%" plus the
185  // zone id, for example, given a link-local address of "fe80::1" and a zone
186  // id of "32", return the address as "fe80::1%32".
187  const std::string link_local{"fe80::1"};
188  const std::string scoped_addr{link_local + "%32"};
189  addr = LookupHost(scoped_addr, false).value();
190  BOOST_REQUIRE(addr.IsValid());
191  BOOST_REQUIRE(addr.IsIPv6());
192  BOOST_CHECK(!addr.IsBindAny());
193  BOOST_CHECK_EQUAL(addr.ToStringAddr(), scoped_addr);
194 
195  // Test that the delimiter "%" and default zone id of 0 can be omitted for the default scope.
196  addr = LookupHost(link_local + "%0", false).value();
197  BOOST_REQUIRE(addr.IsValid());
198  BOOST_REQUIRE(addr.IsIPv6());
199  BOOST_CHECK(!addr.IsBindAny());
200  BOOST_CHECK_EQUAL(addr.ToStringAddr(), link_local);
201 
202  // TORv2, no longer supported
203  BOOST_CHECK(!addr.SetSpecial("6hzph5hv6337r6p2.onion"));
204 
205  // TORv3
206  const char* torv3_addr = "pg6mmjiyjmcrsslvykfwnntlaru7p5svn6y2ymmju6nubxndf4pscryd.onion";
207  BOOST_REQUIRE(addr.SetSpecial(torv3_addr));
208  BOOST_REQUIRE(addr.IsValid());
209  BOOST_REQUIRE(addr.IsTor());
210 
211  BOOST_CHECK(!addr.IsI2P());
212  BOOST_CHECK(!addr.IsBindAny());
214  BOOST_CHECK_EQUAL(addr.ToStringAddr(), torv3_addr);
215 
216  // TORv3, broken, with wrong checksum
217  BOOST_CHECK(!addr.SetSpecial("pg6mmjiyjmcrsslvykfwnntlaru7p5svn6y2ymmju6nubxndf4pscsad.onion"));
218 
219  // TORv3, broken, with wrong version
220  BOOST_CHECK(!addr.SetSpecial("pg6mmjiyjmcrsslvykfwnntlaru7p5svn6y2ymmju6nubxndf4pscrye.onion"));
221 
222  // TORv3, malicious
223  BOOST_CHECK(!addr.SetSpecial(std::string{
224  "pg6mmjiyjmcrsslvykfwnntlaru7p5svn6y2ymmju6nubxndf4pscryd\0wtf.onion", 66}));
225 
226  // TOR, bogus length
227  BOOST_CHECK(!addr.SetSpecial(std::string{"mfrggzak.onion"}));
228 
229  // TOR, invalid base32
230  BOOST_CHECK(!addr.SetSpecial(std::string{"mf*g zak.onion"}));
231 
232  // I2P
233  const char* i2p_addr = "UDHDrtrcetjm5sxzskjyr5ztpeszydbh4dpl3pl4utgqqw2v4jna.b32.I2P";
234  BOOST_REQUIRE(addr.SetSpecial(i2p_addr));
235  BOOST_REQUIRE(addr.IsValid());
236  BOOST_REQUIRE(addr.IsI2P());
237 
238  BOOST_CHECK(!addr.IsTor());
239  BOOST_CHECK(!addr.IsBindAny());
241  BOOST_CHECK_EQUAL(addr.ToStringAddr(), ToLower(i2p_addr));
242 
243  // I2P, correct length, but decodes to less than the expected number of bytes.
244  BOOST_CHECK(!addr.SetSpecial("udhdrtrcetjm5sxzskjyr5ztpeszydbh4dpl3pl4utgqqw2v4jn=.b32.i2p"));
245 
246  // I2P, extra unnecessary padding
247  BOOST_CHECK(!addr.SetSpecial("udhdrtrcetjm5sxzskjyr5ztpeszydbh4dpl3pl4utgqqw2v4jna=.b32.i2p"));
248 
249  // I2P, malicious
250  BOOST_CHECK(!addr.SetSpecial("udhdrtrcetjm5sxzskjyr5ztpeszydbh4dpl3pl4utgqqw2v\0wtf.b32.i2p"s));
251 
252  // I2P, valid but unsupported (56 Base32 characters)
253  // See "Encrypted LS with Base 32 Addresses" in
254  // https://geti2p.net/spec/encryptedleaseset.txt
255  BOOST_CHECK(
256  !addr.SetSpecial("pg6mmjiyjmcrsslvykfwnntlaru7p5svn6y2ymmju6nubxndf4pscsad.b32.i2p"));
257 
258  // I2P, invalid base32
259  BOOST_CHECK(!addr.SetSpecial(std::string{"tp*szydbh4dp.b32.i2p"}));
260 
261  // Internal
262  addr.SetInternal("esffpp");
263  BOOST_REQUIRE(!addr.IsValid()); // "internal" is considered invalid
264  BOOST_REQUIRE(addr.IsInternal());
265 
266  BOOST_CHECK(!addr.IsBindAny());
268  BOOST_CHECK_EQUAL(addr.ToStringAddr(), "esffpvrt3wpeaygy.internal");
269 
270  // Totally bogus
271  BOOST_CHECK(!addr.SetSpecial("totally bogus"));
272 }
273 
274 BOOST_AUTO_TEST_CASE(cnetaddr_tostring_canonical_ipv6)
275 {
276  // Test that CNetAddr::ToString formats IPv6 addresses with zero compression as described in
277  // RFC 5952 ("A Recommendation for IPv6 Address Text Representation").
278  const std::map<std::string, std::string> canonical_representations_ipv6{
279  {"0000:0000:0000:0000:0000:0000:0000:0000", "::"},
280  {"000:0000:000:00:0:00:000:0000", "::"},
281  {"000:000:000:000:000:000:000:000", "::"},
282  {"00:00:00:00:00:00:00:00", "::"},
283  {"0:0:0:0:0:0:0:0", "::"},
284  {"0:0:0:0:0:0:0:1", "::1"},
285  {"2001:0:0:1:0:0:0:1", "2001:0:0:1::1"},
286  {"2001:0db8:0:0:1:0:0:1", "2001:db8::1:0:0:1"},
287  {"2001:0db8:85a3:0000:0000:8a2e:0370:7334", "2001:db8:85a3::8a2e:370:7334"},
288  {"2001:0db8::0001", "2001:db8::1"},
289  {"2001:0db8::0001:0000", "2001:db8::1:0"},
290  {"2001:0db8::1:0:0:1", "2001:db8::1:0:0:1"},
291  {"2001:db8:0000:0:1::1", "2001:db8::1:0:0:1"},
292  {"2001:db8:0000:1:1:1:1:1", "2001:db8:0:1:1:1:1:1"},
293  {"2001:db8:0:0:0:0:2:1", "2001:db8::2:1"},
294  {"2001:db8:0:0:0::1", "2001:db8::1"},
295  {"2001:db8:0:0:1:0:0:1", "2001:db8::1:0:0:1"},
296  {"2001:db8:0:0:1::1", "2001:db8::1:0:0:1"},
297  {"2001:DB8:0:0:1::1", "2001:db8::1:0:0:1"},
298  {"2001:db8:0:0::1", "2001:db8::1"},
299  {"2001:db8:0:0:aaaa::1", "2001:db8::aaaa:0:0:1"},
300  {"2001:db8:0:1:1:1:1:1", "2001:db8:0:1:1:1:1:1"},
301  {"2001:db8:0::1", "2001:db8::1"},
302  {"2001:db8:85a3:0:0:8a2e:370:7334", "2001:db8:85a3::8a2e:370:7334"},
303  {"2001:db8::0:1", "2001:db8::1"},
304  {"2001:db8::0:1:0:0:1", "2001:db8::1:0:0:1"},
305  {"2001:DB8::1", "2001:db8::1"},
306  {"2001:db8::1", "2001:db8::1"},
307  {"2001:db8::1:0:0:1", "2001:db8::1:0:0:1"},
308  {"2001:db8::1:1:1:1:1", "2001:db8:0:1:1:1:1:1"},
309  {"2001:db8::aaaa:0:0:1", "2001:db8::aaaa:0:0:1"},
310  {"2001:db8:aaaa:bbbb:cccc:dddd:0:1", "2001:db8:aaaa:bbbb:cccc:dddd:0:1"},
311  {"2001:db8:aaaa:bbbb:cccc:dddd::1", "2001:db8:aaaa:bbbb:cccc:dddd:0:1"},
312  {"2001:db8:aaaa:bbbb:cccc:dddd:eeee:0001", "2001:db8:aaaa:bbbb:cccc:dddd:eeee:1"},
313  {"2001:db8:aaaa:bbbb:cccc:dddd:eeee:001", "2001:db8:aaaa:bbbb:cccc:dddd:eeee:1"},
314  {"2001:db8:aaaa:bbbb:cccc:dddd:eeee:01", "2001:db8:aaaa:bbbb:cccc:dddd:eeee:1"},
315  {"2001:db8:aaaa:bbbb:cccc:dddd:eeee:1", "2001:db8:aaaa:bbbb:cccc:dddd:eeee:1"},
316  {"2001:db8:aaaa:bbbb:cccc:dddd:eeee:aaaa", "2001:db8:aaaa:bbbb:cccc:dddd:eeee:aaaa"},
317  {"2001:db8:aaaa:bbbb:cccc:dddd:eeee:AAAA", "2001:db8:aaaa:bbbb:cccc:dddd:eeee:aaaa"},
318  {"2001:db8:aaaa:bbbb:cccc:dddd:eeee:AaAa", "2001:db8:aaaa:bbbb:cccc:dddd:eeee:aaaa"},
319  };
320  for (const auto& [input_address, expected_canonical_representation_output] : canonical_representations_ipv6) {
321  const std::optional<CNetAddr> net_addr{LookupHost(input_address, false)};
322  BOOST_REQUIRE(net_addr.value().IsIPv6());
323  BOOST_CHECK_EQUAL(net_addr.value().ToStringAddr(), expected_canonical_representation_output);
324  }
325 }
326 
327 BOOST_AUTO_TEST_CASE(cnetaddr_serialize_v1)
328 {
329  CNetAddr addr;
330  DataStream s{};
331  const auto ser_params{CAddress::V1_NETWORK};
332 
333  s << ser_params(addr);
334  BOOST_CHECK_EQUAL(HexStr(s), "00000000000000000000000000000000");
335  s.clear();
336 
337  addr = LookupHost("1.2.3.4", false).value();
338  s << ser_params(addr);
339  BOOST_CHECK_EQUAL(HexStr(s), "00000000000000000000ffff01020304");
340  s.clear();
341 
342  addr = LookupHost("1a1b:2a2b:3a3b:4a4b:5a5b:6a6b:7a7b:8a8b", false).value();
343  s << ser_params(addr);
344  BOOST_CHECK_EQUAL(HexStr(s), "1a1b2a2b3a3b4a4b5a5b6a6b7a7b8a8b");
345  s.clear();
346 
347  // TORv2, no longer supported
348  BOOST_CHECK(!addr.SetSpecial("6hzph5hv6337r6p2.onion"));
349 
350  BOOST_REQUIRE(addr.SetSpecial("pg6mmjiyjmcrsslvykfwnntlaru7p5svn6y2ymmju6nubxndf4pscryd.onion"));
351  s << ser_params(addr);
352  BOOST_CHECK_EQUAL(HexStr(s), "00000000000000000000000000000000");
353  s.clear();
354 
355  addr.SetInternal("a");
356  s << ser_params(addr);
357  BOOST_CHECK_EQUAL(HexStr(s), "fd6b88c08724ca978112ca1bbdcafac2");
358  s.clear();
359 }
360 
361 BOOST_AUTO_TEST_CASE(cnetaddr_serialize_v2)
362 {
363  CNetAddr addr;
364  DataStream s{};
365  const auto ser_params{CAddress::V2_NETWORK};
366 
367  s << ser_params(addr);
368  BOOST_CHECK_EQUAL(HexStr(s), "021000000000000000000000000000000000");
369  s.clear();
370 
371  addr = LookupHost("1.2.3.4", false).value();
372  s << ser_params(addr);
373  BOOST_CHECK_EQUAL(HexStr(s), "010401020304");
374  s.clear();
375 
376  addr = LookupHost("1a1b:2a2b:3a3b:4a4b:5a5b:6a6b:7a7b:8a8b", false).value();
377  s << ser_params(addr);
378  BOOST_CHECK_EQUAL(HexStr(s), "02101a1b2a2b3a3b4a4b5a5b6a6b7a7b8a8b");
379  s.clear();
380 
381  // TORv2, no longer supported
382  BOOST_CHECK(!addr.SetSpecial("6hzph5hv6337r6p2.onion"));
383 
384  BOOST_REQUIRE(addr.SetSpecial("kpgvmscirrdqpekbqjsvw5teanhatztpp2gl6eee4zkowvwfxwenqaid.onion"));
385  s << ser_params(addr);
386  BOOST_CHECK_EQUAL(HexStr(s), "042053cd5648488c4707914182655b7664034e09e66f7e8cbf1084e654eb56c5bd88");
387  s.clear();
388 
389  BOOST_REQUIRE(addr.SetInternal("a"));
390  s << ser_params(addr);
391  BOOST_CHECK_EQUAL(HexStr(s), "0210fd6b88c08724ca978112ca1bbdcafac2");
392  s.clear();
393 }
394 
395 BOOST_AUTO_TEST_CASE(cnetaddr_unserialize_v2)
396 {
397  CNetAddr addr;
398  DataStream s{};
399  const auto ser_params{CAddress::V2_NETWORK};
400 
401  // Valid IPv4.
402  s << Span{ParseHex("01" // network type (IPv4)
403  "04" // address length
404  "01020304")}; // address
405  s >> ser_params(addr);
406  BOOST_CHECK(addr.IsValid());
407  BOOST_CHECK(addr.IsIPv4());
409  BOOST_CHECK_EQUAL(addr.ToStringAddr(), "1.2.3.4");
410  BOOST_REQUIRE(s.empty());
411 
412  // Invalid IPv4, valid length but address itself is shorter.
413  s << Span{ParseHex("01" // network type (IPv4)
414  "04" // address length
415  "0102")}; // address
416  BOOST_CHECK_EXCEPTION(s >> ser_params(addr), std::ios_base::failure, HasReason("end of data"));
417  BOOST_REQUIRE(!s.empty()); // The stream is not consumed on invalid input.
418  s.clear();
419 
420  // Invalid IPv4, with bogus length.
421  s << Span{ParseHex("01" // network type (IPv4)
422  "05" // address length
423  "01020304")}; // address
424  BOOST_CHECK_EXCEPTION(s >> ser_params(addr), std::ios_base::failure,
425  HasReason("BIP155 IPv4 address with length 5 (should be 4)"));
426  BOOST_REQUIRE(!s.empty()); // The stream is not consumed on invalid input.
427  s.clear();
428 
429  // Invalid IPv4, with extreme length.
430  s << Span{ParseHex("01" // network type (IPv4)
431  "fd0102" // address length (513 as CompactSize)
432  "01020304")}; // address
433  BOOST_CHECK_EXCEPTION(s >> ser_params(addr), std::ios_base::failure,
434  HasReason("Address too long: 513 > 512"));
435  BOOST_REQUIRE(!s.empty()); // The stream is not consumed on invalid input.
436  s.clear();
437 
438  // Valid IPv6.
439  s << Span{ParseHex("02" // network type (IPv6)
440  "10" // address length
441  "0102030405060708090a0b0c0d0e0f10")}; // address
442  s >> ser_params(addr);
443  BOOST_CHECK(addr.IsValid());
444  BOOST_CHECK(addr.IsIPv6());
446  BOOST_CHECK_EQUAL(addr.ToStringAddr(), "102:304:506:708:90a:b0c:d0e:f10");
447  BOOST_REQUIRE(s.empty());
448 
449  // Valid IPv6, contains embedded "internal".
450  s << Span{ParseHex(
451  "02" // network type (IPv6)
452  "10" // address length
453  "fd6b88c08724ca978112ca1bbdcafac2")}; // address: 0xfd + sha256("bitcoin")[0:5] +
454  // sha256(name)[0:10]
455  s >> ser_params(addr);
456  BOOST_CHECK(addr.IsInternal());
458  BOOST_CHECK_EQUAL(addr.ToStringAddr(), "zklycewkdo64v6wc.internal");
459  BOOST_REQUIRE(s.empty());
460 
461  // Invalid IPv6, with bogus length.
462  s << Span{ParseHex("02" // network type (IPv6)
463  "04" // address length
464  "00")}; // address
465  BOOST_CHECK_EXCEPTION(s >> ser_params(addr), std::ios_base::failure,
466  HasReason("BIP155 IPv6 address with length 4 (should be 16)"));
467  BOOST_REQUIRE(!s.empty()); // The stream is not consumed on invalid input.
468  s.clear();
469 
470  // Invalid IPv6, contains embedded IPv4.
471  s << Span{ParseHex("02" // network type (IPv6)
472  "10" // address length
473  "00000000000000000000ffff01020304")}; // address
474  s >> ser_params(addr);
475  BOOST_CHECK(!addr.IsValid());
476  BOOST_REQUIRE(s.empty());
477 
478  // Invalid IPv6, contains embedded TORv2.
479  s << Span{ParseHex("02" // network type (IPv6)
480  "10" // address length
481  "fd87d87eeb430102030405060708090a")}; // address
482  s >> ser_params(addr);
483  BOOST_CHECK(!addr.IsValid());
484  BOOST_REQUIRE(s.empty());
485 
486  // TORv2, no longer supported.
487  s << Span{ParseHex("03" // network type (TORv2)
488  "0a" // address length
489  "f1f2f3f4f5f6f7f8f9fa")}; // address
490  s >> ser_params(addr);
491  BOOST_CHECK(!addr.IsValid());
492  BOOST_REQUIRE(s.empty());
493 
494  // Valid TORv3.
495  s << Span{ParseHex("04" // network type (TORv3)
496  "20" // address length
497  "79bcc625184b05194975c28b66b66b04" // address
498  "69f7f6556fb1ac3189a79b40dda32f1f"
499  )};
500  s >> ser_params(addr);
501  BOOST_CHECK(addr.IsValid());
502  BOOST_CHECK(addr.IsTor());
505  "pg6mmjiyjmcrsslvykfwnntlaru7p5svn6y2ymmju6nubxndf4pscryd.onion");
506  BOOST_REQUIRE(s.empty());
507 
508  // Invalid TORv3, with bogus length.
509  s << Span{ParseHex("04" // network type (TORv3)
510  "00" // address length
511  "00" // address
512  )};
513  BOOST_CHECK_EXCEPTION(s >> ser_params(addr), std::ios_base::failure,
514  HasReason("BIP155 TORv3 address with length 0 (should be 32)"));
515  BOOST_REQUIRE(!s.empty()); // The stream is not consumed on invalid input.
516  s.clear();
517 
518  // Valid I2P.
519  s << Span{ParseHex("05" // network type (I2P)
520  "20" // address length
521  "a2894dabaec08c0051a481a6dac88b64" // address
522  "f98232ae42d4b6fd2fa81952dfe36a87")};
523  s >> ser_params(addr);
524  BOOST_CHECK(addr.IsValid());
525  BOOST_CHECK(addr.IsI2P());
528  "ukeu3k5oycgaauneqgtnvselmt4yemvoilkln7jpvamvfx7dnkdq.b32.i2p");
529  BOOST_REQUIRE(s.empty());
530 
531  // Invalid I2P, with bogus length.
532  s << Span{ParseHex("05" // network type (I2P)
533  "03" // address length
534  "00" // address
535  )};
536  BOOST_CHECK_EXCEPTION(s >> ser_params(addr), std::ios_base::failure,
537  HasReason("BIP155 I2P address with length 3 (should be 32)"));
538  BOOST_REQUIRE(!s.empty()); // The stream is not consumed on invalid input.
539  s.clear();
540 
541  // Valid CJDNS.
542  s << Span{ParseHex("06" // network type (CJDNS)
543  "10" // address length
544  "fc000001000200030004000500060007" // address
545  )};
546  s >> ser_params(addr);
547  BOOST_CHECK(addr.IsValid());
548  BOOST_CHECK(addr.IsCJDNS());
550  BOOST_CHECK_EQUAL(addr.ToStringAddr(), "fc00:1:2:3:4:5:6:7");
551  BOOST_REQUIRE(s.empty());
552 
553  // Invalid CJDNS, wrong prefix.
554  s << Span{ParseHex("06" // network type (CJDNS)
555  "10" // address length
556  "aa000001000200030004000500060007" // address
557  )};
558  s >> ser_params(addr);
559  BOOST_CHECK(addr.IsCJDNS());
560  BOOST_CHECK(!addr.IsValid());
561  BOOST_REQUIRE(s.empty());
562 
563  // Invalid CJDNS, with bogus length.
564  s << Span{ParseHex("06" // network type (CJDNS)
565  "01" // address length
566  "00" // address
567  )};
568  BOOST_CHECK_EXCEPTION(s >> ser_params(addr), std::ios_base::failure,
569  HasReason("BIP155 CJDNS address with length 1 (should be 16)"));
570  BOOST_REQUIRE(!s.empty()); // The stream is not consumed on invalid input.
571  s.clear();
572 
573  // Unknown, with extreme length.
574  s << Span{ParseHex("aa" // network type (unknown)
575  "fe00000002" // address length (CompactSize's MAX_SIZE)
576  "01020304050607" // address
577  )};
578  BOOST_CHECK_EXCEPTION(s >> ser_params(addr), std::ios_base::failure,
579  HasReason("Address too long: 33554432 > 512"));
580  BOOST_REQUIRE(!s.empty()); // The stream is not consumed on invalid input.
581  s.clear();
582 
583  // Unknown, with reasonable length.
584  s << Span{ParseHex("aa" // network type (unknown)
585  "04" // address length
586  "01020304" // address
587  )};
588  s >> ser_params(addr);
589  BOOST_CHECK(!addr.IsValid());
590  BOOST_REQUIRE(s.empty());
591 
592  // Unknown, with zero length.
593  s << Span{ParseHex("aa" // network type (unknown)
594  "00" // address length
595  "" // address
596  )};
597  s >> ser_params(addr);
598  BOOST_CHECK(!addr.IsValid());
599  BOOST_REQUIRE(s.empty());
600 }
601 
602 // prior to PR #14728, this test triggers an undefined behavior
603 BOOST_AUTO_TEST_CASE(ipv4_peer_with_ipv6_addrMe_test)
604 {
605  // set up local addresses; all that's necessary to reproduce the bug is
606  // that a normal IPv4 address is among the entries, but if this address is
607  // !IsRoutable the undefined behavior is easier to trigger deterministically
608  in_addr raw_addr;
609  raw_addr.s_addr = htonl(0x7f000001);
610  const CNetAddr mapLocalHost_entry = CNetAddr(raw_addr);
611  {
613  LocalServiceInfo lsi;
614  lsi.nScore = 23;
615  lsi.nPort = 42;
616  mapLocalHost[mapLocalHost_entry] = lsi;
617  }
618 
619  // create a peer with an IPv4 address
620  in_addr ipv4AddrPeer;
621  ipv4AddrPeer.s_addr = 0xa0b0c001;
622  CAddress addr = CAddress(CService(ipv4AddrPeer, 7777), NODE_NETWORK);
623  std::unique_ptr<CNode> pnode = std::make_unique<CNode>(/*id=*/0,
624  /*sock=*/nullptr,
625  addr,
626  /*nKeyedNetGroupIn=*/0,
627  /*nLocalHostNonceIn=*/0,
628  CAddress{},
629  /*pszDest=*/std::string{},
631  /*inbound_onion=*/false);
632  pnode->fSuccessfullyConnected.store(true);
633 
634  // the peer claims to be reaching us via IPv6
635  in6_addr ipv6AddrLocal;
636  memset(ipv6AddrLocal.s6_addr, 0, 16);
637  ipv6AddrLocal.s6_addr[0] = 0xcc;
638  CAddress addrLocal = CAddress(CService(ipv6AddrLocal, 7777), NODE_NETWORK);
639  pnode->SetAddrLocal(addrLocal);
640 
641  // before patch, this causes undefined behavior detectable with clang's -fsanitize=memory
642  GetLocalAddrForPeer(*pnode);
643 
644  // suppress no-checks-run warning; if this test fails, it's by triggering a sanitizer
645  BOOST_CHECK(1);
646 
647  // Cleanup, so that we don't confuse other tests.
648  {
650  mapLocalHost.erase(mapLocalHost_entry);
651  }
652 }
653 
654 BOOST_AUTO_TEST_CASE(get_local_addr_for_peer_port)
655 {
656  // Test that GetLocalAddrForPeer() properly selects the address to self-advertise:
657  //
658  // 1. GetLocalAddrForPeer() calls GetLocalAddress() which returns an address that is
659  // not routable.
660  // 2. GetLocalAddrForPeer() overrides the address with whatever the peer has told us
661  // he sees us as.
662  // 2.1. For inbound connections we must override both the address and the port.
663  // 2.2. For outbound connections we must override only the address.
664 
665  // Pretend that we bound to this port.
666  const uint16_t bind_port = 20001;
667  m_node.args->ForceSetArg("-bind", strprintf("3.4.5.6:%u", bind_port));
668 
669  // Our address:port as seen from the peer, completely different from the above.
670  in_addr peer_us_addr;
671  peer_us_addr.s_addr = htonl(0x02030405);
672  const CService peer_us{peer_us_addr, 20002};
673 
674  // Create a peer with a routable IPv4 address (outbound).
675  in_addr peer_out_in_addr;
676  peer_out_in_addr.s_addr = htonl(0x01020304);
677  CNode peer_out{/*id=*/0,
678  /*sock=*/nullptr,
679  /*addrIn=*/CAddress{CService{peer_out_in_addr, 8333}, NODE_NETWORK},
680  /*nKeyedNetGroupIn=*/0,
681  /*nLocalHostNonceIn=*/0,
682  /*addrBindIn=*/CAddress{},
683  /*addrNameIn=*/std::string{},
684  /*conn_type_in=*/ConnectionType::OUTBOUND_FULL_RELAY,
685  /*inbound_onion=*/false};
686  peer_out.fSuccessfullyConnected = true;
687  peer_out.SetAddrLocal(peer_us);
688 
689  // Without the fix peer_us:8333 is chosen instead of the proper peer_us:bind_port.
690  auto chosen_local_addr = GetLocalAddrForPeer(peer_out);
691  BOOST_REQUIRE(chosen_local_addr);
692  const CService expected{peer_us_addr, bind_port};
693  BOOST_CHECK(*chosen_local_addr == expected);
694 
695  // Create a peer with a routable IPv4 address (inbound).
696  in_addr peer_in_in_addr;
697  peer_in_in_addr.s_addr = htonl(0x05060708);
698  CNode peer_in{/*id=*/0,
699  /*sock=*/nullptr,
700  /*addrIn=*/CAddress{CService{peer_in_in_addr, 8333}, NODE_NETWORK},
701  /*nKeyedNetGroupIn=*/0,
702  /*nLocalHostNonceIn=*/0,
703  /*addrBindIn=*/CAddress{},
704  /*addrNameIn=*/std::string{},
705  /*conn_type_in=*/ConnectionType::INBOUND,
706  /*inbound_onion=*/false};
707  peer_in.fSuccessfullyConnected = true;
708  peer_in.SetAddrLocal(peer_us);
709 
710  // Without the fix peer_us:8333 is chosen instead of the proper peer_us:peer_us.GetPort().
711  chosen_local_addr = GetLocalAddrForPeer(peer_in);
712  BOOST_REQUIRE(chosen_local_addr);
713  BOOST_CHECK(*chosen_local_addr == peer_us);
714 
715  m_node.args->ForceSetArg("-bind", "");
716 }
717 
718 BOOST_AUTO_TEST_CASE(LimitedAndReachable_Network)
719 {
725 
731 
737 
743 
749 }
750 
751 BOOST_AUTO_TEST_CASE(LimitedAndReachable_NetworkCaseUnroutableAndInternal)
752 {
753  // Should be reachable by default.
756 
758 
761 
769 }
770 
771 CNetAddr UtilBuildAddress(unsigned char p1, unsigned char p2, unsigned char p3, unsigned char p4)
772 {
773  unsigned char ip[] = {p1, p2, p3, p4};
774 
775  struct sockaddr_in sa;
776  memset(&sa, 0, sizeof(sockaddr_in)); // initialize the memory block
777  memcpy(&(sa.sin_addr), &ip, sizeof(ip));
778  return CNetAddr(sa.sin_addr);
779 }
780 
781 
782 BOOST_AUTO_TEST_CASE(LimitedAndReachable_CNetAddr)
783 {
784  CNetAddr addr = UtilBuildAddress(0x001, 0x001, 0x001, 0x001); // 1.1.1.1
785 
788 
791 
792  g_reachable_nets.Add(NET_IPV4); // have to reset this, because this is stateful.
793 }
794 
795 
796 BOOST_AUTO_TEST_CASE(LocalAddress_BasicLifecycle)
797 {
798  CService addr = CService(UtilBuildAddress(0x002, 0x001, 0x001, 0x001), 1000); // 2.1.1.1:1000
799 
801 
802  BOOST_CHECK(!IsLocal(addr));
803  BOOST_CHECK(AddLocal(addr, 1000));
804  BOOST_CHECK(IsLocal(addr));
805 
806  RemoveLocal(addr);
807  BOOST_CHECK(!IsLocal(addr));
808 }
809 
810 BOOST_AUTO_TEST_CASE(initial_advertise_from_version_message)
811 {
813 
814  // Tests the following scenario:
815  // * -bind=3.4.5.6:20001 is specified
816  // * we make an outbound connection to a peer
817  // * the peer reports he sees us as 2.3.4.5:20002 in the version message
818  // (20002 is a random port assigned by our OS for the outgoing TCP connection,
819  // we cannot accept connections to it)
820  // * we should self-advertise to that peer as 2.3.4.5:20001
821 
822  // Pretend that we bound to this port.
823  const uint16_t bind_port = 20001;
824  m_node.args->ForceSetArg("-bind", strprintf("3.4.5.6:%u", bind_port));
825  m_node.args->ForceSetArg("-capturemessages", "1");
826 
827  // Our address:port as seen from the peer - 2.3.4.5:20002 (different from the above).
828  in_addr peer_us_addr;
829  peer_us_addr.s_addr = htonl(0x02030405);
830  const CService peer_us{peer_us_addr, 20002};
831 
832  // Create a peer with a routable IPv4 address.
833  in_addr peer_in_addr;
834  peer_in_addr.s_addr = htonl(0x01020304);
835  CNode peer{/*id=*/0,
836  /*sock=*/nullptr,
837  /*addrIn=*/CAddress{CService{peer_in_addr, 8333}, NODE_NETWORK},
838  /*nKeyedNetGroupIn=*/0,
839  /*nLocalHostNonceIn=*/0,
840  /*addrBindIn=*/CAddress{},
841  /*addrNameIn=*/std::string{},
842  /*conn_type_in=*/ConnectionType::OUTBOUND_FULL_RELAY,
843  /*inbound_onion=*/false};
844 
845  const uint64_t services{NODE_NETWORK | NODE_WITNESS};
846  const int64_t time{0};
847 
848  // Force ChainstateManager::IsInitialBlockDownload() to return false.
849  // Otherwise PushAddress() isn't called by PeerManager::ProcessMessage().
850  auto& chainman = static_cast<TestChainstateManager&>(*m_node.chainman);
851  chainman.JumpOutOfIbd();
852 
853  m_node.peerman->InitializeNode(peer, NODE_NETWORK);
854 
855  std::atomic<bool> interrupt_dummy{false};
856  std::chrono::microseconds time_received_dummy{0};
857 
858  const auto msg_version =
859  NetMsg::Make(NetMsgType::VERSION, PROTOCOL_VERSION, services, time, services, CAddress::V1_NETWORK(peer_us));
860  DataStream msg_version_stream{msg_version.data};
861 
862  m_node.peerman->ProcessMessage(
863  peer, NetMsgType::VERSION, msg_version_stream, time_received_dummy, interrupt_dummy);
864 
865  const auto msg_verack = NetMsg::Make(NetMsgType::VERACK);
866  DataStream msg_verack_stream{msg_verack.data};
867 
868  // Will set peer.fSuccessfullyConnected to true (necessary in SendMessages()).
869  m_node.peerman->ProcessMessage(
870  peer, NetMsgType::VERACK, msg_verack_stream, time_received_dummy, interrupt_dummy);
871 
872  // Ensure that peer_us_addr:bind_port is sent to the peer.
873  const CService expected{peer_us_addr, bind_port};
874  bool sent{false};
875 
876  const auto CaptureMessageOrig = CaptureMessage;
877  CaptureMessage = [&sent, &expected](const CAddress& addr,
878  const std::string& msg_type,
880  bool is_incoming) -> void {
881  if (!is_incoming && msg_type == "addr") {
882  DataStream s{data};
883  std::vector<CAddress> addresses;
884 
885  s >> CAddress::V1_NETWORK(addresses);
886 
887  for (const auto& addr : addresses) {
888  if (addr == expected) {
889  sent = true;
890  return;
891  }
892  }
893  }
894  };
895 
896  m_node.peerman->SendMessages(&peer);
897 
898  BOOST_CHECK(sent);
899 
900  CaptureMessage = CaptureMessageOrig;
901  chainman.ResetIbd();
902  m_node.args->ForceSetArg("-capturemessages", "0");
903  m_node.args->ForceSetArg("-bind", "");
904 }
905 
906 
907 BOOST_AUTO_TEST_CASE(advertise_local_address)
908 {
909  auto CreatePeer = [](const CAddress& addr) {
910  return std::make_unique<CNode>(/*id=*/0,
911  /*sock=*/nullptr,
912  addr,
913  /*nKeyedNetGroupIn=*/0,
914  /*nLocalHostNonceIn=*/0,
915  CAddress{},
916  /*pszDest=*/std::string{},
918  /*inbound_onion=*/false);
919  };
921 
922  CAddress addr_ipv4{Lookup("1.2.3.4", 8333, false).value(), NODE_NONE};
923  BOOST_REQUIRE(addr_ipv4.IsValid());
924  BOOST_REQUIRE(addr_ipv4.IsIPv4());
925 
926  CAddress addr_ipv6{Lookup("1122:3344:5566:7788:9900:aabb:ccdd:eeff", 8333, false).value(), NODE_NONE};
927  BOOST_REQUIRE(addr_ipv6.IsValid());
928  BOOST_REQUIRE(addr_ipv6.IsIPv6());
929 
930  CAddress addr_ipv6_tunnel{Lookup("2002:3344:5566:7788:9900:aabb:ccdd:eeff", 8333, false).value(), NODE_NONE};
931  BOOST_REQUIRE(addr_ipv6_tunnel.IsValid());
932  BOOST_REQUIRE(addr_ipv6_tunnel.IsIPv6());
933  BOOST_REQUIRE(addr_ipv6_tunnel.IsRFC3964());
934 
935  CAddress addr_teredo{Lookup("2001:0000:5566:7788:9900:aabb:ccdd:eeff", 8333, false).value(), NODE_NONE};
936  BOOST_REQUIRE(addr_teredo.IsValid());
937  BOOST_REQUIRE(addr_teredo.IsIPv6());
938  BOOST_REQUIRE(addr_teredo.IsRFC4380());
939 
940  CAddress addr_onion;
941  BOOST_REQUIRE(addr_onion.SetSpecial("pg6mmjiyjmcrsslvykfwnntlaru7p5svn6y2ymmju6nubxndf4pscryd.onion"));
942  BOOST_REQUIRE(addr_onion.IsValid());
943  BOOST_REQUIRE(addr_onion.IsTor());
944 
945  CAddress addr_i2p;
946  BOOST_REQUIRE(addr_i2p.SetSpecial("udhdrtrcetjm5sxzskjyr5ztpeszydbh4dpl3pl4utgqqw2v4jna.b32.i2p"));
947  BOOST_REQUIRE(addr_i2p.IsValid());
948  BOOST_REQUIRE(addr_i2p.IsI2P());
949 
950  CService service_cjdns{Lookup("fc00:3344:5566:7788:9900:aabb:ccdd:eeff", 8333, false).value(), NODE_NONE};
951  CAddress addr_cjdns{MaybeFlipIPv6toCJDNS(service_cjdns), NODE_NONE};
952  BOOST_REQUIRE(addr_cjdns.IsValid());
953  BOOST_REQUIRE(addr_cjdns.IsCJDNS());
954 
955  const auto peer_ipv4{CreatePeer(addr_ipv4)};
956  const auto peer_ipv6{CreatePeer(addr_ipv6)};
957  const auto peer_ipv6_tunnel{CreatePeer(addr_ipv6_tunnel)};
958  const auto peer_teredo{CreatePeer(addr_teredo)};
959  const auto peer_onion{CreatePeer(addr_onion)};
960  const auto peer_i2p{CreatePeer(addr_i2p)};
961  const auto peer_cjdns{CreatePeer(addr_cjdns)};
962 
963  // one local clearnet address - advertise to all but privacy peers
964  AddLocal(addr_ipv4);
965  BOOST_CHECK(GetLocalAddress(*peer_ipv4) == addr_ipv4);
966  BOOST_CHECK(GetLocalAddress(*peer_ipv6) == addr_ipv4);
967  BOOST_CHECK(GetLocalAddress(*peer_ipv6_tunnel) == addr_ipv4);
968  BOOST_CHECK(GetLocalAddress(*peer_teredo) == addr_ipv4);
969  BOOST_CHECK(GetLocalAddress(*peer_cjdns) == addr_ipv4);
970  BOOST_CHECK(!GetLocalAddress(*peer_onion).IsValid());
971  BOOST_CHECK(!GetLocalAddress(*peer_i2p).IsValid());
972  RemoveLocal(addr_ipv4);
973 
974  // local privacy addresses - don't advertise to clearnet peers
975  AddLocal(addr_onion);
976  AddLocal(addr_i2p);
977  BOOST_CHECK(!GetLocalAddress(*peer_ipv4).IsValid());
978  BOOST_CHECK(!GetLocalAddress(*peer_ipv6).IsValid());
979  BOOST_CHECK(!GetLocalAddress(*peer_ipv6_tunnel).IsValid());
980  BOOST_CHECK(!GetLocalAddress(*peer_teredo).IsValid());
981  BOOST_CHECK(!GetLocalAddress(*peer_cjdns).IsValid());
982  BOOST_CHECK(GetLocalAddress(*peer_onion) == addr_onion);
983  BOOST_CHECK(GetLocalAddress(*peer_i2p) == addr_i2p);
984  RemoveLocal(addr_onion);
985  RemoveLocal(addr_i2p);
986 
987  // local addresses from all networks
988  AddLocal(addr_ipv4);
989  AddLocal(addr_ipv6);
990  AddLocal(addr_ipv6_tunnel);
991  AddLocal(addr_teredo);
992  AddLocal(addr_onion);
993  AddLocal(addr_i2p);
994  AddLocal(addr_cjdns);
995  BOOST_CHECK(GetLocalAddress(*peer_ipv4) == addr_ipv4);
996  BOOST_CHECK(GetLocalAddress(*peer_ipv6) == addr_ipv6);
997  BOOST_CHECK(GetLocalAddress(*peer_ipv6_tunnel) == addr_ipv6);
998  BOOST_CHECK(GetLocalAddress(*peer_teredo) == addr_ipv4);
999  BOOST_CHECK(GetLocalAddress(*peer_onion) == addr_onion);
1000  BOOST_CHECK(GetLocalAddress(*peer_i2p) == addr_i2p);
1001  BOOST_CHECK(GetLocalAddress(*peer_cjdns) == addr_cjdns);
1002  RemoveLocal(addr_ipv4);
1003  RemoveLocal(addr_ipv6);
1004  RemoveLocal(addr_ipv6_tunnel);
1005  RemoveLocal(addr_teredo);
1006  RemoveLocal(addr_onion);
1007  RemoveLocal(addr_i2p);
1008  RemoveLocal(addr_cjdns);
1009 }
1010 
1011 namespace {
1012 
1013 CKey GenerateRandomTestKey() noexcept
1014 {
1015  CKey key;
1016  uint256 key_data = InsecureRand256();
1017  key.Set(key_data.begin(), key_data.end(), true);
1018  return key;
1019 }
1020 
1029 class V2TransportTester
1030 {
1031  V2Transport m_transport;
1032  BIP324Cipher m_cipher;
1033  bool m_test_initiator;
1034 
1035  std::vector<uint8_t> m_sent_garbage;
1036  std::vector<uint8_t> m_recv_garbage;
1037  std::vector<uint8_t> m_to_send;
1038  std::vector<uint8_t> m_received;
1039  std::deque<CSerializedNetMsg> m_msg_to_send;
1040  bool m_sent_aad{false};
1041 
1042 public:
1044  explicit V2TransportTester(bool test_initiator)
1045  : m_transport{0, test_initiator},
1046  m_cipher{GenerateRandomTestKey(), MakeByteSpan(InsecureRand256())},
1047  m_test_initiator(test_initiator) {}
1048 
1056  using InteractResult = std::optional<std::vector<std::optional<CNetMessage>>>;
1057 
1063  InteractResult Interact()
1064  {
1065  std::vector<std::optional<CNetMessage>> ret;
1066  while (true) {
1067  bool progress{false};
1068  // Send bytes from m_to_send to the transport.
1069  if (!m_to_send.empty()) {
1070  Span<const uint8_t> to_send = Span{m_to_send}.first(1 + InsecureRandRange(m_to_send.size()));
1071  size_t old_len = to_send.size();
1072  if (!m_transport.ReceivedBytes(to_send)) {
1073  return std::nullopt; // transport error occurred
1074  }
1075  if (old_len != to_send.size()) {
1076  progress = true;
1077  m_to_send.erase(m_to_send.begin(), m_to_send.begin() + (old_len - to_send.size()));
1078  }
1079  }
1080  // Retrieve messages received by the transport.
1081  if (m_transport.ReceivedMessageComplete() && (!progress || InsecureRandBool())) {
1082  bool reject{false};
1083  auto msg = m_transport.GetReceivedMessage({}, reject);
1084  if (reject) {
1085  ret.emplace_back(std::nullopt);
1086  } else {
1087  ret.emplace_back(std::move(msg));
1088  }
1089  progress = true;
1090  }
1091  // Enqueue a message to be sent by the transport to us.
1092  if (!m_msg_to_send.empty() && (!progress || InsecureRandBool())) {
1093  if (m_transport.SetMessageToSend(m_msg_to_send.front())) {
1094  m_msg_to_send.pop_front();
1095  progress = true;
1096  }
1097  }
1098  // Receive bytes from the transport.
1099  const auto& [recv_bytes, _more, _msg_type] = m_transport.GetBytesToSend(!m_msg_to_send.empty());
1100  if (!recv_bytes.empty() && (!progress || InsecureRandBool())) {
1101  size_t to_receive = 1 + InsecureRandRange(recv_bytes.size());
1102  m_received.insert(m_received.end(), recv_bytes.begin(), recv_bytes.begin() + to_receive);
1103  progress = true;
1104  m_transport.MarkBytesSent(to_receive);
1105  }
1106  if (!progress) break;
1107  }
1108  return ret;
1109  }
1110 
1112  BIP324Cipher& GetCipher() { return m_cipher; }
1113 
1115  void Send(Span<const uint8_t> data)
1116  {
1117  m_to_send.insert(m_to_send.end(), data.begin(), data.end());
1118  }
1119 
1121  void SendV1Version(const MessageStartChars& magic)
1122  {
1123  CMessageHeader hdr(magic, "version", 126 + InsecureRandRange(11));
1124  DataStream ser{};
1125  ser << hdr;
1126  m_to_send.insert(m_to_send.end(), UCharCast(ser.data()), UCharCast(ser.data() + ser.size()));
1127  }
1128 
1130  void Send(Span<const std::byte> data) { Send(MakeUCharSpan(data)); }
1131 
1133  void SendKey() { Send(m_cipher.GetOurPubKey()); }
1134 
1136  void SendGarbage(Span<const uint8_t> garbage)
1137  {
1138  // Remember the specified garbage (so we can use it as AAD).
1139  m_sent_garbage.assign(garbage.begin(), garbage.end());
1140  // Schedule it for sending.
1141  Send(m_sent_garbage);
1142  }
1143 
1145  void SendGarbage(size_t garbage_len)
1146  {
1147  // Generate random garbage and send it.
1148  SendGarbage(g_insecure_rand_ctx.randbytes<uint8_t>(garbage_len));
1149  }
1150 
1152  void SendGarbage()
1153  {
1155  }
1156 
1158  void AddMessage(std::string m_type, std::vector<uint8_t> payload)
1159  {
1161  msg.m_type = std::move(m_type);
1162  msg.data = std::move(payload);
1163  m_msg_to_send.push_back(std::move(msg));
1164  }
1165 
1171  void ReceiveKey()
1172  {
1173  // When processing a key, enough bytes need to have been received already.
1174  BOOST_REQUIRE(m_received.size() >= EllSwiftPubKey::size());
1175  // Initialize the cipher using it (acting as the opposite side of the tested transport).
1176  m_cipher.Initialize(MakeByteSpan(m_received).first(EllSwiftPubKey::size()), !m_test_initiator);
1177  // Strip the processed bytes off the front of the receive buffer.
1178  m_received.erase(m_received.begin(), m_received.begin() + EllSwiftPubKey::size());
1179  }
1180 
1183  void SendPacket(Span<const uint8_t> content, Span<const uint8_t> aad = {}, bool ignore = false)
1184  {
1185  // Use cipher to construct ciphertext.
1186  std::vector<std::byte> ciphertext;
1187  ciphertext.resize(content.size() + BIP324Cipher::EXPANSION);
1188  m_cipher.Encrypt(
1189  /*contents=*/MakeByteSpan(content),
1190  /*aad=*/MakeByteSpan(aad),
1191  /*ignore=*/ignore,
1192  /*output=*/ciphertext);
1193  // Schedule it for sending.
1194  Send(ciphertext);
1195  }
1196 
1198  void SendGarbageTerm()
1199  {
1200  // Schedule the garbage terminator to be sent.
1201  Send(m_cipher.GetSendGarbageTerminator());
1202  }
1203 
1205  void SendVersion(Span<const uint8_t> version_data = {}, bool vers_ignore = false)
1206  {
1208  // Set AAD to garbage only for first packet.
1209  if (!m_sent_aad) aad = m_sent_garbage;
1210  SendPacket(/*content=*/version_data, /*aad=*/aad, /*ignore=*/vers_ignore);
1211  m_sent_aad = true;
1212  }
1213 
1217  std::vector<uint8_t> ReceivePacket(Span<const std::byte> aad = {})
1218  {
1219  std::vector<uint8_t> contents;
1220  // Loop as long as there are ignored packets that are to be skipped.
1221  while (true) {
1222  // When processing a packet, at least enough bytes for its length descriptor must be received.
1223  BOOST_REQUIRE(m_received.size() >= BIP324Cipher::LENGTH_LEN);
1224  // Decrypt the content length.
1225  size_t size = m_cipher.DecryptLength(MakeByteSpan(Span{m_received}.first(BIP324Cipher::LENGTH_LEN)));
1226  // Check that the full packet is in the receive buffer.
1227  BOOST_REQUIRE(m_received.size() >= size + BIP324Cipher::EXPANSION);
1228  // Decrypt the packet contents.
1229  contents.resize(size);
1230  bool ignore{false};
1231  bool ret = m_cipher.Decrypt(
1232  /*input=*/MakeByteSpan(
1233  Span{m_received}.first(size + BIP324Cipher::EXPANSION).subspan(BIP324Cipher::LENGTH_LEN)),
1234  /*aad=*/aad,
1235  /*ignore=*/ignore,
1236  /*contents=*/MakeWritableByteSpan(contents));
1237  BOOST_CHECK(ret);
1238  // Don't expect AAD in further packets.
1239  aad = {};
1240  // Strip the processed packet's bytes off the front of the receive buffer.
1241  m_received.erase(m_received.begin(), m_received.begin() + size + BIP324Cipher::EXPANSION);
1242  // Stop if the ignore bit is not set on this packet.
1243  if (!ignore) break;
1244  }
1245  return contents;
1246  }
1247 
1250  void ReceiveGarbage()
1251  {
1252  // Figure out the garbage length.
1253  size_t garblen;
1254  for (garblen = 0; garblen <= V2Transport::MAX_GARBAGE_LEN; ++garblen) {
1255  BOOST_REQUIRE(m_received.size() >= garblen + BIP324Cipher::GARBAGE_TERMINATOR_LEN);
1256  auto term_span = MakeByteSpan(Span{m_received}.subspan(garblen, BIP324Cipher::GARBAGE_TERMINATOR_LEN));
1257  if (term_span == m_cipher.GetReceiveGarbageTerminator()) break;
1258  }
1259  // Copy the garbage to a buffer.
1260  m_recv_garbage.assign(m_received.begin(), m_received.begin() + garblen);
1261  // Strip garbage + garbage terminator off the front of the receive buffer.
1262  m_received.erase(m_received.begin(), m_received.begin() + garblen + BIP324Cipher::GARBAGE_TERMINATOR_LEN);
1263  }
1264 
1266  void ReceiveVersion()
1267  {
1268  auto contents = ReceivePacket(/*aad=*/MakeByteSpan(m_recv_garbage));
1269  // Version packets from real BIP324 peers are expected to be empty, despite the fact that
1270  // this class supports *sending* non-empty version packets (to test that BIP324 peers
1271  // correctly ignore version packet contents).
1272  BOOST_CHECK(contents.empty());
1273  }
1274 
1277  void ReceiveMessage(uint8_t short_id, Span<const uint8_t> payload)
1278  {
1279  auto ret = ReceivePacket();
1280  BOOST_CHECK(ret.size() == payload.size() + 1);
1281  BOOST_CHECK(ret[0] == short_id);
1282  BOOST_CHECK(Span{ret}.subspan(1) == payload);
1283  }
1284 
1287  void ReceiveMessage(const std::string& m_type, Span<const uint8_t> payload)
1288  {
1289  auto ret = ReceivePacket();
1290  BOOST_REQUIRE(ret.size() == payload.size() + 1 + CMessageHeader::COMMAND_SIZE);
1291  BOOST_CHECK(ret[0] == 0);
1292  for (unsigned i = 0; i < 12; ++i) {
1293  if (i < m_type.size()) {
1294  BOOST_CHECK(ret[1 + i] == m_type[i]);
1295  } else {
1296  BOOST_CHECK(ret[1 + i] == 0);
1297  }
1298  }
1299  BOOST_CHECK(Span{ret}.subspan(1 + CMessageHeader::COMMAND_SIZE) == payload);
1300  }
1301 
1304  void SendMessage(std::string mtype, Span<const uint8_t> payload)
1305  {
1306  // Construct contents consisting of 0x00 + 12-byte message type + payload.
1307  std::vector<uint8_t> contents(1 + CMessageHeader::COMMAND_SIZE + payload.size());
1308  std::copy(mtype.begin(), mtype.end(), reinterpret_cast<char*>(contents.data() + 1));
1309  std::copy(payload.begin(), payload.end(), contents.begin() + 1 + CMessageHeader::COMMAND_SIZE);
1310  // Send a packet with that as contents.
1311  SendPacket(contents);
1312  }
1313 
1316  void SendMessage(uint8_t short_id, Span<const uint8_t> payload)
1317  {
1318  // Construct contents consisting of short_id + payload.
1319  std::vector<uint8_t> contents(1 + payload.size());
1320  contents[0] = short_id;
1321  std::copy(payload.begin(), payload.end(), contents.begin() + 1);
1322  // Send a packet with that as contents.
1323  SendPacket(contents);
1324  }
1325 
1327  void CompareSessionIDs() const
1328  {
1329  auto info = m_transport.GetInfo();
1330  BOOST_CHECK(info.session_id);
1331  BOOST_CHECK(uint256(MakeUCharSpan(m_cipher.GetSessionID())) == *info.session_id);
1332  }
1333 
1335  void Damage()
1336  {
1337  m_to_send[InsecureRandRange(m_to_send.size())] ^= (uint8_t{1} << InsecureRandRange(8));
1338  }
1339 };
1340 
1341 } // namespace
1342 
1343 BOOST_AUTO_TEST_CASE(v2transport_test)
1344 {
1345  // A mostly normal scenario, testing a transport in initiator mode.
1346  for (int i = 0; i < 10; ++i) {
1347  V2TransportTester tester(true);
1348  auto ret = tester.Interact();
1349  BOOST_REQUIRE(ret && ret->empty());
1350  tester.SendKey();
1351  tester.SendGarbage();
1352  tester.ReceiveKey();
1353  tester.SendGarbageTerm();
1354  tester.SendVersion();
1355  ret = tester.Interact();
1356  BOOST_REQUIRE(ret && ret->empty());
1357  tester.ReceiveGarbage();
1358  tester.ReceiveVersion();
1359  tester.CompareSessionIDs();
1360  auto msg_data_1 = g_insecure_rand_ctx.randbytes<uint8_t>(InsecureRandRange(100000));
1361  auto msg_data_2 = g_insecure_rand_ctx.randbytes<uint8_t>(InsecureRandRange(1000));
1362  tester.SendMessage(uint8_t(4), msg_data_1); // cmpctblock short id
1363  tester.SendMessage(0, {}); // Invalidly encoded message
1364  tester.SendMessage("tx", msg_data_2); // 12-character encoded message type
1365  ret = tester.Interact();
1366  BOOST_REQUIRE(ret && ret->size() == 3);
1367  BOOST_CHECK((*ret)[0] && (*ret)[0]->m_type == "cmpctblock" && Span{(*ret)[0]->m_recv} == MakeByteSpan(msg_data_1));
1368  BOOST_CHECK(!(*ret)[1]);
1369  BOOST_CHECK((*ret)[2] && (*ret)[2]->m_type == "tx" && Span{(*ret)[2]->m_recv} == MakeByteSpan(msg_data_2));
1370 
1371  // Then send a message with a bit error, expecting failure. It's possible this failure does
1372  // not occur immediately (when the length descriptor was modified), but it should come
1373  // eventually, and no messages can be delivered anymore.
1374  tester.SendMessage("bad", msg_data_1);
1375  tester.Damage();
1376  while (true) {
1377  ret = tester.Interact();
1378  if (!ret) break; // failure
1379  BOOST_CHECK(ret->size() == 0); // no message can be delivered
1380  // Send another message.
1381  auto msg_data_3 = g_insecure_rand_ctx.randbytes<uint8_t>(InsecureRandRange(10000));
1382  tester.SendMessage(uint8_t(12), msg_data_3); // getheaders short id
1383  }
1384  }
1385 
1386  // Normal scenario, with a transport in responder node.
1387  for (int i = 0; i < 10; ++i) {
1388  V2TransportTester tester(false);
1389  tester.SendKey();
1390  tester.SendGarbage();
1391  auto ret = tester.Interact();
1392  BOOST_REQUIRE(ret && ret->empty());
1393  tester.ReceiveKey();
1394  tester.SendGarbageTerm();
1395  tester.SendVersion();
1396  ret = tester.Interact();
1397  BOOST_REQUIRE(ret && ret->empty());
1398  tester.ReceiveGarbage();
1399  tester.ReceiveVersion();
1400  tester.CompareSessionIDs();
1401  auto msg_data_1 = g_insecure_rand_ctx.randbytes<uint8_t>(InsecureRandRange(100000));
1402  auto msg_data_2 = g_insecure_rand_ctx.randbytes<uint8_t>(InsecureRandRange(1000));
1403  tester.SendMessage(uint8_t(14), msg_data_1); // inv short id
1404  tester.SendMessage(uint8_t(19), msg_data_2); // pong short id
1405  ret = tester.Interact();
1406  BOOST_REQUIRE(ret && ret->size() == 2);
1407  BOOST_CHECK((*ret)[0] && (*ret)[0]->m_type == "inv" && Span{(*ret)[0]->m_recv} == MakeByteSpan(msg_data_1));
1408  BOOST_CHECK((*ret)[1] && (*ret)[1]->m_type == "pong" && Span{(*ret)[1]->m_recv} == MakeByteSpan(msg_data_2));
1409 
1410  // Then send a too-large message.
1411  auto msg_data_3 = g_insecure_rand_ctx.randbytes<uint8_t>(4005000);
1412  tester.SendMessage(uint8_t(11), msg_data_3); // getdata short id
1413  ret = tester.Interact();
1414  BOOST_CHECK(!ret);
1415  }
1416 
1417  // Various valid but unusual scenarios.
1418  for (int i = 0; i < 50; ++i) {
1420  bool initiator = InsecureRandBool();
1422  size_t garb_len = InsecureRandBool() ? 0 : V2Transport::MAX_GARBAGE_LEN;
1424  unsigned num_ignore_version = InsecureRandRange(10);
1426  auto ver_data = g_insecure_rand_ctx.randbytes<uint8_t>(InsecureRandBool() ? 0 : InsecureRandRange(1000));
1428  bool send_immediately = !initiator || InsecureRandBool();
1430  unsigned num_decoys_1 = InsecureRandRange(1000), num_decoys_2 = InsecureRandRange(1000);
1431  V2TransportTester tester(initiator);
1432  if (send_immediately) {
1433  tester.SendKey();
1434  tester.SendGarbage(garb_len);
1435  }
1436  auto ret = tester.Interact();
1437  BOOST_REQUIRE(ret && ret->empty());
1438  if (!send_immediately) {
1439  tester.SendKey();
1440  tester.SendGarbage(garb_len);
1441  }
1442  tester.ReceiveKey();
1443  tester.SendGarbageTerm();
1444  for (unsigned v = 0; v < num_ignore_version; ++v) {
1445  size_t ver_ign_data_len = InsecureRandBool() ? 0 : InsecureRandRange(1000);
1446  auto ver_ign_data = g_insecure_rand_ctx.randbytes<uint8_t>(ver_ign_data_len);
1447  tester.SendVersion(ver_ign_data, true);
1448  }
1449  tester.SendVersion(ver_data, false);
1450  ret = tester.Interact();
1451  BOOST_REQUIRE(ret && ret->empty());
1452  tester.ReceiveGarbage();
1453  tester.ReceiveVersion();
1454  tester.CompareSessionIDs();
1455  for (unsigned d = 0; d < num_decoys_1; ++d) {
1456  auto decoy_data = g_insecure_rand_ctx.randbytes<uint8_t>(InsecureRandRange(1000));
1457  tester.SendPacket(/*content=*/decoy_data, /*aad=*/{}, /*ignore=*/true);
1458  }
1459  auto msg_data_1 = g_insecure_rand_ctx.randbytes<uint8_t>(InsecureRandRange(4000000));
1460  tester.SendMessage(uint8_t(28), msg_data_1);
1461  for (unsigned d = 0; d < num_decoys_2; ++d) {
1462  auto decoy_data = g_insecure_rand_ctx.randbytes<uint8_t>(InsecureRandRange(1000));
1463  tester.SendPacket(/*content=*/decoy_data, /*aad=*/{}, /*ignore=*/true);
1464  }
1465  auto msg_data_2 = g_insecure_rand_ctx.randbytes<uint8_t>(InsecureRandRange(1000));
1466  tester.SendMessage(uint8_t(13), msg_data_2); // headers short id
1467  // Send invalidly-encoded message
1468  tester.SendMessage(std::string("blocktxn\x00\x00\x00a", CMessageHeader::COMMAND_SIZE), {});
1469  tester.SendMessage("foobar", {}); // test receiving unknown message type
1470  tester.AddMessage("barfoo", {}); // test sending unknown message type
1471  ret = tester.Interact();
1472  BOOST_REQUIRE(ret && ret->size() == 4);
1473  BOOST_CHECK((*ret)[0] && (*ret)[0]->m_type == "addrv2" && Span{(*ret)[0]->m_recv} == MakeByteSpan(msg_data_1));
1474  BOOST_CHECK((*ret)[1] && (*ret)[1]->m_type == "headers" && Span{(*ret)[1]->m_recv} == MakeByteSpan(msg_data_2));
1475  BOOST_CHECK(!(*ret)[2]);
1476  BOOST_CHECK((*ret)[3] && (*ret)[3]->m_type == "foobar" && (*ret)[3]->m_recv.empty());
1477  tester.ReceiveMessage("barfoo", {});
1478  }
1479 
1480  // Too long garbage (initiator).
1481  {
1482  V2TransportTester tester(true);
1483  auto ret = tester.Interact();
1484  BOOST_REQUIRE(ret && ret->empty());
1485  tester.SendKey();
1486  tester.SendGarbage(V2Transport::MAX_GARBAGE_LEN + 1);
1487  tester.ReceiveKey();
1488  tester.SendGarbageTerm();
1489  ret = tester.Interact();
1490  BOOST_CHECK(!ret);
1491  }
1492 
1493  // Too long garbage (responder).
1494  {
1495  V2TransportTester tester(false);
1496  tester.SendKey();
1497  tester.SendGarbage(V2Transport::MAX_GARBAGE_LEN + 1);
1498  auto ret = tester.Interact();
1499  BOOST_REQUIRE(ret && ret->empty());
1500  tester.ReceiveKey();
1501  tester.SendGarbageTerm();
1502  ret = tester.Interact();
1503  BOOST_CHECK(!ret);
1504  }
1505 
1506  // Send garbage that includes the first 15 garbage terminator bytes somewhere.
1507  {
1508  V2TransportTester tester(true);
1509  auto ret = tester.Interact();
1510  BOOST_REQUIRE(ret && ret->empty());
1511  tester.SendKey();
1512  tester.ReceiveKey();
1514  size_t len_before = InsecureRandRange(V2Transport::MAX_GARBAGE_LEN - 16 + 1);
1516  size_t len_after = InsecureRandRange(V2Transport::MAX_GARBAGE_LEN - 16 - len_before + 1);
1517  // Construct len_before + 16 + len_after random bytes.
1518  auto garbage = g_insecure_rand_ctx.randbytes<uint8_t>(len_before + 16 + len_after);
1519  // Replace the designed 16 bytes in the middle with the to-be-sent garbage terminator.
1520  auto garb_term = MakeUCharSpan(tester.GetCipher().GetSendGarbageTerminator());
1521  std::copy(garb_term.begin(), garb_term.begin() + 16, garbage.begin() + len_before);
1522  // Introduce a bit error in the last byte of that copied garbage terminator, making only
1523  // the first 15 of them match.
1524  garbage[len_before + 15] ^= (uint8_t(1) << InsecureRandRange(8));
1525  tester.SendGarbage(garbage);
1526  tester.SendGarbageTerm();
1527  tester.SendVersion();
1528  ret = tester.Interact();
1529  BOOST_REQUIRE(ret && ret->empty());
1530  tester.ReceiveGarbage();
1531  tester.ReceiveVersion();
1532  tester.CompareSessionIDs();
1533  auto msg_data_1 = g_insecure_rand_ctx.randbytes<uint8_t>(4000000); // test that receiving 4M payload works
1534  auto msg_data_2 = g_insecure_rand_ctx.randbytes<uint8_t>(4000000); // test that sending 4M payload works
1535  tester.SendMessage(uint8_t(InsecureRandRange(223) + 33), {}); // unknown short id
1536  tester.SendMessage(uint8_t(2), msg_data_1); // "block" short id
1537  tester.AddMessage("blocktxn", msg_data_2); // schedule blocktxn to be sent to us
1538  ret = tester.Interact();
1539  BOOST_REQUIRE(ret && ret->size() == 2);
1540  BOOST_CHECK(!(*ret)[0]);
1541  BOOST_CHECK((*ret)[1] && (*ret)[1]->m_type == "block" && Span{(*ret)[1]->m_recv} == MakeByteSpan(msg_data_1));
1542  tester.ReceiveMessage(uint8_t(3), msg_data_2); // "blocktxn" short id
1543  }
1544 
1545  // Send correct network's V1 header
1546  {
1547  V2TransportTester tester(false);
1548  tester.SendV1Version(Params().MessageStart());
1549  auto ret = tester.Interact();
1550  BOOST_CHECK(ret);
1551  }
1552 
1553  // Send wrong network's V1 header
1554  {
1555  V2TransportTester tester(false);
1556  tester.SendV1Version(CChainParams::Main()->MessageStart());
1557  auto ret = tester.Interact();
1558  BOOST_CHECK(!ret);
1559  }
1560 }
1561 
ArgsManager gArgs
Definition: args.cpp:41
int ret
node::NodeContext m_node
Definition: bitcoin-gui.cpp:37
const CChainParams & Params()
Return the currently selected parameters.
void ForceSetArg(const std::string &strArg, const std::string &strValue)
Definition: args.cpp:544
bool SoftSetArg(const std::string &strArg, const std::string &strValue)
Set an argument if it doesn't already have a value.
Definition: args.cpp:528
The BIP324 packet cipher, encapsulating its key derivation, stream cipher, and AEAD.
Definition: bip324.h:20
Span< const std::byte > GetSendGarbageTerminator() const noexcept
Get the Garbage Terminator to send.
Definition: bip324.h:90
Span< const std::byte > GetSessionID() const noexcept
Get the Session ID.
Definition: bip324.h:87
static constexpr unsigned GARBAGE_TERMINATOR_LEN
Definition: bip324.h:23
unsigned DecryptLength(Span< const std::byte > input) noexcept
Decrypt the length of a packet.
Definition: bip324.cpp:89
const EllSwiftPubKey & GetOurPubKey() const noexcept
Retrieve our public key.
Definition: bip324.h:54
bool Decrypt(Span< const std::byte > input, Span< const std::byte > aad, bool &ignore, Span< std::byte > contents) noexcept
Decrypt a packet.
Definition: bip324.cpp:100
void Encrypt(Span< const std::byte > contents, Span< const std::byte > aad, bool ignore, Span< std::byte > output) noexcept
Encrypt a packet.
Definition: bip324.cpp:73
static constexpr unsigned LENGTH_LEN
Definition: bip324.h:25
static constexpr unsigned EXPANSION
Definition: bip324.h:27
void Initialize(const EllSwiftPubKey &their_pubkey, bool initiator, bool self_decrypt=false) noexcept
Initialize when the other side's public key is received.
Definition: bip324.cpp:34
Span< const std::byte > GetReceiveGarbageTerminator() const noexcept
Get the expected Garbage Terminator to receive.
Definition: bip324.h:93
A CService with information about it as peer.
Definition: protocol.h:332
static constexpr SerParams V1_NETWORK
Definition: protocol.h:373
static constexpr SerParams V2_NETWORK
Definition: protocol.h:374
static std::unique_ptr< const CChainParams > Main()
An encapsulated private key.
Definition: key.h:33
void Set(const T pbegin, const T pend, bool fCompressedIn)
Initialize using begin and end iterators to byte data.
Definition: key.h:99
Message header.
Definition: protocol.h:29
static constexpr size_t COMMAND_SIZE
Definition: protocol.h:31
Network address.
Definition: netaddress.h:112
std::string ToStringAddr() const
Definition: netaddress.cpp:581
bool IsBindAny() const
Definition: netaddress.cpp:304
bool SetSpecial(const std::string &addr)
Parse a Tor or I2P address and set this object to it.
Definition: netaddress.cpp:208
bool IsCJDNS() const
Definition: netaddress.h:176
bool IsTor() const
Definition: netaddress.h:174
bool IsValid() const
Definition: netaddress.cpp:425
bool IsIPv4() const
Definition: netaddress.h:157
bool IsIPv6() const
Definition: netaddress.h:158
bool IsInternal() const
Definition: netaddress.cpp:473
bool SetInternal(const std::string &name)
Create an "internal" address that represents a name or FQDN.
Definition: netaddress.cpp:169
bool IsAddrV1Compatible() const
Check if the current object can be serialized in pre-ADDRv2/BIP155 format.
Definition: netaddress.cpp:478
bool IsI2P() const
Definition: netaddress.h:175
Information about a peer.
Definition: net.h:670
A combination of a network address (CNetAddr) and a (TCP) port.
Definition: netaddress.h:531
Double ended buffer combining vector and stream-like interfaces.
Definition: streams.h:147
value_type * data()
Definition: streams.h:188
std::vector< B > randbytes(size_t len)
Generate random bytes.
Definition: random.cpp:671
BOOST_CHECK_EXCEPTION predicates to check the specific validation error.
Definition: setup_common.h:246
static Mutex g_msgproc_mutex
Mutex for anything that is only accessed via the msg processing thread.
Definition: net.h:992
void Add(Network net) EXCLUSIVE_LOCKS_REQUIRED(!m_mutex)
Definition: netbase.h:103
bool Contains(Network net) const EXCLUSIVE_LOCKS_REQUIRED(!m_mutex)
Definition: netbase.h:124
void Remove(Network net) EXCLUSIVE_LOCKS_REQUIRED(!m_mutex)
Definition: netbase.h:110
void RemoveAll() EXCLUSIVE_LOCKS_REQUIRED(!m_mutex)
Definition: netbase.h:117
A Span is an object that can refer to a contiguous sequence of objects.
Definition: span.h:98
constexpr std::size_t size() const noexcept
Definition: span.h:187
constexpr C * end() const noexcept
Definition: span.h:176
constexpr C * begin() const noexcept
Definition: span.h:175
CONSTEXPR_IF_NOT_DEBUG Span< C > first(std::size_t count) const noexcept
Definition: span.h:205
CONSTEXPR_IF_NOT_DEBUG Span< C > subspan(std::size_t offset) const noexcept
Definition: span.h:195
void MarkBytesSent(size_t bytes_sent) noexcept override EXCLUSIVE_LOCKS_REQUIRED(!m_send_mutex)
Report how many bytes returned by the last GetBytesToSend() have been sent.
Definition: net.cpp:1502
static constexpr uint32_t MAX_GARBAGE_LEN
Definition: net.h:631
bool ReceivedBytes(Span< const uint8_t > &msg_bytes) noexcept override EXCLUSIVE_LOCKS_REQUIRED(!m_recv_mutex
Feed wire bytes to the transport.
Definition: net.cpp:1294
Info GetInfo() const noexcept override EXCLUSIVE_LOCKS_REQUIRED(!m_recv_mutex)
Retrieve information about this transport.
Definition: net.cpp:1550
BytesToSend GetBytesToSend(bool have_next_message) const noexcept override EXCLUSIVE_LOCKS_REQUIRED(!m_send_mutex)
Get bytes to send on the wire, if any, along with other information about it.
Definition: net.cpp:1485
bool ReceivedMessageComplete() const noexcept override EXCLUSIVE_LOCKS_REQUIRED(!m_recv_mutex)
Returns true if the current message is complete (so GetReceivedMessage can be called).
Definition: net.cpp:1042
CNetMessage GetReceivedMessage(std::chrono::microseconds time, bool &reject_message) noexcept override EXCLUSIVE_LOCKS_REQUIRED(!m_recv_mutex)
Retrieve a completed message from transport.
Definition: net.cpp:1424
bool SetMessageToSend(CSerializedNetMsg &msg) noexcept override EXCLUSIVE_LOCKS_REQUIRED(!m_send_mutex)
Set the next message to send.
Definition: net.cpp:1453
constexpr unsigned char * end()
Definition: uint256.h:69
constexpr unsigned char * begin()
Definition: uint256.h:68
256-bit opaque blob.
Definition: uint256.h:106
@ 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.
BOOST_AUTO_TEST_SUITE_END()
static CService ip(uint32_t i)
std::array< uint8_t, 4 > MessageStartChars
CSerializedNetMsg Make(std::string msg_type, Args &&... args)
const char * VERSION
The version message provides information about the transmitting node to the receiving node at the beg...
Definition: protocol.cpp:13
const char * VERACK
The verack message acknowledges a previously-received version message, informing the connecting node ...
Definition: protocol.cpp:14
uint16_t GetListenPort()
Definition: net.cpp:133
bool IsLocal(const CService &addr)
check whether a given address is potentially local
Definition: net.cpp:318
void RemoveLocal(const CService &addr)
Definition: net.cpp:299
std::optional< CService > GetLocalAddrForPeer(CNode &node)
Returns a local address that we should advertise to this peer.
Definition: net.cpp:235
bool AddLocal(const CService &addr_, int nScore)
Definition: net.cpp:266
CService GetLocalAddress(const CNode &peer)
Definition: net.cpp:215
GlobalMutex g_maplocalhost_mutex
Definition: net.cpp:115
std::function< void(const CAddress &addr, const std::string &msg_type, Span< const unsigned char > data, bool is_incoming)> CaptureMessage
Defaults to CaptureMessageToFile(), but can be overridden by unit tests.
Definition: net.cpp:3934
int64_t NodeId
Definition: net.h:97
BOOST_AUTO_TEST_CASE(cnode_listen_port)
Definition: net_tests.cpp:38
CNetAddr UtilBuildAddress(unsigned char p1, unsigned char p2, unsigned char p3, unsigned char p4)
Definition: net_tests.cpp:771
@ NET_I2P
I2P.
Definition: netaddress.h:46
@ NET_CJDNS
CJDNS.
Definition: netaddress.h:49
@ NET_ONION
TOR (v2 or v3)
Definition: netaddress.h:43
@ NET_IPV6
IPv6.
Definition: netaddress.h:40
@ NET_IPV4
IPv4.
Definition: netaddress.h:37
@ NET_UNROUTABLE
Addresses from these networks are not publicly routable on the global Internet.
Definition: netaddress.h:34
@ NET_INTERNAL
A set of addresses that represent the hash of a string or FQDN.
Definition: netaddress.h:53
std::vector< CService > Lookup(const std::string &name, uint16_t portDefault, bool fAllowLookup, unsigned int nMaxSolutions, DNSLookupFn dns_lookup_function)
Resolve a service string to its corresponding service.
Definition: netbase.cpp:182
CService MaybeFlipIPv6toCJDNS(const CService &service)
If an IPv6 address belongs to the address range used by the CJDNS network and the CJDNS network is re...
Definition: netbase.cpp:865
ReachableNets g_reachable_nets
Definition: netbase.cpp:41
std::vector< CNetAddr > LookupHost(const std::string &name, unsigned int nMaxSolutions, bool fAllowLookup, DNSLookupFn dns_lookup_function)
Resolve a host string to its corresponding network addresses.
Definition: netbase.cpp:164
#define BOOST_CHECK_EQUAL(v1, v2)
Definition: object.cpp:18
#define BOOST_CHECK(expr)
Definition: object.cpp:17
@ NODE_NONE
Definition: protocol.h:277
@ NODE_WITNESS
Definition: protocol.h:285
@ NODE_NETWORK
Definition: protocol.h:280
static const int PROTOCOL_VERSION
network protocol versioning
constexpr auto MakeUCharSpan(V &&v) -> decltype(UCharSpanCast(Span{std::forward< V >(v)}))
Like the Span constructor, but for (const) unsigned char member types only.
Definition: span.h:304
unsigned char * UCharCast(char *c)
Definition: span.h:288
Span< const std::byte > MakeByteSpan(V &&v) noexcept
Definition: span.h:277
Span< std::byte > MakeWritableByteSpan(V &&v) noexcept
Definition: span.h:282
std::vector< Byte > ParseHex(std::string_view hex_str)
Like TryParseHex, but returns an empty vector on invalid input.
Definition: strencodings.h:65
std::string ToString(const T &t)
Locale-independent version of std::to_string.
Definition: string.h:110
static constexpr size_t size()
Definition: pubkey.h:322
uint16_t nPort
Definition: net.h:175
int nScore
Definition: net.h:174
Identical to TestingSetup, but chain set to regtest.
Definition: setup_common.h:94
void JumpOutOfIbd()
Toggle IsInitialBlockDownload from true to false.
Definition: validation.cpp:18
std::unique_ptr< ChainstateManager > chainman
Definition: context.h:67
std::unique_ptr< PeerManager > peerman
Definition: context.h:66
ArgsManager * args
Definition: context.h:69
#define LOCK(cs)
Definition: sync.h:257
FastRandomContext g_insecure_rand_ctx
This global and the helpers that use it are not thread-safe.
Definition: random.cpp:14
static uint64_t InsecureRandRange(uint64_t range)
Definition: random.h:60
static uint256 InsecureRand256()
Definition: random.h:50
static bool InsecureRandBool()
Definition: random.h:65
#define strprintf
Format arguments and return the string or write to given std::ostream (see tinyformat::format doc for...
Definition: tinyformat.h:1162
std::string HexStr(const Span< const uint8_t > s)
Convert a span of bytes to a lower-case hexadecimal string.
std::string ToLower(std::string_view str)
Returns the lowercase equivalent of the given string.