Expand description
Versioned WIT ABI and guest SDK for Rill runtime handlers.
This crate ships the canonical WIT world definition
(wit/rill-handler.wit)
that every Rill handler must export.
Handler authors compile a Rust crate to wasm32-wasip1 using
wit-bindgen to generate guest
bindings from the WIT file, then wrap the core module into a Component
Model component with wasm-tools component new.
This crate intentionally has no dependencies so that it can be consumed as a build-time WIT source without pulling in any runtime code. The constants below mirror the WIT declarations and are used by both the host and guest for compile-time version checks.
Constantsยง
- HANDLER_
API_ VERSION - Handler ABI version. Independent from the host IPC API version and the model pack format version. Increment only on a breaking WIT change.
- MAX_
CAPABILITIES - Maximum number of capabilities a handler may declare.
- MAX_
CAPABILITY_ LEN - Maximum length of a capability string.
- MAX_
HANDLER_ ID_ LEN - Maximum length of a handler id.
- MAX_
HANDLER_ VERSION_ LEN - Maximum length of a handler version string.
- WIT_
PACKAGE - WIT package name as declared in
rill-handler.wit. - WIT_
VERSION - WIT package version as declared in
rill-handler.wit. - WIT_
WORLD - WIT world name as declared in
rill-handler.wit.