Important
The examples in this repository are WebAssembly modules which consume interfaces defined in Smithy and communicate with providers over the stable ABI. Actors built as WebAssembly components consume interfaces defined using WIT. Examples of actor components can be found in the wasmCloud repo. Note that support for WIT is considered experimental at this time.
Example actors, capability providers, and other demonstrations
The following actors run as WebAssembly on wasmCloud hosts.
| Example | Description | OCI Reference (refer to example for latest version) |
|---|---|---|
| animal-image-downloader | An actor that receives messages and makes HTTP requests, downloading a picture of an animal to a blobstore | wasmcloud.azurecr.io/animal-image-downloader |
| echo | An actor that listens on an HTTP port and returns a JSON payload describing the incoming request | wasmcloud.azurecr.io/echo |
| echo-messaging | An actor that listens on a message broker topic and replies | wasmcloud.azurecr.io/echo-messaging |
| hello | Canonical "hello world" actor that listens on an HTTP port and replies with a greeting | wasmcloud.azurecr.io/hello |
| kvcounter | An actor that uses the key-value store to increment a counter and return a value for every HTTP request it receives | wasmcloud.azurecr.io/kvcounter |
| logging | An actor that demonstrates the builtin logging capability provider | wasmcloud.azurecr.io/logging |
| message-pub | An actor that demonstrates receiving HTTP requests and publishing the request body as a message | wasmcloud.azurecr.io/message-pub |
| random | An actor that demonstrates the builtin random number generation capability provider | wasmcloud.azurecr.io/random |
| todo-sql | An todo-application using sql database, https server (with TLS), logging, and numbergen | (unpublished) |
| todo | An todo-application using keyvalue store, http server, and logging | (unpublished) |
| xkcd | A application that generates xkcd comics | wasmcloud.azurecr.io/xkcd |
| ifconfig | A tinygo actor that will return the external IP address of your http client | (unpublished) |
The following example interfaces are defined by Smithy models.
| Example | Description | Capability contract | Rust crate |
|---|---|---|---|
| cron | A simple interface for invoking an actor at a specific time | wasmcloud:example:cron |
wasmcloud-interface-cron |
| payments | A simple interface for a payments capability provider (used in the Creating an Interface tutorial) | wasmcloud:example:payments |
wasmcloud-examples-payments |
| runner | A simple interface with a single 'Run' method | wasmcloud:example:runner |
wasmcloud-examples-runner |
| timing | A simple interface for retrieving the current timestamp from the host | wasmcloud:timing |
wasmcloud-interface-timing |
Providers of capabilities for wasmCloud actors
| Example | Description | Capability contract | OCI Reference |
|---|---|---|---|
| cron | A capability provider that uses cron expressions to invoke actors on a timed interval | wasmcloud:example:cron |
wasmcloud.azurecr.io/cron |
| factorial | A capability provider that computes factorial of a number | wasmcloud:example:payments |
wasmcloud.azurecr.io/factorial |
| fakepay | A simple payment provider, used in the Creating a capability provider tutorial | wasmcloud:example:fakepay |
wasmcloud.azurecr.io/fakepay |
| timing | An implementation of the wasmcloud:timing capability contract |
wasmcloud:timing |
| Example | Description |
|---|---|
| petclinic | A WebAssembly and wasmCloud-based reimagining of the classic Spring Boot microservices Pet Clinic. The wasmCloud Pet Clinic consists of multiple actors, and uses a relational database capability provider and an http server capability provider. |
| adsb | A FlightAware clone that allows users to take an RTL-SDR and plot airplane data on a map. Users can also cluster many RTL-SDRs from all over the country and visualize them together utilizing the power of the wasmCloud lattice. |