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

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

▤ chainparamsbase.cppGuide

▤ chainparamsbase.hGuide

▤ chainparamsseeds.h

▤ checkqueue.hGuide

▤ clientversion.cpp

▤ clientversion.hGuide

▤ cluster_linearize.h

▤ CMakeLists.txt

▤ coins.cppGuide

▤ coins.hGuide

▤ compressor.cppGuide

▤ deploymentstatus.cpp

▤ deploymentstatus.h

▤ dummywallet.cpp

▤ external_signer.cpp

▤ merkleblock.cppGuide

▤ merkleblock.hGuide

▤ musig.cpp

▤ musig.h

▤ net_permissions.cppGuide

▤ net_permissions.h

▤ net_processing.cppGuide

▤ netaddress.cppGuide

▤ private_broadcast.cpp

▤ private_broadcast.h

▤ threadsafety.hGuide

▤ tinyformat.h

▤ torcontrol.cppGuide

▤ validation.cppGuide

▤ validation.h

▤ validationinterface.cpp

▤ validationinterface.h

▤ versionbits_impl.h

▤ versionbits.cpp

▤ versionbits.h

▤ walletinitinterface.h

▤ CMakeLists.txtGuide

▤ libbitcoinkernel.pc.in

bitcoin / src / dbwrapper.cpp

Download source ↓

15,441 bytes · SHA-256 3ecd43525a45dbf0… · View upstream ↗

251    DBContext().syncoptions.sync = true;
252    DBContext().options = GetOptions(params.cache_bytes, params.bloom_filter);
253    DBContext().options.create_if_missing = true;
254    DBContext().options.max_file_size = params.max_file_size;
255    assert(!(params.testing_env && params.memory_only));
256    if (params.testing_env) {
257        DBContext().options.env = params.testing_env;
258    } else if (params.memory_only) {
259        DBContext().penv = leveldb::NewMemEnv(leveldb::Env::Default());
260        DBContext().options.env = DBContext().penv;
261    }
262    if (!params.memory_only) {
263        if (params.wipe_data) {
264            LogInfo("Wiping LevelDB in %s", fs::PathToString(params.path));
265            leveldb::Status result = leveldb::DestroyDB(fs::PathToString(params.path), DBContext().options);
266            HandleError(result);
267        }
268        if (!params.testing_env) {
269            TryCreateDirectories(params.path);
270        }
271        LogInfo("Opening LevelDB in %s", fs::PathToString(params.path));
272    }
273    // PathToString() return value is safe to pass to leveldb open function,
274    // because on POSIX leveldb passes the byte string directly to ::open(), and
275    // on Windows it converts from UTF-8 to UTF-16 before calling ::CreateFileW
276    // (see env_posix.cc and env_windows.cc).
277    leveldb::Status status = leveldb::DB::Open(DBContext().options, fs::PathToString(params.path), &DBContext().pdb);
278    HandleError(status);
279    LogInfo("Opened LevelDB successfully");
280
281    if (params.options.force_compact) {
282        LogInfo("Starting database compaction of %s", fs::PathToString(params.path));
283        CompactFull();
284        LogInfo("Finished database compaction of %s", fs::PathToString(params.path));
285    }
286
287    if (!Read(OBFUSCATION_KEY, m_obfuscation) && params.obfuscate && IsEmpty()) {
288        // Generate and write the new obfuscation key.
289        const Obfuscation obfuscation{FastRandomContext{}.randbytes<Obfuscation::KEY_SIZE>()};
290        assert(!m_obfuscation); // Make sure the key is written without obfuscation.
291        Write(OBFUSCATION_KEY, obfuscation);
292        m_obfuscation = obfuscation;
293        LogInfo("Wrote new obfuscation key for %s: %s", fs::PathToString(params.path), m_obfuscation.HexKey());
294    }
295    LogInfo("Using obfuscation key for %s: %s", fs::PathToString(params.path), m_obfuscation.HexKey());
296}
297
298CDBWrapper::~CDBWrapper()
299{
300    delete DBContext().pdb;
301    DBContext().pdb = nullptr;
302    delete DBContext().options.filter_policy;
303    DBContext().options.filter_policy = nullptr;
304    delete DBContext().options.info_log;
305    DBContext().options.info_log = nullptr;
306    delete DBContext().options.block_cache;
307    DBContext().options.block_cache = nullptr;
308    delete DBContext().penv;
309    DBContext().options.env = nullptr;
310}
311
312void CDBWrapper::WriteBatch(CDBBatch& batch, bool fSync)
313{
314    const bool log_memory = util::log::ShouldDebugLog(BCLog::LEVELDB);
315    double mem_before = 0;
316    if (log_memory) {
317        mem_before = DynamicMemoryUsage() / double(1_MiB);
318    }
319    leveldb::Status status = DBContext().pdb->Write(fSync ? DBContext().syncoptions : DBContext().writeoptions, &batch.m_impl_batch->batch);
320    HandleError(status);
321    if (log_memory) {
322        double mem_after{DynamicMemoryUsage() / double(1_MiB)};
323        LogDebug(BCLog::LEVELDB, "WriteBatch memory usage: db=%s, before=%.1fMiB, after=%.1fMiB\n",
324                 m_name, mem_before, mem_after);
325    }
326}
327
328std::optional<std::string> CDBWrapper::GetProperty(const std::string& property) const
329{
330    if (std::string value; DBContext().pdb->GetProperty(property, &value)) return value;
331    return std::nullopt;
332}
333
334void CDBWrapper::CompactFull() { DBContext().pdb->CompactRange(nullptr, nullptr); }
335
336size_t CDBWrapper::DynamicMemoryUsage() const
337{
338    std::optional<size_t> parsed;
339    if (auto memory{GetProperty("leveldb.approximate-memory-usage")}; !memory || !(parsed = ToIntegral<size_t>(*memory))) {
340        LogDebug(BCLog::LEVELDB, "Failed to get approximate-memory-usage property\n");
341        return 0;
342    }
343    return parsed.value();
344}
345
346std::optional<std::string> CDBWrapper::ReadImpl(std::span<const std::byte> key) const
347{
348    leveldb::Slice slKey(CharCast(key.data()), key.size());
349    std::string strValue;
350    leveldb::Status status = DBContext().pdb->Get(DBContext().readoptions, slKey, &strValue);
351    if (!status.ok()) {
352        if (status.IsNotFound())
353            return std::nullopt;
354        LogError("LevelDB read failure: %s", status.ToString());
355        HandleError(status);
356    }
357    return strValue;
358}
359
360bool CDBWrapper::ExistsImpl(std::span<const std::byte> key) const
361{
362    leveldb::Slice slKey(CharCast(key.data()), key.size());
363
364    std::string strValue;
365    leveldb::Status status = DBContext().pdb->Get(DBContext().readoptions, slKey, &strValue);
366    if (!status.ok()) {
367        if (status.IsNotFound())
368            return false;
369        LogError("LevelDB read failure: %s", status.ToString());
370        HandleError(status);
371    }
372    return true;
373}
374
375size_t CDBWrapper::EstimateSizeImpl(std::span<const std::byte> key1, std::span<const std::byte> key2) const
376{
377    leveldb::Slice slKey1(CharCast(key1.data()), key1.size());
378    leveldb::Slice slKey2(CharCast(key2.data()), key2.size());
379    uint64_t size = 0;
380    leveldb::Range range(slKey1, slKey2);
381    DBContext().pdb->GetApproximateSizes(&range, 1, &size);
382    return size;
383}
384
385bool CDBWrapper::IsEmpty()
386{
387    std::unique_ptr<CDBIterator> it(NewIterator());
388    it->SeekToFirst();
389    return !(it->Valid());
390}
391
392struct CDBIterator::IteratorImpl {
393    const std::unique_ptr<leveldb::Iterator> iter;
394
395    explicit IteratorImpl(leveldb::Iterator* _iter) : iter{_iter} {}
396};
397
398CDBIterator::CDBIterator(const CDBWrapper& _parent, std::unique_ptr<IteratorImpl> _piter) : parent(_parent),
399                                                                                            m_impl_iter(std::move(_piter))
400{
401    m_scratch.reserve(DBWRAPPER_PREALLOC_KEY_SIZE);
402}
403
404CDBIterator* CDBWrapper::NewIterator()
405{
406    return new CDBIterator{*this, std::make_unique<CDBIterator::IteratorImpl>(DBContext().pdb->NewIterator(DBContext().iteroptions))};
407}
408
409void CDBIterator::SeekImpl(std::span<const std::byte> key)
410{
411    leveldb::Slice slKey(CharCast(key.data()), key.size());
412    m_impl_iter->iter->Seek(slKey);
413}
414
415std::span<const std::byte> CDBIterator::GetKeyImpl() const
416{
417    // The returned span borrows from the current iterator entry and is only
418    // valid until the iterator is advanced.
419    return MakeByteSpan(m_impl_iter->iter->key());
420}
421
422std::span<const std::byte> CDBIterator::GetValueImpl() const
423{
424    return MakeByteSpan(m_impl_iter->iter->value());
425}
426
427CDBIterator::~CDBIterator() = default;
428bool CDBIterator::Valid() const { return m_impl_iter->iter->Valid(); }
429void CDBIterator::SeekToFirst() { m_impl_iter->iter->SeekToFirst(); }
430void CDBIterator::Next() { m_impl_iter->iter->Next(); }
431
432namespace dbwrapper_private {
433
434const Obfuscation& GetObfuscation(const CDBWrapper& w)
435{
436    return w.m_obfuscation;
437}
438
439} // namespace dbwrapper_private
440

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.

340 guided files · 2,680 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 2

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.