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.

5,936 bytes · SHA-256 e0ec9aeeddaf571f… · 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 <util/time.h>
7
8#include <tinyformat.h>
9#include <util/check.h>
10#include <util/strencodings.h>
11
12#include <array>
13#include <atomic>
14#include <chrono>
15#include <compare>
16#include <optional>
17#include <string>
18#include <string_view>
19#include <thread>
20
21#ifdef WIN32
22#include <winsock2.h>
23#else
24#include <sys/time.h>
25#endif
26
27static constexpr std::array<std::string_view, 7> weekdays{"Thu", "Fri", "Sat", "Sun", "Mon", "Tue", "Wed"}; // 1970-01-01 was a Thursday.
28static constexpr std::array<std::string_view, 12> months{"Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"};
29
30void UninterruptibleSleep(const std::chrono::microseconds& n) { std::this_thread::sleep_for(n); }
31
32static std::atomic<std::chrono::seconds> g_mock_time{}; //!< For testing
33std::atomic<bool> g_used_system_time{false};
34static std::atomic<MockableSteadyClock::mock_time_point::duration> g_mock_steady_time{}; //!< For testing
35
36static_assert(NodeClock::epoch.time_since_epoch().count() == 0);
37
38NodeClock::time_point NodeClock::now() noexcept
39{
40    const auto mocktime{g_mock_time.load(std::memory_order_relaxed)};
41    if (!mocktime.count()) {
42        g_used_system_time = true;
43    }
44    const auto ret{
45        mocktime.count() ?
46            mocktime :
47            std::chrono::system_clock::now().time_since_epoch()};
48    assert(ret > 0s);
49    return time_point{ret};
50};
51
52void SetMockTime(std::chrono::time_point<NodeClock, std::chrono::seconds> mock) { SetMockTime(mock.time_since_epoch()); }
53void SetMockTime(std::chrono::seconds mock_time_in)
54{
55    Assert(mock_time_in >= 0s);
56    g_mock_time.store(mock_time_in, std::memory_order_relaxed);
57}
58
59std::chrono::seconds GetMockTime()
60{
61    return g_mock_time.load(std::memory_order_relaxed);
62}
63
64MockableSteadyClock::time_point MockableSteadyClock::now() noexcept
65{
66    const auto mocktime{g_mock_steady_time.load(std::memory_order_relaxed)};
67    if (!mocktime.count()) {
68        g_used_system_time = true;
69    }
70    const auto ret{
71        mocktime.count() ?
72            mocktime :
73            std::chrono::steady_clock::now().time_since_epoch()};
74    return time_point{ret};
75};
76
77void MockableSteadyClock::SetMockTime(mock_time_point::duration mock_time_in)
78{
79    Assert(mock_time_in >= 0s);
80    g_mock_steady_time.store(mock_time_in, std::memory_order_relaxed);
81}
82
83void MockableSteadyClock::ClearMockTime()
84{
85    g_mock_steady_time.store(0ms, std::memory_order_relaxed);
86}
87
88int64_t GetTime() { return GetTime<std::chrono::seconds>().count(); }
89
90std::string FormatISO8601DateTime(int64_t nTime)
91{
92    const std::chrono::sys_seconds secs{std::chrono::seconds{nTime}};
93    const auto days{std::chrono::floor<std::chrono::days>(secs)};
94    const std::chrono::year_month_day ymd{days};
95    const std::chrono::hh_mm_ss hms{secs - days};
96    return strprintf("%04i-%02u-%02uT%02i:%02i:%02iZ", signed{ymd.year()}, unsigned{ymd.month()}, unsigned{ymd.day()}, hms.hours().count(), hms.minutes().count(), hms.seconds().count());
97}
98
99std::string FormatISO8601Date(int64_t nTime)
100{
101    const std::chrono::sys_seconds secs{std::chrono::seconds{nTime}};
102    const auto days{std::chrono::floor<std::chrono::days>(secs)};
103    const std::chrono::year_month_day ymd{days};
104    return strprintf("%04i-%02u-%02u", signed{ymd.year()}, unsigned{ymd.month()}, unsigned{ymd.day()});
105}
106
107std::optional<int64_t> ParseISO8601DateTime(std::string_view str)
108{
109    constexpr auto FMT_SIZE{std::string_view{"2000-01-01T01:01:01Z"}.size()};
110    if (str.size() != FMT_SIZE || str[4] != '-' || str[7] != '-' || str[10] != 'T' || str[13] != ':' || str[16] != ':' || str[19] != 'Z') {
111        return {};
112    }
113    const auto year{ToIntegral<uint16_t>(str.substr(0, 4))};
114    const auto month{ToIntegral<uint8_t>(str.substr(5, 2))};
115    const auto day{ToIntegral<uint8_t>(str.substr(8, 2))};
116    const auto hour{ToIntegral<uint8_t>(str.substr(11, 2))};
117    const auto min{ToIntegral<uint8_t>(str.substr(14, 2))};
118    const auto sec{ToIntegral<uint8_t>(str.substr(17, 2))};
119    if (!year || !month || !day || !hour || !min || !sec) {
120        return {};
121    }
122    const std::chrono::year_month_day ymd{std::chrono::year{*year}, std::chrono::month{*month}, std::chrono::day{*day}};
123    if (!ymd.ok()) {
124        return {};
125    }
126    const auto time{std::chrono::hours{*hour} + std::chrono::minutes{*min} + std::chrono::seconds{*sec}};
127    const auto tp{std::chrono::sys_days{ymd} + time};
128    return int64_t{TicksSinceEpoch<std::chrono::seconds>(tp)};
129}
130
131std::string FormatRFC1123DateTime(int64_t time)
132{
133    if (time < -62167219200 || 253402300799 < time) {
134        // 4-digit year, so only support years 0 to 9999
135        return "";
136    }
137    const std::chrono::sys_seconds secs{std::chrono::seconds{time}};
138    const auto days{std::chrono::floor<std::chrono::days>(secs)};
139    const auto w{days.time_since_epoch().count() % 7}; // will be in the range [-6, 6]
140    std::string_view weekday{weekdays.at(w >= 0 ? w : w + 7)};
141    const std::chrono::year_month_day ymd{days};
142    std::string_view month{months.at(unsigned{ymd.month()} - 1)};
143    const std::chrono::hh_mm_ss hms{secs - days};
144    // examples: Mon, 27 Jul 2009 12:28:53 GMT
145    //           Fri, 31 May 2024 19:18:04 GMT
146    return strprintf("%03s, %02u %03s %04i %02i:%02i:%02i GMT", weekday, unsigned{ymd.day()}, month, signed{ymd.year()}, hms.hours().count(), hms.minutes().count(), hms.seconds().count());
147}
148
149struct timeval MillisToTimeval(int64_t nTimeout)
150{
151    struct timeval timeout;
152    timeout.tv_sec  = nTimeout / 1000;
153    timeout.tv_usec = (nTimeout % 1000) * 1000;
154    return timeout;
155}
156
157struct timeval MillisToTimeval(std::chrono::milliseconds ms)
158{
159    return MillisToTimeval(count_milliseconds(ms));
160}
161

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.