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.

27,775 bytes · SHA-256 983f9e0a52214e8e… · 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#include <bitcoin-build-config.h> // IWYU pragma: keep
6
7#include <qt/bitcoin.h>
8
9#include <chainparams.h>
10#include <common/args.h>
11#include <common/init.h>
12#include <common/system.h>
13#include <init.h>
14#include <interfaces/handler.h>
15#include <interfaces/init.h>
16#include <interfaces/node.h>
17#include <node/context.h>
18#include <node/interface_ui.h>
19#include <noui.h>
20#include <qt/bitcoingui.h>
21#include <qt/clientmodel.h>
22#include <qt/guiconstants.h>
23#include <qt/guiutil.h>
24#include <qt/initexecutor.h>
25#include <qt/intro.h>
26#include <qt/networkstyle.h>
27#include <qt/optionsmodel.h>
28#include <qt/platformstyle.h>
29#include <qt/splashscreen.h>
30#include <qt/utilitydialog.h>
31#include <qt/winshutdownmonitor.h>
32#include <uint256.h>
33#include <util/btcsignals.h>
34#include <util/exception.h>
35#include <util/log.h>
36#include <util/string.h>
37#include <util/threadnames.h>
38#include <util/translation.h>
39#include <validation.h>
40
41#ifdef ENABLE_WALLET
42#include <qt/paymentserver.h>
43#include <qt/walletcontroller.h>
44#include <qt/walletmodel.h>
45#include <wallet/types.h>
46#endif // ENABLE_WALLET
47
48#include <chrono>
49#include <memory>
50
51#include <QApplication>
52#include <QDebug>
53#include <QLatin1String>
54#include <QLibraryInfo>
55#include <QLocale>
56#include <QMessageBox>
57#include <QSettings>
58#include <QThread>
59#include <QTimer>
60#include <QTranslator>
61#include <QWindow>
62
63// Declare meta types used for QMetaObject::invokeMethod
64Q_DECLARE_METATYPE(bool*)
65Q_DECLARE_METATYPE(CAmount)
66Q_DECLARE_METATYPE(SynchronizationState)
67Q_DECLARE_METATYPE(SyncType)
68Q_DECLARE_METATYPE(uint256)
69#ifdef ENABLE_WALLET
70Q_DECLARE_METATYPE(wallet::AddressPurpose)
71#endif // ENABLE_WALLET
72
73using util::MakeUnorderedList;
74
75static void RegisterMetaTypes()
76{
77    // Register meta types used for QMetaObject::invokeMethod and Qt::QueuedConnection
78    qRegisterMetaType<bool*>();
79    qRegisterMetaType<SynchronizationState>();
80    qRegisterMetaType<SyncType>();
81  #ifdef ENABLE_WALLET
82    qRegisterMetaType<WalletModel*>();
83    qRegisterMetaType<wallet::AddressPurpose>();
84  #endif // ENABLE_WALLET
85    // Register typedefs (see https://doc.qt.io/qt-5/qmetatype.html#qRegisterMetaType)
86    // IMPORTANT: if CAmount is no longer a typedef use the normal variant above (see https://doc.qt.io/qt-5/qmetatype.html#qRegisterMetaType-1)
87    qRegisterMetaType<CAmount>("CAmount");
88    qRegisterMetaType<size_t>("size_t");
89
90    qRegisterMetaType<std::function<void()>>("std::function<void()>");
91    qRegisterMetaType<QMessageBox::Icon>("QMessageBox::Icon");
92    qRegisterMetaType<interfaces::BlockAndHeaderTipInfo>("interfaces::BlockAndHeaderTipInfo");
93    qRegisterMetaType<BitcoinUnit>("BitcoinUnit");
94}
95
96static QString GetLangTerritory()
97{
98    QSettings settings;
99    // Get desired locale (e.g. "de_DE")
100    // 1) System default language
101    QString lang_territory = QLocale::system().name();
102    // 2) Language from QSettings
103    QString lang_territory_qsettings = settings.value("language", "").toString();
104    if(!lang_territory_qsettings.isEmpty())
105        lang_territory = lang_territory_qsettings;
106    // 3) -lang command line argument
107    lang_territory = QString::fromStdString(gArgs.GetArg("-lang", lang_territory.toStdString()));
108    return lang_territory;
109}
110
111/** Set up translations */
112static void initTranslations(QTranslator &qtTranslatorBase, QTranslator &qtTranslator, QTranslator &translatorBase, QTranslator &translator)
113{
114    // Remove old translators
115    QApplication::removeTranslator(&qtTranslatorBase);
116    QApplication::removeTranslator(&qtTranslator);
117    QApplication::removeTranslator(&translatorBase);
118    QApplication::removeTranslator(&translator);
119
120    // Get desired locale (e.g. "de_DE")
121    // 1) System default language
122    QString lang_territory = GetLangTerritory();
123
124    // Convert to "de" only by truncating "_DE"
125    QString lang = lang_territory;
126    lang.truncate(lang_territory.lastIndexOf('_'));
127
128    // Load language files for configured locale:
129    // - First load the translator for the base language, without territory
130    // - Then load the more specific locale translator
131
132    const QString translation_path{QLibraryInfo::path(QLibraryInfo::TranslationsPath)};
133    // Load e.g. qt_de.qm
134    if (qtTranslatorBase.load("qt_" + lang, translation_path)) {
135        QApplication::installTranslator(&qtTranslatorBase);
136    }
137
138    // Load e.g. qt_de_DE.qm
139    if (qtTranslator.load("qt_" + lang_territory, translation_path)) {
140        QApplication::installTranslator(&qtTranslator);
141    }
142
143    // Load e.g. bitcoin_de.qm (shortcut "de" needs to be defined in bitcoin.qrc)
144    if (translatorBase.load(lang, ":/translations/")) {
145        QApplication::installTranslator(&translatorBase);
146    }
147
148    // Load e.g. bitcoin_de_DE.qm (shortcut "de_DE" needs to be defined in bitcoin.qrc)
149    if (translator.load(lang_territory, ":/translations/")) {
150        QApplication::installTranslator(&translator);
151    }
152}
153
154static bool ErrorSettingsRead(const bilingual_str& error, const std::vector<std::string>& details)
155{
156    QMessageBox messagebox(QMessageBox::Critical, CLIENT_NAME, QString::fromStdString(strprintf("%s.", error.translated)), QMessageBox::Reset | QMessageBox::Abort);
157    /*: Explanatory text shown on startup when the settings file cannot be read.
158      Prompts user to make a choice between resetting or aborting. */
159    messagebox.setInformativeText(QObject::tr("Do you want to reset settings to default values, or to abort without making changes?"));
160    messagebox.setDetailedText(QString::fromStdString(MakeUnorderedList(details)));
161    messagebox.setTextFormat(Qt::PlainText);
162    messagebox.setDefaultButton(QMessageBox::Reset);
163    switch (messagebox.exec()) {
164    case QMessageBox::Reset:
165        return false;
166    case QMessageBox::Abort:
167        return true;
168    default:
169        assert(false);
170    }
171}
172
173static void ErrorSettingsWrite(const bilingual_str& error, const std::vector<std::string>& details)
174{
175    QMessageBox messagebox(QMessageBox::Critical, CLIENT_NAME, QString::fromStdString(strprintf("%s.", error.translated)), QMessageBox::Ok);
176    /*: Explanatory text shown on startup when the settings file could not be written.
177        Prompts user to check that we have the ability to write to the file.
178        Explains that the user has the option of running without a settings file.*/
179    messagebox.setInformativeText(QObject::tr("A fatal error occurred. Check that settings file is writable, or try running with -nosettings."));
180    messagebox.setDetailedText(QString::fromStdString(MakeUnorderedList(details)));
181    messagebox.setTextFormat(Qt::PlainText);
182    messagebox.setDefaultButton(QMessageBox::Ok);
183    messagebox.exec();
184}
185
186/* qDebug() message handler --> debug.log */
187void DebugMessageHandler(QtMsgType type, const QMessageLogContext& context, const QString &msg)
188{
189    Q_UNUSED(context);
190    if (type == QtDebugMsg) {
191        LogDebug(BCLog::QT, "GUI: %s\n", msg.toStdString());
192    } else {
193        LogInfo("GUI: %s", msg.toStdString());
194    }
195}
196
197static int qt_argc = 1;
198static const char* qt_argv = "bitcoin-qt";
199
200BitcoinApplication::BitcoinApplication()
201    : QApplication(qt_argc, const_cast<char**>(&qt_argv))
202{
203    // Qt runs setlocale(LC_ALL, "") on initialization.
204    RegisterMetaTypes();
205    setQuitOnLastWindowClosed(false);
206}
207
208void BitcoinApplication::setupPlatformStyle()
209{
210    // UI per-platform customization
211    // This must be done inside the BitcoinApplication constructor, or after it, because
212    // PlatformStyle::instantiate requires a QApplication
213    std::string platformName;
214    platformName = gArgs.GetArg("-uiplatform", BitcoinGUI::DEFAULT_UIPLATFORM);
215    platformStyle = PlatformStyle::instantiate(QString::fromStdString(platformName));
216    if (!platformStyle) // Fall back to "other" if specified name not found
217        platformStyle = PlatformStyle::instantiate("other");
218    assert(platformStyle);
219}
220
221BitcoinApplication::~BitcoinApplication()
222{
223    m_executor.reset();
224
225    delete window;
226    window = nullptr;
227    delete platformStyle;
228    platformStyle = nullptr;
229}
230
231#ifdef ENABLE_WALLET
232void BitcoinApplication::createPaymentServer()
233{
234    paymentServer = new PaymentServer(this);
235}
236#endif
237
238bool BitcoinApplication::createOptionsModel(bool resetSettings)
239{
240    optionsModel = new OptionsModel(node(), this);
241    if (resetSettings) {
242        optionsModel->Reset();
243    }
244    bilingual_str error;
245    if (!optionsModel->Init(error)) {
246        fs::path settings_path;
247        if (gArgs.GetSettingsPath(&settings_path)) {
248            error += Untranslated("\n");
249            std::string quoted_path = strprintf("%s", fs::quoted(fs::PathToString(settings_path)));
250            error.original += strprintf("Settings file %s might be corrupt or invalid.", quoted_path);

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.