Skip to content

Define "present credential requests" algorithm. #419

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.

Sign up for GitHub

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

Open
marcoscaceres wants to merge 5 commits into
base: main
Choose a base branch
from
Open

Define "present credential requests" algorithm. #419

Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
db99148
Define "Present credential requests" algorithm.
marcoscaceres Dec 16, 2025
6f2ab6e
Don't pass document and cleanup
marcoscaceres Jan 8, 2026
4a2fb73
use new aliases and cleanup
marcoscaceres Jan 9, 2026
fd2b479
Relocate protocol variable
marcoscaceres Jan 9, 2026
a98d215
Add back the Abort the credential request section
marcoscaceres Jan 9, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
114 changes: 114 additions & 0 deletions index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -666,6 +666,120 @@ <h3>
<p>
To be written.
</p>
<h3>
Present the credential request
</h3>
<p>
To <dfn data-dfn-for="credential request coordinator">present the
credential request</dfn> given a [=Document=] |document|, a [=sequence=]
of validated credential requests |validatedRequests|, and an optional
{{AbortSignal}} |signal|:
</p>
<ol class="algorithm">
<li>Let |requestData| be [=struct=] consisting of |validatedRequests|,
|document|'s [=relevant settings object=]'s [=environment settings
object/origin=], and |document|'s [=Document/origin=].
</li>
<li>Present a [=credential chooser=] with |requestData| and wait for the
user to either:
<ul>
<li>Select a [=digital credential=] and [=holder=] that can fulfill
the request, or
</li>
<li>Cancel the operation.
</li>
</ul>
</li>
<li>If |signal| was passed and |signal| is [=AbortSignal/aborted=]:
<ol>
<li>Return.
<p class="note" title="Abort already handled">
The algorithm [=AbortSignal/add|added=] to |signal| by the
[=credential request coordinator/prepare credential requests=]
steps handle tearing down the [=credential chooser=].
</p>
</li>
</ol>
</li>
<li>If the user cancels the operation or no credential was selected:
<ol>
<li>Let |error| be a newly created {{"AbortError"}} {{DOMException}}.
</li>
<li>[=credential request coordinator/Complete credential request
with=] |error|.
</li>
<li>Return.
</li>
</ol>
</li>
<li>If the platform returns a platform-specific error:
<ol>
<li>Let |error| be the appropriate {{DOMException}} for that error.
</li>
<li>[=credential request coordinator/Complete credential request
with=] |error|.
</li>
<li>Return.
</li>
</ol>
</li>
<li>If a [=digital credential=] was selected by the user:
<ol>
<li>Let |responseData| be a [=string=] [=digital
credential/presentation response=] or [=string=] [=digital
credential/issuance response=] returned by the [=holder=].
</li>
<li>Let |parsedDataOrError| be the result of [=parse a JSON string to
a JavaScript value=] passing |responseData|.
</li>
<li>If |parsedDataOrError| is an [=exception=]:
<ol>
<li>[=credential request coordinator/Complete credential request
with=] |parsedDataOrError|.
</li>
<li>Return.
</li>
</ol>
</li>
<li>If |parsedDataOrError| is not an [=object=]:
<ol>
<li>Let |error| be a newly created {{TypeError}}.
</li>
<li>[=credential request coordinator/Complete credential request
with=] |error|.
</li>
<li>Return.
</li>
</ol>
</li>
<li>Let |protocol| be the [=digital credential/exchange protocol=] or
[=digital credential/issuance protocol=] identifier used in the
exchange.
</li>
<li>Let |credential| be a new {{DigitalCredential}} object with its
{{DigitalCredential/data}} set to |parsedDataOrError| and its
{{DigitalCredential/protocol}} set to |protocol|.
</li>
<li>[=Queue a global task=] on the [=DOM manipulation task source=]
given |document|'s [=relevant global object=] to perform the
following steps:
<ol>
<li>Set the [=credential request coordinator=] [=credential
request coordinator/interaction state=] to "[=credential request
coordinator/idle=]".
</li>
<li>[=Resolve=] the [=credential request coordinator=]'s
[=credential request coordinator/active promise=] with
|credential|.
</li>
<li>Set the [=credential request coordinator=]'s [=credential
request coordinator/active promise=] to `null`.
</li>
</ol>
</li>
</ol>
</li>
</ol>
<h3>
Complete credential request with error
</h3>
Expand Down
Loading