Verification boundary
September 4, 2026 ยท View on GitHub
Verification APIs fall into two categories: authority-aware verification, where caller-supplied trust or expected context is part of the decision, and integrity verification, where an artifact is checked against information carried by that artifact. An integrity result does not authenticate the signer as authorized for a relying party. Applications making authorization decisions should use APIs that accept the required trust anchors or expected context.
Authority-aware surfaces in this SDK
- Passport verification.
verify_passportestablishes issuer authority only with a trusted-issuer input:trusted_issuers. The self-signed opt-inallow_self_signedmarks the result integrity-only and is not a substitute for issuer trust in an authorization gate.assign_role,commerce_preflightandcommerce_with_intenttake the same input and pass it through. - Credential and presentation verification.
verify_verifiable_credential,verify_verifiable_presentationandverify_credential_responsebind the proof key to the identity the document claims. Presentations require a challenge at creation and the expected challenge at verification (expected_challenge); the domain is signed, and a caller that relies on domain separation suppliesexpected_domainto have it compared. The verifiers resolvedid:keyand the multibasedid:apsform without an external resolver; other issuer or holder identifier methods are unresolved by this release and fail closed. - Policy receipt chain verification.
verify_policy_receipttakes the chain it verifies,PolicyReceiptChainInputs.verify_policy_receipt_envelopeis the envelope-only integrity check and must be named to get that answer. - Attribution consent verification.
verify_attribution_consentandcheck_artifact_citationsrequire each party to be named by a self-certifying identifier that commits to the key beside it.
Artifact timestamps at a verification boundary must be readable RFC 3339 instants with an explicit offset or Z.