spend.cpp File Reference

#include <wallet/spend.h>
#include <common/args.h>
#include <common/system.h>
#include <consensus/validation.h>
#include <interfaces/chain.h>
#include <policy/policy.h>
#include <util/check.h>
#include <util/insert.h>
#include <util/moneystr.h>
#include <util/translation.h>
#include <wallet/coincontrol.h>
#include <wallet/fees.h>
#include <wallet/receive.h>
#include <wallet/transaction.h>
#include <wallet/wallet.h>

Include dependency graph for spend.cpp:

Go to the source code of this file.

Functions
int	GetTxSpendSize (const CWallet &wallet, const CWalletTx &wtx, unsigned int out, bool use_max_sig)
	Get the marginal bytes if spending the specified output from this transaction. More...
int	CalculateMaximumSignedInputSize (const CTxOut &txout, const CWallet *wallet, bool use_max_sig)
	Get the marginal bytes of spending the specified output. More...
int64_t	CalculateMaximumSignedTxSize (const CTransaction &tx, const CWallet *wallet, const std::vector< CTxOut > &txouts, bool use_max_sig)
	Calculate the size of the transaction assuming all signatures are max size Use DummySignatureCreator, which inserts 71 byte signatures everywhere. More...
int64_t	CalculateMaximumSignedTxSize (const CTransaction &tx, const CWallet *wallet, bool use_max_sig)
void	AvailableCoins (const CWallet &wallet, std::vector< COutput > &vCoins, const CCoinControl *coinControl, const Amount nMinimumAmount, const Amount nMaximumAmount, const Amount nMinimumSumAmount, const uint64_t nMaximumCount)
	populate vCoins with vector of available COutputs. More...
Amount	GetAvailableBalance (const CWallet &wallet, const CCoinControl *coinControl)
const CTxOut &	FindNonChangeParentOutput (const CWallet &wallet, const CTransaction &tx, int output)
	Find non-change parent output. More...
std::map< CTxDestination, std::vector< COutput > >	ListCoins (const CWallet &wallet)
	Return list of available coins and locked coins grouped by non-change output address. More...
std::vector< OutputGroup >	GroupOutputs (const CWallet &wallet, const std::vector< COutput > &outputs, bool separate_coins, const CFeeRate &effective_feerate, const CFeeRate &long_term_feerate, const CoinEligibilityFilter &filter, bool positive_only)
bool	SelectCoinsMinConf (const CWallet &wallet, const Amount nTargetValue, const CoinEligibilityFilter &eligibility_filter, std::vector< COutput > coins, std::set< CInputCoin > &setCoinsRet, Amount &nValueRet, const CoinSelectionParams &coin_selection_params, bool &bnb_used)
	Shuffle and select coins until nTargetValue is reached while avoiding small change; This method is stochastic for some inputs and upon completion the coin set and corresponding actual target value is assembled param@[in] groups Set of UTXOs to consider. More...
bool	SelectCoins (const CWallet &wallet, const std::vector< COutput > &vAvailableCoins, const Amount nTargetValue, std::set< CInputCoin > &setCoinsRet, Amount &nValueRet, const CCoinControl &coin_control, CoinSelectionParams &coin_selection_params, bool &bnb_used)
	Select a set of coins such that nValueRet >= nTargetValue and at least all coins from coin_control are selected; never select unconfirmed coins if they are not ours param@[out] setCoinsRet Populated with inputs including pre-selected inputs from coin_control and Coin Selection if successful. More...
static util::Result< CreatedTransactionResult >	CreateTransactionInternal (CWallet &wallet, const std::vector< CRecipient > &vecSend, int change_pos, const CCoinControl &coin_control, bool sign)
util::Result< CreatedTransactionResult >	CreateTransaction (CWallet &wallet, const std::vector< CRecipient > &vecSend, 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 create the change output, when needed. More...
bool	FundTransaction (CWallet &wallet, CMutableTransaction &tx, Amount &nFeeRet, int &nChangePosInOut, bilingual_str &error, bool lockUnspents, const std::set< int > &setSubtractFeeFromOutputs, CCoinControl coinControl)
	Insert additional inputs into the transaction by calling CreateTransaction();. More...

Variables
static const size_t	OUTPUT_GROUP_MAX_ENTRIES = 10

Function Documentation

AvailableCoins()

void AvailableCoins	(	const CWallet &	wallet,
		std::vector< COutput > &	vCoins,
		const CCoinControl *	coinControl,
		const Amount	nMinimumAmount,
		const Amount	nMaximumAmount,
		const Amount	nMinimumSumAmount,
		const uint64_t	nMaximumCount
	)

populate vCoins with vector of available COutputs.

Definition at line 71 of file spend.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

CalculateMaximumSignedInputSize()

int CalculateMaximumSignedInputSize	(	const CTxOut &	txout,
		const CWallet *	wallet,
		bool	use_max_sig
	)

Get the marginal bytes of spending the specified output.

Definition at line 34 of file spend.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

CalculateMaximumSignedTxSize() [1/2]

int64_t CalculateMaximumSignedTxSize	(	const CTransaction &	tx,
		const CWallet *	wallet,
		bool	use_max_sig
	)

Definition at line 56 of file spend.cpp.

Here is the call graph for this function:

CalculateMaximumSignedTxSize() [2/2]

int64_t CalculateMaximumSignedTxSize	(	const CTransaction &	tx,
		const CWallet *	wallet,
		const std::vector< CTxOut > &	txouts,
		bool	use_max_sig = false
	)

Calculate the size of the transaction assuming all signatures are max size Use DummySignatureCreator, which inserts 71 byte signatures everywhere.

NOTE: this requires that all inputs must be in mapWallet (eg the tx should be AllInputsMine).

Definition at line 45 of file spend.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

CreateTransaction()

util::Result< CreatedTransactionResult > CreateTransaction	(	CWallet &	wallet,
		const std::vector< CRecipient > &	vecSend,
		int	change_pos,
		const CCoinControl &	coin_control,
		bool	sign = true
	)

Create a new transaction paying the recipients with a set of coins selected by SelectCoins(); Also create the change output, when needed.

Note

passing change_pos as -1 will result in setting a random position

Definition at line 989 of file spend.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

CreateTransactionInternal()

static util::Result< CreatedTransactionResult > CreateTransactionInternal ( CWallet &  wallet, const std::vector< CRecipient > &  vecSend, int  change_pos, const CCoinControl &  coin_control, bool  sign  )

static

Definition at line 609 of file spend.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

FindNonChangeParentOutput()

const CTxOut & FindNonChangeParentOutput	(	const CWallet &	wallet,
		const CTransaction &	tx,
		int	output
	)

Find non-change parent output.

Definition at line 230 of file spend.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

FundTransaction()

bool FundTransaction	(	CWallet &	wallet,
		CMutableTransaction &	tx,
		Amount &	nFeeRet,
		int &	nChangePosInOut,
		bilingual_str &	error,
		bool	lockUnspents,
		const std::set< int > &	setSubtractFeeFromOutputs,
		CCoinControl	coinControl
	)

Insert additional inputs into the transaction by calling CreateTransaction();.

Definition at line 1025 of file spend.cpp.

Here is the call graph for this function:

GetAvailableBalance()

Amount GetAvailableBalance	(	const CWallet &	wallet,
		const CCoinControl *	coinControl
	)

Definition at line 215 of file spend.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

GetTxSpendSize()

int GetTxSpendSize	(	const CWallet &	wallet,
		const CWalletTx &	wtx,
		unsigned int	out,
		bool	use_max_sig
	)

Get the marginal bytes if spending the specified output from this transaction.

Definition at line 24 of file spend.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

GroupOutputs()

std::vector< OutputGroup > GroupOutputs	(	const CWallet &	wallet,
		const std::vector< COutput > &	outputs,
		bool	separate_coins,
		const CFeeRate &	effective_feerate,
		const CFeeRate &	long_term_feerate,
		const CoinEligibilityFilter &	filter,
		bool	positive_only
	)

Definition at line 305 of file spend.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

ListCoins()

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 at line 250 of file spend.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

SelectCoins()

bool SelectCoins	(	const CWallet &	wallet,
		const std::vector< COutput > &	vAvailableCoins,
		const Amount	nTargetValue,
		std::set< CInputCoin > &	setCoinsRet,
		Amount &	nValueRet,
		const CCoinControl &	coin_control,
		CoinSelectionParams &	coin_selection_params,
		bool &	bnb_used
	)

Select a set of coins such that nValueRet >= nTargetValue and at least all coins from coin_control are selected; never select unconfirmed coins if they are not ours param@[out] setCoinsRet Populated with inputs including pre-selected inputs from coin_control and Coin Selection if successful.

param@[out] nValueRet Total value of selected coins including pre-selected ones from coin_control and Coin Selection if successful.

Definition at line 472 of file spend.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

SelectCoinsMinConf()

bool SelectCoinsMinConf	(	const CWallet &	wallet,
		const Amount	nTargetValue,
		const CoinEligibilityFilter &	eligibility_filter,
		std::vector< COutput >	coins,
		std::set< CInputCoin > &	setCoinsRet,
		Amount &	nValueRet,
		const CoinSelectionParams &	coin_selection_params,
		bool &	bnb_used
	)

Shuffle and select coins until nTargetValue is reached while avoiding small change; This method is stochastic for some inputs and upon completion the coin set and corresponding actual target value is assembled param@[in] groups Set of UTXOs to consider.

These will be categorized into OutputGroups and filtered using eligibility_filter before selecting coins. param@[out] setCoinsRet Populated with the coins selected if successful. param@[out] nValueRet Used to return the total value of selected coins.

Definition at line 420 of file spend.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

Variable Documentation

OUTPUT_GROUP_MAX_ENTRIES

const size_t OUTPUT_GROUP_MAX_ENTRIES = 10

static

Definition at line 22 of file spend.cpp.