Inside Bitcoin
Opening the selected file…
Inside Bitcoin
Opening the selected file…
The code behind the network, with room to understand it.
Release published 2026-10-28 · Snapshot fetched 2026-11-01. Latest stable release at fetch time; development branches and Git history are excluded. Only the selected code window and visible folders load here.
252// I2P, malicious253BOOST_CHECK(!addr.SetSpecial("udhdrtrcetjm5sxzskjyr5ztpeszydbh4dpl3pl4utgqqw2v\0wtf.b32.i2p"s));255// I2P, valid but unsupported (56 Base32 characters)256// See https://i2p.net/en/docs/specs/b32encrypted257BOOST_CHECK(258!addr.SetSpecial("pg6mmjiyjmcrsslvykfwnntlaru7p5svn6y2ymmju6nubxndf4pscsad.b32.i2p"));260// I2P, invalid base32261BOOST_CHECK(!addr.SetSpecial(std::string{"tp*szydbh4dp.b32.i2p"}));263// Internal264addr.SetInternal("esffpp");265BOOST_REQUIRE(!addr.IsValid()); // "internal" is considered invalid266BOOST_REQUIRE(addr.IsInternal());268BOOST_CHECK(!addr.IsBindAny());269BOOST_CHECK(addr.IsAddrV1Compatible());270BOOST_CHECK_EQUAL(addr.ToStringAddr(), "esffpvrt3wpeaygy.internal");272// Totally bogus273BOOST_CHECK(!addr.SetSpecial("totally bogus"));274}276BOOST_AUTO_TEST_CASE(cnetaddr_tostring_canonical_ipv6)277{278// Test that CNetAddr::ToString formats IPv6 addresses with zero compression as described in279// RFC 5952 ("A Recommendation for IPv6 Address Text Representation").280const std::map<std::string, std::string> canonical_representations_ipv6{281{"0000:0000:0000:0000:0000:0000:0000:0000", "::"},282{"000:0000:000:00:0:00:000:0000", "::"},283{"000:000:000:000:000:000:000:000", "::"},284{"00:00:00:00:00:00:00:00", "::"},285{"0:0:0:0:0:0:0:0", "::"},286{"0:0:0:0:0:0:0:1", "::1"},287{"2001:0:0:1:0:0:0:1", "2001:0:0:1::1"},288{"2001:0db8:0:0:1:0:0:1", "2001:db8::1:0:0:1"},289{"2001:0db8:85a3:0000:0000:8a2e:0370:7334", "2001:db8:85a3::8a2e:370:7334"},290{"2001:0db8::0001", "2001:db8::1"},291{"2001:0db8::0001:0000", "2001:db8::1:0"},292{"2001:0db8::1:0:0:1", "2001:db8::1:0:0:1"},293{"2001:db8:0000:0:1::1", "2001:db8::1:0:0:1"},294{"2001:db8:0000:1:1:1:1:1", "2001:db8:0:1:1:1:1:1"},295{"2001:db8:0:0:0:0:2:1", "2001:db8::2:1"},296{"2001:db8:0:0:0::1", "2001:db8::1"},297{"2001:db8:0:0:1:0:0:1", "2001:db8::1:0:0:1"},298{"2001:db8:0:0:1::1", "2001:db8::1:0:0:1"},299{"2001:DB8:0:0:1::1", "2001:db8::1:0:0:1"},300{"2001:db8:0:0::1", "2001:db8::1"},301{"2001:db8:0:0:aaaa::1", "2001:db8::aaaa:0:0:1"},302{"2001:db8:0:1:1:1:1:1", "2001:db8:0:1:1:1:1:1"},303{"2001:db8:0::1", "2001:db8::1"},304{"2001:db8:85a3:0:0:8a2e:370:7334", "2001:db8:85a3::8a2e:370:7334"},305{"2001:db8::0:1", "2001:db8::1"},306{"2001:db8::0:1:0:0:1", "2001:db8::1:0:0:1"},307{"2001:DB8::1", "2001:db8::1"},308{"2001:db8::1", "2001:db8::1"},309{"2001:db8::1:0:0:1", "2001:db8::1:0:0:1"},310{"2001:db8::1:1:1:1:1", "2001:db8:0:1:1:1:1:1"},311{"2001:db8::aaaa:0:0:1", "2001:db8::aaaa:0:0:1"},312{"2001:db8:aaaa:bbbb:cccc:dddd:0:1", "2001:db8:aaaa:bbbb:cccc:dddd:0:1"},313{"2001:db8:aaaa:bbbb:cccc:dddd::1", "2001:db8:aaaa:bbbb:cccc:dddd:0:1"},314{"2001:db8:aaaa:bbbb:cccc:dddd:eeee:0001", "2001:db8:aaaa:bbbb:cccc:dddd:eeee:1"},315{"2001:db8:aaaa:bbbb:cccc:dddd:eeee:001", "2001:db8:aaaa:bbbb:cccc:dddd:eeee:1"},316{"2001:db8:aaaa:bbbb:cccc:dddd:eeee:01", "2001:db8:aaaa:bbbb:cccc:dddd:eeee:1"},317{"2001:db8:aaaa:bbbb:cccc:dddd:eeee:1", "2001:db8:aaaa:bbbb:cccc:dddd:eeee:1"},318{"2001:db8:aaaa:bbbb:cccc:dddd:eeee:aaaa", "2001:db8:aaaa:bbbb:cccc:dddd:eeee:aaaa"},319{"2001:db8:aaaa:bbbb:cccc:dddd:eeee:AAAA", "2001:db8:aaaa:bbbb:cccc:dddd:eeee:aaaa"},320{"2001:db8:aaaa:bbbb:cccc:dddd:eeee:AaAa", "2001:db8:aaaa:bbbb:cccc:dddd:eeee:aaaa"},321};322for (const auto& [input_address, expected_canonical_representation_output] : canonical_representations_ipv6) {323const std::optional<CNetAddr> net_addr{LookupHost(input_address, false)};324BOOST_REQUIRE(net_addr.value().IsIPv6());325BOOST_CHECK_EQUAL(net_addr.value().ToStringAddr(), expected_canonical_representation_output);326}327}329BOOST_AUTO_TEST_CASE(cnetaddr_serialize_v1)330{331CNetAddr addr;332DataStream s{};333const auto ser_params{CAddress::V1_NETWORK};335s << ser_params(addr);336BOOST_CHECK_EQUAL(HexStr(s), "00000000000000000000000000000000");337s.clear();339addr = LookupHost("1.2.3.4", false).value();340s << ser_params(addr);341BOOST_CHECK_EQUAL(HexStr(s), "00000000000000000000ffff01020304");342s.clear();344addr = LookupHost("1a1b:2a2b:3a3b:4a4b:5a5b:6a6b:7a7b:8a8b", false).value();345s << ser_params(addr);346BOOST_CHECK_EQUAL(HexStr(s), "1a1b2a2b3a3b4a4b5a5b6a6b7a7b8a8b");347s.clear();349// TORv2, no longer supported350BOOST_CHECK(!addr.SetSpecial("6hzph5hv6337r6p2.onion"));352BOOST_REQUIRE(addr.SetSpecial("pg6mmjiyjmcrsslvykfwnntlaru7p5svn6y2ymmju6nubxndf4pscryd.onion"));353s << ser_params(addr);354BOOST_CHECK_EQUAL(HexStr(s), "00000000000000000000000000000000");355s.clear();357addr.SetInternal("a");358s << ser_params(addr);359BOOST_CHECK_EQUAL(HexStr(s), "fd6b88c08724ca978112ca1bbdcafac2");360s.clear();361}363BOOST_AUTO_TEST_CASE(cnetaddr_serialize_v2)364{365CNetAddr addr;366DataStream s{};367const auto ser_params{CAddress::V2_NETWORK};369s << ser_params(addr);370BOOST_CHECK_EQUAL(HexStr(s), "021000000000000000000000000000000000");371s.clear();373addr = LookupHost("1.2.3.4", false).value();374s << ser_params(addr);375BOOST_CHECK_EQUAL(HexStr(s), "010401020304");376s.clear();378addr = LookupHost("1a1b:2a2b:3a3b:4a4b:5a5b:6a6b:7a7b:8a8b", false).value();379s << ser_params(addr);380BOOST_CHECK_EQUAL(HexStr(s), "02101a1b2a2b3a3b4a4b5a5b6a6b7a7b8a8b");381s.clear();383// TORv2, no longer supported384BOOST_CHECK(!addr.SetSpecial("6hzph5hv6337r6p2.onion"));386BOOST_REQUIRE(addr.SetSpecial("kpgvmscirrdqpekbqjsvw5teanhatztpp2gl6eee4zkowvwfxwenqaid.onion"));387s << ser_params(addr);388BOOST_CHECK_EQUAL(HexStr(s), "042053cd5648488c4707914182655b7664034e09e66f7e8cbf1084e654eb56c5bd88");389s.clear();391BOOST_REQUIRE(addr.SetInternal("a"));392s << ser_params(addr);393BOOST_CHECK_EQUAL(HexStr(s), "0210fd6b88c08724ca978112ca1bbdcafac2");394s.clear();395}397BOOST_AUTO_TEST_CASE(cnetaddr_unserialize_v2)398{399CNetAddr addr;400DataStream s{};401const auto ser_params{CAddress::V2_NETWORK};403// Valid IPv4.404s << "01" // network type (IPv4)405"04" // address length406"01020304"_hex; // address407s >> ser_params(addr);408BOOST_CHECK(addr.IsValid());409BOOST_CHECK(addr.IsIPv4());410BOOST_CHECK(addr.IsAddrV1Compatible());411BOOST_CHECK_EQUAL(addr.ToStringAddr(), "1.2.3.4");412BOOST_REQUIRE(s.empty());414// Invalid IPv4, valid length but address itself is shorter.415s << "01" // network type (IPv4)416"04" // address length417"0102"_hex; // address418BOOST_CHECK_EXCEPTION(s >> ser_params(addr), std::ios_base::failure, HasReason("end of data"));419BOOST_REQUIRE(!s.empty()); // The stream is not consumed on invalid input.420s.clear();422// Invalid IPv4, with bogus length.423s << "01" // network type (IPv4)424"05" // address length425"01020304"_hex; // address426BOOST_CHECK_EXCEPTION(s >> ser_params(addr), std::ios_base::failure,427HasReason("BIP155 IPv4 address with length 5 (should be 4)"));428BOOST_REQUIRE(!s.empty()); // The stream is not consumed on invalid input.429s.clear();431// Invalid IPv4, with extreme length.432s << "01" // network type (IPv4)433"fd0102" // address length (513 as CompactSize)434"01020304"_hex; // address435BOOST_CHECK_EXCEPTION(s >> ser_params(addr), std::ios_base::failure,436HasReason("Address too long: 513 > 512"));437BOOST_REQUIRE(!s.empty()); // The stream is not consumed on invalid input.438s.clear();440// Valid IPv6.441s << "02" // network type (IPv6)442"10" // address length443"0102030405060708090a0b0c0d0e0f10"_hex; // address444s >> ser_params(addr);445BOOST_CHECK(addr.IsValid());446BOOST_CHECK(addr.IsIPv6());447BOOST_CHECK(addr.IsAddrV1Compatible());448BOOST_CHECK_EQUAL(addr.ToStringAddr(), "102:304:506:708:90a:b0c:d0e:f10");449BOOST_REQUIRE(s.empty());451// Valid IPv6, contains embedded "internal".452s << "02" // network type (IPv6)453"10" // address length454"fd6b88c08724ca978112ca1bbdcafac2"_hex; // address: 0xfd + sha256("bitcoin")[0:5] +455// sha256(name)[0:10]456s >> ser_params(addr);457BOOST_CHECK(addr.IsInternal());458BOOST_CHECK(addr.IsAddrV1Compatible());459BOOST_CHECK_EQUAL(addr.ToStringAddr(), "zklycewkdo64v6wc.internal");460BOOST_REQUIRE(s.empty());462// Invalid IPv6, with bogus length.463s << "02" // network type (IPv6)464"04" // address length465"00"_hex; // address466BOOST_CHECK_EXCEPTION(s >> ser_params(addr), std::ios_base::failure,467HasReason("BIP155 IPv6 address with length 4 (should be 16)"));468BOOST_REQUIRE(!s.empty()); // The stream is not consumed on invalid input.469s.clear();471// Invalid IPv6, contains embedded IPv4.472s << "02" // network type (IPv6)473"10" // address length474"00000000000000000000ffff01020304"_hex; // address475s >> ser_params(addr);476BOOST_CHECK(!addr.IsValid());477BOOST_REQUIRE(s.empty());479// Invalid IPv6, contains embedded TORv2.480s << "02" // network type (IPv6)481"10" // address length482"fd87d87eeb430102030405060708090a"_hex; // address483s >> ser_params(addr);484BOOST_CHECK(!addr.IsValid());485BOOST_REQUIRE(s.empty());487// TORv2, no longer supported.488s << "03" // network type (TORv2)489"0a" // address length490"f1f2f3f4f5f6f7f8f9fa"_hex; // address491s >> ser_params(addr);492BOOST_CHECK(!addr.IsValid());493BOOST_REQUIRE(s.empty());495// Valid TORv3.496s << "04" // network type (TORv3)497"20" // address length498"79bcc625184b05194975c28b66b66b04" // address499"69f7f6556fb1ac3189a79b40dda32f1f"_hex;500s >> ser_params(addr);
Independent explanations by MyBitcoinExplorer. Not affiliated with or endorsed by Bitcoin Core. Guides are educational and do not replace the source or its tests.
Bitcoin Core source © its contributors, distributed under the MIT license. Original notices and bundled third-party licenses are retained in the source tree.