Skip to main content

Module pq_handshake

Module pq_handshake 

Source
Expand description

CRY-02 PQ handshake transitions over the existing HandshakeState FSM.

Draft until FND-03 freeze: initiator share wire bytes are exactly ml_kem_pk || x25519_pk with no version prefix. Responder share encoding, length-delimited transcripts, dual proofs, and CRY-02.12 independent vectors remain open. No security proof is claimed. Live KEM encapsulate is not exercised here (RNG/provider); encodings + FSM + 0-RTT only.

Allowed successive states: Idle → Reachability → SharesExchanged → HandshakeKeys → Proofs → Finished → Traffic

Constants§

INITIATOR_SHARE_WIRE_LEN
Exact initiator-share slice length: ML_KEM_768_PK_LEN || X25519_LEN.

Functions§

application_data_allowed
Application data is admitted only in Traffic. Initial-profile 0-RTT is false.
classical_only_authority_is_enough
CRY-02.06 partial: classical-only controller/delegation is never sufficient.
decode_initiator_share
Decode initiator share from ml_kem_pk || x25519_pk. Truncated src fails. Extra bytes are CryptoError::Malformed. Does not call initiator_share.
encode_initiator_share
Encode initiator share as ml_kem_pk || x25519_pk (draft; no version byte).
ml_kem_then_x25519_secret_input
Concatenate ML-KEM shared secret then X25519 shared secret. Order is frozen.
qlink_domain
QLink HKDF/domain label. Distinct from qsession_domain.
qsession_domain
QSession HKDF/domain label. Distinct from qlink_domain.
transition
Advance from to to only when to is the immediate successor.