Skip to content

Remove or add into algorithms the unthrown errors in specification #265

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

Merged
dmitrizagidulin merged 6 commits into from
Jan 22, 2026
Merged

Remove or add into algorithms the unthrown errors in specification #265

Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
4d8406c
add warning about self attested metadata
wip-abramson Sep 29, 2025
4da31d3
Apply grammar fix
wip-abramson Oct 2, 2025
e45a678
Remove spec text should from text
wip-abramson Oct 10, 2025
b769e2a
remove unnecessary public key errors
wip-abramson Jan 6, 2026
de07c05
remove public key errors from http status code table
wip-abramson Jan 6, 2026
a65d403
add unthrown errors into the DID resolution algorithm
wip-abramson Jan 6, 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
83 changes: 36 additions & 47 deletions index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -900,6 +900,25 @@ <h2>DID Resolution Algorithm</h2>
<li><b>didDocumentMetadata</b>: <code>«[ ]»</code></li>
</ol>
</li>
<li>
Determine whether the <var>input <a href="#did-resolution-options">DID resolution options</a></var>
are supported by the <a>DID resolver</a> that implements this algorithm. If not, the <a>DID resolver</a>
MUST return the following result:
<ol class="algorithm">
<li><b>didResolutionMetadata</b>: <var>error object</var> with type set to <a href="#FEATURE_NOT_SUPPORTED">FEATURE_NOT_SUPPORTED</a></li>
<li><b>didDocument</b>: <code>null</code></li>
<li><b>didDocumentMetadata</b>: <code>«[ ]»</code></li>
</ol>
</li>
<li>
Determine whether the <var>input <a href="#did-resolution-options">DID resolution options</a></var>
are valid. If not, the <a>DID resolver</a> MUST return the following result:
<ol class="algorithm">
<li><b>didResolutionMetadata</b>: <var>error object</var> with type set to <a href="#INVALID_OPTIONS">INVALID_OPTIONS</a></li>
<li><b>didDocument</b>: <code>null</code></li>
<li><b>didDocumentMetadata</b>: <code>«[ ]»</code></li>
</ol>
</li>
<li>Obtain the <a>DID document</a> for the <var>input <a>DID</a></var> by executing the
<a href="https://www.w3.org/TR/did-core/#method-operations">Read</a> operation, as defined by the <var>input <a>DID method</a></var>:
<ol class="algorithm">
Expand Down Expand Up @@ -959,6 +978,16 @@ <h2>DID Resolution Algorithm</h2>
</li>
</ol>

<p>
If the <a>DID resolver</a> encounters any unexpected errors during the execution of the DID Resolution algorithm,
it MUST return the following result:
<ol class="algorithm">
<li><b>didResolutionMetadata</b>: <var>error object</var> with type set to <a href="#INTERNAL_ERROR">INTERNAL_ERROR</a></li>
<li><b>didDocument</b>: <code>null</code></li>
<li><b>didDocumentMetadata</b>: <code>«[ ]»</code></li>
</ol>
</p>

</section>

</section>
Expand Down Expand Up @@ -1049,7 +1078,7 @@ <h1>DID URL Dereferencing</h1>

<p>
All [=conforming DID URL dereferencers=] MUST implement the [=DID URL dereferencing=]
function for at least one [=DID method=]. All inputs and outputs of the <code>dereference</code>
function for at least one [=DID method=]. All inputs and outputs of the <code>dereference</code>
function apart from [=contentStream=] MUST be serializable to JSON.
</p>

Expand Down Expand Up @@ -2265,26 +2294,10 @@ <h1>Errors</h1>
</dd>
<dt id="FEATURE_NOT_SUPPORTED">FEATURE_NOT_SUPPORTED</dt>
<dd>
The <a>DID resolver</a> does not support the requested feature. The value of the `detail` field SHOULD provide a longer description of the feature that is not supported by the resolver.
The <a>DID resolver</a> does not support the requested feature. The value of the `detail` field
SHOULD provide a longer description of the feature that is not supported by the resolver.
</dd>
<dt id="INVALID_PUBLIC_KEY">https://w3id.org/security#INVALID_PUBLIC_KEY</dt>
<dd>
An invalid public key value is detected during <a>DID Resolution</a> or <a>DID URL dereferencing</a>.
</dd>
<dt id="INVALID_PUBLIC_KEY_LENGTH">https://w3id.org/security#INVALID_PUBLIC_KEY_LENGTH</dt>
<dd>
The byte length of <i>rawPublicKeyBytes</i> did not match the expected public key length for the associated multicodecValue
during <a>DID Resolution</a> or <a>DID URL dereferencing</a>.
</dd>
<dt id="INVALID_PUBLIC_KEY_TYPE">https://w3id.org/security#INVALID_PUBLIC_KEY_TYPE</dt>
<dd>
An invalid public key type was detected during <a>DID Resolution</a> or <a>DID URL dereferencing</a>.
</dd>
<dt id="UNSUPPORTED_PUBLIC_KEY_TYPE">https://w3id.org/security#UNSUPPORTED_PUBLIC_KEY_TYPE</dt>
<dd>
An unsupported public key type was detected during <a>DID Resolution</a> or <a>DID URL dereferencing</a>.
</dd>
</dl>
</dl>
<dl>
</dl>

Expand Down Expand Up @@ -2454,33 +2467,9 @@ <h2>HTTP(S) Binding</h2>
<code>501</code>
</td>
</tr>
<tr>
<td>
<code>INVALID_PUBLIC_KEY</code>
</td>
<td>
<code>500</code>
</td>
</tr>
<tr>
<td>
<code>INVALID_PUBLIC_KEY_LENGTH</code>
</td>
<td>
<code>500</code>
</td>
</tr>
<tr>
<td>
<code>INVALID_PUBLIC_KEY_TYPE</code>
</td>
<td>
<code>500</code>
</td>
</tr>
<tr>
<tr>
<td>
<code>UNSUPPORTED_PUBLIC_KEY_TYPE</code>
<code>FEATURE_NOT_SUPPORTED</code>
</td>
<td>
<code>501</code>
Expand Down Expand Up @@ -2803,7 +2792,7 @@ <h2>Resolution Cycles</h2>
<h1>Privacy Considerations</h1>

<p>
This section details the privacy considerations specific to DID Resolution.
This section details the privacy considerations specific to DID Resolution.
Readers are urged to familiarize themselves with the general
privacy advice provided in the
<a href="https://www.w3.org/TR/did-1.1/#privacy-considerations">
Expand Down