Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Add initial-values matrix parameter to Generic DID Parameters #84

Closed
wants to merge 8 commits into from
Closed

Add initial-values matrix parameter to Generic DID Parameters #84

Changes from all commits
Commits
Show all changes
8 commits
Select commit Hold shift + click to select a range
a17bec1
Add `initial-values` generic matrix parameter
csuwildcat Oct 22, 2019
b412dfe
Update index.html
csuwildcat Oct 22, 2019
0dc41c9
Update index.html
csuwildcat Oct 22, 2019
065cb0e
Update index.html
csuwildcat Oct 22, 2019
01797ce
Update index.html
csuwildcat Nov 26, 2019
23f814c
Update index.html
csuwildcat Nov 26, 2019
feaaf19
Update index.html
csuwildcat Nov 26, 2019
c569c48
Update index.html
csuwildcat Nov 26, 2019
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 14 additions & 0 deletions index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -787,6 +787,20 @@ <h2>
<td>
Identifies a certain version timestamp of a <a>DID document</a> to be resolved
(i.e., the <a>DID document</a> that was valid for a <a>DID</a> at a certain time).
Note: This parameter may not be supported by all <a>DID methods</a>.
</td>
</tr>
<tr>
<td>
<code>initial-values</code>
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't understand why this is plural, does it support some sort of array semantics in the value property? If not, change to "initial-value".

</td>
<td>
Some <a>DID methods</a> may require an interim period of time (e.g., a block
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What this paragraph says, and what was explained during the WG call today feel like two very different things. We shouldn't create generic parameters where DID Methods can put whatever they want to into the value... that will lead to bad interoperability. If this is going to be a base64 encoded value of the initial DID Document, then the property should be did-document. If it is a hash of the initial document, use a hashlink. If it is a link to the initial document, it should be document-link. The property should be more specific, with a specific encoding such that all methods implement it in the same way, if they choose to implement it.

interval) before a new identifier and its initial <a>DID document</a>
state are propagated within the underlying <a>DID registry</a>. To enable resolution
of a DID during this period, <a>DID methods</a> may require that additional values
be passed to their resolver logic. <a>DID methods</a> SHOULD use the
`initial-values` parameter when such values are necessary.
Note: This parameter may not be supported by all <a>DID methods</a>.
</td>
</tr>
Expand Down