This is an example of running iroh thorugh exitsm as a set of host functions. It's written entirely in rust, but the purpose is to show how one would build an API that any plugin could use to gain access to a plugin-host-provided iroh instance.
You'll need the latest version of the rust toolchain, and the wasm32-unknown-unknown target. Install it with:
rustup target add wasm32-unknown-unknown
There are three
- Build the WASM plugin
- Get a blob ticket
- run the host
cd to extism/plugin and run cargo build --target wasm32-unknown-unknown. If you get an error, check the requirements section above. This will generate a WASM plugin that actually calls the blob download host function.
This example needs a Raw blob ticket, which you can get from iroh blob add on a raw file, or just use this one, which should be hosted on iroh.network:
blobabk62aofuwwwu5zb5ocvzj5v3rtqt6siglyuhoxhqtu4fxravvoteajcnb2hi4dthixs65ltmuys2mjomrsxe4bonfzg62bonzsxi53pojvs4lydaac2cyt22erablaraaa5ciqbfiaqj7ya6cbpuaaaaaaaaaaaahjceagucztuhgez4qucv2733xphmgpc2nkgj54od2vuygn6sz4zzxo6ce
(it's a text file that says hello)
The host code will actually call the example. cd to ./extism/host and run
cargo run <TICKET>
pasting in the ticket you'd like to fetch. It'll fetch the bytes & print it out, proving this host can provide iroh to extism plugins!
What would be truly neat would be to reverse the direction, and write a plugin that brings iroh to a host. For that we'd need to be able to compile some/all of iroh to WASM, which we're working on.
This project is licensed under either of
- Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this project by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.