Skip to main content

Module did_op

Module did_op 

Source
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.
HybridDidOpSignature
Mandatory two-component signature stored on a DID operation.
HybridRotationKey
One inseparable authorization position in the rotation-key list.
VerifiedDidOpLog
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.