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 / net.h

Download source ↓

81,868 bytes · SHA-256 056a59bbafb97c33… · View upstream ↗

751    const uint64_t nKeyedNetGroup;
752    std::atomic_bool fPauseRecv{false};
753    std::atomic_bool fPauseSend{false};
754    /** When was fPauseSend last set from false to true */
755    std::atomic<NodeClock::time_point> m_pause_send_since{NodeClock::epoch};
756
757    /** Network key used to prevent fingerprinting our node across networks.
758     *  Influenced by the network and the bind address (+ bind port for inbounds) */
759    const uint64_t m_network_key;
760
761    const ConnectionType m_conn_type;
762
763    /** Move all messages from the received queue to the processing queue. */
764    void MarkReceivedMsgsForProcessing()
765        EXCLUSIVE_LOCKS_REQUIRED(!m_msg_process_queue_mutex);
766
767    /** Poll the next message from the processing queue of this connection.
768     *
769     * Returns std::nullopt if the processing queue is empty, or a pair
770     * consisting of the message and a bool that indicates if the processing
771     * queue has more entries. */
772    std::optional<std::pair<CNetMessage, bool>> PollMessage()
773        EXCLUSIVE_LOCKS_REQUIRED(!m_msg_process_queue_mutex);
774
775    /** Account for the total size of a sent message in the per msg type connection stats. */
776    void AccountForSentBytes(const std::string& msg_type, size_t sent_bytes)
777        EXCLUSIVE_LOCKS_REQUIRED(cs_vSend)
778    {
779        mapSendBytesPerMsgType[msg_type] += sent_bytes;
780    }
781
782    bool IsOutboundOrBlockRelayConn() const {
783        switch (m_conn_type) {
784            case ConnectionType::OUTBOUND_FULL_RELAY:
785            case ConnectionType::BLOCK_RELAY:
786                return true;
787            case ConnectionType::INBOUND:
788            case ConnectionType::MANUAL:
789            case ConnectionType::ADDR_FETCH:
790            case ConnectionType::FEELER:
791            case ConnectionType::PRIVATE_BROADCAST:
792                return false;
793        } // no default case, so the compiler can warn about missing cases
794
795        assert(false);
796    }
797
798    bool IsFullOutboundConn() const {
799        return m_conn_type == ConnectionType::OUTBOUND_FULL_RELAY;
800    }
801
802    bool IsManualConn() const {
803        return m_conn_type == ConnectionType::MANUAL;
804    }
805
806    bool IsManualOrFullOutboundConn() const
807    {
808        switch (m_conn_type) {
809        case ConnectionType::INBOUND:
810        case ConnectionType::FEELER:
811        case ConnectionType::BLOCK_RELAY:
812        case ConnectionType::ADDR_FETCH:
813        case ConnectionType::PRIVATE_BROADCAST:
814                return false;
815        case ConnectionType::OUTBOUND_FULL_RELAY:
816        case ConnectionType::MANUAL:
817                return true;
818        } // no default case, so the compiler can warn about missing cases
819
820        assert(false);
821    }
822
823    bool IsBlockOnlyConn() const {
824        return m_conn_type == ConnectionType::BLOCK_RELAY;
825    }
826
827    bool IsFeelerConn() const {
828        return m_conn_type == ConnectionType::FEELER;
829    }
830
831    bool IsAddrFetchConn() const {
832        return m_conn_type == ConnectionType::ADDR_FETCH;
833    }
834
835    bool IsPrivateBroadcastConn() const
836    {
837        return m_conn_type == ConnectionType::PRIVATE_BROADCAST;
838    }
839
840    /** Protocol version advertised in our VERSION message.
841     *  Private broadcast connections use a fixed version to maximise anonymity. */
842    int AdvertisedVersion() const
843    {
844        return IsPrivateBroadcastConn() ? WTXID_RELAY_VERSION : PROTOCOL_VERSION;
845    }
846
847    bool IsInboundConn() const {
848        return m_conn_type == ConnectionType::INBOUND;
849    }
850
851    bool ExpectServicesFromConn() const {
852        switch (m_conn_type) {
853            case ConnectionType::INBOUND:
854            case ConnectionType::MANUAL:
855            case ConnectionType::FEELER:
856                return false;
857            case ConnectionType::OUTBOUND_FULL_RELAY:
858            case ConnectionType::BLOCK_RELAY:
859            case ConnectionType::ADDR_FETCH:
860            case ConnectionType::PRIVATE_BROADCAST:
861                return true;
862        } // no default case, so the compiler can warn about missing cases
863
864        assert(false);
865    }
866
867    /**
868     * Get network the peer connected through.
869     *
870     * Returns Network::NET_ONION for *inbound* onion connections,
871     * and CNetAddr::GetNetClass() otherwise. The latter cannot be used directly
872     * because it doesn't detect the former, and it's not the responsibility of
873     * the CNetAddr class to know the actual network a peer is connected through.
874     *
875     * @return network the peer connected through.
876     */
877    Network ConnectedThroughNetwork() const;
878
879    /** Whether this peer connected through a privacy network. */
880    [[nodiscard]] bool IsConnectedThroughPrivacyNet() const;
881
882    // We selected peer as (compact blocks) high-bandwidth peer (BIP152)
883    std::atomic<bool> m_bip152_highbandwidth_to{false};
884    // Peer selected us as (compact blocks) high-bandwidth peer (BIP152)
885    std::atomic<bool> m_bip152_highbandwidth_from{false};
886
887    /** Whether this peer provides all services that we want. Used for eviction decisions */
888    std::atomic_bool m_has_all_wanted_services{false};
889
890    /** Whether we should relay transactions to this peer. This only changes
891     * from false to true. It will never change back to false. */
892    std::atomic_bool m_relays_txs{false};
893
894    /** Whether this peer has loaded a bloom filter. Used only in inbound
895     *  eviction logic. */
896    std::atomic_bool m_bloom_filter_loaded{false};
897
898    /// UNIX epoch time of the last block received from this peer that we had
899    /// not yet seen (e.g. not already received from another peer), that passed
900    /// preliminary validity checks and was saved to disk, even if we don't
901    /// connect the block or it eventually fails to connect. Used as an inbound
902    /// peer eviction criterion in CConnman::AttemptToEvictConnection.
903    std::atomic<std::chrono::seconds> m_last_block_time{0s};
904
905    /// UNIX epoch time of the last transaction received from this peer that we
906    /// had not yet seen (e.g. not already received from another peer) and that
907    /// was accepted into our mempool. Used as an inbound peer eviction criterion
908    /// in CConnman::AttemptToEvictConnection.
909    std::atomic<std::chrono::seconds> m_last_tx_time{0s};
910
911    /// Last measured round-trip duration. Used only for stats.
912    std::atomic<NodeClock::duration> m_last_ping_time{0us};
913
914    /// Lowest measured round-trip duration. Used as an inbound peer eviction
915    /// criterion in CConnman::AttemptToEvictConnection.
916    std::atomic<NodeClock::duration> m_min_ping_time{NodeClock::duration::max()};
917
918    CNode(NodeId id,
919          std::shared_ptr<Sock> sock,
920          const CAddress& addrIn,
921          uint64_t nKeyedNetGroupIn,
922          uint64_t nLocalHostNonceIn,
923          const CService& addrBindIn,
924          const std::string& addrNameIn,
925          ConnectionType conn_type_in,
926          bool inbound_onion,
927          uint64_t network_key,
928          CNodeOptions&& node_opts = {});
929    CNode(const CNode&) = delete;
930    CNode& operator=(const CNode&) = delete;
931
932    NodeId GetId() const {
933        return id;
934    }
935
936    uint64_t GetLocalNonce() const {
937        return nLocalHostNonce;
938    }
939
940    int GetRefCount() const
941    {
942        assert(nRefCount >= 0);
943        return nRefCount;
944    }
945
946    /**
947     * Receive bytes from the buffer and deserialize them into messages.
948     *
949     * @param[in]   msg_bytes   The raw data
950     * @param[out]  complete    Set True if at least one message has been
951     *                          deserialized and is ready to be processed
952     * @return  True if the peer should stay connected,
953     *          False if the peer should be disconnected from.
954     */
955    bool ReceiveMsgBytes(std::span<const uint8_t> msg_bytes, bool& complete) EXCLUSIVE_LOCKS_REQUIRED(!cs_vRecv);
956
957    void SetCommonVersion(int greatest_common_version)
958    {
959        Assume(m_greatest_common_version == INIT_PROTO_VERSION);
960        m_greatest_common_version = greatest_common_version;
961    }
962    int GetCommonVersion() const
963    {
964        return m_greatest_common_version;
965    }
966
967    CService GetAddrLocal() const EXCLUSIVE_LOCKS_REQUIRED(!m_addr_local_mutex);
968    //! May not be called more than once
969    void SetAddrLocal(const CService& addrLocalIn) EXCLUSIVE_LOCKS_REQUIRED(!m_addr_local_mutex);
970
971    CNode* AddRef()
972    {
973        nRefCount++;
974        return this;
975    }
976
977    void Release()
978    {
979        nRefCount--;
980    }
981
982    void CloseSocketDisconnect() EXCLUSIVE_LOCKS_REQUIRED(!m_sock_mutex);
983
984    void CopyStats(CNodeStats& stats) EXCLUSIVE_LOCKS_REQUIRED(!m_subver_mutex, !m_addr_local_mutex, !cs_vSend, !cs_vRecv);
985
986    std::string ConnectionTypeAsString() const { return ::ConnectionTypeAsString(m_conn_type); }
987
988    /**
989     * Helper function to log the peer id, optionally including IP address.
990     *
991     * @return "peer=..." and optionally ", peeraddr=..."
992     */
993    std::string LogPeer() const;
994
995    /**
996     * Helper function to log disconnects.
997     *
998     * @return "disconnecting peer=..." and optionally ", peeraddr=..."
999     */
1000    std::string DisconnectMsg() const;

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 4Next 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.