A transaction with a bunch of additional info that only the owner cares about. More...

#include <transaction.h>

Collaboration diagram for wallet::CWalletTx:

Public Types
enum	AmountType { DEBIT , CREDIT , AMOUNTTYPE_ENUM_ELEMENTS }

Public Member Functions
	CWalletTx (CTransactionRef tx, const TxState &state)

void	Init ()

template<typename Stream >
void	Serialize (Stream &s) const

template<typename Stream >
void	Unserialize (Stream &s)

void	SetTx (CTransactionRef arg)

void	MarkDirty ()
	make sure balances are recalculated More...

bool	IsEquivalentTo (const CWalletTx &tx) const
	True if only scriptSigs are different. More...

bool	InMempool () const

int64_t	GetTxTime () const

template<typename T >
const T *	state () const

template<typename T >
T *	state ()

void	updateState (interfaces::Chain &chain)
	Update transaction state when attaching to a chain, filling in heights of conflicted and confirmed blocks. More...

bool	isAbandoned () const

bool	isMempoolConflicted () const

bool	isBlockConflicted () const

bool	isInactive () const

bool	isUnconfirmed () const

bool	isConfirmed () const

const Txid &	GetHash () const LIFETIMEBOUND

const Wtxid &	GetWitnessHash () const LIFETIMEBOUND

bool	IsCoinBase () const

void	CopyFrom (const CWalletTx &)

Public Attributes
std::optional< std::string >	m_from

std::optional< std::string >	m_message

std::optional< std::string >	m_comment

std::optional< std::string >	m_comment_to

std::optional< Txid >	m_replaces_txid

std::optional< Txid >	m_replaced_by_txid

std::vector< std::string >	m_messages

std::vector< std::string >	m_payment_requests

unsigned int	nTimeReceived
	time received by this node More...

unsigned int	nTimeSmart
	Stable timestamp that never changes, and reflects the order a transaction was added to the wallet. More...

std::optional< bool >	m_cached_from_me {std::nullopt}

int64_t	nOrderPos
	position in ordered transaction list More...

std::multimap< int64_t, CWalletTx * >::const_iterator	m_it_wtxOrdered

CachableAmount	m_amounts [AMOUNTTYPE_ENUM_ELEMENTS]

bool	m_is_cache_empty {true}
	This flag is true if all m_amounts caches are empty. More...

bool	fChangeCached

CAmount	nChangeCached

CTransactionRef	tx

TxState	m_state

std::set< Txid >	mempool_conflicts

std::optional< Txid >	truc_child_in_mempool

Private Member Functions
	CWalletTx (const CWalletTx &)=default

CWalletTx &	operator= (const CWalletTx &)=default

Detailed Description

A transaction with a bunch of additional info that only the owner cares about.

It includes any unrecorded transactions needed to link it back to the block chain.

Definition at line 191 of file transaction.h.

Member Enumeration Documentation

◆ AmountType

enum wallet::CWalletTx::AmountType

Enumerator
DEBIT
CREDIT
AMOUNTTYPE_ENUM_ELEMENTS

Definition at line 225 of file transaction.h.

Constructor & Destructor Documentation

◆ CWalletTx() [1/2]

wallet::CWalletTx::CWalletTx	(	CTransactionRef	tx,
		const TxState &	state
	)

inline

Definition at line 237 of file transaction.h.

Here is the call graph for this function:

◆ CWalletTx() [2/2]

wallet::CWalletTx::CWalletTx ( const CWalletTx & )

privatedefault

Member Function Documentation

◆ CopyFrom()

void wallet::CWalletTx::CopyFrom ( const CWalletTx & _tx )

Definition at line 59 of file transaction.cpp.

◆ GetHash()

const Txid & wallet::CWalletTx::GetHash ( ) const

inline

Definition at line 375 of file transaction.h.

Here is the caller graph for this function:

◆ GetTxTime()

int64_t wallet::CWalletTx::GetTxTime ( ) const

Definition at line 32 of file transaction.cpp.

Here is the caller graph for this function:

◆ GetWitnessHash()

const Wtxid & wallet::CWalletTx::GetWitnessHash ( ) const

inline

Definition at line 376 of file transaction.h.

◆ Init()

void wallet::CWalletTx::Init ( )

inline

Definition at line 242 of file transaction.h.

Here is the caller graph for this function:

◆ InMempool()

bool wallet::CWalletTx::InMempool ( ) const

Definition at line 27 of file transaction.cpp.

Here is the caller graph for this function:

◆ isAbandoned()

bool wallet::CWalletTx::isAbandoned ( ) const

inline

Definition at line 369 of file transaction.h.

Here is the caller graph for this function:

◆ isBlockConflicted()

bool wallet::CWalletTx::isBlockConflicted ( ) const

inline

Definition at line 371 of file transaction.h.

Here is the caller graph for this function:

◆ IsCoinBase()

bool wallet::CWalletTx::IsCoinBase ( ) const

inline

Definition at line 377 of file transaction.h.

Here is the caller graph for this function:

◆ isConfirmed()

bool wallet::CWalletTx::isConfirmed ( ) const

inline

Definition at line 374 of file transaction.h.

Here is the caller graph for this function:

◆ IsEquivalentTo()

bool wallet::CWalletTx::IsEquivalentTo ( const CWalletTx & tx ) const

True if only scriptSigs are different.

Definition at line 12 of file transaction.cpp.

Here is the caller graph for this function:

◆ isInactive()

bool wallet::CWalletTx::isInactive ( ) const

inline

Definition at line 372 of file transaction.h.

Here is the caller graph for this function:

◆ isMempoolConflicted()

bool wallet::CWalletTx::isMempoolConflicted ( ) const

inline

Definition at line 370 of file transaction.h.

Here is the caller graph for this function:

◆ isUnconfirmed()

bool wallet::CWalletTx::isUnconfirmed ( ) const

inline

Definition at line 373 of file transaction.h.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ MarkDirty()

void wallet::CWalletTx::MarkDirty ( )

inline

make sure balances are recalculated

Definition at line 346 of file transaction.h.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ operator=()

CWalletTx & wallet::CWalletTx::operator= ( const CWalletTx & )

privatedefault

◆ Serialize()

template<typename Stream >

void wallet::CWalletTx::Serialize ( Stream & s ) const

inline

Definition at line 267 of file transaction.h.

Here is the call graph for this function:

◆ SetTx()

void wallet::CWalletTx::SetTx ( CTransactionRef arg )

inline

Definition at line 340 of file transaction.h.

Here is the caller graph for this function:

◆ state() [1/2]

template<typename T >

T * wallet::CWalletTx::state ( )

inline

Definition at line 363 of file transaction.h.

◆ state() [2/2]

template<typename T >

const T * wallet::CWalletTx::state ( ) const

inline

Definition at line 362 of file transaction.h.

Here is the caller graph for this function:

◆ Unserialize()

template<typename Stream >

void wallet::CWalletTx::Unserialize ( Stream & s )

inline

Definition at line 299 of file transaction.h.

Here is the call graph for this function:

◆ updateState()

void wallet::CWalletTx::updateState ( interfaces::Chain & chain )

Update transaction state when attaching to a chain, filling in heights of conflicted and confirmed blocks.

Definition at line 38 of file transaction.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

Member Data Documentation

◆ fChangeCached

bool wallet::CWalletTx::fChangeCached

mutable

Definition at line 234 of file transaction.h.

◆ m_amounts

CachableAmount wallet::CWalletTx::m_amounts[AMOUNTTYPE_ENUM_ELEMENTS]

mutable

Definition at line 226 of file transaction.h.

◆ m_cached_from_me

std::optional<bool> wallet::CWalletTx::m_cached_from_me {std::nullopt}

mutable

Definition at line 220 of file transaction.h.

◆ m_comment

std::optional<std::string> wallet::CWalletTx::m_comment

Definition at line 200 of file transaction.h.

◆ m_comment_to

std::optional<std::string> wallet::CWalletTx::m_comment_to

Definition at line 201 of file transaction.h.

◆ m_from

std::optional<std::string> wallet::CWalletTx::m_from

Definition at line 197 of file transaction.h.

◆ m_is_cache_empty

bool wallet::CWalletTx::m_is_cache_empty {true}

mutable

This flag is true if all m_amounts caches are empty.

This is particularly useful in places where MarkDirty is conditionally called and the condition can be expensive and thus can be skipped if the flag is true. See MarkDestinationsDirty.

Definition at line 233 of file transaction.h.

◆ m_it_wtxOrdered

std::multimap<int64_t,CWalletTx*>::const_iterator wallet::CWalletTx::m_it_wtxOrdered

Definition at line 222 of file transaction.h.

◆ m_message

std::optional<std::string> wallet::CWalletTx::m_message

Definition at line 198 of file transaction.h.

◆ m_messages

std::vector<std::string> wallet::CWalletTx::m_messages

Definition at line 205 of file transaction.h.

◆ m_payment_requests

std::vector<std::string> wallet::CWalletTx::m_payment_requests

Definition at line 207 of file transaction.h.

◆ m_replaced_by_txid

std::optional<Txid> wallet::CWalletTx::m_replaced_by_txid

Definition at line 203 of file transaction.h.

◆ m_replaces_txid

std::optional<Txid> wallet::CWalletTx::m_replaces_txid

Definition at line 202 of file transaction.h.

◆ m_state

TxState wallet::CWalletTx::m_state

Definition at line 252 of file transaction.h.

◆ mempool_conflicts

std::set<Txid> wallet::CWalletTx::mempool_conflicts

Definition at line 260 of file transaction.h.

◆ nChangeCached

CAmount wallet::CWalletTx::nChangeCached

mutable

Definition at line 235 of file transaction.h.

◆ nOrderPos

int64_t wallet::CWalletTx::nOrderPos

position in ordered transaction list

Definition at line 221 of file transaction.h.

◆ nTimeReceived

unsigned int wallet::CWalletTx::nTimeReceived

time received by this node

Definition at line 208 of file transaction.h.

◆ nTimeSmart

unsigned int wallet::CWalletTx::nTimeSmart

Stable timestamp that never changes, and reflects the order a transaction was added to the wallet.

Timestamp is based on the block time for a transaction added as part of a block, or else the time when the transaction was received if it wasn't part of a block, with the timestamp adjusted in both cases so timestamp order matches the order transactions were added to the wallet. More details can be found in CWallet::ComputeTimeSmart().

Definition at line 218 of file transaction.h.

◆ truc_child_in_mempool

std::optional<Txid> wallet::CWalletTx::truc_child_in_mempool

Definition at line 264 of file transaction.h.

◆ tx

CTransactionRef wallet::CWalletTx::tx

Definition at line 251 of file transaction.h.

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

src/wallet/transaction.h
src/wallet/transaction.cpp

Public Types

Public Member Functions

Public Attributes

Private Member Functions

Detailed Description

Member Enumeration Documentation

◆ AmountType

Constructor & Destructor Documentation

◆ CWalletTx() [1/2]

◆ CWalletTx() [2/2]

Member Function Documentation

◆ CopyFrom()

◆ GetHash()

◆ GetTxTime()

◆ GetWitnessHash()

◆ Init()

◆ InMempool()

◆ isAbandoned()

◆ isBlockConflicted()

◆ IsCoinBase()

◆ isConfirmed()

◆ IsEquivalentTo()

◆ isInactive()

◆ isMempoolConflicted()

◆ isUnconfirmed()

◆ MarkDirty()

◆ operator=()

◆ Serialize()

◆ SetTx()

◆ state() [1/2]

◆ state() [2/2]

◆ Unserialize()

◆ updateState()

Member Data Documentation

◆ fChangeCached

◆ m_amounts

◆ m_cached_from_me

◆ m_comment

◆ m_comment_to

◆ m_from

◆ m_is_cache_empty

◆ m_it_wtxOrdered

◆ m_message

◆ m_messages

◆ m_payment_requests

◆ m_replaced_by_txid

◆ m_replaces_txid

◆ m_state

◆ mempool_conflicts

◆ nChangeCached

◆ nOrderPos

◆ nTimeReceived

◆ nTimeSmart

◆ truc_child_in_mempool

◆ tx