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.

25,590 bytes · SHA-256 46d390eedc16959f… · 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/transactiontablemodel.h>
6
7#include <qt/addresstablemodel.h>
8#include <qt/bitcoinunits.h>
9#include <qt/clientmodel.h>
10#include <qt/guiconstants.h>
11#include <qt/guiutil.h>
12#include <qt/optionsmodel.h>
13#include <qt/platformstyle.h>
14#include <qt/transactiondesc.h>
15#include <qt/transactionrecord.h>
16#include <qt/walletmodel.h>
17
18#include <core_io.h>
19#include <interfaces/handler.h>
20#include <tinyformat.h>
21#include <uint256.h>
22
23#include <algorithm>
24#include <functional>
25
26#include <QColor>
27#include <QDateTime>
28#include <QDebug>
29#include <QIcon>
30#include <QLatin1Char>
31#include <QLatin1String>
32#include <QList>
33
34
35// Amount column is right-aligned it contains numbers
36static int column_alignments[] = {
37        Qt::AlignLeft|Qt::AlignVCenter, /*status=*/
38        Qt::AlignLeft|Qt::AlignVCenter, /*date=*/
39        Qt::AlignLeft|Qt::AlignVCenter, /*type=*/
40        Qt::AlignLeft|Qt::AlignVCenter, /*address=*/
41        Qt::AlignRight|Qt::AlignVCenter /* amount */
42    };
43
44// Comparison operator for sort/binary search of model tx list
45struct TxLessThan
46{
47    bool operator()(const TransactionRecord &a, const TransactionRecord &b) const
48    {
49        return a.hash < b.hash;
50    }
51    bool operator()(const TransactionRecord &a, const Txid &b) const
52    {
53        return a.hash < b;
54    }
55    bool operator()(const Txid &a, const TransactionRecord &b) const
56    {
57        return a < b.hash;
58    }
59};
60
61// queue notifications to show a non freezing progress dialog e.g. for rescan
62struct TransactionNotification
63{
64public:
65    TransactionNotification() = default;
66    TransactionNotification(Txid _hash, ChangeType _status, bool _showTransaction):
67        hash(_hash), status(_status), showTransaction(_showTransaction) {}
68
69    void invoke(QObject *ttm)
70    {
71        QString strHash = QString::fromStdString(hash.GetHex());
72        qDebug() << "NotifyTransactionChanged: " + strHash + " status= " + QString::number(status);
73        bool invoked = QMetaObject::invokeMethod(ttm, "updateTransaction", Qt::QueuedConnection,
74                                  Q_ARG(QString, strHash),
75                                  Q_ARG(int, status),
76                                  Q_ARG(bool, showTransaction));
77        assert(invoked);
78    }
79private:
80    Txid hash;
81    ChangeType status;
82    bool showTransaction;
83};
84
85// Private implementation
86class TransactionTablePriv
87{
88public:
89    explicit TransactionTablePriv(TransactionTableModel *_parent) :
90        parent(_parent)
91    {
92    }
93
94    TransactionTableModel *parent;
95
96    //! Local cache of wallet sorted by transaction hash
97    QList<TransactionRecord> cachedWallet;
98
99    /** True when model finishes loading all wallet transactions on start */
100    bool m_loaded = false;
101    /** True when transactions are being notified, for instance when scanning */
102    bool m_loading = false;
103    std::vector< TransactionNotification > vQueueNotifications;
104
105    void NotifyTransactionChanged(const Txid& hash, ChangeType status);
106    void DispatchNotifications();
107
108    /* Query entire wallet anew from core.
109     */
110    void refreshWallet(interfaces::Wallet& wallet)
111    {
112        assert(!m_loaded);
113        {
114            for (const auto& wtx : wallet.getWalletTxs()) {
115                if (TransactionRecord::showTransaction()) {
116                    cachedWallet.append(TransactionRecord::decomposeTransaction(wtx));
117                }
118            }
119        }
120        m_loaded = true;
121        DispatchNotifications();
122    }
123
124    /* Update our model of the wallet incrementally, to synchronize our model of the wallet
125       with that of the core.
126
127       Call with transaction that was added, removed or changed.
128     */
129    void updateWallet(interfaces::Wallet& wallet, const Txid& hash, int status, bool showTransaction)
130    {
131        qDebug() << "TransactionTablePriv::updateWallet: " + QString::fromStdString(hash.ToString()) + " " + QString::number(status);
132
133        // Find bounds of this transaction in model
134        QList<TransactionRecord>::iterator lower = std::lower_bound(
135            cachedWallet.begin(), cachedWallet.end(), hash, TxLessThan());
136        QList<TransactionRecord>::iterator upper = std::upper_bound(
137            cachedWallet.begin(), cachedWallet.end(), hash, TxLessThan());
138        int lowerIndex = (lower - cachedWallet.begin());
139        int upperIndex = (upper - cachedWallet.begin());
140        bool inModel = (lower != upper);
141
142        if(status == CT_UPDATED)
143        {
144            if(showTransaction && !inModel)
145                status = CT_NEW; /* Not in model, but want to show, treat as new */
146            if(!showTransaction && inModel)
147                status = CT_DELETED; /* In model, but want to hide, treat as deleted */
148        }
149
150        qDebug() << "    inModel=" + QString::number(inModel) +
151                    " Index=" + QString::number(lowerIndex) + "-" + QString::number(upperIndex) +
152                    " showTransaction=" + QString::number(showTransaction) + " derivedStatus=" + QString::number(status);
153
154        switch(status)
155        {
156        case CT_NEW:
157            if(inModel)
158            {
159                qWarning() << "TransactionTablePriv::updateWallet: Warning: Got CT_NEW, but transaction is already in model";
160                break;
161            }
162            if(showTransaction)
163            {
164                // Find transaction in wallet
165                interfaces::WalletTx wtx = wallet.getWalletTx(hash);
166                if(!wtx.tx)
167                {
168                    qWarning() << "TransactionTablePriv::updateWallet: Warning: Got CT_NEW, but transaction is not in wallet";
169                    break;
170                }
171                // Added -- insert at the right position
172                QList<TransactionRecord> toInsert =
173                        TransactionRecord::decomposeTransaction(wtx);
174                if(!toInsert.isEmpty()) /* only if something to insert */
175                {
176                    parent->beginInsertRows(QModelIndex(), lowerIndex, lowerIndex+toInsert.size()-1);
177                    int insert_idx = lowerIndex;
178                    for (const TransactionRecord &rec : toInsert)
179                    {
180                        cachedWallet.insert(insert_idx, rec);
181                        insert_idx += 1;
182                    }
183                    parent->endInsertRows();
184                }
185            }
186            break;
187        case CT_DELETED:
188            if(!inModel)
189            {
190                qWarning() << "TransactionTablePriv::updateWallet: Warning: Got CT_DELETED, but transaction is not in model";
191                break;
192            }
193            // Removed -- remove entire transaction from table
194            parent->beginRemoveRows(QModelIndex(), lowerIndex, upperIndex-1);
195            cachedWallet.erase(lower, upper);
196            parent->endRemoveRows();
197            break;
198        case CT_UPDATED:
199            // Miscellaneous updates -- nothing to do, status update will take care of this, and is only computed for
200            // visible transactions.
201            for (int i = lowerIndex; i < upperIndex; i++) {
202                TransactionRecord *rec = &cachedWallet[i];
203                rec->status.needsUpdate = true;
204            }
205            break;
206        }
207    }
208
209    int size()
210    {
211        return cachedWallet.size();
212    }
213
214    TransactionRecord* index(interfaces::Wallet& wallet, const uint256& cur_block_hash, const int idx)
215    {
216        if (idx >= 0 && idx < cachedWallet.size()) {
217            TransactionRecord *rec = &cachedWallet[idx];
218
219            // If a status update is needed (blocks came in since last check),
220            // try to update the status of this transaction from the wallet.
221            // Otherwise, simply reuse the cached status.
222            interfaces::WalletTxStatus wtx;
223            int numBlocks;
224            int64_t block_time;
225            if (!cur_block_hash.IsNull() && rec->statusUpdateNeeded(cur_block_hash) && wallet.tryGetTxStatus(rec->hash, wtx, numBlocks, block_time)) {
226                rec->updateStatus(wtx, cur_block_hash, numBlocks, block_time);
227            }
228            return rec;
229        }
230        return nullptr;
231    }
232
233    QString describe(interfaces::Node& node, interfaces::Wallet& wallet, TransactionRecord* rec, BitcoinUnit unit)
234    {
235        return TransactionDesc::toHTML(node, wallet, rec, unit);
236    }
237
238    QString getTxHex(interfaces::Wallet& wallet, TransactionRecord *rec)
239    {
240        auto tx = wallet.getTx(rec->hash);
241        if (tx) {
242            std::string strHex = EncodeHexTx(*tx);
243            return QString::fromStdString(strHex);
244        }
245        return QString();
246    }
247};
248
249TransactionTableModel::TransactionTableModel(const PlatformStyle *_platformStyle, WalletModel *parent):
250        QAbstractTableModel(parent),

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.