DID Core Specification Test Suite

5.1.1 DID Subject - The value of id MUST be a string that conforms to the rules in § 3.1 DID Syntax and MUST exist in the root map of the data model for the DID document.

5.1.2 DID Controller - The controller property is OPTIONAL. If present, the value MUST be a string or an ordered set of strings that conform to the rules in § 3.1 DID Syntax.

5.2 Verification Methods - The verificationMethod property is OPTIONAL. If present, the value MUST be an ordered set of verification methods, where each verification method is expressed using a map.

5.2 Verification Methods - The verification method map MUST include the id, type, controller, and specific verification material properties that are determined by the value of type and are defined in § 5.2.1 Verification Material.

5.2 Verification Methods - The value of the id property for a verification method MUST be a string that conforms to the rules in Section § 3.2 DID URL Syntax.

5.2 Verification Methods - The value of the type property MUST be a string that references exactly one verification method type.

5.2 Verification Methods - The value of the controller property MUST be a string that conforms to the rules in § 3.1 DID Syntax.

5.2 Verification Methods - The publicKeyMultibase property is OPTIONAL. This feature is non-normative. If present, the value MUST be astring representation of a [MULTIBASE] encoded public key.

5.2 Verification Methods - The publicKeyJwk property is OPTIONAL. If present, the value MUST be a map representing a JSON Web Key that conforms to [RFC7517].

5.2 Verification Methods - The map MUST NOT contain "d", or any other members of the private information class as described in Registration Template.

5.2.1 Verification Material - A verification method MUST NOT contain multiple verification material properties for the same material. For example, expressing key material in a verification method using both publicKeyJwk and publicKeyMultibase at the same time is prohibited.

5.3.1 Authentication - The authentication property is OPTIONAL. If present, the associated value MUST be an ordered set of one or more verification methods.

5.3.2 Assertion - The assertionMethod property is OPTIONAL. If present, the associated value MUST be an ordered set of one or more verification methods.

5.3.3 Key Agreement - The keyAgreement property is OPTIONAL. If present, the associated value MUST be an ordered set of one or more verification methods.

5.3.4 Capability Invocation - The capabilityInvocation property is OPTIONAL. If present, the associated value MUST be an ordered set of one or more verification methods.

5.3.5 Capability Delegation - The capabilityDelegation property is OPTIONAL. If present, the associated value MUST be an ordered set of one or more verification methods.

5.4 Services - The service property is OPTIONAL. If present, the associated value MUST be an ordered set of services, where each service is described by a map.

5.4 Services - Each service map MUST contain id, type, and serviceEndpoint properties.

5.4 Services - The value of the id property MUST be a URI conforming to [RFC3986].

5.4 Services - A conforming producer MUST NOT produce multiple service entries with the same id.

5.4 Services - A conforming consumer MUST produce an error if it detects multiple service entries with the same id.

5.4 Services - The value of the type property MUST be a string or an ordered set of strings.

5.4 Services - The value of the serviceEndpoint property MUST be a string, a map, or an ordered set composed of one or more strings and/or maps.

5.4 Services - All [serviceEndpoint] string values MUST be valid URIs conforming to [RFC3986] and normalized according to the Normalization and Comparison rules in RFC3986 and to any normalization rules in its applicable URI scheme specification.

7.3 Metadata Structure - The structure used to communicate this metadata MUST be a map of properties.

7.3 Metadata Structure - Each property name MUST be a string.

7.3 Metadata Structure - Each property value MUST be a string, map, list, ordered set, boolean, or null.

7.3 Metadata Structure - The values within any complex data structures such as maps and lists MUST be one of these data types as well.

7.3 Metadata Structure - The entire metadata structure MUST be serializable according to the JSON serialization rules in the [INFRA] specification.

7.3 Metadata Structure - All metadata property definitions registered in the DID Specification Registries [DID-SPEC-REGISTRIES] MUST define the value type, including any additional formats or restrictions to that value (for example, a string formatted as a date or as a decimal integer).

3.1 DID Syntax - All DIDs MUST conform to the DID Syntax ABNF Rules.

3.2.1 DID Parameters - hl - If present, the associated value MUST be an ASCII string.

3.2.1 DID Parameters - service - If present, the associated value MUST be an ASCII string.

3.2.1 DID Parameters - relativeRef - If present, the associated value MUST be an ASCII string and MUST use percent-encoding for certain characters as specified in RFC3986 Section 2.1.

3.2.1 DID Parameters - versionId - If present, the associated value MUST be an ASCII string.

3.2.1 DID Parameters - versionTime - If present, the associated value MUST be an ASCII string which is a valid XML datetime value, as defined in section 3.3.7 of W3C XML Schema Definition Language (XSD) 1.1 Part 2: Datatypes [XMLSCHEMA11-2]. This datetime value MUST be normalized to UTC 00:00:00 and without sub-second decimal precision. For example: 2020-12-20T19:17:47Z.

6.1 Production and Consumption - A conforming producer MUST take a DID document data model and a representation-specific entries map as input into the production process. The conforming producer MAY accept additional options as input into the production process.

6.1 Production and Consumption - A conforming producer MUST serialize all entries in the DID document data model, and the representation-specific entries map, that do not have explicit processing rules for the representation being produced using only the representation's data type processing rules and return the serialization after the production process completes.

6.1 Production and Consumption - A conforming producer MUST return the Media Type string associated with the representation after the production process completes.

6.1 Production and Consumption - A conforming producer MUST NOT produce non-conforming DIDs or DID documents.

6.2.1 JSON Production - string: A JSON String.

6.2.1 JSON Production - list: A JSON Array, where each element of the list is serialized, in order, as a value of the array according to its type, as defined in this table.

6.2.1 JSON Production - set: A JSON Array, where each element of the set is added, in order, as a value of the array according to its type, as defined in this table.

6.2.1 JSON Production - map: A JSON Object, where each entry is serialized as a member of the JSON Object with the entry key as a JSON String member name and the entry value according to its type, as defined in this table.

6.2.1 JSON Production - datetime: A JSON String serialized as an XML Datetime normalized to UTC 00:00:00 and without sub-second decimal precision.

6.2.1 JSON Production - integer: A JSON Number without a decimal or fractional component.

6.2.1 JSON Production - double: A JSON Number with a decimal and fractional component.

6.2.1 JSON Production - boolean: A JSON Boolean.

6.2.1 JSON Production - null: A JSON null literal.

6.2.1 JSON Production - All entries of a DID document MUST be included in the root JSON Object.

6.2.1 JSON Production - When serializing a DID document, a conforming producer MUST specify a media type of application/did+json to downstream applications such as described in § 7.1.2 DID Resolution Metadata.

6.3.1 JSON-LD Production - The DID document and any DID document data structures expressed by the data model MUST be serialized to the JSON-LD representation according to the JSON representation production rules as defined in § 6.2 JSON.

6.3.1 JSON-LD Production - In addition to using the JSON representation production rules, JSON-LD production MUST include the representation-specific @context entry.

6.3.1 JSON-LD Production - The serialized value of @context MUST be the JSON String https://www.w3.org/ns/did/v1, or a JSON Array where the first item is the JSON String https://www.w3.org/ns/did/v1 and the subsequent items are serialized according to the JSON representation production rules.

6.3.1 JSON-LD Production - When serializing a JSON-LD representation of a DID document, a conforming producer MUST specify a media type of application/did+ld+json to downstream applications such as described in § 7.1.2 DID Resolution Metadata.

All conformant DID resolvers MUST implement the DID resolution functions for at least one DID method and MUST be able to return a DID document in at least one conformant representation.

7.1 DID Resolution - This input is REQUIRED and the value MUST be a conformant DID as defined in § 3.1 DID Syntax.

7.1 DID Resolution - A metadata structure.

7.1 DID Resolution - This input is REQUIRED, but the structure MAY be empty.

7.1 DID Resolution - This structure is REQUIRED, and in the case of an error in the resolution process, this MUST NOT be empty.

7.1 DID Resolution - If resolveRepresentation was called, this structure MUST contain a contentType property containing the Media Type of the representation found in the didDocumentStream.

7.1 DID Resolution - If the resolution is not successful, this structure MUST contain an error property describing the error.

7.1 DID Resolution - If the resolution is successful, and if the resolve function was called, this MUST be a DID document abstract data model (a map) as described in § 4. Data Model that is capable of being transformed into a conforming DID Document (representation), using the production rules specified by the representation.

7.1 DID Resolution - The value of id in the resolved DID document MUST match the DID that was resolved.

7.1 DID Resolution - If the resolution is unsuccessful, this value MUST be empty.

7.1 DID Resolution - If the resolution is successful, this MUST be a metadata structure.

7.1 DID Resolution - If the resolution is unsuccessful, this output MUST be an empty metadata structure.

7.1.1 DID Resolution Options - This property is OPTIONAL for the resolveRepresentation function and MUST NOT be used with the resolve function.

7.1.2 DID Resolution Metadata - This property is REQUIRED if resolution is successful and if the resolveRepresentation function was called.

7.1.2 DID Resolution Metadata - This property MUST NOT be present if the resolve function was called.

7.1.2 DID Resolution Metadata - The caller of the resolveRepresentation function MUST use this value when determining how to parse and process the didDocumentStream returned by this function into the data model.

7.1.2 DID Resolution Metadata - This property is REQUIRED when there is an error in the resolution process.

7.1.3 DID Document Metadata - The value of equivalentId MUST be a set where each item in the list is a string that conforms to the rules in Section § 3.1 DID Syntax.

7.1.3 DID Document Metadata - Each equivalentId DID value MUST be produced by, and a form of, the same DID Method as the id property value.

7.1.3 DID Document Metadata - The value of canonicalId MUST be a string that conforms to the rules in Section § 3.1 DID Syntax.

7.1.3 DID Document Metadata - A canonicalId value MUST be produced by, and a form of, the same DID Method as the id property value.

7.1.2 DID Resolution Metadata - The value of this property MUST be a single keyword ASCII string.

7.1.2 DID Resolution Metadata - invalidDid - The DID supplied to the DID resolution function does not conform to valid syntax.

7.1.2 DID Resolution Metadata - notFound - The DID resolver was unable to find the DID document resulting from this resolution request.

7.1.3 DID Document Metadata - If a DID has been deactivated, DID document metadata MUST include this property with the boolean value true.

7.1 DID Resolution - If the resolution is successful, and if the resolveRepresentation function was called, this MUST be a byte stream of the resolved DID document in one of the conformant representations.

7.1 DID Resolution - If the resolution is unsuccessful, this value MUST be an empty stream.

7.1.1 DID Resolution Options - The Media Type of the caller's preferred representation of the DID document.

7.1.1 DID Resolution Options - The Media Type MUST be expressed as an ASCII string.

7.1.2 DID Resolution Metadata - The value of this property MUST be an ASCII string that is the Media Type of the conformant representations.

7.1.3 DID Document Metadata - The value of the property MUST be a string formatted as an XML Datetime normalized to UTC 00:00:00 and without sub-second decimal precision.

7.1.3 DID Document Metadata - The value of the property MUST follow the same formatting rules as the created property.

7.1.3 DID Document Metadata - updated is later or equal than created.

7.1.3 DID Document Metadata - The value of the property MUST be an ASCII string.

3.1 DID Syntax - All DID URLs MUST conform to the DID URL Syntax ABNF Rules.

3.2.2 Relative DID URLs - When resolving a relative DID URL reference, the algorithm specified in RFC3986 Section 5: Reference Resolution MUST be used.

7.2 DID URL Dereferencing - A conformant DID URL as a single string.

7.2 DID URL Dereferencing - To dereference a DID fragment, the complete DID URL including the DID fragment MUST be used.

7.2 DID URL Dereferencing - This input is REQUIRED.

7.2 DID URL Dereferencing - A metadata structure.

7.2 DID URL Dereferencing - This input is REQUIRED, but the structure MAY be empty.

7.2 DID URL Dereferencing - This structure is REQUIRED, and in the case of an error in the dereferencing process, this MUST NOT be empty.

7.2 DID URL Dereferencing - If the dereferencing is not successful, this structure MUST contain an error property describing the error.

7.2 DID URL Dereferencing - If the dereferencing function was called and successful, this MUST contain a resource corresponding to the DID URL.

7.2 DID URL Dereferencing - If the dereferencing is unsuccessful, this value MUST be empty.

7.2 DID URL Dereferencing - If the dereferencing is successful, this MUST be a metadata structure, but the structure MAY be empty.

7.2 DID URL Dereferencing - If the dereferencing is unsuccessful, this output MUST be an empty metadata structure.

7.2.1 DID URL Dereferencing Options - The Media Type that the caller prefers for contentStream.

7.2.1 DID URL Dereferencing Options - The Media Type MUST be expressed as an ASCII string.

7.2.2 DID URL Dereferencing Metadata - The Media Type value MUST be expressed as an ASCII string.

7.2.2 DID URL Dereferencing Metadata - This property is REQUIRED when there is an error in the dereferencing process.

7.2.2 DID URL Dereferencing Metadata - The value of this property MUST be a single keyword ASCII string.

7.2.2 DID URL Dereferencing Metadata - invalidDidUrl - The DID URL supplied to the DID URL dereferencing function does not conform to valid syntax.

7.2.2 DID URL Dereferencing Metadata - notFound - The DID URL dereferencer was unable to find the contentStream resulting from this dereferencing request.

7.1.3 DID Document Metadata - The value of the property MUST be a string formatted as an XML Datetime normalized to UTC 00:00:00 and without sub-second decimal precision.

7.1.3 DID Document Metadata - The value of the property MUST follow the same formatting rules as the created property.

7.1.3 DID Document Metadata - updated is later or equal than created.

7.1.3 DID Document Metadata - nextUpdate is later than created.

7.1.3 DID Document Metadata - nextUpdate is later than updated.

7.1.3 DID Document Metadata - The value of the property MUST be an ASCII string.

7.1.3 DID Document Metadata - nextVersionId is different from versionId.