Struct Stack

pub struct Stack { /* private fields */ }

EVM stack with STACK_LIMIT capacity of words.

Implementations

impl Stack

pub fn new() -> Self

Instantiate a new stack with the default stack limit.

pub fn len(&self) -> usize

Returns the length of the stack in words.

pub fn is_empty(&self) -> bool

Returns whether the stack is empty.

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

Returns a reference to the underlying data buffer.

pub fn data_mut(&mut self) -> &mut Vec<U256>

Returns a mutable reference to the underlying data buffer.

pub fn into_data(self) -> Vec<U256>

Consumes the stack and returns the underlying data buffer.

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

Removes the topmost element from the stack and returns it, or StackUnderflow if it is empty.

pub unsafe fn pop_unsafe(&mut self) -> U256

Removes the topmost element from the stack and returns it.

Safety

The caller is responsible for checking the length of the stack.

pub unsafe fn top_unsafe(&mut self) -> &mut U256

Peeks the top of the stack.

Safety

The caller is responsible for checking the length of the stack.

pub unsafe fn popn<const N: usize>(&mut self) -> [U256; N]

Pops N values from the stack.

Safety

The caller is responsible for checking the length of the stack.

pub unsafe fn popn_top<const POPN: usize>( &mut self, ) -> ([U256; POPN], &mut U256)

Pops N values from the stack and returns the top of the stack.

Safety

The caller is responsible for checking the length of the stack.

pub fn push(&mut self, value: U256) -> bool

Push a new value onto the stack.

If it will exceed the stack limit, returns false and leaves the stack unchanged.

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

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 dup(&mut self, n: usize) -> bool

Duplicates the Nth value from the top of the stack.

Panics

Panics if n is 0.

pub fn swap(&mut self, n: usize) -> bool

Swaps the topmost value with the Nth value from the top.

Panics

Panics if n is 0.

pub fn exchange(&mut self, n: usize, m: usize) -> bool

Exchange two values on the stack.

n is the first index, and the second index is calculated as n + m.

Panics

Panics if m is zero.

pub fn push_slice(&mut self, slice: &[u8]) -> Result<(), InstructionResult>

Pushes an arbitrary length slice of bytes onto the stack, padding the last word with zeros if necessary.

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

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.

Trait Implementations

impl Clone for Stack

fn clone(&self) -> Self

Returns a copy 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.

impl Default for Stack

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Stack

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Stack

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

Formats the value using the given formatter.

impl Hash for Stack

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for Stack

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

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StackTrait for Stack

fn len(&self) -> usize

Returns stack length.

fn popn<const N: usize>(&mut self) -> Option<[U256; N]>

Pop value from the stack.

fn popn_top<const POPN: usize>(&mut self) -> Option<([U256; POPN], &mut U256)>

Pop N values from the stack and return top value.

fn exchange(&mut self, n: usize, m: usize) -> bool

Exchange two values on the stack.

fn dup(&mut self, n: usize) -> bool

Duplicates the Nth value from the top of the stack.

fn push(&mut self, value: U256) -> bool

Pushes values to the stack Return true if push was successful, false if stack overflow.

fn is_empty(&self) -> bool

Returns true if stack is empty.

fn push_b256(&mut self, value: B256) -> bool

fn top(&mut self) -> Option<&mut U256>

Return top value from the stack.

fn pop(&mut self) -> Option<U256>

Pop one value from the stack.

fn pop_address(&mut self) -> Option<Address>

impl Eq for Stack

impl StructuralPartialEq for Stack