Struct Transactions

pub struct Transactions<N>
where
    N: Network,
{ /* private fields */ }

Implementations

impl<N> Transactions<N>

where N: Network,

pub fn to_finalize_root( &self, ratified_finalize_operations: Vec<FinalizeOperation<N>>, ) -> Result<Field<N>, Error>

Returns the finalize root of the transactions.

impl<N> Transactions<N>

where N: Network,

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

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

pub fn to_path( &self, transaction_id: <N as Network>::TransactionID, ) -> Result<MerklePath<N, snarkvm_console_program::::state_path::configuration::TransactionsPath::{constant#0}>, Error>

Returns the Merkle path for the transactions leaf.

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

The Merkle tree of transaction IDs for the block.

impl<N> Transactions<N>

where N: Network,

pub fn from(transactions: &[ConfirmedTransaction<N>]) -> Transactions<N>

Initializes from a given transactions list.

impl<N> Transactions<N>

where N: Network,

pub fn get( &self, transaction_id: &<N as Network>::TransactionID, ) -> Option<&ConfirmedTransaction<N>>

Returns the transaction for the given transaction ID.

pub fn is_empty(&self) -> bool

Returns ‘true’ if there are no accepted or rejected transactions.

pub fn len(&self) -> usize

Returns the number of confirmed transactions.

pub fn num_accepted(&self) -> usize

Returns the number of accepted transactions.

pub fn num_rejected(&self) -> usize

Returns the number of rejected transactions.

pub fn num_finalize(&self) -> usize

Returns the number of finalize operations.

impl<N> Transactions<N>

where N: Network,

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

Returns true if the transactions contains the given transition ID.

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

Returns true if the transactions contains the given serial number.

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

Returns true if the transactions contains the given commitment.

impl<N> Transactions<N>

where N: Network,

pub fn find_confirmed_transaction_for_unconfirmed_transaction_id( &self, unconfirmed_transaction_id: &<N as Network>::TransactionID, ) -> Option<&ConfirmedTransaction<N>>

Returns the confirmed transaction for the given unconfirmed transaction ID, if it exists.

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

Returns the transaction with the given transition ID, if it exists.

pub fn find_transaction_for_serial_number( &self, serial_number: &Field<N>, ) -> Option<&Transaction<N>>

Returns the transaction with the given serial number, if it exists.

pub fn find_transaction_for_commitment( &self, commitment: &Field<N>, ) -> Option<&Transaction<N>>

Returns the transaction with the given commitment, if it exists.

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.

impl<N> Transactions<N>

where N: Network,

pub const MAX_TRANSACTIONS: usize = 65_536usize

The maximum number of transactions allowed in a block.

pub fn iter(&self) -> impl ExactSizeIterator

Returns an iterator over all transactions, for all transactions in self.

pub fn par_iter(&self) -> impl ParallelIterator<Item = &ConfirmedTransaction<N>>

Returns a parallel iterator over all transactions, for all transactions in self.

pub fn transaction_ids(&self) -> impl ExactSizeIterator

Returns an iterator over the transaction IDs, for all transactions in self.

pub fn deployments(&self) -> impl Iterator<Item = &ConfirmedTransaction<N>>

Returns an iterator over all transactions in self that are accepted deploy transactions.

pub fn executions(&self) -> impl Iterator<Item = &ConfirmedTransaction<N>>

Returns an iterator over all transactions in self that are accepted execute transactions.

pub fn transitions(&self) -> impl Iterator<Item = &Transition<N>>

Returns an iterator over all transitions.

pub fn transition_ids( &self, ) -> impl Iterator<Item = &<N as Network>::TransitionID>

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

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

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

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

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

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

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

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 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 transaction_fee_amounts( &self, ) -> impl Iterator<Item = Result<Integer<N, u64>, Error>>

Returns an iterator over the transaction fee amounts, for all transactions.

pub fn finalize_operations(&self) -> impl Iterator<Item = &FinalizeOperation<N>>

Returns an iterator over the finalize operations, for all transactions.

impl<N> Transactions<N>

where N: Network,

pub fn into_transaction_ids(self) -> impl ExactSizeIterator

Returns a consuming iterator over the transaction IDs, for all transactions in self.

pub fn into_deployments(self) -> impl Iterator<Item = ConfirmedTransaction<N>>

Returns a consuming iterator over all transactions in self that are accepted deploy transactions.

pub fn into_executions(self) -> impl Iterator<Item = ConfirmedTransaction<N>>

Returns a consuming iterator over all transactions in self that are accepted execute transactions.

pub fn into_transitions(self) -> impl Iterator<Item = Transition<N>>

Returns a consuming iterator over all transitions.

pub fn into_transition_ids( self, ) -> impl Iterator<Item = <N as Network>::TransitionID>

Returns a consuming iterator over the transition IDs, for all transitions.

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

Returns a consuming iterator over the transition public keys, for all transactions.

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

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

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

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

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

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

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

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

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

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

Trait Implementations

impl<N> Clone for Transactions<N>

where N: Clone + Network, <N as Network>::TransactionID: Clone,

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

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<N> Debug for Transactions<N>

where N: Network,

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

Prints the transactions as a JSON-string.

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

where N: Network,

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

where D: Deserializer<'de>,

Deserializes the transactions from a JSON-string or buffer.

impl<N> Display for Transactions<N>

where N: Network,

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

Displays the transactions as a JSON-string.

impl<N> FromBytes for Transactions<N>

where N: Network,

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

where R: Read,

Reads the transactions from 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 Transactions<N>

where N: Network,

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

Initializes the transactions from a JSON-string.

type Err = Error

The associated error which can be returned from parsing.

impl<N> IntoIterator for Transactions<N>

where N: Network,

fn into_iter(self) -> <Transactions<N> as IntoIterator>::IntoIter

Returns a consuming iterator over all transactions, for all transactions in self.

type IntoIter = IntoValues<<N as Network>::TransactionID, <Transactions<N> as IntoIterator>::Item>

Which kind of iterator are we turning this into?

type Item = ConfirmedTransaction<N>

The type of the elements being iterated over.

impl<N> PartialEq for Transactions<N>

where N: PartialEq + Network, <N as Network>::TransactionID: PartialEq,

fn eq(&self, other: &Transactions<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 Transactions<N>

where N: Network,

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

where S: Serializer,

Serializes the transactions to a JSON-string or buffer.

impl<N> ToBytes for Transactions<N>

where N: Network,

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

where W: Write,

Writes the transactions 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 Transactions<N>

where N: Eq + Network, <N as Network>::TransactionID: Eq,

impl<N> StructuralPartialEq for Transactions<N>

where N: Network,