Crate wasmtime_wasi_http

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.

Modules

• bindings
  Raw bindings to the wasi:http package.
• body
  Implementation of the wasi:http/types interface’s various body types.
• io
  I/O utility for bridging between tokio::io and hyper::rt.
• proxy
  Implementation of the wasi:http/proxy world.
• types
  Implements the base structure (i.e. WasiHttpCtx) that will provide the implementation of the wasi-http API.

Structs

• HttpError
  A wasi:http-specific error type used to represent either a trap or an ErrorCode.
• WasiHttpCtx
  Capture the state necessary for use in the wasi-http API implementation.

Traits

• WasiHttpView
  A trait which provides internal WASI HTTP state.

Functions

• http_request_error
  Translate a http::Error to a wasi-http ErrorCode in the context of a request.
• hyper_request_error
  Translate a hyper::Error to a wasi-http ErrorCode in the context of a request.
• hyper_response_error
  Translate a hyper::Error to a wasi-http ErrorCode in the context of a response.

Type Aliases

• HttpResult
  A Result type where the error type defaults to HttpError.