A group of UTXOs paid to the same output script.

Synopsis

Declared in <wallet/coinselection.h>

struct OutputGroup;

Member Functions

Name

Description

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

Name

Description

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.

Created with MrDocs