From 1da0bf1b8ddfd725e3fecf5752890cf0b521083d Mon Sep 17 00:00:00 2001 From: Markus Sabadello Date: Fri, 13 Dec 2024 00:17:27 +0900 Subject: [PATCH 1/4] Add more details about how to dereference path and query of a DID URL. --- index.html | 42 +++++++++++++++++++++++++++++++++++++++--- 1 file changed, 39 insertions(+), 3 deletions(-) diff --git a/index.html b/index.html index 476984e..416aea3 100644 --- a/index.html +++ b/index.html @@ -1035,7 +1035,31 @@

Dereferencing the Resource

-
  • Otherwise, if the input DID URL contains the +
  • If the input DID URL contains the + DID parameter hl: + 
    did:example:1234?hl=zQmWvQxTqbG2Z9HPJgG57jjwR154cKhbtJenbyYTWkjgF3e
    +
    1. +

      TODO: Specify the algorithm for processing the `hl` DID parameter.

      +
    +
    • + +
  • If the input DID URL contains the + DID parameter versionId: + 
    did:example:1234?versionId=1
    +
    1. +

      TODO: Specify the algorithm for processing the `versionId` DID parameter.

      +
    +
    • + +
  • If the input DID URL contains the + DID parameter versionTime: + 
    did:example:1234??versionTime=2021-05-10T17:00:00Z
    +
    1. +

      TODO: Specify the algorithm for processing the `versionTime` DID parameter.

      +
    +
    • + +
  • If the input DID URL contains the DID parameter service and optionally the relativeRef DID parameter: 
    did:example:1234?service=files&relativeRef=%2Fmyresume%2Fdoc%3Fversion%3Dlatest
    @@ -1056,16 +1080,28 @@

    Dereferencing the Resource

  • Return the output service endpoint URL.
    • +
  • Otherwise, if the input DID URL contains a DID path and/or DID query: 
    did:example:1234/custom/path?customquery
    1. The applicable DID method MAY specify how to dereference - the input DID URL.
      2. + the DID path and/or DID query of the + input DID URL. + 
      did:example:1234/resources/1234
      +
    2. An extension specification MAY specify how to dereference + the DID path of the input DID URL. + 
      did:example:1234/whois
      +
      3. +
    3. An extension specification MAY specify how to dereference + the DID query of the input DID URL. + 
      did:example:1234?transformKey=JsonWebKey
      +
    4. The client MAY be able to dereference the input DID URL in an application-specific way.
    • -
  • If neither this algorithm, nor the applicable DID method, nor the client + +
  • If neither this algorithm, nor the applicable DID method, nor an extension, nor the client is able to dereference the input DID URL, return the following result:
    1. dereferencingMetadata: «[ "error" → "notFound" ]»
      2. From 27108d3993c93d6ba42cea0f1b23a064fb1b0b58 Mon Sep 17 00:00:00 2001 From: Markus Sabadello Date: Fri, 13 Dec 2024 00:43:41 +0900 Subject: [PATCH 2/4] Fix small markup bug. --- index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.html b/index.html index 416aea3..08c4e83 100644 --- a/index.html +++ b/index.html @@ -1016,6 +1016,7 @@

      Dereferencing the Resource

    2. contentStream: null
    3. contentMetadata: «[ ]»
    +
  • Obtain the DID document for the input DID by executing the DID resolution algorithm as defined in . All @@ -1023,7 +1024,6 @@

    Dereferencing the Resource

    DID parameters of the input DID URL MUST be passed as resolution options to the DID Resolution algorithm. If the input DID does not exist, return a null result. Otherwise, the result is called the resolved DID document.
    • -
  • If present, separate the DID fragment from the input DID URL and continue with the adjusted input DID URL.
    • From dfaa7a1e29ce45e67a04d305e52c3d586b0a6a7f Mon Sep 17 00:00:00 2001 From: Markus Sabadello Date: Fri, 13 Dec 2024 01:08:22 +0900 Subject: [PATCH 3/4] Fix additional markup bug. --- index.html | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/index.html b/index.html index 08c4e83..ee95519 100644 --- a/index.html +++ b/index.html @@ -1085,9 +1085,9 @@

    Dereferencing the Resource

    did:example:1234/custom/path?customquery
    1. The applicable DID method MAY specify how to dereference - the DID path and/or DID query of the - input DID URL.
      2. + the DID path and/or DID query of the input DID URL. 
      did:example:1234/resources/1234
      +
    2. An extension specification MAY specify how to dereference the DID path of the input DID URL. 
      did:example:1234/whois
      From 2545a3ecd960af3dc297297b2668b95aff98e8a7 Mon Sep 17 00:00:00 2001 From: Markus Sabadello Date: Fri, 13 Dec 2024 02:10:16 +0900 Subject: [PATCH 4/4] Update index.html Co-authored-by: Manu Sporny --- index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.html b/index.html index ee95519..1471923 100644 --- a/index.html +++ b/index.html @@ -1053,7 +1053,7 @@

      Dereferencing the Resource

    3. If the input DID URL contains the DID parameter versionTime: - 
      did:example:1234??versionTime=2021-05-10T17:00:00Z
      + 
      did:example:1234?versionTime=2021-05-10T17:00:00Z

      1. TODO: Specify the algorithm for processing the `versionTime` DID parameter.