Bitcoin Core 29.99.0
P2P Digital Currency
spend.h
Go to the documentation of this file.
1// Copyright (c) 2021-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#ifndef BITCOIN_WALLET_SPEND_H
6#define BITCOIN_WALLET_SPEND_H
7
8#include <consensus/amount.h>
9#include <policy/fees.h>
10#include <util/result.h>
12#include <wallet/transaction.h>
13#include <wallet/wallet.h>
14
15#include <map>
16#include <memory>
17#include <optional>
18#include <set>
19#include <unordered_set>
20#include <vector>
21
22namespace wallet {
25int CalculateMaximumSignedInputSize(const CTxOut& txout, const CWallet* pwallet, const CCoinControl* coin_control);
26int CalculateMaximumSignedInputSize(const CTxOut& txout, const COutPoint outpoint, const SigningProvider* pwallet, bool can_grind_r, const CCoinControl* coin_control);
27struct TxSize {
28 int64_t vsize{-1};
29 int64_t weight{-1};
30};
31
34TxSize CalculateMaximumSignedTxSize(const CTransaction& tx, const CWallet* wallet, const std::vector<CTxOut>& txouts, const CCoinControl* coin_control = nullptr);
35TxSize CalculateMaximumSignedTxSize(const CTransaction& tx, const CWallet* wallet, const CCoinControl* coin_control = nullptr) EXCLUSIVE_LOCKS_REQUIRED(wallet->cs_wallet);
36
46 std::map<OutputType, std::vector<COutput>> coins;
47
49 std::vector<COutput> All() const;
50
53 size_t Size() const;
55 size_t TypesCount() const { return coins.size(); }
56 void Clear();
57 void Erase(const std::unordered_set<COutPoint, SaltedOutpointHasher>& coins_to_remove);
58 void Shuffle(FastRandomContext& rng_fast);
59 void Add(OutputType type, const COutput& out);
60
61 CAmount GetTotalAmount() { return total_amount; }
62 std::optional<CAmount> GetEffectiveTotalAmount() {return total_effective_amount; }
63
64private:
66 CAmount total_amount{0};
68 std::optional<CAmount> total_effective_amount{0};
69};
70
72 // Outputs below the minimum amount will not get selected
74 // Outputs above the maximum amount will not get selected
76 // Return outputs until the minimum sum amount is covered
78 // Maximum number of outputs that can be returned
79 uint64_t max_count{0};
80 // By default, return only spendable outputs
81 bool only_spendable{true};
82 // By default, do not include immature coinbase outputs
84 // By default, skip locked UTXOs
85 bool skip_locked{true};
86};
87
91CoinsResult AvailableCoins(const CWallet& wallet,
92 const CCoinControl* coinControl = nullptr,
93 std::optional<CFeeRate> feerate = std::nullopt,
94 const CoinFilterParams& params = {}) EXCLUSIVE_LOCKS_REQUIRED(wallet.cs_wallet);
95
100CoinsResult AvailableCoinsListUnspent(const CWallet& wallet, const CCoinControl* coinControl = nullptr, CoinFilterParams params = {}) EXCLUSIVE_LOCKS_REQUIRED(wallet.cs_wallet);
101
105const CTxOut& FindNonChangeParentOutput(const CWallet& wallet, const COutPoint& outpoint) EXCLUSIVE_LOCKS_REQUIRED(wallet.cs_wallet);
106
110std::map<CTxDestination, std::vector<COutput>> ListCoins(const CWallet& wallet) EXCLUSIVE_LOCKS_REQUIRED(wallet.cs_wallet);
111
115};
116
121 const CoinsResult& coins,
122 const CoinSelectionParams& coin_sel_params,
123 const std::vector<SelectionFilter>& filters);
124
141util::Result<SelectionResult> AttemptSelection(interfaces::Chain& chain, const CAmount& nTargetValue, OutputGroupTypeMap& groups,
142 const CoinSelectionParams& coin_selection_params, bool allow_mixed_output_types);
143
158util::Result<SelectionResult> ChooseSelectionResult(interfaces::Chain& chain, const CAmount& nTargetValue, Groups& groups, const CoinSelectionParams& coin_selection_params);
159
160// User manually selected inputs that must be part of the transaction
162{
163 std::set<std::shared_ptr<COutput>> coins;
164 // If subtract fee from outputs is disabled, the 'total_amount'
165 // will be the sum of each output effective value
166 // instead of the sum of the outputs amount
168
169 void Insert(const COutput& output, bool subtract_fee_outputs)
170 {
171 if (subtract_fee_outputs) {
172 total_amount += output.txout.nValue;
173 } else {
175 }
176 coins.insert(std::make_shared<COutput>(output));
177 }
178};
179
184util::Result<PreSelectedInputs> FetchSelectedInputs(const CWallet& wallet, const CCoinControl& coin_control,
185 const CoinSelectionParams& coin_selection_params) EXCLUSIVE_LOCKS_REQUIRED(wallet.cs_wallet);
186
199util::Result<SelectionResult> AutomaticCoinSelection(const CWallet& wallet, CoinsResult& available_coins, const CAmount& nTargetValue,
200 const CoinSelectionParams& coin_selection_params) EXCLUSIVE_LOCKS_REQUIRED(wallet.cs_wallet);
201
206util::Result<SelectionResult> SelectCoins(const CWallet& wallet, CoinsResult& available_coins, const PreSelectedInputs& pre_set_inputs,
207 const CAmount& nTargetValue, const CCoinControl& coin_control,
208 const CoinSelectionParams& coin_selection_params) EXCLUSIVE_LOCKS_REQUIRED(wallet.cs_wallet);
209
211{
215 std::optional<unsigned int> change_pos;
216
217 CreatedTransactionResult(CTransactionRef _tx, CAmount _fee, std::optional<unsigned int> _change_pos, const FeeCalculation& _fee_calc)
218 : tx(_tx), fee(_fee), fee_calc(_fee_calc), change_pos(_change_pos) {}
219};
220
226util::Result<CreatedTransactionResult> CreateTransaction(CWallet& wallet, const std::vector<CRecipient>& vecSend, std::optional<unsigned int> change_pos, const CCoinControl& coin_control, bool sign = true);
227
232util::Result<CreatedTransactionResult> FundTransaction(CWallet& wallet, const CMutableTransaction& tx, const std::vector<CRecipient>& recipients, std::optional<unsigned int> change_pos, bool lockUnspents, CCoinControl);
233} // namespace wallet
234
235#endif // BITCOIN_WALLET_SPEND_H
static constexpr CAmount MAX_MONEY
No amount larger than this (in satoshi) is valid.
Definition: amount.h:26
int64_t CAmount
Amount in satoshis (Can be negative)
Definition: amount.h:12
An outpoint - a combination of a transaction hash and an index n into its vout.
Definition: transaction.h:29
The basic transaction that is broadcasted on the network and contained in blocks.
Definition: transaction.h:296
An output of a transaction.
Definition: transaction.h:150
CAmount nValue
Definition: transaction.h:152
Fast randomness source.
Definition: random.h:377
An interface to be implemented by keystores that support signing.
Interface giving clients (wallet processes, maybe other analysis tools in the future) ability to acce...
Definition: chain.h:130
static int sign(const secp256k1_context *ctx, struct signer_secrets *signer_secrets, struct signer *signer, const secp256k1_musig_keyagg_cache *cache, const unsigned char *msg32, unsigned char *sig64)
Definition: musig.c:106
const CTxOut & FindNonChangeParentOutput(const CWallet &wallet, const COutPoint &outpoint)
Find non-change parent output.
Definition: spend.cpp:485
CreatedTransactionResult FundTransaction(CWallet &wallet, const CMutableTransaction &tx, const std::vector< CRecipient > &recipients, const UniValue &options, CCoinControl &coinControl, bool override_min_fee)
Definition: spend.cpp:507
util::Result< SelectionResult > AutomaticCoinSelection(const CWallet &wallet, CoinsResult &available_coins, const CAmount &value_to_select, const CoinSelectionParams &coin_selection_params)
Select a set of coins such that nTargetValue is met; never select unconfirmed coins if they are not o...
Definition: spend.cpp:826
FilteredOutputGroups GroupOutputs(const CWallet &wallet, const CoinsResult &coins, const CoinSelectionParams &coin_sel_params, const std::vector< SelectionFilter > &filters, std::vector< OutputGroup > &ret_discarded_groups)
Definition: spend.cpp:532
util::Result< CreatedTransactionResult > CreateTransaction(CWallet &wallet, const std::vector< CRecipient > &vecSend, std::optional< unsigned int > change_pos, const CCoinControl &coin_control, bool sign)
Create a new transaction paying the recipients with a set of coins selected by SelectCoins(); Also cr...
Definition: spend.cpp:1369
util::Result< PreSelectedInputs > FetchSelectedInputs(const CWallet &wallet, const CCoinControl &coin_control, const CoinSelectionParams &coin_selection_params)
Fetch and validate coin control selected inputs.
Definition: spend.cpp:268
util::Result< SelectionResult > AttemptSelection(interfaces::Chain &chain, const CAmount &nTargetValue, OutputGroupTypeMap &groups, const CoinSelectionParams &coin_selection_params, bool allow_mixed_output_types)
Attempt to find a valid input set that preserves privacy by not mixing OutputTypes.
Definition: spend.cpp:662
util::Result< SelectionResult > ChooseSelectionResult(interfaces::Chain &chain, const CAmount &nTargetValue, Groups &groups, const CoinSelectionParams &coin_selection_params)
Attempt to find a valid input set that meets the provided eligibility filter and target.
Definition: spend.cpp:689
util::Result< SelectionResult > SelectCoins(const CWallet &wallet, CoinsResult &available_coins, const PreSelectedInputs &pre_set_inputs, const CAmount &nTargetValue, const CCoinControl &coin_control, const CoinSelectionParams &coin_selection_params)
Select all coins from coin_control, and if coin_control 'm_allow_other_inputs=true',...
Definition: spend.cpp:774
std::map< CTxDestination, std::vector< COutput > > ListCoins(const CWallet &wallet)
Return list of available coins and locked coins grouped by non-change output address.
Definition: spend.cpp:505
CoinsResult AvailableCoinsListUnspent(const CWallet &wallet, const CCoinControl *coinControl, CoinFilterParams params)
Wrapper function for AvailableCoins which skips the feerate and CoinFilterParams::only_spendable para...
Definition: spend.cpp:479
std::map< CoinEligibilityFilter, OutputGroupTypeMap > FilteredOutputGroups
TxSize CalculateMaximumSignedTxSize(const CTransaction &tx, const CWallet *wallet, const std::vector< CTxOut > &txouts, const CCoinControl *coin_control)
Calculate the size of the transaction using CoinControl to determine whether to expect signature grin...
Definition: spend.cpp:143
int CalculateMaximumSignedInputSize(const CTxOut &txout, const COutPoint outpoint, const SigningProvider *provider, bool can_grind_r, const CCoinControl *coin_control)
Definition: spend.cpp:91
CoinsResult AvailableCoins(const CWallet &wallet, const CCoinControl *coinControl, std::optional< CFeeRate > feerate, const CoinFilterParams &params)
Populate the CoinsResult struct with vectors of available COutputs, organized by OutputType.
Definition: spend.cpp:315
OutputType
Definition: outputtype.h:17
std::shared_ptr< const CTransaction > CTransactionRef
Definition: transaction.h:423
A mutable version of CTransaction.
Definition: transaction.h:378
A UTXO under consideration for use in funding a new transaction.
Definition: coinselection.h:28
CTxOut txout
The output itself.
Definition: coinselection.h:41
CAmount GetEffectiveValue() const
Parameters for filtering which OutputGroups we may use in coin selection.
uint64_t max_count
Definition: spend.h:79
bool include_immature_coinbase
Definition: spend.h:83
CAmount min_sum_amount
Definition: spend.h:77
COutputs available for spending, stored by OutputType.
Definition: spend.h:45
std::optional< CAmount > GetEffectiveTotalAmount()
Definition: spend.h:62
size_t TypesCount() const
Return how many different output types this struct stores.
Definition: spend.h:55
std::map< OutputType, std::vector< COutput > > coins
Definition: spend.h:46
CAmount GetTotalAmount()
Definition: spend.h:61
CreatedTransactionResult(CTransactionRef _tx, CAmount _fee, std::optional< unsigned int > _change_pos, const FeeCalculation &_fee_calc)
Definition: spend.h:217
std::optional< unsigned int > change_pos
Definition: spend.h:215
std::set< std::shared_ptr< COutput > > coins
Definition: spend.h:163
void Insert(const COutput &output, bool subtract_fee_outputs)
Definition: spend.h:169
bool allow_mixed_output_types
Definition: spend.h:114
CoinEligibilityFilter filter
Definition: spend.h:113
int64_t vsize
Definition: spend.h:28
int64_t weight
Definition: spend.h:29
#define EXCLUSIVE_LOCKS_REQUIRED(...)
Definition: threadsafety.h:49