Self-Addressing Identifier

Self-Addressing Identifier (SAI) provides a compact text representation of digests of data. It supports multiple hash algorithms.

Self Addressing Identifier is base64 encoded hash of data, prepended with one or two letter prefix, called derivation code. Derivation code determines which hash algorithm was used to derive the digest.

License

EUPL 1.2

We have distilled the most crucial license specifics to make your adoption seamless: see here for details.

Usage

To derive Self Addressing Identifier, SelfAddressing enum can be used. It determines hashing algorithm used for Identifier derivation. Here are its possible values:

pub enum SelfAddressing {
    Blake3_256,
    Blake2B256(Vec<u8>),
    Blake2S256(Vec<u8>),
    SHA3_256,
    SHA2_256,
    Blake3_512,
    SHA3_512,
    Blake2B512,
    SHA2_512,
}

verify_bindings function checks if provided data matches digest encoded in Self Addressing Identifier.

Example

let data = "hello there";
let sai = SelfAddressing::Blake3_256.derive(data.as_bytes());

assert_eq!(format!("{}", sai), "ENmwqnqVxonf_bNZ0hMipOJJY25dxlC8eSY5BbyMCfLJ");
assert!(sai.verify_binding(data.as_bytes()));
assert!(!sai.verify_binding("wrong data".as_bytes()));

wasm

bindings/sai_wasm directory contains a project which allows to compile sai library to wasm.

Releasing new version

cargo-release is required

To release new version run cargo release

Due to release config it will bump version, create new git tag and push it to remote.