canonical

Crates.iocanonical
lib.rscanonical
version0.7.1
sourcesrc
created_at2020-09-24 19:02:30.468482
updated_at2022-04-29 08:51:11.930327
descriptionA serialization library built for no_std environments where you want to deal with recursive datastructures.
homepage
repositoryhttps://github.com/dusk-network/canonical
max_upload_size
id292614
size53,091
Dusk Network (dusknetwork)

documentation

README

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.

Commit count: 210

cargo fmt