Turnkey Decoupled Refinement Airlock Template for Bare-Metal #![no_std] Rust Systems
- Master Epistemic Anchor:
A-77-DELTA-SHIELD-LOCKED - Reference Upstream Proof Witness:
trencinodin-stack/arcstone-refinement-harness(v0.1.0) - Governance Alignment: Canonical Downstream Verification Template across Paths A, B, C, and D (
ARC-FAQ-2026-PHASE7-01Q16), preserving the read-only upstream flagplant policy (Q15).
Core Architectural Invariants
- Zero Upstream Verification Intrusion (
C_ops = 0): The target#![no_std]Rust crate (crates/example-no-std-gate) contains zero verification macros, zero ghost variables, zero proof dependencies, and zero source modifications. - Downstream Generated-Code Refinement (
Rust_Impl ⊑ Coq_Spec): Charon LLBC extraction (--libonly), Aeneas functional synthesis, and Coq 8.18.0 proofs run downstream against a read-only snapshot, proving equivalence directly against the Aeneas-synthesized Coq module. - Zero Unapproved Axiom Creep (
admitted_axioms: 0,unexpected_assumptions: 0): Verification runs inside an offline, non-root, capability-dropped container (--network none --cap-drop ALL --read-only --user 65532:65532) and emitsREFINEMENT-AUDIT.jsonvalidated by recursivecoqchk -o, standaloneAudit.v(Print Assumptions) against an explicit allowlist of pinned AeneasPrimitives.vpointer-width constants (ASSUMPTIONS.allow), golden theorem statement pinning, and an in-sandbox semantic canary mutant. - Upstream-Only DOI Topology: Permanent archival DOIs remain strictly on upstream specifications (
10.5281/zenodo.22665852,10.5281/zenodo.24041851,10.5281/zenodo.24093739). This template never mints a downstream DOI.
30-Minute Quickstart (Using Prebuilt Digest-Pinned OCI Image)
Prerequisites
- Rust stable toolchain (
1.82.0+thumbv7em-none-eabihftarget) - Docker / OCI runtime (
dockerwith--network nonesupport) - Python 3.11+,
git,sha256sum
Step 1: Run the Fast Upstream Inner Loop (< 15s)
This runs cargo fmt --check, cargo clippy -- -D warnings, cargo test --locked, cross-compilation to thumbv7em-none-eabihf, and verifies zero proof-tooling leakage into crates/.
Step 2: Run the Negative Receipt Verifier Unit Tests
python3 -m unittest discover -s airlock/tests -p 'test_*.py' -vStep 3: Run the Hermetic Downstream Airlock (--network none)
This verifies PINS.lock, pulls the digest-pinned verifier OCI image if not cached locally, and executes the full offline pipeline inside /work tmpfs:
- Stages a read-only snapshot of the crate from its Git tree object.
- Runs Charon (
--preset=aeneas --locked -- --lib) and Aeneas (-backend coq). - Verifies generated Coq module signatures against
airlock/golden/generated-shape.txt. - Compiles
Primitives.v, generated Coq modules,GeneratedInterface.v,Spec.v, andRefinement.v. - Executes the semantic canary mutant in
/work/canary(flippingcost <= budgettocost >= budget) and confirms Coq fails specifically onRefinement.v. - Runs
coqchk -oand standaloneAudit.v(Print Assumptions) againstairlock/coq/ASSUMPTIONS.allowand writesout/REFINEMENT-AUDIT.json.
Governance & Release Controls
- Digest-Pinned Verifier OCI Image: Built and pinned by
@sha256:...digest inPINS.lock. - Coq 8.18.0 Proof & Golden Qualification:
GeneratedInterface.v,Spec.v,Refinement.v,generated-shape.txt,statement.txt, andASSUMPTIONS.allowverified end-to-end. - Protected Specification Baselines:
EXPECTED_SPEC_V_SHA256andEXPECTED_STATEMENT_GOLDEN_SHA256enforced via the GitHubproductionenvironment. - Immutable Release & Tag Protection: GitHub Immutable Releases, protected
v*tag rulesets, andCODEOWNERSrequired reviews enforced on release tags.