From 47f7b0457ed1fe3a3fd9d78bfd268e318f88f801 Mon Sep 17 00:00:00 2001 From: Mahmoud Alkhraishi Date: Thu, 27 Oct 2022 12:31:04 -0400 Subject: [PATCH 1/3] update issuanceDate to validFrom --- diagrams/credential-graph.svg | 2 +- diagrams/presentation-graph.svg | 2 +- index.html | 79 +++++++++++--------------- vocab/credentials/v2/vocabulary.csv | 2 +- vocab/credentials/v2/vocabulary.html | 4 +- vocab/credentials/v2/vocabulary.jsonld | 6 +- vocab/credentials/v2/vocabulary.ttl | 6 +- 7 files changed, 45 insertions(+), 56 deletions(-) diff --git a/diagrams/credential-graph.svg b/diagrams/credential-graph.svg index 5d88c551d..2da4f080a 100644 --- a/diagrams/credential-graph.svg +++ b/diagrams/credential-graph.svg @@ -39,7 +39,7 @@ and a public key belonging to the creator, Example University. Credential 123 - issuanceDate + validFrom 2010-01-01T19:37.24Z diff --git a/diagrams/presentation-graph.svg b/diagrams/presentation-graph.svg index 3b50a1b43..7479a4c9a 100644 --- a/diagrams/presentation-graph.svg +++ b/diagrams/presentation-graph.svg @@ -67,7 +67,7 @@ A signature with a nonce, date, algorithm used, and a public key for the proof's Credential 123 - issuanceDate + validFrom 2010-01-01T19:37.24Z diff --git a/index.html b/index.html index 6eadecc16..53ce08518 100644 --- a/index.html +++ b/index.html @@ -756,7 +756,7 @@

Credentials

Proof Graph on the bottom. The Credental Graph has Credential 123 with 4 properties: 'type' of value AlumniCredential, 'issuer' of Example University, - 'issuanceDate' of 2010-01-01T19:23:24Z, and + 'validFrom' of 2010-01-01T19:23:24Z, and credentialSubject of Pat, who has an alumniOf property with value of Example University. The Proof Graph has Signature 456 with 5 properties: 'type' of @@ -924,7 +924,7 @@

Concrete Lifecycle Example

// the entity that issued the credential "issuer": "https://example.edu/issuers/565049", // when the credential was issued - "issuanceDate": "2010-01-01T19:23:24Z", + "validFrom": "2010-01-01T19:23:24Z", // claims about the subjects of the credential "credentialSubject": { // identifier for the only subject of the credential @@ -989,7 +989,7 @@

Concrete Lifecycle Example

"id": "http://example.edu/credentials/1872", "type": ["VerifiableCredential", "AlumniCredential"], "issuer": "https://example.edu/issuers/565049", - "issuanceDate": "2010-01-01T19:23:24Z", + "validFrom": "2010-01-01T19:23:24Z", "credentialSubject": { "id": "did:example:ebfeb1f712ebc6f1c276e12ec21", "alumniOf": { @@ -1120,7 +1120,7 @@

Contexts

"id": "http://example.edu/credentials/58473", "type": ["VerifiableCredential", "AlumniCredential"], "issuer": "https://example.edu/issuers/565049", - "issuanceDate": "2010-01-01T00:00:00Z", + "validFrom": "2010-01-01T00:00:00Z", "credentialSubject": { "id": "did:example:ebfeb1f712ebc6f1c276e12ec21", "alumniOf": { @@ -1226,7 +1226,7 @@

Identifiers

"id": "http://example.edu/credentials/3732", "type": ["VerifiableCredential", "UniversityDegreeCredential"], "issuer": "https://example.edu/issuers/565049", - "issuanceDate": "2010-01-01T00:00:00Z", + "validFrom": "2010-01-01T00:00:00Z", "credentialSubject": { "id": "did:example:ebfeb1f712ebc6f1c276e12ec21", "degree": { @@ -1302,7 +1302,7 @@

Types

"id": "http://example.edu/credentials/3732", "type": ["VerifiableCredential", "UniversityDegreeCredential"], "issuer": "https://example.edu/issuers/565049", - "issuanceDate": "2010-01-01T00:00:00Z", + "validFrom": "2010-01-01T00:00:00Z", "credentialSubject": { "id": "did:example:ebfeb1f712ebc6f1c276e12ec21", "degree": { @@ -1519,7 +1519,7 @@

Credential Subject

"id": "http://example.edu/credentials/3732", "type": ["VerifiableCredential", "UniversityDegreeCredential"], "issuer": "https://example.edu/issuers/565049", - "issuanceDate": "2010-01-01T00:00:00Z", + "validFrom": "2010-01-01T00:00:00Z", "credentialSubject": { "id": "did:example:ebfeb1f712ebc6f1c276e12ec21", "degree": { @@ -1547,7 +1547,7 @@

Credential Subject

"id": "http://example.edu/credentials/3732", "type": ["VerifiableCredential", "RelationshipCredential"], "issuer": "https://example.com/issuer/123", - "issuanceDate": "2010-01-01T00:00:00Z", + "validFrom": "2010-01-01T00:00:00Z", "credentialSubject": [{ "id": "did:example:ebfeb1f712ebc6f1c276e12ec21", "name": "Jayden Doe", @@ -1596,7 +1596,7 @@

Issuer

"id": "http://example.edu/credentials/3732", "type": ["VerifiableCredential", "UniversityDegreeCredential"], "issuer": "https://example.edu/issuers/14", - "issuanceDate": "2010-01-01T19:23:24Z", + "validFrom": "2010-01-01T19:23:24Z", "credentialSubject": { "id": "did:example:ebfeb1f712ebc6f1c276e12ec21", "degree": { @@ -1626,7 +1626,7 @@

Issuer

"id": "did:example:76e12ec712ebc6f1c221ebfeb1f", "name": "Example University" }, - "issuanceDate": "2010-01-01T19:23:24Z", + "validFrom": "2010-01-01T19:23:24Z", "credentialSubject": { "id": "did:example:ebfeb1f712ebc6f1c276e12ec21", "degree": { @@ -1649,15 +1649,15 @@

Issuer

Issuance Date

-This specification defines the issuanceDate property for +This specification defines the validFrom property for expressing the date and time when a credential becomes valid.

-
issuanceDate
+
validFrom
-A credential MUST have an issuanceDate property. The -value of the issuanceDate property MUST be a string value of +A credential MUST have a validFrom property. The +value of the validFrom property MUST be a string value of an [XMLSCHEMA11-2] combined date-time string representing the date and time the credential becomes valid, which could be a date and time in the future. @@ -1668,7 +1668,7 @@

Issuance Date

 {
   "@context": [
@@ -1678,7 +1678,7 @@ 
Issuance Date

   "id": "http://example.edu/credentials/3732",
   "type": ["VerifiableCredential", "UniversityDegreeCredential"],
   "issuer": "https://example.edu/issuers/14",
-  "issuanceDate": "2010-01-01T19:23:24Z",
+  "validFrom": "2010-01-01T19:23:24Z",
   "credentialSubject": {
     "id": "did:example:ebfeb1f712ebc6f1c276e12ec21",
     "degree": {
@@ -1689,17 +1689,6 @@ 
Issuance Date

 }
-

-It is expected that the next version of this specification will add the -validFrom property and will deprecate the -issuanceDate property in favor of a new issued -property. The range of values for both properties are expected to remain -as [XMLSCHEMA11-2] combined -date-time strings. Implementers are advised that the -validFrom and issued properties are reserved -and use for any other purpose is discouraged. -

-
@@ -1756,7 +1745,7 @@

Proofs (Signatures)

"id": "http://example.gov/credentials/3732", "type": ["VerifiableCredential", "UniversityDegreeCredential"], "issuer": "https://example.edu", - "issuanceDate": "2010-01-01T19:23:24Z", + "validFrom": "2010-01-01T19:23:24Z", "credentialSubject": { "id": "did:example:ebfeb1f712ebc6f1c276e12ec21", "degree": { @@ -1817,7 +1806,7 @@

Expiration

"id": "http://example.edu/credentials/3732", "type": ["VerifiableCredential", "UniversityDegreeCredential"], "issuer": "https://example.edu/issuers/14", - "issuanceDate": "2010-01-01T19:23:24Z", + "validFrom": "2010-01-01T19:23:24Z", "expirationDate": "2020-01-01T19:23:24Z", "credentialSubject": { "id": "did:example:ebfeb1f712ebc6f1c276e12ec21", @@ -1889,7 +1878,7 @@

Status

"id": "http://example.edu/credentials/3732", "type": ["VerifiableCredential", "UniversityDegreeCredential"], "issuer": "https://example.edu/issuers/14", - "issuanceDate": "2010-01-01T19:23:24Z", + "validFrom": "2010-01-01T19:23:24Z", "credentialSubject": { "id": "did:example:ebfeb1f712ebc6f1c276e12ec21", "degree": { @@ -2317,7 +2306,7 @@

Extensibility

"id": "http://example.com/credentials/4643", "type": ["VerifiableCredential"], "issuer": "https://example.com/issuers/14", - "issuanceDate": "2018-02-24T05:28:04Z", + "validFrom": "2018-02-24T05:28:04Z", "credentialSubject": { "id": "did:example:abcdef1234567", "name": "Jane Doe" @@ -2370,7 +2359,7 @@

Extensibility

"id": "http://example.com/credentials/4643", "type": ["VerifiableCredential", "CustomExt12"], "issuer": "https://example.com/issuers/14", - "issuanceDate": "2018-02-24T05:28:04Z", + "validFrom": "2018-02-24T05:28:04Z", "referenceNumber": 83294847, "credentialSubject": { "id": "did:example:abcdef1234567", @@ -2537,7 +2526,7 @@

Data Schemas

"id": "http://example.edu/credentials/3732", "type": ["VerifiableCredential", "UniversityDegreeCredential"], "issuer": "https://example.edu/issuers/14", - "issuanceDate": "2010-01-01T19:23:24Z", + "validFrom": "2010-01-01T19:23:24Z", "credentialSubject": { "id": "did:example:ebfeb1f712ebc6f1c276e12ec21", "degree": { @@ -2581,7 +2570,7 @@

Data Schemas

"id": "http://example.edu/credentials/3732", "type": ["VerifiableCredential", "UniversityDegreeCredential"], "issuer": "https://example.edu/issuers/14", - "issuanceDate": "2010-01-01T19:23:24Z", + "validFrom": "2010-01-01T19:23:24Z", "credentialSubject": { "id": "did:example:ebfeb1f712ebc6f1c276e12ec21", "degree": { @@ -2669,7 +2658,7 @@

Refreshing

"id": "http://example.edu/credentials/3732", "type": ["VerifiableCredential", "UniversityDegreeCredential"], "issuer": "https://example.edu/issuers/14", - "issuanceDate": "2010-01-01T19:23:24Z", + "validFrom": "2010-01-01T19:23:24Z", "credentialSubject": { "id": "did:example:ebfeb1f712ebc6f1c276e12ec21", "degree": { @@ -2749,7 +2738,7 @@

Terms of Use

"id": "http://example.edu/credentials/3732", "type": ["VerifiableCredential", "UniversityDegreeCredential"], "issuer": "https://example.edu/issuers/14", - "issuanceDate": "2010-01-01T19:23:24Z", + "validFrom": "2010-01-01T19:23:24Z", "credentialSubject": { "id": "did:example:ebfeb1f712ebc6f1c276e12ec21", "degree": { @@ -2807,7 +2796,7 @@

Terms of Use

"id": "http://example.edu/credentials/3732", "type": ["VerifiableCredential", "UniversityDegreeCredential"], "issuer": "https://example.edu/issuers/14", - "issuanceDate": "2010-01-01T19:23:24Z", + "validFrom": "2010-01-01T19:23:24Z", "credentialSubject": { "id": "did:example:ebfeb1f712ebc6f1c276e12ec21", "degree": { @@ -2920,7 +2909,7 @@

Evidence

"id": "http://example.edu/credentials/3732", "type": ["VerifiableCredential", "UniversityDegreeCredential"], "issuer": "https://example.edu/issuers/14", - "issuanceDate": "2010-01-01T19:23:24Z", + "validFrom": "2010-01-01T19:23:24Z", "credentialSubject": { "id": "did:example:ebfeb1f712ebc6f1c276e12ec21", "degree": { @@ -3248,7 +3237,7 @@

Disputes

}, }, "issuer": "https://example.com/people#me", - "issuanceDate": "2017-12-05T14:27:42Z", + "validFrom": "2017-12-05T14:27:42Z", "proof": { ... } } @@ -3329,7 +3318,7 @@

Syntaxes

issuer property
  • -issuanceDate property +validFrom property
  • expirationDate property. @@ -3821,7 +3810,7 @@

    Bearer Credentials

    "id": "http://example.edu/credentials/temporary/28934792387492384", "type": ["VerifiableCredential", "UniversityDegreeCredential"], "issuer": "https://example.edu/issuers/14", - "issuanceDate": "2017-10-22T12:23:48Z", + "validFrom": "2017-10-22T12:23:48Z", "credentialSubject": { // note that the 'id' property is not specified for bearer credentials "degree": { @@ -4719,11 +4708,11 @@

    Issuer

    • -

    Issuance Date

    +

    Valid From

    -The issuanceDate is expected to be within an expected range for the -verifier. For example, a verifier can check that the issuance date +The validFrom is expected to be within an expected range for the +verifier. For example, a verifier can check that the valid from property of a verifiable credential is not in the future.

    @@ -4896,7 +4885,7 @@

    Base Context

    "holder": {"@id": "cred:holder", "@type": "@id"}, "issued": {"@id": "cred:issued", "@type": "xsd:dateTime"}, "issuer": {"@id": "cred:issuer", "@type": "@id"}, - "issuanceDate": {"@id": "cred:issuanceDate", "@type": "xsd:dateTime"}, + "validFrom": {"@id": "cred:validFrom", "@type": "xsd:dateTime"}, "proof": {"@id": "sec:proof", "@type": "@id", "@container": "@graph"}, "refreshService": { "@id": "cred:refreshService", diff --git a/vocab/credentials/v2/vocabulary.csv b/vocab/credentials/v2/vocabulary.csv index 2e6ee5c2d..4e138661d 100644 --- a/vocab/credentials/v2/vocabulary.csv +++ b/vocab/credentials/v2/vocabulary.csv @@ -19,7 +19,7 @@ property,credentialSubject,,,credential subject,,cred:VerifiableCredential,,,An property,evidence,,,evidence,,cred:VerifiableCredential,cred:CredentialEvidence,,The value of the `evidence` property MUST be one or more Credential Evidence instances. property,expirationDate,,,expiration date,,cred:VerifiableCredential,xsd:dateTime,,The value of the `expirationDate` 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. property,holder,,,holder,,"cred:VerifiableCredential,cred:VerifiablePresentation",,,The value of the `holder` property MUST be a URI. It is RECOMMENDED that dereferencing the URI results in a document containing machine-readable information about the holder that can be used to verify the information expressed in the credential. -property,issuanceDate,,,issuance date,,cred:VerifiableCredential,xsd:dateTime,,The value of the `issuanceDate` 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. +property,validFrom,,,issuance date,,cred:VerifiableCredential,xsd:dateTime,,The value of the `validFrom` 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. property,issued,,,issue date,,cred:VerifiableCredential,xsd:dateTime,,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. property,issuer,,,issuer,,cred:VerifiableCredential,,,The value of the `issuer` property MUST be a URI. It is RECOMMENDED that dereferencing the URI results in a document containing machine-readable information about the issuer that can be used to verify the information expressed in the credential. property,refreshService,,,refresh service,,cred:VerifiableCredential,cred:RefreshService,,The value of the `refreshService` property MUST be one or more Refresh Service instances such that the holder can refresh the credential. diff --git a/vocab/credentials/v2/vocabulary.html b/vocab/credentials/v2/vocabulary.html index 5817115c9..6fdc886b5 100644 --- a/vocab/credentials/v2/vocabulary.html +++ b/vocab/credentials/v2/vocabulary.html @@ -98,7 +98,7 @@ JSON-LD.

    -
    Published:
    +
    Published:
    Version Info:
    2.0
    See Also: https://www.w3.org/TR/vc-data-model-2.0/
    @@ -126,7 +126,7 @@

    Class definitions

    Property definitions

    -

    The following are property definitions in the cred namespace:

    credentialSchemacredential schema

    The value of the `credentialSchema` property MUST be one or more Credential Schema instances.

    Range:
    cred:CredentialSchema
    Domain:
    cred:VerifiableCredential
    credentialStatuscredential status

    The value of the `credentialStatus` property MUST be an instance of Credential Status.

    Range:
    cred:CredentialStatus
    Domain:
    cred:VerifiableCredential
    credentialSubjectcredential subject

    An entity about which claims are made.

    Domain:
    cred:VerifiableCredential
    evidenceevidence

    The value of the `evidence` property MUST be one or more Credential Evidence instances.

    Range:
    cred:CredentialEvidence
    Domain:
    cred:VerifiableCredential
    expirationDateexpiration date

    The value of the `expirationDate` 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.

    Range:
    xsd:dateTime
    Domain:
    cred:VerifiableCredential
    holderholder

    The value of the `holder` property MUST be a URI. It is RECOMMENDED that dereferencing the URI results in a document containing machine-readable information about the holder that can be used to verify the information expressed in the credential.

    Domain:
    Union of:
    cred:VerifiableCredential
    cred:VerifiablePresentation
    issuanceDateissuance date

    The value of the `issuanceDate` 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.

    Range:
    xsd:dateTime
    Domain:
    cred:VerifiableCredential
    issuedissue date

    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.

    Range:
    xsd:dateTime
    Domain:
    cred:VerifiableCredential
    issuerissuer

    The value of the `issuer` property MUST be a URI. It is RECOMMENDED that dereferencing the URI results in a document containing machine-readable information about the issuer that can be used to verify the information expressed in the credential.

    Domain:
    cred:VerifiableCredential
    refreshServicerefresh service

    The value of the `refreshService` property MUST be one or more Refresh Service instances such that the holder can refresh the credential.

    Range:
    cred:RefreshService
    Domain:
    cred:VerifiableCredential
    serviceEndpointservice endpoint

    The value of the `serviceEndpoint` property MUST be a URL to the service endpoint associated with the subject.

    Domain:
    cred:RefreshService
    termsOfUseterms of use

    If specified, the value of the `termsOfUse` property MUST specify one or more terms of use policies under which the creator issued the credential or presentation. If the recipient (a holder or verifier) is not willing to adhere to the specified terms of use, then they do so on their own responsibility and might incur legal liability if they violate the stated Terms of Use. Each `termsOfUse` MUST specify its type, for example, `IssuerPolicy`, and optionally, its instance `id`. The precise contents of each term of use is determined by the specific `TermsOfUse` type definition.

    Range:
    odrl:Policy
    Domain:
    cred:VerifiableCredential
    verifiableCredentialverifiable credential

    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:VerifiableCredentialGraph
    Domain:
    cred:VerifiablePresentation
    +

    The following are property definitions in the cred namespace:

    credentialSchemacredential schema

    The value of the `credentialSchema` property MUST be one or more Credential Schema instances.

    Range:
    cred:CredentialSchema
    Domain:
    cred:VerifiableCredential
    credentialStatuscredential status

    The value of the `credentialStatus` property MUST be an instance of Credential Status.

    Range:
    cred:CredentialStatus
    Domain:
    cred:VerifiableCredential
    credentialSubjectcredential subject

    An entity about which claims are made.

    Domain:
    cred:VerifiableCredential
    evidenceevidence

    The value of the `evidence` property MUST be one or more Credential Evidence instances.

    Range:
    cred:CredentialEvidence
    Domain:
    cred:VerifiableCredential
    expirationDateexpiration date

    The value of the `expirationDate` 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.

    Range:
    xsd:dateTime
    Domain:
    cred:VerifiableCredential
    holderholder

    The value of the `holder` property MUST be a URI. It is RECOMMENDED that dereferencing the URI results in a document containing machine-readable information about the holder that can be used to verify the information expressed in the credential.

    Domain:
    Union of:
    cred:VerifiableCredential
    cred:VerifiablePresentation
    validFromissuance date

    The value of the `validFrom` 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.

    Range:
    xsd:dateTime
    Domain:
    cred:VerifiableCredential
    issuedissue date

    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.

    Range:
    xsd:dateTime
    Domain:
    cred:VerifiableCredential
    issuerissuer

    The value of the `issuer` property MUST be a URI. It is RECOMMENDED that dereferencing the URI results in a document containing machine-readable information about the issuer that can be used to verify the information expressed in the credential.

    Domain:
    cred:VerifiableCredential
    refreshServicerefresh service

    The value of the `refreshService` property MUST be one or more Refresh Service instances such that the holder can refresh the credential.

    Range:
    cred:RefreshService
    Domain:
    cred:VerifiableCredential
    serviceEndpointservice endpoint

    The value of the `serviceEndpoint` property MUST be a URL to the service endpoint associated with the subject.

    Domain:
    cred:RefreshService
    termsOfUseterms of use

    If specified, the value of the `termsOfUse` property MUST specify one or more terms of use policies under which the creator issued the credential or presentation. If the recipient (a holder or verifier) is not willing to adhere to the specified terms of use, then they do so on their own responsibility and might incur legal liability if they violate the stated Terms of Use. Each `termsOfUse` MUST specify its type, for example, `IssuerPolicy`, and optionally, its instance `id`. The precise contents of each term of use is determined by the specific `TermsOfUse` type definition.

    Range:
    odrl:Policy
    Domain:
    cred:VerifiableCredential
    verifiableCredentialverifiable credential

    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:VerifiableCredentialGraph
    Domain:
    cred:VerifiablePresentation
    diff --git a/vocab/credentials/v2/vocabulary.jsonld b/vocab/credentials/v2/vocabulary.jsonld index 748dd125a..94c4c21c9 100644 --- a/vocab/credentials/v2/vocabulary.jsonld +++ b/vocab/credentials/v2/vocabulary.jsonld @@ -85,7 +85,7 @@ "en": "RDFS [[RDF-SCHEMA]] vocabulary used by the Verifiable Credentials [[VC-DATA-MODEL]]" }, "rdfs:seeAlso": "https://www.w3.org/TR/vc-data-model-2.0/", - "dc:date": "2022-09-29", + "dc:date": "2022-10-27", "rdfs_classes": [ { "@id": "cred:JsonSchemaValidator2018", @@ -284,7 +284,7 @@ } }, { - "@id": "cred:issuanceDate", + "@id": "cred:validFrom", "@type": "rdf:Property", "rdfs:subPropertyOf": [], "rdfs:domain": "cred:VerifiableCredential", @@ -293,7 +293,7 @@ "en": "issuance date" }, "rdfs:comment": { - "en": "The value of the `issuanceDate` 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." + "en": "The value of the `validFrom` 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." } }, { diff --git a/vocab/credentials/v2/vocabulary.ttl b/vocab/credentials/v2/vocabulary.ttl index 54fb849a5..06c4679f3 100644 --- a/vocab/credentials/v2/vocabulary.ttl +++ b/vocab/credentials/v2/vocabulary.ttl @@ -11,7 +11,7 @@ cred: a owl:Ontology dc:title """Verifiable Credentials Vocabulary v2.0"""@en ; dc:description """RDFS [[RDF-SCHEMA]] vocabulary used by the Verifiable Credentials [[VC-DATA-MODEL]]"""@en ; rdfs:seeAlso ; - dc:date "2022-09-29"^^xsd:date ; + dc:date "2022-10-27"^^xsd:date ; . # Class definitions @@ -137,12 +137,12 @@ cred:holder a rdf:Property ; rdfs:isDefinedBy cred: ; . -cred:issuanceDate a rdf:Property ; +cred:validFrom a rdf:Property ; rdfs:subPropertyOf ; rdfs:domain cred:VerifiableCredential ; rdfs:range xsd:dateTime ; rdfs:label "issuance date" ; - rdfs:comment """The value of the `issuanceDate` 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."""@en ; + rdfs:comment """The value of the `validFrom` 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."""@en ; rdfs:isDefinedBy cred: ; . From d22a11851354d868e4eb5a1ca98b4fb6d8317b4c Mon Sep 17 00:00:00 2001 From: Mahmoud Alkhraishi Date: Thu, 27 Oct 2022 12:50:39 -0400 Subject: [PATCH 2/3] update expirationDate to validUntil --- VCDMExplainer.md | 4 ++-- index.html | 26 +++++++++----------------- vocab/credentials/v2/vocabulary.csv | 4 ++-- vocab/credentials/v2/vocabulary.html | 2 +- vocab/credentials/v2/vocabulary.jsonld | 8 ++++---- vocab/credentials/v2/vocabulary.ttl | 8 ++++---- 6 files changed, 22 insertions(+), 30 deletions(-) diff --git a/VCDMExplainer.md b/VCDMExplainer.md index 3013bf8c4..1c7edd8c6 100644 --- a/VCDMExplainer.md +++ b/VCDMExplainer.md @@ -153,7 +153,7 @@ Decentralized Identifier (DID) scheme. "id": "http://example.edu/credentials/1872", "type": ["VerifiableCredential", "AlumniCredential"], "issuer": "https://example.edu/issuers/565049",, - "issuanceDate": "2010-01-01T19:73:24Z", + "validFrom": "2010-01-01T19:73:24Z", "credentialSubject": { "id": "did:example:ebfeb1f712ebc6f1c276e12ec21", "alumniOf": "Example University" @@ -184,7 +184,7 @@ The following is an example verifiable credential that supports ZKPs. "ExampleNameDOB" ], "issuer": "did:sov:4t1FPo72LzDMwpqtTVGVjysD6GUqS", - "issuanceDate": "2018-11-27T12:37:15Z", + "validFrom": "2018-11-27T12:37:15Z", "credentialSubject": { "name": "John Doe", "birthDate": "1969-02-14", diff --git a/index.html b/index.html index 53ce08518..d2a97f78e 100644 --- a/index.html +++ b/index.html @@ -1646,7 +1646,7 @@

    Issuer

    -

    Issuance Date

    +

    Valid From

    This specification defines the validFrom property for @@ -1781,14 +1781,14 @@

    Proofs (Signatures)

    Expiration

    -This specification defines the expirationDate property for +This specification defines the validUntil property for the expression of credential expiration information.

    -
    expirationDate
    +
    validUntil
    -If present, the value of the expirationDate property MUST be +If present, the value of the validUntil property MUST be a string value of an [XMLSCHEMA11-2] date-time representing the date and time the credential ceases to be valid. @@ -1796,7 +1796,7 @@

    Expiration

     {
   "@context": [
@@ -1807,7 +1807,7 @@ 
    Expiration
    
   "type": ["VerifiableCredential", "UniversityDegreeCredential"],
   "issuer": "https://example.edu/issuers/14",
   "validFrom": "2010-01-01T19:23:24Z",
-  "expirationDate": "2020-01-01T19:23:24Z",
+  "validUntil": "2020-01-01T19:23:24Z",
   "credentialSubject": {
     "id": "did:example:ebfeb1f712ebc6f1c276e12ec21",
     "degree": {
@@ -1818,14 +1818,6 @@ 
    Expiration
    
 }
    -

    -It is expected that the next version of this specification will add the -validUntil property in a way that deprecates, but -preserves backwards compatibility with the expirationDate -property. Implementers are advised that the validUntil -property is reserved and its use for any other purpose is discouraged. -

    -
    @@ -3321,7 +3313,7 @@

    Syntaxes

    validFrom property
  • -expirationDate property. +validUntil property.
    • @@ -4786,7 +4778,7 @@

    Proofs (Signatures)

    Expiration

    -The expirationDate is expected to be within an expected range +The validUntil is expected to be within an expected range for the verifier. For example, a verifier can check that the expiration date of a verifiable credential is not in the past.

    @@ -4881,7 +4873,7 @@

    Base Context

    "credentialStatus": {"@id": "cred:credentialStatus", "@type": "@id"}, "credentialSubject": {"@id": "cred:credentialSubject", "@type": "@id"}, "evidence": {"@id": "cred:evidence", "@type": "@id"}, - "expirationDate": {"@id": "cred:expirationDate", "@type": "xsd:dateTime"}, + "validUntil": {"@id": "cred:validUntil", "@type": "xsd:dateTime"}, "holder": {"@id": "cred:holder", "@type": "@id"}, "issued": {"@id": "cred:issued", "@type": "xsd:dateTime"}, "issuer": {"@id": "cred:issuer", "@type": "@id"}, diff --git a/vocab/credentials/v2/vocabulary.csv b/vocab/credentials/v2/vocabulary.csv index 4e138661d..6bf1a3829 100644 --- a/vocab/credentials/v2/vocabulary.csv +++ b/vocab/credentials/v2/vocabulary.csv @@ -17,9 +17,9 @@ property,credentialSchema,,,credential schema,,cred:VerifiableCredential,cred:Cr property,credentialStatus,,,credential status,,cred:VerifiableCredential,cred:CredentialStatus,,The value of the `credentialStatus` property MUST be an instance of Credential Status. property,credentialSubject,,,credential subject,,cred:VerifiableCredential,,,An entity about which claims are made. property,evidence,,,evidence,,cred:VerifiableCredential,cred:CredentialEvidence,,The value of the `evidence` property MUST be one or more Credential Evidence instances. -property,expirationDate,,,expiration date,,cred:VerifiableCredential,xsd:dateTime,,The value of the `expirationDate` 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. +property,validUntil,,,valid until,,cred:VerifiableCredential,xsd:dateTime,,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. property,holder,,,holder,,"cred:VerifiableCredential,cred:VerifiablePresentation",,,The value of the `holder` property MUST be a URI. It is RECOMMENDED that dereferencing the URI results in a document containing machine-readable information about the holder that can be used to verify the information expressed in the credential. -property,validFrom,,,issuance date,,cred:VerifiableCredential,xsd:dateTime,,The value of the `validFrom` 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. +property,validFrom,,,valid from,,cred:VerifiableCredential,xsd:dateTime,,The value of the `validFrom` 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. property,issued,,,issue date,,cred:VerifiableCredential,xsd:dateTime,,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. property,issuer,,,issuer,,cred:VerifiableCredential,,,The value of the `issuer` property MUST be a URI. It is RECOMMENDED that dereferencing the URI results in a document containing machine-readable information about the issuer that can be used to verify the information expressed in the credential. property,refreshService,,,refresh service,,cred:VerifiableCredential,cred:RefreshService,,The value of the `refreshService` property MUST be one or more Refresh Service instances such that the holder can refresh the credential. diff --git a/vocab/credentials/v2/vocabulary.html b/vocab/credentials/v2/vocabulary.html index 6fdc886b5..21415476b 100644 --- a/vocab/credentials/v2/vocabulary.html +++ b/vocab/credentials/v2/vocabulary.html @@ -126,7 +126,7 @@

    Class definitions

    Property definitions

    -

    The following are property definitions in the cred namespace:

    credentialSchemacredential schema

    The value of the `credentialSchema` property MUST be one or more Credential Schema instances.

    Range:
    cred:CredentialSchema
    Domain:
    cred:VerifiableCredential
    credentialStatuscredential status

    The value of the `credentialStatus` property MUST be an instance of Credential Status.

    Range:
    cred:CredentialStatus
    Domain:
    cred:VerifiableCredential
    credentialSubjectcredential subject

    An entity about which claims are made.

    Domain:
    cred:VerifiableCredential
    evidenceevidence

    The value of the `evidence` property MUST be one or more Credential Evidence instances.

    Range:
    cred:CredentialEvidence
    Domain:
    cred:VerifiableCredential
    expirationDateexpiration date

    The value of the `expirationDate` 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.

    Range:
    xsd:dateTime
    Domain:
    cred:VerifiableCredential
    holderholder

    The value of the `holder` property MUST be a URI. It is RECOMMENDED that dereferencing the URI results in a document containing machine-readable information about the holder that can be used to verify the information expressed in the credential.

    Domain:
    Union of:
    cred:VerifiableCredential
    cred:VerifiablePresentation
    validFromissuance date

    The value of the `validFrom` 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.

    Range:
    xsd:dateTime
    Domain:
    cred:VerifiableCredential
    issuedissue date

    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.

    Range:
    xsd:dateTime
    Domain:
    cred:VerifiableCredential
    issuerissuer

    The value of the `issuer` property MUST be a URI. It is RECOMMENDED that dereferencing the URI results in a document containing machine-readable information about the issuer that can be used to verify the information expressed in the credential.

    Domain:
    cred:VerifiableCredential
    refreshServicerefresh service

    The value of the `refreshService` property MUST be one or more Refresh Service instances such that the holder can refresh the credential.

    Range:
    cred:RefreshService
    Domain:
    cred:VerifiableCredential
    serviceEndpointservice endpoint

    The value of the `serviceEndpoint` property MUST be a URL to the service endpoint associated with the subject.

    Domain:
    cred:RefreshService
    termsOfUseterms of use

    If specified, the value of the `termsOfUse` property MUST specify one or more terms of use policies under which the creator issued the credential or presentation. If the recipient (a holder or verifier) is not willing to adhere to the specified terms of use, then they do so on their own responsibility and might incur legal liability if they violate the stated Terms of Use. Each `termsOfUse` MUST specify its type, for example, `IssuerPolicy`, and optionally, its instance `id`. The precise contents of each term of use is determined by the specific `TermsOfUse` type definition.

    Range:
    odrl:Policy
    Domain:
    cred:VerifiableCredential
    verifiableCredentialverifiable credential

    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:VerifiableCredentialGraph
    Domain:
    cred:VerifiablePresentation
    +

    The following are property definitions in the cred namespace:

    credentialSchemacredential schema

    The value of the `credentialSchema` property MUST be one or more Credential Schema instances.

    Range:
    cred:CredentialSchema
    Domain:
    cred:VerifiableCredential
    credentialStatuscredential status

    The value of the `credentialStatus` property MUST be an instance of Credential Status.

    Range:
    cred:CredentialStatus
    Domain:
    cred:VerifiableCredential
    credentialSubjectcredential subject

    An entity about which claims are made.

    Domain:
    cred:VerifiableCredential
    evidenceevidence

    The value of the `evidence` property MUST be one or more Credential Evidence instances.

    Range:
    cred:CredentialEvidence
    Domain:
    cred:VerifiableCredential
    validUntilvalid until

    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.

    Range:
    xsd:dateTime
    Domain:
    cred:VerifiableCredential
    holderholder

    The value of the `holder` property MUST be a URI. It is RECOMMENDED that dereferencing the URI results in a document containing machine-readable information about the holder that can be used to verify the information expressed in the credential.

    Domain:
    Union of:
    cred:VerifiableCredential
    cred:VerifiablePresentation
    validFromvalid from

    The value of the `validFrom` 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.

    Range:
    xsd:dateTime
    Domain:
    cred:VerifiableCredential
    issuedissue date

    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.

    Range:
    xsd:dateTime
    Domain:
    cred:VerifiableCredential
    issuerissuer

    The value of the `issuer` property MUST be a URI. It is RECOMMENDED that dereferencing the URI results in a document containing machine-readable information about the issuer that can be used to verify the information expressed in the credential.

    Domain:
    cred:VerifiableCredential
    refreshServicerefresh service

    The value of the `refreshService` property MUST be one or more Refresh Service instances such that the holder can refresh the credential.

    Range:
    cred:RefreshService
    Domain:
    cred:VerifiableCredential
    serviceEndpointservice endpoint

    The value of the `serviceEndpoint` property MUST be a URL to the service endpoint associated with the subject.

    Domain:
    cred:RefreshService
    termsOfUseterms of use

    If specified, the value of the `termsOfUse` property MUST specify one or more terms of use policies under which the creator issued the credential or presentation. If the recipient (a holder or verifier) is not willing to adhere to the specified terms of use, then they do so on their own responsibility and might incur legal liability if they violate the stated Terms of Use. Each `termsOfUse` MUST specify its type, for example, `IssuerPolicy`, and optionally, its instance `id`. The precise contents of each term of use is determined by the specific `TermsOfUse` type definition.

    Range:
    odrl:Policy
    Domain:
    cred:VerifiableCredential
    verifiableCredentialverifiable credential

    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:VerifiableCredentialGraph
    Domain:
    cred:VerifiablePresentation
    diff --git a/vocab/credentials/v2/vocabulary.jsonld b/vocab/credentials/v2/vocabulary.jsonld index 94c4c21c9..736fb0c96 100644 --- a/vocab/credentials/v2/vocabulary.jsonld +++ b/vocab/credentials/v2/vocabulary.jsonld @@ -253,16 +253,16 @@ } }, { - "@id": "cred:expirationDate", + "@id": "cred:validUntil", "@type": "rdf:Property", "rdfs:subPropertyOf": [], "rdfs:domain": "cred:VerifiableCredential", "rdfs:range": "xsd:dateTime", "rdfs:label": { - "en": "expiration date" + "en": "valid until" }, "rdfs:comment": { - "en": "The value of the `expirationDate` 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." + "en": "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." } }, { @@ -290,7 +290,7 @@ "rdfs:domain": "cred:VerifiableCredential", "rdfs:range": "xsd:dateTime", "rdfs:label": { - "en": "issuance date" + "en": "valid from" }, "rdfs:comment": { "en": "The value of the `validFrom` 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." diff --git a/vocab/credentials/v2/vocabulary.ttl b/vocab/credentials/v2/vocabulary.ttl index 06c4679f3..c0a83bf03 100644 --- a/vocab/credentials/v2/vocabulary.ttl +++ b/vocab/credentials/v2/vocabulary.ttl @@ -119,12 +119,12 @@ cred:evidence a rdf:Property ; rdfs:isDefinedBy cred: ; . -cred:expirationDate a rdf:Property ; +cred:validUntil a rdf:Property ; rdfs:subPropertyOf ; rdfs:domain cred:VerifiableCredential ; rdfs:range xsd:dateTime ; - rdfs:label "expiration date" ; - rdfs:comment """The value of the `expirationDate` 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."""@en ; + rdfs:label "valid until" ; + rdfs: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."""@en ; rdfs:isDefinedBy cred: ; . @@ -141,7 +141,7 @@ cred:validFrom a rdf:Property ; rdfs:subPropertyOf ; rdfs:domain cred:VerifiableCredential ; rdfs:range xsd:dateTime ; - rdfs:label "issuance date" ; + rdfs:label "valid from" ; rdfs:comment """The value of the `validFrom` 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."""@en ; rdfs:isDefinedBy cred: ; . From b1d5a42cfeb8f6d4b4c86f95a1b1c1d093f2c10d Mon Sep 17 00:00:00 2001 From: Mahmoud Alkhraishi Date: Thu, 27 Oct 2022 14:55:38 -0400 Subject: [PATCH 3/3] remove duplicate in context --- index.html | 2 -- 1 file changed, 2 deletions(-) diff --git a/index.html b/index.html index d2a97f78e..1b1ccf3d5 100644 --- a/index.html +++ b/index.html @@ -4873,11 +4873,9 @@

    Base Context

    "credentialStatus": {"@id": "cred:credentialStatus", "@type": "@id"}, "credentialSubject": {"@id": "cred:credentialSubject", "@type": "@id"}, "evidence": {"@id": "cred:evidence", "@type": "@id"}, - "validUntil": {"@id": "cred:validUntil", "@type": "xsd:dateTime"}, "holder": {"@id": "cred:holder", "@type": "@id"}, "issued": {"@id": "cred:issued", "@type": "xsd:dateTime"}, "issuer": {"@id": "cred:issuer", "@type": "@id"}, - "validFrom": {"@id": "cred:validFrom", "@type": "xsd:dateTime"}, "proof": {"@id": "sec:proof", "@type": "@id", "@container": "@graph"}, "refreshService": { "@id": "cred:refreshService",