All conformant DID resolvers MUST implement the DID resolution -function for at least one DID method and MUST be able to return a DID +function for at least one DID method. All conformant +DID URL dereferencers MUST be able to return a DID document in at least one conformant representation.
@@ -3013,7 +3014,7 @@
resolve ( did, did-resolution-input-metadata )
- -> ( did-resolution-metadata, did-document-stream, did-document-metadata )
+ -> ( did-resolution-metadata, did-document, did-document-metadata )
@@ -3034,7 +3035,9 @@
resolve function in addition to the did
-itself. This input is REQUIRED, but the structure MAY be empty.
+itself.
+Properties defined by this specification are in .
+This input is REQUIRED, but the structure MAY be empty.
resolve function as it represents data about the
resolution process itself.
+Properties defined by this specification are in .
+If the resolution is not successful, this structure MUST contain an error property describing the error.
resolve function
-into a DID document abstract data model, which can in turn be validated
-and processed. If the resolution is unsuccessful, this value MUST be an empty
-stream.
+If the resolution is successful, this MUST be a DID document conforming to
+the abstract data model, which can be validated and processed.
+If the resolution is unsuccessful, this value MUST be empty.
did-document-stream. This metadata typically does not change
+did-document. This metadata typically does not change
between invocations of the resolve function unless the DID
document changes, as it represents data about the DID document. If
the resolution is unsuccessful, this output MUST be an empty metadata structure.
+Properties defined by this specification are in .
@@ -3089,12 +3092,258 @@
+The possible properties within the did-resolution-input-metadata structure and their possible values are defined by [[DID-SPEC-REGISTRIES]].
+
+The possible properties within the did-resolution-metadata structure and their possible values are defined by [[DID-SPEC-REGISTRIES]].
+This specification defines the following common properties.
+
did-document
+for this resolution request.
+ +The DID URL dereferencing function dereferences a DID URL into content +identified by that DID URL. This content MAY be a DID document, a +portion of a DID document, a service endpoint, or some other data. +The DID URL dereferencer first MUST resolve the DID within the DID URL into a DID document using a DID resolution process. +The details of the implementation of this function +are outside the scope of this specification, but all implementations MUST implement +a function which has the following abstract form: +
+ +
+dereference ( did-url, did-url-dereference-input-metadata )
+ -> ( did-url-dereference-metadata, content-stream, did-document-metadata )
+
+The input variables of this function MUST be as follows: +
+ +dereference function in addition to the did-url
+itself.
+Properties defined by this specification are in .
+This input is REQUIRED, but the structure MAY be empty.
+ +The output variables of this function MUST be as follows: +
+ +dereference function as it represents data about the
+dereferencing process itself.
+Properties defined by this specification are in .
+If the resolution is successful, this structure MUST contain a content-type property containing the mime-type of the content-stream in this result.
+If the resolution is not successful, this structure MUST contain an error property describing the error.
+ dereference function
+into a DID document abstract data model, which can in turn be validated
+and processed. If the dereferencing is unsuccessful, this value MUST be an empty
+stream.
+ content-stream. This metadata typically does not change
+between invocations of the dereference function unless the DID
+document changes, as it represents data about the DID document. If
+the dereferencing is unsuccessful, or if the dereferenced content is not
+a DID document, this output MUST be an empty
+metadata structure.
+Properties defined by this specification are in .
+
+DID URL dereferencer implementations MUST NOT alter the signature of this
+function in any way. DID URL dereferencer implementations
+MAY implement and expose additional
+functions with different signatures in addition to the dereference
+function specified here.
+
+The possible properties within the did-url-dereferencing-input-metadata structure and their possible values are defined by [[DID-SPEC-REGISTRIES]].
+This specification defines the following common properties.
+
content-stream if such
+a representation is supported and available. This property is OPTIONAL.
+
+The possible properties within the did-url-dereferencing-metadata structure and their possible values are defined by [[DID-SPEC-REGISTRIES]].
+This specification defines the following common properties.
+
content-stream.
+This property is REQUIRED if dereferencing is successful and a content-stream is returned.
+If the value of this property is the mime-type of one of the conformant representations of a DID document,
+then the caller of the dereference function MUST use this value when determining how to
+parse and process the content-stream returned by this function into a
+DID document abstract data model.
+ content-stream
+for this dereferencing request.
+ +The possible properties within this structure and their possible values are defined by [[DID-SPEC-REGISTRIES]]. +This specification defines the following common properties. +
+