Enum ConfirmedTransaction

pub enum ConfirmedTransaction<N>
where
    N: Network,
{
    AcceptedDeploy(u32, Transaction<N>, Vec<FinalizeOperation<N>>),
    AcceptedExecute(u32, Transaction<N>, Vec<FinalizeOperation<N>>),
    RejectedDeploy(u32, Transaction<N>, Rejected<N>, Vec<FinalizeOperation<N>>),
    RejectedExecute(u32, Transaction<N>, Rejected<N>, Vec<FinalizeOperation<N>>),
}

The confirmed transaction.

Variants

AcceptedDeploy(u32, Transaction<N>, Vec<FinalizeOperation<N>>)

The accepted deploy transaction is composed of (index, deploy_transaction, finalize_operations).

AcceptedExecute(u32, Transaction<N>, Vec<FinalizeOperation<N>>)

The accepted execute transaction is composed of (index, execute_transaction, finalize_operations).

RejectedDeploy(u32, Transaction<N>, Rejected<N>, Vec<FinalizeOperation<N>>)

The rejected deploy transaction is composed of (index, fee_transaction, rejected_deployment, finalize_operations).

RejectedExecute(u32, Transaction<N>, Rejected<N>, Vec<FinalizeOperation<N>>)

The rejected execute transaction is composed of (index, fee_transaction, rejected_execution, finalize_operations).

Implementations

impl<N> ConfirmedTransaction<N>

where N: Network,

pub fn accepted_deploy( index: u32, transaction: Transaction<N>, finalize_operations: Vec<FinalizeOperation<N>>, ) -> Result<ConfirmedTransaction<N>, Error>

Returns a new instance of an accepted deploy transaction.

pub fn accepted_execute( index: u32, transaction: Transaction<N>, finalize_operations: Vec<FinalizeOperation<N>>, ) -> Result<ConfirmedTransaction<N>, Error>

Returns a new instance of an accepted execute transaction.

pub fn rejected_deploy( index: u32, transaction: Transaction<N>, rejected: Rejected<N>, finalize_operations: Vec<FinalizeOperation<N>>, ) -> Result<ConfirmedTransaction<N>, Error>

Returns a new instance of a rejected deploy transaction.

pub fn rejected_execute( index: u32, transaction: Transaction<N>, rejected: Rejected<N>, finalize_operations: Vec<FinalizeOperation<N>>, ) -> Result<ConfirmedTransaction<N>, Error>

Returns a new instance of a rejected execute transaction.

impl<N> ConfirmedTransaction<N>

where N: Network,

pub const fn is_accepted(&self) -> bool

Returns ‘true’ if the confirmed transaction is accepted.

pub const fn is_rejected(&self) -> bool

Returns ‘true’ if the confirmed transaction is rejected.

pub fn contains_unconfirmed_transaction_id( &self, unconfirmed_transaction_id: &<N as Network>::TransactionID, ) -> bool

Returns true if the confirmed transaction represents the given unconfirmed transaction ID.

impl<N> ConfirmedTransaction<N>

where N: Network,

pub const fn index(&self) -> u32

Returns the confirmed transaction index.

pub const fn variant(&self) -> &str

Returns the human-readable variant of the confirmed transaction.

pub const fn transaction(&self) -> &Transaction<N>

Returns the transaction.

pub fn into_transaction(self) -> Transaction<N>

Returns the transaction.

pub fn num_finalize(&self) -> usize

Returns the number of finalize operations.

pub const fn finalize_operations(&self) -> &Vec<FinalizeOperation<N>>

Returns the finalize operations for the confirmed transaction.

pub fn to_finalize_id(&self) -> Result<Field<N>, Error>

Returns the finalize ID, by computing the root of a (small) Merkle tree comprised of the ordered finalize operations for the transaction.

pub fn to_rejected_id(&self) -> Result<Option<Field<N>>, Error>

Returns the rejected ID, if the confirmed transaction is rejected.

pub fn to_rejected(&self) -> Option<&Rejected<N>>

Returns the rejected object, if the confirmed transaction is rejected.

pub fn to_unconfirmed_transaction_id( &self, ) -> Result<<N as Network>::TransactionID, Error>

Returns the unconfirmed transaction ID, which is defined as the transaction ID prior to confirmation. When a transaction is rejected, its fee transition is used to construct the confirmed transaction ID, changing the original transaction ID.

pub fn to_unconfirmed_transaction(&self) -> Result<Transaction<N>, Error>

Returns the unconfirmed transaction, which is defined as the transaction prior to confirmation. When a transaction is rejected, its fee transition is used to construct the confirmed transaction, changing the original transaction.

Methods from Deref<Target = Transaction<N>>

pub const MAX_TRANSITIONS: usize = 32usize

pub fn to_root(&self) -> Result<Field<N>, Error>

Returns the transaction root, by computing the root for a Merkle tree of the transition IDs.

pub fn to_leaf(&self, id: &Field<N>) -> Result<TransactionLeaf<N>, Error>

Returns the Merkle leaf for the given ID of a function or transition in the transaction.

pub fn to_path( &self, leaf: &TransactionLeaf<N>, ) -> Result<MerklePath<N, snarkvm_console_program::::state_path::configuration::TransactionPath::{constant#0}>, Error>

Returns the Merkle path for the transaction leaf.

pub fn to_tree( &self, ) -> Result<MerkleTree<N, BHP<N, 8, 54>, BHP<N, 6, 43>, snarkvm_console_program::::state_path::configuration::TransactionTree::{constant#0}>, Error>

The Merkle tree of transition IDs for the transaction.

pub fn is_deploy(&self) -> bool

Returns true if the transaction is a deploy transaction.

pub fn is_execute(&self) -> bool

Returns true if the transaction is an execute transaction.

pub fn is_fee(&self) -> bool

Returns true if the transaction is a fee transaction.

pub fn contains_split(&self) -> bool

Returns true if this transaction contains a call to credits.aleo/split.

pub fn owner(&self) -> Option<&ProgramOwner<N>>

Returns Some(owner) if the transaction is a deployment. Otherwise, returns None.

pub fn deployment(&self) -> Option<&Deployment<N>>

Returns Some(deployment) if the transaction is a deployment. Otherwise, returns None.

pub fn execution(&self) -> Option<&Execution<N>>

Returns Some(execution) if the transaction is an execution. Otherwise, returns None.

pub fn id(&self) -> <N as Network>::TransactionID

Returns the transaction ID.

pub fn fee_amount(&self) -> Result<Integer<N, u64>, Error>

Returns the transaction total fee.

pub fn base_fee_amount(&self) -> Result<Integer<N, u64>, Error>

Returns the transaction base fee.

pub fn priority_fee_amount(&self) -> Result<Integer<N, u64>, Error>

Returns the transaction priority fee.

pub fn fee_transition(&self) -> Option<Fee<N>>

Returns the fee transition.

pub fn contains_transition( &self, transition_id: &<N as Network>::TransitionID, ) -> bool

Returns true if the transaction contains the given transition ID.

pub fn contains_serial_number(&self, serial_number: &Field<N>) -> bool

Returns true if the transaction contains the given serial number.

pub fn contains_commitment(&self, commitment: &Field<N>) -> bool

Returns true if the transaction contains the given commitment.

pub fn find_transition( &self, transition_id: &<N as Network>::TransitionID, ) -> Option<&Transition<N>>

Returns the transition with the corresponding transition ID, if it exists.

pub fn find_transition_for_serial_number( &self, serial_number: &Field<N>, ) -> Option<&Transition<N>>

Returns the transition for the given serial number, if it exists.

pub fn find_transition_for_commitment( &self, commitment: &Field<N>, ) -> Option<&Transition<N>>

Returns the transition for the given commitment, if it exists.

pub fn find_record( &self, commitment: &Field<N>, ) -> Option<&Record<N, Ciphertext<N>>>

Returns the record with the corresponding commitment, if it exists.

pub fn transition_ids(&self) -> impl DoubleEndedIterator

Returns an iterator over the transition IDs, for all transitions.

pub fn transitions(&self) -> impl DoubleEndedIterator

Returns an iterator over all transitions.

pub fn input_ids(&self) -> impl Iterator<Item = &Field<N>>

Returns an iterator over the input IDs, for all transition inputs that are records.

pub fn serial_numbers(&self) -> impl Iterator<Item = &Field<N>>

Returns an iterator over the serial numbers, for all transition inputs that are records.

pub fn tags(&self) -> impl Iterator<Item = &Field<N>>

Returns an iterator over the tags, for all transition inputs that are records.

pub fn output_ids(&self) -> impl Iterator<Item = &Field<N>>

Returns an iterator over the output IDs, for all transition inputs that are records.

pub fn commitments(&self) -> impl Iterator<Item = &Field<N>>

Returns an iterator over the commitments, for all transition outputs that are records.

pub fn records( &self, ) -> impl Iterator<Item = (&Field<N>, &Record<N, Ciphertext<N>>)>

Returns an iterator over the records, for all transition outputs that are records.

pub fn nonces(&self) -> impl Iterator<Item = &Group<N>>

Returns an iterator over the nonces, for all transition outputs that are records.

pub fn transition_public_keys(&self) -> impl DoubleEndedIterator

Returns an iterator over the transition public keys, for all transitions.

pub fn transition_commitments(&self) -> impl DoubleEndedIterator

Returns an iterator over the transition commitments, for all transitions.

Trait Implementations

impl<N> Clone for ConfirmedTransaction<N>

where N: Clone + Network,

fn clone(&self) -> ConfirmedTransaction<N>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<N> Debug for ConfirmedTransaction<N>

where N: Network,

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

Prints the confirmed transaction as a JSON-string.

impl<N> Deref for ConfirmedTransaction<N>

where N: Network,

fn deref(&self) -> &<ConfirmedTransaction<N> as Deref>::Target

Returns a reference to the valid transaction.

type Target = Transaction<N>

The resulting type after dereferencing.

impl<'de, N> Deserialize<'de> for ConfirmedTransaction<N>

where N: Network,

fn deserialize<D>( deserializer: D, ) -> Result<ConfirmedTransaction<N>, <D as Deserializer<'de>>::Error>

where D: Deserializer<'de>,

Deserializes the confirmed transaction from a string or bytes.

impl<N> Display for ConfirmedTransaction<N>

where N: Network,

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

Displays the confirmed transaction as a JSON-string.

impl<N> FromBytes for ConfirmedTransaction<N>

where N: Network,

fn read_le<R>(reader: R) -> Result<ConfirmedTransaction<N>, Error>

where R: Read,

Reads the confirmed transaction from a buffer.

fn from_bytes_le(bytes: &[u8]) -> Result<Self, Error>

where Self: Sized,

Returns Self from a byte array in little-endian order.

impl<'a, N> FromIterator<&'a ConfirmedTransaction<N>> for Transactions<N>

where N: Network,

fn from_iter<T>(iter: T) -> Transactions<N>

where T: IntoIterator<Item = &'a ConfirmedTransaction<N>>,

Initializes from an iterator of transactions.

impl<N> FromIterator<ConfirmedTransaction<N>> for Transactions<N>

where N: Network,

fn from_iter<T>(iter: T) -> Transactions<N>

where T: IntoIterator<Item = ConfirmedTransaction<N>>,

Initializes from an iterator of transactions.

impl<N> FromStr for ConfirmedTransaction<N>

where N: Network,

fn from_str( status: &str, ) -> Result<ConfirmedTransaction<N>, <ConfirmedTransaction<N> as FromStr>::Err>

Initializes the confirmed transaction from a JSON-string.

type Err = Error

The associated error which can be returned from parsing.

impl<N> PartialEq for ConfirmedTransaction<N>

where N: PartialEq + Network,

fn eq(&self, other: &ConfirmedTransaction<N>) -> bool

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<N> Serialize for ConfirmedTransaction<N>

where N: Network,

fn serialize<S>( &self, serializer: S, ) -> Result<<S as Serializer>::Ok, <S as Serializer>::Error>

where S: Serializer,

Serializes the confirmed transaction into string or bytes.

impl<N> ToBytes for ConfirmedTransaction<N>

where N: Network,

fn write_le<W>(&self, writer: W) -> Result<(), Error>

where W: Write,

Writes the confirmed transaction to a buffer.

fn to_bytes_le(&self) -> Result<Vec<u8>, Error>

where Self: Sized,

Returns self as a byte array in little-endian order.

impl<N> Eq for ConfirmedTransaction<N>

where N: Eq + Network,

impl<N> StructuralPartialEq for ConfirmedTransaction<N>

where N: Network,