ag_id 0.1.0

Ag^id — deterministic identifiers that survive platform translation
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87

#![allow(clippy::doc_markdown)]
//! Print canonical vectors to stdout. Run via:
//!   cargo test --test vector_export -- --nocapture print_vectors
//!
//! The output is consumed by `test-vectors/v1.json` and any re-implementation
//! in another language.

use ag_id::{DeriveDomain, Did};

fn hex(bytes: &[u8; 32]) -> String {
    use core::fmt::Write as _;
    let mut s = String::with_capacity(64);
    for b in bytes {
        let _ = write!(s, "{b:02x}");
    }
    s
}

#[derive(Clone, Copy)]
struct V {
    name: &'static str,
    domain: DeriveDomain,
    input: &'static [u8],
}

const VECTORS: &[V] = &[
    V {
        name: "user_alice_at_example",
        domain: DeriveDomain::User,
        input: b"alice@example.com",
    },
    V {
        name: "golden_v1_anchor",
        domain: DeriveDomain::User,
        input: b"agid:golden:v1",
    },
    V {
        name: "empty_input_user",
        domain: DeriveDomain::User,
        input: b"",
    },
    V {
        name: "unicode_cyrillic",
        domain: DeriveDomain::User,
        // UTF-8 bytes for "Михаил"
        input: "Михаил".as_bytes(),
    },
    V {
        name: "domain_separation_user",
        domain: DeriveDomain::User,
        input: b"same-input",
    },
    V {
        name: "domain_separation_document",
        domain: DeriveDomain::Document,
        input: b"same-input",
    },
    V {
        name: "domain_separation_session",
        domain: DeriveDomain::Session,
        input: b"same-input",
    },
    V {
        name: "custom_domain_0xff",
        domain: DeriveDomain::Custom(core::num::NonZeroU8::MAX),
        input: b"some-input",
    },
    V {
        name: "long_input_1024_zeros",
        domain: DeriveDomain::Document,
        input: &[0u8; 1024],
    },
];

#[test]
fn print_vectors() {
    println!();
    println!("{:30}  {:8}  raw_hex                                                            did_string", "name", "domain");
    println!("{:-<150}", "");
    for v in VECTORS {
        let did = Did::derive(v.domain, v.input);
        let raw = hex(did.as_bytes());
        let s = did.to_did_string();
        let dom = format!("{:?}", v.domain);
        println!("{:30}  {dom:8}  {raw}  {s}", v.name);
    }
}