Skip to content

Commit

Permalink
Export terminology used by this spec that is useful elsewhere.
Browse files Browse the repository at this point in the history
  • Loading branch information
@msporny
msporny committed Nov 7, 2023
1 parent d40f8e0 commit aa58433
Showing 1 changed file with 27 additions and 28 deletions.
55 changes: 27 additions & 28 deletions index.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -1121,7 +1121,7 @@ <h3>Contexts</h3>
</p>

<dl>
<dt><dfn class="lint-ignore">@context</dfn></dt>
<dt><dfn class="export">@context</dfn></dt>
<dd>
The value of the <code>@context</code> <a>property</a> MUST be an ordered set
where the first item is a <a>URL</a> with the value
Expand Down Expand Up @@ -1233,7 +1233,7 @@ <h3>Identifiers</h3>
</p>

<dl>
<dt><dfn class="lint-ignore">id</dfn></dt>
<dt><dfn class="export">id</dfn></dt>
<dd>
The value of the <code>id</code> <a>property</a> MUST be a single <a>URL</a>.
It is RECOMMENDED that the <a>URL</a> in the <code>id</code> be one which, if
Expand Down Expand Up @@ -1307,7 +1307,7 @@ <h3>Types</h3>
</p>

<dl>
<dt><dfn data-lt="type|types">type</dfn></dt>
<dt><dfn class="export" data-lt="type|types">type</dfn></dt>
<dd>
The value of the <code>type</code> <a>property</a> MUST be, or map to (through
interpretation of the <code>@context</code> property), one or more <a>URLs</a>.
Expand Down Expand Up @@ -1499,7 +1499,7 @@ <h3>Names and Descriptions</h3>
</p>

<dl>
<dt><dfn class="lint-ignore">name</dfn></dt>
<dt><dfn class="export">name</dfn></dt>
<dd>
An OPTIONAL property that expresses the name of the <a>credential</a>. If
present, the value of the <code>name</code> <a>property</a> MUST be a string or
Expand All @@ -1512,7 +1512,7 @@ <h3>Names and Descriptions</h3>
enable an individual to quickly differentiate one <a>credential</a>
from any other <a>credentials</a> that they might hold.
</dd>
<dt><dfn class="lint-ignore">description</dfn></dt>
<dt><dfn class="export">description</dfn></dt>
<dd>
An OPTIONAL property that conveys specific details about a <a>credential</a>. If
present, the value of the <code>description</code> <a>property</a> MUST be a
Expand Down Expand Up @@ -1648,7 +1648,7 @@ <h3>Credential Subject</h3>
</p>

<dl>
<dt><dfn class="lint-ignore"
<dt><dfn class="export"
id="defn-credentialSubject">credentialSubject</dfn></dt>
<dd>
The value of the <code>credentialSubject</code> <a>property</a> is defined as
Expand Down Expand Up @@ -1978,15 +1978,14 @@ <h3>Verifiable Credential Graphs</h3>

<p>
To ensure that data from different <a>verifiable credentials</a> are not
accidentally co-mingled, the concept of a <dfn>verifiable credential graph</dfn>
is used to encapsulate each <a>verifiable credential</a>. For simple
<a>verifiable credentials</a>, i.e., when the JSON-LD document contains a single
credential with, possibly, associated proofs, this graph is the <a>default
graph</a>. For <a>presentations</a>, each value associated with the
`verifiableCredential` property of the <a>presentation</a> is a separate
<a>named graph</a> of type
<dfn class="lint-ignore">VerifiableCredentialGraph</dfn> which contains a single
<a>verifiable credential</a>.
accidentally co-mingled, the concept of a <dfn class="export">verifiable
credential graph</dfn> is used to encapsulate each <a>verifiable credential</a>.
For simple <a>verifiable credentials</a>, i.e., when the JSON-LD document
contains a single credential with, possibly, associated proofs, this graph is
the <a>default graph</a>. For <a>presentations</a>, each value associated with
the `verifiableCredential` property of the <a>presentation</a> is a separate
<a>named graph</a> of type <dfn class="export">VerifiableCredentialGraph</dfn>
which contains a single <a>verifiable credential</a>.
</p>
<p>
Using these <a>graphs</a> has a concrete effect when performing JSON-LD
Expand All @@ -2013,12 +2012,12 @@ <h3>Securing Verifiable Credentials</h3>
<p>
This specification recognizes two classes of securing mechanisms: those that use
external proofs and those that use embedded proofs. An
<dfn class="lint-ignore">external proof</dfn> is one that wraps an expression of
<dfn class="export">external proof</dfn> is one that wraps an expression of
this data model, such as via a JSON Web Token, which is elaborated on in the
<em>Securing Verifiable Credentials using JOSE and COSE</em> [[VC-JOSE-COSE]] specification.
An <dfn>embedded proof</dfn> is a mechanism where the proof is included in the
data model, such as a Data Integrity Proof, which is elaborated on in <em>Verifiable
Credential Data Integrity</em> [[VC-DATA-INTEGRITY]].
An <dfn class="export">embedded proof</dfn> is a mechanism where the proof is
included in the data model, such as a Data Integrity Proof, which is elaborated
on in <em>Verifiable Credential Data Integrity</em> [[VC-DATA-INTEGRITY]].
</p>
<p>
It should be noted that these two classes of securing mechanisms are not
Expand All @@ -2045,9 +2044,9 @@ <h3>Securing Verifiable Credentials</h3>
One or more cryptographic proofs that can be used to detect tampering and verify
the authorship of a <a>verifiable credential</a> or a <a>verifiable
presentation</a>. Each proof is a separate <a>named graph</a>
(referred to as a <dfn>proof graph</dfn>) containing a single proof. The
specific method used for an <a>embedded proof</a> MUST be identified using the
<code>type</code> <a>property</a>.
(referred to as a <dfn class="export">proof graph</dfn>) containing a single
proof. The specific method used for an <a>embedded proof</a> MUST be identified
using the <code>type</code> <a>property</a>.
</p>
<p>
A proof for a <a>verifiable credential</a> covers all <a>claims</a>
Expand Down Expand Up @@ -2617,17 +2616,17 @@ <h3>Lifecycle Details</h3>

<ul>
<li>
An <a>issuer</a> <dfn class="lint-ignore" data-lt="issue">issues</dfn> a
An <a>issuer</a> <dfn class="export" data-lt="issue">issues</dfn> a
<a>verifiable credential</a> to a <a>holder</a>. Issuance always occurs before
any other actions involving a <a>credential</a>.
</li>
<li>
A <a>holder</a> might <dfn class="lint-ignore"
A <a>holder</a> might <dfn class="export"
data-lt="transfers">transfer</dfn> one or more of its <a>verifiable
credentials</a> to another <a>holder</a>.
</li>
<li>
A <a>holder</a> <dfn class="lint-ignore" data-lt="present">presents</dfn> one or
A <a>holder</a> <dfn class="export" data-lt="present">presents</dfn> one or
more of its <a>verifiable credentials</a> to a <a>verifier</a>, optionally
inside a <a>verifiable presentation</a>.
</li>
Expand All @@ -2644,11 +2643,11 @@ <h3>Lifecycle Details</h3>
appropriate for the requested use.
</li>
<li>
An <a>issuer</a> might <dfn class="lint-ignore" data-lt="revoke">revoke</dfn> a
An <a>issuer</a> might <dfn class="export" data-lt="revoke">revoke</dfn> a
<a>verifiable credential</a>.
</li>
<li>
A <a>holder</a> might <dfn class="lint-ignore" data-lt="delete">delete</dfn> a
A <a>holder</a> might <dfn class="export" data-lt="delete">delete</dfn> a
<a>verifiable credential</a>.
</li>
</ul>
Expand Down Expand Up @@ -3417,7 +3416,7 @@ <h3>Evidence</h3>
</p>

<dl>
<dt><dfn id="defn-evidence">evidence</dfn></dt>
<dt><dfn id="defn-evidence" class="export">evidence</dfn></dt>
<dd>
The value of the <code>evidence</code> <a>property</a> MUST be one or more
evidence schemes providing enough information for a <a>verifier</a> to determine
Expand Down

0 comments on commit aa58433

Please sign in to comment.