This document serves as a collection of known DID Resolution and Dereferencing extensions.
Comments regarding this document are welcome. Please file issues directly on GitHub, or send them to public-did-wg@w3.org ( subscribe, archives).
Portions of the work on this specification have been funded by the United States Department of Homeland Security's Science and Technology Directorate under contracts HSHQDC-16-R00012-H-SB2016-1-002, 70RSAT20T00000010, and HSHQDC-17-C-00019. The content of this specification does not necessarily reflect the position or the policy of the U.S. Government and no official endorsement should be inferred.
Work on this registry has also been supported by the Rebooting the Web of Trust community facilitated by Christopher Allen, Shannon Appelcline, Kiara Robles, Brian Weller, Betty Dhamers, Kaliya Young, Kim Hamilton Duffy, Manu Sporny, Drummond Reed, Joe Andrieu, and Heather Vescent, Dmitri Zagidulin, and Dan Burnett.
This document serves as a collection of known DID Resolution and Dereferencing extensions.
The registration process is described in the [[[DID-EXTENSIONS]]].
This table provides a reference for media types and the associated specifications for producing and consuming those representations.
| Media Type | Specification |
|---|---|
| application/did+json | DID Core |
| application/did+ld+json | DID Core |
| application/did+cbor | The Plain CBOR Representation |
These are entries in DID documents that are specific to the JSON representation.
(No entries yet)
These are entries in DID documents that are specific to the JSON-LD representation.
| Normative Definition |
|---|
| DID Core |
The following values are acceptable values for the @context entry as
a JSON
String or first item of a JSON Array,
represented as a JSON
String.
| `@context` Values | Specification Version |
|---|---|
| https://www.w3.org/ns/did/v1 | DID Core 1.0 Working draft |
{
"@context": [
"https://www.w3.org/ns/did/v1",
"https://example.com/blockchain-identity/v1"
],
...
}
These are entries in DID documents that are specific to the CBOR representation.
(No entries yet)
These properties contain information pertaining to the DID resolution request.
| Normative Definition | |
|---|---|
| DID Core |
{
"accept": "application/did+ld+json"
}
These properties contain information pertaining to the DID resolution response.
| Normative Definition | |
|---|---|
| DID Core |
{
"contentType": "application/did+ld+json"
}
| Normative Definition | |
|---|---|
| DID Resolution, DID Core v1.0 |
{
"error": {
"type": "https://www.w3.org/ns/did#NOT_FOUND",
"title": "DID not found"
}
}
| Normative Definition | URL |
|---|---|
| DID Resolution, DID Core v1.0 |
https://www.w3.org/ns/did#INVALID_DID
|
{
"error": {
"type": "https://www.w3.org/ns/did#INVALID_DID",
"title": "Invalid DID"
}
}
| Normative Definition | URL |
|---|---|
| DID Resolution |
https://www.w3.org/ns/did#INVALID_DID_DOCUMENT
|
{
"error": {
"type": "https://www.w3.org/ns/did#INVALID_DID_DOCUMENT",
"title": "Invalid DID document"
}
}
| Normative Definition | URL |
|---|---|
| DID Resolution, DID Core v1.0 |
https://www.w3.org/ns/did#NOT_FOUND
|
{
"error": {
"type": "https://www.w3.org/ns/did#NOT_FOUND",
"title": "DID not found"
}
}
| Normative Definition | URL |
|---|---|
| DID Resolution, DID Core v1.0 |
https://www.w3.org/ns/did#REPRESENTATION_NOT_SUPPORTED
|
{
"error": {
"type": "https://www.w3.org/ns/did#REPRESENTATION_NOT_SUPPORTED",
"title": "Representation not supported"
}
}
| Normative Definition | URL |
|---|---|
| DID Resolution |
https://www.w3.org/ns/did#METHOD_NOT_SUPPORTED
|
{
"error": {
"type": "https://www.w3.org/ns/did#METHOD_NOT_SUPPORTED",
"title": "DID method not supported"
}
}
| Normative Definition | URL |
|---|---|
| DID Resolution |
https://www.w3.org/ns/did#INVALID_OPTIONS
|
{
"error": {
"type": "https://www.w3.org/ns/did#INVALID_OPTIONS",
"title": "Invalid options"
}
}
| Normative Definition | URL |
|---|---|
| DID Resolution |
https://www.w3.org/ns/did#INTERNAL_ERROR
|
{
"error": {
"type": "https://www.w3.org/ns/did#INTERNAL_ERROR",
"title": "Internal error"
}
}
| Normative Definition | URL |
|---|---|
| DID Resolution |
https://www.w3.org/ns/did#FEATURE_NOT_SUPPORTED
|
{
"error": {
"type": "https://www.w3.org/ns/did#FEATURE_NOT_SUPPORTED",
"title": "Feature not supported"
}
}
This error is deprecated. Its definition was removed from DID Resolution in January 2026 and no other specification defines it.
| Normative Definition | URL |
|---|---|
| DID Resolution (28 November 2024 Working Draft) | None defined |
{
"error": "invalidPublicKey"
}
This error is deprecated. Its definition was removed from DID Resolution in January 2026 and no other specification defines it.
| Normative Definition | URL |
|---|---|
| DID Resolution (28 November 2024 Working Draft) | None defined |
{
"error": "invalidPublicKeyLength"
}
This error is deprecated. Its definition was removed from DID Resolution in January 2026 and no other specification defines it.
| Normative Definition | URL |
|---|---|
| DID Resolution (28 November 2024 Working Draft) | None defined |
{
"error": "invalidPublicKeyType"
}
This error is deprecated. Its definition was removed from DID Resolution in January 2026 and no other specification defines it.
| Normative Definition | URL |
|---|---|
| DID Resolution (28 November 2024 Working Draft) | None defined |
{
"error": "unsupportedPublicKeyType"
}
| Normative Definition | URL |
|---|---|
| DID Spec Extension: notAllowedVerificationMethodType | None defined |
{
"error": "notAllowedVerificationMethodType"
}
| Normative Definition | URL |
|---|---|
| DID Spec Extension: notAllowedKeyType | None defined |
{
"error": "notAllowedKeyType"
}
| Normative Definition | URL |
|---|---|
| DID Spec Extension: notAllowedMethod | None defined |
{
"error": "notAllowedMethod"
}
| Normative Definition | URL |
|---|---|
| DID Spec Extension: notAllowedCertificate | None defined |
{
"error": "notAllowedCertificate"
}
| Normative Definition | URL |
|---|---|
| DID Spec Extension: notAllowedLocalDuplicateKey | None defined |
{
"error": "notAllowedLocalDuplicateKey"
}
| Normative Definition | URL |
|---|---|
| DID Spec Extension: notAllowedLocalDerivedKey | None defined |
{
"error": "notAllowedLocalDerivedKey"
}
| Normative Definition | URL |
|---|---|
| DID Spec Extension: notAllowedGlobalDuplicateKey | None defined |
{
"error": "notAllowedGlobalDuplicateKey"
}
These properties contain information pertaining to the DID dereferencing response.
| Normative Definition | |
|---|---|
| DID Resolution, DID Core v1.0 |
{
"error": {
"type": "https://www.w3.org/ns/did#NOT_FOUND",
"title": "Not found"
}
}
| Normative Definition | URL |
|---|---|
| DID Resolution, DID Core v1.0 |
https://www.w3.org/ns/did#INVALID_DID_URL
|
{
"error": {
"type": "https://www.w3.org/ns/did#INVALID_DID_URL",
"title": "Invalid DID URL"
}
}
| Normative Definition | URL |
|---|---|
| DID Resolution, DID Core v1.0 |
https://www.w3.org/ns/did#NOT_FOUND
|
{
"error": {
"type": "https://www.w3.org/ns/did#NOT_FOUND",
"title": "Not found"
}
}
These properties contain information pertaining to the DID document itself, rather than the DID subject.
See DID Core #203.
| Normative Definition | JSON-LD |
|---|---|
| DID Core | DID Core |
{
"created": "2019-03-23T06:35:22Z"
}
See DID Core #203.
| Normative Definition | JSON-LD |
|---|---|
| DID Core | DID Core |
{
"updated": "2023-08-10T13:40:06Z"
}
| Normative Definition | JSON-LD |
|---|---|
| DID Core | DID Core |
{
"deactivated": true
}
| Normative Definition | JSON-LD |
|---|---|
| DID Core | DID Core |
{
"nextUpdate": "2023-08-10T13:40:06Z"
}
| Normative Definition | JSON-LD |
|---|---|
| DID Core | DID Core |
{
"versionId": "bafyreifederejlobaec6kwpl2mc3tw7qk3j3ey4uytkbiw2qw7dzylud6i"
}
| Normative Definition | JSON-LD |
|---|---|
| DID Core | DID Core |
{
"nextVersionId": "bafyreifederejlobaec6kwpl2mc3tw7qk3j3ey4uytkbiw2qw7dzylud6i"
}
| Normative Definition | JSON-LD |
|---|---|
| DID Core | DID Core |
{
"equivalentId": ["did:example:ABC", "did:example:Abc"]
}
| Normative Definition | JSON-LD |
|---|---|
| DID Core | DID Core |
{
"canonicalId": "did:example:ABC"
}
| Normative Definition |
|---|
| DID Core |
did:example:123?hl=zQmWvQxTqbG2Z9HPJgG57jjwR154cKhbtJenbyYTWkjgF3e
| Normative Definition |
|---|
| DID Core |
did:example:123?service=agent
| Normative Definition |
|---|
| DID Core |
did:example:123?versionId=4
| Normative Definition |
|---|
| DID Core |
did:example:123?versionTime=2016-10-17T02:41:00Z
| Normative Definition |
|---|
| DID Core |
did:example:123?service=files&relativeRef=%2Fmyresume%2Fdoc%3Fversion%3Dlatest%23intro
| Normative Definition |
|---|
| DID Spec Extensions by DIF |
did:example:123?initialState=eyJkZWx0YV9oYXNoIjoiRWlDUlRKZ2Q0U0V2YUZDLW9fNUZjQnZJUkRtWF94Z3RLX3g...
| Normative Definition |
|---|
| DID Spec Extensions by DIF |
did:example:123?transformKeys=jwk
| Normative Definition |
|---|
| DID Spec Extensions by DIF |
did:example:123?signedIetfJsonPatch=eyJraWQiOiJkaWQ6ZXhhbXBsZTo0NTYjX1FxMFVMMkZxNjUxUTBGamQ2VH...
| Normative Definition |
|---|
| DID URL Resource Parameter Specification |
did:foo:21tDAKCERh95uGgKbJNHYp?resource=true