Skip to main content

Module wire

Module wire 

Source
Expand description

Delegation certificates (0x0001), proof bundles and challenge presentations (0x0002), revocation lists (0x0003) and pushes (0x0005). Mirrors Go protocol_v2_wire.go.

Structs§

DelegationCertV2
Delegation certificate (object code 0x0001).
ProofBundleV2
Proof bundle carrying a challenge presentation (object code 0x0002). None fields encode as JSON null.
RevocationListV2
Full revocation snapshot (object code 0x0003).
RevocationPushV2
Incremental revocation push (object code 0x0005).
RevokedCertV2
Issuer-scoped revoked certificate reference.

Enums§

StatusEvidenceObjectV2
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 delegations and challenge_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 cert under the issuer’s v2 private key. The issuer duties of sign_delegation_cert_v2_with_signer apply.
sign_delegation_cert_v2_with_signer
Sign cert with 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_v2 with an external signer whose complete public key must equal the bundle agent key.
sign_revocation_list_v2
Return a signed copy of list under the caller-authenticated status key.
sign_revocation_list_v2_with_signer
sign_revocation_list_v2 with an external signer whose complete public key must equal bound_status_key.
sign_revocation_push_v2
Return a signed copy of push under the caller-authenticated status key.
sign_revocation_push_v2_with_signer
sign_revocation_push_v2 with an external signer whose complete public key must equal bound_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 (malformed otherwise); any other code is unsupported_object_type with 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 prefix custom:, an empty string, and a scope longer than MAX_SCOPE_LENGTH_BYTES are 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.