HTTP/2 200
server: GitHub.com
content-type: text/html; charset=utf-8
last-modified: Mon, 29 Sep 2025 23:14:03 GMT
access-control-allow-origin: *
etag: W/"68db12bb-9108"
expires: Fri, 10 Oct 2025 07:37:07 GMT
cache-control: max-age=600
content-encoding: gzip
x-proxy-cache: MISS
x-github-request-id: 5F65:C0BFA:13AABA:177ABB:68E8B54B
accept-ranges: bytes
age: 0
date: Fri, 10 Oct 2025 07:27:07 GMT
via: 1.1 varnish
x-served-by: cache-bom-vanm7210078-BOM
x-cache: MISS
x-cache-hits: 0
x-timer: S1760081227.412489,VS0,VE322
vary: Accept-Encoding
x-fastly-request-id: aaff768d6c844abaa7328d3aabce43e5d632cde1
content-length: 5889
DID Resolution Extensions
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.
Representations
This table provides a reference for media types and the associated specifications for producing and consuming those representations.
Representation-Specific Entries
JSON
These are entries in DID documents that are specific to the
JSON representation.
(No entries yet)
JSON-LD
These are entries in DID documents that are specific to the
JSON-LD representation.
@context
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": [
"carview.php?tsp=https://www.w3.org/ns/did/v1",
"https://example.com/blockchain-identity/v1"
],
...
}
CBOR
These are entries in DID documents that are specific to the
CBOR representation.
(No entries yet)
DID Resolution Options
These properties contain information pertaining to the DID resolution request.
accept
{
"accept": "application/did+ld+json"
}
DID Resolution Metadata
These properties contain information pertaining to the DID resolution response.
contentType
{
"contentType": "application/did+ld+json"
}
error
{
"error": "notFound"
}
invalidDid
{
"error": "invalidDid"
}
notFound
{
"error": "notFound"
}
representationNotSupported
{
"error": "representationNotSupported"
}
methodNotSupported
{
"error": "methodNotSupported"
}
internalError
{
"error": "internalError"
}
invalidPublicKey
{
"error": "invalidPublicKey"
}
invalidPublicKeyLength
{
"error": "invalidPublicKeyLength"
}
invalidPublicKeyType
{
"error": "invalidPublicKeyType"
}
unsupportedPublicKeyType
{
"error": "unsupportedPublicKeyType"
}
notAllowedVerificationMethodType
{
"error": "notAllowedVerificationMethodType"
}
notAllowedKeyType
{
"error": "notAllowedKeyType"
}
notAllowedMethod
{
"error": "notAllowedMethod"
}
notAllowedCertificate
{
"error": "notAllowedCertificate"
}
notAllowedLocalDuplicateKey
{
"error": "notAllowedLocalDuplicateKey"
}
notAllowedLocalDerivedKey
{
"error": "notAllowedLocalDerivedKey"
}
notAllowedGlobalDuplicateKey
{
"error": "notAllowedGlobalDuplicateKey"
}
DID Dereferencing Metadata
These properties contain information pertaining to the DID dereferencing response.
error
{
"error": "notFound"
}
invalidDidUrl
{
"error": "invalidDidUrl"
}
notFound
{
"error": "notFound"
}
DID Document Metadata
These properties contain information pertaining to the DID document itself,
rather than the DID subject.
deactivated
{
"deactivated": true
}
nextUpdate
{
"nextUpdate": "2023-08-10T13:40:06Z"
}
versionId
{
"versionId": "bafyreifederejlobaec6kwpl2mc3tw7qk3j3ey4uytkbiw2qw7dzylud6i"
}
nextVersionId
{
"nextVersionId": "bafyreifederejlobaec6kwpl2mc3tw7qk3j3ey4uytkbiw2qw7dzylud6i"
}
equivalentId
{
"equivalentId": ["did:example:ABC", "did:example:Abc"]
}
canonicalId
{
"canonicalId": "did:example:ABC"
}
Parameters
hl
did:example:123?hl=zQmWvQxTqbG2Z9HPJgG57jjwR154cKhbtJenbyYTWkjgF3e
service
did:example:123?service=agent
versionId
did:example:123?versionId=4
versionTime
did:example:123?versionTime=2016-10-17T02:41:00Z
relativeRef
did:example:123?service=files&relativeRef=%2Fmyresume%2Fdoc%3Fversion%3Dlatest%23intro
initialState
did:example:123?initialState=eyJkZWx0YV9oYXNoIjoiRWlDUlRKZ2Q0U0V2YUZDLW9fNUZjQnZJUkRtWF94Z3RLX3g...
did:example:123?transformKeys=jwk
signedIetfJsonPatch
did:example:123?signedIetfJsonPatch=eyJraWQiOiJkaWQ6ZXhhbXBsZTo0NTYjX1FxMFVMMkZxNjUxUTBGamQ2VH...
resource
did:foo:21tDAKCERh95uGgKbJNHYp?resource=true
