dharitri-vm-executor 2.0.0

DharitrI VM executor interface
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

use crate::{BreakpointValue, ExecutorError, VMHooksEarlyExit};

pub enum InstanceCallResult {
    Ok,
    FunctionNotFound,
    RuntimeError(ExecutorError),
    VMHooksEarlyExit(VMHooksEarlyExit),
    Breakpoint(BreakpointValue),
}

/// The new instance trait, only used for configuring & calling the wasmer instance.
pub trait Instance {
    /// Calls an exported function of a WebAssembly instance by `name`.
    fn call(&mut self, func_name: &str, points_limit: u64) -> InstanceCallResult;

    /// Checks that all public module functions (SC endpoints) have no arguments or results.
    fn check_signatures(&self) -> bool;

    /// Checks whether SC has an endpoint with given name.
    fn has_function(&self, func_name: &str) -> bool;

    /// Required to be able to extract all SC endpoint names.
    fn get_exported_function_names(&self) -> Vec<String>;

    /// Returns the number of points(gas) used by the given instance.
    fn get_points_used(&mut self) -> Result<u64, ExecutorError>;

    /// Resets an instance, cleaning memories and globals.
    fn reset(&self) -> Result<(), ExecutorError>;

    /// Caches an instance.
    fn cache(&self) -> Result<Vec<u8>, ExecutorError>;
}