Coverage Report

Created: 2026-06-09 19:51

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/root/bitcoin/src/wallet/feebumper.cpp
Line
Count
Source
1
// Copyright (c) 2017-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 <wallet/feebumper.h>
6
7
#include <coins.h>
8
#include <common/system.h>
9
#include <consensus/validation.h>
10
#include <interfaces/chain.h>
11
#include <policy/fees/block_policy_estimator.h>
12
#include <policy/policy.h>
13
#include <util/moneystr.h>
14
#include <util/rbf.h>
15
#include <util/translation.h>
16
#include <wallet/coincontrol.h>
17
#include <wallet/fees.h>
18
#include <wallet/receive.h>
19
#include <wallet/spend.h>
20
#include <wallet/wallet.h>
21
22
namespace wallet {
23
//! Check whether transaction has descendant in wallet or mempool, or has been
24
//! mined, or conflicts with a mined transaction. Return a feebumper::Result.
25
static feebumper::Result PreconditionChecks(const CWallet& wallet, const CWalletTx& wtx, bool require_mine, std::vector<bilingual_str>& errors) EXCLUSIVE_LOCKS_REQUIRED(wallet.cs_wallet)
26
0
{
27
0
    if (wallet.HasWalletSpend(wtx.tx)) {
  Branch (27:9): [True: 0, False: 0]
28
0
        errors.emplace_back(Untranslated("Transaction has descendants in the wallet"));
29
0
        return feebumper::Result::INVALID_PARAMETER;
30
0
    }
31
32
0
    {
33
0
        if (wallet.chain().hasDescendantsInMempool(wtx.GetHash())) {
  Branch (33:13): [True: 0, False: 0]
34
0
            errors.emplace_back(Untranslated("Transaction has descendants in the mempool"));
35
0
            return feebumper::Result::INVALID_PARAMETER;
36
0
        }
37
0
    }
38
39
0
    if (wallet.GetTxDepthInMainChain(wtx) != 0) {
  Branch (39:9): [True: 0, False: 0]
40
0
        errors.emplace_back(Untranslated("Transaction has been mined, or is conflicted with a mined transaction"));
41
0
        return feebumper::Result::WALLET_ERROR;
42
0
    }
43
44
0
    if (wtx.mapValue.contains("replaced_by_txid")) {
  Branch (44:9): [True: 0, False: 0]
45
0
        errors.push_back(Untranslated(strprintf("Cannot bump transaction %s which was already bumped by transaction %s", wtx.GetHash().ToString(), wtx.mapValue.at("replaced_by_txid"))));
46
0
        return feebumper::Result::WALLET_ERROR;
47
0
    }
48
49
0
    if (require_mine) {
  Branch (49:9): [True: 0, False: 0]
50
        // check that original tx consists entirely of our inputs
51
        // if not, we can't bump the fee, because the wallet has no way of knowing the value of the other inputs (thus the fee)
52
0
        if (!AllInputsMine(wallet, *wtx.tx)) {
  Branch (52:13): [True: 0, False: 0]
53
0
            errors.emplace_back(Untranslated("Transaction contains inputs that don't belong to this wallet"));
54
0
            return feebumper::Result::WALLET_ERROR;
55
0
        }
56
0
    }
57
58
0
    return feebumper::Result::OK;
59
0
}
60
61
//! Check if the user provided a valid feeRate
62
static feebumper::Result CheckFeeRate(const CWallet& wallet, const CMutableTransaction& mtx, const CFeeRate& newFeerate, const int64_t maxTxSize, CAmount old_fee, std::vector<bilingual_str>& errors)
63
0
{
64
    // check that fee rate is higher than mempool's minimum fee
65
    // (no point in bumping fee if we know that the new tx won't be accepted to the mempool)
66
    // This may occur if fallbackfee is too low, or, perhaps,
67
    // in a rare situation where the mempool minimum fee increased significantly since the fee estimation just a
68
    // moment earlier. In this case, we report an error to the user, who may adjust the fee.
69
0
    CFeeRate minMempoolFeeRate = wallet.chain().mempoolMinFee();
70
71
0
    if (newFeerate.GetFeePerK() < minMempoolFeeRate.GetFeePerK()) {
  Branch (71:9): [True: 0, False: 0]
72
0
        errors.push_back(Untranslated(
73
0
            strprintf("New fee rate (%s) is lower than the minimum fee rate (%s) to get into the mempool -- ",
74
0
            FormatMoney(newFeerate.GetFeePerK()),
75
0
            FormatMoney(minMempoolFeeRate.GetFeePerK()))));
76
0
        return feebumper::Result::WALLET_ERROR;
77
0
    }
78
79
0
    std::vector<COutPoint> reused_inputs;
80
0
    reused_inputs.reserve(mtx.vin.size());
81
0
    for (const CTxIn& txin : mtx.vin) {
  Branch (81:28): [True: 0, False: 0]
82
0
        reused_inputs.push_back(txin.prevout);
83
0
    }
84
85
0
    const std::optional<CAmount> combined_bump_fee = wallet.chain().calculateCombinedBumpFee(reused_inputs, newFeerate);
86
0
    if (!combined_bump_fee.has_value()) {
  Branch (86:9): [True: 0, False: 0]
87
0
        errors.push_back(Untranslated(strprintf("Failed to calculate bump fees, because unconfirmed UTXOs depend on an enormous cluster of unconfirmed transactions.")));
88
0
        return feebumper::Result::WALLET_ERROR;
89
0
    }
90
0
    CAmount new_total_fee = newFeerate.GetFee(maxTxSize) + combined_bump_fee.value();
91
92
0
    CFeeRate incrementalRelayFee = wallet.chain().relayIncrementalFee();
93
94
    // Min total fee is old fee + relay fee
95
0
    CAmount minTotalFee = old_fee + incrementalRelayFee.GetFee(maxTxSize);
96
97
0
    if (new_total_fee < minTotalFee) {
  Branch (97:9): [True: 0, False: 0]
98
0
        errors.push_back(Untranslated(strprintf("Insufficient total fee %s, must be at least %s (oldFee %s + incrementalFee %s)",
99
0
            FormatMoney(new_total_fee), FormatMoney(minTotalFee), FormatMoney(old_fee), FormatMoney(incrementalRelayFee.GetFee(maxTxSize)))));
100
0
        return feebumper::Result::INVALID_PARAMETER;
101
0
    }
102
103
0
    CAmount requiredFee = GetRequiredFee(wallet, maxTxSize);
104
0
    if (new_total_fee < requiredFee) {
  Branch (104:9): [True: 0, False: 0]
105
0
        errors.push_back(Untranslated(strprintf("Insufficient total fee (cannot be less than required fee %s)",
106
0
            FormatMoney(requiredFee))));
107
0
        return feebumper::Result::INVALID_PARAMETER;
108
0
    }
109
110
    // Check that in all cases the new fee doesn't violate maxTxFee
111
0
    const CAmount max_tx_fee = wallet.m_default_max_tx_fee;
112
0
    if (new_total_fee > max_tx_fee) {
  Branch (112:9): [True: 0, False: 0]
113
0
        errors.push_back(Untranslated(strprintf("Specified or calculated fee %s is too high (cannot be higher than -maxtxfee %s)",
114
0
            FormatMoney(new_total_fee), FormatMoney(max_tx_fee))));
115
0
        return feebumper::Result::WALLET_ERROR;
116
0
    }
117
118
0
    return feebumper::Result::OK;
119
0
}
120
121
static CFeeRate EstimateFeeRate(const CWallet& wallet, const CWalletTx& wtx, const CAmount old_fee, const CCoinControl& coin_control)
122
0
{
123
    // Get the fee rate of the original transaction. This is calculated from
124
    // the tx fee/vsize, so it may have been rounded down. Add 1 satoshi to the
125
    // result.
126
0
    int64_t txSize = GetVirtualTransactionSize(*(wtx.tx));
127
0
    CFeeRate feerate(old_fee, txSize);
128
0
    feerate += CFeeRate(1);
129
130
    // The node has a configurable incremental relay fee. Increment the fee by
131
    // the minimum of that and the wallet's conservative
132
    // WALLET_INCREMENTAL_RELAY_FEE value to future proof against changes to
133
    // network wide policy for incremental relay fee that our node may not be
134
    // aware of. This ensures we're over the required relay fee rate
135
    // (Rule 4).  The replacement tx will be at least as large as the
136
    // original tx, so the total fee will be greater (Rule 3)
137
0
    CFeeRate node_incremental_relay_fee = wallet.chain().relayIncrementalFee();
138
0
    CFeeRate wallet_incremental_relay_fee = CFeeRate(WALLET_INCREMENTAL_RELAY_FEE);
139
0
    feerate += std::max(node_incremental_relay_fee, wallet_incremental_relay_fee);
140
141
    // Fee rate must also be at least the wallet's GetMinimumFeeRate
142
0
    CFeeRate min_feerate(GetMinimumFeeRate(wallet, coin_control, /*feeCalc=*/nullptr));
143
144
    // Set the required fee rate for the replacement transaction in coin control.
145
0
    return std::max(feerate, min_feerate);
146
0
}
147
148
namespace feebumper {
149
150
bool TransactionCanBeBumped(const CWallet& wallet, const Txid& txid)
151
0
{
152
0
    LOCK(wallet.cs_wallet);
153
0
    const CWalletTx* wtx = wallet.GetWalletTx(txid);
154
0
    if (wtx == nullptr) return false;
  Branch (154:9): [True: 0, False: 0]
155
156
0
    std::vector<bilingual_str> errors_dummy;
157
0
    feebumper::Result res = PreconditionChecks(wallet, *wtx, /* require_mine=*/ true, errors_dummy);
158
0
    return res == feebumper::Result::OK;
159
0
}
160
161
Result CreateRateBumpTransaction(CWallet& wallet, const Txid& txid, const CCoinControl& coin_control, std::vector<bilingual_str>& errors,
162
                                 CAmount& old_fee, CAmount& new_fee, CMutableTransaction& mtx, bool require_mine, const std::vector<CTxOut>& outputs, std::optional<uint32_t> original_change_index)
163
0
{
164
    // For now, cannot specify both new outputs to use and an output index to send change
165
0
    if (!outputs.empty() && original_change_index.has_value()) {
  Branch (165:9): [True: 0, False: 0]
  Branch (165:29): [True: 0, False: 0]
166
0
        errors.emplace_back(Untranslated("The options 'outputs' and 'original_change_index' are incompatible. You can only either specify a new set of outputs, or designate a change output to be recycled."));
167
0
        return Result::INVALID_PARAMETER;
168
0
    }
169
170
    // We are going to modify coin control later, copy to reuse
171
0
    CCoinControl new_coin_control(coin_control);
172
173
0
    LOCK(wallet.cs_wallet);
174
0
    errors.clear();
175
0
    auto it = wallet.mapWallet.find(txid);
176
0
    if (it == wallet.mapWallet.end()) {
  Branch (176:9): [True: 0, False: 0]
177
0
        errors.emplace_back(Untranslated("Invalid or non-wallet transaction id"));
178
0
        return Result::INVALID_ADDRESS_OR_KEY;
179
0
    }
180
0
    const CWalletTx& wtx = it->second;
181
182
    // Make sure that original_change_index is valid
183
0
    if (original_change_index.has_value() && original_change_index.value() >= wtx.tx->vout.size()) {
  Branch (183:9): [True: 0, False: 0]
  Branch (183:46): [True: 0, False: 0]
184
0
        errors.emplace_back(Untranslated("Change position is out of range"));
185
0
        return Result::INVALID_PARAMETER;
186
0
    }
187
188
    // Retrieve all of the UTXOs and add them to coin control
189
    // While we're here, calculate the input amount
190
0
    std::map<COutPoint, Coin> coins;
191
0
    CAmount input_value = 0;
192
0
    std::vector<CTxOut> spent_outputs;
193
0
    for (const CTxIn& txin : wtx.tx->vin) {
  Branch (193:28): [True: 0, False: 0]
194
0
        coins[txin.prevout]; // Create empty map entry keyed by prevout.
195
0
    }
196
0
    wallet.chain().findCoins(coins);
197
0
    for (const CTxIn& txin : wtx.tx->vin) {
  Branch (197:28): [True: 0, False: 0]
198
0
        const Coin& coin = coins.at(txin.prevout);
199
0
        if (coin.out.IsNull()) {
  Branch (199:13): [True: 0, False: 0]
200
0
            errors.emplace_back(Untranslated(strprintf("%s:%u is already spent", txin.prevout.hash.GetHex(), txin.prevout.n)));
201
0
            return Result::MISC_ERROR;
202
0
        }
203
0
        PreselectedInput& preset_txin = new_coin_control.Select(txin.prevout);
204
0
        if (!wallet.IsMine(txin.prevout)) {
  Branch (204:13): [True: 0, False: 0]
205
0
            preset_txin.SetTxOut(coin.out);
206
0
        }
207
0
        input_value += coin.out.nValue;
208
0
        spent_outputs.push_back(coin.out);
209
0
    }
210
211
    // Figure out if we need to compute the input weight, and do so if necessary
212
0
    PrecomputedTransactionData txdata;
213
0
    txdata.Init(*wtx.tx, std::move(spent_outputs), /* force=*/ true);
214
0
    for (unsigned int i = 0; i < wtx.tx->vin.size(); ++i) {
  Branch (214:30): [True: 0, False: 0]
215
0
        const CTxIn& txin = wtx.tx->vin.at(i);
216
0
        const Coin& coin = coins.at(txin.prevout);
217
218
0
        if (new_coin_control.IsExternalSelected(txin.prevout)) {
  Branch (218:13): [True: 0, False: 0]
219
            // For external inputs, we estimate the size using the size of this input
220
0
            int64_t input_weight = GetTransactionInputWeight(txin);
221
            // Because signatures can have different sizes, we need to figure out all of the
222
            // signature sizes and replace them with the max sized signature.
223
            // In order to do this, we verify the script with a special SignatureChecker which
224
            // will observe the signatures verified and record their sizes.
225
0
            SignatureWeights weights;
226
0
            TransactionSignatureChecker tx_checker(wtx.tx.get(), i, coin.out.nValue, txdata, MissingDataBehavior::FAIL);
227
0
            SignatureWeightChecker size_checker(weights, tx_checker);
228
0
            VerifyScript(txin.scriptSig, coin.out.scriptPubKey, &txin.scriptWitness, STANDARD_SCRIPT_VERIFY_FLAGS, size_checker);
229
            // Add the difference between max and current to input_weight so that it represents the largest the input could be
230
0
            input_weight += weights.GetWeightDiffToMax();
231
0
            new_coin_control.SetInputWeight(txin.prevout, input_weight);
232
0
        }
233
0
    }
234
235
0
    Result result = PreconditionChecks(wallet, wtx, require_mine, errors);
236
0
    if (result != Result::OK) {
  Branch (236:9): [True: 0, False: 0]
237
0
        return result;
238
0
    }
239
240
    // Calculate the old output amount.
241
0
    CAmount output_value = 0;
242
0
    for (const auto& old_output : wtx.tx->vout) {
  Branch (242:33): [True: 0, False: 0]
243
0
        output_value += old_output.nValue;
244
0
    }
245
246
0
    old_fee = input_value - output_value;
247
248
    // Fill in recipients (and preserve a single change key if there
249
    // is one). If outputs vector is non-empty, replace original
250
    // outputs with its contents, otherwise use original outputs.
251
0
    std::vector<CRecipient> recipients;
252
0
    CAmount new_outputs_value = 0;
253
0
    const auto& txouts = outputs.empty() ? wtx.tx->vout : outputs;
  Branch (253:26): [True: 0, False: 0]
254
0
    for (size_t i = 0; i < txouts.size(); ++i) {
  Branch (254:24): [True: 0, False: 0]
255
0
        const CTxOut& output = txouts.at(i);
256
0
        CTxDestination dest;
257
0
        ExtractDestination(output.scriptPubKey, dest);
258
0
        if (original_change_index.has_value() ?  original_change_index.value() == i : OutputIsChange(wallet, output)) {
  Branch (258:13): [True: 0, False: 0]
  Branch (258:13): [True: 0, False: 0]
259
0
            new_coin_control.destChange = dest;
260
0
        } else {
261
0
            CRecipient recipient = {dest, output.nValue, false};
262
0
            recipients.push_back(recipient);
263
0
        }
264
0
        new_outputs_value += output.nValue;
265
0
    }
266
267
    // If no recipients, means that we are sending coins to a change address
268
0
    if (recipients.empty()) {
  Branch (268:9): [True: 0, False: 0]
269
        // Just as a sanity check, ensure that the change address exist
270
0
        if (std::get_if<CNoDestination>(&new_coin_control.destChange)) {
  Branch (270:13): [True: 0, False: 0]
271
0
            errors.emplace_back(Untranslated("Unable to create transaction. Transaction must have at least one recipient"));
272
0
            return Result::INVALID_PARAMETER;
273
0
        }
274
275
        // Add change as recipient with SFFO flag enabled, so fees are deduced from it.
276
        // If the output differs from the original tx output (because the user customized it) a new change output will be created.
277
0
        recipients.emplace_back(CRecipient{new_coin_control.destChange, new_outputs_value, /*fSubtractFeeFromAmount=*/true});
278
0
        new_coin_control.destChange = CNoDestination();
279
0
    }
280
281
0
    if (coin_control.m_feerate) {
  Branch (281:9): [True: 0, False: 0]
282
        // The user provided a feeRate argument.
283
        // We calculate this here to avoid compiler warning on the cs_wallet lock
284
        // We need to make a temporary transaction with no input witnesses as the dummy signer expects them to be empty for external inputs
285
0
        CMutableTransaction temp_mtx{*wtx.tx};
286
0
        for (auto& txin : temp_mtx.vin) {
  Branch (286:25): [True: 0, False: 0]
287
0
            txin.scriptSig.clear();
288
0
            txin.scriptWitness.SetNull();
289
0
        }
290
0
        temp_mtx.vout = txouts;
291
0
        const int64_t maxTxSize{CalculateMaximumSignedTxSize(CTransaction(temp_mtx), &wallet, &new_coin_control).vsize};
292
0
        Result res = CheckFeeRate(wallet, temp_mtx, *new_coin_control.m_feerate, maxTxSize, old_fee, errors);
293
0
        if (res != Result::OK) {
  Branch (293:13): [True: 0, False: 0]
294
0
            return res;
295
0
        }
296
0
    } else {
297
        // The user did not provide a feeRate argument
298
0
        new_coin_control.m_feerate = EstimateFeeRate(wallet, wtx, old_fee, new_coin_control);
299
0
    }
300
301
    // Fill in required inputs we are double-spending(all of them)
302
    // N.B.: bip125 doesn't require all the inputs in the replaced transaction to be
303
    // used in the replacement transaction, but it's very important for wallets to make
304
    // sure that happens. If not, it would be possible to bump a transaction A twice to
305
    // A2 and A3 where A2 and A3 don't conflict (or alternatively bump A to A2 and A2
306
    // to A3 where A and A3 don't conflict). If both later get confirmed then the sender
307
    // has accidentally double paid.
308
0
    for (const auto& inputs : wtx.tx->vin) {
  Branch (308:29): [True: 0, False: 0]
309
0
        new_coin_control.Select(COutPoint(inputs.prevout));
310
0
    }
311
0
    new_coin_control.m_allow_other_inputs = true;
312
313
    // We cannot source new unconfirmed inputs(bip125 rule 2)
314
0
    new_coin_control.m_min_depth = 1;
315
316
0
    auto res = CreateTransaction(wallet, recipients, /*change_pos=*/std::nullopt, new_coin_control, false);
317
0
    if (!res) {
  Branch (317:9): [True: 0, False: 0]
318
0
        errors.emplace_back(Untranslated("Unable to create transaction.") + Untranslated(" ") + util::ErrorString(res));
319
0
        return Result::WALLET_ERROR;
320
0
    }
321
322
0
    const auto& txr = *res;
323
    // Write back new fee if successful
324
0
    new_fee = txr.fee;
325
326
    // Write back transaction
327
0
    mtx = CMutableTransaction(*txr.tx);
328
329
0
    return Result::OK;
330
0
}
331
332
0
bool SignTransaction(CWallet& wallet, CMutableTransaction& mtx) {
333
0
    LOCK(wallet.cs_wallet);
334
335
0
    if (wallet.IsWalletFlagSet(WALLET_FLAG_EXTERNAL_SIGNER)) {
  Branch (335:9): [True: 0, False: 0]
336
        // Make a blank psbt
337
0
        PartiallySignedTransaction psbtx(mtx);
338
339
        // First fill transaction with our data without signing,
340
        // so external signers are not asked to sign more than once.
341
0
        bool complete;
342
0
        wallet.FillPSBT(psbtx, {.sign = false, .bip32_derivs = true}, complete);
343
0
        auto err{wallet.FillPSBT(psbtx, {.sign = true, .bip32_derivs = false}, complete)};
344
0
        if (err) return false;
  Branch (344:13): [True: 0, False: 0]
345
0
        complete = FinalizeAndExtractPSBT(psbtx, mtx);
346
0
        return complete;
347
0
    } else {
348
0
        return wallet.SignTransaction(mtx);
349
0
    }
350
0
}
351
352
Result CommitTransaction(CWallet& wallet, const Txid& txid, CMutableTransaction&& mtx, std::vector<bilingual_str>& errors, Txid& bumped_txid)
353
0
{
354
0
    LOCK(wallet.cs_wallet);
355
0
    if (!errors.empty()) {
  Branch (355:9): [True: 0, False: 0]
356
0
        return Result::MISC_ERROR;
357
0
    }
358
0
    auto it = txid.IsNull() ? wallet.mapWallet.end() : wallet.mapWallet.find(txid);
  Branch (358:15): [True: 0, False: 0]
359
0
    if (it == wallet.mapWallet.end()) {
  Branch (359:9): [True: 0, False: 0]
360
0
        errors.emplace_back(Untranslated("Invalid or non-wallet transaction id"));
361
0
        return Result::MISC_ERROR;
362
0
    }
363
0
    const CWalletTx& oldWtx = it->second;
364
365
    // make sure the transaction still has no descendants and hasn't been mined in the meantime
366
0
    Result result = PreconditionChecks(wallet, oldWtx, /* require_mine=*/ false, errors);
367
0
    if (result != Result::OK) {
  Branch (367:9): [True: 0, False: 0]
368
0
        return result;
369
0
    }
370
371
    // commit/broadcast the tx
372
0
    CTransactionRef tx = MakeTransactionRef(std::move(mtx));
373
0
    mapValue_t mapValue = oldWtx.mapValue;
374
0
    mapValue["replaces_txid"] = oldWtx.GetHash().ToString();
375
376
0
    wallet.CommitTransaction(tx, std::move(mapValue), oldWtx.vOrderForm);
377
378
    // mark the original tx as bumped
379
0
    bumped_txid = tx->GetHash();
380
0
    if (!wallet.MarkReplaced(oldWtx.GetHash(), bumped_txid)) {
  Branch (380:9): [True: 0, False: 0]
381
0
        errors.emplace_back(Untranslated("Created new bumpfee transaction but could not mark the original transaction as replaced"));
382
0
    }
383
0
    return Result::OK;
384
0
}
385
386
} // namespace feebumper
387
} // namespace wallet