BITCOIN MAINNETLive explorer status

Explorer Mempool Feed Forum Visualizer Receipts Tools Learn Code

Inside Bitcoin

Opening the selected file…

₿MyBitcoinExplorer

Bitcoin, in focus.
Explore the network. Understand the connections.

Explore Bitcoin with clarity.

READ THE CODE

Inside Bitcoin

The code behind the network, with room to understand it.

Stable release v32.1bitcoin/bitcoin · f0de87f04062 ↗3,020 source files · 47.5 MB stored on the server440 file guides

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.

bitcoin / bitcoinstable

Find a file

▤ arith_uint256.hGuide

▤ bitcoin-chainstate.cpp

▤ bitcoin-cli-res.rc

▤ bitcoin-cli.cppGuide

▤ bitcoin-res.rc

▤ bitcoin-tx-res.rc

▤ bitcoin-tx.cpp

▤ bitcoin-util-res.rc

▤ bitcoin-util.cpp

▤ bitcoin-wallet-res.rc

▤ blockencodings.cppGuide

▤ blockencodings.hGuide

▤ blockfilter.cppGuide

▤ blockfilter.hGuide

▤ chain.cppGuide

▤ chain.h

▤ chainparams.cppGuide

▤ chainparams.hGuide

▤ chainparamsbase.cppGuide

▤ chainparamsbase.hGuide

▤ chainparamsseeds.h

▤ checkqueue.hGuide

▤ clientversion.cppGuide

▤ clientversion.hGuide

▤ cluster_linearize.h

▤ CMakeLists.txt

▤ coins.cppGuide

▤ coins.hGuide

▤ compressor.cppGuide

▤ compressor.hGuide

▤ core_io.cpp

▤ core_io.hGuide

▤ core_memusage.hGuide

▤ cuckoocache.h

▤ dbwrapper.cpp

▤ dbwrapper.hGuide

▤ deploymentinfo.cppGuide

▤ deploymentinfo.hGuide

▤ deploymentstatus.cppGuide

▤ deploymentstatus.hGuide

▤ dummywallet.cppGuide

▤ external_signer.cpp

▤ external_signer.hGuide

▤ merkleblock.cppGuide

▤ merkleblock.hGuide

▤ musig.cpp

▤ musig.hGuide

▤ net_permissions.cppGuide

▤ net_permissions.hGuide

▤ net_processing.cppGuide

▤ netaddress.cppGuide

▤ netmessagemaker.hGuide

▤ noui.cppGuide

▤ noui.hGuide

▤ outputtype.cppGuide

▤ private_broadcast.cpp

▤ private_broadcast.h

▤ semaphore_grant.hGuide

▤ threadsafety.hGuide

▤ tinyformat.h

▤ torcontrol.cppGuide

▤ validation.cppGuide

▤ validation.h

▤ validationinterface.cpp

▤ validationinterface.h

▤ versionbits_impl.hGuide

▤ versionbits.cpp

▤ versionbits.hGuide

▤ walletinitinterface.hGuide

▤ CMakeLists.txtGuide

▤ libbitcoinkernel.pc.in

bitcoin / src / netaddress.h

Download source ↓

20,318 bytes · SHA-256 4590086cfafa37ec… · View upstream ↗

251    template <typename Stream>
252    void Unserialize(Stream& s)
253    {
254        if (s.template GetParams<SerParams>().enc == Encoding::V2) {
255            UnserializeV2Stream(s);
256        } else {
257            UnserializeV1Stream(s);
258        }
259    }
260
261    /**
262     * BIP155 network ids recognized by this software.
263     */
264    enum BIP155Network : uint8_t {
265        IPV4 = 1,
266        IPV6 = 2,
267        TORV2 = 3,
268        TORV3 = 4,
269        I2P = 5,
270        CJDNS = 6,
271    };
272
273    friend class CSubNet;
274
275private:
276    /**
277     * Parse a Tor address and set this object to it.
278     * @param[in] addr Address to parse, must be a valid C string, for example
279     * pg6mmjiyjmcrsslvykfwnntlaru7p5svn6y2ymmju6nubxndf4pscryd.onion.
280     * @returns Whether the operation was successful.
281     * @see CNetAddr::IsTor()
282     */
283    bool SetTor(std::string_view addr);
284
285    /**
286     * Parse an I2P address and set this object to it.
287     * @param[in] addr Address to parse, must be a valid C string, for example
288     * ukeu3k5oycgaauneqgtnvselmt4yemvoilkln7jpvamvfx7dnkdq.b32.i2p.
289     * @returns Whether the operation was successful.
290     * @see CNetAddr::IsI2P()
291     */
292    bool SetI2P(std::string_view addr);
293
294    /**
295     * Size of CNetAddr when serialized as ADDRv1 (pre-BIP155) (in bytes).
296     */
297    static constexpr size_t V1_SERIALIZATION_SIZE = ADDR_IPV6_SIZE;
298
299    /**
300     * Maximum size of an address as defined in BIP155 (in bytes).
301     * This is only the size of the address, not the entire CNetAddr object
302     * when serialized.
303     */
304    static constexpr size_t MAX_ADDRV2_SIZE = 512;
305
306    /**
307     * Get the BIP155 network id of this address.
308     * Must not be called for IsInternal() objects.
309     * @returns BIP155 network id, except TORV2 which is no longer supported.
310     */
311    BIP155Network GetBIP155Network() const;
312
313    /**
314     * Set `m_net` from the provided BIP155 network id and size after validation.
315     * @retval true the network was recognized, is valid and `m_net` was set
316     * @retval false not recognised (from future?) and should be silently ignored
317     * @throws std::ios_base::failure if the network is one of the BIP155 founding
318     * networks (id 1..6) with wrong address size.
319     */
320    bool SetNetFromBIP155Network(uint8_t possible_bip155_net, size_t address_size);
321
322    /**
323     * Serialize in pre-ADDRv2/BIP155 format to an array.
324     */
325    void SerializeV1Array(uint8_t (&arr)[V1_SERIALIZATION_SIZE]) const
326    {
327        size_t prefix_size;
328
329        switch (m_net) {
330        case NET_IPV6:
331            assert(m_addr.size() == sizeof(arr));
332            memcpy(arr, m_addr.data(), m_addr.size());
333            return;
334        case NET_IPV4:
335            prefix_size = sizeof(IPV4_IN_IPV6_PREFIX);
336            assert(prefix_size + m_addr.size() == sizeof(arr));
337            memcpy(arr, IPV4_IN_IPV6_PREFIX.data(), prefix_size);
338            memcpy(arr + prefix_size, m_addr.data(), m_addr.size());
339            return;
340        case NET_INTERNAL:
341            prefix_size = sizeof(INTERNAL_IN_IPV6_PREFIX);
342            assert(prefix_size + m_addr.size() == sizeof(arr));
343            memcpy(arr, INTERNAL_IN_IPV6_PREFIX.data(), prefix_size);
344            memcpy(arr + prefix_size, m_addr.data(), m_addr.size());
345            return;
346        case NET_ONION:
347        case NET_I2P:
348        case NET_CJDNS:
349            break;
350        case NET_UNROUTABLE:
351        case NET_MAX:
352            assert(false);
353        } // no default case, so the compiler can warn about missing cases
354
355        // Serialize ONION, I2P and CJDNS as all-zeros.
356        memset(arr, 0x0, V1_SERIALIZATION_SIZE);
357    }
358
359    /**
360     * Serialize in pre-ADDRv2/BIP155 format to a stream.
361     */
362    template <typename Stream>
363    void SerializeV1Stream(Stream& s) const
364    {
365        uint8_t serialized[V1_SERIALIZATION_SIZE];
366
367        SerializeV1Array(serialized);
368
369        s << serialized;
370    }
371
372    /**
373     * Serialize as ADDRv2 / BIP155.
374     */
375    template <typename Stream>
376    void SerializeV2Stream(Stream& s) const
377    {
378        if (IsInternal()) {
379            // Serialize NET_INTERNAL as embedded in IPv6. We need to
380            // serialize such addresses from addrman.
381            s << static_cast<uint8_t>(BIP155Network::IPV6);
382            s << COMPACTSIZE(ADDR_IPV6_SIZE);
383            SerializeV1Stream(s);
384            return;
385        }
386
387        s << static_cast<uint8_t>(GetBIP155Network());
388        s << m_addr;
389    }
390
391    /**
392     * Unserialize from a pre-ADDRv2/BIP155 format from an array.
393     *
394     * This function is only called from UnserializeV1Stream() and is a wrapper
395     * for SetLegacyIPv6(); however, we keep it for symmetry with
396     * SerializeV1Array() to have pairs of ser/unser functions and to make clear
397     * that if one is altered, a corresponding reverse modification should be
398     * applied to the other.
399     */
400    void UnserializeV1Array(uint8_t (&arr)[V1_SERIALIZATION_SIZE])
401    {
402        // Use SetLegacyIPv6() so that m_net is set correctly. For example
403        // ::FFFF:0102:0304 should be set as m_net=NET_IPV4 (1.2.3.4).
404        SetLegacyIPv6(arr);
405    }
406
407    /**
408     * Unserialize from a pre-ADDRv2/BIP155 format from a stream.
409     */
410    template <typename Stream>
411    void UnserializeV1Stream(Stream& s)
412    {
413        uint8_t serialized[V1_SERIALIZATION_SIZE];
414
415        s >> serialized;
416
417        UnserializeV1Array(serialized);
418    }
419
420    /**
421     * Unserialize from a ADDRv2 / BIP155 format.
422     */
423    template <typename Stream>
424    void UnserializeV2Stream(Stream& s)
425    {
426        uint8_t bip155_net;
427        s >> bip155_net;
428
429        size_t address_size;
430        s >> COMPACTSIZE(address_size);
431
432        if (address_size > MAX_ADDRV2_SIZE) {
433            throw std::ios_base::failure(strprintf(
434                "Address too long: %u > %u", address_size, MAX_ADDRV2_SIZE));
435        }
436
437        m_scope_id = 0;
438
439        if (SetNetFromBIP155Network(bip155_net, address_size)) {
440            m_addr.resize(address_size);
441            s >> std::span{m_addr};
442
443            if (m_net != NET_IPV6) {
444                return;
445            }
446
447            // Do some special checks on IPv6 addresses.
448
449            // Recognize NET_INTERNAL embedded in IPv6, such addresses are not
450            // gossiped but could be coming from addrman, when unserializing from
451            // disk.
452            if (util::HasPrefix(m_addr, INTERNAL_IN_IPV6_PREFIX)) {
453                m_net = NET_INTERNAL;
454                memmove(m_addr.data(), m_addr.data() + INTERNAL_IN_IPV6_PREFIX.size(),
455                        ADDR_INTERNAL_SIZE);
456                m_addr.resize(ADDR_INTERNAL_SIZE);
457                return;
458            }
459
460            if (!util::HasPrefix(m_addr, IPV4_IN_IPV6_PREFIX) &&
461                !util::HasPrefix(m_addr, TORV2_IN_IPV6_PREFIX)) {
462                return;
463            }
464
465            // IPv4 and TORv2 are not supposed to be embedded in IPv6 (like in V1
466            // encoding). Unserialize as !IsValid(), thus ignoring them.
467        } else {
468            // If we receive an unknown BIP155 network id (from the future?) then
469            // ignore the address - unserialize as !IsValid().
470            s.ignore(address_size);
471        }
472
473        // Mimic a default-constructed CNetAddr object which is !IsValid() and thus
474        // will not be gossiped, but continue reading next addresses from the stream.
475        m_net = NET_IPV6;
476        m_addr.assign(ADDR_IPV6_SIZE, 0x0);
477    }
478};
479
480class CSubNet
481{
482protected:
483    /// Network (base) address
484    CNetAddr network;
485    /// Netmask, in network byte order
486    uint8_t netmask[16];
487    /// Is this value valid? (only used to signal parse errors)
488    bool valid;
489
490public:
491    /**
492     * Construct an invalid subnet (empty, `Match()` always returns false).
493     */
494    CSubNet();
495
496    /**
497     * Construct from a given network start and number of bits (CIDR mask).
498     * @param[in] addr Network start. Must be IPv4 or IPv6, otherwise an invalid subnet is
499     * created.
500     * @param[in] mask CIDR mask, must be in [0, 32] for IPv4 addresses and in [0, 128] for

A READING COMPANION

Source available. Guide coming next.

This file is included in the stable source snapshot. A file-specific guide has not been published yet.

440 guided files · 2,580 pending. Guides cover key sections, not every line.

cmake/bitcoin-build-config.h.in src/consensus/amount.h src/consensus/consensus.h src/primitives/block.h src/primitives/transaction.h src/crypto/sha256.h src/util/moneystr.h src/clientversion.h src/uint256.h src/script/script.h src/policy/policy.h CMakeLists.txt README.md COPYING src/consensus/tx_check.cpp src/consensus/tx_verify.cpp src/consensus/merkle.cpp src/pow.cpp src/validation.cpp src/script/interpreter.cpp src/script/solver.cpp src/script/sign.cpp src/key_io.cpp src/net.cpp src/net_processing.cpp src/netaddress.cpp src/protocol.h src/wallet/wallet.cpp src/wallet/spend.cpp

← Previous 250 linesCode page 2Next 250 lines →

src/wallet/receive.cpp

src/wallet/coinselection.cpp

src/consensus/validation.h

src/primitives/transaction.cpp

src/script/descriptor.cpp

src/bitcoin-cli.cpp

src/rpc/blockchain.cpp

src/rpc/rawtransaction.cpp

src/init.cpp

src/crypto/sha256.cpp

src/consensus/merkle.h

src/consensus/tx_check.h

src/consensus/tx_verify.h

src/policy/feerate.h

src/policy/feerate.cpp

src/primitives/transaction_identifier.h

src/chainparamsbase.h

src/chainparamsbase.cpp

src/util/moneystr.cpp

src/crypto/ripemd160.h

src/crypto/sha1.h

src/crypto/sha512.h

src/crypto/hmac_sha256.h

src/crypto/hmac_sha512.h

src/crypto/hmac_sha256.cpp

src/crypto/hmac_sha512.cpp

src/crypto/hkdf_sha256_32.h

src/crypto/hkdf_sha256_32.cpp

src/support/cleanse.h

src/support/cleanse.cpp

src/crypto/siphash.cpp

src/crypto/muhash.h

src/crypto/chacha20.h

src/crypto/poly1305.h

src/crypto/chacha20poly1305.h

src/crypto/chacha20poly1305.cpp

src/util/chaintype.cpp

src/util/obfuscation.h

src/util/byte_units.h

src/util/overflow.h

src/blockencodings.cpp

src/net_permissions.cpp

src/policy/packages.cpp

src/policy/rbf.cpp

src/policy/truc_policy.cpp

src/policy/ephemeral_policy.cpp

src/policy/settings.cpp

src/policy/policy.cpp

src/node/transaction.cpp

src/node/coin.cpp

src/rpc/client.cpp

src/rpc/external_signer.cpp

src/rpc/request.cpp

src/rpc/server_util.cpp

src/rpc/fees.cpp

src/rpc/output_script.cpp

src/rpc/rawtransaction_util.cpp

src/rpc/rawtransaction_util.h

src/rpc/register.h

src/rpc/request.h

src/rpc/server_util.h

src/rpc/protocol.h

src/rpc/server.h

src/rpc/signmessage.cpp

src/rpc/txoutproof.cpp

src/rpc/util.cpp

src/rpc/util.h

src/wallet/rpc/addresses.cpp

src/wallet/rpc/backup.cpp

src/wallet/rpc/coins.cpp

src/wallet/rpc/encrypt.cpp

src/wallet/rpc/signmessage.cpp

src/wallet/rpc/util.cpp

src/wallet/rpc/util.h

src/wallet/coincontrol.cpp

src/wallet/coincontrol.h

src/wallet/context.cpp

src/wallet/context.h

src/wallet/crypter.cpp

src/wallet/crypter.h

src/wallet/db.cpp

src/wallet/export.cpp

src/wallet/external_signer_scriptpubkeyman.cpp

src/wallet/rpc/spend.cpp

src/wallet/rpc/transactions.cpp

src/wallet/rpc/wallet.cpp

src/wallet/feebumper.cpp

src/wallet/feebumper.h

src/index/base.h

src/index/base.cpp

src/index/txindex.h

src/index/txindex.cpp

src/index/txindex_key.h

src/index/txospenderindex.h

src/index/txospenderindex.cpp

src/index/blockfilterindex.h

src/index/blockfilterindex.cpp

src/index/coinstatsindex.h

src/index/coinstatsindex.cpp

src/index/db_key.h

src/index/disktxpos.h

src/kernel/chain.cpp

src/kernel/chain.h

src/kernel/checks.cpp

src/kernel/checks.h

src/kernel/context.cpp

src/kernel/context.h

src/kernel/cs_main.cpp

src/kernel/cs_main.h

src/kernel/disconnected_transactions.cpp

src/kernel/disconnected_transactions.h

src/kernel/mempool_removal_reason.cpp

src/kernel/mempool_removal_reason.h

src/kernel/coinstats.cpp

src/kernel/coinstats.h

src/kernel/chainparams.cpp

src/kernel/chainparams.h

src/wallet/sqlite.cpp

src/wallet/sqlite.h

src/wallet/transaction.cpp

src/wallet/transaction.h

src/wallet/dump.cpp

src/wallet/dump.h

src/wallet/init.cpp

src/wallet/walletutil.cpp

src/wallet/walletutil.h

src/wallet/wallettool.cpp

src/wallet/wallettool.h

src/wallet/export.h

src/wallet/migrate.cpp

src/wallet/migrate.h

src/wallet/db.h

src/wallet/walletdb.cpp

src/wallet/interfaces.cpp

src/wallet/scriptpubkeyman.cpp

src/wallet/scriptpubkeyman.h

src/kernel/bitcoinkernel.cpp

src/kernel/bitcoinkernel.h

src/kernel/bitcoinkernel_wrapper.h

src/node/chainstate.cpp

src/node/chainstate.h

src/node/blockstorage.cpp

src/node/blockstorage.h

src/node/mempool_persist.cpp

src/node/mempool_persist.h

src/node/utxo_snapshot.cpp

src/node/utxo_snapshot.h

src/node/kernel_notifications.cpp

src/node/kernel_notifications.h

src/node/blockmanager_args.cpp

src/kernel/blockmanager_opts.h

src/util/expected.cpp

src/policy/settings.h

src/util/types.h

src/kernel/messagestartchars.h

src/kernel/warning.h

src/util/exception.h

src/common/license_info.h

src/node/coins_view_args.h

src/node/database_args.h

src/util/batchpriority.h

src/util/ui_change_type.h

src/node/coins_view_args.cpp

src/node/peerman_args.h

src/util/serfloat.h

src/node/blockmanager_args.h

src/node/database_args.cpp

src/util/overloaded.h

src/interfaces/types.h

src/node/chainstatemanager_args.h

src/node/minisketchwrapper.h

src/util/macros.h

src/util/syserror.h

src/common/run_command.h

src/util/bytevectorhash.cpp

src/node/mempool_persist_args.cpp

src/util/exec.h

src/util/rbf.h

src/crypto/hex_base.h

src/node/mempool_persist_args.h

src/interfaces/echo.h

src/util/any.h

src/util/batchpriority.cpp

src/util/threadnames.h

src/node/coin.h

src/node/mempool_args.h

src/util/asmap.h

src/util/bytevectorhash.h

src/node/context.cpp

src/util/insert.h

src/util/readwritefile.h

src/node/peerman_args.cpp

src/node/interface_ui.cpp

src/interfaces/handler.h

src/node/mining_args.h

src/util/hasher.cpp

src/common/init.h

src/kernel/mempool_limits.h

src/common/system.h

src/crypto/sha3.h

src/util/threadinterrupt.cpp

src/node/protocol_version.h

src/util/exception.cpp

src/common/messages.h

src/node/connection_types.cpp

src/util/bip32.h

src/common/license_info.cpp

src/util/stdmutex.h

src/common/run_command.cpp

src/util/check.cpp

src/util/golombrice.h

src/node/types.h

src/node/timeoffsets.h

src/util/readwritefile.cpp

src/util/fastrange.h

src/util/signalinterrupt.h

src/util/task_runner.h

src/util/syserror.cpp

src/common/interfaces.cpp

src/common/types.h

src/util/threadinterrupt.h

src/kernel/chainstatemanager_opts.h

src/node/psbt.h

src/policy/ephemeral_policy.h

src/util/trace.h

src/common/url.cpp

src/kernel/mempool_options.h

src/util/serfloat.cpp

src/kernel/notifications_interface.h

src/node/timeoffsets.cpp

src/node/warnings.cpp

src/util/hash_type.h

src/crypto/hex_base.cpp

src/node/eviction.h

src/util/tokenbucket.h

src/crypto/aes.h

src/common/pcp.h

src/util/feefrac.cpp

src/node/transaction.h

src/util/threadnames.cpp

src/common/signmessage.h

src/util/exec.cpp

src/util/signalinterrupt.cpp

src/clientversion.cpp

src/common/signmessage.cpp

src/compat/assumptions.h

src/compat/byteswap.h

src/deploymentinfo.cpp

src/deploymentinfo.h

src/deploymentstatus.cpp

src/deploymentstatus.h

src/dummywallet.cpp

src/external_signer.h

src/init/bitcoin-gui.cpp

src/init/bitcoin-node.cpp

src/init/bitcoin-qt.cpp

src/init/bitcoin-wallet.cpp

src/init/bitcoind.cpp

src/init/common.h

src/interfaces/init.h

src/interfaces/ipc.h

src/key_io.h

src/logging/categories.h

src/logging/timer.h

src/mapport.h

src/musig.h

src/net_permissions.h

src/netgroup.h

src/netmessagemaker.h

src/node/chainstatemanager_args.cpp

src/node/connection_types.h

src/node/context.h

src/node/interface_ui.h

src/node/mempool_args.cpp

src/node/mining_args.cpp

src/node/minisketchwrapper.cpp

src/node/txreconciliation.h

src/policy/fees/estimator_args.cpp

src/policy/fees/estimator_args.h

src/policy/fees/estimator_man.cpp

src/policy/fees/estimator_man.h

src/policy/packages.h

src/policy/rbf.h

src/policy/truc_policy.h

src/pow.h

src/primitives/block.cpp

src/randomenv.h

src/rest.h

src/script/keyorigin.h

src/script/parsing.cpp

src/script/parsing.h

src/script/script_error.h

src/script/sigcache.cpp

src/script/sigcache.h

src/script/solver.h

src/script/verify_flags.h

src/semaphore_grant.h

src/signet.h

src/span.h

src/support/allocators/secure.h

src/support/allocators/zeroafterfree.h

src/util/tokenpipe.cpp

src/util/translation.h

src/util/vector.h

src/versionbits.h

src/versionbits_impl.h

src/wallet/external_signer_scriptpubkeyman.h

src/wallet/fees.h

src/wallet/load.h

src/wallet/receive.h

src/wallet/rpc/wallet.h

src/wallet/types.h

src/walletinitinterface.h

src/zmq/zmqabstractnotifier.cpp

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.