Skip to main content

OP VC Data Model

The OP specification defines several VCs that conform to a common data model based on the VC DM 2.0 Conforming Document, which is specified in this document.

VC Data Model​

It MUST conform to the VC DM 2.0 Conforming Document.

Properties​

@context​

REQUIRED. An ordered array of URLs. The array MUST start with https://www.w3.org/ns/credentials/v2, followed by https://originator-profile.org/ns/credentials/v1. The last element of the array SHOULD indicate the language of the string in VC with the @language tag. For example, if the language is Japanese, include {"@language": "ja"} at the end of the array.

type​

REQUIRED. The value MUST be a VerifiableCredential or an array of JSON-LD terms whose value contains a VerifiableCredential.

credentialSubject​

REQUIRED. JSON-LD Node Object

credentialSubject.type​

OPTIONAL. The value MUST be a term in the JSON-LD vocabulary or an array thereof.

credentialSubject.id​

REQUIRED. An identifier. The format of the identifier is specified in the data model document for each VC.

issuer​

REQUIRED. It MUST be the OP ID of the VC issuing organization.

Internationalization​

The language used in each VC can be identified by the @language tag specified in the @context property of the OP VC Data Model. Application implementers SHOULD use VCs written in the appropriate language for display, matching the application user's locale.

Implementation Notes

Application implementers must take the following considerations when the user's locale cannot be obtained, or when VCs matching the user's locale are unavailable:

  1. Fallback to VCs with the language code en.
  2. If VCs from step 1 are unavailable, fallback to any obtained VCs.

Verification Process​

A VC that conforms to the data model in this document can be verified by following these steps:

  1. Get the VC to be verified
  2. Get the verification key of the issuing organization of the VC to be verified by OP ID.
  3. Verify using the algorithms defined in Securing Mechanisms
  4. Verify properties that use The image Datatype
info

For information on the Securing Mechanisms used in applications developed by the Originator Profile Collaborative Innovation Partnership, see OP VC Securing Mechanism.