code wiki / _hdl_build / nx_spore_manifest_gate.nx

nx_spore_manifest_gate.nx source

↩ module page · 205 lines · 10108 B

1// nx_spore_manifest_gate.nx -- X-SEED-001 / V-SPORE manifest: the GERMINATION MANIFEST 2// (the seed body, "the .torrent of the organism"). Generalizes the proven single-piece 3// germination (V-SPORE-1, nx_spore_germ_gate) to a LAYERED, MULTI-piece, content-addressed seed: 4// PACK -- FNV-1a each piece's source bytes; EMIT germination_manifest.tsv 5// (id <tab> source <tab> hash <tab> layer <tab> kat_expect) = a real persisted seed. 6// GERMINATE -- in LAYER order, per piece: re-read source (received), FNV-1a, verify == packed 7// hash (INTEGRITY), materialize, REBUILD via the sovereign toolchain, run -> exit 8// == kat_expect (BEHAVIOR/KAT). ADMIT iff both. 9// NEG -- one piece tampered (a byte flipped) -> hash mismatch -> REJECTED, never built. 10// READ-BACK -- re-read the emitted manifest; data-row count must == piece count (seed persisted). 11// verdict GREEN iff ADMIT-ALL + NEG-REJECT + ROWS==N. 12// 13// HONEST scope: verification uses the in-run packed hashes + a persisted-manifest read-back; 14// full content-addressing FROM the persisted manifest (re-parse the recorded hash) and 15// AUTO-DERIVING the piece set from the capability registry/lineage (X-SEED-001 full) are next rungs. 16// 17// Build/run (from nxc2 cwd): _offc/nx_sov_build_run.elf nx_spore_manifest_gate 18// genealogy_id: nishi_spore_seed_portability_charter (X-SEED-001 / V-SPORE manifest) 19 20import "nx_syscalls.nx" 21 22const GERM_FNV_OFFSET: i64 = 0 - 3750763034362895579 // 0xcbf29ce484222325 23const GERM_FNV_PRIME: i64 = 1099511628211 // 0x100000001b3 24const MAN_PATH: *u8 = "knowledge/registry/germination_manifest.tsv" 25const N_PIECES: i64 = 2 26 27func germ_hash(buf: *u8, len: i64) -> i64 { 28 var h: i64 = GERM_FNV_OFFSET 29 var i: i64 = 0 30 while i < len { h = h ^ (buf[i] as i64); h = h * GERM_FNV_PRIME; i = i + 1 } 31 return h 32} 33func g_slen(s: *u8) -> i64 { var n: i64 = 0; while s[n] != (0 as u8) { n = n + 1 } return n } 34func g_puts(s: *u8) -> i64 { sys_write(1, s, g_slen(s)); return 0 } 35func g_puts_fd(fd: i64, s: *u8) -> i64 { sys_write(fd, s, g_slen(s)); return 0 } 36func g_tab(fd: i64) -> i64 { let t: *u8 = sys_mmap(8); t[0] = 9; sys_write(fd, t, 1); return 0 } 37func g_putn(fd: i64, v: i64) -> i64 { 38 let bb: *u8 = sys_mmap(28) 39 var m: i64 = v 40 if m < 0 { m = 0 - m; sys_write(fd, "-" as *u8, 1) } 41 let t: *u8 = sys_mmap(28) 42 var k: i64 = 0 43 if m == 0 { t[0] = 48; k = 1 } 44 while m > 0 { t[k] = 48 + (m % 10); m = m / 10; k = k + 1 } 45 var i: i64 = 0 46 while i < k { bb[i] = t[k - 1 - i]; i = i + 1 } 47 sys_write(fd, bb, k) 48 return 0 49} 50// fork + optional redirect + execve; parent waits; 128+sig on signal-death (no fake success). 51func g_run(path: *u8, argv: *i64, redir_out: i64, redir_err: i64) -> i64 { 52 let pid: i64 = sys_fork() 53 if pid == 0 { 54 if redir_out >= 0 { sys_dup3(redir_out, 1, 0) } 55 if redir_err >= 0 { sys_dup3(redir_err, 2, 0) } 56 sys_execve(path, argv, 0 as *i64) 57 sys_exit(127) 58 } 59 let st: *i64 = sys_mmap(16) as *i64 60 sys_wait4(pid, st, 0) 61 let sig: i64 = st[0] & 0x7f 62 if sig != 0 { return 128 + sig } 63 return (st[0] >> 8) & 0xff 64} 65// rebuild+run a materialized piece by basename via the sovereign lane; returns its run-exit. 66func g_rebuild_run(basename: *u8) -> i64 { 67 let builder: *u8 = "_offc/nx_sov_build_run.elf" as *u8 68 let a: *i64 = sys_mmap(32) as *i64 69 a[0] = builder as i64 70 a[1] = basename as i64 71 a[2] = 0 72 return g_run(builder, a, 0 - 1, 0 - 1) 73} 74// one manifest row: id \t source \t hash \t layer \t kat \n 75func g_man_row(fd: i64, id: *u8, src: *u8, hash: i64, layer: i64, kat: i64) -> i64 { 76 g_puts_fd(fd, id); g_tab(fd) 77 g_puts_fd(fd, src); g_tab(fd) 78 g_putn(fd, hash); g_tab(fd) 79 g_putn(fd, layer); g_tab(fd) 80 g_putn(fd, kat); sys_write(fd, "\n" as *u8, 1) 81 return 0 82} 83 84func main() -> i64 { 85 g_puts("================================================================\n" as *u8) 86 g_puts(" GERMINATION MANIFEST -- layered multi-piece seed: pack -> emit ->\n" as *u8) 87 g_puts(" germinate each (hash+rebuild+KAT) in layer order; tamper rejected.\n" as *u8) 88 g_puts("================================================================\n" as *u8) 89 90 // ---- inline piece table (the seed's pieces; layer = hardware-up order, pre-sorted) ---- 91 let ids: *i64 = sys_mmap(8 * N_PIECES) as *i64 92 let srcs: *i64 = sys_mmap(8 * N_PIECES) as *i64 93 let scratches: *i64 = sys_mmap(8 * N_PIECES) as *i64 94 let bases: *i64 = sys_mmap(8 * N_PIECES) as *i64 95 let layers: *i64 = sys_mmap(8 * N_PIECES) as *i64 96 let kats: *i64 = sys_mmap(8 * N_PIECES) as *i64 97 let hashes: *i64 = sys_mmap(8 * N_PIECES) as *i64 98 99 ids[0] = ("nx_exit42" as *u8) as i64 100 srcs[0] = ("runtime/nx_exit42.nx" as *u8) as i64 101 scratches[0] = ("runtime/_germ_man_nx_exit42.nx" as *u8) as i64 102 bases[0] = ("_germ_man_nx_exit42" as *u8) as i64 103 layers[0] = 0; kats[0] = 42 104 105 ids[1] = ("nx_kat_add7" as *u8) as i64 106 srcs[1] = ("runtime/nx_kat_add7.nx" as *u8) as i64 107 scratches[1] = ("runtime/_germ_man_nx_kat_add7.nx" as *u8) as i64 108 bases[1] = ("_germ_man_nx_kat_add7" as *u8) as i64 109 layers[1] = 1; kats[1] = 7 110 111 // ---- PACK: FNV-1a each source, emit germination_manifest.tsv ---- 112 g_puts("\n [PACK] hash sources -> emit manifest\n" as *u8) 113 let mfd: i64 = sys_openat_wr(MAN_PATH, 0x1a4) 114 if mfd < 0 { g_puts(" FAIL: cannot write manifest\n" as *u8); sys_exit(10); return 10 } 115 g_puts_fd(mfd, "# germination_manifest.tsv -- AUTHORED by nx_spore_manifest_gate (PACK). cols: id <tab> source <tab> hash <tab> layer <tab> kat_expect\n" as *u8) 116 var i: i64 = 0 117 while i < N_PIECES { 118 let lenp: *i64 = sys_mmap(8) as *i64 119 let b: *u8 = sys_read_file((srcs[i]) as *u8, lenp) 120 let n: i64 = *lenp 121 if (b as i64) == 0 { g_puts(" FAIL: unreadable source\n" as *u8); sys_close(mfd); sys_exit(11); return 11 } 122 if n <= 0 { g_puts(" FAIL: empty source\n" as *u8); sys_close(mfd); sys_exit(11); return 11 } 123 hashes[i] = germ_hash(b, n) 124 g_man_row(mfd, (ids[i]) as *u8, (srcs[i]) as *u8, hashes[i], layers[i], kats[i]) 125 g_puts(" packed " as *u8); g_puts((ids[i]) as *u8); g_puts(" layer=" as *u8); g_putn(1, layers[i]); g_puts(" bytes=" as *u8); g_putn(1, n); g_puts("\n" as *u8) 126 i = i + 1 127 } 128 sys_close(mfd) 129 g_puts(" manifest -> " as *u8); g_puts(MAN_PATH); g_puts("\n" as *u8) 130 131 // ---- GERMINATE in layer order: integrity -> materialize -> rebuild -> KAT ---- 132 g_puts("\n [GERMINATE] layer-ordered\n" as *u8) 133 var admitted: i64 = 0 134 i = 0 135 while i < N_PIECES { 136 g_puts(" piece " as *u8); g_puts((ids[i]) as *u8); g_puts(" (layer " as *u8); g_putn(1, layers[i]); g_puts("): " as *u8) 137 let lenp: *i64 = sys_mmap(8) as *i64 138 let recv: *u8 = sys_read_file((srcs[i]) as *u8, lenp) 139 let n: i64 = *lenp 140 let rh: i64 = germ_hash(recv, n) 141 if rh != hashes[i] { 142 g_puts("INTEGRITY mismatch -> REJECT (never built)\n" as *u8) 143 } else { 144 let wfd: i64 = sys_openat_wr((scratches[i]) as *u8, 0x1a4) 145 if wfd < 0 { 146 g_puts("materialize FAIL\n" as *u8) 147 } else { 148 sys_write(wfd, recv, n) 149 sys_close(wfd) 150 let rc: i64 = g_rebuild_run((bases[i]) as *u8) 151 g_puts("germ_rc=" as *u8); g_putn(1, rc); g_puts(" (kat=" as *u8); g_putn(1, kats[i]); g_puts(") " as *u8) 152 if rc == kats[i] { admitted = admitted + 1; g_puts("ADMIT\n" as *u8) } else { g_puts("REJECT(kat)\n" as *u8) } 153 } 154 } 155 i = i + 1 156 } 157 158 // ---- NEGATIVE control: tamper piece 0's received bytes -> integrity reject ---- 159 g_puts("\n [NEG] tamper " as *u8); g_puts((ids[0]) as *u8); g_puts(": " as *u8) 160 var neg_reject: i64 = 0 161 let lp: *i64 = sys_mmap(8) as *i64 162 let ob: *u8 = sys_read_file((srcs[0]) as *u8, lp) 163 let on: i64 = *lp 164 let cor: *u8 = sys_mmap(on + 16) 165 var c: i64 = 0 166 while c < on { cor[c] = ob[c]; c = c + 1 } 167 cor[0] = (cor[0] ^ 1) as u8 168 if germ_hash(cor, on) != hashes[0] { neg_reject = 1; g_puts("hash MISMATCH -> REJECTED pre-build\n" as *u8) } else { g_puts("collision?! gate broken\n" as *u8) } 169 170 // ---- READ-BACK: the emitted manifest persisted with N data rows ---- 171 let rbp: *i64 = sys_mmap(8) as *i64 172 let mb: *u8 = sys_read_file(MAN_PATH, rbp) 173 let mn: i64 = *rbp 174 var nl: i64 = 0 175 var j: i64 = 0 176 while j < mn { if mb[j] == (10 as u8) { nl = nl + 1 } j = j + 1 } 177 let data_rows: i64 = nl - 1 // minus the # header line 178 g_puts("\n [READ-BACK] manifest data rows=" as *u8); g_putn(1, data_rows); g_puts(" (expect " as *u8); g_putn(1, N_PIECES); g_puts(")\n" as *u8) 179 180 // ---- VERDICT (sealed): GREEN iff exactly the known answer ---- 181 var green: i64 = 1 182 if admitted != N_PIECES { green = 0 } 183 if neg_reject != 1 { green = 0 } 184 if data_rows != N_PIECES { green = 0 } 185 186 let lfd: i64 = sys_openat_append("knowledge/status/spore_germ.log" as *u8, 0x1a4) 187 if lfd >= 0 { 188 g_puts_fd(lfd, "SPOREMANIFEST-GATE epoch=" as *u8); g_putn(lfd, sys_now_realtime_sec()) 189 g_puts_fd(lfd, " pieces=" as *u8); g_putn(lfd, N_PIECES) 190 g_puts_fd(lfd, " admitted=" as *u8); g_putn(lfd, admitted) 191 g_puts_fd(lfd, " neg_reject=" as *u8); g_putn(lfd, neg_reject) 192 g_puts_fd(lfd, " manifest_rows=" as *u8); g_putn(lfd, data_rows) 193 if green == 1 { g_puts_fd(lfd, " verdict=GREEN\n" as *u8) } else { g_puts_fd(lfd, " verdict=RED\n" as *u8) } 194 sys_close(lfd) 195 } 196 197 g_puts("----------------------------------------------------------------\n" as *u8) 198 if green == 1 { 199 g_puts(" verdict=GREEN -- a layered multi-piece seed was emitted; every piece\n" as *u8) 200 g_puts(" germinated + KAT-proved in layer order; the tampered piece was rejected.\n" as *u8) 201 sys_exit(0); return 0 202 } 203 g_puts(" verdict=RED -- see fields above\n" as *u8) 204 sys_exit(1); return 1 205}