Skip to content

aph-cli: attest-rotation and render-did --attestation (RFC 0001 §3.1 publication) - #6

Merged
scott-wyatt merged 3 commits into
mainfrom
attest-rotation-k2
Nov 8, 2026
Merged

scott-wyatt merged 3 commits into
mainfrom
attest-rotation-k2

Conversation

@scott-wyatt

Copy link
Copy Markdown
Contributor

What

v0.2 §5 / RFC 0001 §3.1 publication, end to end: a notary's CURRENT key signs that a named successor is its own, and the DID document carries that statement.

  • aph-core — discovery::publish::render_did_document_with_rotation: the §8.4.4 document plus the signed attestation under https://w3id.org/aph/v1#rotationAttestation. Refuses (APH_E024, the verifier's own code) before anything renders unless the statement verifies under the PUBLISHED predecessor and the named successor is published under the same bytes. The plain render_did_document is byte-identical to before (one shared builder; a test pins it). The DID-document parser's unknown-field tolerance is what makes the added property safe for every verifier, and a test now pins that dependency by name.
  • aph-cli — attest-rotation <did:web> <pred-kid> <did:key> <succ-kid> --id --created --not-before --not-after: the one verb in the binary that holds a private key. The predecessor seed arrives on STDIN and nowhere else; the statement is self-verified before it is printed; no message carries the value (length class only). Lives in its own attest module so publish's public-only promise stays unqualified. render-did --attestation <file> embeds the result, re-verifying under the published key.
  • CHANGELOG: bullet under Unreleased (v0.3 line).

Tests

Four new tests (two per crate): the rotation render adds exactly the property and nothing else; five chain failures refuse under APH_E024; the verb's output strict-parses, verifies under the predecessor's public key and embeds; malformed seeds and incomplete arguments refuse without echoing. Keys are RFC 8032 §7.1 TEST 1 and TEST 2. Full default workspace green; release binary smoke-tested end to end including a wrong-signer refusal.

First use

did:web:aph-notary.squillo.com#k2 is live beside #k1 as of 2026-11-07, attested by the live #k1; the published document re-renders byte-identically from the live key and the statement.

Note

This branch also carries 9e850f2 (Scott, 2026-09-30): a two-line src_dir fix in two nlang.config.n files that was committed locally on main and never pushed. Included as-is rather than rewritten.

Scott Wyatt added 3 commits September 30, 2026 11:06
… N_BOOK §3.11 errata)

N_BOOK §3.11 (errata @squillo/n 0f90276 + cb76d34): every nlang.config.n path
resolves from the Snapp root, and a leading ".." escapes it literally.
nlang sha256 4b830ee4 still CLAMPS a leading ".." in src_dir back to
<root>/<rest>, so this edit is zero-behaviour today: "./" already resolves
from the root. It has to land BEFORE the clamp is fixed (nlang bundle #6).

Announced on FLEET-BROADCAST seq 70851 with a 60-min objection window.
One line changed per file.
… is named by its predecessor, in the document

v0.2 §5 / RFC 0001 §3.1 publication, end to end. aph-core gains
render_did_document_with_rotation: the §8.4.4 document plus the signed
statement under the full-URI property, refused (APH_E024) before anything
renders unless it verifies under the PUBLISHED predecessor and the named
successor is published under the same bytes; the plain renderer is
byte-identical to before (one shared builder; a test pins it). The
DID-document parser's unknown-field tolerance is what makes the added
property safe, and a test now pins that dependency by name.

aph-cli: attest-rotation is the one verb in the binary that holds a
private key — the predecessor seed arrives on STDIN and nowhere else, the
statement is self-verified before it is printed, and no message carries
the value (length class only). render-did --attestation embeds the
result, re-verifying under the published key. Kept out of `publish` so
that module's public-only promise stays unqualified.

First use: did:web:aph-notary.squillo.com#k2 published beside #k1 on
2026-11-07, attested by the live #k1.
…derer change

The byte-diff job on PR #6 failed by design — aph-core gained
render_did_document_with_rotation, so the shim's bytes moved — and the
Linux runner uploaded the reference build (run 42502534093, artifact
rebuilt-aph-wasm). Adopted per interpreters/go/README.md: placed, the Go
suite run locally against it, committed. The runner is the one reference
builder; this is not a local build.
scott-wyatt pushed a commit that referenced this pull request Nov 8, 2026
…derer change

The byte-diff job on PR #6 failed by design — aph-core gained
render_did_document_with_rotation, so the shim's bytes moved — and the
Linux runner uploaded the reference build (run 42502534093, artifact
rebuilt-aph-wasm). Adopted per interpreters/go/README.md: placed, the Go
suite run locally against it, committed. The runner is the one reference
builder; this is not a local build.
@scott-wyatt
scott-wyatt merged commit 573600f into main Nov 8, 2026
6 checks passed
@scott-wyatt
scott-wyatt deleted the attest-rotation-k2 branch November 8, 2026 21:51
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