OpenID4VCI icon indicating copy to clipboard operation
OpenID4VCI copied to clipboard

claims description mixes display and schema information

Open c2bo opened this issue 1 year ago • 1 comments

Claims description in the metadata is introduced as

A claims description object as used in the Credential Issuer metadata is an object used to describe how a certain claim in the Credential should be displayed to the End-User. It is used in the claims parameter in the Credential Issuer metadata defined in (#format-profiles).

It however seems to contain information that goes more into the realm of schema definitions with

  • value_type which denotes the type of a value (removed in the last PR)
  • claim description that does not contain display - which basically seems to be a signal that this claim exists in the specific credential (especially for claims that are optional in their credential schema)

example for the second part:

...
        {
          "path": ["address"],
          "display": [
            {
              "name": "Place of residence",
              "locale": "en-US"
            },
            {
              "name": "Wohnsitz",
              "locale": "de-DE"
            }
          ]
        },
        {"path": ["address", "street_address"]},
        {"path": ["address", "locality"]},
        {"path": ["address", "region"]},
...

I am not convinced we need both currently as all major credential formats seem to have their own mechanism to convey schema:

  • namespace for mdoc
  • vct for sd-jwt
  • context for w3c vcdm

To me, it feels like both mechanisms are either under-specified or not entirely necessary & seem to duplicate the schema information of the credential formats.

c2bo avatar Dec 17 '24 09:12 c2bo

labelling this 1.1 since both of the structures being questioned are optional so even if we agree to remove etc. that will be a non-breaking change

Sakurann avatar Jan 24 '25 21:01 Sakurann