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

//! Round-trip example: produce a `did:agid:` string, transmit it, parse it back.
//!
//! Run with:
//!   cargo run --example parsing

use ag_id::{DeriveDomain, Did};

fn main() {
    let typed = Did::derive(DeriveDomain::User, b"alice@example.com");
    let s = typed.to_did_string();
    println!("produced:  {s}");

    // Parse it back. Domain is irrecoverable — we get Domain::Opaque.
    let parsed: Did = s.parse().expect("valid did:agid string");
    println!("parsed:    {parsed}  domain={}", parsed.domain());

    // Byte equality: parsed and typed agree.
    assert!(typed.eq_bytes(&parsed));
    println!("eq_bytes:  ✓");

    // PartialEq compares both bytes AND domain, so direct == differs:
    assert_ne!(typed, parsed);
    println!("PartialEq is stricter: typed ≠ opaque (by design)");

    // Demonstrate parse failures.
    println!("\nparse failures:");
    for s in [
        "did:other:abc",
        "did:agid:",
        "did:agid:O0Il",
        "did:agid:thisIsTooLongForA32ByteHashEncodedInBase58000000",
    ] {
        match s.parse::<Did>() {
            Ok(_) => println!("  {s:>50}  unexpectedly parsed"),
            Err(e) => println!("  {s:>50}  → {e}"),
        }
    }
}