1use super::cb_usri::{CompactBinaryUsri, HierarchyLevel};
48use super::usri::RealmClass;
49
50fn fnv1a_64(s: &str) -> u64 {
52 let mut h: u64 = 0xcbf29ce484222325;
53 for b in s.as_bytes() {
54 h ^= *b as u64;
55 h = h.wrapping_mul(0x100000001b3);
56 }
57 h
58}
59
60pub const OP_COSMIC_POSE: u8 = 0x50;
64
65pub const OP_REALM_TRANSIT: u8 = 0x51;
67
68pub const OP_OBSERVER_FIBER: u8 = 0x53;
70
71pub const OP_MICRO_POSE: u8 = 0x54;
73
74pub const OP_ELEMENT_COLLAPSE: u8 = 0x55;
76
77pub const COSMIC_POSE_IRI: &str = "cosmic:hasSpacetimePose";
79
80pub const SENSITIVITY_PUBLIC: u8 = 0;
82pub const SENSITIVITY_RESTRICTED: u8 = 1;
83pub const SENSITIVITY_CLASSIFIED: u8 = 2;
84
85pub const LANE_PASSTHROUGH: u8 = 0b00;
87pub const LANE_COMMONS: u8 = 0b01;
88pub const LANE_BILATERAL: u8 = 0b10;
89pub const LANE_SPATIAL: u8 = 0b11;
90
91#[repr(C)]
97#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, bytemuck::Pod, bytemuck::Zeroable)]
98pub struct CosmicNQuin {
99 pub subject: u64,
100 pub predicate: u64,
101 pub object: u64,
102 pub context: u64,
103 pub metadata: u64,
104 pub parity: u64,
105}
106
107impl CosmicNQuin {
108 pub fn cosmic_pose(
113 subject_did: &str,
114 pose_iri: &str,
115 realm_usri: &str,
116 level: HierarchyLevel,
117 sensitivity: u8,
118 lamport_clock: u32,
119 ) -> Self {
120 Self::build(
121 OP_COSMIC_POSE,
122 subject_did,
123 pose_iri,
124 realm_usri,
125 level,
126 0, sensitivity,
128 LANE_COMMONS,
129 lamport_clock,
130 )
131 }
132
133 pub fn realm_transit(
135 subject_did: &str,
136 target_realm_usri: &str,
137 source_realm_usri: &str,
138 level: HierarchyLevel,
139 sensitivity: u8,
140 lamport_clock: u32,
141 ) -> Self {
142 Self::build(
143 OP_REALM_TRANSIT,
144 subject_did,
145 target_realm_usri,
146 source_realm_usri,
147 level,
148 0,
149 sensitivity,
150 LANE_BILATERAL,
151 lamport_clock,
152 )
153 }
154
155 pub fn observer_fiber(
157 observer_did: &str,
158 perceived_frame_usi: &str,
159 realm_usri: &str,
160 level: HierarchyLevel,
161 sensitivity: u8,
162 lamport_clock: u32,
163 ) -> Self {
164 Self::build(
165 OP_OBSERVER_FIBER,
166 observer_did,
167 perceived_frame_usi,
168 realm_usri,
169 level,
170 0,
171 sensitivity,
172 LANE_BILATERAL,
173 lamport_clock,
174 )
175 }
176
177 pub fn micro_pose(
179 subject_did: &str,
180 pose_iri: &str,
181 realm_usri: &str,
182 level: HierarchyLevel,
183 sensitivity: u8,
184 lamport_clock: u32,
185 ) -> Self {
186 Self::build(
187 OP_MICRO_POSE,
188 subject_did,
189 pose_iri,
190 realm_usri,
191 level,
192 0,
193 sensitivity,
194 LANE_COMMONS,
195 lamport_clock,
196 )
197 }
198
199 pub fn element_collapse(
201 narrative_entity_iri: &str,
202 physical_anchor_iri: &str,
203 realm_usri: &str,
204 level: HierarchyLevel,
205 sensitivity: u8,
206 lamport_clock: u32,
207 ) -> Self {
208 Self::build(
209 OP_ELEMENT_COLLAPSE,
210 narrative_entity_iri,
211 physical_anchor_iri,
212 realm_usri,
213 level,
214 0,
215 sensitivity,
216 LANE_COMMONS,
217 lamport_clock,
218 )
219 }
220
221 #[allow(clippy::too_many_arguments)]
223 fn build(
224 opcode: u8,
225 subject_did: &str,
226 object_iri: &str,
227 realm_usri: &str,
228 level: HierarchyLevel,
229 nesting_depth: u8,
230 sensitivity: u8,
231 routing_lane: u8,
232 lamport_clock: u32,
233 ) -> Self {
234 let subject_hash = fnv1a_64(subject_did) & 0x7FFF_FFFF_FFFF_FFFF;
236 let subject = subject_hash | (1u64 << 63); let pose_hash = fnv1a_64(COSMIC_POSE_IRI) & 0x003F_FFFF_FFFF_FFFF; let predicate = (pose_hash << 8) | (opcode as u64);
241
242 let object_hash = fnv1a_64(object_iri) & 0x7FFF_FFFF_FFFF_FFFF;
244 let object = object_hash | (1u64 << 63); let realm_hash = fnv1a_64(realm_usri) & 0x00FF_FFFF_FFFF_FFFF; let context = ((sensitivity as u64) << 56) | realm_hash;
249
250 let lane_bits = ((routing_lane as u64) & 0b11) << 61;
253 let clock_bits = ((lamport_clock as u64) & 0x1FFF_FFFF) << 32;
254 let realm_class = derive_realm_class_from_usri(realm_usri);
256 let lower32 =
257 (realm_class as u64) | ((level.as_u8() as u64) << 8) | ((nesting_depth as u64) << 16);
258 let metadata = lane_bits | clock_bits | lower32;
259
260 let parity = subject ^ predicate ^ object ^ context ^ metadata;
262
263 Self {
264 subject,
265 predicate,
266 object,
267 context,
268 metadata,
269 parity,
270 }
271 }
272
273 pub fn opcode(&self) -> u8 {
275 (self.predicate & 0xFF) as u8
276 }
277
278 pub fn subject_hash(&self) -> u64 {
280 self.subject & 0x7FFF_FFFF_FFFF_FFFF
281 }
282
283 pub fn object_hash(&self) -> u64 {
285 self.object & 0x7FFF_FFFF_FFFF_FFFF
286 }
287
288 pub fn sensitivity(&self) -> u8 {
290 (self.context >> 56) as u8
291 }
292
293 pub fn realm_hash(&self) -> u64 {
295 self.context & 0x00FF_FFFF_FFFF_FFFF
296 }
297
298 pub fn routing_lane(&self) -> u8 {
300 ((self.metadata >> 61) & 0b11) as u8
301 }
302
303 pub fn lamport_clock(&self) -> u32 {
305 ((self.metadata >> 32) & 0x1FFF_FFFF) as u32
306 }
307
308 pub fn realm_class_index(&self) -> u8 {
310 (self.metadata & 0xFF) as u8
311 }
312
313 pub fn hierarchy_level(&self) -> Option<HierarchyLevel> {
315 HierarchyLevel::from_u8(((self.metadata >> 8) & 0xFF) as u8)
316 }
317
318 pub fn nesting_depth(&self) -> u8 {
320 ((self.metadata >> 16) & 0xFF) as u8
321 }
322
323 pub fn verify_parity(&self) -> bool {
325 self.parity == (self.subject ^ self.predicate ^ self.object ^ self.context ^ self.metadata)
326 }
327
328 pub fn to_bytes(&self) -> [u8; 48] {
330 bytemuck::cast(*self)
331 }
332
333 pub fn from_bytes(bytes: &[u8; 48]) -> Self {
335 *bytemuck::cast_ref(bytes)
336 }
337
338 pub const fn size_bytes() -> usize {
340 48
341 }
342}
343
344fn derive_realm_class_from_usri(usri: &str) -> u8 {
346 if let Ok(parsed) = super::usri::Usri::parse(usri) {
348 parsed.realm_class.as_u8()
349 } else {
350 RealmClass::Physical.as_u8()
352 }
353}
354
355pub fn from_cb_usri(
360 cb: &CompactBinaryUsri,
361 subject_did: &str,
362 object_iri: &str,
363 opcode: u8,
364 lamport_clock: u32,
365) -> CosmicNQuin {
366 let level = HierarchyLevel::from_u8(cb.level()).unwrap_or(HierarchyLevel::L5);
367 let nesting_depth = cb.nesting_depth();
368 let realm_class_idx = cb.realm_class();
369
370 let subject = (fnv1a_64(subject_did) & 0x7FFF_FFFF_FFFF_FFFF) | (1u64 << 63);
372
373 let pose_hash = fnv1a_64(COSMIC_POSE_IRI) & 0x003F_FFFF_FFFF_FFFF;
375 let predicate = (pose_hash << 8) | (opcode as u64);
376
377 let object = (fnv1a_64(object_iri) & 0x7FFF_FFFF_FFFF_FFFF) | (1u64 << 63);
379
380 let context = (SENSITIVITY_PUBLIC as u64) << 56 | (cb.path_hash() & 0x00FF_FFFF_FFFF_FFFF);
382
383 let metadata = ((LANE_COMMONS as u64) << 61)
385 | ((lamport_clock as u64 & 0x1FFF_FFFF) << 32)
386 | (realm_class_idx as u64)
387 | ((level.as_u8() as u64) << 8)
388 | ((nesting_depth as u64) << 16);
389
390 let parity = subject ^ predicate ^ object ^ context ^ metadata;
391
392 CosmicNQuin {
393 subject,
394 predicate,
395 object,
396 context,
397 metadata,
398 parity,
399 }
400}
401
402#[cfg(test)]
403mod tests {
404 use super::*;
405
406 #[test]
407 fn opcodes_in_correct_range() {
408 assert_eq!(OP_COSMIC_POSE, 0x50);
410 assert_eq!(OP_REALM_TRANSIT, 0x51);
411 assert_eq!(OP_OBSERVER_FIBER, 0x53);
412 assert_eq!(OP_MICRO_POSE, 0x54);
413 assert_eq!(OP_ELEMENT_COLLAPSE, 0x55);
414 }
415
416 #[test]
417 fn opcodes_above_ltl_range() {
418 assert!(OP_COSMIC_POSE > 0x44);
420 assert!(OP_ELEMENT_COLLAPSE > 0x44);
421 }
422
423 #[test]
424 fn cosmic_pose_builds_correctly() {
425 let q = CosmicNQuin::cosmic_pose(
426 "did:q42:person:alice",
427 "urn:omni:v1:physical:observable:standard:earth:wgs84#pose",
428 "urn:omni:v1:physical:observable:standard:earth:wgs84",
429 HierarchyLevel::L5,
430 SENSITIVITY_PUBLIC,
431 12345,
432 );
433 assert_eq!(q.opcode(), OP_COSMIC_POSE);
434 assert!(q.subject & (1u64 << 63) != 0, "subject MSB should be set");
435 assert!(q.object & (1u64 << 63) != 0, "object MSB should be set");
436 assert_eq!(q.sensitivity(), SENSITIVITY_PUBLIC);
437 assert_eq!(q.lamport_clock(), 12345);
438 assert_eq!(q.hierarchy_level(), Some(HierarchyLevel::L5));
439 assert!(q.verify_parity());
440 }
441
442 #[test]
443 fn realm_transit_uses_bilateral_lane() {
444 let q = CosmicNQuin::realm_transit(
445 "did:q42:person:alice",
446 "urn:omni:v1:fiction:star-trek:prime",
447 "urn:omni:v1:physical:observable:standard:earth",
448 HierarchyLevel::L5,
449 SENSITIVITY_RESTRICTED,
450 100,
451 );
452 assert_eq!(q.opcode(), OP_REALM_TRANSIT);
453 assert_eq!(q.routing_lane(), LANE_BILATERAL);
454 assert_eq!(q.sensitivity(), SENSITIVITY_RESTRICTED);
455 }
456
457 #[test]
458 fn observer_fiber_builds() {
459 let q = CosmicNQuin::observer_fiber(
460 "did:q42:person:bob",
461 "urn:omni:v1:phenomenology:bob:perceived",
462 "urn:omni:v1:phenomenology:bob",
463 HierarchyLevel::L4,
464 SENSITIVITY_CLASSIFIED,
465 999,
466 );
467 assert_eq!(q.opcode(), OP_OBSERVER_FIBER);
468 assert_eq!(q.sensitivity(), SENSITIVITY_CLASSIFIED);
469 assert_eq!(q.routing_lane(), LANE_BILATERAL);
470 }
471
472 #[test]
473 fn micro_pose_uses_correct_level() {
474 let q = CosmicNQuin::micro_pose(
475 "did:q42:atom:hydrogen-1",
476 "urn:omni:v1:physical:observable:standard:hydrogen",
477 "urn:omni:v1:physical:observable:standard:hydrogen",
478 HierarchyLevel::L2,
479 SENSITIVITY_PUBLIC,
480 1,
481 );
482 assert_eq!(q.opcode(), OP_MICRO_POSE);
483 assert_eq!(q.hierarchy_level(), Some(HierarchyLevel::L2));
484 }
485
486 #[test]
487 fn element_collapse_builds() {
488 let q = CosmicNQuin::element_collapse(
489 "urn:omni:v1:narrative:homer:iliad:troy",
490 "urn:omni:v1:physical:observable:standard:earth:hisarlik",
491 "urn:omni:v1:narrative:homer:iliad",
492 HierarchyLevel::L5,
493 SENSITIVITY_PUBLIC,
494 42,
495 );
496 assert_eq!(q.opcode(), OP_ELEMENT_COLLAPSE);
497 assert_eq!(q.lamport_clock(), 42);
498 }
499
500 #[test]
501 fn parity_is_verified() {
502 let q = CosmicNQuin::cosmic_pose(
503 "did:q42:person:test",
504 "pose",
505 "urn:omni:v1:physical:observable:standard:earth",
506 HierarchyLevel::L5,
507 SENSITIVITY_PUBLIC,
508 1,
509 );
510 assert!(q.verify_parity());
511 }
512
513 #[test]
514 fn parity_detects_corruption() {
515 let mut q = CosmicNQuin::cosmic_pose(
516 "did:q42:person:test",
517 "pose",
518 "urn:omni:v1:physical:observable:standard:earth",
519 HierarchyLevel::L5,
520 SENSITIVITY_PUBLIC,
521 1,
522 );
523 assert_eq!(q.parity, q.subject ^ q.predicate ^ q.object ^ q.context ^ q.metadata);
524 q.metadata ^= 1; assert!(!q.verify_parity());
526 q.metadata ^= 1;
527 q.subject ^= 1; assert!(!q.verify_parity());
529 }
530
531 #[test]
532 fn bytes_round_trip() {
533 let q = CosmicNQuin::cosmic_pose(
534 "did:q42:person:alice",
535 "pose",
536 "urn:omni:v1:physical:observable:standard:earth",
537 HierarchyLevel::L5,
538 SENSITIVITY_PUBLIC,
539 100,
540 );
541 let bytes = q.to_bytes();
542 assert_eq!(bytes.len(), 48);
543 let recovered = CosmicNQuin::from_bytes(&bytes);
544 assert_eq!(q, recovered);
545 }
546
547 #[test]
548 fn size_is_48_bytes() {
549 assert_eq!(CosmicNQuin::size_bytes(), 48);
550 assert_eq!(std::mem::size_of::<CosmicNQuin>(), 48);
551 }
552
553 #[test]
554 fn from_cb_usri_builds() {
555 let cb = CompactBinaryUsri::from_usri(
556 "urn:omni:v1:physical:observable:standard:earth:wgs84",
557 RealmClass::Physical,
558 HierarchyLevel::L5,
559 0,
560 "geo(lat=37.8,lon=-122.4)",
561 );
562 let q = from_cb_usri(&cb, "did:q42:person:alice", "pose-iri", OP_COSMIC_POSE, 500);
563 assert_eq!(q.opcode(), OP_COSMIC_POSE);
564 assert_eq!(q.hierarchy_level(), Some(HierarchyLevel::L5));
565 assert_eq!(q.realm_class_index(), RealmClass::Physical.as_u8());
566 assert!(q.verify_parity());
567 }
568
569 #[test]
570 fn realm_class_derived_from_usri() {
571 let q = CosmicNQuin::cosmic_pose(
572 "did:q42:person:test",
573 "pose",
574 "urn:omni:v1:fiction:star-trek:prime:earth",
575 HierarchyLevel::L5,
576 SENSITIVITY_PUBLIC,
577 1,
578 );
579 assert_eq!(q.realm_class_index(), RealmClass::Fiction.as_u8());
580 }
581
582 #[test]
583 fn nesting_depth_extracted() {
584 let q = CosmicNQuin::cosmic_pose(
585 "did:q42:person:test",
586 "pose",
587 "urn:omni:v1:physical:observable:standard:earth",
588 HierarchyLevel::L5,
589 SENSITIVITY_PUBLIC,
590 1,
591 );
592 assert_eq!(q.nesting_depth(), 0);
594 }
595
596 #[test]
597 fn lamport_clock_wraps_29_bits() {
598 let q = CosmicNQuin::cosmic_pose(
599 "did:q42:person:test",
600 "pose",
601 "urn:omni:v1:physical:observable:standard:earth",
602 HierarchyLevel::L5,
603 SENSITIVITY_PUBLIC,
604 0x1FFF_FFFF, );
606 assert_eq!(q.lamport_clock(), 0x1FFF_FFFF);
607 }
608}