wallet::OutputGroup Struct Reference

A group of UTXOs paid to the same output script. More...

#include <coinselection.h>

Collaboration diagram for wallet::OutputGroup:

Public Member Functions
	OutputGroup ()
	OutputGroup (const CoinSelectionParams &params)
void	Insert (const COutput &output, size_t ancestors, size_t descendants, bool positive_only)
bool	EligibleForSpending (const CoinEligibilityFilter &eligibility_filter) const
CAmount	GetSelectionAmount () const

Public Attributes
std::vector< COutput >	m_outputs
	The list of UTXOs contained in this output group. More...
bool	m_from_me {true}
	Whether the UTXOs were sent by the wallet to itself. More...
CAmount	m_value {0}
	The total value of the UTXOs in sum. More...
int	m_depth {999}
	The minimum number of confirmations the UTXOs in the group have. More...
size_t	m_ancestors {0}
	The aggregated count of unconfirmed ancestors of all UTXOs in this group. More...
size_t	m_descendants {0}
	The maximum count of descendants of a single UTXO in this output group. More...
CAmount	effective_value {0}
	The value of the UTXOs after deducting the cost of spending them at the effective feerate. More...
CAmount	fee {0}
	The fee to spend these UTXOs at the effective feerate. More...
CFeeRate	m_effective_feerate {0}
	The target feerate of the transaction we're trying to build. More...
CAmount	long_term_fee {0}
	The fee to spend these UTXOs at the long term feerate. More...
CFeeRate	m_long_term_feerate {0}
	The feerate for spending a created change output eventually (i.e. More...
bool	m_subtract_fee_outputs {false}
	Indicate that we are subtracting the fee from outputs. More...

Detailed Description

A group of UTXOs paid to the same output script.

Definition at line 192 of file coinselection.h.

Constructor & Destructor Documentation

OutputGroup() [1/2]

wallet::OutputGroup::OutputGroup ( )

inline

Definition at line 225 of file coinselection.h.

OutputGroup() [2/2]

wallet::OutputGroup::OutputGroup ( const CoinSelectionParams &  params )

inline

Definition at line 226 of file coinselection.h.

Member Function Documentation

EligibleForSpending()

bool wallet::OutputGroup::EligibleForSpending

(

const CoinEligibilityFilter &

eligibility_filter

)

const

Definition at line 359 of file coinselection.cpp.

Here is the caller graph for this function:

GetSelectionAmount()

CAmount wallet::OutputGroup::GetSelectionAmount

(

)

const

Definition at line 366 of file coinselection.cpp.

Here is the caller graph for this function:

Insert()

void wallet::OutputGroup::Insert	(	const COutput &	output,
		size_t	ancestors,
		size_t	descendants,
		bool	positive_only
	)

Definition at line 333 of file coinselection.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

Member Data Documentation

effective_value

CAmount wallet::OutputGroup::effective_value {0}

The value of the UTXOs after deducting the cost of spending them at the effective feerate.

Definition at line 210 of file coinselection.h.

fee

CAmount wallet::OutputGroup::fee {0}

The fee to spend these UTXOs at the effective feerate.

Definition at line 212 of file coinselection.h.

long_term_fee

CAmount wallet::OutputGroup::long_term_fee {0}

The fee to spend these UTXOs at the long term feerate.

Definition at line 216 of file coinselection.h.

m_ancestors

size_t wallet::OutputGroup::m_ancestors {0}

The aggregated count of unconfirmed ancestors of all UTXOs in this group.

Not deduplicated and may overestimate when ancestors are shared.

Definition at line 206 of file coinselection.h.

m_depth

int wallet::OutputGroup::m_depth {999}

The minimum number of confirmations the UTXOs in the group have.

Unconfirmed is 0.

Definition at line 203 of file coinselection.h.

m_descendants

size_t wallet::OutputGroup::m_descendants {0}

The maximum count of descendants of a single UTXO in this output group.

Definition at line 208 of file coinselection.h.

m_effective_feerate

CFeeRate wallet::OutputGroup::m_effective_feerate {0}

The target feerate of the transaction we're trying to build.

Definition at line 214 of file coinselection.h.

m_from_me

bool wallet::OutputGroup::m_from_me {true}

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.

Definition at line 199 of file coinselection.h.

m_long_term_feerate

CFeeRate wallet::OutputGroup::m_long_term_feerate {0}

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.

Definition at line 220 of file coinselection.h.

m_outputs

std::vector<COutput> wallet::OutputGroup::m_outputs

The list of UTXOs contained in this output group.

Definition at line 195 of file coinselection.h.

m_subtract_fee_outputs

bool wallet::OutputGroup::m_subtract_fee_outputs {false}

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

Definition at line 223 of file coinselection.h.

m_value

CAmount wallet::OutputGroup::m_value {0}

The total value of the UTXOs in sum.

Definition at line 201 of file coinselection.h.

---

The documentation for this struct was generated from the following files:

• src/wallet/coinselection.h
• src/wallet/coinselection.cpp