CCoins Class Reference

pruned version of CTransaction: only retains metadata and unspent transaction outputs More...

#include <main.h>

Public Member Functions
	CCoins (const CTransaction &tx, int nHeightIn)
	CCoins ()
void	Cleanup ()
void	swap (CCoins &to)
void	CalcMaskSize (unsigned int &nBytes, unsigned int &nNonzeroBytes) const
bool	IsCoinBase () const
unsigned int	GetSerializeSize (int nType, int nVersion) const
template<typename Stream >
void	Serialize (Stream &s, int nType, int nVersion) const
template<typename Stream >
void	Unserialize (Stream &s, int nType, int nVersion)
bool	Spend (const COutPoint &out, CTxInUndo &undo)
bool	Spend (int nPos)
bool	IsAvailable (unsigned int nPos) const
bool	IsPruned () const

Public Attributes
bool	fCoinBase
std::vector< CTxOut >	vout
int	nHeight
int	nVersion

Friends
bool	operator== (const CCoins &a, const CCoins &b)
bool	operator!= (const CCoins &a, const CCoins &b)

Detailed Description

pruned version of CTransaction: only retains metadata and unspent transaction outputs

Serialized format:

• VARINT(nVersion)
• VARINT(nCode)
• unspentness bitvector, for vout[2] and further; least significant byte first
• the non-spent CTxOuts (via CTxOutCompressor)
• VARINT(nHeight)

The nCode value consists of:

• bit 1: IsCoinBase()
• bit 2: vout[0] is not spent
• bit 4: vout[1] is not spent
• The higher bits encode N, the number of non-zero bytes in the following bitvector.
  • In case both bit 2 and bit 4 are unset, they encode N-1, as there must be at least one non-spent output).

Example: 0104835800816115944e077fe7c803cfa57f29b36bf87c1d358bb85e <><><-----------------------------------------—><-—> | \ | / version code vout[1] height

• version = 1
• code = 4 (vout[1] is not spent, and 0 non-zero bytes of bitvector follow)
• unspentness bitvector: as 0 non-zero bytes follow, it has length 0
• vout[1]: 835800816115944e077fe7c803cfa57f29b36bf87c1d35
  • 8358: compact amount representation for 60000000000 (600 BTC)
  • 00: special txout type pay-to-pubkey-hash
  • 816115944e077fe7c803cfa57f29b36bf87c1d35: address uint160
• height = 203998

Example: 0109044086ef97d5790061b01caab50f1b8e9c50a5057eb43c2d9563a4eebbd123008c988f1a4a4de2161e0f50aac7f17e7f9555caa486af3b <><><–><-----------------------------------------------—><-------------------------------------------—><-—> / \ \ | | / version code unspentness vout[4] vout[16] height

• version = 1
• code = 9 (coinbase, neither vout[0] or vout[1] are unspent, 2 (1, +1 because both bit 2 and bit 4 are unset) non-zero bitvector bytes follow)
• unspentness bitvector: bits 2 (0x04) and 14 (0x4000) are set, so vout[2+2] and vout[14+2] are unspent
• vout[4]: 86ef97d5790061b01caab50f1b8e9c50a5057eb43c2d9563a4ee
  • 86ef97d579: compact amount representation for 234925952 (2.35 BTC)
  • 00: special txout type pay-to-pubkey-hash
  • 61b01caab50f1b8e9c50a5057eb43c2d9563a4ee: address uint160
• vout[16]: bbd123008c988f1a4a4de2161e0f50aac7f17e7f9555caa4
  • bbd123: compact amount representation for 110397 (0.001 BTC)
  • 00: special txout type pay-to-pubkey-hash
  • 8c988f1a4a4de2161e0f50aac7f17e7f9555caa4: address uint160
• height = 120891

Definition at line 896 of file main.h.

Constructor & Destructor Documentation

CCoins::CCoins ( const CTransaction &  tx, int  nHeightIn  )

inline

Definition at line 913 of file main.h.

CCoins::CCoins ( )

inline

Definition at line 916 of file main.h.

Member Function Documentation

void CCoins::CalcMaskSize ( unsigned int &  nBytes, unsigned int &  nNonzeroBytes  ) const

inline

Definition at line 947 of file main.h.

void CCoins::Cleanup ( )

inline

Definition at line 919 of file main.h.

unsigned int CCoins::GetSerializeSize ( int  nType, int  nVersion  ) const

inline

Definition at line 969 of file main.h.

bool CCoins::IsAvailable ( unsigned int  nPos ) const

inline

Definition at line 1080 of file main.h.

bool CCoins::IsCoinBase ( ) const

inline

Definition at line 965 of file main.h.

bool CCoins::IsPruned ( ) const

inline

Definition at line 1086 of file main.h.

template<typename Stream >

void CCoins::Serialize ( Stream &  s, int  nType, int  nVersion  ) const

inline

Definition at line 993 of file main.h.

bool CCoins::Spend ( const COutPoint &  out, CTxInUndo &  undo  )

inline

Definition at line 1056 of file main.h.

bool CCoins::Spend ( int  nPos )

inline

Definition at line 1073 of file main.h.

void CCoins::swap ( CCoins &  to )

inline

Definition at line 926 of file main.h.

template<typename Stream >

void CCoins::Unserialize ( Stream &  s, int  nType, int  nVersion  )

inline

Definition at line 1022 of file main.h.

Friends And Related Function Documentation

bool operator!= ( const CCoins &  a, const CCoins &  b  )

friend

Definition at line 940 of file main.h.

bool operator== ( const CCoins &  a, const CCoins &  b  )

friend

Definition at line 934 of file main.h.

Member Data Documentation

bool CCoins::fCoinBase

Definition at line 900 of file main.h.

int CCoins::nHeight

Definition at line 906 of file main.h.

int CCoins::nVersion

Definition at line 910 of file main.h.

std::vector<CTxOut> CCoins::vout

Definition at line 903 of file main.h.

---

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

• src/main.h