22 releases

0.0.22 Apr 19, 2024
0.0.21 Apr 16, 2024
0.0.16 Mar 30, 2024
0.0.7 Feb 23, 2024

#314 in WebAssembly

Download history 164/week @ 2024-02-12 233/week @ 2024-02-19 488/week @ 2024-02-26 434/week @ 2024-03-04 58/week @ 2024-03-11 622/week @ 2024-03-18 491/week @ 2024-03-25 476/week @ 2024-04-01 537/week @ 2024-04-08 739/week @ 2024-04-15 199/week @ 2024-04-22 52/week @ 2024-04-29 174/week @ 2024-05-06 202/week @ 2024-05-13

645 downloads per month
Used in 6 crates (5 directly)

Apache-2.0

270KB
6K SLoC

golem-wasm-rpc

Defines data types for Golem's remote function invocation and conversions between them.

  • WitValue is the WIT-defined generic data type capable of representing an arbitrary value, generated by wit-bindgen
  • A builder and an extractor API for WitValue
  • Value is a recursive Rust type which is more convenient to work with than WitValue. Conversion between WitValue and Value is implemented in both directions.
  • Protobuf message types for describing values and types, and a protobuf version of WitValue itself and conversion from and to Value and WitValue
  • JSON representation of WIT values, as defined in the Golem docs.
  • Conversion of Value to and from wasmtime values

The JSON representation requires additional type information which can be extracted using the golem-wasm-ast crate.

Host and stub mode

The golem-wasm-rpc crate can be both used in host and guest environments:

To compile the host version:

cargo build -p wasm-rpc --no-default-features --features host

To compile the guest version, has minimal dependencies and feature set to be used in generated stubs:

cargo component build -p wasm-rpc --no-default-features --features stub

Feature flags

  • arbitrary adds an Arbitrary instance for Value
  • json adds conversion functions for mapping of a WIT value and type definition to/from JSON
  • protobuf adds the protobuf message types
  • wasmtime adds conversion to wasmtime Val values
  • host enables all features: arbitrary, json, protobuf, typeinfo, and wasmtime
  • stub is to be used in generated WASM stubs and disables all features, and generates guest bindings instead of host bindings

Dependencies

~3–17MB
~241K SLoC