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.

6,453 bytes · SHA-256 d6f60ea29df61e6f… · 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/transactionrecord.h>
6
7#include <chain.h>
8#include <interfaces/wallet.h>
9#include <key_io.h>
10
11#include <cstdint>
12
13#include <QDateTime>
14
15/* Return positive answer if transaction should be shown in list.
16 */
17bool TransactionRecord::showTransaction()
18{
19    // There are currently no cases where we hide transactions, but
20    // we may want to use this in the future for things like RBF.
21    return true;
22}
23
24/*
25 * Decompose CWallet transaction to model transaction records.
26 */
27QList<TransactionRecord> TransactionRecord::decomposeTransaction(const interfaces::WalletTx& wtx)
28{
29    QList<TransactionRecord> parts;
30    int64_t nTime = wtx.time;
31    CAmount nCredit = wtx.credit;
32    CAmount nDebit = wtx.debit;
33    CAmount nNet = nCredit - nDebit;
34    Txid hash = wtx.tx->GetHash();
35
36    bool all_from_me = true;
37    bool any_from_me = false;
38    if (wtx.is_coinbase) {
39        all_from_me = false;
40    } else {
41        for (const bool mine : wtx.txin_is_mine)
42        {
43            all_from_me = all_from_me && mine;
44            if (mine) any_from_me = true;
45        }
46    }
47
48    if (all_from_me || !any_from_me) {
49        CAmount nTxFee = nDebit - wtx.tx->GetValueOut();
50
51        for(unsigned int i = 0; i < wtx.tx->vout.size(); i++)
52        {
53            const CTxOut& txout = wtx.tx->vout[i];
54
55            if (all_from_me) {
56                // Change is only really possible if we're the sender
57                // Otherwise, someone just sent bitcoins to a change address, which should be shown
58                if (wtx.txout_is_change[i]) {
59                    continue;
60                }
61
62                //
63                // Debit
64                //
65
66                TransactionRecord sub(hash, nTime);
67                sub.idx = i;
68
69                if (!std::get_if<CNoDestination>(&wtx.txout_address[i]))
70                {
71                    // Sent to Bitcoin Address
72                    sub.type = TransactionRecord::SendToAddress;
73                    sub.address = EncodeDestination(wtx.txout_address[i]);
74                }
75                else
76                {
77                    // Sent to IP, or other non-address transaction like OP_EVAL
78                    sub.type = TransactionRecord::SendToOther;
79                    sub.address = wtx.comment_to.value_or("");
80                }
81
82                CAmount nValue = txout.nValue;
83                /* Add fee to first output */
84                if (nTxFee > 0)
85                {
86                    nValue += nTxFee;
87                    nTxFee = 0;
88                }
89                sub.debit = -nValue;
90
91                parts.append(sub);
92            }
93
94            bool mine = wtx.txout_is_mine[i];
95            if(mine)
96            {
97                //
98                // Credit
99                //
100
101                TransactionRecord sub(hash, nTime);
102                sub.idx = i; // vout index
103                sub.credit = txout.nValue;
104                if (wtx.txout_address_is_mine[i])
105                {
106                    // Received by Bitcoin Address
107                    sub.type = TransactionRecord::RecvWithAddress;
108                    sub.address = EncodeDestination(wtx.txout_address[i]);
109                }
110                else
111                {
112                    // Received by IP connection (deprecated features), or a multisignature or other non-simple transaction
113                    sub.type = TransactionRecord::RecvFromOther;
114                    sub.address = wtx.from.value_or("");
115                }
116                if (wtx.is_coinbase)
117                {
118                    // Generated
119                    sub.type = TransactionRecord::Generated;
120                }
121
122                parts.append(sub);
123            }
124        }
125    } else {
126        //
127        // Mixed debit transaction, can't break down payees
128        //
129        parts.append(TransactionRecord(hash, nTime, TransactionRecord::Other, "", nNet, 0));
130    }
131
132    return parts;
133}
134
135void TransactionRecord::updateStatus(const interfaces::WalletTxStatus& wtx, const uint256& block_hash, int numBlocks, int64_t block_time)
136{
137    // Determine transaction status
138
139    // Sort order, unrecorded transactions sort to the top
140    int typesort;
141    switch (type) {
142    case SendToAddress: case SendToOther:
143        typesort = 2; break;
144    case RecvWithAddress: case RecvFromOther:
145        typesort = 3; break;
146    default:
147        typesort = 9;
148    }
149    status.sortKey = strprintf("%010d-%01d-%010u-%03d-%d",
150        wtx.block_height,
151        wtx.is_coinbase ? 1 : 0,
152        wtx.time_received,
153        idx,
154        typesort);
155    status.countsForBalance = wtx.is_trusted && !(wtx.blocks_to_maturity > 0);
156    status.depth = wtx.depth_in_main_chain;
157    status.m_cur_block_hash = block_hash;
158
159    // For generated transactions, determine maturity
160    if (type == TransactionRecord::Generated) {
161        if (wtx.blocks_to_maturity > 0)
162        {
163            status.status = TransactionStatus::Immature;
164
165            if (wtx.is_in_main_chain)
166            {
167                status.matures_in = wtx.blocks_to_maturity;
168            }
169            else
170            {
171                status.status = TransactionStatus::NotAccepted;
172            }
173        }
174        else
175        {
176            status.status = TransactionStatus::Confirmed;
177        }
178    }
179    else
180    {
181        if (status.depth < 0)
182        {
183            status.status = TransactionStatus::Conflicted;
184        }
185        else if (status.depth == 0)
186        {
187            status.status = TransactionStatus::Unconfirmed;
188            if (wtx.is_abandoned)
189                status.status = TransactionStatus::Abandoned;
190        }
191        else if (status.depth < RecommendedNumConfirmations)
192        {
193            status.status = TransactionStatus::Confirming;
194        }
195        else
196        {
197            status.status = TransactionStatus::Confirmed;
198        }
199    }
200    status.needsUpdate = false;
201}
202
203bool TransactionRecord::statusUpdateNeeded(const uint256& block_hash) const
204{
205    assert(!block_hash.IsNull());
206    return status.m_cur_block_hash != block_hash || status.needsUpdate;
207}
208
209QString TransactionRecord::getTxHash() const
210{
211    return QString::fromStdString(hash.ToString());
212}
213
214int TransactionRecord::getOutputIndex() const
215{
216    return idx;
217}
218

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.