DID Vocabulary

More details about this document
This version:
https://w3c.github.io/did/vocab/vocabulary.html
Latest published version:
https://www.w3.org/TR/did-1.1/
Editors:
Ivan Herman (W3C)
Manu Sporny (Digital Bazaar)

This document is also available in these non-normative formats: Turtle and JSON-LD


Abstract

This document describes the DID Vocabulary, i.e., the vocabulary used to ensure the authenticity and integrity of W3C DID Documents, a profile of W3C Controlled Identifier Document.

Alternate versions of the vocabulary definition exist in Turtle and JSON-LD.

Published:
Version Info:
1.1
See Also: https://www.w3.org/TR/did-1.1/

Status of This Document

This document is merely a W3C-internal document. It has no official standing of any kind and does not represent consensus of the W3C Membership.

Comments regarding this document are welcome. Please file issues directly on GitHub, or send them to mailto:public-did-wg@w3.org (subscribe, archives).

Namespaces

This specification makes use a number of external vocabulary namespaces.

Click here for details.
dd
https://www.w3.org/ns/did#
sec
https://w3id.org/security#
act
https://www.w3.org/ns/activitystreams#
dc
http://purl.org/dc/terms/
dcterms
http://purl.org/dc/terms/
owl
http://www.w3.org/2002/07/owl#
rdf
http://www.w3.org/1999/02/22-rdf-syntax-ns#
rdfs
http://www.w3.org/2000/01/rdf-schema#
xsd
http://www.w3.org/2001/XMLSchema#
vs
http://www.w3.org/2003/06/sw-vocab-status/ns#
schema
http://schema.org/
jsonld
http://www.w3.org/ns/json-ld#

@context files

Several @context files make use of the terms defined in this specification.

Click here for details.

Regular terms

Property definitions

The following are property definitions in the dd namespace.

controller

Controller

See also the formal definition of the term.

The property's value should be a URL, i.e., not a literal.

Note

This term is formally defined in another vocabulary (as sec:controller), but is frequently used with this vocabulary and has been included to aid readability of this document.

See also:
DID 1.1 specification
Relevant @contexts:
https://www.w3.org/ns/did/v1.1,
https://w3id.org/security/data-integrity/v2,
https://www.w3.org/ns/cid/v1

alsoKnownAs

Also known as

See also the formal definition of the term.

Note

This term is formally defined in another vocabulary (as act:alsoKnownAs), but is frequently used with this vocabulary and has been included to aid readability of this document.

See also:
DID 1.1 specification
Relevant @context:
https://www.w3.org/ns/did/v1.1

verificationMethod

Verification method

See also the formal definition of the term.

Note

This term is formally defined in another vocabulary (as sec:verificationMethod), but is frequently used with this vocabulary and has been included to aid readability of this document.

See also:
DID 1.1 specification
Relevant @contexts:
https://www.w3.org/ns/did/v1.1,
https://w3id.org/security/data-integrity/v2

authentication

Authentication method

See also the formal definition of the term.

Note

This term is formally defined in another vocabulary (as sec:authentication), but is frequently used with this vocabulary and has been included to aid readability of this document.

See also:
DID 1.1 specification
Type
VerificationRelationship
Relevant @contexts:
https://www.w3.org/ns/did/v1.1,
https://w3id.org/security/data-integrity/v2,
https://www.w3.org/ns/cid/v1

assertionMethod

Assertion method

See also the formal definition of the term.

Note

This term is formally defined in another vocabulary (as sec:assertionMethod), but is frequently used with this vocabulary and has been included to aid readability of this document.

See also:
DID 1.1 specification
Type
VerificationRelationship
Relevant @contexts:
https://www.w3.org/ns/did/v1.1,
https://w3id.org/security/data-integrity/v2,
https://www.w3.org/ns/cid/v1

capabilityDelegationMethod

Capability delegation method

See also the formal definition of the term.

Historically, this property has often been expressed using capabilityDelegation as a shortened term in JSON-LD. Since this shortened term and its mapping to this property are in significant use in the ecosystem, the inconsistency between the short term name (capabilityDelegation) and the property identifier (...#capabilityDelegationMethod) is expected and should not trigger an error.
Note

This term is formally defined in another vocabulary (as sec:capabilityDelegationMethod), but is frequently used with this vocabulary and has been included to aid readability of this document.

See also:
DID 1.1 specification
Type
VerificationRelationship
Relevant @contexts:
https://www.w3.org/ns/did/v1.1,
https://w3id.org/security/data-integrity/v2,
https://www.w3.org/ns/cid/v1

capabilityInvocationMethod

Capability invocation method

See also the formal definition of the term.

Historically, this property has often been expressed using capabilityInvocation as a shortened term in JSON-LD. Since this shortened term and its mapping to this property are in significant use in the ecosystem, the inconsistency between the short term name (capabilityInvocation) and the property identifier (...#capabilityInvocationMethod) is expected and should not trigger an error.
Note

This term is formally defined in another vocabulary (as sec:capabilityInvocationMethod), but is frequently used with this vocabulary and has been included to aid readability of this document.

See also:
DID 1.1 specification
Type
VerificationRelationship
Relevant @contexts:
https://www.w3.org/ns/did/v1.1,
https://w3id.org/security/data-integrity/v2,
https://www.w3.org/ns/cid/v1

keyAgreementMethod

Key agreement protocols

See also the formal definition of the term.

Historically, this property has often been expressed using keyAgreement as a shortened term in JSON-LD. Since this shortened term and its mapping to this property are in significant use in the ecosystem, the inconsistency between the short term name (keyAgreement) and the property identifier (...#keyAgreementMethod) is expected and should not trigger an error.
Note

This term is formally defined in another vocabulary (as sec:keyAgreementMethod), but is frequently used with this vocabulary and has been included to aid readability of this document.

See also:
DID 1.1 specification
Type
VerificationRelationship
Relevant @contexts:
https://www.w3.org/ns/did/v1.1,
https://w3id.org/security/data-integrity/v2,
https://www.w3.org/ns/cid/v1

publicKeyMultibase

Public key multibase

See also the formal definition of the term.

Note

This term is formally defined in another vocabulary (as sec:publicKeyMultibase), but is frequently used with this vocabulary and has been included to aid readability of this document.

Relevant @contexts:
https://www.w3.org/ns/did/v1.1,
https://w3id.org/security/multikey/v1

secretKeyMultibase

Secret key multibase

See also the formal definition of the term.

Note

This term is formally defined in another vocabulary (as sec:secretKeyMultibase), but is frequently used with this vocabulary and has been included to aid readability of this document.

Relevant @contexts:
https://www.w3.org/ns/did/v1.1,
https://w3id.org/security/multikey/v1

publicKeyJwk

Public key JWK

See also the formal definition of the term.

Note

This term is formally defined in another vocabulary (as sec:publicKeyJwk), but is frequently used with this vocabulary and has been included to aid readability of this document.

Relevant @contexts:
https://www.w3.org/ns/did/v1.1,
https://w3id.org/security/jwk/v1

secretKeyJwk

Secret key JWK

See also the formal definition of the term.

Note

This term is formally defined in another vocabulary (as sec:secretKeyJwk), but is frequently used with this vocabulary and has been included to aid readability of this document.

Relevant @contexts:
https://www.w3.org/ns/did/v1.1,
https://w3id.org/security/jwk/v1

service

Service

See the formal definition of the term.

The associated value must be a set of services, where each service is described by a map.
stable
Range:
Service
Relevant @context:
https://www.w3.org/ns/did/v1.1

serviceEndpoint

Service endpoint

See the formal definition of the term.

Refers to the service endpoint, which is a URL that can be used to access the service.

The property's value should be a URL, i.e., not a literal.
stable
Domain:
Service
Relevant @context:
https://www.w3.org/ns/did/v1.1

Class definitions

The following are class definitions in the dd namespace.

Service

Service

See the formal definition of the term.

A service is a set of properties that describe a service endpoint, and should be defined through subclasses to this class. In order to maximize interoperability, the service type and its associated properties should be registered in the  [did-spec-registries].
stable
Range of:
service
Domain of:
serviceEndpoint

VerificationMethod

Verification method

See also the formal definition of the term.

Instances of this class must be denoted by URLs, i.e., they cannot be blank nodes.
Note

This term is formally defined in another vocabulary (as sec:VerificationMethod), but is frequently used with this vocabulary and has been included to aid readability of this document.

Range of:
verificationMethod, authentication, assertionMethod, capabilityDelegationMethod, capabilityInvocationMethod, keyAgreementMethod

VerificationRelationship

Sec : verification relationship

See also the formal definition of the term.

Instances of this class are verification relationships like, for example, authentication or assertionMethod.
Note

This term is formally defined in another vocabulary (as sec:VerificationRelationship), but is frequently used with this vocabulary and has been included to aid readability of this document.

Multikey

Multikey Verification Method

See also the formal definition of the term.

Note

This term is formally defined in another vocabulary (as sec:Multikey), but is frequently used with this vocabulary and has been included to aid readability of this document.

Domain of:
publicKeyMultibase, secretKeyMultibase
Relevant @context:
https://w3id.org/security/multikey/v1

JsonWebKey

JSON Web Key Verification Method

See also the formal definition of the term.

Note

This term is formally defined in another vocabulary (as sec:JsonWebKey), but is frequently used with this vocabulary and has been included to aid readability of this document.

Domain of:
publicKeyJwk, secretKeyJwk
Relevant @context:
https://w3id.org/security/jwk/v1

Datatype definitions

The following are datatype definitions in the dd namespace.

multibase

Datatype for multibase values

See also the formal definition of the term.

Note

This term is formally defined in another vocabulary (as sec:multibase), but is frequently used with this vocabulary and has been included to aid readability of this document.

Derived from:
xsd:string
Range of:
publicKeyMultibase, secretKeyMultibase
Relevant @context:
https://w3id.org/security/multikey/v1