Expand description
Delegation certificates (0x0001), proof bundles and challenge
presentations (0x0002), revocation lists (0x0003) and pushes (0x0005).
Mirrors Go protocol_v2_wire.go.
Structs§
- Delegation
Cert V2 - Delegation certificate (object code 0x0001).
- Proof
Bundle V2 - Proof bundle carrying a challenge presentation (object code 0x0002).
Nonefields encode as JSONnull. - Revocation
List V2 - Full revocation snapshot (object code 0x0003).
- Revocation
Push V2 - Incremental revocation push (object code 0x0005).
- Revoked
Cert V2 - Issuer-scoped revoked certificate reference.
Enums§
- Status
Evidence Object V2 - A complete signed status object for
status_evidence_digest_v2.
Functions§
- bundle_
hash_ v2 - “sha384:” + hex(SHA-384(“ratify-protocol-bundle-v2\0” || canonical bundle)).
- decode_
delegation_ cert_ v2 - Strictly decode one v2 delegation certificate.
- decode_
proof_ bundle_ v2 - Strictly decode a v2 proof bundle.
- decode_
revocation_ list_ v2 - Strictly decode a v2 revocation list.
- decode_
revocation_ push_ v2 - Strictly decode a v2 revocation push.
- delegation_
cert_ v2_ signable_ bytes - Canonical signable projection of a certificate (all fields but
signature). - delegation_
digest_ v2 - SHA-384(“ratify-protocol-delegations-v2\0” || canonical(certs)).
- encode_
delegation_ cert_ v2 - Canonical wire bytes of a certificate (validated, then round-trip checked).
- encode_
proof_ bundle_ v2 - Canonical wire bytes of a proof bundle (round-trip checked).
- encode_
revocation_ list_ v2 - Canonical wire bytes of a revocation list.
- encode_
revocation_ push_ v2 - Canonical wire bytes of a revocation push.
- presentation_
v2_ signable_ bytes - Canonical challenge-presentation signable (code 0x0002): the bundle
without
delegationsandchallenge_sig. - revocation_
list_ v2_ signable_ bytes - Canonical revocation-list signable (code 0x0003).
- revocation_
push_ v2_ signable_ bytes - Canonical revocation-push signable (code 0x0005).
- sign_
delegation_ cert_ v2 - Return a signed copy of
certunder the issuer’s v2 private key. The issuer duties ofsign_delegation_cert_v2_with_signerapply. - sign_
delegation_ cert_ v2_ with_ signer - Sign
certwith an external signer whose complete public key must equal the certificate issuer key. - sign_
proof_ bundle_ v2 - Compute the delegation digest and sign the presentation with the agent private key. Trust in the terminal issuer is not established.
- sign_
proof_ bundle_ v2_ with_ signer sign_proof_bundle_v2with an external signer whose complete public key must equal the bundle agent key.- sign_
revocation_ list_ v2 - Return a signed copy of
listunder the caller-authenticated status key. - sign_
revocation_ list_ v2_ with_ signer sign_revocation_list_v2with an external signer whose complete public key must equalbound_status_key.- sign_
revocation_ push_ v2 - Return a signed copy of
pushunder the caller-authenticated status key. - sign_
revocation_ push_ v2_ with_ signer sign_revocation_push_v2with an external signer whose complete public key must equalbound_status_key.- status_
evidence_ digest_ list_ v2 - StatusEvidenceDigest(0x0003, list): binds audit evidence to the complete signed canonical list. It does not establish validity or freshness.
- status_
evidence_ digest_ push_ v2 - StatusEvidenceDigest(0x0005, push).
- status_
evidence_ digest_ v2 - Go
StatusEvidenceDigest(code, object)under an explicit object type code: 0x0003 requires a list and 0x0005 a push (malformedotherwise); any other code isunsupported_object_typewith no digest. - validate_
required_ scope_ v2 - Exactly one requestable action scope (SPEC-v2 §2.4): a registered
canonical non-wildcard scope, or one exact
custom:extension scope. A canonical wildcard,custom:*, the bare prefixcustom:, an empty string, and a scope longer thanMAX_SCOPE_LENGTH_BYTESare rejected. A custom required scope is an exact string matched by byte equality. - validate_
scopes_ v2 - Protocol v2 delegation scope rules (post-claim): non-empty, registered or
custom, no
custom:*, no duplicates. - verify_
delegation_ cert_ v2_ signature - Verify one certificate’s structure, key-ID bindings, and issuer signature (code 0x0001) with its own issuer key. Trust is not established here.
- verify_
proof_ bundle_ v2_ signatures - Structure (key IDs, digest, duplicates, linkage) first, then every certificate signature and the challenge signature. Trust is not evaluated.
- verify_
revocation_ list_ v2_ signature - Verify a list under the caller-authenticated status key bound to
trusted_issuer_id. - verify_
revocation_ push_ v2_ signature - Verify a push under the caller-authenticated status key bound to
trusted_issuer_id.