From 8cbbb38ec0ebcc64290203fae1281dc1f5708893 Mon Sep 17 00:00:00 2001 From: Parth Bhatt Date: Tue, 29 Jul 2025 13:19:22 -0700 Subject: [PATCH 1/3] Add proof handling documentation to credential issuance. - Defines three approaches for handling existing proofs: Proof Sets, Proof Chains, and Error Handling - Clarifies behavior when credentials already contain proofs Addresses #422 --- components/Credential.yml | 5 ++++- index.html | 32 ++++++++++++++++++++++++++------ 2 files changed, 30 insertions(+), 7 deletions(-) diff --git a/components/Credential.yml b/components/Credential.yml index ec1246c8..d35e5ea5 100644 --- a/components/Credential.yml +++ b/components/Credential.yml @@ -91,7 +91,10 @@ components: description: The subject "proof": type: object - description: An optional proof for credentials that are secured using proof sets or chains. + description: > + An optional proof or array of proofs for credentials that are secured using proof sets or chains. + When present, the issuer instance configuration determines how these existing proofs are processed + (appended to create proof sets/chains, or trigger an error). oneOf: - type: object - type: array diff --git a/index.html b/index.html index 7c7742ee..86edb404 100644 --- a/index.html +++ b/index.html @@ -902,13 +902,33 @@

Issue Credential

provided `credential`, the instance MUST attach all of these proofs in response to a single call to the `/credentials/issue` endpoint.

-

+

If a provided `credential` already contains one or more proofs, -an issuing instance SHOULD append its proofs to the list of existing proofs -provided by the caller, converting a single proof value to an array of -proof values if necessary. An issuing instance MAY be configured to return an -error if `credential` values that contain existing `proof` values are provided. -

+the behavior is determined by the issuer instance configuration. An issuing instance +SHOULD be configured to handle existing proofs in one of the following ways: +

+ +

+The specific approach used depends on the issuer instance configuration and +the intended use case for the verifiable credential. +

From da559e6848b897485455c0da8c1015ef32472626 Mon Sep 17 00:00:00 2001 From: Ted Thibodeau Jr Date: Tue, 29 Jul 2025 13:41:29 -0700 Subject: [PATCH 2/3] Fix grammatical issues in the issue credential section. - Improves sentence structure and clarity throughout the section Addresses #422 --- index.html | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/index.html b/index.html index 86edb404..869d7ac3 100644 --- a/index.html +++ b/index.html @@ -904,18 +904,18 @@

Issue Credential

If a provided `credential` already contains one or more proofs, -the behavior is determined by the issuer instance configuration. An issuing instance -SHOULD be configured to handle existing proofs in one of the following ways: +the behavior is determined by the configuration of the issuer instance. An issuing +instance SHOULD be configured to handle existing proofs in one of the following ways:

  • - Proof Sets: Append its proofs to the list of existing proofs + Proof Sets: Append their proofs to the list of existing proofs provided by the caller, converting a single proof value to an array of proof values if necessary, creating a proof set where multiple proofs exist in parallel.
  • - Proof Chains: Append its proofs to create a proof chain + Proof Chains: Append their proofs to create a proof chain where proofs are linked in a specific sequence, potentially using properties like previousProof to establish the chain relationship.
    • @@ -926,7 +926,7 @@

    Issue Credential

-The specific approach used depends on the issuer instance configuration and +The specific approach used depends on the configuration of the issuer instance and the intended use case for the verifiable credential.

From 20262006c1adf17bdb9bfe30c36f119c3a534434 Mon Sep 17 00:00:00 2001 From: Dave Longley Date: Tue, 29 Jul 2025 13:50:39 -0700 Subject: [PATCH 3/3] Improve clarity and readability of existing proof scenarios. - Enhances technical precision in proof handling descriptions Addresses #422 --- index.html | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/index.html b/index.html index 869d7ac3..5d247ac0 100644 --- a/index.html +++ b/index.html @@ -909,15 +909,15 @@

Issue Credential