6 releases (3 breaking)

0.6.2 May 25, 2021
0.6.0 Mar 30, 2021
0.5.0 Jan 19, 2021
0.4.0 Oct 21, 2020
0.2.1 Oct 16, 2020

#150 in WebAssembly

42 downloads per month
Used in 2 crates

MPL-2.0 license

6MB
838 lines

Canonical

Build Status Repository Documentation

Canonical is a specialized serialization library built for merkle trees and suitable for wasm environments.

Its main component is the Canon trait, which specifies how the type is encoded to/read from bytes.

This allows you, for example, to easily pass complex sets containing millions of elements between different wasm modules.

identifiers

Each value of a type implementing the Canon trait has a 1:1 relation to an Id.

let a = 42;

let id = Id::new(&a);

assert_eq!(id.reify().expect("read back"), a);

The Repr<T> is a smart-pointer type that either owns the value, contains a cryptographic hash of the value, or both. This allows you to construct recursive data types, that can also effeciently be stored and accessed as merkle trees.

canonical_derive

In order not to have to write all this byte-counting code by hand, canonical includes a derive-macro to implement them for you.

#[derive(Canon, PartialEq, Debug)]
struct A2 {
    a: u8,
    b: u8,
}

canonical_fuzz

A simple fuzzer built on top of the arbitrary crate. Allows you to fuzz the canon encoding for types, helpful if you choose to implement custom encodings.

The fuzzer also checks that the reported length of the value is correct with what is being written.

Dependencies