Crate wasmtime_wasi_http

source ·
Expand description

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.
  • WasiHttpImpl
    A concrete structure that all generated Host traits are implemented for.

Traits§

  • WasiHttpView
    A trait which provides internal WASI HTTP state.

Functions§

Type Aliases§