wallet::OutputGroup

A group of UTXOs paid to the same output script.

Synopsis

Declared in <wallet/coinselection.h>

struct OutputGroup;

Member Functions

NameDescription
OutputGroup [constructor]Constructors
EligibleForSpending Report whether this group passes an eligibility filter.
GetSelectionAmount Return the value used for this group during coin selection.
Insert Add an output to the group, updating its aggregate values.

Data Members

NameDescription
effective_value The value of the UTXOs after deducting the cost of spending them at the effective feerate.
fee The fee to spend these UTXOs at the effective feerate.
long_term_fee The fee to spend these UTXOs at the long term feerate.
m_ancestors The aggregated count of unconfirmed ancestors of all UTXOs in this group. Not deduplicated and may overestimate when ancestors are shared.
m_depth The minimum number of confirmations the UTXOs in the group have. Unconfirmed is 0.
m_from_me Whether the UTXOs were sent by the wallet to itself. This is relevant because we may want at least a certain number of confirmations on UTXOs received from outside wallets while trusting our own UTXOs more.
m_long_term_feerate The feerate for spending a created change output eventually (i.e. not urgently, and thus at a lower feerate). Calculated using long term fee estimate. This is used to decide whether it could be economical to create a change output.
m_max_cluster_count The maximum cluster count of a single UTXO in this output group.
m_outputs The list of UTXOs contained in this output group.
m_subtract_fee_outputs Indicate that we are subtracting the fee from outputs. When true, the value that is used for coin selection is the UTXO's real value rather than effective value
m_value The total value of the UTXOs in sum.
m_weight Total weight of the UTXOs in this group.