Skip to main content

Go

Compiling your application​

Since Go 1.21, you can natively compiled Go applications to WebAssembly using the wasip1 GOOS:

GOOS=wasip1 GOARCH=wasm go build -o app.wasm <path/to/main/pkg>

If you prefer using TinyGo:

tinygo build -o app.wasm -target=wasi <path/to/main/pkg>

This will build a WebAssembly module that can be run with Timecraft.

Running your application with Timecraft​

To run your application:

timecraft run app.wasm

Command-line arguments can be specified after the WebAssembly module. To prevent Timecraft from interpreting command-line options for the application, use:

timecraft run -- app.wasm arg1 arg2 ...
info

Note that -- is optional but considered a best practice to separate runtime arguments and application arguments.

Note that environment variables passed to Timecraft are automatically passed to the WebAssembly module.

Networking applications​

You may quickly find that the networking capabilities of GOOS=wasip1 are limited.

We have created a library to help with common use cases, such as creating HTTP servers and connecting to databases. See github.com/stealthrocket/net for usage details.

Let's go over a quick example.

Simple HTTP server listening on http://localhost:3000
loading...

In this example, we create a listener using WASI as well as the WasmEdge extension in order to serve incoming HTTP request through the WASI layer.

To build it and run it with the following commands:

GOOS=wasip1 GOARCH=wasm go build -o server.wasm main.go
timecraft run server.wasm

You should be able to use curl to query the server: curl http://localhost:3000

Check out the github.com/stealthrocket/net to see more use cases.