Add a minimal TinyGo guest example - #98
Open
AndyFerns wants to merge 5 commits into
Open
Conversation
GianIac
requested changes
Aug 11, 2026
Owner
There was a problem hiding this comment.
Thanks a lot for the PR! the README is honest about the -target wasi / -opt=0 trade-offs, the Windows + Unix scripts are a nice extra, and using //go:wasmimport / //go:export is exactly the right approach.
A few small things before merge:
Small fixes
- Please add a trailing newline to the new files (all 5 are missing it, some linters/pre-commit hooks complain).
- Could you set the executable bit on
build.shdirectly in the commit? That way users don't need thechmod +xstep from the README. From your side:git update-index --chmod=+x examples/guest_tinygo/build.sh
Please add two short notes to the README
- Because of
-target wasi, the module also importswasi_snapshot_preview1in addition to thenxnamespace. Worth calling that out so readers know the import surface is larger than the AssemblyScript/Zig examples. stringToWasmPtrtakes the address of a heap-allocated[]byteand passes it to the host. It works with TinyGo's default GC onwasi, but a one-line caveat about GC / pointer lifetime would be great (or, if you feel like it, switch to a static[]byteglobal — no pressure though).
Not blocking
- Other recent guest examples (AssemblyScript #95, Zig #97) added a CI job that builds and smoke-tests the module. Not asking you to do it here. I'll open a follow-up issue for CI coverage after merge.
Once the small fixes above are in, happy to merge. Thanks again !
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds a new Guest example for TinyGo performing simple logging and KV access
Additions
A TinyGo guest (living under the src/ subdir) that exports
runand importshost_log_v2anddb_setfrom thenxnamespace.uint32pointers/lengths).build.bat) and Linux/macOS (build.sh) build scripts.notes
//go:wasmimportand//go:exportdirectives to keep the WASM ABI clean (no C-esque name mangling)-target wasito prevent TinyGo from injecting JS-specific runtime hooks (which previously causedgojs::runtime.tickslinking errors)-opt=0) in the build scripts so users don't strictly needwasm-opt(Binaryen) installed on their machines just to run the example.Closes #51