Skip to content
/ as-guest Public

SDK for creating waPC WebAssembly Guest Modules in AssemblyScript

License

Notifications You must be signed in to change notification settings

wapc/as-guest

Repository files navigation

waPC Guest Library for AssemblyScript

This is the AssemblyScript implementation of the waPC standard for WebAssembly guest modules. It allows any waPC-compliant WebAssembly host to invoke to procedures inside a AssemblyScript compiled guest and similarly for the guest to invoke procedures exposed by the host.

Example

The following is a simple example of synchronous, bi-directional procedure calls between a WebAssembly host runtime and the guest module.

import {
  register,
  handleCall,
  hostCall,
  handleAbort,
  Result,
} from "../assembly";

register("hello", function (payload: ArrayBuffer): Result {
  hostCall("myBinding", "sample", "hello", String.UTF8.encode("Simon"));
  return Result.ok(String.UTF8.encode("Hello"));
});

// This must be present in the entry file. Do not remove.

export function __guest_call(operation_size: usize, payload_size: usize): bool {
  return handleCall(operation_size, payload_size);
}

function abort(message: string | null, fileName: string | null, lineNumber: u32, columnNumber: u32): void {
  handleAbort(message, fileName, lineNumber, columnNumber)
}
asc example/hello.ts -b example/hello.wasm --use abort=example/hello/abort --validate --optimize