@twin.org/node 0.0.3-next.39 → 0.0.3-next.41

package/dist/locales/en.json

@@ -218,6 +218,12 @@
 		"jsonHelper": {
 			"failedPatch": "Failed to patch the JSON object, patch index \"{index}\" failed"
 		},
+		"mutex": {
+			"lockNotFound": "The key \"{key}\" has no active lock",
+			"lockAlreadyReleased": "The key \"{key}\" is not currently locked",
+			"lockTimeout": "Failed to acquire lock for key \"{key}\" within the timeout of {timeout} milliseconds",
+			"bufferFetchFailed": "Failed to retrieve shared buffer for key \"{key}\" from the main thread"
+		},
 		"fetchHelper": {
 			"decodingJSON": "Decoding JSON failed for route \"{url}\"",
 			"failureStatusText": "The request to the API failed: \"{statusText}\"",
@@ -589,8 +595,9 @@
 			"agreementNotMatchingOffer": "Agreement \"{agreementId}\" does not match any Catalog Offer for dataset {datasetId}. Available Offers: {availableOffers}",
 			"organizationContextMissing": "Organization context is missing. Cannot verify Agreement authorization for consumerPid: {consumerPid}",
 			"organizationContextMissingProvider": "Organization context is missing. Cannot verify Agreement authorization for providerPid: {providerPid}",
-			"agreementAssignerMismatch": "Agreement assigner does not match current organization. Agreement: {agreementId}, consumerPid: {consumerPid}, expected: {expectedOrgId}, actual: {actualAssigner}",
-			"agreementAssignerMismatchProvider": "Agreement assigner does not match current organization. Agreement: {agreementId}, providerPid: {providerPid}, expected: {expectedOrgId}, actual: {actualAssigner}",
+			"agreementAssignerMismatch": "Agreement assigner does not match current caller identity. Agreement: {agreementId}, consumerPid: {consumerPid}, expected: {expectedComposite}, actual: {actualAssigner}",
+			"agreementAssignerMismatchProvider": "Agreement assigner does not match current caller identity. Agreement: {agreementId}, providerPid: {providerPid}, expected: {expectedComposite}, actual: {actualAssigner}",
+			"invalidCompositeIdentifier": "Composite tenant identifier is not in a recognised shape (expected `nodeDid` or `nodeDid:tenantIdHash`, where `nodeDid` starts with `did:`). Got: \"{composite}\"",
 			"agreementAssigneeMismatch": "Agreement assignee does not match expected consumer identity. Agreement: {agreementId}, providerPid: {providerPid}, expected: {expectedConsumerIdentity}, actual: {actualAssignee}",
 			"negotiationInitiationFailed": "Failed to initiate contract negotiation",
 			"datasetNotFoundInCatalog": "Dataset/Offer \"{offerId}\" not found in Federated Catalogue. Cannot initiate negotiation for non-existent offer.",
@@ -607,11 +614,15 @@
 			"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.",
+			"invalidPushDataAddress": "PUSH transfer cannot start: consumer dataAddress is missing endpoint or endpointType (consumerPid: {consumerPid})",
+			"pushTransferDataPathNotConfigured": "PUSH transfer cannot start: dataPlanePath is not configured (consumerPid: {consumerPid})",
+			"dataPlaneNotRegistered": "Push-mode transfer requires the data plane component to be registered (factory key: \"dataspace-data-plane\"). This deployment was configured without a data plane — register one to enable push, or use pull-mode transfers only.",
 			"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."
+			"datasetWrongTenant": "The calling tenant does not own this dataset.",
+			"transferWrongTenant": "The calling tenant does not own this transfer."
 		},
 		"dataspaceControlPlanePolicyRequester": {},
 		"odrlPolicyHelper": {
@@ -637,10 +648,17 @@
 			"transferProcessNotFound": "Transfer Process not found for consumerPid \"{notFoundId}\"",
 			"transferNotInStartedState": "Transfer Process is not in STARTED state. Current state: \"{currentState}\"",
 			"transferMissingDatasetId": "Transfer Process is missing datasetId",
+			"transferMissingDataAddress": "Transfer Process is missing a valid push dataAddress endpoint (consumerPid: {consumerPid})",
+			"pushSubscriptionMissingTenantToken": "Push subscription setup rejected: consumer endpoint does not carry an `x-enc-tenant-token` query parameter (consumerPid: {consumerPid}, endpoint: {endpoint}). On multi-tenant publishers the consumer must bake its tenant token before sending the dataAddress.",
+			"pushSubscriptionStorageNotRegistered": "Push-mode transfer requires push-subscription storage to be registered (entity-storage key: \"push-subscription\"). This deployment was configured without it — register the storage to enable push, or use pull-mode transfers only.",
 			"schemaNotFound": "Schema \"{schemaId}\" not found",
 			"cleanupFailed": "Error occurred during cleanup of activity logs",
 			"invalidProcessingGroupId": "Invalid processing group id \"{processingGroupId}\" specified in activity query",
-			"missingHandleActivity": "Handler App \"{dataspaceAppId}\" does not export a \"handleActivity\" function"
+			"missingHandleActivity": "Handler App \"{dataspaceAppId}\" does not export a \"handleActivity\" function",
+			"pushSubscriptionNotFound": "Push subscription not found for consumerPid \"{notFoundId}\"",
+			"pushActivityNotAuthorized": "Unauthorized push activity — no matching STARTED transfer found for the activity generator",
+			"processOutboxActivityMultipleTo": "processOutboxActivity does not support multiple recipients — activity.to contains {count} values, expected exactly one consumerPid",
+			"pushSubscriptionCompensationFailed": "Compensating unsubscribeToData failed after push-subscription storage write failed (consumerPid: {consumerPid}, providerPid: {providerPid}) — app may be left with a dangling Follow until orphan cleanup runs"
 		},
 		"dataspaceDataPlaneSocketClient": {
 			"socketConnect": "Failure during socket connect",
@@ -1184,7 +1202,6 @@
 			"offerNotAccepted": "Offer with id: \"{offerId}\" was not accepted by the requester",
 			"agreementNotAccepted": "Agreement with id: \"{agreementId}\" was not accepted by the requester",
 			"noAgreementCreated": "No agreement was created for offer with id: \"{offerId}\"",
-			"assignerNotIdentity": "The assigner in the offer is not a single identity",
 			"providerInitiatedNotSupported": "Provider initiated negotiations are currently not supported as the consumer identity is required to be set as the trust identity in the negotiation",
 			"callerNotAuthorizedForNegotiation": "The caller's verified identity does not match any authorized party in this negotiation"
 		},
@@ -1941,7 +1958,6 @@
 		},
 		"dataspaceControlPlaneService": {
 			"catalogDatasetHasNoOffers": "Dataset has no Offers (odrl:hasPolicy) in Federated Catalogue",
-			"pushTransferModeNotImplemented": "PUSH transfer mode requested but not implemented. Consumer provided dataAddress endpoint but data push is not yet supported.",
 			"stalledNegotiationCleanedUp": "Stalled negotiation cleaned up (negotiationId: {negotiationId})"
 		},
 		"dataspaceControlPlanePolicyRequester": {
@@ -1949,6 +1965,10 @@
 			"negotiationTerminated": "Negotiation terminated by provider (negotiationId: {negotiationId})",
 			"unknownNegotiationTerminated": "Unknown negotiation terminated (negotiationId: {negotiationId})"
 		},
+		"dataspaceDataPlaneService": {
+			"pushSubscriptionNotFoundOnTeardown": "Push subscription not found for consumerPid \"{consumerPid}\" during teardown — treating as no-op",
+			"pushSubscriptionNotFoundForActivity": "Push subscription not found for outbound activity (consumerPid: {consumerPid})"
+		},
 		"policyNegotiationAdminPointService": {
 			"sendTerminateFailed": "Failed to send terminate to consumer for negotiation id: \"{id}\", correlation id: \"{correlationId}\""
 		},
@@ -2105,7 +2125,8 @@
 			"negotiationStateRetrieved": "Negotiation state retrieved successfully",
 			"getNegotiationHistory": "Retrieving negotiation history",
 			"negotiationHistoryRetrieved": "Negotiation history retrieved successfully",
-			"stalledNegotiationsCleanupComplete": "Stalled negotiations cleanup completed (cleanedUp: {cleanedUp})"
+			"stalledNegotiationsCleanupComplete": "Stalled negotiations cleanup completed (cleanedUp: {cleanedUp})",
+			"pushTransferStarted": "PUSH transfer started (consumerPid: {consumerPid}, providerPid: {providerPid}, endpoint: {endpoint})"
 		},
 		"dataspaceControlPlanePolicyRequester": {
 			"offerReceived": "Offer received from provider (negotiationId: {negotiationId}, offerId: {offerId})",
@@ -2116,7 +2137,12 @@
 		},
 		"dataspaceDataPlaneService": {
 			"scheduledTask": "\"{taskId}\": Task scheduled for Dataspace App \"{dataspaceAppId}\" (isRetry: {isRetry})",
-			"policyObligationTriggered": "Policy obligation triggered for agreement \"{agreementId}\": action=\"{action}\", target=\"{target}\""
+			"policyObligationTriggered": "Policy obligation triggered for agreement \"{agreementId}\": action=\"{action}\", target=\"{target}\"",
+			"pushSubscriptionCreated": "Push subscription created (consumerPid: {consumerPid}, providerPid: {providerPid})",
+			"pushSubscriptionSuspended": "Push subscription suspended (consumerPid: {consumerPid})",
+			"pushSubscriptionResumed": "Push subscription resumed (consumerPid: {consumerPid})",
+			"pushSubscriptionTornDown": "Push subscription torn down (consumerPid: {consumerPid}, providerPid: {providerPid})",
+			"pushDeliveryTaskScheduled": "Push delivery task scheduled (taskId: {taskId}, consumerPid: {consumerPid})"
 		},
 		"dataspaceDataPlaneSocketClient": {
 			"subscribeActivityLogs": "Subscription created for topic activity logs with id \"{subscriptionId}\"",
@@ -2494,7 +2520,9 @@
 			"engineCloneStart": "'start' method has been called from an engine clone. No task scheduler created",
 			"cleanUpOngoing": "There is an ongoing clean up of activity logs. Skipping",
 			"activityLogCleanedUp": "Activity Log has been cleaned up. \"{numRecordsDeleted}\" records deleted",
-			"replacingFailedTasks": "Retrying apps \"{appsToRetry}\" (successful: \"{successfulApps}\") for activity \"{activityLogEntryId}\""
+			"pushSubscriptionsCleanedUp": "Orphaned push subscriptions cleaned up. \"{numDeleted}\" records deleted",
+			"replacingFailedTasks": "Retrying apps \"{appsToRetry}\" (successful: \"{successfulApps}\") for activity \"{activityLogEntryId}\"",
+			"pushDeliverySkippedPaused": "Push delivery skipped — subscription is paused (consumerPid: {consumerPid})"
 		},
 		"dataspaceDataPlaneSocketRoutes": {
 			"activityLogStatusConnected": "Web Socket Connected: Socket Id: \"{socketId}\"",

package/docs/changelog.md

@@ -1,5 +1,33 @@
 # Changelog
 
+## [0.0.3-next.41](https://github.com/iotaledger/twin-node/compare/node-v0.0.3-next.40...node-v0.0.3-next.41) (2026-05-27)
+
+
+### Miscellaneous Chores
+
+* **node:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/node-core bumped from 0.0.3-next.40 to 0.0.3-next.41
+
+## [0.0.3-next.40](https://github.com/iotaledger/twin-node/compare/node-v0.0.3-next.39...node-v0.0.3-next.40) (2026-05-22)
+
+
+### Miscellaneous Chores
+
+* **node:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/node-core bumped from 0.0.3-next.39 to 0.0.3-next.40
+
 ## [0.0.3-next.39](https://github.com/iotaledger/twin-node/compare/node-v0.0.3-next.38...node-v0.0.3-next.39) (2026-05-21)
 
 

package/docs/open-api/spec.json

@@ -7996,7 +7996,7 @@
 								"notarizationCreateExample": {
 									"value": {
 										"mode": "dynamic",
-										"data": {},
+										"data": "aGVsbG8gd29ybGQ=",
 										"description": "My first notarization"
 									}
 								}
@@ -8107,7 +8107,7 @@
 						"content": {
 							"application/json": {
 								"schema": {
-									"$ref": "#/components/schemas/Notarization"
+									"$ref": "#/components/schemas/NotarizationGetResponse"
 								},
 								"examples": {
 									"notarizationGetResponseExample": {
@@ -8115,7 +8115,7 @@
 											"id": "123",
 											"mode": "dynamic",
 											"dateCreated": "2026-01-01T00:00:00.000Z",
-											"data": {},
+											"data": "aGVsbG8gd29ybGQ=",
 											"description": "A notarization"
 										}
 									}
@@ -8299,7 +8299,7 @@
 					"content": {
 						"application/json": {
 							"schema": {
-								"$ref": "#/components/schemas/Notarization"
+								"$ref": "#/components/schemas/NotarizationUpdateRequest"
 							},
 							"examples": {
 								"notarizationUpdateExample": {
@@ -8307,7 +8307,7 @@
 										"id": "123",
 										"mode": "dynamic",
 										"dateCreated": "2026-01-01T00:00:00.000Z",
-										"data": {},
+										"data": "aGVsbG8gd29ybGQ=",
 										"description": "Updated notarization"
 									}
 								}
@@ -8643,7 +8643,6 @@
 											"id": "attestation:iota:aW90YS1uZnQ6dHN0OjB4NzYyYjljNDllYTg2OWUwZWJkYTliYmZhNzY5Mzk0NDdhNDI4ZGNmMTc4YzVkMTVhYjQ0N2UyZDRmYmJiNGViMg==",
 											"dateCreated": "2024-06-18T13:34:51Z",
 											"ownerIdentity": "did:iota:tst:0x8992c426116f21b2a4c7a2854300748d3e94a8ce089d5be62e11f105bd2a0f9e",
-											"holderIdentity": "did:iota:tst:0x8992c426116f21b2a4c7a2854300748d3e94a8ce089d5be62e11f105bd2a0f9e",
 											"attestationObject": {
 												"@context": "https://schema.org",
 												"type": "DigitalDocument",
@@ -8669,7 +8668,6 @@
 											"id": "attestation:iota:aW90YS1uZnQ6dHN0OjB4NzYyYjljNDllYTg2OWUwZWJkYTliYmZhNzY5Mzk0NDdhNDI4ZGNmMTc4YzVkMTVhYjQ0N2UyZDRmYmJiNGViMg==",
 											"dateCreated": "2024-06-18T13:34:51Z",
 											"ownerIdentity": "did:iota:tst:0x8992c426116f21b2a4c7a2854300748d3e94a8ce089d5be62e11f105bd2a0f9e",
-											"holderIdentity": "did:iota:tst:0x8992c426116f21b2a4c7a2854300748d3e94a8ce089d5be62e11f105bd2a0f9e",
 											"attestationObject": {
 												"@context": "https://schema.org",
 												"type": "DigitalDocument",
@@ -8703,7 +8701,6 @@
 											"id": "attestation:iota:aW90YS1uZnQ6dHN0OjB4NzYyYjljNDllYTg2OWUwZWJkYTliYmZhNzY5Mzk0NDdhNDI4ZGNmMTc4YzVkMTVhYjQ0N2UyZDRmYmJiNGViMg==",
 											"dateCreated": "2024-06-18T13:34:51Z",
 											"ownerIdentity": "did:iota:tst:0x8992c426116f21b2a4c7a2854300748d3e94a8ce089d5be62e11f105bd2a0f9e",
-											"holderIdentity": "did:iota:tst:0x8992c426116f21b2a4c7a2854300748d3e94a8ce089d5be62e11f105bd2a0f9e",
 											"attestationObject": {
 												"@context": "https://schema.org",
 												"type": "DigitalDocument",
@@ -8729,7 +8726,6 @@
 											"id": "attestation:iota:aW90YS1uZnQ6dHN0OjB4NzYyYjljNDllYTg2OWUwZWJkYTliYmZhNzY5Mzk0NDdhNDI4ZGNmMTc4YzVkMTVhYjQ0N2UyZDRmYmJiNGViMg==",
 											"dateCreated": "2024-06-18T13:34:51Z",
 											"ownerIdentity": "did:iota:tst:0x8992c426116f21b2a4c7a2854300748d3e94a8ce089d5be62e11f105bd2a0f9e",
-											"holderIdentity": "did:iota:tst:0x8992c426116f21b2a4c7a2854300748d3e94a8ce089d5be62e11f105bd2a0f9e",
 											"attestationObject": {
 												"@context": "https://schema.org",
 												"type": "DigitalDocument",
@@ -8914,7 +8910,6 @@
 							"examples": {
 								"attestationTransferRequestExample": {
 									"value": {
-										"holderIdentity": "did:iota:tst:0x06ae1034f9f4af1b408a0b54e877bb476259666a14f221400d3746aecefa7105",
 										"holderAddress": "tst1prctjk5ck0dutnsunnje6u90jk5htx03qznjjmkd6843pzltlgz87srjzzv"
 									}
 								}
@@ -12253,7 +12248,7 @@
 				}
 			}
 		},
-		"/aig/{id}/versions/{versionId}": {
+		"/aig/{id}/versions/{version}": {
 			"get": {
 				"operationId": "auditableItemGraphVersionGet",
 				"summary": "Get a graph vertex at a specific version",
@@ -12273,15 +12268,15 @@
 						"example": "aig:1234567890"
 					},
 					{
-						"name": "versionId",
-						"description": "The id of the version (changeset id) to get.",
+						"name": "version",
+						"description": "The version number to get.",
 						"in": "path",
 						"required": true,
 						"schema": {
 							"type": "string"
 						},
 						"style": "simple",
-						"example": "changeset:1234567890"
+						"example": "1"
 					},
 					{
 						"name": "accept",
@@ -12459,9 +12454,18 @@
 												"AuditableItemGraphVertexVersionList"
 											],
 											"itemListElement": [
-												0,
-												1,
-												2
+												{
+													"version": 0,
+													"dateCreated": "2024-08-22T11:55:16.271Z"
+												},
+												{
+													"version": 1,
+													"dateCreated": "2024-08-22T11:56:00.000Z"
+												},
+												{
+													"version": 2,
+													"dateCreated": "2024-08-22T11:57:00.000Z"
+												}
 											]
 										}
 									}
@@ -16164,18 +16168,13 @@
 				}
 			}
 		},
-		"/dataspace-data-plane/notify": {
+		"/dataspace-data-plane/inbox": {
 			"post": {
 				"operationId": "activityStreamNotify",
 				"summary": "Notify of a new Activity",
 				"tags": [
 					"Dataspace Data Plane"
 				],
-				"security": [
-					{
-						"jwtBearerAuthScheme": []
-					}
-				],
 				"requestBody": {
 					"description": "Activity Stream Notify Request.",
 					"required": true,
@@ -16236,24 +16235,6 @@
 							}
 						}
 					},
-					"401": {
-						"description": "You are not authorized to use the API or no credentials were supplied, see the content for more details.",
-						"content": {
-							"application/json": {
-								"schema": {
-									"$ref": "#/components/schemas/Error"
-								},
-								"examples": {
-									"exampleResponse": {
-										"value": {
-											"name": "UnauthorizedError",
-											"message": "errorMessage"
-										}
-									}
-								}
-							}
-						}
-					},
 					"422": {
 						"description": "The server cannot process the request, see the content for more details.",
 						"content": {
@@ -19831,6 +19812,7 @@
 											"correlationId": "cid",
 											"dateCreated": "2025-09-03T00:00:00.000Z",
 											"state": "REQUESTED",
+											"nodeIdentity": "did:iota:nodexyz",
 											"organizationIdentity": "did:iota:123456789abcdefghi"
 										}
 									}
@@ -19936,6 +19918,7 @@
 										"correlationId": "cid",
 										"dateCreated": "2025-09-03T00:00:00.000Z",
 										"state": "REQUESTED",
+										"nodeIdentity": "did:iota:nodexyz",
 										"organizationIdentity": "did:iota:123456789abcdefghi"
 									}
 								}
@@ -20144,6 +20127,7 @@
 												"correlationId": "cid",
 												"dateCreated": "2025-09-03T00:00:00.000Z",
 												"state": "REQUESTED",
+												"nodeIdentity": "did:iota:nodexyz",
 												"organizationIdentity": "did:iota:123456789abcdefghi"
 											}
 										]
@@ -20490,17 +20474,12 @@
 			"AttestationTransferRequest": {
 				"type": "object",
 				"properties": {
-					"holderIdentity": {
-						"type": "string",
-						"description": "The new holder identity."
-					},
 					"holderAddress": {
 						"type": "string",
 						"description": "The new holder address."
 					}
 				},
 				"required": [
-					"holderIdentity",
 					"holderAddress"
 				],
 				"description": "The parameters to be used in the transfer."
@@ -22151,32 +22130,16 @@
 				],
 				"description": "The body which contains the error."
 			},
-			"Notarization": {
-				"description": "Interface describing a notarization.",
+			"NotarizationCreateRequest": {
 				"type": "object",
 				"properties": {
-					"id": {
-						"type": "string",
-						"description": "The unique identifier of the notarization."
-					},
 					"mode": {
 						"$ref": "#/components/schemas/NotarizationMode"
 					},
-					"dateCreated": {
-						"type": "string",
-						"description": "The date and time when the notarization was created, in ISO 8601 format."
-					},
 					"dateModified": {
 						"type": "string",
 						"description": "The date and time when the notarization was last modified, in ISO 8601 format."
 					},
-					"data": {
-						"type": "array",
-						"items": {
-							"type": "number"
-						},
-						"description": "The notarization data as a byte array."
-					},
 					"immutableDescription": {
 						"type": "string",
 						"description": "An optional description of the notarization that cannot be changed after creation."
@@ -22196,32 +22159,40 @@
 					"transferLockDateTime": {
 						"type": "string",
 						"description": "An optional transfer lock date-time, in ISO 8601 format.\nUsed only in Dynamic Notarization."
+					},
+					"data": {
+						"type": "string",
+						"description": "The notarization data as a base64 encoded string."
+					},
+					"namespace": {
+						"type": "string",
+						"description": "The namespace of the connector to use for the notarization, defaults to component configured namespace."
 					}
 				},
 				"required": [
-					"id",
 					"mode",
-					"dateCreated",
 					"data"
-				]
+				],
+				"description": "The request data."
 			},
-			"NotarizationCreateRequest": {
+			"NotarizationGetResponse": {
 				"type": "object",
 				"properties": {
+					"id": {
+						"type": "string",
+						"description": "The unique identifier of the notarization."
+					},
 					"mode": {
 						"$ref": "#/components/schemas/NotarizationMode"
 					},
+					"dateCreated": {
+						"type": "string",
+						"description": "The date and time when the notarization was created, in ISO 8601 format."
+					},
 					"dateModified": {
 						"type": "string",
 						"description": "The date and time when the notarization was last modified, in ISO 8601 format."
 					},
-					"data": {
-						"type": "array",
-						"items": {
-							"type": "number"
-						},
-						"description": "The notarization data as a byte array."
-					},
 					"immutableDescription": {
 						"type": "string",
 						"description": "An optional description of the notarization that cannot be changed after creation."
@@ -22242,16 +22213,18 @@
 						"type": "string",
 						"description": "An optional transfer lock date-time, in ISO 8601 format.\nUsed only in Dynamic Notarization."
 					},
-					"namespace": {
+					"data": {
 						"type": "string",
-						"description": "The namespace of the connector to use for the notarization, defaults to component configured namespace."
+						"description": "The notarization data as a base64 encoded string."
 					}
 				},
 				"required": [
+					"id",
 					"mode",
+					"dateCreated",
 					"data"
 				],
-				"description": "The request data."
+				"description": "The response body."
 			},
 			"NotarizationMode": {
 				"description": "Supported notarization mode values.",
@@ -22279,6 +22252,57 @@
 				],
 				"description": "The request data."
 			},
+			"NotarizationUpdateRequest": {
+				"type": "object",
+				"properties": {
+					"id": {
+						"type": "string",
+						"description": "The unique identifier of the notarization."
+					},
+					"mode": {
+						"$ref": "#/components/schemas/NotarizationMode"
+					},
+					"dateCreated": {
+						"type": "string",
+						"description": "The date and time when the notarization was created, in ISO 8601 format."
+					},
+					"dateModified": {
+						"type": "string",
+						"description": "The date and time when the notarization was last modified, in ISO 8601 format."
+					},
+					"immutableDescription": {
+						"type": "string",
+						"description": "An optional description of the notarization that cannot be changed after creation."
+					},
+					"description": {
+						"type": "string",
+						"description": "An optional description of the notarization that can be modified until the notarization is locked."
+					},
+					"deleteLockDateTime": {
+						"type": "string",
+						"description": "An optional lock date, in ISO 8601 format, that prevents deletion until the date is reached.\nUsed only in Locked Notarization, it prevents the object from being deleted until the lock expires."
+					},
+					"transferLockUntilDestroyed": {
+						"type": "boolean",
+						"description": "An optional flag indicating transfer lock is active until the notarization is destroyed.\nUsed only in Dynamic Notarization."
+					},
+					"transferLockDateTime": {
+						"type": "string",
+						"description": "An optional transfer lock date-time, in ISO 8601 format.\nUsed only in Dynamic Notarization."
+					},
+					"data": {
+						"type": "string",
+						"description": "The notarization data as a base64 encoded string."
+					}
+				},
+				"required": [
+					"id",
+					"mode",
+					"dateCreated",
+					"data"
+				],
+				"description": "The request data."
+			},
 			"PapCreateRequest": {
 				"description": "The body of the request - the policy to create (id will be auto-generated if not provided).",
 				"type": "object",
@@ -22556,9 +22580,13 @@
 						"type": "string",
 						"description": "The tenant id this negotiation belongs to."
 					},
+					"nodeIdentity": {
+						"type": "string",
+						"description": "The node identity (DID) used to sign trust payloads."
+					},
 					"organizationIdentity": {
 						"type": "string",
-						"description": "Organization identity to be used when sending trust payloads."
+						"description": "Organization identity (the org DID of the user who initiated or received\nthe negotiation, when a user context was available)."
 					},
 					"offer": {
 						"$ref": "https://schema.twindev.org/dataspace-protocol/DataspaceProtocolOffer"
@@ -22626,7 +22654,7 @@
 					"correlationId",
 					"dateCreated",
 					"state",
-					"organizationIdentity"
+					"nodeIdentity"
 				]
 			},
 			"RefreshTokenRequest": {
@@ -23332,6 +23360,14 @@
 						"type": "string",
 						"description": "The identity associated with the payload."
 					},
+					"tenantId": {
+						"type": "string",
+						"description": "The tenant that issued the payload, if multi-tenancy was active at generation time."
+					},
+					"organizationId": {
+						"type": "string",
+						"description": "The organisation that issued the payload, if an authenticated user context was available at generation time."
+					},
 					"data": {
 						"type": "object",
 						"additionalProperties": {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@twin.org/node",
-	"version": "0.0.3-next.39",
+	"version": "0.0.3-next.41",
 	"description": "TWIN Node serving APIs using the specified configuration",
 	"repository": {
 		"type": "git",
@@ -14,7 +14,7 @@
 		"node": ">=20.0.0"
 	},
 	"dependencies": {
-		"@twin.org/node-core": "0.0.3-next.39"
+		"@twin.org/node-core": "0.0.3-next.41"
 	},
 	"bugs": {
 		"url": "git+https://github.com/iotaledger/node/issues"