CTxIn Class Reference

An input of a transaction. More...

#include <transaction.h>

Collaboration diagram for CTxIn:

Public Member Functions
	CTxIn ()
	CTxIn (COutPoint prevoutIn, CScript scriptSigIn=CScript(), uint32_t nSequenceIn=SEQUENCE_FINAL)
	CTxIn (Txid hashPrevTx, uint32_t nOut, CScript scriptSigIn=CScript(), uint32_t nSequenceIn=SEQUENCE_FINAL)
	SERIALIZE_METHODS (CTxIn, obj)
std::string	ToString () const

Public Attributes
COutPoint	prevout
CScript	scriptSig
uint32_t	nSequence
CScriptWitness	scriptWitness
	Only serialized through CTransaction.

Static Public Attributes
static constexpr uint32_t	SEQUENCE_FINAL {0xffffffff}
	Setting nSequence to this value for every input in a transaction disables nLockTime/IsFinalTx().
static constexpr uint32_t	MAX_SEQUENCE_NONFINAL {SEQUENCE_FINAL - 1}
	This is the maximum sequence number that enables both nLockTime and OP_CHECKLOCKTIMEVERIFY (BIP 65).
static constexpr uint32_t	SEQUENCE_LOCKTIME_DISABLE_FLAG {1U << 31}
	If this flag is set, CTxIn::nSequence is NOT interpreted as a relative lock-time.
static constexpr uint32_t	SEQUENCE_LOCKTIME_TYPE_FLAG {1 << 22}
	If CTxIn::nSequence encodes a relative lock-time and this flag is set, the relative lock-time has units of 512 seconds, otherwise it specifies blocks with a granularity of 1.
static constexpr uint32_t	SEQUENCE_LOCKTIME_MASK {0x0000ffff}
	If CTxIn::nSequence encodes a relative lock-time, this mask is applied to extract that lock-time from the sequence field.
static constexpr int	SEQUENCE_LOCKTIME_GRANULARITY {9}
	In order to use the same number of bits to encode roughly the same wall-clock duration, and because blocks are naturally limited to occur every 600s on average, the minimum granularity for time-based relative lock-time is fixed at 512 seconds.

Friends
bool	operator== (const CTxIn &a, const CTxIn &b)

Detailed Description

An input of a transaction.

It contains the location of the previous transaction's output that it claims and a signature that matches the output's public key.

Definition at line 62 of file transaction.h.

Constructor & Destructor Documentation

CTxIn() [1/3]

CTxIn::CTxIn ( )

inline

Definition at line 117 of file transaction.h.

CTxIn() [2/3]

CTxIn::CTxIn ( COutPoint  prevoutIn, CScript  scriptSigIn = CScript(), uint32_t  nSequenceIn = SEQUENCE_FINAL  )

explicit

Definition at line 26 of file transaction.cpp.

Here is the call graph for this function:

CTxIn() [3/3]

CTxIn::CTxIn	(	Txid	hashPrevTx,
		uint32_t	nOut,
		CScript	scriptSigIn = CScript(),
		uint32_t	nSequenceIn = SEQUENCE_FINAL
	)

Definition at line 33 of file transaction.cpp.

Here is the call graph for this function:

Member Function Documentation

SERIALIZE_METHODS()

CTxIn::SERIALIZE_METHODS ( CTxIn  , obj    )

inline

Definition at line 125 of file transaction.h.

Here is the call graph for this function:

ToString()

std::string CTxIn::ToString

(

)

const

Definition at line 40 of file transaction.cpp.

Here is the call graph for this function:

Friends And Related Symbol Documentation

operator==

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

friend

Definition at line 127 of file transaction.h.

Member Data Documentation

MAX_SEQUENCE_NONFINAL

constexpr uint32_t CTxIn::MAX_SEQUENCE_NONFINAL {SEQUENCE_FINAL - 1}

staticconstexpr

This is the maximum sequence number that enables both nLockTime and OP_CHECKLOCKTIMEVERIFY (BIP 65).

It has SEQUENCE_LOCKTIME_DISABLE_FLAG set (BIP 68/112).

Definition at line 83 of file transaction.h.

nSequence

uint32_t CTxIn::nSequence

Definition at line 67 of file transaction.h.

prevout

COutPoint CTxIn::prevout

Definition at line 65 of file transaction.h.

scriptSig

CScript CTxIn::scriptSig

Definition at line 66 of file transaction.h.

scriptWitness

CScriptWitness CTxIn::scriptWitness

Only serialized through CTransaction.

Definition at line 68 of file transaction.h.

SEQUENCE_FINAL

constexpr uint32_t CTxIn::SEQUENCE_FINAL {0xffffffff}

staticconstexpr

Setting nSequence to this value for every input in a transaction disables nLockTime/IsFinalTx().

It fails OP_CHECKLOCKTIMEVERIFY/CheckLockTime() for any input that has it set (BIP 65). It has SEQUENCE_LOCKTIME_DISABLE_FLAG set (BIP 68/112).

Definition at line 77 of file transaction.h.

SEQUENCE_LOCKTIME_DISABLE_FLAG

constexpr uint32_t CTxIn::SEQUENCE_LOCKTIME_DISABLE_FLAG {1U << 31}

staticconstexpr

If this flag is set, CTxIn::nSequence is NOT interpreted as a relative lock-time.

It skips SequenceLocks() for any input that has it set (BIP 68). It fails OP_CHECKSEQUENCEVERIFY/CheckSequence() for any input that has it set (BIP 112).

Definition at line 94 of file transaction.h.

SEQUENCE_LOCKTIME_GRANULARITY

constexpr int CTxIn::SEQUENCE_LOCKTIME_GRANULARITY {9}

staticconstexpr

In order to use the same number of bits to encode roughly the same wall-clock duration, and because blocks are naturally limited to occur every 600s on average, the minimum granularity for time-based relative lock-time is fixed at 512 seconds.

Converting from CTxIn::nSequence to seconds is performed by multiplying by 512 = 2^9, or equivalently shifting up by 9 bits.

Definition at line 115 of file transaction.h.

SEQUENCE_LOCKTIME_MASK

constexpr uint32_t CTxIn::SEQUENCE_LOCKTIME_MASK {0x0000ffff}

staticconstexpr

If CTxIn::nSequence encodes a relative lock-time, this mask is applied to extract that lock-time from the sequence field.

Definition at line 105 of file transaction.h.

SEQUENCE_LOCKTIME_TYPE_FLAG

constexpr uint32_t CTxIn::SEQUENCE_LOCKTIME_TYPE_FLAG {1 << 22}

staticconstexpr

If CTxIn::nSequence encodes a relative lock-time and this flag is set, the relative lock-time has units of 512 seconds, otherwise it specifies blocks with a granularity of 1.

Definition at line 100 of file transaction.h.

---

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

• src/primitives/transaction.h
• src/primitives/transaction.cpp