@sphereon/ssi-types 0.30.2-feature.mdoc.funke2.374 → 0.30.2-feature.mdoc.funke2.375

package/dist/types/index.d.ts

@@ -3,6 +3,7 @@ export * from './pex';
 export * from './vc';
 export * from './generic';
 export * from './sd-jwt-vc';
+export * from './sd-jwt-type-metadata';
 export * from './w3c-vc';
 export * from './jose';
 export * from './cose';

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,OAAO,CAAA;AACrB,cAAc,OAAO,CAAA;AACrB,cAAc,MAAM,CAAA;AACpB,cAAc,WAAW,CAAA;AACzB,cAAc,aAAa,CAAA;AAC3B,cAAc,UAAU,CAAA;AACxB,cAAc,QAAQ,CAAA;AACtB,cAAc,QAAQ,CAAA;AACtB,cAAc,YAAY,CAAA;AAC1B,cAAc,kBAAkB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,OAAO,CAAA;AACrB,cAAc,OAAO,CAAA;AACrB,cAAc,MAAM,CAAA;AACpB,cAAc,WAAW,CAAA;AACzB,cAAc,aAAa,CAAA;AAC3B,cAAc,wBAAwB,CAAA;AACtC,cAAc,UAAU,CAAA;AACxB,cAAc,QAAQ,CAAA;AACtB,cAAc,QAAQ,CAAA;AACtB,cAAc,YAAY,CAAA;AAC1B,cAAc,kBAAkB,CAAA"}

package/dist/types/index.js

@@ -19,6 +19,7 @@ __exportStar(require("./pex"), exports);
 __exportStar(require("./vc"), exports);
 __exportStar(require("./generic"), exports);
 __exportStar(require("./sd-jwt-vc"), exports);
+__exportStar(require("./sd-jwt-type-metadata"), exports);
 __exportStar(require("./w3c-vc"), exports);
 __exportStar(require("./jose"), exports);
 __exportStar(require("./cose"), exports);

package/dist/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wCAAqB;AACrB,wCAAqB;AACrB,uCAAoB;AACpB,4CAAyB;AACzB,8CAA2B;AAC3B,2CAAwB;AACxB,yCAAsB;AACtB,yCAAsB;AACtB,6CAA0B;AAC1B,mDAAgC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wCAAqB;AACrB,wCAAqB;AACrB,uCAAoB;AACpB,4CAAyB;AACzB,8CAA2B;AAC3B,yDAAsC;AACtC,2CAAwB;AACxB,yCAAsB;AACtB,yCAAsB;AACtB,6CAA0B;AAC1B,mDAAgC"}

package/dist/types/sd-jwt-type-metadata.d.ts

@@ -0,0 +1,147 @@
+import { AsyncHasher } from './sd-jwt-vc';
+/**
+ * Represents the metadata associated with a specific SD-JWT VC type.
+ */
+interface SdJwtTypeMetadata {
+    /**
+     * REQUIRED. The VC type URI.
+     */
+    vct: string;
+    /**
+     * OPTIONAL. A human-readable name for the type.
+     */
+    name?: string;
+    /**
+     * OPTIONAL. A human-readable description for the type.
+     */
+    description?: string;
+    /**
+     * OPTIONAL. A URI of another type that this type extends.
+     */
+    extends?: string;
+    /**
+     * OPTIONAL. Integrity metadata string for the 'extends' field.
+     */
+    ['extends#integrity']?: string;
+    /**
+     * OPTIONAL. URL pointing towards a JSON Schema document describing the VC's structure.
+     */
+    schema_uri?: string;
+    /**
+     * OPTIONAL. Integrity metadata string for the 'schema_uri' field.
+     */
+    ['schema_uri#integrity']?: string;
+    /**
+     * OPTIONAL. Display metadata for various languages.
+     */
+    display?: Array<SdJwtTypeDisplayMetadata>;
+    /**
+     * OPTIONAL. Metadata for the claims within the VC.
+     */
+    claims?: Array<any>;
+}
+/**
+ * Represents display metadata for a specific language.
+ */
+interface SdJwtTypeDisplayMetadata {
+    /**
+     * REQUIRED. Language tag for the display information.
+     */
+    lang: string;
+    /**
+     * REQUIRED. Human-readable name for the type.
+     */
+    name: string;
+    /**
+     * OPTIONAL. Human-readable description for the type.
+     */
+    description?: string;
+    /**
+     * OPTIONAL. Rendering metadata for the type.
+     */
+    rendering?: SdJwtTypeRenderingMetadata;
+}
+/**
+ * Contains rendering metadata for different methods.
+ */
+interface SdJwtTypeRenderingMetadata {
+    /**
+     * OPTIONAL. Simple rendering method metadata.
+     */
+    simple?: SdJwtSimpleRenderingMetadata;
+    /**
+     * OPTIONAL. Metadata for SVG templates.
+     */
+    svg_template?: Array<SdJwtSVGTemplateMetadata>;
+}
+/**
+ * Represents metadata for simple rendering.
+ */
+interface SdJwtSimpleRenderingMetadata {
+    /**
+     * OPTIONAL. Metadata for the logo image.
+     */
+    logo?: SdJwtLogoMetadata;
+    /**
+     * OPTIONAL. Background color for the credential.
+     */
+    background_color?: string;
+    /**
+     * OPTIONAL. Text color for the credential.
+     */
+    text_color?: string;
+}
+/**
+ * Represents metadata for a logo.
+ */
+interface SdJwtLogoMetadata {
+    /**
+     * REQUIRED. URI pointing to the logo image.
+     */
+    uri: string;
+    /**
+     * OPTIONAL. Integrity metadata string for the 'uri' field.
+     */
+    ['uri#integrity']?: string;
+    /**
+     * OPTIONAL. Alternative text for the logo image.
+     */
+    alt_text?: string;
+}
+/**
+ * Represents metadata for SVG templates.
+ */
+interface SdJwtSVGTemplateMetadata {
+    /**
+     * REQUIRED. URI pointing to the SVG template.
+     */
+    uri: string;
+    /**
+     * OPTIONAL. Integrity metadata string for the 'uri' field.
+     */
+    ['uri#integrity']?: string;
+    /**
+     * OPTIONAL. Properties for the SVG template.
+     */
+    properties?: SdJwtSVGTemplateProperties;
+}
+/**
+ * Contains properties for SVG templates.
+ */
+interface SdJwtSVGTemplateProperties {
+    /**
+     * OPTIONAL. The orientation for which the SVG template is optimized.
+     */
+    orientation?: string;
+    /**
+     * OPTIONAL. The color scheme for which the SVG template is optimized.
+     */
+    color_scheme?: string;
+}
+export type SdJwtTypeHasher = (input: any, alg?: string) => string;
+export declare function fetchSdJwtTypeMetadataFromVctUrl(vct: string, opts?: {
+    hasher?: AsyncHasher;
+    integrity?: string;
+}): Promise<SdJwtTypeMetadata>;
+export {};
+//# sourceMappingURL=sd-jwt-type-metadata.d.ts.map

package/dist/types/sd-jwt-type-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sd-jwt-type-metadata.d.ts","sourceRoot":"","sources":["../../src/types/sd-jwt-type-metadata.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAEzC;;GAEG;AACH,UAAU,iBAAiB;IACzB;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,CAAC,mBAAmB,CAAC,CAAC,EAAE,MAAM,CAAC;IAE/B;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,CAAC,sBAAsB,CAAC,CAAC,EAAE,MAAM,CAAC;IAElC;;OAEG;IACH,OAAO,CAAC,EAAE,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAE1C;;OAEG;IAEH,MAAM,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;CACrB;AAED;;GAEG;AACH,UAAU,wBAAwB;IAChC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,SAAS,CAAC,EAAE,0BAA0B,CAAC;CACxC;AAED;;GAEG;AACH,UAAU,0BAA0B;IAClC;;OAEG;IACH,MAAM,CAAC,EAAE,4BAA4B,CAAC;IAEtC;;OAEG;IACH,YAAY,CAAC,EAAE,KAAK,CAAC,wBAAwB,CAAC,CAAC;CAChD;AAED;;GAEG;AACH,UAAU,4BAA4B;IACpC;;OAEG;IACH,IAAI,CAAC,EAAE,iBAAiB,CAAC;IAEzB;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,UAAU,iBAAiB;IACzB;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,CAAC,eAAe,CAAC,CAAC,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,UAAU,wBAAwB;IAChC;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,CAAC,eAAe,CAAC,CAAC,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,UAAU,CAAC,EAAE,0BAA0B,CAAC;CACzC;AAED;;GAEG;AACH,UAAU,0BAA0B;IAClC;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAYD,MAAM,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,MAAM,CAAA;AAQlE,wBAAsB,gCAAgC,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,WAAW,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAanJ"}

package/dist/types/sd-jwt-type-metadata.js

@@ -0,0 +1,84 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchSdJwtTypeMetadataFromVctUrl = fetchSdJwtTypeMetadataFromVctUrl;
+const u8a = __importStar(require("uint8arrays"));
+// Helper function to fetch API with error handling
+function fetchUrlWithErrorHandling(url) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const response = yield fetch(url);
+        if (!response.ok) {
+            throw new Error(`${response.status}: ${response.statusText}`);
+        }
+        return response;
+    });
+}
+function validateIntegrity(input, integrityValue, hasher, alg) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const hash = yield hasher(input, alg !== null && alg !== void 0 ? alg : 'sha256');
+        return u8a.toString(hash, 'utf-8') === integrityValue;
+    });
+}
+// Fetch and validate Type Metadata
+function fetchSdJwtTypeMetadataFromVctUrl(vct, opts) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const url = new URL(vct);
+        const wellKnownUrl = `${url.origin}/.well-known/vct${url.pathname}`;
+        const response = yield fetchUrlWithErrorHandling(wellKnownUrl);
+        const metadata = yield response.json();
+        assertValidTypeMetadata(metadata, vct);
+        if ((opts === null || opts === void 0 ? void 0 : opts.integrity) && opts.hasher) {
+            if (!(yield validateIntegrity(metadata, opts.integrity, opts.hasher))) {
+                throw new Error('Integrity check failed');
+            }
+        }
+        return metadata;
+    });
+}
+function assertValidTypeMetadata(metadata, vct) {
+    if (metadata.vct !== vct) {
+        throw new Error('VCT mismatch in metadata and credential');
+    }
+}
+/*
+// Example usage
+  try {
+    const vct = 'https://betelgeuse.example.com/education_credential'
+    const typeMetadata = await fetchSdJwtTypeMetadataFromVctUrl(vct)
+    console.log('Type Metadata retrieved successfully:', typeMetadata)
+  } catch (error) {
+    console.error('Error fetching type metadata:', error.message)
+  }
+*/
+//# sourceMappingURL=sd-jwt-type-metadata.js.map

package/dist/types/sd-jwt-type-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sd-jwt-type-metadata.js","sourceRoot":"","sources":["../../src/types/sd-jwt-type-metadata.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2LA,4EAaC;AAxMD,iDAAkC;AA0KlC,mDAAmD;AACnD,SAAe,yBAAyB,CAAC,GAAW;;QAClD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAA;QACjC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,GAAG,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAA;QAC/D,CAAC;QACD,OAAO,QAAQ,CAAA;IACjB,CAAC;CAAA;AAID,SAAe,iBAAiB,CAAC,KAAU,EAAE,cAAsB,EAAE,MAAmB,EAAE,GAAY;;QACpG,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,KAAK,EAAE,GAAG,aAAH,GAAG,cAAH,GAAG,GAAI,QAAQ,CAAC,CAAA;QACjD,OAAO,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,cAAc,CAAA;IACvD,CAAC;CAAA;AAED,mCAAmC;AACnC,SAAsB,gCAAgC,CAAC,GAAW,EAAE,IAAmD;;QACrH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAA;QACxB,MAAM,YAAY,GAAG,GAAG,GAAG,CAAC,MAAM,mBAAmB,GAAG,CAAC,QAAQ,EAAE,CAAA;QAEnE,MAAM,QAAQ,GAAG,MAAM,yBAAyB,CAAC,YAAY,CAAC,CAAA;QAC9D,MAAM,QAAQ,GAAsB,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;QACzD,uBAAuB,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAA;QACtC,IAAI,CAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,SAAS,KAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACnC,IAAI,CAAC,CAAA,MAAM,iBAAiB,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA,EAAE,CAAC;gBACpE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAA;YAC3C,CAAC;QACH,CAAC;QACD,OAAO,QAAQ,CAAA;IACjB,CAAC;CAAA;AAED,SAAS,uBAAuB,CAAC,QAA2B,EAAE,GAAW;IACvE,IAAI,QAAQ,CAAC,GAAG,KAAK,GAAG,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAA;IAC5D,CAAC;AACH,CAAC;AAGD;;;;;;;;;EASE"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sphereon/ssi-types",
   "description": "SSI Common Types",
-  "version": "0.30.2-feature.mdoc.funke2.374+3b4c0e52",
+  "version": "0.30.2-feature.mdoc.funke2.375+025f6b57",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {
@@ -13,7 +13,8 @@
     "@sphereon/kmp-mdoc-core": "0.2.0-SNAPSHOT.14",
     "debug": "^4.3.5",
     "events": "^3.3.0",
-    "jwt-decode": "^3.1.2"
+    "jwt-decode": "^3.1.2",
+    "uint8arrays": "3.1.1"
   },
   "devDependencies": {
     "@types/jest": "^27.5.2",
@@ -46,5 +47,5 @@
     "DIDs"
   ],
   "nx": {},
-  "gitHead": "3b4c0e5211f2125ad874b87d3e80609553ce2517"
+  "gitHead": "025f6b5785263196a86760930746ce1c98691d1a"
 }

package/src/types/index.ts

@@ -3,6 +3,7 @@ export * from './pex'
 export * from './vc'
 export * from './generic'
 export * from './sd-jwt-vc'
+export * from './sd-jwt-type-metadata'
 export * from './w3c-vc'
 export * from './jose'
 export * from './cose'

package/src/types/sd-jwt-type-metadata.ts

@@ -0,0 +1,220 @@
+import * as u8a from 'uint8arrays'
+import { AsyncHasher } from './sd-jwt-vc'
+
+/**
+ * Represents the metadata associated with a specific SD-JWT VC type.
+ */
+interface SdJwtTypeMetadata {
+  /**
+   * REQUIRED. The VC type URI.
+   */
+  vct: string;
+
+  /**
+   * OPTIONAL. A human-readable name for the type.
+   */
+  name?: string;
+
+  /**
+   * OPTIONAL. A human-readable description for the type.
+   */
+  description?: string;
+
+  /**
+   * OPTIONAL. A URI of another type that this type extends.
+   */
+  extends?: string;
+
+  /**
+   * OPTIONAL. Integrity metadata string for the 'extends' field.
+   */
+  ['extends#integrity']?: string;
+
+  /**
+   * OPTIONAL. URL pointing towards a JSON Schema document describing the VC's structure.
+   */
+  schema_uri?: string;
+
+  /**
+   * OPTIONAL. Integrity metadata string for the 'schema_uri' field.
+   */
+  ['schema_uri#integrity']?: string;
+
+  /**
+   * OPTIONAL. Display metadata for various languages.
+   */
+  display?: Array<SdJwtTypeDisplayMetadata>;
+
+  /**
+   * OPTIONAL. Metadata for the claims within the VC.
+   */
+  // TODO:
+  claims?: Array<any>;
+}
+
+/**
+ * Represents display metadata for a specific language.
+ */
+interface SdJwtTypeDisplayMetadata {
+  /**
+   * REQUIRED. Language tag for the display information.
+   */
+  lang: string;
+
+  /**
+   * REQUIRED. Human-readable name for the type.
+   */
+  name: string;
+
+  /**
+   * OPTIONAL. Human-readable description for the type.
+   */
+  description?: string;
+
+  /**
+   * OPTIONAL. Rendering metadata for the type.
+   */
+  rendering?: SdJwtTypeRenderingMetadata;
+}
+
+/**
+ * Contains rendering metadata for different methods.
+ */
+interface SdJwtTypeRenderingMetadata {
+  /**
+   * OPTIONAL. Simple rendering method metadata.
+   */
+  simple?: SdJwtSimpleRenderingMetadata;
+
+  /**
+   * OPTIONAL. Metadata for SVG templates.
+   */
+  svg_template?: Array<SdJwtSVGTemplateMetadata>;
+}
+
+/**
+ * Represents metadata for simple rendering.
+ */
+interface SdJwtSimpleRenderingMetadata {
+  /**
+   * OPTIONAL. Metadata for the logo image.
+   */
+  logo?: SdJwtLogoMetadata;
+
+  /**
+   * OPTIONAL. Background color for the credential.
+   */
+  background_color?: string;
+
+  /**
+   * OPTIONAL. Text color for the credential.
+   */
+  text_color?: string;
+}
+
+/**
+ * Represents metadata for a logo.
+ */
+interface SdJwtLogoMetadata {
+  /**
+   * REQUIRED. URI pointing to the logo image.
+   */
+  uri: string;
+
+  /**
+   * OPTIONAL. Integrity metadata string for the 'uri' field.
+   */
+  ['uri#integrity']?: string;
+
+  /**
+   * OPTIONAL. Alternative text for the logo image.
+   */
+  alt_text?: string;
+}
+
+/**
+ * Represents metadata for SVG templates.
+ */
+interface SdJwtSVGTemplateMetadata {
+  /**
+   * REQUIRED. URI pointing to the SVG template.
+   */
+  uri: string;
+
+  /**
+   * OPTIONAL. Integrity metadata string for the 'uri' field.
+   */
+  ['uri#integrity']?: string;
+
+  /**
+   * OPTIONAL. Properties for the SVG template.
+   */
+  properties?: SdJwtSVGTemplateProperties;
+}
+
+/**
+ * Contains properties for SVG templates.
+ */
+interface SdJwtSVGTemplateProperties {
+  /**
+   * OPTIONAL. The orientation for which the SVG template is optimized.
+   */
+  orientation?: string;
+
+  /**
+   * OPTIONAL. The color scheme for which the SVG template is optimized.
+   */
+  color_scheme?: string;
+}
+
+
+// Helper function to fetch API with error handling
+async function fetchUrlWithErrorHandling(url: string): Promise<Response> {
+  const response = await fetch(url)
+  if (!response.ok) {
+    throw new Error(`${response.status}: ${response.statusText}`)
+  }
+  return response
+}
+
+export type SdJwtTypeHasher = (input: any, alg?: string) => string
+
+async function validateIntegrity(input: any, integrityValue: string, hasher: AsyncHasher, alg?: string): Promise<boolean> {
+  const hash = await hasher(input, alg ?? 'sha256')
+  return u8a.toString(hash, 'utf-8') === integrityValue
+}
+
+// Fetch and validate Type Metadata
+export async function fetchSdJwtTypeMetadataFromVctUrl(vct: string, opts?: { hasher?: AsyncHasher, integrity?: string }): Promise<SdJwtTypeMetadata> {
+  const url = new URL(vct)
+  const wellKnownUrl = `${url.origin}/.well-known/vct${url.pathname}`
+
+  const response = await fetchUrlWithErrorHandling(wellKnownUrl)
+  const metadata: SdJwtTypeMetadata = await response.json()
+  assertValidTypeMetadata(metadata, vct)
+  if (opts?.integrity && opts.hasher) {
+    if (!await validateIntegrity(metadata, opts.integrity, opts.hasher)) {
+      throw new Error('Integrity check failed')
+    }
+  }
+  return metadata
+}
+
+function assertValidTypeMetadata(metadata: SdJwtTypeMetadata, vct: string): void {
+  if (metadata.vct !== vct) {
+    throw new Error('VCT mismatch in metadata and credential')
+  }
+}
+
+
+/*
+// Example usage
+  try {
+    const vct = 'https://betelgeuse.example.com/education_credential'
+    const typeMetadata = await fetchSdJwtTypeMetadataFromVctUrl(vct)
+    console.log('Type Metadata retrieved successfully:', typeMetadata)
+  } catch (error) {
+    console.error('Error fetching type metadata:', error.message)
+  }
+*/
+