diff --git a/vocab/credentials/v2/vocabulary.yml b/vocab/credentials/v2/vocabulary.yml index dd5276839..8ce97e3b1 100644 --- a/vocab/credentials/v2/vocabulary.yml +++ b/vocab/credentials/v2/vocabulary.yml @@ -33,6 +33,11 @@ class: label: Refresh service comment: A Refresh Service is a mechanism that can be utilized by software agents to retrieve an updated copy of a Verifiable Credential. + - id: Credential + label: Credential + comment: | + A Credential is a set of one or more claims made by an issuer. + - id: CredentialSchema label: Credential schema comment: A Credential Schema provides verifiers with enough information to determine if the provided data conforms to the provided schema. @@ -45,48 +50,48 @@ class: label: Credential evidence comment: A Credential Evidence scheme provides enough information to a verifier to determine whether the evidence gathered meets their requirements for issuing a credential. The precise content of each evidence scheme is determined by the specific evidence type definition. + - id: CredentialGraph + label: (Verifiable) credential graph + comment: Instances of this class are RDF Graphs, where each of these graphs must include exactly one Credential (usually a Verifiable Credential). + - id: VerifiableCredential label: Verifiable credential comment: | - A Credential is a set of one or more claims made by an issuer. A Verifiable Credential is a tamper-evident credential that has authorship that can be cryptographically verified. Verifiable Credentials can be used to build Verifiable Presentations, which can also be cryptographically verified. - - - id: VerifiableCredentialGraph - label: Verifiable credential graph - comment: Instances of this class are RDF Graphs, where each of these graphs must include exactly one Verifiable Credential + A Verifiable Credential is a Credential that is tamper-evident and has authorship that can be cryptographically verified. Verifiable Credentials can be used to build Verifiable Presentations, which can also be cryptographically verified. - id: VerifiablePresentation label: Verifiable presentation comment: | - A Presentation is data derived from one or more Credentials, issued by one or more `issuers`, that is shared with a specific `verifier`. A Verifiable Presentation is a tamper-evident Presentation encoded in such a way that authorship of the data can be trusted after a process of cryptographic verification. Certain types of verifiable presentations might contain data that is synthesized from, but do not contain, the original verifiable credentials (for example, zero-knowledge proofs). + A Presentation is data derived from one or more Credentials (usually, but not necessarily, Verifiable Credentials), issued by one or more `issuers`, that is shared with a specific `verifier`. A Verifiable Presentation is a tamper-evident Presentation encoded in such a way that authorship of the data can be trusted after a process of cryptographic verification. Certain types of verifiable presentations might contain data that is synthesized from, but do not contain, the original verifiable credentials (for example, zero-knowledge proofs). property: - id: credentialSchema label: Credential schema - domain: cred:VerifiableCredential + domain: cred:Credential range: cred:CredentialSchema comment: The value of the `credentialSchema` property MUST be one or more Credential schema instances. - id: credentialStatus label: Credential status - domain: cred:VerifiableCredential + domain: cred:Credential range: cred:CredentialStatus comment: The value of the `credentialStatus` property MUST be an instance of a Credential status. - id: credentialSubject label: Credential subject - domain: cred:VerifiableCredential + domain: cred:Credential range: IRI comment: An entity about which claims are made. - id: evidence label: Evidence - domain: cred:VerifiableCredential + domain: cred:Credential range: cred:CredentialEvidence comment: The value of the `evidence` property MUST be one or more Credential evidence instances. - id: expirationDate label: Expiration date - domain: cred:VerifiableCredential + domain: cred:Credential range: xsd:dateTime deprecated: true comment: The value of the `expirationDate` property was used to express the date and time the credential ceases to be valid. It has been deprecated in favor of `validUntil` @@ -94,7 +99,7 @@ property: - id: holder label: Holder domain: - - cred:VerifiableCredential + - cred:Credential - cred:VerifiablePresentation range : IRI comment: | @@ -110,21 +115,21 @@ property: - id: issued label: issue date - domain: cred:VerifiableCredential + domain: cred:Credential range: xsd:dateTime comment: | The value of the `issued` property MUST be a string value of an ISO8601 combined date and time string representing the date and time the credential was issued. Note that this date represents the earliest date when the information associated with the `credentialSubject` property became valid. - id: validUntil label: Valid until - domain: cred:VerifiableCredential + domain: cred:Credential range: xsd:dateTime comment: The value of the `validUntil` property MUST be a string value of an ISO8601 combined date and time string representing the date and time the credential ceases to be valid. - id: verifiableCredential label: verifiable credential domain: cred:VerifiablePresentation - range: cred:VerifiableCredentialGraph - comment: The value of the `verifiableCredential` property MUST identify a Verifiable credential graph (informally, it indirectly identifies a Verifiable credential contained in a separate graph). + range: cred:CredentialGraph + comment: The value of the `verifiableCredential` property MUST identify a (Verifiable) credential graph (informally, it indirectly identifies a Credential contained in a separate graph).