@matter/protocol 0.15.0-alpha.0-20250619-df2264f15 → 0.15.0-alpha.0-20250624-e8c89f458

package/dist/esm/dcl/DclClient.js

@@ -0,0 +1,99 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { MatterError } from "#general";
+const DCL_PRODUCTION_URL = "https://on.dcl.csa-iot.org";
+const DCL_TEST_URL = "https://on.test-net.dcl.csa-iot.org";
+class MatterDclError extends MatterError {
+}
+class MatterDclResponseError extends MatterDclError {
+  constructor(path, error) {
+    super(`Error fetching ${path} from DCL: ${error.code} - ${error.message}`);
+  }
+}
+class DclClient {
+  constructor(production = true) {
+    this.production = production;
+    this.#baseUrl = this.production ? DCL_PRODUCTION_URL : DCL_TEST_URL;
+  }
+  #baseUrl;
+  async #fetchJson(path) {
+    const url = new URL(path, this.#baseUrl);
+    try {
+      const response = await fetch(url.toString(), {
+        method: "GET",
+        headers: {
+          "Content-Type": "application/json"
+        },
+        signal: AbortSignal.timeout(5e3)
+        // 5 seconds timeout
+      });
+      if (!response.ok) {
+        throw new MatterDclResponseError(path, await response.json());
+      }
+      return await response.json();
+    } catch (error) {
+      if (error instanceof MatterDclResponseError) {
+        throw error;
+      }
+      throw new MatterDclResponseError(path, {
+        code: 500,
+        message: error instanceof Error ? error.message : "Unknown Error",
+        details: []
+      });
+    }
+  }
+  async fetchRootCertificateList() {
+    const certList = await this.#fetchJson("/certificates/approved");
+    if (certList?.approvedRootCertificates?.schemaVersion !== 0) {
+      throw new MatterDclError(
+        `Unsupported DCL Root Certificate schema version: ${certList.approvedRootCertificates.schemaVersion}`
+      );
+    }
+    return certList.approvedRootCertificates.certs;
+  }
+  async fetchRootCertificateBySubject(subject) {
+    const path = `/certificates/${encodeURIComponent(subject.subject)}/${encodeURIComponent(subject.subjectKeyId)}`;
+    const response = await this.#fetchJson(path);
+    if (!response || !response.approvedRootCertificates || response.approvedRootCertificates.subject !== subject.subject || response.approvedRootCertificates.subjectKeyId !== subject.subjectKeyId || response.approvedRootCertificates.schemaVersion !== 0) {
+      throw new MatterDclError(
+        `Root certificate not found for subject: ${subject.subject}, subjectKeyId: ${subject.subjectKeyId}`
+      );
+    }
+    return response.approvedRootCertificates.certs;
+  }
+  async fetchModelByVidPid(vid, pid) {
+    const path = `/models/model/${encodeURIComponent(vid)}/${encodeURIComponent(pid)}`;
+    const response = await this.#fetchJson(path);
+    if (!response || !response.model || response.model.vid !== vid || response.model.pid !== pid || response.model.schemaVersion !== 0) {
+      throw new MatterDclError(`Model not found for VID: ${vid}, PID: ${pid}`);
+    }
+    return response.model;
+  }
+  async fetchModelVersionsByVidPid(vid, pid) {
+    const path = `/models/versions/${encodeURIComponent(vid)}/${encodeURIComponent(pid)}`;
+    const response = await this.#fetchJson(path);
+    if (!response || !response.modelVersions || response.modelVersions.vid !== vid || response.modelVersions.pid !== pid || response.modelVersions.schemaVersion !== 0) {
+      throw new MatterDclError(`Model versions not found for VID: ${vid}, PID: ${pid}`);
+    }
+    return response.modelVersions.softwareVersions;
+  }
+  async fetchModelVersionByVidPidSoftwareVersion(vid, pid, softwareVersion) {
+    const path = `/models/versions/${encodeURIComponent(vid)}/${encodeURIComponent(pid)}/${encodeURIComponent(softwareVersion)}`;
+    const response = await this.#fetchJson(path);
+    if (!response || !response.modelVersion || response.modelVersion.vid !== vid || response.modelVersion.pid !== pid || response.modelVersion.softwareVersion !== softwareVersion || response.modelVersion.schemaVersion !== 0) {
+      throw new MatterDclError(
+        `Model version not found for VID: ${vid}, PID: ${pid}, Software Version: ${softwareVersion}`
+      );
+    }
+    return response.modelVersion;
+  }
+}
+export {
+  DclClient,
+  MatterDclError,
+  MatterDclResponseError
+};
+//# sourceMappingURL=DclClient.js.map

package/dist/esm/dcl/DclClient.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/dcl/DclClient.ts"],
+  "mappings": "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",
+  "names": []
+}

package/dist/esm/dcl/DclRestApiTypes.d.ts

@@ -0,0 +1,49 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { DeviceModelDclSchema, DeviceSoftwareVersionModelDclSchema, ProductAttestationDclSchema } from "@matter/types";
+export interface DclApiErrorResponse {
+    code: number;
+    message: string;
+    details: string[];
+}
+export interface DclPkiRootCertificateSubjectReference {
+    subject: string;
+    subjectKeyId: string;
+}
+/** Response for /dcl/pki/certificates/approved */
+export interface DclPkiRootCertificatesResponse {
+    approvedRootCertificates: {
+        certs: DclPkiRootCertificateSubjectReference[];
+        schemaVersion: number;
+    };
+}
+/** Response for /dcl/pki/certificates/{subject}/{subjectKeyId} */
+export interface DclPkiCertificateResponse {
+    approvedRootCertificates: {
+        subject: string;
+        subjectKeyId: string;
+        certs: ProductAttestationDclSchema[];
+        schemaVersion: number;
+    };
+}
+/** Response for /dcl/models/model/{vid}/{pid} */
+export interface DclModelModelsWithVidPidResponse {
+    model: DeviceModelDclSchema;
+}
+/** Response for /dcl/model/versions/{vid}/{pid} */
+export interface DclModelVersionsWithVidPidResponse {
+    modelVersions: {
+        vid: number;
+        pid: number;
+        softwareVersions: number[];
+        schemaVersion: number;
+    };
+}
+/** Response for /dcl/model/versions/{vid}/{pid}/{softwareVersion} */
+export interface DclModelVersionWithVidPidSoftwareVersionResponse {
+    modelVersion: DeviceSoftwareVersionModelDclSchema;
+}
+//# sourceMappingURL=DclRestApiTypes.d.ts.map

package/dist/esm/dcl/DclRestApiTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DclRestApiTypes.d.ts","sourceRoot":"","sources":["../../../src/dcl/DclRestApiTypes.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,oBAAoB,EAAE,mCAAmC,EAAE,2BAA2B,EAAE,MAAM,eAAe,CAAC;AAEvH,MAAM,WAAW,mBAAmB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,qCAAqC;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;CACxB;AAED,kDAAkD;AAClD,MAAM,WAAW,8BAA8B;IAC3C,wBAAwB,EAAE;QACtB,KAAK,EAAE,qCAAqC,EAAE,CAAC;QAC/C,aAAa,EAAE,MAAM,CAAC;KACzB,CAAC;CACL;AAED,kEAAkE;AAClE,MAAM,WAAW,yBAAyB;IACtC,wBAAwB,EAAE;QACtB,OAAO,EAAE,MAAM,CAAC;QAChB,YAAY,EAAE,MAAM,CAAC;QACrB,KAAK,EAAE,2BAA2B,EAAE,CAAC;QACrC,aAAa,EAAE,MAAM,CAAC;KACzB,CAAC;CACL;AAED,iDAAiD;AACjD,MAAM,WAAW,gCAAgC;IAC7C,KAAK,EAAE,oBAAoB,CAAC;CAC/B;AAED,mDAAmD;AACnD,MAAM,WAAW,kCAAkC;IAC/C,aAAa,EAAE;QACX,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,EAAE,MAAM,CAAC;QACZ,gBAAgB,EAAE,MAAM,EAAE,CAAC;QAC3B,aAAa,EAAE,MAAM,CAAC;KACzB,CAAC;CACL;AAED,qEAAqE;AACrE,MAAM,WAAW,gDAAgD;IAC7D,YAAY,EAAE,mCAAmC,CAAC;CACrD"}

package/dist/esm/dcl/DclRestApiTypes.js

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+//# sourceMappingURL=DclRestApiTypes.js.map

package/dist/esm/dcl/DclRestApiTypes.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/dcl/DclRestApiTypes.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;",
+  "names": []
+}

package/dist/esm/dcl/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export * from "./DclClient.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/dcl/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/dcl/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,gBAAgB,CAAC"}

package/dist/esm/dcl/index.js

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export * from "./DclClient.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/dcl/index.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/dcl/index.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,cAAc;",
+  "names": []
+}

package/dist/esm/fabric/TestFabric.d.ts

@@ -1,6 +1,6 @@
 /**
  * @license
- * Copyright 2022-2025 Project CHIP Authors
+ * Copyright 2022-2025 Matter.js Authors
  * SPDX-License-Identifier: Apache-2.0
  */
 import { FabricAuthority } from "./FabricAuthority.js";

package/dist/esm/fabric/TestFabric.js

@@ -1,6 +1,6 @@
 /**
  * @license
- * Copyright 2022-2025 Project CHIP Authors
+ * Copyright 2022-2025 Matter.js Authors
  * SPDX-License-Identifier: Apache-2.0
  */
 import { CertificateAuthority } from "#certificate/CertificateAuthority.js";

package/dist/esm/index.d.ts

@@ -9,6 +9,7 @@ export * from "./certificate/index.js";
 export * from "./cluster/index.js";
 export * from "./codec/index.js";
 export * from "./common/index.js";
+export * from "./dcl/index.js";
 export * from "./events/index.js";
 export * from "./fabric/index.js";
 export * from "./groups/index.js";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC"}

package/dist/esm/index.js

@@ -9,6 +9,7 @@ export * from "./certificate/index.js";
 export * from "./cluster/index.js";
 export * from "./codec/index.js";
 export * from "./common/index.js";
+export * from "./dcl/index.js";
 export * from "./events/index.js";
 export * from "./fabric/index.js";
 export * from "./groups/index.js";

package/dist/esm/index.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../src/index.ts"],
-  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;",
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;",
   "names": []
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@matter/protocol",
-    "version": "0.15.0-alpha.0-20250619-df2264f15",
+    "version": "0.15.0-alpha.0-20250624-e8c89f458",
     "description": "Low-level APIs for Matter interaction",
     "keywords": [
         "iot",
@@ -40,13 +40,13 @@
         "#*": "./src/*"
     },
     "dependencies": {
-        "@matter/general": "0.15.0-alpha.0-20250619-df2264f15",
-        "@matter/model": "0.15.0-alpha.0-20250619-df2264f15",
-        "@matter/types": "0.15.0-alpha.0-20250619-df2264f15"
+        "@matter/general": "0.15.0-alpha.0-20250624-e8c89f458",
+        "@matter/model": "0.15.0-alpha.0-20250624-e8c89f458",
+        "@matter/types": "0.15.0-alpha.0-20250624-e8c89f458"
     },
     "devDependencies": {
-        "@matter/tools": "0.15.0-alpha.0-20250619-df2264f15",
-        "@matter/testing": "0.15.0-alpha.0-20250619-df2264f15"
+        "@matter/tools": "0.15.0-alpha.0-20250624-e8c89f458",
+        "@matter/testing": "0.15.0-alpha.0-20250624-e8c89f458"
     },
     "files": [
         "dist/**/*",

package/src/action/client/index.ts

@@ -1,6 +1,6 @@
 /**
  * @license
- * Copyright 2022-2025 Project CHIP Authors
+ * Copyright 2022-2025 Matter.js Authors
  * SPDX-License-Identifier: Apache-2.0
  */
 

package/src/action/errors.ts

@@ -80,6 +80,15 @@ export class ConstraintError extends ValidateError {
     }
 }
 
+/**
+ * Thrown when an enum value is not known based on Matter specification
+ */
+export class UnknownEnumValueError extends ValidateError {
+    constructor(path: SchemaErrorPath, message: string) {
+        super(path, message, StatusCode.ConstraintError);
+    }
+}
+
 /**
  * Thrown when conformance is violated.
  */
@@ -91,7 +100,16 @@ export class ConformanceError extends ValidateError {
         } else {
             prefix = `Conformance "${(schema as ValueModel).conformance}"`;
         }
-        super(path, `${prefix}: ${message}`, StatusCode.InvalidAction);
+        super(path, `${prefix}: ${message}`, StatusCode.ConstraintError);
+    }
+}
+
+/**
+ * Thrown when an enum value is not valid based on conformance definitions
+ */
+export class EnumValueConformanceError extends ConformanceError {
+    constructor(schema: Schema, path: SchemaErrorPath, message: string) {
+        super(schema, path, message);
     }
 }
 

package/src/action/protocols.ts

@@ -1,6 +1,6 @@
 /**
  * @license
- * Copyright 2022-2025 Project CHIP Authors
+ * Copyright 2022-2025 Matter.js Authors
  * SPDX-License-Identifier: Apache-2.0
  */
 

package/src/action/server/AttributeReadResponse.ts

@@ -1,6 +1,6 @@
 /**
  * @license
- * Copyright 2022-2025 Project CHIP Authors
+ * Copyright 2022-2025 Matter.js Authors
  * SPDX-License-Identifier: Apache-2.0
  */
 

package/src/action/server/AttributeSubscriptionResponse.ts

@@ -1,6 +1,6 @@
 /**
  * @license
- * Copyright 2022-2025 Project CHIP Authors
+ * Copyright 2022-2025 Matter.js Authors
  * SPDX-License-Identifier: Apache-2.0
  */
 import { InteractionSession } from "#action/index.js";

package/src/action/server/AttributeWriteResponse.ts

@@ -1,6 +1,6 @@
 /**
  * @license
- * Copyright 2022-2025 Project CHIP Authors
+ * Copyright 2022-2025 Matter.js Authors
  * SPDX-License-Identifier: Apache-2.0
  */
 

package/src/action/server/CommandInvokeResponse.ts

@@ -1,6 +1,6 @@
 /**
  * @license
- * Copyright 2022-2025 Project CHIP Authors
+ * Copyright 2022-2025 Matter.js Authors
  * SPDX-License-Identifier: Apache-2.0
  */
 

package/src/action/server/DataResponse.ts

@@ -1,6 +1,6 @@
 /**
  * @license
- * Copyright 2022-2025 Project CHIP Authors
+ * Copyright 2022-2025 Matter.js Authors
  * SPDX-License-Identifier: Apache-2.0
  */
 import { InteractionSession } from "#action/Interactable.js";

package/src/action/server/EventReadResponse.ts

@@ -1,6 +1,6 @@
 /**
  * @license
- * Copyright 2022-2025 Project CHIP Authors
+ * Copyright 2022-2025 Matter.js Authors
  * SPDX-License-Identifier: Apache-2.0
  */
 

package/src/action/server/ServerInteraction.ts

@@ -1,6 +1,6 @@
 /**
  * @license
- * Copyright 2022-2025 Project CHIP Authors
+ * Copyright 2022-2025 Matter.js Authors
  * SPDX-License-Identifier: Apache-2.0
  */
 

package/src/action/server/index.ts

@@ -1,6 +1,6 @@
 /**
  * @license
- * Copyright 2022-2025 Project CHIP Authors
+ * Copyright 2022-2025 Matter.js Authors
  * SPDX-License-Identifier: Apache-2.0
  */
 

package/src/certificate/kinds/X509Base.ts

@@ -340,34 +340,70 @@ export abstract class X509Base<CT extends X509Certificate> {
     /**
      * Extract the public key from a Certificate Signing Request (CSR) in ASN.1 DER format.
      */
-    static async getPublicKeyFromCsr(crypto: Crypto, csr: Uint8Array) {
-        const { [DerKey.Elements]: rootElements } = DerCodec.decode(csr);
-        if (rootElements?.length !== 3) throw new CertificateError("Invalid CSR data");
+    static async getPublicKeyFromCsr(crypto: Crypto, encodedCsr: Uint8Array) {
+        const { [DerKey.Elements]: rootElements } = DerCodec.decode(encodedCsr);
+        if (rootElements?.length !== 3) {
+            throw new CertificateError("Invalid CSR data");
+        }
         const [requestNode, signAlgorithmNode, signatureNode] = rootElements;
 
         // Extract the public key
         const { [DerKey.Elements]: requestElements } = requestNode;
-        if (requestElements?.length !== 4) throw new CertificateError("Invalid CSR data");
-        const [versionNode, _subjectNode, publicKeyNode] = requestElements;
-        const requestVersion = versionNode[DerKey.Bytes][0];
-        if (requestVersion !== 0) throw new CertificateError(`Unsupported request version ${requestVersion}`);
-        // TODO: verify subject = { OrganisationName: "CSR" }
+        if (requestElements?.length !== 4) {
+            throw new CertificateError("Invalid CSR data");
+        }
+        const [versionNode, subjectNode, publicKeyNode] = requestElements;
+        const requestVersionBytes = versionNode[DerKey.Bytes];
+        if (requestVersionBytes.length !== 1 || requestVersionBytes[0] !== 0) {
+            throw new CertificateError(`Unsupported CSR version ${requestVersionBytes[0]}`);
+        }
+
+        // Verify the subject, according to spec can be "any value", so just check that it exists
+        if (!subjectNode[DerKey.Elements]?.length) {
+            throw new CertificateError("Missing subject in CSR data");
+        }
 
         const { [DerKey.Elements]: publicKeyElements } = publicKeyNode;
-        if (publicKeyElements?.length !== 2) throw new CertificateError("Invalid CSR data");
-        const [_publicKeyTypeNode, publicKeyBytesNode] = publicKeyElements;
-        // TODO: verify publicKey algorithm
-        const publicKey = publicKeyBytesNode[DerKey.Bytes];
+        if (publicKeyElements?.length !== 2) {
+            throw new CertificateError("Invalid CSR data");
+        }
+        const [publicKeyTypeNode, publicKeyBytesNode] = publicKeyElements;
 
-        // Verify the CSR signature
+        // Verify Public Key Algorithm Type
+        const { [DerKey.Elements]: publicKeyTypeNodeElements } = publicKeyTypeNode;
+        if (publicKeyTypeNodeElements?.length !== 2) {
+            throw new CertificateError("Invalid public key type in CSR");
+        }
         if (
-            signAlgorithmNode[DerKey.Elements]?.[0]?.[DerKey.Bytes] === undefined ||
             !Bytes.areEqual(
-                X962.EcdsaWithSHA256[DerKey.ObjectId][DerKey.Bytes],
-                signAlgorithmNode[DerKey.Elements]?.[0]?.[DerKey.Bytes],
+                publicKeyTypeNodeElements[0][DerKey.Bytes],
+                X962.PublicKeyAlgorithmEcPublicKey[DerKey.Bytes],
             )
-        )
-            throw new CertificateError("Unsupported signature type");
+        ) {
+            throw new CertificateError("Unsupported public key algorithm in CSR");
+        }
+        // Verify Public Key Curve Type (Parameter to Algorithm)
+        if (
+            !Bytes.areEqual(
+                publicKeyTypeNodeElements[1][DerKey.Bytes],
+                X962.PublicKeyAlgorithmEcPublicKeyP256[DerKey.Bytes],
+            )
+        ) {
+            throw new CertificateError("Unsupported public key curve in CSR");
+        }
+
+        const publicKey = publicKeyBytesNode[DerKey.Bytes];
+
+        // Verify the CSR signature algorithm
+        const signatureAlgorithmBytes = signAlgorithmNode[DerKey.Elements]?.[0]?.[DerKey.Bytes];
+        if (
+            signatureAlgorithmBytes === undefined ||
+            !Bytes.areEqual(X962.EcdsaWithSHA256[DerKey.ObjectId][DerKey.Bytes], signatureAlgorithmBytes)
+        ) {
+            throw new CertificateError("Unsupported signature algorithm in CSR");
+        }
+
+        // Verify the CSR signature
         await crypto.verifyEcdsa(
             PublicKey(publicKey),
             DerCodec.encode(requestNode),

package/src/dcl/DclClient.ts

@@ -0,0 +1,140 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import {
+    DclApiErrorResponse,
+    DclModelModelsWithVidPidResponse,
+    DclModelVersionsWithVidPidResponse,
+    DclModelVersionWithVidPidSoftwareVersionResponse,
+    DclPkiCertificateResponse,
+    DclPkiRootCertificatesResponse,
+    DclPkiRootCertificateSubjectReference,
+} from "#dcl/DclRestApiTypes.js";
+import { MatterError } from "#general";
+
+const DCL_PRODUCTION_URL = "https://on.dcl.csa-iot.org";
+const DCL_TEST_URL = "https://on.test-net.dcl.csa-iot.org";
+
+/** Base class for all DCL-related errors */
+export class MatterDclError extends MatterError {}
+
+/** Error thrown when fetching data from DCL fails */
+export class MatterDclResponseError extends MatterDclError {
+    constructor(path: string, error: DclApiErrorResponse) {
+        super(`Error fetching ${path} from DCL: ${error.code} - ${error.message}`);
+    }
+}
+
+/** A client clas to use "fetch" to get REST DAta from DCL (Decentraland) */
+export class DclClient {
+    #baseUrl: string;
+
+    constructor(private readonly production: boolean = true) {
+        this.#baseUrl = this.production ? DCL_PRODUCTION_URL : DCL_TEST_URL;
+    }
+
+    async #fetchJson<ResponseT>(path: string): Promise<ResponseT> {
+        const url = new URL(path, this.#baseUrl);
+        try {
+            const response = await fetch(url.toString(), {
+                method: "GET",
+                headers: {
+                    "Content-Type": "application/json",
+                },
+                signal: AbortSignal.timeout(5_000), // 5 seconds timeout
+            });
+
+            if (!response.ok) {
+                throw new MatterDclResponseError(path, await response.json());
+            }
+
+            return await response.json();
+        } catch (error) {
+            if (error instanceof MatterDclResponseError) {
+                throw error; // Re-throw custom DCL error
+            }
+            throw new MatterDclResponseError(path, {
+                code: 500,
+                message: error instanceof Error ? error.message : "Unknown Error",
+                details: [],
+            });
+        }
+    }
+
+    async fetchRootCertificateList() {
+        const certList = await this.#fetchJson<DclPkiRootCertificatesResponse>("/certificates/approved");
+        if (certList?.approvedRootCertificates?.schemaVersion !== 0) {
+            throw new MatterDclError(
+                `Unsupported DCL Root Certificate schema version: ${certList.approvedRootCertificates.schemaVersion}`,
+            );
+        }
+        return certList.approvedRootCertificates.certs;
+    }
+
+    async fetchRootCertificateBySubject(subject: DclPkiRootCertificateSubjectReference) {
+        const path = `/certificates/${encodeURIComponent(subject.subject)}/${encodeURIComponent(subject.subjectKeyId)}`;
+        const response = await this.#fetchJson<DclPkiCertificateResponse>(path);
+        if (
+            !response ||
+            !response.approvedRootCertificates ||
+            response.approvedRootCertificates.subject !== subject.subject ||
+            response.approvedRootCertificates.subjectKeyId !== subject.subjectKeyId ||
+            response.approvedRootCertificates.schemaVersion !== 0
+        ) {
+            throw new MatterDclError(
+                `Root certificate not found for subject: ${subject.subject}, subjectKeyId: ${subject.subjectKeyId}`,
+            );
+        }
+        return response.approvedRootCertificates.certs;
+    }
+
+    async fetchModelByVidPid(vid: number, pid: number) {
+        const path = `/models/model/${encodeURIComponent(vid)}/${encodeURIComponent(pid)}`;
+        const response = await this.#fetchJson<DclModelModelsWithVidPidResponse>(path);
+        if (
+            !response ||
+            !response.model ||
+            response.model.vid !== vid ||
+            response.model.pid !== pid ||
+            response.model.schemaVersion !== 0
+        ) {
+            throw new MatterDclError(`Model not found for VID: ${vid}, PID: ${pid}`);
+        }
+        return response.model;
+    }
+
+    async fetchModelVersionsByVidPid(vid: number, pid: number) {
+        const path = `/models/versions/${encodeURIComponent(vid)}/${encodeURIComponent(pid)}`;
+        const response = await this.#fetchJson<DclModelVersionsWithVidPidResponse>(path);
+        if (
+            !response ||
+            !response.modelVersions ||
+            response.modelVersions.vid !== vid ||
+            response.modelVersions.pid !== pid ||
+            response.modelVersions.schemaVersion !== 0
+        ) {
+            throw new MatterDclError(`Model versions not found for VID: ${vid}, PID: ${pid}`);
+        }
+        return response.modelVersions.softwareVersions;
+    }
+
+    async fetchModelVersionByVidPidSoftwareVersion(vid: number, pid: number, softwareVersion: number) {
+        const path = `/models/versions/${encodeURIComponent(vid)}/${encodeURIComponent(pid)}/${encodeURIComponent(softwareVersion)}`;
+        const response = await this.#fetchJson<DclModelVersionWithVidPidSoftwareVersionResponse>(path);
+        if (
+            !response ||
+            !response.modelVersion ||
+            response.modelVersion.vid !== vid ||
+            response.modelVersion.pid !== pid ||
+            response.modelVersion.softwareVersion !== softwareVersion ||
+            response.modelVersion.schemaVersion !== 0
+        ) {
+            throw new MatterDclError(
+                `Model version not found for VID: ${vid}, PID: ${pid}, Software Version: ${softwareVersion}`,
+            );
+        }
+        return response.modelVersion;
+    }
+}