This document describes the Bitstring Status List Vocabulary, i.e., the RDFS [[RDF-SCHEMA]] vocabulary used by the [[[VC-BITSTRING-STATUS-LIST]]] [[VC-BITSTRING-STATUS-LIST]].

Alternate versions of the vocabulary definition exist in Turtle and JSON-LD.

Published:
Version Info:
1.0
See Also: https://www.w3.org/TR/vc-bitstring-status-list/

This vocabulary has been defined by the W3C Verifiable Credentials Working Group and provides the official RDFS vocabulary for Bitstring Status Lists. Comments regarding this document are welcome. Please file issues directly on GitHub, or send them to public-vc-comments@w3.org ( subscribe, archives).

Specification of terms

In general, the terms — i.e., the properties and classes — used in the VCDM are formally specified in Recommendation Track documents published by the W3C Verifiable Credentials Working Group. In each case of such external definition, the term's description in this document contains a link to the relevant specification. Additionally, the `rdfs:definedBy` property in the RDFS representation(s) refers to the formal specification.

In some cases, a local explanation is necessary to complement, or to replace, the definition found in an external specification. For instance, this is so when the term is needed to provide a consistent structure to the RDFS vocabulary, such as when the term defines a common supertype for class instances that are used as objects of specific properties. For such cases, the extra definition is included in the current document (and the `rdfs:comment` property is used to include them in the RDFS representations).

Overview diagram of the vocabulary (without the`xsd` datatypes). The terms prefixed by cred: or sec: are not defined in this vocabulary; they have only been added to the diagram for the sake of clarity.
A separate, stand-alone SVG version of the diagram, as well as a textual description, are also available.

Namespaces

This specification makes use of the following namespaces:

cs
https://www.w3.org/ns/credentials/status#
cred
https://w3.org/2018/credentials#
sec
https://w3id.org/security#
dc
http://purl.org/dc/terms/
owl
http://www.w3.org/2002/07/owl#
rdf
http://www.w3.org/1999/02/22-rdf-syntax-ns#
rdfs
http://www.w3.org/2000/01/rdf-schema#
xsd
http://www.w3.org/2001/XMLSchema#
vs
http://www.w3.org/2003/06/sw-vocab-status/ns#
schema
http://schema.org/
jsonld
http://www.w3.org/ns/json-ld#

@context files

The following @context files make use of the terms defined in this specification:

Regular terms

Property definitions

The following are property definitions in the cs namespace.

statusPurpose

Status purpose

See the formal definition of the term.

stable
Range:
xsd:string
Domain:
Union of:
BitstringStatusList
BitstringStatusListEntry
Relevant @context:
https://www.w3.org/ns/credentials/v2

statusListIndex

Status list index

See the formal definition of the term.

stable
Range:
xsd:string
Domain:
BitstringStatusListEntry
Relevant @context:
https://www.w3.org/ns/credentials/v2

statusListCredential

Status list credential

See the formal definition of the term.

stable
Range:
BitstringStatusListCredential
Domain:
BitstringStatusListEntry
Relevant @context:
https://www.w3.org/ns/credentials/v2

encodedList

Encoded list

See the formal definition of the term.

stable
Range:
sec:multibase
Domain:
BitstringStatusList
Relevant @context:
https://www.w3.org/ns/credentials/v2

ttl

Time to live in milliseconds

See the formal definition of the term.

stable
Range:
xsd:string
Domain:
BitstringStatusList
Relevant @context:
https://www.w3.org/ns/credentials/v2

statusSize

Bitstring entry size in bits

See the formal definition of the term.

stable
Range:
xsd:positiveInteger
Domain:
BitstringStatusList
Relevant @context:
https://www.w3.org/ns/credentials/v2

statusMessage

Status message

See the formal definition of the term.

stable
Range:
BitstringStatusMessage
Domain:
BitstringStatusList
Relevant @context:
https://www.w3.org/ns/credentials/v2

status

Hexadecimal value of a status message

See the formal definition of the term.

stable
Range:
xsd:string
Domain:
BitstringStatusMessage
Relevant @context:
https://www.w3.org/ns/credentials/v2

message

Human-readable message of a status value

See the formal definition of the term.

stable
Range:
xsd:string
Domain:
BitstringStatusMessage
Relevant @context:
https://www.w3.org/ns/credentials/v2

statusReference

Reference documentation for status messages

See the formal definition of the term.

The property's value should be a URL, i.e., not a literal.

stable
Domain:
BitstringStatusList
Relevant @context:
https://www.w3.org/ns/credentials/v2

Class definitions

The following are class definitions in the cs namespace.

BitstringStatusList

Bitstring status list

See the formal definition of the term.

stable
Domain of:
encodedList, ttl, statusSize, statusMessage, statusReference
In the domain of:
statusPurpose
Relevant @context:
https://www.w3.org/ns/credentials/v2

BitstringStatusListEntry

Bitstring status list entry

See the formal definition of the term.

stable
Subclass of:
cred:CredentialStatus
Domain of:
statusListIndex, statusListCredential
In the domain of:
statusPurpose
Relevant @context:
https://www.w3.org/ns/credentials/v2

BitstringStatusListCredential

Bitstring status list credential

See the formal definition of the term.

stable
Subclass of:
cred:VerifiableCredential
Range of:
statusListCredential
Relevant @context:
https://www.w3.org/ns/credentials/v2

BitstringStatusMessage

Bitstring status message

See the formal definition of the term.

stable
Range of:
statusMessage
Domain of:
status, message
Relevant @context:
https://www.w3.org/ns/credentials/v2

Diagram description

Overview diagram of the vocabulary (without the `xsd` datatypes). The terms prefixed by cred: or sec: are not defined in this vocabulary; they have only been added to the diagram for the sake of clarity.

The diagram uses boxes, ellipses, and connecting lines with different "styles" (border color, end marker, line type) to differentiate their semantic meaning: "Property", "Class", and "Datatype" are identified by the shape of the graph node (e.g., an ellipse signifies a "Class"); "Superclass", "Domain Of", or "Range" relationships are identified by the style of the connecting line. These style names are used in the explanation text that follows, below.

The diagram is roughly divided into three sections — left, middle, and right. To make this description easier to understand, these sections will be respectively referred to as the "Classes", "Properties", and "Values" sections. Shapes in the three sections are connected by lines of different styles.

Classes Section

The section contains three ellipses, labeled as "cred:CredentialStatus", "BitstringStatusListEntry", and "BitstringStatusList". It also contains a box, styled as "Property" and labeled as "cred:credentialStatus".

The "cred:CredentialStatus" ellipse, is connected to the ellipse, labeled as "cred:CredentialStatus", with a line styled "Range". The ellipse labeled as "BitstringStatusListEntry" is connected to the ellipse, labeled as "cred:CredentialStatus", with a line styled as "Superclass".

The ellipses labeled as "BitstringStatusListEntry" and "BitstringStatusList" are also connected to a number of boxes, all styled as "Property", with lines styled as "Domain Of"; see the "Properties" section below for further details.

Properties Section

The section contains a number of boxes, each styles as "Property". The labels of these boxes are "statusListIndex", "statusListCredential", "statusPurpose", "statusMessage", "ttl", "statusReference", "statusSize", and "encodedList". There is also a small, unlabeled circle, which serves as an intersection point for connector lines.

The ellipse labeled as "BitstringStatusListEntry", described in the previous section, is connected to the "statusListIndex", and "statusListCredential" boxes with lines styled as "Domain Of". The ellipse labeled as "BitstringStatusList", also described in the previous section, is connected to the "statusMessage", "ttl", "statusReference", "statusSize", and "encodedList" boxes, also with lines styled as "Domain Of".

Both the ellipses labeled as "BitstringStatusListEntry" and "BitstringStatusList" are connected to the intersection point with a line styled as "Domain Of", and the intersection point is connected to the box labeled as "statusPurpose with a line styled as "Domain Of".

Values Section

The section contains and ellipse, labeled as "BitstringStatusListCredential", which is connected to another ellipse, labeled as "cred:VerifiableCredential", with a line styled as "Superclass". The box labeled as "statusListCredential", described in the previous section, is connected to the ellipse, labeled as "BitstringStatusListCredential", with a line styled as "Range".

Another ellipse, labeled as "BistringStatusMessage", is connected to two boxes with lines styled as "Domain Of". The boxes are styled as "Property" and are labeled with "status" and "message". The box labeled as "statusMessage", described in the previous section, is connected to the ellipse, labeled as "BistringStatusMessage", with a line styled as "Range".

The box labeled as "statusSize", described in the previous section, is connected to a box, styled as "Datatype", and labeled as "xsd:positiveInteger", with a line styled as "Range".

The box labeled as "encodedList", described in the previous section, is connected to a box, styled as "Datatype", and labeled as "sec:multibase", with a line styled as "Range".