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

▤ interfaces.cppGuide

▤ license_info.cppGuide

▤ license_info.hGuide

▤ run_command.cppGuide

▤ run_command.hGuide

▤ settings.cpp

▤ settings.h

▤ signmessage.cppGuide

▤ 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 / common / args.cpp

Download source ↓

34,092 bytes · SHA-256 502a01297124ac28… · View upstream ↗

251        }
252    }
253    return true;
254}
255
256std::optional<unsigned int> ArgsManager::GetArgFlags_(const std::string& name) const
257{
258    AssertLockHeld(cs_args);
259    for (const auto& arg_map : m_available_args) {
260        const auto search = arg_map.second.find(name);
261        if (search != arg_map.second.end()) {
262            return search->second.m_flags;
263        }
264    }
265    return m_default_flags;
266}
267
268std::optional<unsigned int> ArgsManager::GetArgFlags(const std::string& name) const
269{
270    LOCK(cs_args);
271    return GetArgFlags_(name);
272}
273
274void ArgsManager::SetDefaultFlags(std::optional<unsigned int> flags)
275{
276    LOCK(cs_args);
277    m_default_flags = flags;
278}
279
280fs::path ArgsManager::GetPathArg_(std::string arg, const fs::path& default_value) const
281{
282    AssertLockHeld(cs_args);
283    const auto value = GetSetting_(arg);
284    if (value.isFalse()) return {};
285    std::string path_str = SettingToString(value, "");
286    if (path_str.empty()) return default_value;
287    fs::path result = fs::PathFromString(path_str).lexically_normal();
288    // Remove trailing slash, if present.
289    return result.has_filename() ? result : result.parent_path();
290}
291
292fs::path ArgsManager::GetPathArg(std::string arg, const fs::path& default_value) const
293{
294    LOCK(cs_args);
295    return GetPathArg_(std::move(arg), default_value);
296}
297
298fs::path ArgsManager::GetBlocksDirPath() const
299{
300    LOCK(cs_args);
301    fs::path& path = m_cached_blocks_path;
302
303    // Cache the path to avoid calling fs::create_directories on every call of
304    // this function
305    if (!path.empty()) return path;
306
307    if (!GetSetting_("-blocksdir").isNull()) {
308        path = fs::absolute(GetPathArg_("-blocksdir"));
309        if (!fs::is_directory(path)) {
310            path = "";
311            return path;
312        }
313    } else {
314        path = GetDataDir(/*net_specific=*/false);
315    }
316
317    path /= fs::PathFromString(BaseParams().DataDir());
318    path /= "blocks";
319    fs::create_directories(path);
320    return path;
321}
322
323fs::path ArgsManager::GetDataDirBase() const {
324    LOCK(cs_args);
325    return GetDataDir(/*net_specific=*/false);
326}
327
328fs::path ArgsManager::GetDataDirNet() const {
329    LOCK(cs_args);
330    return GetDataDir(/*net_specific=*/true);
331}
332
333fs::path ArgsManager::GetDataDir(bool net_specific) const
334{
335    AssertLockHeld(cs_args);
336    fs::path& path = net_specific ? m_cached_network_datadir_path : m_cached_datadir_path;
337
338    // Used cached path if available
339    if (!path.empty()) return path;
340
341    const fs::path datadir{GetPathArg_("-datadir")};
342    if (!datadir.empty()) {
343        path = fs::absolute(datadir);
344        if (!fs::is_directory(path)) {
345            path = "";
346            return path;
347        }
348    } else {
349        path = GetDefaultDataDir();
350    }
351
352    if (net_specific && !BaseParams().DataDir().empty()) {
353        path /= fs::PathFromString(BaseParams().DataDir());
354    }
355
356    return path;
357}
358
359void ArgsManager::ClearPathCache()
360{
361    LOCK(cs_args);
362
363    m_cached_datadir_path = fs::path();
364    m_cached_network_datadir_path = fs::path();
365    m_cached_blocks_path = fs::path();
366}
367
368std::optional<const ArgsManager::Command> ArgsManager::GetCommand() const
369{
370    Command ret;
371    LOCK(cs_args);
372    auto it = m_command.begin();
373    if (it == m_command.end()) {
374        // No command was passed
375        return std::nullopt;
376    }
377    if (!m_accept_any_command) {
378        // The registered command
379        ret.command = *(it++);
380    }
381    while (it != m_command.end()) {
382        // The unregistered command and args (if any)
383        ret.args.push_back(*(it++));
384    }
385    return ret;
386}
387
388bool ArgsManager::CheckCommandOptions(const std::string& command, std::vector<std::string>* errors) const
389{
390    LOCK(cs_args);
391
392    auto command_options = m_available_args.find(OptionsCategory::COMMAND_OPTIONS);
393    if (command_options == m_available_args.end()) {
394        // There are no command-specific options at all, so everything is fine
395        return true;
396    }
397
398    const auto command_args = m_command_args.find(command);
399    auto is_valid_opt = [&](const auto& opt) EXCLUSIVE_LOCKS_REQUIRED(cs_args) -> bool {
400        if (command_args == m_command_args.end()) {
401            // Caller may not have checked that command actually exists
402            // before calling this function.  In that case, treat it as
403            // having no valid command-specific options.
404            return false;
405        } else {
406            return command_args->second.contains(opt);
407        }
408    };
409
410    bool ok = true;
411    for (const auto& [arg, _] : command_options->second) {
412        if (!GetSetting_(arg).isNull() && !is_valid_opt(arg)) {
413            ok = false;
414            if (errors != nullptr) {
415                errors->emplace_back(strprintf("The %s option cannot be used with the '%s' command.", arg, command));
416            }
417        }
418    }
419    return ok;
420}
421
422std::vector<std::string> ArgsManager::GetArgs(const std::string& strArg) const
423{
424    std::vector<std::string> result;
425    for (const common::SettingsValue& value : GetSettingsList(strArg)) {
426        result.push_back(value.isFalse() ? "0" : value.isTrue() ? "1" : value.get_str());
427    }
428    return result;
429}
430
431bool ArgsManager::IsArgSet(const std::string& strArg) const
432{
433    return !GetSetting(strArg).isNull();
434}
435
436bool ArgsManager::GetSettingsPath(fs::path* filepath, bool temp, bool backup) const
437{
438    fs::path settings = GetPathArg("-settings", BITCOIN_SETTINGS_FILENAME);
439    if (settings.empty()) {
440        return false;
441    }
442    if (backup) {
443        settings += ".bak";
444    }
445    if (filepath) {
446        *filepath = fsbridge::AbsPathJoin(GetDataDirNet(), temp ? settings + ".tmp" : settings);
447    }
448    return true;
449}
450
451static void SaveErrors(const std::vector<std::string> errors, std::vector<std::string>* error_out)
452{
453    for (const auto& error : errors) {
454        if (error_out) {
455            error_out->emplace_back(error);
456        } else {
457            LogWarning("%s", error);
458        }
459    }
460}
461
462bool ArgsManager::ReadSettingsFile(std::vector<std::string>* errors)
463{
464    fs::path path;
465    if (!GetSettingsPath(&path, /* temp= */ false)) {
466        return true; // Do nothing if settings file disabled.
467    }
468
469    LOCK(cs_args);
470    m_settings.rw_settings.clear();
471    std::vector<std::string> read_errors;
472    if (!common::ReadSettings(path, m_settings.rw_settings, read_errors)) {
473        SaveErrors(read_errors, errors);
474        return false;
475    }
476    for (const auto& setting : m_settings.rw_settings) {
477        KeyInfo key = InterpretKey(setting.first); // Split setting key into section and argname
478        if (!GetArgFlags_('-' + key.name)) {
479            LogWarning("Ignoring unknown rw_settings value %s", setting.first);
480        }
481    }
482    return true;
483}
484
485bool ArgsManager::WriteSettingsFile(std::vector<std::string>* errors, bool backup) const
486{
487    fs::path path, path_tmp;
488    if (!GetSettingsPath(&path, /*temp=*/false, backup) || !GetSettingsPath(&path_tmp, /*temp=*/true, backup)) {
489        throw std::logic_error("Attempt to write settings file when dynamic settings are disabled.");
490    }
491
492    LOCK(cs_args);
493    std::vector<std::string> write_errors;
494    if (!common::WriteSettings(path_tmp, m_settings.rw_settings, write_errors)) {
495        SaveErrors(write_errors, errors);
496        return false;
497    }
498    if (!RenameOver(path_tmp, path)) {
499        SaveErrors({strprintf("Failed renaming settings file %s to %s\n", fs::PathToString(path_tmp), fs::PathToString(path))}, errors);
500        return false;

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.