Struct FrameTxContext 

pub struct FrameTxContext {
    pub sender_approved: bool,
    pub payer_address: Option<Address>,
    pub frame_results: Vec<(u8, u64, Vec<Log>)>,
    pub current_frame_index: usize,
    pub sig_hash: H256,
    pub tx: FrameTransaction,
    pub approve_called_in_current_frame: bool,
    pub total_gas_limit: u64,
}

Context for frame transaction (EIP-8141) execution. This is set when executing a frame transaction and is used by APPROVE, TXPARAM, FRAMEDATALOAD, and FRAMEDATACOPY opcodes.

Fields

sender_approved: bool

Whether the sender has approved (APPROVE scope APPROVE_EXECUTION or APPROVE_EXECUTION_AND_PAYMENT).

payer_address: Option<Address>

The address that approved payment, set by APPROVE_PAYMENT or APPROVE_EXECUTION_AND_PAYMENT. Per the latest EIP-8141 spec this is the single source of truth for whether payment has been approved: when this is Some(_), the transaction has a payer; when None, it does not.

frame_results: Vec<(u8, u64, Vec<Log>)>

Per-frame execution results (status, gas_used, logs). status is a FRAME_RECEIPT_STATUS_* code (0 = failure, 1 = success, 3 = skipped due to failed atomic batch).

current_frame_index: usize

Index of the currently executing frame

sig_hash: H256

The sig_hash of the frame transaction

tx: FrameTransaction

The full frame transaction (for TXPARAM access)

approve_called_in_current_frame: bool

Whether APPROVE was called in the current frame

total_gas_limit: u64

Cached FrameTransaction::total_gas_limit(). Computing it re-encodes every frame and signature, so it must not run per-opcode (TXPARAM 0x06, compute_tx_max_cost). Computed once at tx entry.

Implementations

impl FrameTxContext

pub fn approval_snapshot(&self) -> (bool, Option<Address>)

Capture the approval state at atomic-batch entry. A batch revert rolls back the payer’s balance deduction and the sender nonce increment, so approvals granted inside the batch must be rolled back with it — otherwise a reverted APPROVE would leave the transaction authorized by a frame whose effects no longer exist.

pub fn restore_approvals(&mut self, snapshot: (bool, Option<Address>))

Restore the approval state captured by approval_snapshot when the enclosing atomic batch reverts. Approvals granted before the batch are unaffected (the snapshot includes them).

Trait Implementations

impl Clone for FrameTxContext

fn clone(&self) -> FrameTxContext

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FrameTxContext

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

Formats the value using the given formatter.