Module go.bytecodealliance.org/pkg is the Go library for Wasm components. It adapts standard-library interfaces (net/http, log/slog) to standard wasi:* interfaces and ships the committed bindings and WIT worlds needed to build HTTP components with componentize-go. The use of this package significantly reduces the number of files generated and committed for a typical go application.

The library targets two worlds defined in wit/world.wit:

• bytecodealliance:pkg/wasip2 (default): a sync WASI P2 component exporting wasi:http/incoming-handler@0.2.8, buildable with stock Go.
• bytecodealliance:pkg/wasip3 (opt-in): an async WASI P3 component exporting wasi:http/handler@0.3.0 with streaming bodies and native concurrency.

Bindings under imports/ and exports/ are generated by regenerate_bindings.sh — do not edit them.

The wasi:* WIT packages under wit/deps/ are vendored verbatim from the WebAssembly package registry using wkg. To update a dependency:

1. Bump its version in fetch_wit_deps.sh and in wit/world.wit.

2. Re-fetch the vendored WIT:

   $ ./fetch_wit_deps.sh

3. Regenerate the committed bindings and commit everything together:

   $ ./regenerate_bindings.sh

Note: the script uses wkg get with exact versions rather than wkg wit fetch because the library intentionally depends on two versions of several packages (e.g. wasi:http@0.2.8 and wasi:http@0.3.0), and wkg wit fetch resolves at most one version per package name.

wasihttp compiles to one of two implementations; the exported API is identical under both:

• Default (no tag): sync WASI P2 (wasi:http@0.2.8). Matches the bytecodealliance:pkg/wasip2 world.
• -tags componentizego_async: async WASI P3 (wasi:http@0.3.0) with streaming bodies and native concurrency. Matches the bytecodealliance:pkg/wasip3 world.

componentize-go sets the tag automatically when building an async world.

package main

import (
	"net/http"

	"go.bytecodealliance.org/pkg/wasihttp"
)

func init() {
	wasihttp.HandleFunc(func(w http.ResponseWriter, r *http.Request) {
		w.Write([]byte("Hello, component!"))
	})
}

func main() {}

Add componentize-go as a Go tool and build:

$ go get -tool github.com/bytecodealliance/componentize-go
$ go tool componentize-go build

The default world (bytecodealliance:pkg/wasip2@0.1.0) is declared in componentize-go.toml and discovered automatically. To build the async WASI P3 world instead:

$ go tool componentize-go -w bytecodealliance:pkg/wasip3 build

Pure-Go conversion logic (header conversion and friends) has microbenchmarks that run on the host:

$ go test -bench=. -benchmem ./...

Packages that call wasi:* imports only link on wasm targets, so the benchmarks live in host-compilable packages (e.g. internal/httpconv).

For A/B comparisons use benchstat: collect ≥10 samples per side with the test filter disabled, then compare:

$ go test -bench=. -benchmem -count=10 -run='^$' ./... > old.txt
$ # ... apply your change ...
$ go test -bench=. -benchmem -count=10 -run='^$' ./... > new.txt
$ benchstat old.txt new.txt

Ask over in the Bytecode Alliance Zulip.

See CONTRIBUTING.md for more information about contributing to this repository.