33 releases (stable)

1.16.0 Mar 26, 2024
1.13.0 Jan 9, 2024
1.12.0 Nov 25, 2023
1.8.0 Jul 24, 2023
0.0.2 Oct 27, 2020

#29 in WebAssembly

Download history 33/week @ 2023-12-23 67/week @ 2023-12-30 388/week @ 2024-01-06 447/week @ 2024-01-13 391/week @ 2024-01-20 472/week @ 2024-01-27 552/week @ 2024-02-03 363/week @ 2024-02-10 384/week @ 2024-02-17 736/week @ 2024-02-24 897/week @ 2024-03-02 986/week @ 2024-03-09 705/week @ 2024-03-16 404/week @ 2024-03-23 700/week @ 2024-03-30 495/week @ 2024-04-06

2,482 downloads per month
Used in 3 crates (2 directly)

Apache-2.0

39KB
816 lines

Wasmtime Engine Provider

crates.io license

This is a pluggable engine provider for the waPC RPC exchange protocol. This engine implements WebAssemblyEngineProvider for the the Bytecode Alliance's wasmtime WebAssembly runtime.

Running ping demo

$ cargo run -p wasmtime-provider --example wasmtime-demo ./wasm/crates/wasm-basic/build/wasm_basic.wasm ping "hi"

Running codec and module hotswapping demo

cargo run -p wasmtime-provider --example wasmtime-hash-mreplace AlexName 

Example

use wasmtime_provider::WasmtimeEngineProviderBuilder;
use wapc::WapcHost;
use std::error::Error;

pub fn main() -> Result<(), Box<dyn Error>> {

  // Sample host callback that prints the operation a WASM module requested.
  let host_callback = |id: u64, bd: &str, ns: &str, op: &str, payload: &[u8]| {
    println!("Guest {} invoked '{}->{}:{}' with a {} byte payload",
    id, bd, ns, op, payload.len());
    // Return success with zero-byte payload.
    Ok(vec![])
  };

  let file = "../../wasm/crates/wasm-basic/build/wasm_basic.wasm";
  let module_bytes = std::fs::read(file)?;

  let engine = WasmtimeEngineProviderBuilder::new()
    .module_bytes(&module_bytes)
    .build()?;
  let host = WapcHost::new(Box::new(engine), Some(Box::new(host_callback)))?;

  let res = host.call("ping", b"payload bytes")?;
  assert_eq!(res, b"payload bytes");

  Ok(())
}

See also

Dependencies

~10–26MB
~396K SLoC