Skip to main content

Module signer_suite

Module signer_suite 

Source
Expand description

Signer-suite thumbprint — the ONE shared helper and encoding for the v16 cnf.hs_signer_suite confirmation method (frozen WS-A credential-profile §1.1/§5). Both the mint side (WS-B ExchangeDelegated) and the verify side (WS-C proof resolution) compute the identical function over the identical bytes — there is no second hash encoding.

Content thumbprint: SHA-256( RFC 8949 deterministic-CBOR of [suite_id, [ordered raw component public keys]] ). It uniformly covers a classical (one-key) and a hybrid (two-key) primary signer group. Component key order is the suite-plan order — NEVER a kid/group_id/label/position.

This is a direct port of A’s frozen gen_proof_vectors.py::signer_suite_thumbprint (+ its enc); the golden vectors in the tests are cross-checked against A’s own tooling at af08825528627069b3cfbdd763948c4a24689cb5.

Constants§

SUITE_CLASSICAL_ED25519
Frozen suite ID for a classical (single Ed25519) primary signer group.
SUITE_HYBRID_ED25519_MLDSA65
Frozen suite ID for a hybrid (Ed25519 + ML-DSA-65) primary signer group. Component order is [ed25519, ml_dsa_65].

Functions§

service_signer_suite_b64
The v16 cnf.hs_signer_suite value (base64url, unpadded) for a primary signer group given its raw component public keys: classical (SUITE_CLASSICAL_ED25519, Ed25519 only) when ml_dsa_65 is None, or hybrid (SUITE_HYBRID_ED25519_MLDSA65, Ed25519 + ML-DSA-65 in that frozen order) when present. The single place mint paths turn key material into the stamped confirmation value.
signer_suite_thumbprint
The v16 cnf.hs_signer_suite content thumbprint: SHA-256(det-CBOR([suite_id, [ordered raw component public keys]])), using the ONE shared det_cbor encoder (no second det-CBOR implementation).