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.

8,113 bytes · SHA-256 c1f339a3c0b11f14… · 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 <qt/paymentserver.h>
6
7#include <qt/bitcoinunits.h>
8#include <qt/guiutil.h>
9#include <qt/optionsmodel.h>
10
11#include <chainparams.h>
12#include <common/args.h>
13#include <interfaces/node.h>
14#include <key_io.h>
15#include <node/interface_ui.h>
16#include <policy/policy.h>
17#include <wallet/wallet.h>
18
19#include <cstdlib>
20#include <memory>
21
22#include <QApplication>
23#include <QByteArray>
24#include <QDataStream>
25#include <QDebug>
26#include <QFile>
27#include <QFileOpenEvent>
28#include <QHash>
29#include <QList>
30#include <QLocalServer>
31#include <QLocalSocket>
32#include <QStringList>
33#include <QUrlQuery>
34
35const int BITCOIN_IPC_CONNECT_TIMEOUT = 1000; // milliseconds
36const QString BITCOIN_IPC_PREFIX("bitcoin:");
37
38//
39// Create a name that is unique for:
40//  testnet / non-testnet
41//  data directory
42//
43static QString ipcServerName()
44{
45    QString name("BitcoinQt");
46
47    // Append a simple hash of the datadir
48    // Note that gArgs.GetDataDirNet() returns a different path
49    // for -testnet versus main net
50    QString ddir(GUIUtil::PathToQString(gArgs.GetDataDirNet()));
51    name.append(QString::number(qHash(ddir)));
52
53    return name;
54}
55
56//
57// We store payment URIs and requests received before
58// the main GUI window is up and ready to ask the user
59// to send payment.
60
61static QSet<QString> savedPaymentRequests;
62
63//
64// Sending to the server is done synchronously, at startup.
65// If the server isn't already running, startup continues,
66// and the items in savedPaymentRequest will be handled
67// when uiReady() is called.
68//
69// Warning: ipcSendCommandLine() is called early in init,
70// so don't use "Q_EMIT message()", but "QMessageBox::"!
71//
72void PaymentServer::ipcParseCommandLine(int argc, char* argv[])
73{
74    for (int i = 1; i < argc; i++)
75    {
76        QString arg(argv[i]);
77        if (arg.startsWith("-")) continue;
78
79        if (arg.startsWith(BITCOIN_IPC_PREFIX, Qt::CaseInsensitive)) // bitcoin: URI
80        {
81            savedPaymentRequests.insert(arg);
82        }
83    }
84}
85
86//
87// Sending to the server is done synchronously, at startup.
88// If the server isn't already running, startup continues,
89// and the items in savedPaymentRequest will be handled
90// when uiReady() is called.
91//
92bool PaymentServer::ipcSendCommandLine()
93{
94    bool fResult = false;
95    for (const QString& r : savedPaymentRequests)
96    {
97        QLocalSocket* socket = new QLocalSocket();
98        socket->connectToServer(ipcServerName(), QIODevice::WriteOnly);
99        if (!socket->waitForConnected(BITCOIN_IPC_CONNECT_TIMEOUT))
100        {
101            delete socket;
102            socket = nullptr;
103            return false;
104        }
105
106        QByteArray block;
107        QDataStream out(&block, QIODevice::WriteOnly);
108        out.setVersion(QDataStream::Qt_4_0);
109        out << r;
110        out.device()->seek(0);
111
112        socket->write(block);
113        socket->flush();
114        socket->waitForBytesWritten(BITCOIN_IPC_CONNECT_TIMEOUT);
115        socket->disconnectFromServer();
116
117        delete socket;
118        socket = nullptr;
119        fResult = true;
120    }
121
122    return fResult;
123}
124
125PaymentServer::PaymentServer(QObject* parent, bool startLocalServer)
126    : QObject(parent)
127{
128    // Install global event filter to catch QFileOpenEvents
129    // on Mac: sent when you click bitcoin: links
130    // other OSes: helpful when dealing with payment request files
131    if (parent)
132        parent->installEventFilter(this);
133
134    QString name = ipcServerName();
135
136    // Clean up old socket leftover from a crash:
137    QLocalServer::removeServer(name);
138
139    if (startLocalServer)
140    {
141        uriServer = new QLocalServer(this);
142
143        if (!uriServer->listen(name)) {
144            // constructor is called early in init, so don't use "Q_EMIT message()" here
145            QMessageBox::critical(nullptr, tr("Payment request error"),
146                tr("Cannot start bitcoin: click-to-pay handler"));
147        }
148        else {
149            connect(uriServer, &QLocalServer::newConnection, this, &PaymentServer::handleURIConnection);
150        }
151    }
152}
153
154PaymentServer::~PaymentServer() = default;
155
156//
157// OSX-specific way of handling bitcoin: URIs
158//
159bool PaymentServer::eventFilter(QObject *object, QEvent *event)
160{
161    if (event->type() == QEvent::FileOpen) {
162        QFileOpenEvent *fileEvent = static_cast<QFileOpenEvent*>(event);
163        if (!fileEvent->file().isEmpty())
164            handleURIOrFile(fileEvent->file());
165        else if (!fileEvent->url().isEmpty())
166            handleURIOrFile(fileEvent->url().toString());
167
168        return true;
169    }
170
171    return QObject::eventFilter(object, event);
172}
173
174void PaymentServer::uiReady()
175{
176    saveURIs = false;
177    for (const QString& s : savedPaymentRequests)
178    {
179        handleURIOrFile(s);
180    }
181    savedPaymentRequests.clear();
182}
183
184void PaymentServer::handleURIOrFile(const QString& s)
185{
186    if (saveURIs)
187    {
188        savedPaymentRequests.insert(s);
189        return;
190    }
191
192    if (s.startsWith("bitcoin://", Qt::CaseInsensitive))
193    {
194        Q_EMIT message(tr("URI handling"), tr("'bitcoin://' is not a valid URI. Use 'bitcoin:' instead."),
195            CClientUIInterface::MSG_ERROR);
196    }
197    else if (s.startsWith(BITCOIN_IPC_PREFIX, Qt::CaseInsensitive)) // bitcoin: URI
198    {
199        QUrlQuery uri((QUrl(s)));
200        // normal URI
201        {
202            SendCoinsRecipient recipient;
203            if (GUIUtil::parseBitcoinURI(s, &recipient))
204            {
205                std::string error_msg;
206                const CTxDestination dest = DecodeDestination(recipient.address.toStdString(), error_msg);
207
208                if (!IsValidDestination(dest)) {
209                    if (uri.hasQueryItem("r")) {  // payment request
210                        Q_EMIT message(tr("URI handling"),
211                            tr("Cannot process payment request because BIP70 is not supported.\n"
212                               "Due to widespread security flaws in BIP70 it's strongly recommended that any merchant instructions to switch wallets be ignored.\n"
213                               "If you are receiving this error you should request the merchant provide a BIP21 compatible URI."),
214                            CClientUIInterface::ICON_WARNING);
215                    }
216                    Q_EMIT message(tr("URI handling"), QString::fromStdString(error_msg),
217                        CClientUIInterface::MSG_ERROR);
218                }
219                else
220                    Q_EMIT receivedPaymentRequest(recipient);
221            }
222            else
223                Q_EMIT message(tr("URI handling"),
224                    tr("URI cannot be parsed! This can be caused by an invalid Bitcoin address or malformed URI parameters."),
225                    CClientUIInterface::ICON_WARNING);
226
227            return;
228        }
229    }
230
231    if (QFile::exists(s)) // payment request file
232    {
233        Q_EMIT message(tr("Payment request file handling"),
234            tr("Cannot process payment request because BIP70 is not supported.\n"
235               "Due to widespread security flaws in BIP70 it's strongly recommended that any merchant instructions to switch wallets be ignored.\n"
236               "If you are receiving this error you should request the merchant provide a BIP21 compatible URI."),
237            CClientUIInterface::ICON_WARNING);
238    }
239}
240
241void PaymentServer::handleURIConnection()
242{
243    QLocalSocket *clientConnection = uriServer->nextPendingConnection();
244
245    while (clientConnection->bytesAvailable() < (int)sizeof(quint32))
246        clientConnection->waitForReadyRead();
247
248    connect(clientConnection, &QLocalSocket::disconnected, clientConnection, &QLocalSocket::deleteLater);
249
250    QDataStream in(clientConnection);

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.