Skip to content

Add appendix with issuance, verification, and presentation examples - #684

Open
eric-schuh wants to merge 2 commits into
w3c:mainfrom
eric-schuh:add_swimlane_examples
Open

Add appendix with issuance, verification, and presentation examples#684
eric-schuh wants to merge 2 commits into
w3c:mainfrom
eric-schuh:add_swimlane_examples

Conversation

@eric-schuh

@eric-schuh eric-schuh commented Jul 28, 2026

Copy link
Copy Markdown
Collaborator

First pass at addressing #561. I added 4 examples:

  • Issuance of a VC (basically @bparth24's example from the issue)
  • Verification of a single VC (using GET /credentials/{id} and having the holder coordinator generate the VP that is sent to the verifier)
  • Verification of multiple VCs (using POST /presentations and having the holder service generate the VP that is sent to the verifier)
  • Presentation of a VC in person

My main question is around the two verification examples and ensuring that they do accurately represent two different ways the holder coordinator and service could behave to achieve nominally the same result.


💥 Error: 500 Internal Server Error 💥

PR Preview failed to build. (Last tried on Aug 4, 2026, 6:50 PM UTC).

More

PR Preview relies on a number of web services to run. There seems to be an issue with the following one:

🚨 Spec Generator - Spec Generator is the web service used to build bikeshed/ReSpec specs

🔗 Related URL

Error output:

EISDIR: illegal operation on a directory, open 'uploads/fyOU3y/'

This seems to be an issue with the Spec Generator service. PR Preview doesn't manage this service and so has no control over it. If you've identified an issue with it, you can report the issue to the maintainers of Spec Generator directly. Please be courteous. Thank you!

If you don't have enough information above to solve the error by yourself or if the issue doesn't seem related to Spec Generator, you can file an issue with PR Preview.

Adding sequence diagrams that detail simple examples of issuance, verification--of both a single, and multiple VCs, and in person presentation of a VC.
Comment thread index.html Outdated
Comment thread index.html Outdated
Comment thread index.html Outdated
Comment thread index.html Outdated
Co-authored-by: Ted Thibodeau Jr <tthibodeau@openlinksw.com>

@dlongley dlongley left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Preview not working so hard to review visually, but noticed a spelling mistake. If we can't get the preview working reviewers can paste the mermaid into another tool, but ideally we get that fixed here.

Comment thread index.html
Note left of VWF: Initiate exchange including the created VP.

VWF->>VC: Validate VP
VC->>VC: Apply buisiness rules

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
VC->>VC: Apply buisiness rules
VC->>VC: Apply business rules

Comment thread index.html
Note left of VWF: Initiate exchange including the requested VP.

VWF->>VC: Validate VP
VC->>VC: Apply buisiness rules

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
VC->>VC: Apply buisiness rules
VC->>VC: Apply business rules

Comment thread index.html
Note left of IWF: Initiate exchange by POSTing an empty JSON object.

IWF->>IC: Coordinate
IC->>IC: Apply buisiness rules

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
IC->>IC: Apply buisiness rules
IC->>IC: Apply business rules

@dlongley dlongley left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looked at the sequence diagrams via another mermaid tool. They aren't correct as they have the workflow service talking with the coordinator system to carry out the tasks that it actually carries out.

Additionally, any business rules that can't be encoded into a workflow itself are applied before a workflow -- and any that need to occur after a workflow are handled via redirects, which can be interaction URLs for "interstitial" business rules that enable, for example, a user to "stay their wallet".

We should correct this before merging.

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants