Skip to content

docs: bring attestation, boot, build and verification up to the STARK backend - #1

Merged
eKisNonos merged 3 commits into
mainfrom
stark-attestation-docs
Jul 17, 2026
Merged

docs: bring attestation, boot, build and verification up to the STARK backend#1
eKisNonos merged 3 commits into
mainfrom
stark-attestation-docs

Conversation

@eKisNonos

@eKisNonos eKisNonos commented Jul 17, 2026

Copy link
Copy Markdown
Contributor

Brings the wiki up to the transparent post-quantum STARK attestation now in the kernel and bootloader (kernel PRs #375 to #378). Written against the code, with the honest framing kept intact: STARK is the production (nonos-mk-zerostate) backend, and the earlier enrolled-secret Pedersen proof still gates the default build.

Core pages

  • security/attestation.md: two backends behind one gate, selected by nonos-stark-attest. The STARK measurement-membership gate (src/security/capsule_attest/stark.rs:53), the shared 48-byte context, the NZKSTRK1 vs NZKCAPS2 trailers, kernel self-attestation, and an updated source map.
  • subsystems/boot/handoff.md: the bootloader now verifies the kernel's own STARK self-attestation before jump (nonos-bootloader/src/kernel_verify/stark_attest.rs:44).
  • subsystems/proof-system/README.md + pedersen-attestation.md: the STARK backs attestation in production; the Pedersen page marked as the earlier backend that still ships as default.
  • build/workflows.md: make menuconfig, make from-config, and nonos-mk-zerostate.
  • build/signing.md: new section on capsule STARK trailer enrollment via nonos-stark-enroll (main.rs:209, self-check main.rs:142).
  • architecture/verification.md: the 203-theorem STARK proof body, plus its Kani and Verus coverage.

Wider sweep

  • Renamed nonos-mk-full-gui-prod to nonos-mk-zerostate across the capsule contributing pages and the toolchain page (old name kept as an alias in the Makefile).
  • security/README.md, security/security-model.md, userland/attest/attestation-data.md, and the docs index README updated to name both attestation backends and the STARK proof body; no enrolled-secret-only claims remain.
  • Re-resolved the desktop-gui-prod and zerostate Makefile line refs to their current lines after the macro fold.

Convention

Every source reference carries file:line, matching the wiki's own standard. No em-dashes, one voice.

Out of scope

The wider Makefile:LINE drift on refs unrelated to these targets predates this change and belongs to the wiki's own regeneration pass.

… backend

Attestation now has two backends behind the gate, selected by
nonos-stark-attest: the production transparent post-quantum FRI-STARK
membership proof, and the earlier enrolled-secret discrete-log proof
that still gates the default build. Document both, STARK first, add the
kernel self-attestation the bootloader verifies before jump, add the
capsule STARK enrollment step and the configurable build (menuconfig,
from-config, nonos-mk-zerostate), and record the 203-theorem STARK proof
body with its Kani and Verus coverage on the verification page.
@eKisNonos
eKisNonos force-pushed the stark-attestation-docs branch from 76042a1 to 5b25edc Compare July 17, 2026 13:29
ek added 2 commits July 17, 2026 15:38
Rename the make target across the capsule contributing pages and the
toolchain page (nonos-mk-full-gui-prod is now nonos-mk-zerostate, kept
as an alias). Update the security index and the userland attest page to
name the two attestation backends, and the security model and docs index
to reflect the STARK proof body. No enrolled-secret-only claims left.
The macro fold shifted the desktop-gui-prod and zerostate target lines
to 1183 and 1215. Fix those target-line references. Body and
prerequisite line refs vary by context and are part of the wider,
pre-existing Makefile-line drift the wiki regenerates separately.
@eKisNonos
eKisNonos force-pushed the stark-attestation-docs branch from b4019f0 to 583e11b Compare July 17, 2026 14:02
@eKisNonos
eKisNonos merged commit b273895 into main Jul 17, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant