Skip to main content

qualia_core_db/sensing/authority/
mod.rs

1//! Cryptographic authority, calibration certificate chain verification, rational clock
2//! discipline, and simulator actuation gates for EMF v4 and QAC v1 streams (Packet M02).
3//!
4//! Enforces gates `G-AUTHORITY` and `G-INTEGRITY` under C02 (`quantities-models.md`) and
5//! C03 (`wire-freeze.md`):
6//! - [`custody_bridge`]: Anti-substitution binding across `authority_receipt_digest`
7//!   (Schemas 4, 7, 137, 207), `original_blake3`, envelope `index_commitment`, `source_id`,
8//!   `actor_id`, `purpose_hash`, and `SensingAction`, with replay protection, live revocation
9//!   revalidation, sidecar attestation, and native local custody integration.
10//! - [`certificates`]: Ed25519 + BLAKE3 calibration certificate chain verification (EMF Schema 107,
11//!   QAC Schema 202), exact `i128` rational half-open interval validity `[valid_from, valid_until)`
12//!   (C02-C03), single-application affine calibration rules (C02-C05), and explicit uncertainty
13//!   target/unit/kind validation on mixed-unit records (Modes 0x0106 and 0x0107).
14//! - [`clock_discipline`]: Exact rational clock origin verification, TAI/UTC leap-second table
15//!   binding, sinusoidal phase uncertainty bounds $\Delta\phi_{\max} = 2\pi f u_t$ (C02-C03),
16//!   and explicit EMF negative-carrier vs QAC positive-carrier I/Q conversion (`z_QAC = conj(z_EMF)`,
17//!   C02-C08).
18//! - [`actuation_gate`]: Strict provenance role separation (`Measured`, `Model`, `Derived`,
19//!   `Command`, `OpaquePreserved`), empirical join rejection of `Hypothesis`, `Counterfactual`,
20//!   and `Fictional` epistemic classes (Schema 134), passive-artifact non-actuation guards, and
21//!   fail-closed simulator command admission (Schema 207 `actuator-command`, Schema 208
22//!   `transmit-command`, C02-C07).
23
24pub mod actuation_gate;
25pub mod certificates;
26pub mod clock_discipline;
27pub mod custody_bridge;
28
29pub use actuation_gate::{
30    admit_simulator_command, reject_passive_artifact_for_actuation,
31    verify_empirical_join_admission, ActuationGateError, AdmittedSimulatorCommand,
32    CommandReplayLedger, EpistemicClass, HapticSchema207Role, PassiveArtifactKind, ProvenanceRole,
33    ProvenanceRoleRecord, SignedSimulatorCommandReceipt, SimulatorCommandClaims,
34    SimulatorCommandKind, SimulatorCommandRequest, UltrasoundSchema208Role,
35    COMMAND_RECEIPT_DOMAIN, COMMAND_SIG_DOMAIN, MAX_COMMAND_REPLAY_ENTRIES,
36};
37pub use certificates::{
38    calibrate_complex_iq_pair_once, verify_calibration_certificate_chain, CalibratedSeriesState,
39    CalibrationCertificate, CalibrationError, CalibrationSchemaFamily, CalibrationValidityWindow,
40    QualifiedUncertainty, RationalInstant, SignalStageRelation, UncertaintyKind,
41    CALIBRATION_CERT_DOMAIN, CALIBRATION_SIG_DOMAIN, MAX_CALIBRATION_BATCH_SAMPLES,
42    MAX_CALIBRATION_CHAIN_LEN,
43};
44pub use clock_discipline::{
45    compute_phase_uncertainty_rad, convert_iq_sample_between_conventions,
46    reject_unconjugated_iq_memcpy, verify_phase_coherent_join, verify_same_clock_join,
47    ClockDisciplineError, ClockScale, CrossClockMapping, IqCarrierConvention, LeapSecondStep,
48    LeapSecondTable, QualifiedIqSample, LEAP_SECOND_TABLE_DOMAIN, MAX_LEAP_SECOND_ENTRIES,
49};
50pub use custody_bridge::{
51    verify_acquisition_derivation_custody, verify_acquisition_original_custody,
52    verify_and_consume_stream_receipt, verify_artifact_link_digest, AuthorityBindingClaims,
53    AuthorityReceiptTarget, ConsentBoundSidecarAuthority, CustodyBridgeError,
54    ExpectedStreamBinding, ReceiptReplayWindow, SignedAuthorityReceipt, AUTHORITY_RECEIPT_DOMAIN,
55    AUTHORITY_SIGNATURE_DOMAIN, MAX_RECEIPT_REPLAY_WINDOW,
56};
57#[cfg(not(target_arch = "wasm32"))]
58pub use custody_bridge::LocalCustodyStoreBridge;
59
60#[cfg(test)]
61mod tests;
62#[cfg(test)]
63mod tests_custody_actuation;