Struct Barrel

pub struct Barrel<H: Send + Clone> { /* private fields */ }

Barrel encapsulates the concept of a running Lyquid instance given a specific execution context (Barrel::host, which also includes the a version of network state). The given H generic type should be clonable in a way that all clones effecitvely represent the same context/state.

In the implementation, all Bottles (e.g., call frames) in a Barrel share the same [LyteMemory] object.

Implementations

impl<H: Send + Clone> Barrel<H>

pub fn builder( wasm_bin: Bytes, lite_memory: LyteMemory, host: H, ) -> Result<BarrelBuilder<H>, Error>

Create a builder for Barrel.

pub async fn nuke_state(&self) -> Result<(), Error>

Mark the network & instance state as uninitialized, which means the next call made to the Barrel will start with a new state.

pub fn release(&self) -> Result<(), Error>

Release resources.

pub fn memory(&self) -> &LyteMemory

Access the underlying LyteMemory for this Barrel (all Bottles use the same LyteMemory).

pub async fn call<O, F: FnOnce(&[u8]) -> Result<O, Error>>( &self, method: &str, input: &[u8], output_decoder: F, abi: InputABI, ) -> Result<O, Error>

Call the given Lyquid function with raw input and customized output decoder.

pub async fn call_network_func( &self, params: CallParams, ) -> Result<Vec<u8>, Error>

Make a network call with raw input and output.

pub async fn call_instance_func( &self, params: CallParams, ) -> Result<Vec<u8>, Error>

Make an instance call with raw input and output.

pub async fn call_instance_func_decoded<O: for<'a> Deserialize<'a>>( &self, params: CallParams, ) -> Result<O, Error>

Make an instance call with typed input and output.

pub fn host(&self) -> &H