cosmonic-hedge

This actor takes an incoming HTTP request and returns a simple HTTP response.

This is very similar to the echo example in the tinygo actor sdk. Feel free to experiment with the code to see how you can change the HTTP response easily.

Building

To build this actor and sign the WebAssembly file, run make.

Make sure the wasmcloud host is running (and a registry and a nats server) as described in Getting Started

Start an http server provider and link it to your actor. This only needs to be done once, even if you test multiple iterations of your actor.

make provider
make link

To run your actor, issue the following commands

# push the signed wasm to your OCI registry
make push
# start the actor
make start

To test it,

curl -v localhost:8085/abc

It should print the response "hello" on your console.

How do I customize this template to use other contracts & interfaces?

• You can change what contracts this actor claims in wasmcloud.toml and the Makefile. In the future this will just be in wasmcloud.toml.
• You will then need to change the dependencies in go.mod to import the interfaces for the contracts you want. Delete the github.com/wasmcloud/interfaces/httpserver/tinygo dep if you're not using that contract.
• Finally, change the echo.go file, changing/deleting the current interface import, HttpServerHandler, and HandleRequest function, while adding a new import & Handler & implementation function for any contracts you added!

Using the included Github Actions

The generated project include two GitHub actions: build.yml and release.yml under .github/workflows. The build action will automatically build, lint, and check formatting for your actor. The release action will automatically release a new version of your actor whenever code is pushed to main, or when you push a tag with the form vX.Y.Z.

These actions require 3 secrets

1. WASH_ISSUER_KEY, which can be generated with wash keys gen issuer, then look for the 58 character Seed value
2. WASH_SUBJECT_KEY, which can be generated with wash keys gen module, then look for the 58 character Seed value
3. WASMCLOUD_PAT, which can be created by following the Github PAT instructions and ensuring the write:packages permission is enabled