Struct NeoRuntime 

pub struct NeoRuntime { /* private fields */ }

Neo runtime for executing compiled Yul contracts

Implementations

impl NeoRuntime

pub fn enable_debugging(&mut self)

Enable debugging mode

pub fn disable_debugging(&mut self)

Disable debugging mode

pub fn set_breakpoint(&mut self, instruction_pointer: u32)

Set breakpoint at instruction

pub fn remove_breakpoint(&mut self, instruction_pointer: u32)

Remove breakpoint

pub fn step(&mut self) -> Result<StepResult, RuntimeError>

Step through execution

impl NeoRuntime

pub fn deploy_contract( &mut self, bytecode: &[u8], constructor_args: &[u8], ) -> Result<String, RuntimeError>

Deploy contract and return address

impl NeoRuntime

pub fn override_block_height(&mut self, height: u64)

Override block height for the next execution.

pub fn override_timestamp(&mut self, timestamp: u64)

Override timestamp for the next execution.

pub fn override_caller_account( &mut self, account: &str, ) -> Result<(), RuntimeError>

Override caller script hash for the next execution.

pub fn override_value(&mut self, value: u64)

Task #113 — Override Solidity msg.value for the next execution.

Neo N3 has no native attached-value concept, so compiled MsgValue reads default to 0. This override lets harnesses drive msg.value to a specific u64 for payable-fallback / NEP-17 onPayment test scenarios. Drained after the next execution (mirrors override_timestamp / override_block_height).

pub fn execute_with_overrides( &mut self, bytecode: &[u8], input: &[u8], overrides: &ExecutionOverrides, ) -> Result<ExecutionResult, RuntimeError>

Execute bytecode with optional metadata overrides applied to this invocation.

pub fn new(config: RuntimeConfig) -> Result<Self, RuntimeError>

Create new runtime instance

pub fn execute( &mut self, bytecode: &[u8], input: &[u8], ) -> Result<ExecutionResult, RuntimeError>

Execute bytecode with given input

pub fn execute_with_tokens( &mut self, bytecode: &[u8], input: &[u8], tokens: &[MethodToken], ) -> Result<ExecutionResult, RuntimeError>

Execute bytecode with a NEF method token table.

This is required when the script contains the CALLT opcode (0x37).

pub fn call_function( &mut self, bytecode: &[u8], function_name: &str, args: &[StackItem], ) -> Result<ExecutionResult, RuntimeError>

Call specific function with arguments

pub fn call_method( &mut self, bytecode: &[u8], tokens: &[MethodToken], manifest: &Value, method_name: &str, args: &[StackItem], ) -> Result<ExecutionResult, RuntimeError>

Invoke a named method on a compiled Neo DevPack for Solidity contract.

Unlike call_function, which cannot reach anything past the first public method of a multi-method contract, this helper (Task #19):

1. Runs _deploy(null, false) once per NeoRuntime instance so that state-variable initializers populate storage before any user call observes the contract (Task #47: state-var initializers did not run under the execute/call_function paths — this subsumes it).
2. Looks up the target method’s offset from manifest.abi.methods[].offset (emitted by the compiler at src/cli/bytecode/bytecode_core.rs:120) and starts execution at that offset rather than always at bytecode[0].
3. Pushes args in reverse onto the NeoVM evaluation stack so that the INITSLOT locals, args prologue emitted by each compiled method (opcode 0x57, handler at instruction/slots.rs:4) pops them into the method’s argument slots in declaration order.

The persisted storage lives in storage_manager; bridge::execute flushes the storage_overlay via storage.commit(..) on halt, so subsequent call_method invocations on the same NeoRuntime observe deploy-time writes.

tokens is the NEF method-token table carried alongside the bytecode (see CompilationArtifacts::tokens); pass an empty slice for scripts that do not use CALLT.

pub fn call_method_with_deploy_args( &mut self, bytecode: &[u8], tokens: &[MethodToken], manifest: &Value, method_name: &str, args: &[StackItem], deploy_args: Option<&[StackItem]>, ) -> Result<ExecutionResult, RuntimeError>

Task #81: Invoke a named method like call_method, but pass deploy_args through the auto-fired _deploy(data, update) trigger as the data parameter.

deploy_args wires constructor arguments for contracts whose Solidity constructor(...) takes parameters. When deploy_args = Some(&[..]), the slice is wrapped in a StackItem::Array and passed as data; the compiled _deploy prologue then decodes it (jsonDeserialize/deserialize fallbacks throw on Array inputs, so the original Array flows through unchanged to PICKITEM / ArrayGet for constructor-argument extraction, see src/ir/ir_deploy.rs:112).

When deploy_args = None, behavior matches pre-Task #81 call_method: data = Null, suitable for no-arg constructors.

update is always Boolean(false) here (this is a first-deployment trigger, not a contract update).

impl NeoRuntime

pub fn get_state_snapshot(&self) -> StateSnapshot

Get current state of the runtime

pub fn restore_state( &mut self, snapshot: StateSnapshot, ) -> Result<(), RuntimeError>

Restore state from snapshot

pub fn get_storage( &mut self, account: &str, key: &[u8], ) -> Result<Option<Vec<u8>>, RuntimeError>

Get storage value for account and key

pub fn set_storage( &mut self, account: &str, key: &[u8], value: &[u8], ) -> Result<(), RuntimeError>

Set storage value for account and key

pub fn storage_find( &mut self, account: &str, prefix: &[u8], ) -> Result<Vec<(Vec<u8>, Vec<u8>)>, RuntimeError>

Find all storage (key, value) pairs for account whose keys start with prefix, returned in byte-lexicographic key order.

Delegates to StorageManager::query with an explicit prefix filter; an empty prefix slice matches every key for the account (common “scan all” pattern used by Neo N3 storage iterators).

pub fn get_balance(&self, account: &str) -> Result<u64, RuntimeError>

Get account balance

pub fn set_balance( &mut self, account: &str, balance: u64, ) -> Result<(), RuntimeError>

Set account balance

pub fn get_statistics(&self) -> RuntimeStatistics

Get runtime statistics

Trait Implementations

impl Debug for NeoRuntime

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

Formats the value using the given formatter.