Struct Stack

pub struct Stack { /* private fields */ }

EVM stack.

Implementations

impl Stack

pub const fn new(limit: usize) -> Self

Create a new stack with given limit.

pub const fn limit(&self) -> usize

Stack limit.

pub fn len(&self) -> usize

Stack length.

pub fn is_empty(&self) -> bool

Whether the stack is empty.

pub const fn data(&self) -> &Vec<U256>

Stack data.

pub fn clear(&mut self)

Clear the stack.

pub fn pop(&mut self) -> Result<U256, ExitException>

Pop a value from the stack. If the stack is already empty, returns the StackUnderflow error.

pub fn push(&mut self, value: U256) -> Result<(), ExitException>

Push a new value into the stack. If it exceeds the stack limit, returns StackOverflow error and leaves the stack unchanged.

pub fn check_pop_push( &self, pop: usize, push: usize, ) -> Result<(), ExitException>

Check whether it’s possible to pop and push enough items in the stack.

pub fn peek(&self, no_from_top: usize) -> Result<U256, ExitException>

Peek a value at given index for the stack, where the top of the stack is at index 0. If the index is too large, StackError::Underflow is returned.

pub fn set( &mut self, no_from_top: usize, val: U256, ) -> Result<(), ExitException>

Set a value at given index for the stack, where the top of the stack is at index 0. If the index is too large, StackError::Underflow is returned.

pub fn perform_pop0_push1<R, F>(&mut self, f: F) -> Result<R, ExitError>

where F: FnOnce() -> Result<(U256, R), ExitError>,

Pop $pop_len values from the stack, and then push $push_len values into the stack.

If f returns error, then the stack will not be changed.

pub fn perform_pop1_push0<R, F>(&mut self, f: F) -> Result<R, ExitError>

where F: FnOnce(&U256) -> Result<((), R), ExitError>,

Pop $pop_len values from the stack, and then push $push_len values into the stack.

If f returns error, then the stack will not be changed.

pub fn perform_pop1_push1<R, F>(&mut self, f: F) -> Result<R, ExitError>

where F: FnOnce(&U256) -> Result<(U256, R), ExitError>,

Pop $pop_len values from the stack, and then push $push_len values into the stack.

If f returns error, then the stack will not be changed.

pub fn perform_pop2_push1<R, F>(&mut self, f: F) -> Result<R, ExitError>

where F: FnOnce(&U256, &U256) -> Result<(U256, R), ExitError>,

Pop $pop_len values from the stack, and then push $push_len values into the stack.

If f returns error, then the stack will not be changed.

pub fn perform_pop3_push0<R, F>(&mut self, f: F) -> Result<R, ExitError>

where F: FnOnce(&U256, &U256, &U256) -> Result<((), R), ExitError>,

Pop $pop_len values from the stack, and then push $push_len values into the stack.

If f returns error, then the stack will not be changed.

pub fn perform_pop4_push0<R, F>(&mut self, f: F) -> Result<R, ExitError>

where F: FnOnce(&U256, &U256, &U256, &U256) -> Result<((), R), ExitError>,

Pop $pop_len values from the stack, and then push $push_len values into the stack.

If f returns error, then the stack will not be changed.

pub fn perform_pop6_push0<R, F>(&mut self, f: F) -> Result<R, ExitError>

where F: FnOnce(&U256, &U256, &U256, &U256, &U256, &U256) -> Result<((), R), ExitError>,

Pop $pop_len values from the stack, and then push $push_len values into the stack.

If f returns error, then the stack will not be changed.

pub fn perform_pop7_push0<R, F>(&mut self, f: F) -> Result<R, ExitError>

where F: FnOnce(&U256, &U256, &U256, &U256, &U256, &U256, &U256) -> Result<((), R), ExitError>,

Pop $pop_len values from the stack, and then push $push_len values into the stack.

If f returns error, then the stack will not be changed.

Trait Implementations

impl Clone for Stack

fn clone(&self) -> Stack

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Stack

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

Formats the value using the given formatter.