Struct sc_executor_common::sandbox::SandboxInstance

source · [−]

pub struct SandboxInstance<FR> { /* private fields */ }

Expand description

Sandboxed instance of a wasm module.

It’s primary purpose is to invoke exported functions on it.

All imports of this instance are specified at the creation time and imports are implemented by the supervisor.

Hence, in order to invoke an exported function on a sandboxed module instance, it’s required to provide supervisor externals: it will be used to execute code in the supervisor context.

This is generic over a supervisor function reference type.

Implementations

source

impl<FR> SandboxInstance<FR>

source

pub fn invoke<FE: SandboxCapabilities<SupervisorFuncRef = FR>>(
 &self,
 export_name: &str,
 args: &[RuntimeValue ],
 supervisor_externals: &mut FE,
 state: u32
) -> Result<Option<RuntimeValue>, Error>

Invoke an exported function by a name.

supervisor_externals is required to execute the implementations of the syscalls that published to a sandboxed module instance.

The state parameter can be used to provide custom data for these syscall implementations.

source

pub fn get_global_val(&self, name: &str) -> Option<Value>

Get the value from a global with the given name.

Returns Some(_) if the global could be found.

Auto Trait Implementations

impl<FR> !RefUnwindSafe for SandboxInstance<FR>

impl<FR> !Send for SandboxInstance<FR>

impl<FR> !Sync for SandboxInstance<FR>

impl<FR> Unpin for SandboxInstance<FR> where
FR: Unpin,

impl<FR> !UnwindSafe for SandboxInstance<FR>

Blanket Implementations

source

impl<T> Any for T where
T: 'static + ?Sized,

source

pub fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

source

impl<T> Borrow<T> for T where
T: ?Sized,

const: unstable · source

pub fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

source

impl<T> BorrowMut<T> for T where
T: ?Sized,

const: unstable · source

pub fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

source

impl<T> From<T> for T

const: unstable · source

pub fn from(t: T) -> T

Returns the argument unchanged.

source

impl<T> Instrument for T

source

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more

source

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more

source

impl<T, U> Into for T where
U: From<T>,

const: unstable · source

pub fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source

impl<T, Outer> IsWrappedBy<Outer> for T where
Outer: AsRef<T> + AsMut<T> + From<T>,
T: From<Outer>,

source

pub fn from_ref(outer: &Outer) -> &T

Get a reference to the inner from the outer.

source

pub fn from_mut(outer: &mut Outer) -> &mut T

Get a mutable reference to the inner from the outer.

source

impl<T> Same<T> for T

type Output = T

Should always be Self

source

impl<T, U> TryFrom for T where
U: Into<T>,

type Error = Infallible

The type returned in the event of a conversion error.

const: unstable · source

pub fn try_from(value: U) -> Result<T, <T as TryFrom>::Error>

Performs the conversion.

source

impl<T, U> TryInto for T where
U: TryFrom<T>,

type Error = >::Error

The type returned in the event of a conversion error.

const: unstable · source

pub fn try_into(self) -> Result<U, >::Error>

Performs the conversion.

source

impl<S, T> UncheckedInto<T> for S where
T: UncheckedFrom<S>,

source

pub fn unchecked_into(self) -> T

The counterpart to unchecked_from.

source

impl<V, T> VZip<V> for T where
V: MultiLane<T>,

source

Struct sc_executor_common::sandbox::SandboxInstance

Implementations

impl<FR> SandboxInstance<FR>

pub fn invoke<FE: SandboxCapabilities<SupervisorFuncRef = FR>>(
    &self,
    export_name: &str,
    args: &[RuntimeValue ],
    supervisor_externals: &mut FE,
    state: u32
) -> Result<Option<RuntimeValue>, Error>

pub fn get_global_val(&self, name: &str) -> Option<Value>

Auto Trait Implementations

impl<FR> !RefUnwindSafe for SandboxInstance<FR>

impl<FR> !Send for SandboxInstance<FR>

impl<FR> !Sync for SandboxInstance<FR>

impl<FR> Unpin for SandboxInstance<FR> where
FR: Unpin,

impl<FR> !UnwindSafe for SandboxInstance<FR>

Blanket Implementations

impl<T> Any for T where
T: 'static + ?Sized,

pub fn type_id(&self) -> TypeId

impl<T> Borrow<T> for T where
T: ?Sized,

pub fn borrow(&self) -> &T

impl<T> BorrowMut<T> for T where
T: ?Sized,

pub fn borrow_mut(&mut self) -> &mut T

impl<T> From<T> for T

pub fn from(t: T) -> T

impl<T> Instrument for T

fn instrument(self, span: Span) -> Instrumented<Self>

fn in_current_span(self) -> Instrumented<Self>

impl<T, U> Into<U> for T where
U: From<T>,

pub fn into(self) -> U

impl<T, Outer> IsWrappedBy<Outer> for T where
Outer: AsRef<T> + AsMut<T> + From<T>,
T: From<Outer>,

pub fn from_ref(outer: &Outer) -> &T

pub fn from_mut(outer: &mut Outer) -> &mut T

impl<T> Same<T> for T

type Output = T

impl<T, U> TryFrom<U> for T where
U: Into<T>,

type Error = Infallible

pub fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

impl<T, U> TryInto<U> for T where
U: TryFrom<T>,

type Error = <U as TryFrom<T>>::Error

pub fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

impl<S, T> UncheckedInto<T> for S where
T: UncheckedFrom<S>,

pub fn unchecked_into(self) -> T

impl<V, T> VZip<V> for T where
V: MultiLane<T>,

pub fn vzip(self) -> V

Struct sc_executor_common::sandbox::SandboxInstance

Implementations

impl<FR> SandboxInstance<FR>

pub fn invoke<FE: SandboxCapabilities<SupervisorFuncRef = FR>>( &self, export_name: &str, args: &[RuntimeValue], supervisor_externals: &mut FE, state: u32) -> Result<Option<RuntimeValue>, Error>

pub fn get_global_val(&self, name: &str) -> Option<Value>

Auto Trait Implementations

impl<FR> !RefUnwindSafe for SandboxInstance<FR>

impl<FR> !Send for SandboxInstance<FR>

impl<FR> !Sync for SandboxInstance<FR>

impl<FR> Unpin for SandboxInstance<FR> where FR: Unpin,

impl<FR> !UnwindSafe for SandboxInstance<FR>

Blanket Implementations

impl<T> Any for T where T: 'static + ?Sized,

pub fn type_id(&self) -> TypeId

impl<T> Borrow<T> for T where T: ?Sized,

pub fn borrow(&self) -> &T

impl<T> BorrowMut<T> for T where T: ?Sized,

pub fn borrow_mut(&mut self) -> &mut T

impl<T> From<T> for T

pub fn from(t: T) -> T

impl<T> Instrument for T

fn instrument(self, span: Span) -> Instrumented<Self>

fn in_current_span(self) -> Instrumented<Self>

impl<T, U> Into<U> for T where U: From<T>,

pub fn into(self) -> U

impl<T, Outer> IsWrappedBy<Outer> for T where Outer: AsRef<T> + AsMut<T> + From<T>, T: From<Outer>,

pub fn from_ref(outer: &Outer) -> &T

pub fn from_mut(outer: &mut Outer) -> &mut T

impl<T> Same<T> for T

type Output = T

impl<T, U> TryFrom<U> for T where U: Into<T>,

type Error = Infallible

pub fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

impl<T, U> TryInto<U> for T where U: TryFrom<T>,

type Error = <U as TryFrom<T>>::Error

pub fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

impl<S, T> UncheckedInto<T> for S where T: UncheckedFrom<S>,

pub fn unchecked_into(self) -> T

impl<V, T> VZip<V> for T where V: MultiLane<T>,

pub fn vzip(self) -> V

pub fn invoke<FE: SandboxCapabilities<SupervisorFuncRef = FR>>(
&self,
export_name: &str,
args: &[RuntimeValue ],
supervisor_externals: &mut FE,
state: u32
) -> Result<Option<RuntimeValue>, Error>

impl<FR> Unpin for SandboxInstance<FR> where
FR: Unpin,

impl<T> Any for T where
T: 'static + ?Sized,

impl<T> Borrow<T> for T where
T: ?Sized,

impl<T> BorrowMut<T> for T where
T: ?Sized,

impl<T, U> Into<U> for T where
U: From<T>,

impl<T, Outer> IsWrappedBy<Outer> for T where
Outer: AsRef<T> + AsMut<T> + From<T>,
T: From<Outer>,

impl<T, U> TryFrom<U> for T where
U: Into<T>,

impl<T, U> TryInto<U> for T where
U: TryFrom<T>,

impl<S, T> UncheckedInto<T> for S where
T: UncheckedFrom<S>,

impl<V, T> VZip<V> for T where
V: MultiLane<T>,