hyperledger / anoncreds-spec

The specification for AnonCreds verifiable credential exchange.
https://hyperledger.github.io/anoncreds-spec/
Apache License 2.0
45 stars 24 forks source link

Add a summary / overview of the data used in the cryptography across all of the AnonCreds interactions #20

Open swcurran opened 2 years ago

swcurran commented 2 years ago

Add a section to the specification that provides an overview of the cryptography data elements used (see example below), with, with reference links (usually [[ref: ]]s) to where those elements are defined.

The original description of this task was to define a "Data Models" section in the specification. Instead, we are putting in the Data Models inline tagged with [[def: ]]-style definitions, and referencing them elsewhere in the specification, including in this overview section.

Original Description: For each data model referenced in the "data flow" documents, define the data structure in JSON and the purpose/meaning and optionality of each item. This includes:

MichScha commented 2 years ago

This is a pretty helpful part for understanding all object and their relations.

I think we should create a list of the individual data objects here with details of exactly where they are created, stored and between which participants they are exchanged (context example credential issuance). I would also add the description of the objects here and instead of linking to the appendix, link the json objects from the chapters. Might be easier to read and understand?

I am just wondering if we should also include something like nonce which the issuer needs to store locally for a later credential issuance. Thats seems to be too detailled.

Just a quick summary out of my mind Local Data Roles (whereas each entity could be in every role)

Data on Verifiable Data Registry (Indy specific Domain Ledger)

Data in motion

I am happy to take over this part if not someone is already working on it.

swcurran commented 2 years ago

I think this is an excellent idea! Having it all in one section would be really good.