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

▤ 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 / interfaces / chain.h

Download source ↓

20,227 bytes · SHA-256 e04b34e2f2974bb5… · View upstream ↗

251    //! Currently only returns the ancestor and descendant count limits, but could be enhanced to
252    //! return more policy settings.
253    virtual void getPackageLimits(unsigned int& limit_ancestor_count, unsigned int& limit_descendant_count) = 0;
254
255    //! Check if transaction will pass the mempool's chain limits.
256    virtual util::Result<void> checkChainLimits(const CTransactionRef& tx) = 0;
257
258    //! Estimate a fee rate.
259    virtual util::Expected<FeeRateEstimation, FeeRateEstimationError> getFeeRateEstimate(int num_blocks, bool conservative) const = 0;
260
261    //! Fee estimator max target.
262    virtual unsigned int maximumFeeEstimationTargetBlocks() const = 0;
263
264    //! Mempool minimum fee.
265    virtual CFeeRate mempoolMinFee() = 0;
266
267    //! Relay current minimum fee (from -minrelaytxfee and -incrementalrelayfee settings).
268    virtual CFeeRate relayMinFee() = 0;
269
270    //! Relay incremental fee setting (-incrementalrelayfee), reflecting cost of relay.
271    virtual CFeeRate relayIncrementalFee() = 0;
272
273    //! Relay dust fee setting (-dustrelayfee), reflecting lowest rate it's economical to spend.
274    virtual CFeeRate relayDustFee() = 0;
275
276    //! Check if any block has been pruned.
277    virtual bool havePruned() = 0;
278
279    //! Get the current prune height.
280    virtual std::optional<int> getPruneHeight() = 0;
281
282    //! Check if the node is ready to broadcast transactions.
283    virtual bool isReadyToBroadcast() = 0;
284
285    //! Check if in IBD.
286    virtual bool isInitialBlockDownload() = 0;
287
288    //! Check if shutdown requested.
289    virtual bool shutdownRequested() = 0;
290
291    //! Send init message.
292    virtual void initMessage(const std::string& message) = 0;
293
294    //! Send init warning.
295    virtual void initWarning(const bilingual_str& message) = 0;
296
297    //! Send init error.
298    virtual void initError(const bilingual_str& message) = 0;
299
300    //! Send progress indicator.
301    virtual void showProgress(const std::string& title, int progress, bool resume_possible) = 0;
302
303    //! Chain notifications.
304    class Notifications
305    {
306    public:
307        virtual ~Notifications() = default;
308        virtual void transactionAddedToMempool(const CTransactionRef& tx) {}
309        virtual void transactionRemovedFromMempool(const CTransactionRef& tx, MemPoolRemovalReason reason) {}
310        virtual void blockConnected(const kernel::ChainstateRole& role, const BlockInfo& block) {}
311        virtual void blockDisconnected(const BlockInfo& block) {}
312        virtual void updatedBlockTip() {}
313        virtual void chainStateFlushed(const kernel::ChainstateRole& role, const CBlockLocator& locator) {}
314    };
315
316    //! Options specifying which chain notifications are required.
317    struct NotifyOptions
318    {
319        //! Include undo data with block connected notifications.
320        bool connect_undo_data = false;
321        //! Include block data with block disconnected notifications.
322        bool disconnect_data = false;
323        //! Include undo data with block disconnected notifications.
324        bool disconnect_undo_data = false;
325    };
326
327    //! Register handler for notifications.
328    //! Some notifications are asynchronous and may still execute after the handler is disconnected.
329    //! Use waitForNotifications() after the handler is disconnected to ensure all pending notifications
330    //! have been processed.
331    virtual std::unique_ptr<Handler> handleNotifications(std::shared_ptr<Notifications> notifications) = 0;
332
333    //! Wait for pending notifications to be processed unless block hash points to the current
334    //! chain tip.
335    virtual void waitForNotificationsIfTipChanged(const uint256& old_tip) = 0;
336
337    //! Wait for all pending notifications up to this point to be processed
338    virtual void waitForNotifications() = 0;
339
340    //! Register handler for RPC. Command is not copied, so reference
341    //! needs to remain valid until Handler is disconnected.
342    virtual std::unique_ptr<Handler> handleRpc(const CRPCCommand& command) = 0;
343
344    //! Check if deprecated RPC is enabled.
345    virtual bool rpcEnableDeprecated(const std::string& method) = 0;
346
347    //! Get settings value.
348    virtual common::SettingsValue getSetting(const std::string& arg) = 0;
349
350    //! Get list of settings values.
351    virtual std::vector<common::SettingsValue> getSettingsList(const std::string& arg) = 0;
352
353    //! Return <datadir>/settings.json setting value.
354    virtual common::SettingsValue getRwSetting(const std::string& name) = 0;
355
356    //! Updates a setting in <datadir>/settings.json.
357    //! Null can be passed to erase the setting. There is intentionally no
358    //! support for writing null values to settings.json.
359    //! Depending on the action returned by the update function, this will either
360    //! update the setting in memory or write the updated settings to disk.
361    //! Returns false if the update function returned no action, or if the
362    //! settings could not be written to disk, including when settings are
363    //! disabled with -nosettings. In-memory changes are kept either way.
364    virtual bool updateRwSetting(const std::string& name, const SettingsUpdate& update_function) = 0;
365
366    //! Replace a setting in <datadir>/settings.json with a new value.
367    //! Null can be passed to erase the setting.
368    //! This method provides a simpler alternative to updateRwSetting when
369    //! atomically reading and updating the setting is not required.
370    virtual bool overwriteRwSetting(const std::string& name, common::SettingsValue value, SettingsAction action = SettingsAction::WRITE) = 0;
371
372    //! Delete a given setting in <datadir>/settings.json.
373    //! This method provides a simpler alternative to overwriteRwSetting when
374    //! erasing a setting, for ease of use and readability.
375    virtual bool deleteRwSettings(const std::string& name, SettingsAction action = SettingsAction::WRITE) = 0;
376
377    //! Synchronously send transactionAddedToMempool notifications about all
378    //! current mempool transactions to the specified handler and return after
379    //! the last one is sent. These notifications aren't coordinated with async
380    //! notifications sent by handleNotifications, so out of date async
381    //! notifications from handleNotifications can arrive during and after
382    //! synchronous notifications from requestMempoolTransactions. Clients need
383    //! to be prepared to handle this by ignoring notifications about unknown
384    //! removed transactions and already added new transactions.
385    virtual void requestMempoolTransactions(Notifications& notifications) = 0;
386
387    //! Return true if an assumed-valid snapshot is in use. Note that this
388    //! returns true even after the snapshot is validated, until the next node
389    //! restart.
390    virtual bool hasAssumedValidChain() = 0;
391
392    //! Get internal node context. Useful for testing, but not
393    //! accessible across processes.
394    virtual node::NodeContext* context() { return nullptr; }
395};
396
397//! Interface to let node manage chain clients (wallets, or maybe tools for
398//! monitoring and analysis in the future).
399class ChainClient
400{
401public:
402    virtual ~ChainClient() = default;
403
404    //! Register rpcs.
405    virtual void registerRpcs() = 0;
406
407    //! Check for errors before loading.
408    virtual bool verify() = 0;
409
410    //! Load saved state.
411    virtual bool load() = 0;
412
413    //! Start client execution and provide a scheduler.
414    virtual void start(CScheduler& scheduler) = 0;
415
416    //! Shut down client.
417    virtual void stop() = 0;
418
419    //! Set mock time.
420    virtual void setMockTime(int64_t time) = 0;
421
422    //! Mock the scheduler to fast forward in time.
423    virtual void schedulerMockForward(std::chrono::seconds delta_seconds) = 0;
424};
425
426//! Return implementation of Chain interface.
427std::unique_ptr<Chain> MakeChain(node::NodeContext& node);
428
429} // namespace interfaces
430
431#endif // BITCOIN_INTERFACES_CHAIN_H
432

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

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.