diff --git a/index.html b/index.html index 6eca77d7..8e211a95 100644 --- a/index.html +++ b/index.html @@ -3410,6 +3410,191 @@
+The DID URL dereferencing function dereferences a DID URL into +a resource with contents depending on the DID URL's components, +including the DID method, method-specific identifier, query parameters, +and fragment. When a DID URL is also a DID, this process + performs DID Resolution. The details of how this +process is accomplished are outside the scope of this specification, but all +conformant implementations MUST implement two functions which have the +following abstract forms: +
+ +
+dereference ( did-url, did-url-dereferencing-input-metadata )
+ -> ( did-url-dereferencing-metadata, content, content-metadata )
+
+The input variables of these functions 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 these functions MUST be as follows: +
+ +error
property describing the error.
+ dereferencing
function was called and successful, this MUST
+contain a resource corresponding to the DID URL.
+Additionally, in the case that the DID URL is a DID, then this
+MUST be a did-document
as described in DID Resolution,
+obtained through the resolution process.
+
+If the dereferencing is unsuccessful, this value MUST be empty.
+ content
.
+Additionally, in the case that the DID URL is a DID, then this
+MUST be a did-document-metadata
as described in DID Resolution,
+obtained through the resolution process.
+
+If the dereferencing is unsuccessful, this output MUST be an empty metadata structure.
+
+DID URL Dereferencing implementations MUST NOT alter the signature of
+these functions in any way. DID URL Dereferencing implementations MAY
+map the dereference
function to a method-specific internal
+function to perform the actual DID URL Dereferencing process. DID
+URL Dereferencing implementations MAY implement and expose additional
+functions with different signatures in addition to the dereference
+function specified here.
+
+The possible properties within this structure and their possible values are defined by [[DID-SPEC-REGISTRIES]]. +This specification defines the following common properties. +
+ +content
. The DID URL
+Dereferencing implementation SHOULD use this value to determine the
+representation contained in the returned value if such a representation is
+supported and available. This property is OPTIONAL.
+ +The possible properties within this structure and their possible values are defined by [[DID-SPEC-REGISTRIES]]. +This specification defines the following common properties. +
+ +content
.
+This property is REQUIRED if dereferencing is successful.
+ content
+resulting from 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. +
+ +