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.

4,559 bytes · SHA-256 2e417383f75c17a5… · View upstream ↗

1// Copyright (c) 2009-present The Bitcoin Core developers
2// Distributed under the MIT software license, see the accompanying
3// file COPYING or https://opensource.org/license/mit/.
4
5#include <memusage.h>
6#include <span.h>
7#include <streams.h>
8#include <util/fs_helpers.h>
9#include <util/obfuscation.h>
10
11#include <array>
12
13AutoFile::AutoFile(std::FILE* file, const Obfuscation& obfuscation) : m_file{file}, m_obfuscation{obfuscation}
14{
15    if (!IsNull()) {
16        auto pos{FileTell64(m_file)};
17        if (pos >= 0) m_position = pos;
18    }
19}
20
21std::size_t AutoFile::detail_fread(std::span<std::byte> dst)
22{
23    if (!m_file) throw std::ios_base::failure("AutoFile::read: file handle is nullptr");
24    const size_t ret = std::fread(dst.data(), 1, dst.size(), m_file);
25    if (m_obfuscation) {
26        if (!m_position) throw std::ios_base::failure("AutoFile::read: position unknown");
27        m_obfuscation(dst.subspan(0, ret), *m_position);
28    }
29    if (m_position) *m_position += ret;
30    return ret;
31}
32
33void AutoFile::seek(int64_t offset, int origin)
34{
35    if (IsNull()) {
36        throw std::ios_base::failure("AutoFile::seek: file handle is nullptr");
37    }
38    if (FileSeek64(m_file, offset, origin) != 0) {
39        throw std::ios_base::failure(feof() ? "AutoFile::seek: end of file" : "AutoFile::seek: fseek failed");
40    }
41    if (origin == SEEK_SET) {
42        m_position = offset;
43    } else if (origin == SEEK_CUR && m_position.has_value()) {
44        *m_position += offset;
45    } else {
46        int64_t r{FileTell64(m_file)};
47        if (r < 0) {
48            throw std::ios_base::failure("AutoFile::seek: ftell failed");
49        }
50        m_position = r;
51    }
52}
53
54int64_t AutoFile::tell()
55{
56    if (!m_position.has_value()) throw std::ios_base::failure("AutoFile::tell: position unknown");
57    return *m_position;
58}
59
60int64_t AutoFile::size()
61{
62    if (IsNull()) {
63        throw std::ios_base::failure("AutoFile::size: file handle is nullptr");
64    }
65    // Temporarily save the current position
66    int64_t current_pos = tell();
67    seek(0, SEEK_END);
68    int64_t file_size = tell();
69    // Restore the original position
70    seek(current_pos, SEEK_SET);
71    return file_size;
72}
73
74void AutoFile::read(std::span<std::byte> dst)
75{
76    if (detail_fread(dst) != dst.size()) {
77        throw std::ios_base::failure(feof() ? "AutoFile::read: end of file" : "AutoFile::read: fread failed");
78    }
79}
80
81void AutoFile::ignore(size_t nSize)
82{
83    if (!m_file) throw std::ios_base::failure("AutoFile::ignore: file handle is nullptr");
84    unsigned char data[4096];
85    while (nSize > 0) {
86        size_t nNow = std::min<size_t>(nSize, sizeof(data));
87        if (std::fread(data, 1, nNow, m_file) != nNow) {
88            throw std::ios_base::failure(feof() ? "AutoFile::ignore: end of file" : "AutoFile::ignore: fread failed");
89        }
90        nSize -= nNow;
91        if (m_position.has_value()) *m_position += nNow;
92    }
93}
94
95void AutoFile::write(std::span<const std::byte> src)
96{
97    if (!m_file) throw std::ios_base::failure("AutoFile::write: file handle is nullptr");
98    if (!m_obfuscation) {
99        if (std::fwrite(src.data(), 1, src.size(), m_file) != src.size()) {
100            throw std::ios_base::failure("AutoFile::write: write failed");
101        }
102        m_was_written = true;
103        if (m_position.has_value()) *m_position += src.size();
104    } else {
105        std::array<std::byte, 4096> buf;
106        while (src.size()) {
107            auto buf_now{std::span{buf}.first(std::min<size_t>(src.size(), buf.size()))};
108            std::copy_n(src.begin(), buf_now.size(), buf_now.begin());
109            write_buffer(buf_now);
110            src = src.subspan(buf_now.size());
111        }
112    }
113}
114
115void AutoFile::write_buffer(std::span<std::byte> src)
116{
117    if (!m_file) throw std::ios_base::failure("AutoFile::write_buffer: file handle is nullptr");
118    if (m_obfuscation) {
119        if (!m_position) throw std::ios_base::failure("AutoFile::write_buffer: obfuscation position unknown");
120        m_obfuscation(src, *m_position); // obfuscate in-place
121    }
122    if (std::fwrite(src.data(), 1, src.size(), m_file) != src.size()) {
123        throw std::ios_base::failure("AutoFile::write_buffer: write failed");
124    }
125    m_was_written = true;
126    if (m_position) *m_position += src.size();
127}
128
129bool AutoFile::Commit()
130{
131    return ::FileCommit(m_file);
132}
133
134bool AutoFile::Truncate(uint64_t size)
135{
136    m_was_written = true;
137    return ::TruncateFile(m_file, size);
138}
139
140size_t DataStream::GetMemoryUsage() const noexcept
141{
142    return sizeof(*this) + memusage::DynamicUsage(vch);
143}
144

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.