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.

14,796 bytes · SHA-256 7bbdb2f4fe539e6c… · 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/transactiondesc.h>
6
7#include <qt/bitcoinunits.h>
8#include <qt/guiutil.h>
9#include <qt/paymentserver.h>
10#include <qt/transactionrecord.h>
11
12#include <common/system.h>
13#include <consensus/consensus.h>
14#include <interfaces/node.h>
15#include <interfaces/wallet.h>
16#include <key_io.h>
17#include <policy/policy.h>
18#include <util/log.h>
19#include <validation.h>
20
21#include <cstdint>
22#include <string>
23
24#include <QLatin1String>
25
26QString TransactionDesc::FormatTxStatus(const interfaces::WalletTxStatus& status, bool inMempool)
27{
28    int depth = status.depth_in_main_chain;
29    if (depth < 0) {
30        /*: Text explaining the current status of a transaction, shown in the
31            status field of the details window for this transaction. This status
32            represents an unconfirmed transaction that conflicts with a confirmed
33            transaction. */
34        return tr("conflicted with a transaction with %1 confirmations").arg(-depth);
35    } else if (depth == 0) {
36        QString s;
37        if (inMempool) {
38            /*: Text explaining the current status of a transaction, shown in the
39                status field of the details window for this transaction. This status
40                represents an unconfirmed transaction that is in the memory pool. */
41            s = tr("0/unconfirmed, in memory pool");
42        } else {
43            /*: Text explaining the current status of a transaction, shown in the
44                status field of the details window for this transaction. This status
45                represents an unconfirmed transaction that is not in the memory pool. */
46            s = tr("0/unconfirmed, not in memory pool");
47        }
48        if (status.is_abandoned) {
49            /*: Text explaining the current status of a transaction, shown in the
50                status field of the details window for this transaction. This
51                status represents an abandoned transaction. */
52            s += QLatin1String(", ") + tr("abandoned");
53        }
54        return s;
55    } else if (depth < 6) {
56        /*: Text explaining the current status of a transaction, shown in the
57            status field of the details window for this transaction. This
58            status represents a transaction confirmed in at least one block,
59            but less than 6 blocks. */
60        return tr("%1/unconfirmed").arg(depth);
61    } else {
62        /*: Text explaining the current status of a transaction, shown in the
63            status field of the details window for this transaction. This status
64            represents a transaction confirmed in 6 or more blocks. */
65        return tr("%1 confirmations").arg(depth);
66    }
67}
68
69// Takes an encoded PaymentRequest as a string and tries to find the Common Name of the X.509 certificate
70// used to sign the PaymentRequest.
71bool GetPaymentRequestMerchant(const std::string& pr, QString& merchant)
72{
73    // Search for the supported pki type strings
74    if (pr.find(std::string({0x12, 0x0b}) + "x509+sha256") != std::string::npos || pr.find(std::string({0x12, 0x09}) + "x509+sha1") != std::string::npos) {
75        // We want the common name of the Subject of the cert. This should be the second occurrence
76        // of the bytes 0x0603550403. The first occurrence of those is the common name of the issuer.
77        // After those bytes will be either 0x13 or 0x0C, then length, then either the ascii or utf8
78        // string with the common name which is the merchant name
79        size_t cn_pos = pr.find({0x06, 0x03, 0x55, 0x04, 0x03});
80        if (cn_pos != std::string::npos) {
81            cn_pos = pr.find({0x06, 0x03, 0x55, 0x04, 0x03}, cn_pos + 5);
82            if (cn_pos != std::string::npos) {
83                cn_pos += 5;
84                if (pr[cn_pos] == 0x13 || pr[cn_pos] == 0x0c) {
85                    cn_pos++; // Consume the type
86                    int str_len = pr[cn_pos];
87                    cn_pos++; // Consume the string length
88                    merchant = QString::fromUtf8(pr.data() + cn_pos, str_len);
89                    return true;
90                }
91            }
92        }
93    }
94    return false;
95}
96
97QString TransactionDesc::toHTML(interfaces::Node& node, interfaces::Wallet& wallet, TransactionRecord* rec, BitcoinUnit unit)
98{
99    int numBlocks;
100    interfaces::WalletTxStatus status;
101    bool inMempool;
102    std::vector<std::string> messages;
103    std::vector<std::string> payment_requests;
104    interfaces::WalletTx wtx = wallet.getWalletTxDetails(rec->hash, status, messages, payment_requests, inMempool, numBlocks);
105
106    QString strHTML;
107
108    strHTML.reserve(4000);
109    strHTML += "<html><font face='verdana, arial, helvetica, sans-serif'>";
110
111    int64_t nTime = wtx.time;
112    CAmount nCredit = wtx.credit;
113    CAmount nDebit = wtx.debit;
114    CAmount nNet = nCredit - nDebit;
115
116    strHTML += "<b>" + tr("Status") + ":</b> " + FormatTxStatus(status, inMempool);
117    strHTML += "<br>";
118
119    strHTML += "<b>" + tr("Date") + ":</b> " + (nTime ? GUIUtil::dateTimeStr(nTime) : "") + "<br>";
120
121    //
122    // From
123    //
124    if (wtx.is_coinbase)
125    {
126        strHTML += "<b>" + tr("Source") + ":</b> " + tr("Generated") + "<br>";
127    } else if (wtx.from) {
128        // Online transaction
129        strHTML += "<b>" + tr("From") + ":</b> " + GUIUtil::HtmlEscape(*wtx.from) + "<br>";
130    }
131    else
132    {
133        // Offline transaction
134        if (nNet > 0)
135        {
136            // Credit
137            CTxDestination address = DecodeDestination(rec->address);
138            if (IsValidDestination(address)) {
139                std::string name;
140                if (wallet.getAddress(address, &name, /*purpose=*/nullptr))
141                {
142                    strHTML += "<b>" + tr("From") + ":</b> " + tr("unknown") + "<br>";
143                    strHTML += "<b>" + tr("To") + ":</b> ";
144                    strHTML += GUIUtil::HtmlEscape(rec->address);
145                    QString addressOwned = tr("own address");
146                    if (!name.empty())
147                        strHTML += " (" + addressOwned + ", " + tr("label") + ": " + GUIUtil::HtmlEscape(name) + ")";
148                    else
149                        strHTML += " (" + addressOwned + ")";
150                    strHTML += "<br>";
151                }
152            }
153        }
154    }
155
156    //
157    // To
158    //
159    if (wtx.comment_to) {
160        // Online transaction
161        std::string strAddress = *wtx.comment_to;
162        strHTML += "<b>" + tr("To") + ":</b> ";
163        CTxDestination dest = DecodeDestination(strAddress);
164        std::string name;
165        if (wallet.getAddress(
166                dest, &name, /*purpose=*/nullptr) && !name.empty())
167            strHTML += GUIUtil::HtmlEscape(name) + " ";
168        strHTML += GUIUtil::HtmlEscape(strAddress) + "<br>";
169    }
170
171    //
172    // Amount
173    //
174    if (wtx.is_coinbase && nCredit == 0)
175    {
176        //
177        // Coinbase
178        //
179        CAmount nUnmatured = 0;
180        for (const CTxOut& txout : wtx.tx->vout)
181            nUnmatured += wallet.getCredit(txout);
182        strHTML += "<b>" + tr("Credit") + ":</b> ";
183        if (status.is_in_main_chain)
184            strHTML += BitcoinUnits::formatHtmlWithUnit(unit, nUnmatured)+ " (" + tr("matures in %n more block(s)", "", status.blocks_to_maturity) + ")";
185        else
186            strHTML += "(" + tr("not accepted") + ")";
187        strHTML += "<br>";
188    }
189    else if (nNet > 0)
190    {
191        //
192        // Credit
193        //
194        strHTML += "<b>" + tr("Credit") + ":</b> " + BitcoinUnits::formatHtmlWithUnit(unit, nNet) + "<br>";
195    }
196    else
197    {
198        bool all_from_me = std::all_of(wtx.txin_is_mine.begin(), wtx.txin_is_mine.end(), [](bool mine) { return mine; });
199        bool all_to_me = std::all_of(wtx.txout_is_mine.begin(), wtx.txout_is_mine.end(), [](bool mine) { return mine; });
200
201        if (all_from_me)
202        {
203            // Debit
204            //
205            auto mine = wtx.txout_is_mine.begin();
206            for (const CTxOut& txout : wtx.tx->vout)
207            {
208                // Ignore change
209                bool toSelf = *(mine++);
210                if (toSelf && all_from_me)
211                    continue;
212
213                if (!wtx.comment_to) {
214                    // Offline transaction
215                    CTxDestination address;
216                    if (ExtractDestination(txout.scriptPubKey, address))
217                    {
218                        strHTML += "<b>" + tr("To") + ":</b> ";
219                        std::string name;
220                        if (wallet.getAddress(
221                                address, &name, /*purpose=*/nullptr) && !name.empty())
222                            strHTML += GUIUtil::HtmlEscape(name) + " ";
223                        strHTML += GUIUtil::HtmlEscape(EncodeDestination(address));
224                        if(toSelf)
225                            strHTML += " (" + tr("own address") + ")";
226                        strHTML += "<br>";
227                    }
228                }
229
230                strHTML += "<b>" + tr("Debit") + ":</b> " + BitcoinUnits::formatHtmlWithUnit(unit, -txout.nValue) + "<br>";
231                if(toSelf)
232                    strHTML += "<b>" + tr("Credit") + ":</b> " + BitcoinUnits::formatHtmlWithUnit(unit, txout.nValue) + "<br>";
233            }
234
235            if (all_to_me)
236            {
237                // Payment to self
238                CAmount nChange = wtx.change;
239                CAmount nValue = nCredit - nChange;
240                strHTML += "<b>" + tr("Total debit") + ":</b> " + BitcoinUnits::formatHtmlWithUnit(unit, -nValue) + "<br>";
241                strHTML += "<b>" + tr("Total credit") + ":</b> " + BitcoinUnits::formatHtmlWithUnit(unit, nValue) + "<br>";
242            }
243
244            CAmount nTxFee = nDebit - wtx.tx->GetValueOut();
245            if (nTxFee > 0)
246                strHTML += "<b>" + tr("Transaction fee") + ":</b> " + BitcoinUnits::formatHtmlWithUnit(unit, -nTxFee) + "<br>";
247        }
248        else
249        {
250            //

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.