Wasmtime's WASI HTTP Implementation

This crate's implementation is primarily built on top of [hyper].

WASI HTTP Interfaces

This crate contains implementations of the following interfaces:

• wasi:http/incoming-handler
• wasi:http/outgoing-handler
• wasi:http/types

The crate also contains an implementation of the wasi:http/proxy world.

All traits are implemented in terms of a [WasiHttpView] trait which provides basic access to [WasiHttpCtx], configuration for WASI HTTP, and a [wasmtime_wasi::ResourceTable], the state for all host-defined component model resources.

Examples

Usage of this crate is done through a few steps to get everything hooked up:

1. First implement [WasiHttpView] for your type which is the T in [wasmtime::Store<T>].
2. Add WASI HTTP interfaces to a [wasmtime::component::Linker<T>]. This is either done through functions like [proxy::add_to_linker] (which bundles all interfaces in the wasi:http/proxy world together) or through individual interfaces like the [bindings::http::outgoing_handler::add_to_linker_get_host] function.
3. Use the previous [wasmtime::component::Linker<T>::instantiate] to instantiate a [wasmtime::component::Component] within a [wasmtime::Store<T>]. If you're targeting the wasi:http/proxy world, you can instantiate the component with [proxy::Proxy::instantiate_async] or [proxy::sync::Proxy::instantiate] functions.