From a3e9daeb15a89e40bfdb414f493ca6716e19b055 Mon Sep 17 00:00:00 2001 From: jrhender Date: Mon, 27 Jan 2025 14:19:26 -0800 Subject: [PATCH 1/3] Clarifies that exchanges are short-lived Includes guidance on how asynchronous issuance may be implemented. --- index.html | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/index.html b/index.html index 5d260b7..48c3e19 100644 --- a/index.html +++ b/index.html @@ -1122,6 +1122,13 @@

Workflows and Exchanges

These examples will be added later.

+VC API exchanges are expected to be short-lived but they can be combined with other mechanisms to enable longer interactions. +Examples of other mechanisms include SMS, email, web notifications, or phone calls. +This approach simplifies digital wallet implementation. +For example, in asynchronous issuance, a holder requests a credential but must wait for processing. +In such cases, systems outside the VC API notify the holder when their credential is ready for collection. +

+

The following APIs are defined for using workflows and exchanges for credential use cases that require crossing trust boundaries:

From b93e8d08c04db32e6c256be6b7ed23c487cfe447 Mon Sep 17 00:00:00 2001 From: John Henderson Date: Tue, 28 Jan 2025 19:38:21 +0000 Subject: [PATCH 2/3] Clarify relationship between VC API and platforms for long-lived interactions Co-authored-by: Ted Thibodeau Jr Co-authored-by: Dave Longley --- index.html | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/index.html b/index.html index 48c3e19..095f384 100644 --- a/index.html +++ b/index.html @@ -1124,9 +1124,15 @@

Workflows and Exchanges

VC API exchanges are expected to be short-lived but they can be combined with other mechanisms to enable longer interactions. Examples of other mechanisms include SMS, email, web notifications, or phone calls. -This approach simplifies digital wallet implementation. +This approach simplifies digital wallet implementation and allows +existing mechanisms to be reused without reinvention within +the VC API. The Web or native platforms are expected to enable +additional interactions via applications (such as Web browsers) +or other platform features. For example, in asynchronous issuance, a holder requests a credential but must wait for processing. -In such cases, systems outside the VC API notify the holder when their credential is ready for collection. +In such cases, VC API components (such as an issuer coordinator) make +use of mechanisms outside the VC API to notify the holder when their +credential is ready for collection.

The following APIs are defined for using workflows and exchanges for credential use cases that require crossing trust boundaries: From aa1ff9608fe41a294ab7ac65d01bbebbffa4e896 Mon Sep 17 00:00:00 2001 From: Manu Sporny Date: Tue, 4 Feb 2025 15:26:05 -0500 Subject: [PATCH 3/3] Fine tune grammar in short lived exchanges text. --- index.html | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/index.html b/index.html index 095f384..c6f95d4 100644 --- a/index.html +++ b/index.html @@ -1122,14 +1122,14 @@

Workflows and Exchanges

These examples will be added later.

-VC API exchanges are expected to be short-lived but they can be combined with other mechanisms to enable longer interactions. -Examples of other mechanisms include SMS, email, web notifications, or phone calls. +A given interaction with a VC API exchange is expected to be short-lived but other mechanisms can be used to enable longer or multi-stage interactions. +Examples of other interaction mechanisms include SMS, email, web notifications, or phone calls. This approach simplifies digital wallet implementation and allows existing mechanisms to be reused without reinvention within the VC API. The Web or native platforms are expected to enable additional interactions via applications (such as Web browsers) or other platform features. -For example, in asynchronous issuance, a holder requests a credential but must wait for processing. +For example, in asynchronous issuance, a holder requests a credential but waits for processing. In such cases, VC API components (such as an issuer coordinator) make use of mechanisms outside the VC API to notify the holder when their credential is ready for collection.