Struct LazyInstructionFetcher 

pub struct LazyInstructionFetcher { /* private fields */ }

Lazy instruction fetcher implementation

Implementations

impl LazyInstructionFetcher

pub unsafe fn new(return_trap_address: u64, pc: u64) -> Self

Create a new instance.

return_trap_address is the address at which the interpreter will stop execution (gracefully).

Safety

The program counter must be valid and aligned, the instructions processed must be valid and end with a jump instruction.

Trait Implementations

impl Clone for LazyInstructionFetcher

fn clone(&self) -> LazyInstructionFetcher

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for LazyInstructionFetcher

impl Debug for LazyInstructionFetcher

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

Formats the value using the given formatter.

impl<Memory> InstructionFetcher<ContractInstruction, Memory> for LazyInstructionFetcher

where Memory: VirtualMemory,

fn peek_instruction( &mut self, memory: &Memory, ) -> FetchInstructionResult<ContractInstruction>

Read the instruction at the current position, leaving the program counter on it.

unsafe fn advance(&mut self, instruction_size: u8)

Move the program counter past an instruction of instruction_size bytes that Self::peek_instruction() has just returned.

fn fetch_instruction( &mut self, memory: &Memory, ) -> FetchInstructionResult<ContractInstruction>

Fetch a single instruction at a specified address and advance the program counter on successful fetch.

impl<Memory> ProgramCounter<u64, Memory> for LazyInstructionFetcher

where Memory: VirtualMemory,

fn get_pc(&self) -> u64

Get the current value of the program counter

unsafe fn try_set_pc_relative( &mut self, instruction_size: u8, offset: i32, ) -> bool

Move offset bytes from the instruction being executed for targets this can resolve.

unsafe fn failed_branch( &mut self, memory: &Memory, ) -> Result<ControlFlow<()>, ExecutionError<u64>>

Say what is wrong with the target Self::try_set_pc_relative() refused.

fn set_pc( &mut self, memory: &Memory, pc: u64, ) -> Result<ControlFlow<()>, ExecutionError<u64>>

Set the current value of the program counter

fn old_pc(&self, instruction_size: u8) -> Address

where Address: From<u8> + Sub<Output = Address>,

Get the previous value of the program counter before executing an instruction.

fn set_pc_relative( &mut self, memory: &Memory, instruction_size: u8, offset: i32, ) -> Result<ControlFlow<()>, ExecutionError<Address>>

where Self: ProgramCounter<Address, Memory>,

Apply ExecutionResult::Branch, continuing offset bytes from the instruction being executed.