36 releases (stable)

1.19.1 Jul 11, 2024
1.16.0 Mar 26, 2024
1.12.0 Nov 25, 2023
1.8.0 Jul 24, 2023
0.0.2 Oct 27, 2020

#29 in WebAssembly

Download history 557/week @ 2024-04-04 894/week @ 2024-04-11 852/week @ 2024-04-18 396/week @ 2024-04-25 436/week @ 2024-05-02 267/week @ 2024-05-09 422/week @ 2024-05-16 4/week @ 2024-05-23 576/week @ 2024-05-30 205/week @ 2024-06-06 615/week @ 2024-06-13 511/week @ 2024-06-20 295/week @ 2024-06-27 325/week @ 2024-07-04 520/week @ 2024-07-11 557/week @ 2024-07-18

1,701 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

~13–26MB
~410K SLoC