Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Interpretation of issuer metadata display parameters #376

Open
nemqe opened this issue Aug 15, 2024 · 3 comments
Open

Interpretation of issuer metadata display parameters #376

nemqe opened this issue Aug 15, 2024 · 3 comments

Comments

@nemqe
Copy link
Contributor

nemqe commented Aug 15, 2024

Is there a explanation how the display parameters from the issuer metadata need to be interpreted by the wallet.

I would like to answer some questions like:

  • is display a hint or a requirement for the wallet
  • what should wallet display if the metadata contains no display properties on any level
  • does a missing display property on a credential_configuration level signal that no claims should be shown on the wallet for a particular credential
  • does a missing display property on a claim level signal that the claim in question should be hidden
  • what happens if a specific locale is specified one the credential_configuration level but that locale cannot be found on the claim level
  • ...

Seems this part is a tad under-specified, maybe it is by design for now or maybe I am missing another source of information on this topic.

@Sakurann
Copy link
Collaborator

responding to each of the points (numbering them, so that it is easy to continue the discussion:

  1. i think the intention is for display to be a requirement for the wallet. it is a very important for issuer branding that wallet uses logo, colors, etc as requested by the issuer
  2. if there is no display properties on any level, there is nothing for the wallet to display, so those fields should be empty, no logo, no color, etc.
  3. credential_configuration level display property is for the entire credential, so per point 2. that would mean that credential is displayed but with no display information
  4. claim level display property is for that claim, so per point 2-3. that would mean that claim is displayed but with no display information
  5. what happens if a specific locale is specified one the credential_configuration level but that locale cannot be found on the claim level

i agree a non-normative clarification on these would be helpful

@nemqe
Copy link
Contributor Author

nemqe commented Aug 20, 2024

Thank you for the answer!

Just to repeat to see if my understanding is correct here.

When you say display information we are talking about information carried in the display property for a given level, but that display information is only used to enrich the way how the credential is displayed (style, locale) but it is not used as a signal that certain parts of a credential should not be shown by the wallet.

If I as an issuer would issue a credential without having any display properties in my metadata the wallet should not interpret that as :

  • "Display is missing I do not know what to display so I won't display anything"

but it should interpret it as

  • "Display is missing so I have no requirements on how to style or localize this credential so I should display it using default colors and fonts and locale per my wallet settings"?

If for some of the levels there are display properties we use those and for other we just do the default.

Sorry for potentially silly questions, but we had some discussions lately in the space where people were using for example presence of the claims level display property as a signal that the claim in question should not be displayed to the user at all (akin to css visibility type hidden), so I am just trying to get a baseline of understanding on my end so I know what I need to implement on the issuer side of things.

@ThierryThevenet
Copy link

Hello
To complete, on our side as a wallet provider it seems not possible for us to decide if an attribute should or should not be displayed to the user. Some VCs carry information that does not make sense to the user and therefore it seems normal that the issuer does not want to display them.
So until today the wallet displays the claims that have a "display" attribute and only those that have the attribute. So it is not just a "style" problem.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

3 participants