Expand description
#1167 — canonical, append-only, hash-chained DID operation log.
Defines the genesis/rotation wire format and its pinned-Hybrid
(Ed25519 + ML-DSA-65) fail-closed verifier. Kept separate from DID
resolution and anchored-DID policy.
Canonical append-only operation log for hybrid-rooted did:plc identities.
This module is deliberately only the operation format and verifier. It does not resolve DID documents, consult a directory, or apply anchored-identity policy.
§Format
Every operation is a canonical DAG-CBOR map:
{
"type": "plc_operation",
"sequence": uint,
"prev": null | "<CIDv1 dag-cbor sha2-256>",
"rotationKeys": [{
"ed25519Pub": bytes(32),
"mldsa65Pub": bytes(1952)
}, ...],
"sig": {
"ed25519": bytes(64),
"mldsa65": bytes(3309)
}
}The signature covers the canonical operation with the entire sig field
omitted. Both components are mandatory and are bound using hyprstream’s
nested Ed25519 + ML-DSA-65 composite construction. Genesis has
sequence = 0 and prev = null; rotations increment the sequence by one
and set prev to the CIDv1 of the complete previous signed operation.
As in the PLC method, the DID identifier is the first 24 lower-case RFC 4648 base32 characters of SHA-256 over the complete signed genesis DAG-CBOR.
Structs§
- DidOp
- A complete signed genesis or rotation operation.
- Hybrid
DidOp Signature - Mandatory two-component signature stored on a DID operation.
- Hybrid
Rotation Key - One inseparable authorization position in the rotation-key list.
- Verified
DidOp Log - Verified head state returned by
verify_did_op_log.
Constants§
- DID_
OP_ SIGNATURE_ CONTEXT - Domain separation for both layers of every DID operation signature.
- DID_
OP_ TYPE - Fixed operation discriminator, matching the regular PLC operation name.
- MAX_
DID_ OP_ BYTES - PQ keys and signatures are larger than classical PLC operations.
- MAX_
ROTATION_ KEYS - PLC-compatible maximum number of active rotation keys.
Functions§
- verify_
did_ op_ log - Verify a complete linear operation log, failing closed on every discrepancy.