Struct ContractRuntime 

pub struct ContractRuntime { /* private fields */ }

Runtime responsible for executing a single contract invocation.

This runtime encapsulates a concrete execution Strategy (interpreter, AOT, JIT, etc.), a typed store holding the RuntimeContext, and the resolved entrypoint to invoke.

A single instance corresponds to one logical contract execution (call or deployment).

Implementations

impl ContractRuntime

pub fn new( strategy: StrategyDefinition, import_linker: Arc<ImportLinker>, ctx: RuntimeContext, fuel_limit: Option<u64>, ) -> Result<Self, TrapCode>

Creates a new contract runtime instance.

This constructor:

• selects the appropriate entrypoint based on ctx.state,
• creates a new rWasm store bound to the provided execution strategy,
• wires the runtime syscall handler,
• configures fuel metering.

Panics

Panics if the contract state is neither STATE_MAIN nor STATE_DEPLOY.

pub fn execute(&mut self) -> Result<(), TrapCode>

Executes the contract entrypoint.

Starts execution from the resolved entrypoint (main or deploy) with no arguments and no direct return values.

Any trap produced by execution is surfaced as a TrapCode.

pub fn resume( &mut self, exit_code: i32, fuel_consumed: u64, ) -> Result<(), TrapCode>

Resumes contract execution after an external interruption.

This is typically called after handling a syscall or delegated execution. The provided exit_code is passed back into the runtime, and fuel_consumed is charged before resuming execution.

pub fn memory_write( &mut self, offset: usize, data: &[u8], ) -> Result<(), TrapCode>

Writes data into the contract linear memory.

Performs bounds checking according to the underlying memory model. Out-of-bounds writes result in a trap.

pub fn memory_read( &mut self, offset: usize, buffer: &mut [u8], ) -> Result<(), TrapCode>

Reads data from the contract linear memory.

Fills buffer with bytes starting at offset. Traps if the read exceeds accessible memory.

pub fn remaining_fuel(&self) -> Option<u64>

Returns the remaining execution fuel if fuel metering is enabled.

Returns None if fuel accounting is disabled for this execution.

pub fn context_mut(&mut self) -> &mut RuntimeContext

Provides mutable access to the runtime context.

This is the only supported way to mutate execution-scoped state such as logs, gas accounting, call depth, or environment data.

pub fn context(&self) -> &RuntimeContext

Provides immutable access to the runtime context.

Intended for inspection and read-only queries.