Struct TransactionTemplate 

pub struct TransactionTemplate<FeeConstraint>
where
    FeeConstraint: Constraint + Clone + Copy,
{
    pub(crate) data: SerializedTransaction,
    pub(crate) hash: Hash,
    pub(crate) auth_digest: AuthDigest,
    pub(crate) depends: Vec<u16>,
    pub(crate) fee: Amount<FeeConstraint>,
    pub(crate) sigops: u32,
    pub(crate) required: bool,
}

Transaction data and fields needed to generate blocks using the getblocktemplate RPC.

Fields

data: SerializedTransaction

The hex-encoded serialized data for this transaction.

hash: Hash

The transaction ID of this transaction.

auth_digest: AuthDigest

The authorizing data digest of a v5 transaction, or a placeholder for older versions.

depends: Vec<u16>

The transactions in this block template that this transaction depends upon. These are 1-based indexes in the transactions list.

Populated when the selected transactions are assembled into a block template.

We use u16 because 2 MB blocks are limited to around 39,000 transactions.

fee: Amount<FeeConstraint>

The fee for this transaction.

Non-coinbase transactions must be NonNegative. The coinbase transaction fee is the negative total collected miner fees, excluding the NSM contribution, so its fee must be NegativeOrZero.

sigops: u32

The number of transparent signature operations in this transaction.

required: bool

Is this transaction required in the block?

Coinbase transactions are required, all other transactions are not.

Implementations

impl<FeeConstraint> TransactionTemplate<FeeConstraint>

where FeeConstraint: Constraint + Clone + Copy,

Auto-generated by derive_getters::Getters.

pub fn data(&self) -> &SerializedTransaction

The hex-encoded serialized data for this transaction.

pub fn hash(&self) -> Hash

The transaction ID of this transaction.

pub fn auth_digest(&self) -> AuthDigest

The authorizing data digest of a v5 transaction, or a placeholder for older versions.

pub fn depends(&self) -> &Vec<u16>

The transactions in this block template that this transaction depends upon. These are 1-based indexes in the transactions list.

Populated when the selected transactions are assembled into a block template.

We use u16 because 2 MB blocks are limited to around 39,000 transactions.

pub fn fee(&self) -> Amount<FeeConstraint>

The fee for this transaction.

Non-coinbase transactions must be NonNegative. The coinbase transaction fee is the negative total collected miner fees, excluding the NSM contribution, so its fee must be NegativeOrZero.

pub fn sigops(&self) -> u32

The number of transparent signature operations in this transaction.

pub fn required(&self) -> bool

Is this transaction required in the block?

Coinbase transactions are required, all other transactions are not.

impl<FeeConstraint> TransactionTemplate<FeeConstraint>

where FeeConstraint: Constraint + Clone + Copy,

pub fn new( data: SerializedTransaction, hash: Hash, auth_digest: AuthDigest, depends: Vec<u16>, fee: Amount<FeeConstraint>, sigops: u32, required: bool, ) -> Self

Constructs a new TransactionTemplate.

impl TransactionTemplate<NegativeOrZero>

pub fn new_coinbase( net: &Network, height: Height, miner_params: &MinerParams, txs_fee: Amount<NonNegative>, ) -> Result<Self, TransactionError>

Constructs a transaction template for a coinbase without parent-dependent reissuance.

txs_fee is the gross transaction fee total. The payout and the template’s negative fee include only the miner’s share after the NSM contribution.

pub fn new_coinbase_with_parent_pools( net: &Network, height: Height, miner_params: &MinerParams, txs_fee: Amount<NonNegative>, parent_nsm_value_balance: Option<Amount<NonNegative>>, ) -> Result<Self, TransactionError>

Constructs a transaction template for a coinbase transaction in a block whose parent leaves parent_nsm_value_balance in the NSM value balance.

The parent’s NSM value balance is required from the NSM reissuance height, because it determines the block subsidy. The payout and negative fee include only net miner fees after the NSM contribution.

Trait Implementations

impl<FeeConstraint> Clone for TransactionTemplate<FeeConstraint>

where FeeConstraint: Constraint + Clone + Copy + Clone,

fn clone(&self) -> TransactionTemplate<FeeConstraint>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<FeeConstraint> Debug for TransactionTemplate<FeeConstraint>

where FeeConstraint: Constraint + Clone + Copy + Debug,

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de, FeeConstraint> Deserialize<'de> for TransactionTemplate<FeeConstraint>

where FeeConstraint: Constraint + Clone + Copy,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<FeeConstraint> Eq for TransactionTemplate<FeeConstraint>

where FeeConstraint: Constraint + Clone + Copy + Eq,

impl From<&VerifiedUnminedTx> for TransactionTemplate<NonNegative>

fn from(tx: &VerifiedUnminedTx) -> Self

Converts to this type from the input type.

impl From<VerifiedUnminedTx> for TransactionTemplate<NonNegative>

fn from(tx: VerifiedUnminedTx) -> Self

Converts to this type from the input type.

impl<FeeConstraint> PartialEq for TransactionTemplate<FeeConstraint>

where FeeConstraint: Constraint + Clone + Copy + PartialEq,

fn eq(&self, other: &TransactionTemplate<FeeConstraint>) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl<FeeConstraint> Serialize for TransactionTemplate<FeeConstraint>

where FeeConstraint: Constraint + Clone + Copy,

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl<FeeConstraint> StructuralPartialEq for TransactionTemplate<FeeConstraint>

where FeeConstraint: Constraint + Clone + Copy + PartialEq,

Layout

Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...) attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.

Size: 128 bytes