Struct Runtime

pub struct Runtime<'a, T, H, M: ?Sized> { /* private fields */ }

Can only be used for one call.

Implementations

impl<T: Config, H: PrecompileHandle, M: PolkaVmInstance> Runtime<'_, T, H, M>

pub fn handle_interrupt( &mut self, interrupt: Result<InterruptKind, Error>, module: &Module, instance: &mut M, ) -> Option<ExecResult>

impl<'a, T: Config, H: PrecompileHandle, M: PolkaVmInstance> Runtime<'a, T, H, M>

pub fn new(handle: &'a mut H, input_data: Vec<u8>, gas_limit: Gas) -> Self

pub fn write_sandbox_output( &mut self, memory: &mut M, out_ptr: u32, out_len_ptr: u32, buf: &[u8], allow_skip: bool, create_token: impl FnOnce(u32) -> Option<RuntimeCosts>, ) -> Result<(), SupervisorError>

Write the given buffer and its length to the designated locations in sandbox memory and charge gas according to the token returned by create_token.

out_ptr is the location in sandbox memory where buf should be written to. out_len_ptr is an in-out location in sandbox memory. It is read to determine the length of the buffer located at out_ptr. If that buffer is smaller than the actual buf.len(), only what fits into that buffer is written to out_ptr. The actual amount of bytes copied to out_ptr is written to out_len_ptr.

If out_ptr is set to the sentinel value of SENTINEL and allow_skip is true the operation is skipped and Ok is returned. This is supposed to help callers to make copying output optional. For example to skip copying back the output buffer of an seal_call when the caller is not interested in the result.

create_token can optionally instruct this function to charge the gas meter with the token it returns. create_token receives the variable amount of bytes that are about to be copied by this function.

In addition to the error conditions of Memory::write this functions returns Err if the size of the buffer located at out_ptr is too small to fit buf.

pub fn write_fixed_sandbox_output( &mut self, memory: &mut M, out_ptr: u32, buf: &[u8], allow_skip: bool, create_token: impl FnOnce(u32) -> Option<RuntimeCosts>, ) -> Result<(), SupervisorError>

Same as write_sandbox_output but for static size output.