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.

Introduction

This document serves as a collection of known DID Resolution and Dereferencing extensions.

The Registration Process

The registration process is described in the [[[DID-EXTENSIONS]]].

Representations

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

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

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"
  ],
  ...
}
        

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

Normative Definition
DID Core
{
  "accept": "application/did+ld+json"
}
      

DID Resolution Metadata

These properties contain information pertaining to the DID resolution response.

contentType

Normative Definition
DID Core
{
  "contentType": "application/did+ld+json"
}
      

error

Normative Definition
DID Resolution, DID Core v1.0
{
  "error": {
    "type": "https://www.w3.org/ns/did#NOT_FOUND",
    "title": "DID not found"
  }
}
      

invalidDid

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"
  }
}
        

INVALID_DID_DOCUMENT

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"
  }
}
        

notFound

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"
  }
}
        

representationNotSupported

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"
  }
}
        

methodNotSupported

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"
  }
}
        

INVALID_OPTIONS

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"
  }
}
        

internalError

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"
  }
}
        

FEATURE_NOT_SUPPORTED

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"
  }
}
        

invalidPublicKey

Deprecated

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"
}
        

invalidPublicKeyLength

Deprecated

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"
}
        

invalidPublicKeyType

Deprecated

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"
}
        

unsupportedPublicKeyType

Deprecated

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"
}
        

notAllowedVerificationMethodType

Normative Definition URL
DID Spec Extension: notAllowedVerificationMethodType None defined
{
  "error": "notAllowedVerificationMethodType"
}
        

notAllowedKeyType

Normative Definition URL
DID Spec Extension: notAllowedKeyType None defined
{
  "error": "notAllowedKeyType"
}
        

notAllowedMethod

Normative Definition URL
DID Spec Extension: notAllowedMethod None defined
{
  "error": "notAllowedMethod"
}
        

notAllowedCertificate

Normative Definition URL
DID Spec Extension: notAllowedCertificate None defined
{
  "error": "notAllowedCertificate"
}
        

notAllowedLocalDuplicateKey

Normative Definition URL
DID Spec Extension: notAllowedLocalDuplicateKey None defined
{
  "error": "notAllowedLocalDuplicateKey"
}
        

notAllowedLocalDerivedKey

Normative Definition URL
DID Spec Extension: notAllowedLocalDerivedKey None defined
{
  "error": "notAllowedLocalDerivedKey"
}
        

notAllowedGlobalDuplicateKey

Normative Definition URL
DID Spec Extension: notAllowedGlobalDuplicateKey None defined
{
  "error": "notAllowedGlobalDuplicateKey"
}
        

DID Dereferencing Metadata

These properties contain information pertaining to the DID dereferencing response.

error

Normative Definition
DID Resolution, DID Core v1.0
{
  "error": {
    "type": "https://www.w3.org/ns/did#NOT_FOUND",
    "title": "Not found"
  }
}
      

invalidDidUrl

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"
  }
}
        

notFound

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"
  }
}
        

DID Document Metadata

These properties contain information pertaining to the DID document itself, rather than the DID subject.

created

See DID Core #203.

Normative Definition JSON-LD
DID Core DID Core
{
  "created": "2019-03-23T06:35:22Z"
}
      

updated

See DID Core #203.

Normative Definition JSON-LD
DID Core DID Core
{
  "updated": "2023-08-10T13:40:06Z"
}
      

deactivated

Normative Definition JSON-LD
DID Core DID Core
{
  "deactivated": true
}
      

nextUpdate

Normative Definition JSON-LD
DID Core DID Core
{
  "nextUpdate": "2023-08-10T13:40:06Z"
}
      

versionId

Normative Definition JSON-LD
DID Core DID Core
{
  "versionId": "bafyreifederejlobaec6kwpl2mc3tw7qk3j3ey4uytkbiw2qw7dzylud6i"
}
      

nextVersionId

Normative Definition JSON-LD
DID Core DID Core
{
  "nextVersionId": "bafyreifederejlobaec6kwpl2mc3tw7qk3j3ey4uytkbiw2qw7dzylud6i"
}
      

equivalentId

Normative Definition JSON-LD
DID Core DID Core
{
  "equivalentId": ["did:example:ABC", "did:example:Abc"]
}
      

canonicalId

Normative Definition JSON-LD
DID Core DID Core
{
  "canonicalId": "did:example:ABC"
}
      

Parameters

hl

Normative Definition
DID Core
did:example:123?hl=zQmWvQxTqbG2Z9HPJgG57jjwR154cKhbtJenbyYTWkjgF3e
      

service

Normative Definition
DID Core
did:example:123?service=agent
      

versionId

Normative Definition
DID Core
did:example:123?versionId=4
      

versionTime

Normative Definition
DID Core
did:example:123?versionTime=2016-10-17T02:41:00Z
      

relativeRef

Normative Definition
DID Core
did:example:123?service=files&relativeRef=%2Fmyresume%2Fdoc%3Fversion%3Dlatest%23intro
      

initialState

Normative Definition
DID Spec Extensions by DIF
did:example:123?initialState=eyJkZWx0YV9oYXNoIjoiRWlDUlRKZ2Q0U0V2YUZDLW9fNUZjQnZJUkRtWF94Z3RLX3g...
      

transformKeys

Normative Definition
DID Spec Extensions by DIF
did:example:123?transformKeys=jwk
      

signedIetfJsonPatch

Normative Definition
DID Spec Extensions by DIF
did:example:123?signedIetfJsonPatch=eyJraWQiOiJkaWQ6ZXhhbXBsZTo0NTYjX1FxMFVMMkZxNjUxUTBGamQ2VH...
      

resource

Normative Definition
DID URL Resource Parameter Specification
did:foo:21tDAKCERh95uGgKbJNHYp?resource=true