Skip to content

Commit ef6a858

Browse files
gvgv
gv
authored and
gv
committed
render the spec
1 parent e4c9408 commit ef6a858

File tree

1 file changed

+75
-2
lines changed

1 file changed

+75
-2
lines changed

‎spec/index.html

Lines changed: 75 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -78,12 +78,80 @@ <h1 id="linked-claims"><a class="toc-anchor" href="#linked-claims" >§</a> Linke
7878
<dd>(add here as people contribute!)</dd>
7979
<dt>Feedback:</dt>
8080
<dd><a href="https://github.com/org/repo">GitHub Issues</a></dd>
81-
<dt>Related Documents:</dt>
82-
<dd><a href="#">tbd</a></dd>
8381
</dl>
8482
</details>
8583
<h2 id="abstract"><a class="toc-anchor" href="#abstract" >§</a> Abstract</h2>
8684
<p>Evaluating the credibiity of digital information about the real world is a difficult problem, one which is not sufficiently addressed by cryptographic signing or blockchain validation. An open, interoperable, cross-domain web of trust could enable robust credibility assessment; a number of projects pursue this goal. LinkedClaims is a minimal standard to enable links between independent claims: each claim must be addressable (ie have a URI), must be about an addressable subject, and must be cryptographically signed. Several desirable features are also identified, such as the ability to make a determinate hash of claim content. The LinkedClaim pattern already exists in several independent projects and implementations; by defining profiles or mappings for these existing data structures to a LinkedClaim data model, we enable linking them together without requiring changes to their native formats.</p>
85+
<p>This specification defines the fundamental requirements for a claim to be classified as a “linked claim.” It introduces the concept of a LinkedClaim profile, outlines how an ecosystem can achieve conformance with the linked claim requirements, and provides guidance on specifying additional requirements through a profile. However, it does not define any specific profile or provide an implementation guide, which are addressed in separate documents.</p>
86+
<h2 id="related-work"><a class="toc-anchor" href="#related-work" >§</a> Related Work</h2>
87+
<p>The LinkedClaims specification is being developed alongside several complementary initiatives:</p>
88+
<ul>
89+
<li><a href="TBD" >Progressive Trust</a> - A framework for building trust through incremental verification and validation of claims</li>
90+
<li><a href="TBD" >digest Multibase Hashlink</a> - TBD</li>
91+
<li><a href="TBD" >inbox</a> - The use of an ActivityPub compatible inbox for replies to claims</li>
92+
</ul>
93+
<h2 id="status-of-this-document"><a class="toc-anchor" href="#status-of-this-document" >§</a> Status of This Document</h2>
94+
<p>Decentralized Web Node is a <em>DRAFT</em> specification under development within the <a path-0="identity.foundation"href="https://identity.foundation" >Decentralized Identity Foundation</a> (DIF). It is an active work item of the <a path-0="github.com"path-1="decentralized-identity"path-2="labs"path-3="blob"path-4="main"path-5="proposals"path-6="linked_claims"path-7="001_proposal.md"href="https://github.com/decentralized-identity/labs/blob/main/proposals/linked_claims/001_proposal.md" >Linked Claim Incubation Lab at DIF</a> It incorporates requirements and learnings from diverse stakeholders across sectors into a shared specification that meets the collective needs of the community.</p>
95+
<p>The specification will be updated to incorporate feedback, from DIF members and the wider community, with a reference implementation being developed that exercises the features and requirements defined here. We encourage reviewers to submit <a path-0="github.com"path-1="decentralized-identity"path-2="labs-linkedclaims"path-3="issues"href="https://github.com/decentralized-identity/labs-linkedclaims/issues" >GitHub Issues</a> as the means by which to communicate feedback and contributions.</p>
96+
<h2 id="terminology"><a class="toc-anchor" href="#terminology" >§</a> Terminology</h2>
97+
<p><span id="term:did">DID</span> ~ A Decentralized Identifier as defined in <a path-0="www.w3.org"path-1="TR"path-2="did-core"path-3=""href="https://www.w3.org/TR/did-core/" ><span>https://www.w3.org/TR/did-core/</span></a></p>
98+
<p><span id="term:linked-claim">Linked Claim</span> ~ A structured, cryptographically signed document with a URI subject that is itself addressable at a URI, following at least the MUST requirements detailed below.</p>
99+
<p><span id="term:signer">Signer</span> ~ The entity that cryptographically signs a claim (known as the “issuer” in Verifiable Credentials)</p>
100+
<p><span id="term:uri">URI</span> ~ a Uniform Resource Identifier as defined in <a path-0="datatracker.ietf.org"path-1="doc"path-2="html"path-3="rfc3986"href="https://datatracker.ietf.org/doc/html/rfc3986" ><span>https://datatracker.ietf.org/doc/html/rfc3986</span></a></p>
101+
<h2 id="core-pattern"><a class="toc-anchor" href="#core-pattern" >§</a> Core Pattern</h2>
102+
<div class="mermaid">
103+
graph LR
104+
subgraph Claim-B
105+
B_id["id: URI_B"]
106+
B_subject["subject: URI_A"]
107+
B_content["content: {...}"]
108+
B_sig["signature: xyz"]
109+
end
110+
111+
subgraph Claim-A
112+
A_id["id: URI_A"]
113+
A_subject["subject: URL_X"]
114+
A_content["content: {...}"]
115+
A_sig["signature: xyz"]
116+
end
117+
118+
subgraph Resource
119+
X["URL_X"]
120+
end
121+
122+
%% Claims point to their subjects
123+
B_subject -.-> A_id
124+
A_subject -.-> X
125+
126+
classDef claim fill:#f8f8ff,stroke:#333,stroke-width:2px
127+
classDef claimPart fill:#ffffff,stroke:#666,stroke-width:1px
128+
classDef resource fill:#e8f4f8,stroke:#333,stroke-width:2px
129+
130+
class B_id,B_subject,B_content,B_sig,A_id,A_subject,A_content,A_sig claimPart
131+
style Claim-A fill:#f8f8ff,stroke:#333,stroke-width:2px
132+
style Claim-B fill:#f8f8ff,stroke:#333,stroke-width:2px
133+
style Resource fill:#e8f4f8,stroke:#333,stroke-width:2px
134+
style X fill:#ffffff
135+
136+
linkStyle 0,1 stroke:#666,stroke-width:2px,stroke-dasharray: 5
137+
</div>
138+
<h2 id="linkedclaim-conformance-requirements"><a class="toc-anchor" href="#linkedclaim-conformance-requirements" >§</a> LinkedClaim Conformance Requirements</h2>
139+
<p>A LinkedClaim:</p>
140+
<ul>
141+
<li><strong>MUST</strong> have a subject that can be any valid URI</li>
142+
<li><strong>MUST</strong> itself have an identifier that is a well-formed URI (URN is acceptable)</li>
143+
<li><strong>MUST</strong> be cryptographically signed, such as with a DID</li>
144+
<li><strong>SHOULD</strong> provide a mechanism to retrieve deterministic machine-readable content from its URI</li>
145+
<li><strong>SHOULD</strong> include a date that is in the signed data</li>
146+
<li><strong>SHOULD</strong> contain evidence such as links to a source or attachments, optionally hashlinked</li>
147+
<li><strong>SHOULD</strong> have a URI-addressable cryptographic signer</li>
148+
<li><strong>MAY</strong> have a narrative statement</li>
149+
<li><strong>MAY</strong> be a W3C Verifiable Credential or similar digital credential specification</li>
150+
<li><strong>MAY</strong> provide a way for the signer to mutate or revoke the claim</li>
151+
<li><strong>MAY</strong> have a subject that itself is a claim</li>
152+
<li><strong>MAY</strong> have a separate published date and effective date</li>
153+
<li><strong>MAY</strong> be public or access controlled</li>
154+
</ul>
87155

88156
</article>
89157

@@ -109,6 +177,11 @@ <h2 id="abstract"><a class="toc-anchor" href="#abstract" >§</a> Abstract</h2>
109177
<div id="toc_list">
110178
<ul class="toc">
111179
<li><a href="#abstract" >Abstract</a></li>
180+
<li><a href="#related-work" >Related Work</a></li>
181+
<li><a href="#status-of-this-document" >Status of This Document</a></li>
182+
<li><a href="#terminology" >Terminology</a></li>
183+
<li><a href="#core-pattern" >Core Pattern</a></li>
184+
<li><a href="#linkedclaim-conformance-requirements" >LinkedClaim Conformance Requirements</a></li>
112185
</ul>
113186

114187
</div>

0 commit comments

Comments
 (0)