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.

12,920 bytes · SHA-256 9fd990cae3a49900… · View upstream ↗

1// Copyright (c) 2011-present The Bitcoin Core developers
2// Distributed under the MIT software license, see the accompanying
3// file COPYING or http://www.opensource.org/licenses/mit-license.php.
4
5#ifndef BITCOIN_QT_BITCOINGUI_H
6#define BITCOIN_QT_BITCOINGUI_H
7
8#include <bitcoin-build-config.h> // IWYU pragma: keep
9
10#include <qt/bitcoinunits.h>
11#include <qt/clientmodel.h>
12#include <qt/guiutil.h>
13#include <qt/optionsdialog.h>
14
15#include <consensus/amount.h>
16
17#include <QLabel>
18#include <QMainWindow>
19#include <QMap>
20#include <QMenu>
21#include <QPoint>
22#include <QSystemTrayIcon>
23
24#ifdef Q_OS_MACOS
25#include <qt/macos_appnap.h>
26#endif
27
28#include <memory>
29
30class NetworkStyle;
31class Notificator;
32class OptionsModel;
33class PlatformStyle;
34class RPCConsole;
35class SendCoinsRecipient;
36class UnitDisplayStatusBarControl;
37class WalletController;
38class WalletFrame;
39class WalletModel;
40class HelpMessageDialog;
41class ModalOverlay;
42enum class SynchronizationState;
43
44namespace interfaces {
45class Handler;
46class Node;
47struct BlockAndHeaderTipInfo;
48}
49
50QT_BEGIN_NAMESPACE
51class QAction;
52class QComboBox;
53class QDateTime;
54class QProgressBar;
55class QProgressDialog;
56QT_END_NAMESPACE
57
58namespace GUIUtil {
59class ClickableLabel;
60class ClickableProgressBar;
61}
62
63/**
64  Bitcoin GUI main class. This class represents the main window of the Bitcoin UI. It communicates with both the client and
65  wallet models to give the user an up-to-date view of the current core state.
66*/
67class BitcoinGUI : public QMainWindow
68{
69    Q_OBJECT
70
71public:
72    static const std::string DEFAULT_UIPLATFORM;
73
74    explicit BitcoinGUI(interfaces::Node& node, const PlatformStyle *platformStyle, const NetworkStyle *networkStyle, QWidget *parent = nullptr);
75    ~BitcoinGUI();
76
77    /** Set the client model.
78        The client model represents the part of the core that communicates with the P2P network, and is wallet-agnostic.
79    */
80    void setClientModel(ClientModel *clientModel = nullptr, interfaces::BlockAndHeaderTipInfo* tip_info = nullptr);
81#ifdef ENABLE_WALLET
82    void setWalletController(WalletController* wallet_controller, bool show_loading_minimized);
83    WalletController* getWalletController();
84#endif
85
86#ifdef ENABLE_WALLET
87    /** Set the wallet model.
88        The wallet model represents a bitcoin wallet, and offers access to the list of transactions, address book and sending
89        functionality.
90    */
91    void addWallet(WalletModel* walletModel);
92    void removeWallet(WalletModel* walletModel);
93    void removeAllWallets();
94#endif // ENABLE_WALLET
95    bool enableWallet = false;
96
97    /** Get the tray icon status.
98        Some systems have not "system tray" or "notification area" available.
99    */
100    bool hasTrayIcon() const { return trayIcon; }
101
102    /** Disconnect core signals from GUI client */
103    void unsubscribeFromCoreSignals();
104
105    bool isPrivacyModeActivated() const;
106
107protected:
108    void changeEvent(QEvent *e) override;
109    void closeEvent(QCloseEvent *event) override;
110    void showEvent(QShowEvent *event) override;
111    void dragEnterEvent(QDragEnterEvent *event) override;
112    void dropEvent(QDropEvent *event) override;
113    bool eventFilter(QObject *object, QEvent *event) override;
114
115private:
116    interfaces::Node& m_node;
117#ifdef ENABLE_WALLET
118    WalletController* m_wallet_controller{nullptr};
119#endif // ENABLE_WALLET
120    std::unique_ptr<interfaces::Handler> m_handler_message_box;
121    std::unique_ptr<interfaces::Handler> m_handler_question;
122    ClientModel* clientModel = nullptr;
123    WalletFrame* walletFrame = nullptr;
124
125    UnitDisplayStatusBarControl* unitDisplayControl = nullptr;
126    GUIUtil::ThemedLabel* labelWalletEncryptionIcon = nullptr;
127    GUIUtil::ThemedLabel* labelWalletHDStatusIcon = nullptr;
128    GUIUtil::ClickableLabel* labelProxyIcon = nullptr;
129    GUIUtil::ClickableLabel* connectionsControl = nullptr;
130    GUIUtil::ClickableLabel* labelBlocksIcon = nullptr;
131    QLabel* progressBarLabel = nullptr;
132    GUIUtil::ClickableProgressBar* progressBar = nullptr;
133    QProgressDialog* progressDialog = nullptr;
134
135    QMenuBar* appMenuBar = nullptr;
136    QToolBar* appToolBar = nullptr;
137    QAction* overviewAction = nullptr;
138    QAction* historyAction = nullptr;
139    QAction* quitAction = nullptr;
140    QAction* sendCoinsAction = nullptr;
141    QAction* usedSendingAddressesAction = nullptr;
142    QAction* usedReceivingAddressesAction = nullptr;
143    QAction* signMessageAction = nullptr;
144    QAction* verifyMessageAction = nullptr;
145    QAction* m_load_psbt_action = nullptr;
146    QAction* m_load_psbt_clipboard_action = nullptr;
147    QAction* aboutAction = nullptr;
148    QAction* receiveCoinsAction = nullptr;
149    QAction* optionsAction = nullptr;
150    QAction* encryptWalletAction = nullptr;
151    QAction* backupWalletAction = nullptr;
152    QAction* changePassphraseAction = nullptr;
153    QAction* aboutQtAction = nullptr;
154    QAction* openRPCConsoleAction = nullptr;
155    QAction* openAction = nullptr;
156    QAction* showHelpMessageAction = nullptr;
157    QAction* m_create_wallet_action{nullptr};
158    QAction* m_open_wallet_action{nullptr};
159    QMenu* m_open_wallet_menu{nullptr};
160    QAction* m_restore_wallet_action{nullptr};
161    QAction* m_close_wallet_action{nullptr};
162    QAction* m_close_all_wallets_action{nullptr};
163#ifdef ENABLE_WALLET
164    QAction* m_wallet_selector_label_action = nullptr;
165    QAction* m_wallet_selector_action = nullptr;
166#endif // ENABLE_WALLET
167    QAction* m_mask_values_action{nullptr};
168    QAction* m_migrate_wallet_action{nullptr};
169    QMenu* m_migrate_wallet_menu{nullptr};
170    QAction* m_export_watchonly_action{nullptr};
171#ifdef ENABLE_WALLET
172    QLabel *m_wallet_selector_label = nullptr;
173    QComboBox* m_wallet_selector = nullptr;
174#endif // ENABLE_WALLET
175    QSystemTrayIcon* trayIcon = nullptr;
176    const std::unique_ptr<QMenu> trayIconMenu;
177    Notificator* notificator = nullptr;
178    RPCConsole* rpcConsole = nullptr;
179    HelpMessageDialog* helpMessageDialog = nullptr;
180    ModalOverlay* modalOverlay = nullptr;
181
182    QMenu* m_network_context_menu = new QMenu(this);
183
184#ifdef Q_OS_MACOS
185    CAppNapInhibitor* m_app_nap_inhibitor = nullptr;
186#endif
187
188    /** Keep track of previous number of blocks, to detect progress */
189    int prevBlocks = 0;
190    int spinnerFrame = 0;
191
192    const PlatformStyle *platformStyle;
193    const NetworkStyle* const m_network_style;
194
195    /** Create the main UI actions. */
196    void createActions();
197    /** Create the menu bar and sub-menus. */
198    void createMenuBar();
199    /** Create the toolbars */
200    void createToolBars();
201    /** Create system tray icon and notification */
202    void createTrayIcon();
203    /** Create system tray menu (or setup the dock menu) */
204    void createTrayIconMenu();
205
206    /** Enable or disable all wallet-related actions */
207    void setWalletActionsEnabled(bool enabled);
208
209    /** Connect core signals to GUI client */
210    void subscribeToCoreSignals();
211
212    /** Update UI with latest network info from model. */
213    void updateNetworkState();
214
215    void updateHeadersSyncProgressLabel();
216    void updateHeadersPresyncProgressLabel(int64_t height, const QDateTime& blockDate);
217
218    /** Open the OptionsDialog on the specified tab index */
219    void openOptionsDialogWithTab(OptionsDialog::Tab tab);
220
221Q_SIGNALS:
222    void quitRequested();
223    /** Signal raised when a URI was entered or dragged to the GUI */
224    void receivedURI(const QString &uri);
225    /** Signal raised when RPC console shown */
226    void consoleShown(RPCConsole* console);
227    void setPrivacy(bool privacy);
228
229public Q_SLOTS:
230    /** Set number of connections shown in the UI */
231    void setNumConnections(int count);
232    /** Set network state shown in the UI */
233    void setNetworkActive(bool network_active);
234    /** Set number of blocks and last block date shown in the UI */
235    void setNumBlocks(int count, const QDateTime& blockDate, double nVerificationProgress, SyncType synctype, SynchronizationState sync_state);
236    /** Launch the wallet creation modal (no-op if wallet is not compiled) **/
237    void createWallet();
238
239    /** Notify the user of an event from the core network or transaction handling code.
240       @param[in] title             the message box / notification title
241       @param[in] message           the displayed text
242       @param[in] style             modality and style definitions (icon and used buttons - buttons only for message boxes)
243                                    @see CClientUIInterface::MessageBoxFlags
244       @param[in] ret               pointer to a bool that will be modified to whether Ok was clicked (modal only)
245       @param[in] detailed_message  the text to be displayed in the details area
246    */
247    void message(const QString& title, QString message, unsigned int style, bool* ret = nullptr, const QString& detailed_message = QString());
248
249#ifdef ENABLE_WALLET
250    void setCurrentWallet(WalletModel* wallet_model);

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.