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

▤ autocompact_test.cc

▤ fault_injection_test.cc

▤ version_edit_test.cc

▤ version_edit.cc

▤ version_edit.h

▤ version_set_test.cc

▤ version_set.cc

▤ version_set.h

▤ write_batch_internal.h

▤ write_batch_test.cc

▤ 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 / leveldb / db / db_impl.cc

Download source ↓

48,885 bytes · SHA-256 b8e1157faebfb845… · View upstream ↗

501Status DBImpl::WriteLevel0Table(MemTable* mem, VersionEdit* edit,
502                                Version* base) {
503  mutex_.AssertHeld();
504  const uint64_t start_micros = env_->NowMicros();
505  FileMetaData meta;
506  meta.number = versions_->NewFileNumber();
507  pending_outputs_.insert(meta.number);
508  Iterator* iter = mem->NewIterator();
509  Log(options_.info_log, "Level-0 table #%llu: started",
510      (unsigned long long)meta.number);
511
512  Status s;
513  {
514    mutex_.Unlock();
515    s = BuildTable(dbname_, env_, options_, table_cache_, iter, &meta);
516    mutex_.Lock();
517  }
518
519  Log(options_.info_log, "Level-0 table #%llu: %lld bytes %s",
520      (unsigned long long)meta.number, (unsigned long long)meta.file_size,
521      s.ToString().c_str());
522  delete iter;
523  pending_outputs_.erase(meta.number);
524
525  // Note that if file_size is zero, the file has been deleted and
526  // should not be added to the manifest.
527  int level = 0;
528  if (s.ok() && meta.file_size > 0) {
529    const Slice min_user_key = meta.smallest.user_key();
530    const Slice max_user_key = meta.largest.user_key();
531    if (base != nullptr) {
532      level = base->PickLevelForMemTableOutput(min_user_key, max_user_key);
533    }
534    edit->AddFile(level, meta.number, meta.file_size, meta.smallest,
535                  meta.largest);
536  }
537
538  CompactionStats stats;
539  stats.micros = env_->NowMicros() - start_micros;
540  stats.bytes_written = meta.file_size;
541  stats_[level].Add(stats);
542  return s;
543}
544
545void DBImpl::CompactMemTable() {
546  mutex_.AssertHeld();
547  assert(imm_ != nullptr);
548
549  // Save the contents of the memtable as a new Table
550  VersionEdit edit;
551  Version* base = versions_->current();
552  base->Ref();
553  Status s = WriteLevel0Table(imm_, &edit, base);
554  base->Unref();
555
556  if (s.ok() && shutting_down_.load(std::memory_order_acquire)) {
557    s = Status::IOError("Deleting DB during memtable compaction");
558  }
559
560  // Replace immutable memtable with the generated Table
561  if (s.ok()) {
562    edit.SetPrevLogNumber(0);
563    edit.SetLogNumber(logfile_number_);  // Earlier logs no longer needed
564    s = versions_->LogAndApply(&edit, &mutex_);
565  }
566
567  if (s.ok()) {
568    // Commit to the new state
569    imm_->Unref();
570    imm_ = nullptr;
571    has_imm_.store(false, std::memory_order_release);
572    DeleteObsoleteFiles();
573  } else {
574    RecordBackgroundError(s);
575  }
576}
577
578void DBImpl::CompactRange(const Slice* begin, const Slice* end) {
579  int max_level_with_files = 1;
580  {
581    MutexLock l(&mutex_);
582    Version* base = versions_->current();
583    for (int level = 1; level < config::kNumLevels; level++) {
584      if (base->OverlapInLevel(level, begin, end)) {
585        max_level_with_files = level;
586      }
587    }
588  }
589  TEST_CompactMemTable();  // TODO(sanjay): Skip if memtable does not overlap
590  for (int level = 0; level < max_level_with_files; level++) {
591    TEST_CompactRange(level, begin, end);
592  }
593}
594
595void DBImpl::TEST_CompactRange(int level, const Slice* begin,
596                               const Slice* end) {
597  assert(level >= 0);
598  assert(level + 1 < config::kNumLevels);
599
600  InternalKey begin_storage, end_storage;
601
602  ManualCompaction manual;
603  manual.level = level;
604  manual.done = false;
605  if (begin == nullptr) {
606    manual.begin = nullptr;
607  } else {
608    begin_storage = InternalKey(*begin, kMaxSequenceNumber, kValueTypeForSeek);
609    manual.begin = &begin_storage;
610  }
611  if (end == nullptr) {
612    manual.end = nullptr;
613  } else {
614    end_storage = InternalKey(*end, 0, static_cast<ValueType>(0));
615    manual.end = &end_storage;
616  }
617
618  MutexLock l(&mutex_);
619  while (!manual.done && !shutting_down_.load(std::memory_order_acquire) &&
620         bg_error_.ok()) {
621    if (manual_compaction_ == nullptr) {  // Idle
622      manual_compaction_ = &manual;
623      MaybeScheduleCompaction();
624    } else {  // Running either my compaction or another compaction.
625      background_work_finished_signal_.Wait();
626    }
627  }
628  if (manual_compaction_ == &manual) {
629    // Cancel my manual compaction since we aborted early for some reason.
630    manual_compaction_ = nullptr;
631  }
632}
633
634Status DBImpl::TEST_CompactMemTable() {
635  // nullptr batch means just wait for earlier writes to be done
636  Status s = Write(WriteOptions(), nullptr);
637  if (s.ok()) {
638    // Wait until the compaction completes
639    MutexLock l(&mutex_);
640    while (imm_ != nullptr && bg_error_.ok()) {
641      background_work_finished_signal_.Wait();
642    }
643    if (imm_ != nullptr) {
644      s = bg_error_;
645    }
646  }
647  return s;
648}
649
650void DBImpl::RecordBackgroundError(const Status& s) {
651  mutex_.AssertHeld();
652  if (bg_error_.ok()) {
653    bg_error_ = s;
654    background_work_finished_signal_.SignalAll();
655  }
656}
657
658void DBImpl::MaybeScheduleCompaction() {
659  mutex_.AssertHeld();
660  if (background_compaction_scheduled_) {
661    // Already scheduled
662  } else if (shutting_down_.load(std::memory_order_acquire)) {
663    // DB is being deleted; no more background compactions
664  } else if (!bg_error_.ok()) {
665    // Already got an error; no more changes
666  } else if (imm_ == nullptr && manual_compaction_ == nullptr &&
667             !versions_->NeedsCompaction()) {
668    // No work to be done
669  } else {
670    background_compaction_scheduled_ = true;
671    env_->Schedule(&DBImpl::BGWork, this);
672  }
673}
674
675void DBImpl::BGWork(void* db) {
676  reinterpret_cast<DBImpl*>(db)->BackgroundCall();
677}
678
679void DBImpl::BackgroundCall() {
680  MutexLock l(&mutex_);
681  assert(background_compaction_scheduled_);
682  if (shutting_down_.load(std::memory_order_acquire)) {
683    // No more background work when shutting down.
684  } else if (!bg_error_.ok()) {
685    // No more background work after a background error.
686  } else {
687    BackgroundCompaction();
688  }
689
690  background_compaction_scheduled_ = false;
691
692  // Previous compaction may have produced too many files in a level,
693  // so reschedule another compaction if needed.
694  MaybeScheduleCompaction();
695  background_work_finished_signal_.SignalAll();
696}
697
698void DBImpl::BackgroundCompaction() {
699  mutex_.AssertHeld();
700
701  if (imm_ != nullptr) {
702    CompactMemTable();
703    return;
704  }
705
706  Compaction* c;
707  bool is_manual = (manual_compaction_ != nullptr);
708  InternalKey manual_end;
709  if (is_manual) {
710    ManualCompaction* m = manual_compaction_;
711    c = versions_->CompactRange(m->level, m->begin, m->end);
712    m->done = (c == nullptr);
713    if (c != nullptr) {
714      manual_end = c->input(0, c->num_input_files(0) - 1)->largest;
715    }
716    Log(options_.info_log,
717        "Manual compaction at level-%d from %s .. %s; will stop at %s\n",
718        m->level, (m->begin ? m->begin->DebugString().c_str() : "(begin)"),
719        (m->end ? m->end->DebugString().c_str() : "(end)"),
720        (m->done ? "(end)" : manual_end.DebugString().c_str()));
721  } else {
722    c = versions_->PickCompaction();
723  }
724
725  Status status;
726  if (c == nullptr) {
727    // Nothing to do
728  } else if (!is_manual && c->IsTrivialMove()) {
729    // Move file to next level
730    assert(c->num_input_files(0) == 1);
731    FileMetaData* f = c->input(0, 0);
732    c->edit()->DeleteFile(c->level(), f->number);
733    c->edit()->AddFile(c->level() + 1, f->number, f->file_size, f->smallest,
734                       f->largest);
735    status = versions_->LogAndApply(c->edit(), &mutex_);
736    if (!status.ok()) {
737      RecordBackgroundError(status);
738    }
739    VersionSet::LevelSummaryStorage tmp;
740    Log(options_.info_log, "Moved #%lld to level-%d %lld bytes %s: %s\n",
741        static_cast<unsigned long long>(f->number), c->level() + 1,
742        static_cast<unsigned long long>(f->file_size),
743        status.ToString().c_str(), versions_->LevelSummary(&tmp));
744  } else {
745    CompactionState* compact = new CompactionState(c);
746    status = DoCompactionWork(compact);
747    if (!status.ok()) {
748      RecordBackgroundError(status);
749    }
750    CleanupCompaction(compact);

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