uor-addr 0.2.0

UOR-ADDR — the typed reference vocabulary for content-addressing across recursively-grammared formats. Standard-library Layer-3 Prism realization of the UOR Foundation; ships the common architectural surface plus the JSON realization under JCS-RFC8785 + NFC + SHA-256.
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

//! `uor-addr` — Common architectural surface comprehensive example.
//!
//! Demonstrates the shared surface every format-specific UOR-ADDR
//! realization exposes (ADR-060): a host-boundary `address(raw)` entry
//! point that parses, canonicalizes, and folds the typed-input bytes
//! into the common [`uor_addr::AddressOutcome`] shape (a `KappaLabel`
//! plus a verifiable [`uor_addr::AddressWitness`]).
//!
//! Run with `cargo run -p uor-addr --example common_surface`.

fn show_outcome(
    name: &str,
    address: &uor_addr::KappaLabel<71>,
    witness: &uor_addr::AddressWitness<71>,
) {
    println!("─── {name} ─────────────────────────────────────");
    println!("   κ-label:              {address}");
    println!(
        "   content fingerprint:  {} bytes",
        witness.content_fingerprint().len()
    );

    // The witness re-derives the κ-label without re-invoking SHA-256 on
    // the original input; the recovered label must match.
    let recovered = witness.verify().expect("witness verifies");
    assert_eq!(
        &recovered, address,
        "verified κ-label matches minted address"
    );
    println!("   witness verifies:     yes\n");
}

fn main() {
    println!("uor-addr — common architectural surface (address entry points)\n");

    println!("Every realization exposes a host-boundary `address(raw)` that");
    println!("yields the common AddressOutcome shape:\n");
    println!("    pub struct AddressOutcome {{");
    println!("        pub address: KappaLabel,");
    println!("        pub witness: AddressWitness,");
    println!("    }}\n");

    // Walk every format-specific realization through its `address` entry.
    let o = uor_addr::json::address(br#"{"x":1}"#).expect("valid json");
    show_outcome("json", &o.address, &o.witness);

    let o = uor_addr::sexp::address(b"(a b c)").expect("valid sexp");
    show_outcome("sexp", &o.address, &o.witness);

    let o = uor_addr::xml::address(b"<root/>").expect("valid xml");
    show_outcome("xml", &o.address, &o.witness);

    let o = uor_addr::asn1::address(&[0x02, 0x01, 0x2A]).expect("valid der");
    show_outcome("asn1", &o.address, &o.witness);

    let o = uor_addr::ring::address(&[0u8, 0x42]).expect("valid ring element");
    show_outcome("ring", &o.address, &o.witness);

    let m = uor_addr::codemodule::CodeModuleValue::module("demo", &[]);
    let o = uor_addr::codemodule::address(m.tagged_bytes()).expect("valid ast");
    show_outcome("codemodule", &o.address, &o.witness);

    println!("OK — every realization exposes the common AddressOutcome surface.");
}