code wiki / (root) / nx_uxf_cid.nx

nx_uxf_cid.nx

buildroot/runtime/nx_uxf_cid.nx

2859 B68 linesdepth 6pulls 6 transitivereach 63 importersview sourcekind librarytopic uxf
docsdependenciesstructsconstsfunctions

about

nx_uxf_cid.nx -- UXF arc R1c: the SELF-DESCRIBING multicodec/profile CID, built ON TOP of nx_canon_cid (do NOT touch the foundation -- Rule 19 additive, Rule 3 no patch cascade). The substrate spec (knowledge/specs/2026-06-09-tutoring-storage-substrate-rung1.md) defines CID = multihash + a multicodec(record-type) tag, but the shipped cid_of() omits the multicodec. This adds it. The profiled CID carries a PROFILE/codec id that is: (a) FOLDED INTO the hash -> same bytes under different profiles => different CID (no cross-profile collision; still fully content-addressed within a profile), AND (b) READABLE from the CID string -> an endpoint can pick the right view WITHOUT any out-of-band schema = Law-1 endpoint-adaptive ; new profiles = new codec ids with NO format change = Law-4 extensible (Rule 25: add an id, never a new format). Profiled CID: "nxc1-" <2hex codec> "-" <64hex sha256(codec_byte || canon_bytes)> NUL (len 72) No hardware/persistent writes (Rule 26). license_tier: ORIGINAL

dependencies 3 imports · 23 importers

nx_syscalls.nx nx_sha256.nx nx_canon_cid.nx nx_uxf_cid.nx nx_asset_record.nx nx_audio_gate.nx nx_benchmark_ref.nx nx_fb2_book_gate.nx nx_lib_uxf_ingest.nx nx_library_exceed.nx nx_m4b_gate.nx nx_nmz.nx nx_nmz_author.nx nx_nmz_comic_gate.nx

diagram shows first 10 each side; +0 more imports, +13 more importers in the complete lists below.

imports: nx_syscalls.nxnx_sha256.nxnx_canon_cid.nx

imported by: nx_asset_record.nxnx_audio_gate.nxnx_benchmark_ref.nxnx_fb2_book_gate.nxnx_lib_uxf_ingest.nxnx_library_exceed.nxnx_m4b_gate.nxnx_nmz.nxnx_nmz_author.nxnx_nmz_comic_gate.nxnx_nmz_gate.nxnx_nmz_index.nxnx_nmz_native_gate.nxnx_nmz_pack.nxnx_uxf_cid_test.nxnx_uxf_config_test.nxnx_uxf_corpus_migrate.nxnx_uxf_corpus_persist.nxnx_uxf_decode_test.nxnx_uxf_media_asset_test.nxnx_uxf_tsv_migrate.nxnx_uxf_tsv_persist.nxnx_uxf_wms_bridge_test.nx

structs

none

consts

20const UXF_DATA: i64 = 1
21const UXF_DOC: i64 = 2
22const UXF_MEDIA: i64 = 3
23const UXF_CONFIG: i64 = 4
24const UXF_ARCHIVE: i64 = 5

functions

26func uxf_nib_hex(v: i64) -> i64
called by 1: uxf_cid_profiled
31func uxf_hex_nib(b: i64) -> i64
called by 1: uxf_codec_of_cid
39func uxf_cid_profiled(codec: i64, canon: *u8, n: i64, cid: *u8) -> i64
62func uxf_codec_of_cid(cid: *u8) -> i64
called by 9: mainmainmainmainmainmain+3 calls 1: uxf_hex_nib