20 releases
0.7.1 | Apr 29, 2022 |
---|---|
0.7.0 | Feb 23, 2022 |
0.6.7 |
|
0.6.5 | Jun 8, 2021 |
0.4.2 | Nov 12, 2020 |
#2 in #canon
85 downloads per month
Used in 18 crates
(17 directly)
28KB
668 lines
Canonical
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
~0.4–5MB
~10K SLoC