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 server340 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.

14,138 bytes · SHA-256 74ed6ccd8bb67980… · View upstream ↗

1// Copyright (c) 2009-2010 Satoshi Nakamoto
2// Copyright (c) 2009-present The Bitcoin Core developers
3// Distributed under the MIT software license, see the accompanying
4// file COPYING or http://www.opensource.org/licenses/mit-license.php.
5
6#include <bitcoin-build-config.h> // IWYU pragma: keep
7
8#include <randomenv.h>
9
10#include <clientversion.h>
11#include <compat/compat.h>
12#include <compat/cpuid.h>
13#include <crypto/sha512.h>
14#include <span.h>
15#include <support/cleanse.h>
16#include <util/byte_units.h>
17#include <util/time.h>
18
19#include <algorithm>
20#include <atomic>
21#include <cstdint>
22#include <cstring>
23#include <chrono>
24#include <climits>
25#include <thread>
26#include <vector>
27
28#include <sys/types.h> // must go before a number of other headers
29
30#ifdef WIN32
31#include <windows.h>
32#else
33#include <fcntl.h>
34#include <netinet/in.h>
35#include <sys/resource.h>
36#include <sys/socket.h>
37#include <sys/stat.h>
38#include <sys/time.h>
39#include <sys/utsname.h>
40#include <unistd.h>
41#endif
42#ifdef HAVE_IFADDRS
43#include <ifaddrs.h>
44#endif
45#ifdef HAVE_SYSCTL
46#include <sys/sysctl.h>
47#if __has_include(<vm/vm_param.h>)
48#include <vm/vm_param.h>
49#endif
50#if __has_include(<sys/resources.h>)
51#include <sys/resources.h>
52#endif
53#if __has_include(<sys/vmmeter.h>)
54#include <sys/vmmeter.h>
55#endif
56#endif
57#if defined(HAVE_STRONG_GETAUXVAL)
58#include <sys/auxv.h>
59#endif
60
61#if defined(__APPLE__) || \
62    defined(__FreeBSD__) || \
63    defined(__NetBSD__) || \
64    defined(__OpenBSD__) || \
65    defined(__illumos__)
66extern char** environ; // Necessary on the above platforms
67#endif
68
69namespace {
70
71/** Helper to easily feed data into a CSHA512.
72 *
73 * Note that this does not serialize the passed object (like stream.h's << operators do).
74 * Its raw memory representation is used directly.
75 */
76template<typename T>
77CSHA512& operator<<(CSHA512& hasher, const T& data) {
78    static_assert(!std::is_same_v<std::decay_t<T>, char*>, "Calling operator<<(CSHA512, char*) is probably not what you want");
79    static_assert(!std::is_same_v<std::decay_t<T>, unsigned char*>, "Calling operator<<(CSHA512, unsigned char*) is probably not what you want");
80    static_assert(!std::is_same_v<std::decay_t<T>, const char*>, "Calling operator<<(CSHA512, const char*) is probably not what you want");
81    static_assert(!std::is_same_v<std::decay_t<T>, const unsigned char*>, "Calling operator<<(CSHA512, const unsigned char*) is probably not what you want");
82    hasher.Write((const unsigned char*)&data, sizeof(data));
83    return hasher;
84}
85
86#ifndef WIN32
87void AddSockaddr(CSHA512& hasher, const struct sockaddr *addr)
88{
89    if (addr == nullptr) return;
90    switch (addr->sa_family) {
91    case AF_INET:
92        hasher.Write((const unsigned char*)addr, sizeof(sockaddr_in));
93        break;
94    case AF_INET6:
95        hasher.Write((const unsigned char*)addr, sizeof(sockaddr_in6));
96        break;
97    default:
98        hasher.Write((const unsigned char*)&addr->sa_family, sizeof(addr->sa_family));
99    }
100}
101
102void AddFile(CSHA512& hasher, const char *path)
103{
104    struct stat sb = {};
105    int f = open(path, O_RDONLY);
106    size_t total = 0;
107    if (f != -1) {
108        unsigned char fbuf[4096];
109        int n;
110        hasher.Write((const unsigned char*)&f, sizeof(f));
111        if (fstat(f, &sb) == 0) hasher << sb;
112        do {
113            n = read(f, fbuf, sizeof(fbuf));
114            if (n > 0) hasher.Write(fbuf, n);
115            total += n;
116            /* not bothering with EINTR handling. */
117        } while (n == sizeof(fbuf) && total < 1_MiB); // Read only the first 1 Mbyte
118        close(f);
119    }
120}
121
122void AddPath(CSHA512& hasher, const char *path)
123{
124    struct stat sb = {};
125    if (stat(path, &sb) == 0) {
126        hasher.Write((const unsigned char*)path, strlen(path) + 1);
127        hasher << sb;
128    }
129}
130#endif
131
132#ifdef HAVE_SYSCTL
133template<int... S>
134void AddSysctl(CSHA512& hasher)
135{
136    int CTL[sizeof...(S)] = {S...};
137    unsigned char buffer[65536];
138    size_t siz = 65536;
139    int ret = sysctl(CTL, sizeof...(S), buffer, &siz, nullptr, 0);
140    if (ret == 0 || (ret == -1 && errno == ENOMEM)) {
141        hasher << sizeof(CTL);
142        hasher.Write((const unsigned char*)CTL, sizeof(CTL));
143        if (siz > sizeof(buffer)) siz = sizeof(buffer);
144        hasher << siz;
145        hasher.Write(buffer, siz);
146    }
147}
148#endif
149
150#ifdef HAVE_GETCPUID
151void inline AddCPUID(CSHA512& hasher, uint32_t leaf, uint32_t subleaf, uint32_t& ax, uint32_t& bx, uint32_t& cx, uint32_t& dx)
152{
153    GetCPUID(leaf, subleaf, ax, bx, cx, dx);
154    hasher << leaf << subleaf << ax << bx << cx << dx;
155}
156
157void AddAllCPUID(CSHA512& hasher)
158{
159    uint32_t ax, bx, cx, dx;
160    // Iterate over all standard leaves
161    AddCPUID(hasher, 0, 0, ax, bx, cx, dx); // Returns max leaf in ax
162    uint32_t max = ax;
163    for (uint32_t leaf = 1; leaf <= max && leaf <= 0xFF; ++leaf) {
164        uint32_t maxsub = 0;
165        for (uint32_t subleaf = 0; subleaf <= 0xFF; ++subleaf) {
166            AddCPUID(hasher, leaf, subleaf, ax, bx, cx, dx);
167            // Iterate subleafs for leaf values 4, 7, 11, 13
168            if (leaf == 4) {
169                if ((ax & 0x1f) == 0) break;
170            } else if (leaf == 7) {
171                if (subleaf == 0) maxsub = ax;
172                if (subleaf == maxsub) break;
173            } else if (leaf == 11) {
174                if ((cx & 0xff00) == 0) break;
175            } else if (leaf == 13) {
176                if (ax == 0 && bx == 0 && cx == 0 && dx == 0) break;
177            } else {
178                // For any other leaf, stop after subleaf 0.
179                break;
180            }
181        }
182    }
183    // Iterate over all extended leaves
184    AddCPUID(hasher, 0x80000000, 0, ax, bx, cx, dx); // Returns max extended leaf in ax
185    uint32_t ext_max = ax;
186    for (uint32_t leaf = 0x80000001; leaf <= ext_max && leaf <= 0x800000FF; ++leaf) {
187        AddCPUID(hasher, leaf, 0, ax, bx, cx, dx);
188    }
189}
190#endif
191} // namespace
192
193void RandAddDynamicEnv(CSHA512& hasher)
194{
195    // Various clocks
196#ifdef WIN32
197    FILETIME ftime;
198    GetSystemTimeAsFileTime(&ftime);
199    hasher << ftime;
200#else
201    struct timespec ts = {};
202#    ifdef CLOCK_MONOTONIC
203    clock_gettime(CLOCK_MONOTONIC, &ts);
204    hasher << ts;
205#    endif
206#    ifdef CLOCK_REALTIME
207    clock_gettime(CLOCK_REALTIME, &ts);
208    hasher << ts;
209#    endif
210#    ifdef CLOCK_BOOTTIME
211    clock_gettime(CLOCK_BOOTTIME, &ts);
212    hasher << ts;
213#    endif
214    // gettimeofday is available on all UNIX systems, but only has microsecond precision.
215    struct timeval tv = {};
216    gettimeofday(&tv, nullptr);
217    hasher << tv;
218#endif
219    // Probably redundant, but also use all the standard library clocks:
220    hasher << std::chrono::system_clock::now().time_since_epoch().count();
221    hasher << std::chrono::steady_clock::now().time_since_epoch().count();
222    hasher << std::chrono::high_resolution_clock::now().time_since_epoch().count();
223
224#ifndef WIN32
225    // Current resource usage.
226    struct rusage usage = {};
227    if (getrusage(RUSAGE_SELF, &usage) == 0) hasher << usage;
228#endif
229
230#ifdef __linux__
231    AddFile(hasher, "/proc/diskstats");
232    AddFile(hasher, "/proc/vmstat");
233    AddFile(hasher, "/proc/schedstat");
234    AddFile(hasher, "/proc/zoneinfo");
235    AddFile(hasher, "/proc/meminfo");
236    AddFile(hasher, "/proc/softirqs");
237    AddFile(hasher, "/proc/stat");
238    AddFile(hasher, "/proc/self/schedstat");
239    AddFile(hasher, "/proc/self/status");
240#endif
241
242#ifdef HAVE_SYSCTL
243#  ifdef CTL_KERN
244#    if defined(KERN_PROC) && defined(KERN_PROC_ALL)
245    AddSysctl<CTL_KERN, KERN_PROC, KERN_PROC_ALL>(hasher);
246#    endif
247#  endif
248#  ifdef CTL_HW
249#    ifdef HW_DISKSTATS
250    AddSysctl<CTL_HW, HW_DISKSTATS>(hasher);

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

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.