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

Download source ↓

15,149 bytes · SHA-256 f795cf2bb28e959f… · View upstream ↗

251
252    // Return whether the wallet is blank.
253    virtual bool canGetAddresses() = 0;
254
255    // Return whether private keys enabled.
256    virtual bool privateKeysDisabled() = 0;
257
258    // Return whether the wallet contains a Taproot scriptPubKeyMan
259    virtual bool taprootEnabled() = 0;
260
261    // Return whether wallet uses an external signer.
262    virtual bool hasExternalSigner() = 0;
263
264    // Get default address type.
265    virtual OutputType getDefaultAddressType() = 0;
266
267    //! Get max tx fee.
268    virtual CAmount getDefaultMaxTxFee() = 0;
269
270    // Remove wallet.
271    virtual void remove() = 0;
272
273    //! Register handler for unload message.
274    using UnloadFn = std::function<void()>;
275    virtual std::unique_ptr<Handler> handleUnload(UnloadFn fn) = 0;
276
277    //! Register handler for show progress messages.
278    using ShowProgressFn = std::function<void(const std::string& title, int progress)>;
279    virtual std::unique_ptr<Handler> handleShowProgress(ShowProgressFn fn) = 0;
280
281    //! Register handler for status changed messages.
282    using StatusChangedFn = std::function<void()>;
283    virtual std::unique_ptr<Handler> handleStatusChanged(StatusChangedFn fn) = 0;
284
285    //! Register handler for address book changed messages.
286    using AddressBookChangedFn = std::function<void(const CTxDestination& address,
287        const std::string& label,
288        bool is_mine,
289        wallet::AddressPurpose purpose,
290        ChangeType status)>;
291    virtual std::unique_ptr<Handler> handleAddressBookChanged(AddressBookChangedFn fn) = 0;
292
293    //! Register handler for transaction changed messages.
294    using TransactionChangedFn = std::function<void(const Txid& txid, ChangeType status)>;
295    virtual std::unique_ptr<Handler> handleTransactionChanged(TransactionChangedFn fn) = 0;
296
297    //! Register handler for keypool changed messages.
298    using CanGetAddressesChangedFn = std::function<void()>;
299    virtual std::unique_ptr<Handler> handleCanGetAddressesChanged(CanGetAddressesChangedFn fn) = 0;
300
301    //! Return pointer to internal wallet class, useful for testing.
302    virtual wallet::CWallet* wallet() { return nullptr; }
303
304    //! Export a watchonly wallet file. See CWallet::ExportWatchOnlyWallet
305    virtual util::Result<std::string> exportWatchOnlyWallet(const fs::path& destination) = 0;
306};
307
308//! Wallet chain client that in addition to having chain client methods for
309//! starting up, shutting down, and registering RPCs, also has additional
310//! methods (called by the GUI) to load and create wallets.
311class WalletLoader : public ChainClient
312{
313public:
314    //! Create new wallet.
315    virtual util::Result<std::unique_ptr<Wallet>> createWallet(const std::string& name, const SecureString& passphrase, uint64_t wallet_creation_flags, std::vector<bilingual_str>& warnings) = 0;
316
317    //! Load existing wallet.
318    virtual util::Result<std::unique_ptr<Wallet>> loadWallet(const std::string& name, std::vector<bilingual_str>& warnings) = 0;
319
320    //! Return default wallet directory.
321    virtual std::string getWalletDir() = 0;
322
323    //! Restore backup wallet
324    virtual util::Result<std::unique_ptr<Wallet>> restoreWallet(const fs::path& backup_file, const std::string& wallet_name, std::vector<bilingual_str>& warnings, bool load_after_restore) = 0;
325
326    //! Migrate a wallet
327    virtual util::Result<WalletMigrationResult> migrateWallet(const std::string& name, const SecureString& passphrase, bool load_wallet) = 0;
328
329    //! Returns true if wallet stores encryption keys
330    virtual bool isEncrypted(const std::string& wallet_name) = 0;
331
332    //! Return available wallets in wallet directory.
333    virtual std::vector<std::pair<std::string, std::string>> listWalletDir() = 0;
334
335    //! Return interfaces for accessing wallets (if any).
336    virtual std::vector<std::unique_ptr<Wallet>> getWallets() = 0;
337
338    //! Register handler for load wallet messages. This callback is triggered by
339    //! createWallet and loadWallet above, and also triggered when wallets are
340    //! loaded at startup or by RPC.
341    using LoadWalletFn = std::function<void(std::unique_ptr<Wallet> wallet)>;
342    virtual std::unique_ptr<Handler> handleLoadWallet(LoadWalletFn fn) = 0;
343
344    //! Return pointer to internal context, useful for testing.
345    virtual wallet::WalletContext* context() { return nullptr; }
346};
347
348//! Information about one wallet address.
349struct WalletAddress
350{
351    CTxDestination dest;
352    bool is_mine;
353    wallet::AddressPurpose purpose;
354    std::string name;
355
356    WalletAddress(CTxDestination dest, bool is_mine, wallet::AddressPurpose purpose, std::string name)
357        : dest(std::move(dest)), is_mine(is_mine), purpose(std::move(purpose)), name(std::move(name))
358    {
359    }
360};
361
362//! Collection of wallet balances.
363struct WalletBalances
364{
365    CAmount balance = 0;
366    CAmount unconfirmed_balance = 0;
367    CAmount immature_balance = 0;
368    CAmount used_balance = 0;
369    CAmount nonmempool_balance = 0;
370
371    bool balanceChanged(const WalletBalances& prev) const
372    {
373        return balance != prev.balance || unconfirmed_balance != prev.unconfirmed_balance ||
374               immature_balance != prev.immature_balance ||
375               used_balance != prev.used_balance || nonmempool_balance != prev.nonmempool_balance;
376    }
377};
378
379// Wallet transaction information.
380struct WalletTx
381{
382    CTransactionRef tx;
383    std::vector<bool> txin_is_mine;
384    std::vector<bool> txout_is_mine;
385    std::vector<bool> txout_is_change;
386    std::vector<CTxDestination> txout_address;
387    std::vector<bool> txout_address_is_mine;
388    CAmount credit;
389    CAmount debit;
390    CAmount change;
391    int64_t time;
392    std::optional<std::string> from; // Deprecated
393    std::optional<std::string> message; // Deprecated
394    std::optional<std::string> comment;
395    std::optional<std::string> comment_to;
396    bool is_coinbase;
397
398    bool operator<(const WalletTx& a) const { return tx->GetHash() < a.tx->GetHash(); }
399};
400
401//! Updated transaction status.
402struct WalletTxStatus
403{
404    int block_height;
405    int blocks_to_maturity;
406    int depth_in_main_chain;
407    unsigned int time_received;
408    uint32_t lock_time;
409    bool is_trusted;
410    bool is_abandoned;
411    bool is_coinbase;
412    bool is_in_main_chain;
413};
414
415//! Wallet transaction output.
416struct WalletTxOut
417{
418    CTxOut txout;
419    int64_t time;
420    int depth_in_main_chain = -1;
421    bool is_spent = false;
422};
423
424//! Migrated wallet info
425struct WalletMigrationResult
426{
427    std::unique_ptr<Wallet> wallet;
428    std::optional<std::string> watchonly_wallet_name;
429    std::optional<std::string> solvables_wallet_name;
430    fs::path backup_path;
431};
432
433//! Return implementation of Wallet interface. This function is defined in
434//! dummywallet.cpp and throws if the wallet component is not compiled.
435std::unique_ptr<Wallet> MakeWallet(wallet::WalletContext& context, const std::shared_ptr<wallet::CWallet>& wallet);
436
437//! Return implementation of ChainClient interface for a wallet loader. This
438//! function will be undefined in builds where ENABLE_WALLET is false.
439std::unique_ptr<WalletLoader> MakeWalletLoader(Chain& chain, ArgsManager& args);
440
441} // namespace interfaces
442
443#endif // BITCOIN_INTERFACES_WALLET_H
444

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.