Struct ContentAddress 

pub struct ContentAddress { /* private fields */ }

v0.2.2 T4.2: sealed content-addressed handle. Wraps a 128-bit identity used for BindingsTable lookups and as a compact identity handle for Grounded values. The underlying u128 is visible via as_u128() for interop. Distinct from ContentFingerprint (the parametric-width fingerprint computed by the substrate Hasher — see T5.C3.d below): ContentAddress is a fixed 16-byte sortable handle, while ContentFingerprint is the full substrate-computed identity that round-trips through verify_trace.

Implementations

impl ContentAddress

pub const fn zero() -> Self

The zero content address. Used as the “unset” placeholder in BindingsTable lookups, the default state of an uninitialised Grounded::unit_address, and the initial seed of replay folds.

pub const fn as_u128(&self) -> u128

Returns the underlying 128-bit content hash.

Examples found in repository

examples/static_bindings_catalog.rs (line 71)

fn main() {
    println!("Static BindingsTable with {} entries:", TABLE.entries.len());
    for entry in TABLE.entries {
        println!(
            "  address={:?} bytes={:?}",
            entry.address,
            core::str::from_utf8(entry.bytes).expect("surface is utf8")
        );
    }

    // Lookup: binary search by address (BindingsTable entries are sorted).
    let lookup_addr = BINDINGS[1].to_binding_entry().address;
    let found = TABLE
        .entries
        .binary_search_by_key(&lookup_addr.as_u128(), |e| e.address.as_u128())
        .map(|idx| &TABLE.entries[idx]);

    match found {
        Ok(entry) => println!(
            "Lookup found: {:?}",
            core::str::from_utf8(entry.bytes).unwrap_or("?")
        ),
        Err(_) => println!("Lookup miss"),
    }
}

pub const fn is_zero(&self) -> bool

Whether this content address is the zero handle.

pub const fn from_u128(raw: u128) -> Self

v0.2.2 T5.C1: public ctor. Promoted from pub(crate) in T5 so downstream tests can construct deterministic ContentAddress values for fixture data without going through the foundation pipeline.

pub const fn from_u64_fingerprint(fingerprint: u64) -> Self

v0.2.2 Phase P.3: construct a ContentAddress from a u64 FNV-1a fingerprint by right-padding the value into the 128-bit address space. Used by Binding::to_binding_entry to bridge the Binding.content_address: u64 carrier to the BindingEntry.address: ContentAddress (u128-backed) shape. The lift is raw = (fingerprint as u128) << 64 — upper 64 bits carry the FNV-1a value; lower 64 bits are zero. Content-deterministic; round-trips via ContentAddress::as_u128() >> 64 back to the original u64.

Trait Implementations

impl Clone for ContentAddress

fn clone(&self) -> ContentAddress

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ContentAddress

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for ContentAddress

fn default() -> Self

Returns the “default value” for a type.

impl Hash for ContentAddress

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for ContentAddress

fn eq(&self, other: &ContentAddress) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for ContentAddress

impl Eq for ContentAddress

impl StructuralPartialEq for ContentAddress