Expand description
Format-specific presentation adapters for SD-JWT VC, mdoc, and ZK proofs.
Serde implementations in this crate exist only for bounded internal protocol parsing of format-native presentation values. They are not stable SDK DTO contracts. Cross-language and SDK boundaries must use generated OpenID4VP protobuf messages and validated canonical JSON byte fields.
Modules§
- mdoc
- ISO mdoc presentation glue for OpenID4VP.
- sd_jwt
- RFC 9901 SD-JWT VC verification for OpenID4VP presentations.
Structs§
- Derived
Claim Statement - Statement proven by a derived ZK presentation.
- Prepared
Open Id4Vp Request Hashes - Digests inserted into the ZK protobuf
ZkPreparedVerifierRequestV1. - Prepared
Open Id4Vp Request Input - The authenticated OpenID4VP values that both sides retain for one query.
The
issued_at_unixandexpires_at_unixvalues must come from the same request; prepared profiles require both even for unsigned DC API requests. - ZkFormat
Error - ZK presentation format error.
- ZkPresentation
- JSON-native ZK
vp_tokenpresentation entry. - ZkPresentation
Binding - Binding hashes embedded in the ZK presentation envelope.
- ZkPresentation
Circuit Ref - Exact imported circuit source used for an artifact-backed proof.
- ZkPresentation
Stage - One exact circuit proof inside the production presentation bundle.
Enums§
- ZkFormat
Error Reason - Stable ZK presentation error taxonomy.
- ZkPresentation
Artifact Identity - Explicit artifact construction carried by a presentation stage.
- ZkPresentation
Profile - Production credential-proof profile carried by a ZK presentation.
- ZkPresentation
Proof Suite - Fully specified proof suite carried by a ZK presentation envelope.
- ZkPresentation
Stage Kind - Required production stage carried in a ZK presentation bundle.
Constants§
- FORMAT_
DC_ SD_ JWT - OpenID4VP final SD-JWT VC format identifier.
- FORMAT_
MSO_ MDOC - OpenID4VP final ISO mdoc format identifier.
- FORMAT_
REALLYME_ ZK - ReallyMe ZK presentation format marker.
- MAX_
ZK_ CIRCUIT_ LABEL_ BYTES - Maximum bytes accepted for a circuit identifier or circuit-ref label.
- MAX_
ZK_ PREPARED_ PERSONA_ BYTES - Cap the encoded prepared object before protobuf decoding or proof work.
- MAX_
ZK_ PRESENTATION_ DERIVED_ CLAIMS - Maximum derived claims accepted in one ZK presentation.
- MAX_
ZK_ PRESENTATION_ PROOF_ BYTES - Maximum proof bytes accepted before invoking an external ZK verifier.
- MAX_
ZK_ PRESENTATION_ PUBLIC_ INPUT_ BYTES - Maximum public-input bytes accepted before invoking an external ZK verifier.
- MAX_
ZK_ STATEMENT_ BYTES - Maximum bytes accepted for a derived-claim semantic label.
- MAX_
ZK_ STATEMENT_ ID_ BYTES - Maximum bytes accepted for a derived-claim statement identifier.
- ZK_
COMMON_ CREDENTIAL_ ROOT_ PRESENTATION_ STAGE_ COUNT - Exact number of proofs in the common-credential-root v1 presentation contract.
- ZK_
PREPARED_ PERSONA_ TYPE - Versioned marker for a prepared-persona
vp_tokenentry. - ZK_
PRESENTATION_ STAGE_ COUNT - Exact number of stages in the production proof-bundle contract.
- ZK_
PRESENTATION_ TYPE - ZK presentation marker used inside JSON-native
vp_tokenentries.
Functions§
- build_
zk_ presentation_ binding - Build the session-binding hashes required in a ZK presentation envelope.
- derive_
prepared_ openid4vp_ request_ hashes - Derive the six ZK request inputs from one independently authenticated OpenID4VP request/session projection. This helper is shared by wallet and verifier adapters so their byte-level signature transcript cannot drift.
- encode_
zk_ prepared_ persona_ value - Encode the ZK SDK’s canonical prepared presentation as a JSON
vp_token. - encode_
zk_ presentation_ value - Validate and encode an externally produced ZK envelope as a
vp_tokenvalue. - hash_
openid4vp_ audience - Hash an OpenID4VP verifier audience for ZK public-input binding.
- hash_
openid4vp_ nonce - Hash an OpenID4VP nonce for ZK public-input binding.
- is_
zk_ presentation_ value - Return whether a presentation value is marked as a ReallyMe ZK presentation.
- parse_
zk_ prepared_ persona_ value - Parse only the canonical two-field transport envelope when marked.
- parse_
zk_ presentation_ value - Parse a
vp_tokenpresentation value as a ZK presentation when marked. - validate_
zk_ presentation_ binding - Validate the unencrypted OpenID4VP binding carried by a ZK envelope.
- validate_
zk_ presentation_ shape - Validate the backend-neutral ZK presentation envelope.