anoncreds visual data model overview

hyperledger / anoncreds-spec

The specification for AnonCreds verifiable credential exchange.

https://hyperledger.github.io/anoncreds-spec/

Apache License 2.0

47 stars 24 forks source link

anoncreds visual data model overview #88

Closed ArPhil closed 2 years ago

ArPhil commented 2 years ago

This is an initial commit for a high level overview of the AnonCreds data object model. Things to consider:

Is the level of detail enough or maybe even too much?
Do we have to include the Verifier more into this?
Is just mentioning the Tails file enough, instead of explaining its function in detail?
Which members / childs for each of the AnonCreds data objects do we have to provide? Do we have to give at this point (introduction) all the details or just the most important ones in order to be able to give the overview explanation?

swcurran commented 2 years ago

Looks good! I think missing from this and our description so far is that there is a "Private Revocation Registry" component that is much like the Private Credential Definition -- with some cryptographic material needed in creating the Revocation Registry Entries.

swcurran commented 2 years ago

And...I just read @wip-abramson section on Revocation and see that the cryptographic material that I was thinking about is stored in the Credential Definition in AnonCreds. So...never mind on my previous comment.

ArPhil commented 2 years ago

@swcurran, @victormartinez-work , please have a look at the simplified version of the AnonCreds Overview diagram and explanation below. After incorporating the feedback from the last call, I blieve it is OK now.

victormartinez-work commented 2 years ago

@ArPhil it looks fantastic to me. I have a suggestion and I'm happy to contribute to the suggestion if you agree with it. How about if we overlay or change the layout of the diagram based on the trust triangle (https://www.w3.org/TR/vc-data-model/diagrams/ecosystem.svg)? So it is maybe easier to understand each object which role belongs to?

swcurran commented 2 years ago

Outstanding! I had a few tweaks to the text, but the drawing is excellent. I like the drawing now, and I like Victor's idea -- I'm OK either way. We have someone on our team that is excellent at this type of imagery. How about I send him the two images and get his thoughts (and hopefully skills) in putting the two images together?

Happy to merge with the image we have today.

ArPhil commented 2 years ago

@ArPhil it looks fantastic to me. I have a suggestion and I'm happy to contribute to the suggestion if you agree with it. How about if we overlay or change the layout of the diagram based on the trust triangle (https://www.w3.org/TR/vc-data-model/diagrams/ecosystem.svg)? So it is maybe easier to understand each object which role belongs to?

@victormartinez-work, I like the idea. @swcurran, feel free to send the images to your team. Happy to see "the merge" of the two images! :-)