Skip to main content

Module install

Module install 

Source
Expand description

The verified install pipeline (REQ-VERIFY-001, REQ-ROLLBACK-001).

Order is the security argument, so it is fixed here and tested:

  1. fetch manifest bytes (by pin digest if pinned, else by name)
  2. verify the manifest signature against the trust root
  3. parse strictly; cross-check layer name, channel, pinned digest
  4. anti-rollback check against the per-line high-water mark
  5. fetch each blob; verify each digest against the signed manifest
  6. lay down in the core
  7. only now advance the high-water mark

Nothing a source returns reaches the core unverified, and a failed install leaves both the core and the high-water marks untouched. The kill-criterion (REQ-VERIFY-001): running the same bytes through two different sources yields identical verdicts — a source that could influence acceptance has joined the trusted base, and the design is broken.

Structs§

InstallOutcome
A successful install.
InstallPolicy
Policy inputs the caller supplies; time is data, not something the pipeline samples.
VerifyError

Enums§

InstallError

Traits§

ManifestVerifier
Signature verification over fetched manifest bytes, against the PulseEngine trust root. Returns the authenticated payload (the layer manifest itself) — for DSSE-enveloped transport the fetched bytes and the trusted bytes differ, and everything downstream must use only the latter. Implementations carry the trust root; callers cannot relax it per-source — the pipeline takes exactly one verifier for all sources.

Functions§

install