Struct SanitizedTransaction 

pub struct SanitizedTransaction { /* private fields */ }

Sanitized transaction and the hash of its message

Implementations

impl SanitizedTransaction

pub fn try_new( tx: SanitizedVersionedTransaction, message_hash: Hash, is_simple_vote_tx: bool, address_loader: impl AddressLoader, reserved_account_keys: &HashSet<Address>, ) -> Result<SanitizedTransaction, TransactionError>

Create a sanitized transaction from a sanitized versioned transaction. If the input transaction uses address tables, attempt to lookup the address for each table index.

pub fn try_create( tx: VersionedTransaction, message_hash: impl Into<MessageHash>, is_simple_vote_tx: Option<bool>, address_loader: impl AddressLoader, reserved_account_keys: &HashSet<Address>, ) -> Result<SanitizedTransaction, TransactionError>

Create a sanitized transaction from an un-sanitized versioned transaction. If the input transaction uses address tables, attempt to lookup the address for each table index.

pub fn try_from_legacy_transaction( tx: Transaction, reserved_account_keys: &HashSet<Address>, ) -> Result<SanitizedTransaction, TransactionError>

Create a sanitized transaction from a legacy transaction

pub fn from_transaction_for_tests(tx: Transaction) -> SanitizedTransaction

Create a sanitized transaction from a legacy transaction. Used for tests only.

pub fn try_new_from_fields( message: SanitizedMessage, message_hash: Hash, is_simple_vote_tx: bool, signatures: Vec<Signature>, ) -> Result<SanitizedTransaction, TransactionError>

Create a sanitized transaction from fields. Performs only basic signature sanitization.

pub fn signature(&self) -> &Signature

Return the first signature for this transaction.

Notes:

Sanitized transactions must have at least one signature because the number of signatures must be greater than or equal to the message header value num_required_signatures which must be greater than 0 itself.

pub fn signatures(&self) -> &[Signature]

Return the list of signatures for this transaction

pub fn message(&self) -> &SanitizedMessage

Return the signed message

pub fn message_hash(&self) -> &Hash

Return the hash of the signed message

pub fn is_simple_vote_transaction(&self) -> bool

Returns true if this transaction is a simple vote

pub fn to_versioned_transaction(&self) -> VersionedTransaction

Convert this sanitized transaction into a versioned transaction for recording in the ledger.

pub fn get_account_locks( &self, tx_account_lock_limit: usize, ) -> Result<TransactionAccountLocks<'_>, TransactionError>

Validate and return the account keys locked by this transaction

pub fn get_account_locks_unchecked(&self) -> TransactionAccountLocks<'_>

Return the list of accounts that must be locked during processing this transaction.

pub fn get_loaded_addresses(&self) -> LoadedAddresses

Return the list of addresses loaded from on-chain address lookup tables

pub fn get_durable_nonce(&self) -> Option<&Address>

If the transaction uses a durable nonce, return the pubkey of the nonce account

pub fn verify(&self) -> Result<(), TransactionError>

Verify the transaction signatures

pub fn validate_account_locks( message: &SanitizedMessage, tx_account_lock_limit: usize, ) -> Result<(), TransactionError>

Validate a transaction message against locked accounts

Trait Implementations

impl Clone for SanitizedTransaction

fn clone(&self) -> SanitizedTransaction

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SanitizedTransaction

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

Formats the value using the given formatter.

impl PartialEq for SanitizedTransaction

fn eq(&self, other: &SanitizedTransaction) -> 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 SVMMessage for SanitizedTransaction

fn num_transaction_signatures(&self) -> u64

Return the number of transaction-level signatures in the message.

fn num_write_locks(&self) -> u64

Returns the number of requested write-locks in this message. This does not consider if write-locks are demoted.

fn recent_blockhash(&self) -> &Hash

Return the recent blockhash.

fn num_instructions(&self) -> usize

Return the number of instructions in the message.

fn instructions_iter(&self) -> impl Iterator<Item = SVMInstruction<'_>>

Return an iterator over the instructions in the message.

fn program_instructions_iter( &self, ) -> impl Iterator<Item = (&Address, SVMInstruction<'_>)> + Clone

Return an iterator over the instructions in the message, paired with the pubkey of the program.

fn static_account_keys(&self) -> &[Address]

Return the list of static account keys.

fn account_keys(&self) -> AccountKeys<'_>

Return the account keys.

fn fee_payer(&self) -> &Address

Return the fee-payer

fn is_writable(&self, index: usize) -> bool

Returns true if the account at index is writable.

fn is_signer(&self, index: usize) -> bool

Returns true if the account at index is signer.

fn is_invoked(&self, key_index: usize) -> bool

Returns true if the account at the specified index is invoked as a program in top-level instructions of this message.

fn num_lookup_tables(&self) -> usize

Get the number of lookup tables.

fn message_address_table_lookups( &self, ) -> impl Iterator<Item = SVMMessageAddressTableLookup<'_>>

Get message address table lookups used in the message

fn num_ed25519_signatures(&self) -> u64

Return the number of ed25519 precompile signatures in the message.

fn num_secp256k1_signatures(&self) -> u64

Return the number of secp256k1 precompile signatures in the message.

fn num_secp256r1_signatures(&self) -> u64

Return the number of secp256r1 precompile signatures in the message.

fn is_instruction_account(&self, key_index: usize) -> bool

Returns true if the account at the specified index is an input to some program instruction in this message.

fn get_durable_nonce( &self, require_static_nonce_account: bool, ) -> Option<&Address>

If the message uses a durable nonce, return the pubkey of the nonce account

fn get_ix_signers(&self, index: usize) -> impl Iterator<Item = &Address>

For the instruction at index, return an iterator over input accounts that are signers.

impl SVMTransaction for SanitizedTransaction

fn signature(&self) -> &Signature

Get the first signature of the message.

fn signatures(&self) -> &[Signature]

Get all the signatures of the message.

impl Eq for SanitizedTransaction

impl StructuralPartialEq for SanitizedTransaction