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.

21,500 bytes · SHA-256 a4d86f03483e3acc… · 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/walletmodel.h>
6
7#include <qt/addresstablemodel.h>
8#include <qt/clientmodel.h>
9#include <qt/guiconstants.h>
10#include <qt/guiutil.h>
11#include <qt/optionsmodel.h>
12#include <qt/paymentserver.h>
13#include <qt/recentrequeststablemodel.h>
14#include <qt/sendcoinsdialog.h>
15#include <qt/transactiontablemodel.h>
16
17#include <common/args.h>
18#include <interfaces/handler.h>
19#include <interfaces/node.h>
20#include <key_io.h>
21#include <node/interface_ui.h>
22#include <node/types.h>
23#include <psbt.h>
24#include <util/translation.h>
25#include <wallet/coincontrol.h>
26#include <wallet/types.h>
27#include <wallet/wallet.h>
28
29#include <cstdint>
30#include <functional>
31#include <memory>
32#include <vector>
33
34#include <QDebug>
35#include <QMessageBox>
36#include <QSet>
37#include <QTimer>
38
39using wallet::CCoinControl;
40using wallet::CRecipient;
41using wallet::DEFAULT_DISABLE_WALLET;
42
43WalletModel::WalletModel(std::unique_ptr<interfaces::Wallet> wallet, ClientModel& client_model, const PlatformStyle *platformStyle, QObject *parent) :
44    QObject(parent),
45    m_wallet(std::move(wallet)),
46    m_client_model(&client_model),
47    m_node(client_model.node()),
48    optionsModel(client_model.getOptionsModel()),
49    timer(new QTimer(this))
50{
51    addressTableModel = new AddressTableModel(this);
52    transactionTableModel = new TransactionTableModel(platformStyle, this);
53    recentRequestsTableModel = new RecentRequestsTableModel(this);
54
55    subscribeToCoreSignals();
56}
57
58WalletModel::~WalletModel()
59{
60    unsubscribeFromCoreSignals();
61}
62
63void WalletModel::startPollBalance()
64{
65    // Update the cached balance right away, so every view can make use of it,
66    // so them don't need to waste resources recalculating it.
67    pollBalanceChanged();
68
69    // This timer will be fired repeatedly to update the balance
70    // Since the QTimer::timeout is a private signal, it cannot be used
71    // in the GUIUtil::ExceptionSafeConnect directly.
72    connect(timer, &QTimer::timeout, this, &WalletModel::timerTimeout);
73    GUIUtil::ExceptionSafeConnect(this, &WalletModel::timerTimeout, this, &WalletModel::pollBalanceChanged);
74    timer->start(MODEL_UPDATE_DELAY);
75}
76
77void WalletModel::setClientModel(ClientModel* client_model)
78{
79    m_client_model = client_model;
80    if (!m_client_model) timer->stop();
81}
82
83void WalletModel::updateStatus()
84{
85    EncryptionStatus newEncryptionStatus = getEncryptionStatus();
86
87    if(cachedEncryptionStatus != newEncryptionStatus) {
88        Q_EMIT encryptionStatusChanged();
89    }
90}
91
92void WalletModel::pollBalanceChanged()
93{
94    // Avoid recomputing wallet balances unless a TransactionChanged or
95    // BlockTip notification was received.
96    if (!fForceCheckBalanceChanged && m_cached_last_update_tip == getLastBlockProcessed()) return;
97
98    // Try to get balances and return early if locks can't be acquired. This
99    // avoids the GUI from getting stuck on periodical polls if the core is
100    // holding the locks for a longer time - for example, during a wallet
101    // rescan.
102    interfaces::WalletBalances new_balances;
103    uint256 block_hash;
104    if (!m_wallet->tryGetBalances(new_balances, block_hash)) {
105        return;
106    }
107
108    if (fForceCheckBalanceChanged || block_hash != m_cached_last_update_tip) {
109        fForceCheckBalanceChanged = false;
110
111        // Balance and number of transactions might have changed
112        m_cached_last_update_tip = block_hash;
113
114        checkBalanceChanged(new_balances);
115        if(transactionTableModel)
116            transactionTableModel->updateConfirmations();
117    }
118}
119
120void WalletModel::checkBalanceChanged(const interfaces::WalletBalances& new_balances)
121{
122    if (new_balances.balanceChanged(m_cached_balances)) {
123        m_cached_balances = new_balances;
124        Q_EMIT balanceChanged(new_balances);
125    }
126}
127
128interfaces::WalletBalances WalletModel::getCachedBalance() const
129{
130    return m_cached_balances;
131}
132
133void WalletModel::updateTransaction()
134{
135    // Balance and number of transactions might have changed
136    fForceCheckBalanceChanged = true;
137}
138
139void WalletModel::updateAddressBook(const QString &address, const QString &label,
140        bool isMine, wallet::AddressPurpose purpose, int status)
141{
142    if(addressTableModel)
143        addressTableModel->updateEntry(address, label, isMine, purpose, status);
144}
145
146bool WalletModel::validateAddress(const QString& address) const
147{
148    return IsValidDestinationString(address.toStdString());
149}
150
151WalletModel::SendCoinsReturn WalletModel::prepareTransaction(WalletModelTransaction &transaction, const CCoinControl& coinControl)
152{
153    transaction.getWtx() = nullptr; // reset tx output
154
155    CAmount total = 0;
156    bool fSubtractFeeFromAmount = false;
157    QList<SendCoinsRecipient> recipients = transaction.getRecipients();
158    std::vector<CRecipient> vecSend;
159
160    if(recipients.empty())
161    {
162        return OK;
163    }
164
165    QSet<QString> setAddress; // Used to detect duplicates
166    int nAddresses = 0;
167
168    // Pre-check input data for validity
169    for (const SendCoinsRecipient &rcp : recipients)
170    {
171        if (rcp.fSubtractFeeFromAmount)
172            fSubtractFeeFromAmount = true;
173        {   // User-entered bitcoin address / amount:
174            if(!validateAddress(rcp.address))
175            {
176                return InvalidAddress;
177            }
178            if(rcp.amount <= 0)
179            {
180                return InvalidAmount;
181            }
182            setAddress.insert(rcp.address);
183            ++nAddresses;
184
185            vecSend.emplace_back(CRecipient{DecodeDestination(rcp.address.toStdString()), rcp.amount, rcp.fSubtractFeeFromAmount});
186
187            total += rcp.amount;
188        }
189    }
190    if(setAddress.size() != nAddresses)
191    {
192        return DuplicateAddress;
193    }
194
195    // If no coin was manually selected, use the cached balance
196    // Future: can merge this call with 'createTransaction'.
197    CAmount nBalance = getAvailableBalance(&coinControl);
198
199    if(total > nBalance)
200    {
201        return AmountExceedsBalance;
202    }
203
204    try {
205        auto& newTx = transaction.getWtx();
206        const auto& res = m_wallet->createTransaction(vecSend, coinControl, /*sign=*/!wallet().privateKeysDisabled(), /*change_pos=*/std::nullopt);
207        if (!res) {
208            Q_EMIT message(tr("Send Coins"), QString::fromStdString(util::ErrorString(res).translated),
209                           CClientUIInterface::MSG_ERROR);
210            return TransactionCreationFailed;
211        }
212
213        newTx = res->tx;
214        CAmount nFeeRequired = res->fee;
215        transaction.setTransactionFee(nFeeRequired);
216        if (fSubtractFeeFromAmount && newTx) {
217            transaction.reassignAmounts(static_cast<int>(res->change_pos.value_or(-1)));
218        }
219
220        // Reject absurdly high fee. (This can never happen because the
221        // wallet never creates transactions with fee greater than
222        // m_default_max_tx_fee. This merely a belt-and-suspenders check).
223        if (nFeeRequired > m_wallet->getDefaultMaxTxFee()) {
224            return AbsurdFee;
225        }
226    } catch (const std::runtime_error& err) {
227        // Something unexpected happened, instruct user to report this bug.
228        Q_EMIT message(tr("Send Coins"), QString::fromStdString(err.what()),
229                       CClientUIInterface::MSG_ERROR);
230        return TransactionCreationFailed;
231    }
232
233    return SendCoinsReturn(OK);
234}
235
236void WalletModel::sendCoins(WalletModelTransaction& transaction)
237{
238    QByteArray transaction_array; /* store serialized transaction */
239
240    {
241        std::vector<std::string> messages;
242        for (const SendCoinsRecipient &rcp : transaction.getRecipients())
243        {
244            if (!rcp.message.isEmpty()) { // Message from normal bitcoin:URI (bitcoin:123...?message=example)
245                messages.emplace_back(rcp.message.toStdString());
246            }
247        }
248
249        auto& newTx = transaction.getWtx();
250        wallet().commitTransaction(newTx, messages);

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.