Module wasmtime::component::bindgen_examples::_2_world_exports

Available on crate feature runtime and crate feature component-model and docsrs only.

An example of generated bindings for top-level exported functions for a world.

Some notable generated items here are:

• my::project::host::Host - the generated trait for the interface host import.
• exports::demo::Guest - the generated structured used to invoke exports on the returned instance.
• HelloWorld - the overall generated structure representing our world.

use wasmtime::component::*;
use wasmtime::{Engine, Store};

bindgen!({
    inline: r#"
        package my:project;

        interface host {
            gen-random-integer: func() -> u32;
            sha256: func(bytes: list<u8>) -> string;
        }

        world hello-world {
            import host;

            export demo: interface {
                run: func();
            }
        }
    "#,
});

struct MyState {
    // ...
}

// Note that the trait here is per-interface and within a submodule now.
impl my::project::host::Host for MyState {
    fn gen_random_integer(&mut self) -> u32 {
        rand::thread_rng().gen()
    }

    fn sha256(&mut self, bytes: Vec<u8>) -> String {
        // ...
    }
}

fn main() -> wasmtime::Result<()> {
    let engine = Engine::default();
    let component = Component::from_file(&engine, "./your-component.wasm")?;

    let mut linker = Linker::new(&engine);
    HelloWorld::add_to_linker(&mut linker, |state: &mut MyState| state)?;

    let mut store = Store::new(
        &engine,
        MyState { /* ... */ },
    );
    let bindings = HelloWorld::instantiate(&mut store, &component, &linker)?;

    // Note that the `demo` method returns a `&exports::Demo::Guest`
    // through which we can run the methods on that interface.
    bindings.demo().call_run(&mut store)?;
    Ok(())
}

Modules

• exports
• my

Structs

• HelloWorld
  Auto-generated bindings for an instance a component which implements the world hello-world.
• HelloWorldIndices
  Auto-generated bindings for index of the exports of hello-world.
• HelloWorldPre
  Auto-generated bindings for a pre-instantiated version of a component which implements the world hello-world.