@twin.org/dataspace-control-plane-service 0.0.3-next.26 → 0.0.3-next.27

package/dist/es/models/IDataspaceControlPlaneServiceConstructorOptions.js.map

@@ -1 +1 @@
-{"version":3,"file":"IDataspaceControlPlaneServiceConstructorOptions.js","sourceRoot":"","sources":["../../../src/models/IDataspaceControlPlaneServiceConstructorOptions.ts"],"names":[],"mappings":"","sourcesContent":["// Copyright 2025 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport type { IDataspaceControlPlaneServiceConfig } from \"./IDataspaceControlPlaneServiceConfig.js\";\n\n/**\n * Dataspace Control Plane service constructor options.\n */\nexport interface IDataspaceControlPlaneServiceConstructorOptions {\n\t/**\n\t * Policy Administration Point component type.\n\t * Used for Agreement lookup and validation during Transfer Process initiation.\n\t * @default policy-administration-point\n\t */\n\tpolicyAdministrationPointComponentType?: string;\n\n\t/**\n\t * Policy Negotiation Point component type.\n\t * Used for contract negotiation to create agreements before transfer processes.\n\t * @default policy-negotiation-point\n\t */\n\tpolicyNegotiationPointComponentType?: string;\n\n\t/**\n\t * Policy Negotiation Admin Point component type.\n\t * Used for querying negotiation history.\n\t * Optional - if not provided, negotiation history will not be available.\n\t * @default policy-negotiation-admin-point\n\t */\n\tpolicyNegotiationAdminPointComponentType?: string;\n\n\t/**\n\t * Federated Catalogue component type.\n\t * Used for dataset validation during Transfer Process initiation.\n\t * Validates that Agreements reference valid catalog datasets.\n\t * @default federated-catalogue\n\t */\n\tfederatedCatalogueComponentType?: string;\n\n\t/**\n\t * Logging component type.\n\t * @default logging\n\t */\n\tloggingComponentType?: string;\n\n\t/**\n\t * Identity component type (for token signing/verification).\n\t * @default identity\n\t */\n\tidentityComponentType?: string;\n\n\t/**\n\t * Identity Authentication component type (for token validation).\n\t * @default identity-authentication\n\t */\n\tidentityAuthenticationComponentType?: string;\n\n\t/**\n\t * Trust component type for trust verification.\n\t * Used to verify JWT/VC tokens and extract identity information.\n\t * @default trust\n\t */\n\ttrustComponentType?: string;\n\n\t/**\n\t * Entity storage type for Transfer Process entities.\n\t * Used to persist transfer state for the consumerPid flow.\n\t * Must match the Data Plane's transferProcessEntityStorageType for shared storage.\n\t * @default transfer-process\n\t */\n\ttransferProcessEntityStorageType?: string;\n\n\t/**\n\t * Task scheduler component type for periodic cleanup of stalled negotiations.\n\t * @default task-scheduler\n\t */\n\ttaskSchedulerComponentType?: string;\n\n\t/**\n\t * The configuration of the Dataspace Control Plane Service.\n\t */\n\tconfig?: IDataspaceControlPlaneServiceConfig;\n}\n"]}
+{"version":3,"file":"IDataspaceControlPlaneServiceConstructorOptions.js","sourceRoot":"","sources":["../../../src/models/IDataspaceControlPlaneServiceConstructorOptions.ts"],"names":[],"mappings":"","sourcesContent":["// Copyright 2025 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport type { IDataspaceControlPlaneServiceConfig } from \"./IDataspaceControlPlaneServiceConfig.js\";\n\n/**\n * Dataspace Control Plane service constructor options.\n */\nexport interface IDataspaceControlPlaneServiceConstructorOptions {\n\t/**\n\t * Policy Administration Point component type.\n\t * Used for Agreement lookup and validation during Transfer Process initiation.\n\t * @default policy-administration-point\n\t */\n\tpolicyAdministrationPointComponentType?: string;\n\n\t/**\n\t * Policy Negotiation Point component type.\n\t * Used for contract negotiation to create agreements before transfer processes.\n\t * @default policy-negotiation-point\n\t */\n\tpolicyNegotiationPointComponentType?: string;\n\n\t/**\n\t * Policy Negotiation Admin Point component type.\n\t * Used for querying negotiation history.\n\t * Optional - if not provided, negotiation history will not be available.\n\t * @default policy-negotiation-admin-point\n\t */\n\tpolicyNegotiationAdminPointComponentType?: string;\n\n\t/**\n\t * Federated Catalogue component type.\n\t * Used for dataset validation during Transfer Process initiation.\n\t * Validates that Agreements reference valid catalog datasets.\n\t * @default federated-catalogue\n\t */\n\tfederatedCatalogueComponentType?: string;\n\n\t/**\n\t * Logging component type.\n\t * @default logging\n\t */\n\tloggingComponentType?: string;\n\n\t/**\n\t * Identity component type (for token signing/verification).\n\t * @default identity\n\t */\n\tidentityComponentType?: string;\n\n\t/**\n\t * Identity Authentication component type (for token validation).\n\t * @default identity-authentication\n\t */\n\tidentityAuthenticationComponentType?: string;\n\n\t/**\n\t * Trust component type for trust verification.\n\t * Used to verify JWT/VC tokens and extract identity information.\n\t * @default trust\n\t */\n\ttrustComponentType?: string;\n\n\t/**\n\t * Entity storage type for Transfer Process entities.\n\t * Used to persist transfer state for the consumerPid flow.\n\t * Must match the Data Plane's transferProcessEntityStorageType for shared storage.\n\t * @default transfer-process\n\t */\n\ttransferProcessEntityStorageType?: string;\n\n\t/**\n\t * Entity storage type for Dataspace App Dataset entities.\n\t * @default dataspace-app-dataset\n\t */\n\tdataspaceAppDatasetEntityStorageType?: string;\n\n\t/**\n\t * Task scheduler component type for periodic cleanup of stalled negotiations.\n\t * @default task-scheduler\n\t */\n\ttaskSchedulerComponentType?: string;\n\n\t/**\n\t * URL Transformer component type used to encrypt the tenant token into the data-plane..\n\t * @default url-transformer\n\t */\n\turlTransformerComponentType?: string;\n\n\t/**\n\t * The configuration of the Dataspace Control Plane Service.\n\t */\n\tconfig?: IDataspaceControlPlaneServiceConfig;\n}\n"]}

package/dist/es/schema.js

@@ -1,11 +1,12 @@
 // Copyright 2025 IOTA Stiftung.
 // SPDX-License-Identifier: Apache-2.0.
-import { TransferProcess } from "@twin.org/dataspace-models";
+import { DataspaceAppDataset, TransferProcess } from "@twin.org/dataspace-models";
 import { EntitySchemaFactory, EntitySchemaHelper } from "@twin.org/entity";
 /**
  * Inits schemas for Control Plane entities.
  */
 export function initSchema() {
     EntitySchemaFactory.register("TransferProcess", () => EntitySchemaHelper.getSchema(TransferProcess));
+    EntitySchemaFactory.register("DataspaceAppDataset", () => EntitySchemaHelper.getSchema(DataspaceAppDataset));
 }
 //# sourceMappingURL=schema.js.map

package/dist/es/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/schema.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,uCAAuC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAG3E;;GAEG;AACH,MAAM,UAAU,UAAU;IACzB,mBAAmB,CAAC,QAAQ,oBAA4B,GAAG,EAAE,CAC5D,kBAAkB,CAAC,SAAS,CAAC,eAAe,CAAC,CAC7C,CAAC;AACH,CAAC","sourcesContent":["// Copyright 2025 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport { TransferProcess } from \"@twin.org/dataspace-models\";\nimport { EntitySchemaFactory, EntitySchemaHelper } from \"@twin.org/entity\";\nimport { nameof } from \"@twin.org/nameof\";\n\n/**\n * Inits schemas for Control Plane entities.\n */\nexport function initSchema(): void {\n\tEntitySchemaFactory.register(nameof<TransferProcess>(), () =>\n\t\tEntitySchemaHelper.getSchema(TransferProcess)\n\t);\n}\n"]}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/schema.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,uCAAuC;AACvC,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClF,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAG3E;;GAEG;AACH,MAAM,UAAU,UAAU;IACzB,mBAAmB,CAAC,QAAQ,oBAA4B,GAAG,EAAE,CAC5D,kBAAkB,CAAC,SAAS,CAAC,eAAe,CAAC,CAC7C,CAAC;IACF,mBAAmB,CAAC,QAAQ,wBAAgC,GAAG,EAAE,CAChE,kBAAkB,CAAC,SAAS,CAAC,mBAAmB,CAAC,CACjD,CAAC;AACH,CAAC","sourcesContent":["// Copyright 2025 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport { DataspaceAppDataset, TransferProcess } from \"@twin.org/dataspace-models\";\nimport { EntitySchemaFactory, EntitySchemaHelper } from \"@twin.org/entity\";\nimport { nameof } from \"@twin.org/nameof\";\n\n/**\n * Inits schemas for Control Plane entities.\n */\nexport function initSchema(): void {\n\tEntitySchemaFactory.register(nameof<TransferProcess>(), () =>\n\t\tEntitySchemaHelper.getSchema(TransferProcess)\n\t);\n\tEntitySchemaFactory.register(nameof<DataspaceAppDataset>(), () =>\n\t\tEntitySchemaHelper.getSchema(DataspaceAppDataset)\n\t);\n}\n"]}

package/dist/types/dataspaceControlPlaneService.d.ts

@@ -1,5 +1,5 @@
-import { type IDataspaceControlPlaneComponent, type IDataspaceControlPlaneResolverComponent, type INegotiationCallback, type ITransferContext } from "@twin.org/dataspace-models";
-import { type IDataspaceProtocolContractNegotiation, type IDataspaceProtocolContractNegotiationError, type IDataspaceProtocolTransferCompletionMessage, type IDataspaceProtocolTransferError, type IDataspaceProtocolTransferProcess, type IDataspaceProtocolTransferRequestMessage, type IDataspaceProtocolTransferStartMessage, type IDataspaceProtocolTransferSuspensionMessage, type IDataspaceProtocolTransferTerminationMessage } from "@twin.org/standards-dataspace-protocol";
+import { type IDataspaceControlPlaneComponent, type IDataspaceControlPlaneResolverComponent, type INegotiationCallback, type IDataspaceAppDataset, type ITransferContext } from "@twin.org/dataspace-models";
+import { type IDataspaceProtocolContractNegotiation, type IDataspaceProtocolContractNegotiationError, type IDataspaceProtocolDataset, type IDataspaceProtocolTransferCompletionMessage, type IDataspaceProtocolTransferError, type IDataspaceProtocolTransferProcess, type IDataspaceProtocolTransferRequestMessage, type IDataspaceProtocolTransferStartMessage, type IDataspaceProtocolTransferSuspensionMessage, type IDataspaceProtocolTransferTerminationMessage } from "@twin.org/standards-dataspace-protocol";
 import type { IDataspaceControlPlaneServiceConstructorOptions } from "./models/IDataspaceControlPlaneServiceConstructorOptions.js";
 /**
  * Dataspace Control Plane Service implementation.
@@ -38,7 +38,9 @@ export declare class DataspaceControlPlaneService implements IDataspaceControlPl
     /**
      * The service needs to be started when the application is initialized.
      * Populates the Federated Catalogue with datasets from registered apps
-     * and starts the stalled negotiation cleanup task.
+     * and starts the stalled negotiation cleanup task. Also captures the node
+     * identity from ContextIdStore when tenant-token encryption is configured
+     * (required to derive the vault key name `${nodeId}/${signingKeyName}`).
      * @param nodeLoggingComponentType The node logging component type.
      */
     start(nodeLoggingComponentType?: string): Promise<void>;
@@ -151,4 +153,41 @@ export declare class DataspaceControlPlaneService implements IDataspaceControlPl
      * @returns Transfer Context with Agreement, datasetId, and Transfer Process metadata.
      */
     resolveProviderPid(providerPid: string, trustPayload: unknown): Promise<ITransferContext>;
+    /**
+     * Register a dataset for a dataspace app, owned by the calling tenant.
+     * @param id Optional explicit id. If omitted, derived from `dataset["@id"]`
+     * or generated.
+     * @param appId The dataspace app this dataset belongs to.
+     * @param dataset The dataset payload.
+     * @returns The resolved dataset id.
+     */
+    createAppDataset(id: string | undefined, appId: string, dataset: IDataspaceProtocolDataset): Promise<string>;
+    /**
+     * Get a dataset record owned by the calling tenant.
+     * @param id The stored dataset id.
+     * @returns The stored dataset record.
+     */
+    getAppDataset(id: string): Promise<IDataspaceAppDataset>;
+    /**
+     * List the dataspace app datasets owned by the calling tenant.
+     * @param cursor Optional pagination cursor.
+     * @param limit Optional maximum number of entries to return.
+     * @returns The stored datasets and the next-page cursor if more exist.
+     */
+    listAppDatasets(cursor?: string, limit?: number): Promise<{
+        entities: IDataspaceAppDataset[];
+        cursor?: string;
+    }>;
+    /**
+     * Update a dataset record owned by the calling tenant.
+     * @param id The stored dataset id.
+     * @param appId The dataspace app this dataset belongs to.
+     * @param dataset The dataset payload.
+     */
+    updateAppDataset(id: string, appId: string, dataset: IDataspaceProtocolDataset): Promise<void>;
+    /**
+     * Delete a dataspace app dataset owned by the calling tenant.
+     * @param id The stored app dataset id.
+     */
+    deleteAppDataset(id: string): Promise<void>;
 }

package/dist/types/models/IDataspaceControlPlaneServiceConstructorOptions.d.ts

@@ -57,11 +57,21 @@ export interface IDataspaceControlPlaneServiceConstructorOptions {
      * @default transfer-process
      */
     transferProcessEntityStorageType?: string;
+    /**
+     * Entity storage type for Dataspace App Dataset entities.
+     * @default dataspace-app-dataset
+     */
+    dataspaceAppDatasetEntityStorageType?: string;
     /**
      * Task scheduler component type for periodic cleanup of stalled negotiations.
      * @default task-scheduler
      */
     taskSchedulerComponentType?: string;
+    /**
+     * URL Transformer component type used to encrypt the tenant token into the data-plane..
+     * @default url-transformer
+     */
+    urlTransformerComponentType?: string;
     /**
      * The configuration of the Dataspace Control Plane Service.
      */

package/docs/changelog.md

@@ -1,11 +1,25 @@
 # Changelog
 
-## [0.0.3-next.26](https://github.com/twinfoundation/dataspace/compare/dataspace-control-plane-service-v0.0.3-next.25...dataspace-control-plane-service-v0.0.3-next.26) (2026-04-14)
+## [0.0.3-next.27](https://github.com/iotaledger/twin-dataspace/compare/dataspace-control-plane-service-v0.0.3-next.26...dataspace-control-plane-service-v0.0.3-next.27) (2026-05-08)
+
+
+### Features
+
+* endpoint encryption + getDatasetTargets multi-target fix ([#112](https://github.com/iotaledger/twin-dataspace/issues/112)) ([3288941](https://github.com/iotaledger/twin-dataspace/commit/328894113c19c7402f7d00dfa77b6a97ae40ca91))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/dataspace-models bumped from 0.0.3-next.26 to 0.0.3-next.27
+
+## [0.0.3-next.26](https://github.com/iotaledger/twin-dataspace/compare/dataspace-control-plane-service-v0.0.3-next.25...dataspace-control-plane-service-v0.0.3-next.26) (2026-04-14)
 
 
 ### Bug Fixes
 
-* dependency update ([fbff0dd](https://github.com/twinfoundation/dataspace/commit/fbff0ddae93d82bd2899001368d7a03b482ce05c))
+* dependency update ([fbff0dd](https://github.com/iotaledger/twin-dataspace/commit/fbff0ddae93d82bd2899001368d7a03b482ce05c))
 
 
 ### Dependencies
@@ -14,7 +28,7 @@
   * dependencies
     * @twin.org/dataspace-models bumped from 0.0.3-next.25 to 0.0.3-next.26
 
-## [0.0.3-next.25](https://github.com/twinfoundation/dataspace/compare/dataspace-control-plane-service-v0.0.3-next.24...dataspace-control-plane-service-v0.0.3-next.25) (2026-04-10)
+## [0.0.3-next.25](https://github.com/iotaledger/twin-dataspace/compare/dataspace-control-plane-service-v0.0.3-next.24...dataspace-control-plane-service-v0.0.3-next.25) (2026-04-10)
 
 
 ### Miscellaneous Chores
@@ -28,12 +42,12 @@
   * dependencies
     * @twin.org/dataspace-models bumped from 0.0.3-next.24 to 0.0.3-next.25
 
-## [0.0.3-next.24](https://github.com/twinfoundation/dataspace/compare/dataspace-control-plane-service-v0.0.3-next.23...dataspace-control-plane-service-v0.0.3-next.24) (2026-03-31)
+## [0.0.3-next.24](https://github.com/iotaledger/twin-dataspace/compare/dataspace-control-plane-service-v0.0.3-next.23...dataspace-control-plane-service-v0.0.3-next.24) (2026-03-31)
 
 
 ### Features
 
-* skip tenant dsp transfer routes ([#97](https://github.com/twinfoundation/dataspace/issues/97)) ([2f1ad97](https://github.com/twinfoundation/dataspace/commit/2f1ad971bc50ad24bb9f68759fbd4d44527d3d02))
+* skip tenant dsp transfer routes ([#97](https://github.com/iotaledger/twin-dataspace/issues/97)) ([2f1ad97](https://github.com/iotaledger/twin-dataspace/commit/2f1ad971bc50ad24bb9f68759fbd4d44527d3d02))
 
 
 ### Dependencies
@@ -42,7 +56,7 @@
   * dependencies
     * @twin.org/dataspace-models bumped from 0.0.3-next.23 to 0.0.3-next.24
 
-## [0.0.3-next.23](https://github.com/twinfoundation/dataspace/compare/dataspace-control-plane-service-v0.0.3-next.22...dataspace-control-plane-service-v0.0.3-next.23) (2026-03-25)
+## [0.0.3-next.23](https://github.com/iotaledger/twin-dataspace/compare/dataspace-control-plane-service-v0.0.3-next.22...dataspace-control-plane-service-v0.0.3-next.23) (2026-03-25)
 
 
 ### Miscellaneous Chores
@@ -56,12 +70,12 @@
   * dependencies
     * @twin.org/dataspace-models bumped from 0.0.3-next.22 to 0.0.3-next.23
 
-## [0.0.3-next.22](https://github.com/twinfoundation/dataspace/compare/dataspace-control-plane-service-v0.0.3-next.21...dataspace-control-plane-service-v0.0.3-next.22) (2026-03-20)
+## [0.0.3-next.22](https://github.com/iotaledger/twin-dataspace/compare/dataspace-control-plane-service-v0.0.3-next.21...dataspace-control-plane-service-v0.0.3-next.22) (2026-03-20)
 
 
 ### Features
 
-* internalise constant ([9b9b293](https://github.com/twinfoundation/dataspace/commit/9b9b2933588ee70811a601bc485b5abaa12bed41))
+* internalise constant ([9b9b293](https://github.com/iotaledger/twin-dataspace/commit/9b9b2933588ee70811a601bc485b5abaa12bed41))
 
 
 ### Dependencies
@@ -70,18 +84,18 @@
   * dependencies
     * @twin.org/dataspace-models bumped from 0.0.3-next.21 to 0.0.3-next.22
 
-## [0.0.3-next.21](https://github.com/twinfoundation/dataspace/compare/dataspace-control-plane-service-v0.0.3-next.20...dataspace-control-plane-service-v0.0.3-next.21) (2026-03-17)
+## [0.0.3-next.21](https://github.com/iotaledger/twin-dataspace/compare/dataspace-control-plane-service-v0.0.3-next.20...dataspace-control-plane-service-v0.0.3-next.21) (2026-03-17)
 
 
 ### Features
 
-* improve open-api examples ([1368dbe](https://github.com/twinfoundation/dataspace/commit/1368dbed5c36e074b4854942304a19b9ce51e088))
-* improve open-api examples ([44f7350](https://github.com/twinfoundation/dataspace/commit/44f7350c625d8d6afdca88b292dd48ef03253412))
+* improve open-api examples ([1368dbe](https://github.com/iotaledger/twin-dataspace/commit/1368dbed5c36e074b4854942304a19b9ce51e088))
+* improve open-api examples ([44f7350](https://github.com/iotaledger/twin-dataspace/commit/44f7350c625d8d6afdca88b292dd48ef03253412))
 
 
 ### Bug Fixes
 
-* handle missing target in catalogue offers during policy derivation check ([#89](https://github.com/twinfoundation/dataspace/issues/89)) ([a0e0dbc](https://github.com/twinfoundation/dataspace/commit/a0e0dbc8d9111d5d1c43e905249825e5d8d62816))
+* handle missing target in catalogue offers during policy derivation check ([#89](https://github.com/iotaledger/twin-dataspace/issues/89)) ([a0e0dbc](https://github.com/iotaledger/twin-dataspace/commit/a0e0dbc8d9111d5d1c43e905249825e5d8d62816))
 
 
 ### Dependencies
@@ -90,12 +104,12 @@
   * dependencies
     * @twin.org/dataspace-models bumped from 0.0.3-next.20 to 0.0.3-next.21
 
-## [0.0.3-next.20](https://github.com/twinfoundation/dataspace/compare/dataspace-control-plane-service-v0.0.3-next.19...dataspace-control-plane-service-v0.0.3-next.20) (2026-03-17)
+## [0.0.3-next.20](https://github.com/iotaledger/twin-dataspace/compare/dataspace-control-plane-service-v0.0.3-next.19...dataspace-control-plane-service-v0.0.3-next.20) (2026-03-17)
 
 
 ### Features
 
-* improve open-api examples ([f065f4b](https://github.com/twinfoundation/dataspace/commit/f065f4bd55540041a653ef141c4be29a83c5055e))
+* improve open-api examples ([f065f4b](https://github.com/iotaledger/twin-dataspace/commit/f065f4bd55540041a653ef141c4be29a83c5055e))
 
 
 ### Dependencies
@@ -104,12 +118,12 @@
   * dependencies
     * @twin.org/dataspace-models bumped from 0.0.3-next.19 to 0.0.3-next.20
 
-## [0.0.3-next.19](https://github.com/twinfoundation/dataspace/compare/dataspace-control-plane-service-v0.0.3-next.18...dataspace-control-plane-service-v0.0.3-next.19) (2026-03-12)
+## [0.0.3-next.19](https://github.com/iotaledger/twin-dataspace/compare/dataspace-control-plane-service-v0.0.3-next.18...dataspace-control-plane-service-v0.0.3-next.19) (2026-03-12)
 
 
 ### Features
 
-* improve validation ([#82](https://github.com/twinfoundation/dataspace/issues/82)) ([8bfaf7b](https://github.com/twinfoundation/dataspace/commit/8bfaf7b830f89b63575f8a51ee96bd8ac4da02f4))
+* improve validation ([#82](https://github.com/iotaledger/twin-dataspace/issues/82)) ([8bfaf7b](https://github.com/iotaledger/twin-dataspace/commit/8bfaf7b830f89b63575f8a51ee96bd8ac4da02f4))
 
 
 ### Dependencies
@@ -118,12 +132,12 @@
   * dependencies
     * @twin.org/dataspace-models bumped from 0.0.3-next.18 to 0.0.3-next.19
 
-## [0.0.3-next.18](https://github.com/twinfoundation/dataspace/compare/dataspace-control-plane-service-v0.0.3-next.17...dataspace-control-plane-service-v0.0.3-next.18) (2026-03-09)
+## [0.0.3-next.18](https://github.com/iotaledger/twin-dataspace/compare/dataspace-control-plane-service-v0.0.3-next.17...dataspace-control-plane-service-v0.0.3-next.18) (2026-03-09)
 
 
 ### Features
 
-* resolve DSP transfer flow bugs for cross-node communication ([#76](https://github.com/twinfoundation/dataspace/issues/76)) ([506a45c](https://github.com/twinfoundation/dataspace/commit/506a45c94e63d5f958b1fc7131adfe452c3e2974))
+* resolve DSP transfer flow bugs for cross-node communication ([#76](https://github.com/iotaledger/twin-dataspace/issues/76)) ([506a45c](https://github.com/iotaledger/twin-dataspace/commit/506a45c94e63d5f958b1fc7131adfe452c3e2974))
 
 
 ### Dependencies
@@ -132,18 +146,18 @@
   * dependencies
     * @twin.org/dataspace-models bumped from 0.0.3-next.17 to 0.0.3-next.18
 
-## [0.0.3-next.17](https://github.com/twinfoundation/dataspace/compare/dataspace-control-plane-service-v0.0.3-next.16...dataspace-control-plane-service-v0.0.3-next.17) (2026-03-06)
+## [0.0.3-next.17](https://github.com/iotaledger/twin-dataspace/compare/dataspace-control-plane-service-v0.0.3-next.16...dataspace-control-plane-service-v0.0.3-next.17) (2026-03-06)
 
 
 ### Features
 
-* docs update ([8b44c7a](https://github.com/twinfoundation/dataspace/commit/8b44c7a75afb8d377a6f606616f8a78d58439ab4))
-* types update ([77c338e](https://github.com/twinfoundation/dataspace/commit/77c338e9244dcc7e3d597fdb06229513b1f13eac))
+* docs update ([8b44c7a](https://github.com/iotaledger/twin-dataspace/commit/8b44c7a75afb8d377a6f606616f8a78d58439ab4))
+* types update ([77c338e](https://github.com/iotaledger/twin-dataspace/commit/77c338e9244dcc7e3d597fdb06229513b1f13eac))
 
 
 ### Bug Fixes
 
-* avoid compaction of incoming activities ([#77](https://github.com/twinfoundation/dataspace/issues/77)) ([ff43d6a](https://github.com/twinfoundation/dataspace/commit/ff43d6a3e1563eb9cb185501134b2a53ae88787c))
+* avoid compaction of incoming activities ([#77](https://github.com/iotaledger/twin-dataspace/issues/77)) ([ff43d6a](https://github.com/iotaledger/twin-dataspace/commit/ff43d6a3e1563eb9cb185501134b2a53ae88787c))
 
 
 ### Dependencies
@@ -152,12 +166,12 @@
   * dependencies
     * @twin.org/dataspace-models bumped from 0.0.3-next.16 to 0.0.3-next.17
 
-## [0.0.3-next.16](https://github.com/twinfoundation/dataspace/compare/dataspace-control-plane-service-v0.0.3-next.15...dataspace-control-plane-service-v0.0.3-next.16) (2026-03-02)
+## [0.0.3-next.16](https://github.com/iotaledger/twin-dataspace/compare/dataspace-control-plane-service-v0.0.3-next.15...dataspace-control-plane-service-v0.0.3-next.16) (2026-03-02)
 
 
 ### Bug Fixes
 
-* docs and component init ([8557233](https://github.com/twinfoundation/dataspace/commit/8557233fb3b8273c5c9a5b580fb43061f8efe47c))
+* docs and component init ([8557233](https://github.com/iotaledger/twin-dataspace/commit/8557233fb3b8273c5c9a5b580fb43061f8efe47c))
 
 
 ### Dependencies
@@ -166,12 +180,12 @@
   * dependencies
     * @twin.org/dataspace-models bumped from 0.0.3-next.15 to 0.0.3-next.16
 
-## [0.0.3-next.15](https://github.com/twinfoundation/dataspace/compare/dataspace-control-plane-service-v0.0.3-next.14...dataspace-control-plane-service-v0.0.3-next.15) (2026-03-02)
+## [0.0.3-next.15](https://github.com/iotaledger/twin-dataspace/compare/dataspace-control-plane-service-v0.0.3-next.14...dataspace-control-plane-service-v0.0.3-next.15) (2026-03-02)
 
 
 ### Features
 
-* unification of the data exchange and the data space connector ([#57](https://github.com/twinfoundation/dataspace/issues/57)) ([df2644d](https://github.com/twinfoundation/dataspace/commit/df2644d989471e07dadd83d27bef736179e31bf4))
+* unification of the data exchange and the data space connector ([#57](https://github.com/iotaledger/twin-dataspace/issues/57)) ([df2644d](https://github.com/iotaledger/twin-dataspace/commit/df2644d989471e07dadd83d27bef736179e31bf4))
 
 
 ### Dependencies
@@ -180,12 +194,12 @@
   * dependencies
     * @twin.org/dataspace-models bumped from 0.0.3-next.14 to 0.0.3-next.15
 
-## [0.0.3-next.1](https://github.com/twinfoundation/data-exchange/compare/data-exchange-service-v0.0.3-next.0...data-exchange-service-v0.0.3-next.1) (2026-01-19)
+## [0.0.3-next.1](https://github.com/iotaledger/twin-data-exchange/compare/data-exchange-service-v0.0.3-next.0...data-exchange-service-v0.0.3-next.1) (2026-01-19)
 
 
 ### Features
 
-* mocking data exchange basic methods ([#5](https://github.com/twinfoundation/data-exchange/issues/5)) ([6cb00c0](https://github.com/twinfoundation/data-exchange/commit/6cb00c029aacf46da7bed0b3c97a21ef4102784a))
+* mocking data exchange basic methods ([#5](https://github.com/iotaledger/twin-data-exchange/issues/5)) ([6cb00c0](https://github.com/iotaledger/twin-data-exchange/commit/6cb00c029aacf46da7bed0b3c97a21ef4102784a))
 
 
 ### Dependencies

package/docs/reference/classes/DataspaceControlPlaneService.md

@@ -120,7 +120,9 @@ The key used when registering the callback.
 
 The service needs to be started when the application is initialized.
 Populates the Federated Catalogue with datasets from registered apps
-and starts the stalled negotiation cleanup task.
+and starts the stalled negotiation cleanup task. Also captures the node
+identity from ContextIdStore when tenant-token encryption is configured
+(required to derive the vault key name `${nodeId}/${signingKeyName}`).
 
 #### Parameters
 
@@ -553,3 +555,160 @@ Transfer Context with Agreement, datasetId, and Transfer Process metadata.
 #### Implementation of
 
 `IDataspaceControlPlaneResolverComponent.resolveProviderPid`
+
+***
+
+### createAppDataset() {#createappdataset}
+
+> **createAppDataset**(`id`, `appId`, `dataset`): `Promise`\<`string`\>
+
+Register a dataset for a dataspace app, owned by the calling tenant.
+
+#### Parameters
+
+##### id
+
+`string` \| `undefined`
+
+Optional explicit id. If omitted, derived from `dataset["@id"]`
+or generated.
+
+##### appId
+
+`string`
+
+The dataspace app this dataset belongs to.
+
+##### dataset
+
+`IDataspaceProtocolDataset`
+
+The dataset payload.
+
+#### Returns
+
+`Promise`\<`string`\>
+
+The resolved dataset id.
+
+#### Implementation of
+
+`IDataspaceControlPlaneComponent.createAppDataset`
+
+***
+
+### getAppDataset() {#getappdataset}
+
+> **getAppDataset**(`id`): `Promise`\<`IDataspaceAppDataset`\>
+
+Get a dataset record owned by the calling tenant.
+
+#### Parameters
+
+##### id
+
+`string`
+
+The stored dataset id.
+
+#### Returns
+
+`Promise`\<`IDataspaceAppDataset`\>
+
+The stored dataset record.
+
+#### Implementation of
+
+`IDataspaceControlPlaneComponent.getAppDataset`
+
+***
+
+### listAppDatasets() {#listappdatasets}
+
+> **listAppDatasets**(`cursor?`, `limit?`): `Promise`\<\{ `entities`: `IDataspaceAppDataset`[]; `cursor?`: `string`; \}\>
+
+List the dataspace app datasets owned by the calling tenant.
+
+#### Parameters
+
+##### cursor?
+
+`string`
+
+Optional pagination cursor.
+
+##### limit?
+
+`number`
+
+Optional maximum number of entries to return.
+
+#### Returns
+
+`Promise`\<\{ `entities`: `IDataspaceAppDataset`[]; `cursor?`: `string`; \}\>
+
+The stored datasets and the next-page cursor if more exist.
+
+#### Implementation of
+
+`IDataspaceControlPlaneComponent.listAppDatasets`
+
+***
+
+### updateAppDataset() {#updateappdataset}
+
+> **updateAppDataset**(`id`, `appId`, `dataset`): `Promise`\<`void`\>
+
+Update a dataset record owned by the calling tenant.
+
+#### Parameters
+
+##### id
+
+`string`
+
+The stored dataset id.
+
+##### appId
+
+`string`
+
+The dataspace app this dataset belongs to.
+
+##### dataset
+
+`IDataspaceProtocolDataset`
+
+The dataset payload.
+
+#### Returns
+
+`Promise`\<`void`\>
+
+#### Implementation of
+
+`IDataspaceControlPlaneComponent.updateAppDataset`
+
+***
+
+### deleteAppDataset() {#deleteappdataset}
+
+> **deleteAppDataset**(`id`): `Promise`\<`void`\>
+
+Delete a dataspace app dataset owned by the calling tenant.
+
+#### Parameters
+
+##### id
+
+`string`
+
+The stored app dataset id.
+
+#### Returns
+
+`Promise`\<`void`\>
+
+#### Implementation of
+
+`IDataspaceControlPlaneComponent.deleteAppDataset`

package/docs/reference/interfaces/IDataspaceControlPlaneServiceConstructorOptions.md

@@ -139,6 +139,20 @@ transfer-process
 
 ***
 
+### dataspaceAppDatasetEntityStorageType? {#dataspaceappdatasetentitystoragetype}
+
+> `optional` **dataspaceAppDatasetEntityStorageType?**: `string`
+
+Entity storage type for Dataspace App Dataset entities.
+
+#### Default
+
+```ts
+dataspace-app-dataset
+```
+
+***
+
 ### taskSchedulerComponentType? {#taskschedulercomponenttype}
 
 > `optional` **taskSchedulerComponentType?**: `string`
@@ -153,6 +167,20 @@ task-scheduler
 
 ***
 
+### urlTransformerComponentType? {#urltransformercomponenttype}
+
+> `optional` **urlTransformerComponentType?**: `string`
+
+URL Transformer component type used to encrypt the tenant token into the data-plane..
+
+#### Default
+
+```ts
+url-transformer
+```
+
+***
+
 ### config? {#config}
 
 > `optional` **config?**: [`IDataspaceControlPlaneServiceConfig`](IDataspaceControlPlaneServiceConfig.md)

package/locales/en.json

@@ -12,8 +12,8 @@
 			"resolvedProviderPid": "Resolved providerPid to Transfer Context",
 			"catalogDatasetFound": "Dataset validated in Federated Catalogue",
 			"agreementMatchedOffer": "Agreement matched Catalog Offer",
-			"populatingFederatedCatalogue": "Populating Federated Catalogue with datasets from registered apps",
-			"federatedCataloguePopulated": "Federated Catalogue population completed (registered: {registeredCount}, errors: {errorCount}, apps: {totalApps})",
+			"populatingFederatedCatalogue": "Populating Federated Catalogue with stored app datasets",
+			"federatedCataloguePopulated": "Federated Catalogue population completed (registered: {registeredCount}, errors: {errorCount}, datasets: {totalDatasets})",
 			"startingContractNegotiation": "Starting contract negotiation with provider",
 			"offerFoundInCatalog": "Offer found in Federated Catalogue and validated",
 			"negotiationInitiated": "Contract negotiation initiated successfully",
@@ -34,8 +34,7 @@
 	"debug": {
 		"dataspaceControlPlaneService": {
 			"engineCloneStart": "Skipping Federated Catalogue population (engine clone or no engine)",
-			"discoveredApps": "Discovered {count} registered Dataspace apps",
-			"datasetRegistered": "Dataset {datasetId} registered from app {appName}"
+			"datasetRegistered": "Dataset {datasetId} registered for app {appId} (tenant: {tenantId})"
 		}
 	},
 	"warn": {
@@ -54,8 +53,6 @@
 		"dataspaceControlPlaneService": {
 			"transferProcessNotFound": "Transfer Process not found",
 			"pullTransfersNotSupported": "PULL transfers are not supported. Configure dataPlanePath in service configuration to enable PULL transfers.",
-			"datasetRegistrationFailed": "Failed to register dataset {datasetId} from app {appName}",
-			"appDatasetsRetrievalFailed": "Failed to retrieve datasets from app {appName}",
 			"transferProcessTerminated": "Transfer Process \"{consumerPid}\" is terminated and cannot be used",
 			"transferProcessTerminatedProvider": "Transfer Process \"{providerPid}\" is terminated and cannot be used",
 			"invalidTransferRequest": "Transfer Request does not conform to Dataspace Protocol specification",
@@ -93,7 +90,12 @@
 			"callerNotAuthorizedAsConsumer": "The caller's verified identity does not match the consumer for this transfer process",
 			"callerNotAuthorizedAsProvider": "The caller's verified identity does not match the provider for this transfer process",
 			"callerNotAuthorizedForTransfer": "The caller's verified identity does not match the consumer or provider for this transfer process",
-			"multipleAssignersNotSupported": "Multiple assigners found in agreement, which is not supported. Only single assigner agreements are supported."
+			"multipleAssignersNotSupported": "Multiple assigners found in agreement, which is not supported. Only single assigner agreements are supported.",
+			"datasetPublishFailed": "Failed to publish dataset {datasetRecordId} for app {appId} (tenant: {tenantId})",
+			"datasetNodeContextRequired": "A node context is required to register a dataset.",
+			"datasetAlreadyExists": "A dataset with id \"{id}\" already exists.",
+			"datasetNotFound": "Dataset not found",
+			"datasetWrongTenant": "The calling tenant does not own this dataset."
 		},
 		"dataspaceControlPlanePolicyRequester": {}
 	}

package/package.json

@@ -1,10 +1,10 @@
 {
 	"name": "@twin.org/dataspace-control-plane-service",
-	"version": "0.0.3-next.26",
+	"version": "0.0.3-next.27",
 	"description": "Implements agreement negotiation and transfer process lifecycle management for control plane operations.",
 	"repository": {
 		"type": "git",
-		"url": "git+https://github.com/twinfoundation/dataspace.git",
+		"url": "git+https://github.com/iotaledger/dataspace.git",
 		"directory": "packages/dataspace-control-plane-service"
 	},
 	"author": "martyn.janes@iota.org",
@@ -15,9 +15,10 @@
 	},
 	"dependencies": {
 		"@twin.org/api-models": "next",
+		"@twin.org/api-tenant-processor": "next",
 		"@twin.org/context": "next",
 		"@twin.org/core": "next",
-		"@twin.org/dataspace-models": "0.0.3-next.26",
+		"@twin.org/dataspace-models": "0.0.3-next.27",
 		"@twin.org/entity": "next",
 		"@twin.org/entity-storage-models": "next",
 		"@twin.org/federated-catalogue-models": "next",
@@ -26,7 +27,8 @@
 		"@twin.org/rights-management-models": "next",
 		"@twin.org/standards-dataspace-protocol": "next",
 		"@twin.org/standards-w3c-odrl": "next",
-		"@twin.org/trust-models": "next"
+		"@twin.org/trust-models": "next",
+		"@twin.org/vault-models": "next"
 	},
 	"main": "./dist/es/index.js",
 	"types": "./dist/types/index.d.ts",
@@ -64,7 +66,7 @@
 		"business-logic"
 	],
 	"bugs": {
-		"url": "git+https://github.com/twinfoundation/dataspace/issues"
+		"url": "git+https://github.com/iotaledger/dataspace/issues"
 	},
 	"homepage": "https://twindev.org"
 }