Bitcoin Core  22.99.0
P2P Digital Currency
coincontrol.h
Go to the documentation of this file.
1 // Copyright (c) 2011-2019 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_COINCONTROL_H
6 #define BITCOIN_WALLET_COINCONTROL_H
7 
8 #include <outputtype.h>
9 #include <policy/feerate.h>
10 #include <policy/fees.h>
11 #include <primitives/transaction.h>
12 #include <script/keyorigin.h>
13 #include <script/signingprovider.h>
14 #include <script/standard.h>
15 
16 #include <optional>
17 #include <algorithm>
18 #include <map>
19 #include <set>
20 
21 const int DEFAULT_MIN_DEPTH = 0;
22 const int DEFAULT_MAX_DEPTH = 9999999;
23 
25 static constexpr bool DEFAULT_AVOIDPARTIALSPENDS = false;
26 
29 {
30 public:
34  std::optional<OutputType> m_change_type;
36  bool m_add_inputs = true;
40  bool fAllowOtherInputs = false;
42  bool fAllowWatchOnly = false;
44  bool fOverrideFeeRate = false;
46  std::optional<CFeeRate> m_feerate;
48  std::optional<unsigned int> m_confirm_target;
50  std::optional<bool> m_signal_bip125_rbf;
54  bool m_avoid_address_reuse = false;
63 
64  CCoinControl();
65 
66  bool HasSelected() const
67  {
68  return (setSelected.size() > 0);
69  }
70 
71  bool IsSelected(const COutPoint& output) const
72  {
73  return (setSelected.count(output) > 0);
74  }
75 
76  bool IsExternalSelected(const COutPoint& output) const
77  {
78  return (m_external_txouts.count(output) > 0);
79  }
80 
81  bool GetExternalOutput(const COutPoint& outpoint, CTxOut& txout) const
82  {
83  const auto ext_it = m_external_txouts.find(outpoint);
84  if (ext_it == m_external_txouts.end()) {
85  return false;
86  }
87  txout = ext_it->second;
88  return true;
89  }
90 
91  void Select(const COutPoint& output)
92  {
93  setSelected.insert(output);
94  }
95 
96  void SelectExternal(const COutPoint& outpoint, const CTxOut& txout)
97  {
98  setSelected.insert(outpoint);
99  m_external_txouts.emplace(outpoint, txout);
100  }
101 
102  void UnSelect(const COutPoint& output)
103  {
104  setSelected.erase(output);
105  }
106 
107  void UnSelectAll()
108  {
109  setSelected.clear();
110  }
111 
112  void ListSelected(std::vector<COutPoint>& vOutpoints) const
113  {
114  vOutpoints.assign(setSelected.begin(), setSelected.end());
115  }
116 
117 private:
118  std::set<COutPoint> setSelected;
119  std::map<COutPoint, CTxOut> m_external_txouts;
120 };
121 
122 #endif // BITCOIN_WALLET_COINCONTROL_H
CCoinControl::Select
void Select(const COutPoint &output)
Definition: coincontrol.h:91
CCoinControl::fAllowOtherInputs
bool fAllowOtherInputs
If false, allows unselected inputs, but requires all selected inputs be used.
Definition: coincontrol.h:40
feerate.h
CCoinControl::m_signal_bip125_rbf
std::optional< bool > m_signal_bip125_rbf
Override the wallet's m_signal_rbf if set.
Definition: coincontrol.h:50
CCoinControl::fOverrideFeeRate
bool fOverrideFeeRate
Override automatic min/max checks on fee, m_feerate must be set if true.
Definition: coincontrol.h:44
CCoinControl::CCoinControl
CCoinControl()
Definition: coincontrol.cpp:9
CCoinControl::ListSelected
void ListSelected(std::vector< COutPoint > &vOutpoints) const
Definition: coincontrol.h:112
CCoinControl::m_avoid_partial_spends
bool m_avoid_partial_spends
Avoid partial use of funds sent to a given address.
Definition: coincontrol.h:52
transaction.h
CCoinControl::SelectExternal
void SelectExternal(const COutPoint &outpoint, const CTxOut &txout)
Definition: coincontrol.h:96
CCoinControl::m_fee_mode
FeeEstimateMode m_fee_mode
Fee estimation mode to control arguments to estimateSmartFee.
Definition: coincontrol.h:56
outputtype.h
CCoinControl
Coin Control Features.
Definition: coincontrol.h:28
CCoinControl::m_include_unsafe_inputs
bool m_include_unsafe_inputs
If false, only safe inputs will be used.
Definition: coincontrol.h:38
CCoinControl::IsSelected
bool IsSelected(const COutPoint &output) const
Definition: coincontrol.h:71
CCoinControl::m_feerate
std::optional< CFeeRate > m_feerate
Override the wallet's m_pay_tx_fee if set.
Definition: coincontrol.h:46
CCoinControl::HasSelected
bool HasSelected() const
Definition: coincontrol.h:66
CCoinControl::m_confirm_target
std::optional< unsigned int > m_confirm_target
Override the default confirmation target if set.
Definition: coincontrol.h:48
CCoinControl::m_change_type
std::optional< OutputType > m_change_type
Override the default change type if set, ignored if destChange is set.
Definition: coincontrol.h:34
signingprovider.h
CCoinControl::fAllowWatchOnly
bool fAllowWatchOnly
Includes watch only addresses which are solvable.
Definition: coincontrol.h:42
CTxDestination
std::variant< CNoDestination, PKHash, ScriptHash, WitnessV0ScriptHash, WitnessV0KeyHash, WitnessV1Taproot, WitnessUnknown > CTxDestination
A txout script template with a specific destination.
Definition: standard.h:157
CTxOut
An output of a transaction.
Definition: transaction.h:128
CCoinControl::m_avoid_address_reuse
bool m_avoid_address_reuse
Forbids inclusion of dirty (previously used) addresses.
Definition: coincontrol.h:54
FeeEstimateMode
FeeEstimateMode
Definition: feerate.h:18
CCoinControl::UnSelectAll
void UnSelectAll()
Definition: coincontrol.h:107
standard.h
CCoinControl::setSelected
std::set< COutPoint > setSelected
Definition: coincontrol.h:118
CCoinControl::IsExternalSelected
bool IsExternalSelected(const COutPoint &output) const
Definition: coincontrol.h:76
CCoinControl::m_external_txouts
std::map< COutPoint, CTxOut > m_external_txouts
Definition: coincontrol.h:119
FeeEstimateMode::UNSET
@ UNSET
Use default settings based on other criteria.
CCoinControl::m_min_depth
int m_min_depth
Minimum chain depth value for coin availability.
Definition: coincontrol.h:58
CNoDestination
Definition: standard.h:73
CCoinControl::m_max_depth
int m_max_depth
Maximum chain depth value for coin availability.
Definition: coincontrol.h:60
DEFAULT_MAX_DEPTH
const int DEFAULT_MAX_DEPTH
Definition: coincontrol.h:22
DEFAULT_MIN_DEPTH
const int DEFAULT_MIN_DEPTH
Definition: coincontrol.h:21
fees.h
CCoinControl::GetExternalOutput
bool GetExternalOutput(const COutPoint &outpoint, CTxOut &txout) const
Definition: coincontrol.h:81
COutPoint
An outpoint - a combination of a transaction hash and an index n into its vout.
Definition: transaction.h:26
keyorigin.h
CCoinControl::m_external_provider
FlatSigningProvider m_external_provider
SigningProvider that has pubkeys and scripts to do spend size estimation for external inputs.
Definition: coincontrol.h:62
CCoinControl::UnSelect
void UnSelect(const COutPoint &output)
Definition: coincontrol.h:102
FlatSigningProvider
Definition: signingprovider.h:73
DEFAULT_AVOIDPARTIALSPENDS
static constexpr bool DEFAULT_AVOIDPARTIALSPENDS
Default for -avoidpartialspends.
Definition: coincontrol.h:25
CCoinControl::m_add_inputs
bool m_add_inputs
If false, only selected inputs are used.
Definition: coincontrol.h:36
CCoinControl::destChange
CTxDestination destChange
Custom change destination, if not set an address is generated.
Definition: coincontrol.h:32