Skip to content

Commit 12f34a0

Browse files
Apply suggestions from Paul's review
Co-authored-by: Paul Bastian <[email protected]>
1 parent 90de936 commit 12f34a0

File tree

1 file changed

+21
-21
lines changed

1 file changed

+21
-21
lines changed

openid-4-verifiable-presentations-1_0.md

+21-21
Original file line numberDiff line numberDiff line change
@@ -560,7 +560,7 @@ If the Verifier responds with any HTTP error response, the Wallet MUST terminate
560560
The Verifiable Presentation Query Language (VP Query) is a JSON-encoded query
561561
language that allows the Verifier to request the Wallet to present Verifiable
562562
Credentials that match the query. The Verifier MAY encode constraints on the
563-
combinations of credentials and claims that may be returned. The Wallet evaluates the
563+
combinations of credentials and claims that are requested. The Wallet evaluates the
564564
query against the Verifiable Credentials it holds and returns the Verifiable
565565
Presentations that match the query.
566566

@@ -572,10 +572,10 @@ top-level properties:
572572
that specify the requested Verifiable Credentials.
573573

574574
`valid_credential_sets`:
575-
: OPTIONAL. A non-empty array containing arrays of identifiers for elements in
575+
: OPTIONAL. A non-empty array containing arrays of identifiers for Credential Queries defined in
576576
`expect_credentials` that defines which sets of Credentials may be returned.
577577
The identifier MAY be postfixed by `?`, indicating that
578-
delivery of the the respective credential is optional. For details, see
578+
delivery of the the respective Credential is optional. For details, see
579579
(#vp_query_lang_processing_rules).
580580

581581
Note: While this specification does not define additional top-level properties,
@@ -585,24 +585,24 @@ the Wallet when processing the query.
585585
## Credential Query {#credential_query}
586586

587587
A Credential Query is an object representing a request for one specific
588-
credential.
588+
Credential.
589589

590590
It contains the following properties:
591591

592592
`id`:
593-
: REQUIRED. A string identifying the credential in the response and, if provided,
593+
: REQUIRED. A string identifying the Credential in the response and, if provided,
594594
the constraints in `valid_credential_sets`.
595595

596596
`format`:
597597
: REQUIRED. A string that specifies the format of the requested
598-
Verifiable Credential. Valid Credential format identifier values are defined in
598+
Verifiable Credential. Valid Credential Format Identifier values are defined in
599599
Appendix A of [@!OpenID.VCI]. The value of this property MUST be one of the
600-
supported Credential formats as defined in the Wallet's metadata.
600+
supported Credential Formats as defined in the Wallet's metadata.
601601

602602
`expect_meta`:
603603
: OPTIONAL. An object defining additional properties requested by the Verifier that
604-
apply to the metadata and validity data of the credential. The properties of
605-
this object are defined per format in (#format_specific_properties). If omitted,
604+
apply to the metadata and validity data of the Credential. The properties of
605+
this object are defined per Credential Format in (#format_specific_properties). If omitted,
606606
no specific restrictions are placed on the metadata or validity of the requested
607607
Credential.
608608

@@ -627,17 +627,17 @@ Within the particular `expected_claims` array, the same `id` MUST NOT
627627
be present more than once.
628628

629629
`path`:
630-
: REQUIRED if the credential format uses a JSON-based claims structure; MUST NOT
630+
: REQUIRED if the Credential Format uses a JSON-based claims structure; MUST NOT
631631
be present otherwise. The value MUST be a claims path pointer that specifies the path to the claim
632632
within the Verifiable Credential, as defined in (#claims_path_pointer).
633633

634634
`namespace`:
635-
: REQUIRED if the credential format is based on ISO 18013-5; MUST NOT be present otherwise.
635+
: REQUIRED if the Credential Format is based on mdoc format defined in ISO 18013-5; MUST NOT be present otherwise.
636636
The value MUST be a string that specifies the namespace of the claim
637637
within the Verifiable Credential, e.g., `org.iso.18013.5.1`.
638638

639639
`claim_name`:
640-
: REQUIRED if the credential format is based on ISO 18013-5; MUST NOT be present otherwise.
640+
: REQUIRED if the Credential Format is based on mdoc format defined in ISO 18013-5; MUST NOT be present otherwise.
641641
The value MUST be a string that specifies the name of the claim within the provided namespace
642642
in the Verifiable Credential, e.g., `first_name`.
643643

@@ -667,15 +667,15 @@ The following rules apply for selecting claims via `expect_claims` and `valid_cl
667667
`valid_claim_sets`, with optional claims marked by the postfix `?`.
668668

669669
If the Wallet cannot fulfill the request by the Verifier, it MUST NOT
670-
return the respective credential.
670+
return the respective Credential.
671671

672672
#### Selecting Credentials
673673

674-
The following rules apply for selecting credentials via `expect_credentials` and `valid_credential_sets`:
674+
The following rules apply for selecting Credentials via `expect_credentials` and `valid_credential_sets`:
675675

676676
- If `valid_credential_sets` is not provided, the Verifier expects all
677-
credentials in `expect_credentials` to be returned.
678-
- Otherwise, the Verifier expects one combination of the credentials
677+
Credentials in `expect_credentials` to be returned.
678+
- Otherwise, the Verifier expects one combination of the Credentials
679679
listed in `valid_credential_sets`, with optional credentials marked by the postfix `?`.
680680

681681
Credentials not matching the respective restrictions expressed within
@@ -725,10 +725,10 @@ TBD
725725

726726
A claims path pointer is a pointer into the JSON structure of the Verifiable
727727
Credential, identifying one or more claims. A claims path pointer MUST be a
728-
non-empty array of strings and non-negative integers. A `*` string value indicates
729-
that all elements of the currently selected array(s) are to be selected; any other
730-
string indicates that the respective key is to be selected; and a non-negative
731-
integer indicates that the respective index in an array is to be selected. The path
728+
non-empty array of strings and non-negative integers. A string value
729+
indicates that the respective key is to be selected, the special string value `*`
730+
indicates that all elements of the currently selected array(s) are to be selected;
731+
and a non-negative integer indicates that the respective index in an array is to be selected. The path
732732
is formed as follows:
733733

734734
- Start with an empty array.
@@ -784,7 +784,7 @@ claims:
784784

785785
In detail, the array is processed by the Wallet from left to right as follows:
786786

787-
1. Select the root element of the credential, i.e., the top-level JSON object.
787+
1. Select the root element of the Credential, i.e., the top-level JSON object.
788788
2. Process the query components from left to right:
789789
1. If the query component is a string, select the element in the respective
790790
key in the currently selected element(s). If any of the currently

0 commit comments

Comments
 (0)