@europeum-ebsi/vcdm2.0-trust-model-schema

EBSI Verifiable Trust Model

Base schema to manage trust model

The schema is published to the Trusted Schemas Registry with the IDs:

• 0x281b019ab5fdd82338047e4eb495059cf6e54ec67da6aeb208cdfee36f741709 (hexadecimal)
• z3hZCACZvpwLH1k8t9hq4XnpSpS2mbpD7UreZz7LFLkQG (multibase base58btc)

Table of Contents

• JSON Schema
• Installation
• Usage
• License

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "EBSI Verifiable Trust Model",
  "description": "Base schema to manage trust model",
  "type": "object",
  "allOf": [
    {
      "$ref": "./node_modules/@europeum-ebsi/vcdm2.0-attestation-schema/schema.json"
    },
    {
      "properties": {
        "type": {
          "description": "Defines the Verifiable Credential type. MUST contain VerifiableTrustModel",
          "type": "array",
          "contains": {
            "type": "string",
            "const": "VerifiableTrustModel"
          }
        },
        "credentialSubject": {
          "description": "Defines additional information about the subject that is described by the Verifiable Accreditation",
          "type": "object",
          "properties": {
            "id": {
              "description": "Defines the DID of the subject that is described by the issued credential",
              "type": "string",
              "format": "uri"
            },
            "reservedAttributeId": {
              "description": "Defines the Trusted Issuers Registry attributeId this Verifiable Accreditation has been reserved for",
              "type": "string"
            },
            "permissionFor": {
              "description": "Defines a list of claims that define/determine the authorisation of an subject to issue or accredit certain types of VCs",
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "schemaId": {
                    "description": "Schema, registered in Trusted Schemas Registry, which the accredited organisation is allowed to issue or accredit",
                    "type": "string",
                    "format": "uri"
                  },
                  "types": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "jurisdiction": {
                    "anyOf": [
                      {
                        "description": "Defines the jurisdiction for which the accreditation is valid",
                        "type": "string",
                        "format": "uri"
                      },
                      {
                        "type": "array",
                        "description": "Defines the jurisdictions for which the accreditation is valid",
                        "items": {
                          "type": "string",
                          "format": "uri"
                        }
                      }
                    ]
                  }
                },
                "required": ["schemaId", "types", "jurisdiction"]
              }
            }
          },
          "required": ["id", "reservedAttributeId", "permissionFor"]
        },
        "credentialStatus": {
          "description": "Defines revocation details for the issued credential. Further redefined by type extension",
          "type": "object",
          "properties": {
            "id": {
              "description": "Credential status in Trusted Issuers Registry, pointing towards Subject DID and the reservedAttributeId",
              "type": "string",
              "format": "uri"
            },
            "type": {
              "description": "Defines the revocation status type",
              "type": "string",
              "const": "EbsiAccreditationEntry"
            }
          },
          "required": ["id", "type"]
        }
      },
      "required": ["validUntil", "credentialSubject", "credentialStatus"]
    },
    {
      "oneOf": [
        {
          "$ref": "#/$defs/VerifiableAuthorisationForTrustChain"
        },
        {
          "$ref": "#/$defs/VerifiableAccreditationToAccredit"
        },
        {
          "$ref": "#/$defs/VerifiableAccreditationToAttest"
        }
      ]
    }
  ],
  "$defs": {
    "trustFrameworkPolicy": {
      "description": "Defines Trust Framework Policy under which the Verifiable Credential has been issued",
      "type": "object",
      "properties": {
        "type": {
          "type": "string",
          "description": "Type of the TermsOfUse entry. It MUST be TrustFrameworkPolicy. Other types may be added in the future",
          "const": "TrustFrameworkPolicy"
        },
        "trustFramework": {
          "type": "string",
          "description": "Name of the Trust Framework (TF)"
        },
        "policyId": {
          "type": "string",
          "description": "URI identifying the policy under which the Trust Framework operates or Verifiable Accreditation has been Issued in",
          "format": "uri"
        },
        "legalBasis": {
          "type": "string",
          "description": "Legal basis for the tf, is a string as 'professional qualifications directive'"
        }
      },
      "required": ["type", "trustFramework", "policyId"]
    },
    "accreditationPolicy": {
      "description": "Defines the Accreditation Policy under which the Verifiable Credential has been issued",
      "type": "object",
      "properties": {
        "type": {
          "type": "string",
          "description": "Type of the TermsOfUse entry. It MUST be AccreditationPolicy",
          "const": "AccreditationPolicy"
        },
        "parentAccreditation": {
          "type": "string",
          "description": "URL to access the parent entity in the trust chain supporting the attestation",
          "format": "uri"
        },
        "rootAuthorisation": {
          "type": "string",
          "description": "URL to access the root entity in the trust chain supporting the attestation",
          "format": "uri"
        }
      },
      "required": ["type", "parentAccreditation", "rootAuthorisation"]
    },
    "VerifiableAuthorisationForTrustChain": {
      "properties": {
        "type": {
          "description": "Defines the Verifiable Credential type. MUST contain VerifiableAuthorisationForTrustChain",
          "type": "array",
          "contains": {
            "type": "string",
            "const": "VerifiableAuthorisationForTrustChain"
          }
        },
        "termsOfUse": {
          "anyOf": [
            {
              "$ref": "#/$defs/trustFrameworkPolicy"
            },
            {
              "type": "array",
              "items": {
                "$ref": "#/$defs/trustFrameworkPolicy"
              }
            }
          ]
        }
      },
      "required": ["termsOfUse"]
    },
    "VerifiableAccreditationToAccredit": {
      "properties": {
        "type": {
          "description": "Defines the Verifiable Credential type. MUST contain VerifiableAccreditationToAccredit",
          "type": "array",
          "contains": {
            "type": "string",
            "const": "VerifiableAccreditationToAccredit"
          }
        },
        "termsOfUse": {
          "anyOf": [
            {
              "$ref": "#/$defs/accreditationPolicy"
            },
            {
              "type": "array",
              "items": {
                "$ref": "#/$defs/accreditationPolicy"
              }
            }
          ]
        }
      },
      "required": ["termsOfUse"]
    },
    "VerifiableAccreditationToAttest": {
      "properties": {
        "type": {
          "description": "Defines the Verifiable Credential type. MUST contain VerifiableAccreditationToAttest",
          "type": "array",
          "contains": {
            "type": "string",
            "const": "VerifiableAccreditationToAttest"
          }
        },
        "termsOfUse": {
          "anyOf": [
            {
              "$ref": "#/$defs/accreditationPolicy"
            },
            {
              "type": "array",
              "items": {
                "$ref": "#/$defs/accreditationPolicy"
              }
            }
          ]
        }
      },
      "required": ["termsOfUse"]
    }
  }
}

Installation

# with npm
npm add @europeum-ebsi/[email protected]

# with Yarn
yarn add @europeum-ebsi/[email protected]

# with pnpm
pnpm add @europeum-ebsi/[email protected]

Usage

The package exports the schema and its metadata as JavaScript objects:

import { schema, metadata } from "@europeum-ebsi/vcdm2.0-trust-model-schema";

// you can now use the schema and metadata

In addition, the package exports a TypeScript type corresponding to the schema:

import type { EBSIVerifiableTrustModel } from "@europeum-ebsi/vcdm2.0-trust-model-schema";

License

Copyright (C) 2026 European Union

This program is free software: you can redistribute it and/or modify it under the terms of the EUROPEAN UNION PUBLIC LICENCE v. 1.2 as published by the European Union.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the EUROPEAN UNION PUBLIC LICENCE v. 1.2 for further details.

You should have received a copy of the EUROPEAN UNION PUBLIC LICENCE v. 1.2. along with this program. If not, see https://joinup.ec.europa.eu/collection/eupl/eupl-text-eupl-12.