@twin.org/node 0.0.3-next.27 → 0.0.3-next.28

package/README.md

@@ -1,40 +1,30 @@
 # TWIN Node
 
-A REST server implementation support the routes from various packages.
+This app provides the executable server runtime for delivering service workloads through a deployable Node.js application. It assembles shared runtime components into a practical entry point so teams can run, configure, and operate service endpoints with predictable behaviour.
 
-The OpenAPI Spec can be found here [TWIN Node OpenAPI Spec](https://editor-next.swagger.io/?url=https://raw.githubusercontent.com/twinfoundation/node/refs/heads/next/apps/node/docs/open-api/spec.json)
+It supports local development and production aligned operation while keeping configuration and extension patterns explicit. The generated OpenAPI specification offers a clear integration contract and helps maintain consistency across consuming systems.
 
-## Building and running the application
-
-To install the dependencies, perform a full build and start the server.
+## Installation
 
 ```shell
-npm install
-npm run dist
-npm start
+npm install -D @twin.org/node
 ```
 
-## Development mode
-
-Once you have performed a full build you can run the server in development mode, this will watch the TypeScript code, rebuild if there are any changes, and relaunch the server.
-
-```shell
-npm run dev
-```
+## Configuration
 
-## Extensions
+Configuration options are documented in [docs/configuration.md](docs/configuration.md)
 
-The TWIN Node supports dynamic extension loading from multiple sources (local files, npm packages, HTTPS URLs).
+## Deployment
 
-For complete extension documentation, including syntax, lifecycle hooks, and configuration options, see [Extension Loading](docs/configuration.md#extension-loading).
+Examples of how to deploy the app can be found in [docs/deployment.md](docs/deployment.md)
 
-## Configuration
+## Usage
 
-There are various options you can set through configuration, these can be found in [docs/configuration.md](docs/configuration.md)
+Usage of the tool is shown in the examples [docs/usage.md](docs/usage.md)
 
-## Deployment
+## Reference
 
-Examples of how to deploy the app can be found in [docs/deployment.md](docs/deployment.md)
+Detailed reference documentation for the API can be found in [docs/open-api/spec.json](docs/open-api/spec.json)
 
 ## Changelog
 

package/dist/locales/en.json

@@ -125,9 +125,10 @@
 			"atLeastOneNumber": "The value should contain at least one number",
 			"atLeastOneSpecialChar": "The value should contain at least one symbol",
 			"schema": {
-				"failedValidation": "The JSON schema failed validation, {message}",
 				"missingType": "Failed to validate as there is no handler for type \"{dataType}\""
 			},
+			"schemaFailed": "Schema failed validation, \"{message}\", keyword: \"{keyword}\", schemaPath: \"{schemaPath}\"",
+			"missingType": "The object must include at least one @type value",
 			"geo": {
 				"coordinatesLatitudeNumber": "The latitude value must be a number",
 				"coordinatesLatitudeRange": "The latitude value must be between -90 and 90",
@@ -560,7 +561,6 @@
 			"activityStillProcessing": "Activity is still being processed",
 			"noFailedTasksToRetry": "Activity has error status but no failed tasks to retry",
 			"invalidActivityGeneratorIdentity": "Invalid activity. No identity specified either on 'generator' or 'actor'",
-			"invalidActivity": "Invalid Activity. Expected fields not specified",
 			"unknownActivityLogEntryId": "Unknown Activity Log Entry Id \"{activityLogEntryId}\"",
 			"tooManyAppsRegistered": "There are several DS Apps registered for Dataset \"{datasetId}\"",
 			"noAppRegistered": "There are no DS Apps registered for Dataset \"{datasetId}\"",
@@ -687,7 +687,6 @@
 		},
 		"federatedCatalogueService": {
 			"datasetNotFound": "Dataset with ID \"{notFoundId}\" not found in the catalogue",
-			"datasetNotConformant": "Dataset \"{dataSetId}\" does not conform to DS Protocol specification",
 			"datasetIdInvalidUri": "Dataset @id \"{dataSetId}\" must be a valid URI (URN or URL) per DS Protocol",
 			"datasetMissingPublisher": "Dataset \"{dataSetId}\" is missing required dcterms:publisher property (needed for participant identification)",
 			"filterIndexCreationFailed": "Failed to create filter index for dataset \"{dataSetId}\" using filter \"{filterType}\"",
@@ -786,6 +785,13 @@
 			"gasStationTransactionFailed": "The gas station transaction failed",
 			"dryRunFailed": "The dry run execution failed"
 		},
+		"iotaIdentityUtils": {
+			"getControllerCapInfoFailed": "Getting the controller capability info for the identity failed",
+			"identityNotFound": "The identity could not be found \"{notFoundId}\"",
+			"identityDeleted": "The identity \"{identityId}\" has been deleted and cannot be used for minting",
+			"controllerTokenNotFound": "No controller token found for the identity \"{notFoundId}\" with the provided controller address",
+			"unexpectedSignerCall": "The no-op signer was unexpectedly called during a read-only identity lookup"
+		},
 		"iotaSmartContractUtils": {
 			"migrationFailed": "Smart contract migration failed",
 			"migrateSmartContractFailed": "Failed to migrate smart contract for object \"{objectId}\"",

package/docs/changelog.md

@@ -1,4 +1,18 @@
-# @twin.org/node - Changelog
+# Changelog
+
+## [0.0.3-next.28](https://github.com/twinfoundation/node/compare/node-v0.0.3-next.27...node-v0.0.3-next.28) (2026-03-12)
+
+
+### Miscellaneous Chores
+
+* **node:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/node-core bumped from 0.0.3-next.27 to 0.0.3-next.28
 
 ## [0.0.3-next.27](https://github.com/twinfoundation/node/compare/node-v0.0.3-next.26...node-v0.0.3-next.27) (2026-03-09)
 

package/docs/configuration.md

@@ -1,4 +1,4 @@
-# @twin.org/node - Configuration
+# Node Configuration
 
 ## Extension Loading
 

package/docs/deployment-docker.md

@@ -1,4 +1,4 @@
-# @twin.org/node - Deployment Docker
+# Node Deployment Docker
 
 ## Docker Building
 

package/docs/deployment-ec2.md

@@ -1,4 +1,4 @@
-# @twin.org/node - Deployment Amazon AWS EC2
+# Node Deployment Amazon AWS EC2
 
 ## Amazon AWS EC2 Instance
 

package/docs/deployment.md

@@ -1,4 +1,4 @@
-# @twin.org/node - Deployment
+# Node Deployment
 
 - [Docker](./deployment-docker.md) - Guide to deploying with docker.
 - [Amazon AWS EC2](./deployment-ec2.md) - Guide to deploying with Amazon AWS EC2.

package/docs/open-api/spec.json

@@ -13690,8 +13690,8 @@
 													"dcterms:title": "Energy Consumption Data",
 													"dcterms:description": "Historical energy consumption data",
 													"hasPolicy": {
+														"@id": "urn:uuid:policy-456",
 														"@type": "Offer",
-														"uid": "urn:uuid:policy-456",
 														"assigner": "did:example:data-provider-789"
 													},
 													"distribution": {
@@ -14296,11 +14296,6 @@
 				"tags": [
 					"Transfer Process"
 				],
-				"security": [
-					{
-						"jwtBearerAuthScheme": []
-					}
-				],
 				"responses": {
 					"200": {
 						"description": "The rest request ended in success with no data.",
@@ -14333,24 +14328,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"
-										}
-									}
-								}
-							}
-						}
-					},
 					"500": {
 						"description": "The server has encountered a situation it does not know how to handle, see the content for more details.",
 						"content": {
@@ -14391,11 +14368,6 @@
 						"style": "simple"
 					}
 				],
-				"security": [
-					{
-						"jwtBearerAuthScheme": []
-					}
-				],
 				"responses": {
 					"200": {
 						"description": "The rest request ended in success with no data.",
@@ -14428,24 +14400,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"
-										}
-									}
-								}
-							}
-						}
-					},
 					"500": {
 						"description": "The server has encountered a situation it does not know how to handle, see the content for more details.",
 						"content": {
@@ -14486,11 +14440,6 @@
 						"style": "simple"
 					}
 				],
-				"security": [
-					{
-						"jwtBearerAuthScheme": []
-					}
-				],
 				"responses": {
 					"200": {
 						"description": "The rest request ended in success with no data.",
@@ -14523,24 +14472,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"
-										}
-									}
-								}
-							}
-						}
-					},
 					"500": {
 						"description": "The server has encountered a situation it does not know how to handle, see the content for more details.",
 						"content": {
@@ -14581,11 +14512,6 @@
 						"style": "simple"
 					}
 				],
-				"security": [
-					{
-						"jwtBearerAuthScheme": []
-					}
-				],
 				"responses": {
 					"200": {
 						"description": "The rest request ended in success with no data.",
@@ -14618,24 +14544,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"
-										}
-									}
-								}
-							}
-						}
-					},
 					"500": {
 						"description": "The server has encountered a situation it does not know how to handle, see the content for more details.",
 						"content": {
@@ -14676,11 +14584,6 @@
 						"style": "simple"
 					}
 				],
-				"security": [
-					{
-						"jwtBearerAuthScheme": []
-					}
-				],
 				"responses": {
 					"200": {
 						"description": "The rest request ended in success with no data.",
@@ -14713,24 +14616,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"
-										}
-									}
-								}
-							}
-						}
-					},
 					"500": {
 						"description": "The server has encountered a situation it does not know how to handle, see the content for more details.",
 						"content": {
@@ -14771,11 +14656,6 @@
 						"style": "simple"
 					}
 				],
-				"security": [
-					{
-						"jwtBearerAuthScheme": []
-					}
-				],
 				"responses": {
 					"200": {
 						"description": "The rest request ended in success with no data.",
@@ -14808,24 +14688,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"
-										}
-									}
-								}
-							}
-						}
-					},
 					"500": {
 						"description": "The server has encountered a situation it does not know how to handle, see the content for more details.",
 						"content": {
@@ -14865,7 +14727,7 @@
 					"content": {
 						"application/json": {
 							"schema": {
-								"$ref": "#/components/schemas/PapCreateRequest"
+								"$ref": "https://schema.twindev.org/json-ld/JsonLdObjectWithOptionalAtId<DataspaceProtocolPolicy>"
 							},
 							"examples": {
 								"papCreateRequestExample": {
@@ -15046,7 +14908,7 @@
 											{
 												"@context": "http://www.w3.org/ns/odrl.jsonld",
 												"@type": "Set",
-												"uid": "urn:rights-management:abc123def456",
+												"@id": "urn:rights-management:abc123def456",
 												"permission": [
 													{
 														"target": "http://example.com/asset/1",
@@ -15151,14 +15013,14 @@
 					"content": {
 						"application/json": {
 							"schema": {
-								"$ref": "https://schema.twindev.org/w3c-odrl/OdrlPolicy"
+								"$ref": "https://schema.twindev.org/dataspace-protocol/DataspaceProtocolPolicy"
 							},
 							"examples": {
 								"papUpdateRequestExample": {
 									"value": {
 										"@context": "http://www.w3.org/ns/odrl.jsonld",
 										"@type": "Set",
-										"uid": "urn:rights-management:abc123def456",
+										"@id": "urn:rights-management:abc123def456",
 										"permission": [
 											{
 												"target": "http://example.com/asset/2",
@@ -15264,14 +15126,14 @@
 						"content": {
 							"application/json": {
 								"schema": {
-									"$ref": "https://schema.twindev.org/w3c-odrl/OdrlPolicy"
+									"$ref": "https://schema.twindev.org/dataspace-protocol/DataspaceProtocolPolicy"
 								},
 								"examples": {
 									"papGetResponseExample": {
 										"value": {
 											"@context": "http://www.w3.org/ns/odrl.jsonld",
 											"@type": "Set",
-											"uid": "urn:rights-management:abc123def456",
+											"@id": "urn:rights-management:abc123def456",
 											"permission": [
 												{
 													"target": "http://example.com/asset/1",
@@ -15462,14 +15324,14 @@
 						"content": {
 							"application/json": {
 								"schema": {
-									"$ref": "https://schema.twindev.org/w3c-odrl/OdrlAgreement"
+									"$ref": "https://schema.twindev.org/dataspace-protocol/DataspaceProtocolAgreement"
 								},
 								"examples": {
 									"papGetResponseExample": {
 										"value": {
 											"@context": "http://www.w3.org/ns/odrl.jsonld",
 											"@type": "Agreement",
-											"uid": "urn:rights-management:abc123def456",
+											"@id": "urn:rights-management:abc123def456",
 											"permission": [
 												{
 													"target": "http://example.com/asset/1",
@@ -15575,14 +15437,14 @@
 						"content": {
 							"application/json": {
 								"schema": {
-									"$ref": "https://schema.twindev.org/w3c-odrl/OdrlOffer"
+									"$ref": "https://schema.twindev.org/dataspace-protocol/DataspaceProtocolOffer"
 								},
 								"examples": {
 									"papGetResponseExample": {
 										"value": {
 											"@context": "http://www.w3.org/ns/odrl.jsonld",
 											"@type": "Offer",
-											"uid": "urn:rights-management:abc123def456",
+											"@id": "urn:rights-management:abc123def456",
 											"permission": [
 												{
 													"target": "http://example.com/asset/1",
@@ -15688,14 +15550,14 @@
 						"content": {
 							"application/json": {
 								"schema": {
-									"$ref": "https://schema.twindev.org/w3c-odrl/OdrlSet"
+									"$ref": "https://schema.twindev.org/dataspace-protocol/DataspaceProtocolSet"
 								},
 								"examples": {
 									"papGetResponseExample": {
 										"value": {
 											"@context": "http://www.w3.org/ns/odrl.jsonld",
 											"@type": "Set",
-											"uid": "urn:rights-management:abc123def456",
+											"@id": "urn:rights-management:abc123def456",
 											"permission": [
 												{
 													"target": "http://example.com/asset/1",
@@ -15922,9 +15784,8 @@
 										"@type": "ContractRequestMessage",
 										"consumerPid": "urn:contract-negotiation:22aa11bb.......ffff",
 										"offer": {
-											"@context": "http://www.w3.org/ns/odrl.jsonld",
 											"@type": "Offer",
-											"uid": "urn:offer-1",
+											"@id": "urn:offer-1",
 											"assigner": "urn:provider:node:1"
 										}
 									}
@@ -16036,9 +15897,8 @@
 										"@type": "ContractRequestMessage",
 										"consumerPid": "urn:contract-negotiation:22aa11bb.......ffff",
 										"offer": {
-											"@context": "http://www.w3.org/ns/odrl.jsonld",
 											"@type": "Offer",
-											"uid": "urn:offer-1",
+											"@id": "urn:offer-1",
 											"assigner": "urn:provider:node:1"
 										}
 									}
@@ -16496,9 +16356,8 @@
 										"providerPid": "urn:contract-negotiation:00aa11bb.......ffff",
 										"consumerPid": "urn:contract-negotiation:22aa11bb.......ffff",
 										"offer": {
-											"@context": "http://www.w3.org/ns/odrl.jsonld",
 											"@type": "Offer",
-											"uid": "urn:offer-1",
+											"@id": "urn:offer-1",
 											"assigner": "urn:provider:node:1"
 										}
 									}
@@ -16610,9 +16469,8 @@
 										"providerPid": "urn:contract-negotiation:00aa11bb.......ffff",
 										"consumerPid": "urn:contract-negotiation:22aa11bb.......ffff",
 										"offer": {
-											"@context": "http://www.w3.org/ns/odrl.jsonld",
 											"@type": "Offer",
-											"uid": "urn:offer-1",
+											"@id": "urn:offer-1",
 											"assigner": "urn:provider:node:1"
 										}
 									}
@@ -16744,9 +16602,8 @@
 										"providerPid": "urn:contract-negotiation:00aa11bb.......ffff",
 										"consumerPid": "urn:contract-negotiation:22aa11bb.......ffff",
 										"agreement": {
-											"@context": "http://www.w3.org/ns/odrl.jsonld",
 											"@type": "Agreement",
-											"uid": "urn:offer-1",
+											"@id": "urn:offer-1",
 											"assigner": "urn:provider:node:1",
 											"assignee": "urn:consumer:node:1"
 										}
@@ -17410,7 +17267,6 @@
 						"$ref": "#/components/schemas/ActivityStreamsContextType"
 					},
 					"type": {
-						"description": "Object or array data type",
 						"anyOf": [
 							{
 								"$ref": "#/components/schemas/ActivityStreamsTypes"
@@ -17431,11 +17287,13 @@
 									]
 								}
 							}
-						]
+						],
+						"description": "Activity Type."
 					},
 					"id": {
 						"type": "string",
-						"description": "Global identifier."
+						"description": "Global identifier.",
+						"format": "uri"
 					},
 					"name": {
 						"anyOf": [
@@ -17553,23 +17411,28 @@
 					},
 					"published": {
 						"type": "string",
-						"description": "Published date-time."
+						"description": "Published date-time.",
+						"format": "date-time"
 					},
 					"updated": {
 						"type": "string",
-						"description": "The date and time at which the object was updated."
+						"description": "Updated date-time.",
+						"format": "date-time"
 					},
 					"startTime": {
 						"type": "string",
-						"description": "Start time."
+						"description": "Start time.",
+						"format": "date-time"
 					},
 					"endTime": {
 						"type": "string",
-						"description": "End time."
+						"description": "End time.",
+						"format": "date-time"
 					},
 					"duration": {
 						"type": "string",
-						"description": "Duration."
+						"description": "Duration.",
+						"format": "duration"
 					},
 					"generator": {
 						"description": "Object or array data type",
@@ -18058,8 +17921,11 @@
 					},
 					{
 						"type": "array",
-						"minItems": 1,
+						"minItems": 2,
 						"prefixItems": [
+							{
+								"$ref": "https://schema.twindev.org/json-ld/JsonLdContextDefinitionElement"
+							},
 							{
 								"type": "string",
 								"const": "https://www.w3.org/ns/activitystreams"
@@ -18071,11 +17937,14 @@
 					},
 					{
 						"type": "array",
-						"minItems": 1,
+						"minItems": 2,
 						"prefixItems": [
 							{
 								"type": "string",
 								"const": "https://www.w3.org/ns/activitystreams"
+							},
+							{
+								"$ref": "https://schema.twindev.org/json-ld/JsonLdContextDefinitionElement"
 							}
 						],
 						"items": {
@@ -18085,151 +17954,6 @@
 				],
 				"description": "The Activity Streams JSON-LD context type."
 			},
-			"ActivityStreamsLinkTypes": {
-				"anyOf": [
-					{
-						"type": "string",
-						"const": "Link",
-						"description": "Link"
-					},
-					{
-						"type": "string",
-						"const": "Mention",
-						"description": "Mention"
-					}
-				],
-				"description": "The link types concerning Activity Streams."
-			},
-			"ActivityStreamsObjectTypes": {
-				"anyOf": [
-					{
-						"type": "string",
-						"const": "Object",
-						"description": "Object"
-					},
-					{
-						"type": "string",
-						"const": "Activity",
-						"description": "Activity"
-					},
-					{
-						"type": "string",
-						"const": "IntransitiveActivity",
-						"description": "IntransitiveActivity"
-					},
-					{
-						"type": "string",
-						"const": "Collection",
-						"description": "Collection"
-					},
-					{
-						"type": "string",
-						"const": "OrderedCollection",
-						"description": "OrderedCollection"
-					},
-					{
-						"type": "string",
-						"const": "CollectionPage",
-						"description": "CollectionPage"
-					},
-					{
-						"type": "string",
-						"const": "OrderedCollectionPage",
-						"description": "OrderedCollectionPage"
-					},
-					{
-						"type": "string",
-						"const": "Actor",
-						"description": "Actor"
-					},
-					{
-						"type": "string",
-						"const": "Application",
-						"description": "Application"
-					},
-					{
-						"type": "string",
-						"const": "Group",
-						"description": "Group"
-					},
-					{
-						"type": "string",
-						"const": "Organization",
-						"description": "Organization"
-					},
-					{
-						"type": "string",
-						"const": "Person",
-						"description": "Person"
-					},
-					{
-						"type": "string",
-						"const": "Service",
-						"description": "Service"
-					},
-					{
-						"type": "string",
-						"const": "Article",
-						"description": "Article"
-					},
-					{
-						"type": "string",
-						"const": "Audio",
-						"description": "Audio"
-					},
-					{
-						"type": "string",
-						"const": "Document",
-						"description": "Document"
-					},
-					{
-						"type": "string",
-						"const": "Event",
-						"description": "Event"
-					},
-					{
-						"type": "string",
-						"const": "Image",
-						"description": "Image"
-					},
-					{
-						"type": "string",
-						"const": "Note",
-						"description": "Note"
-					},
-					{
-						"type": "string",
-						"const": "Page",
-						"description": "Page"
-					},
-					{
-						"type": "string",
-						"const": "Place",
-						"description": "Place"
-					},
-					{
-						"type": "string",
-						"const": "Profile",
-						"description": "Profile"
-					},
-					{
-						"type": "string",
-						"const": "Relationship",
-						"description": "Relationship"
-					},
-					{
-						"type": "string",
-						"const": "Tombstone",
-						"description": "Tombstone"
-					},
-					{
-						"type": "string",
-						"const": "Video",
-						"description": "Video"
-					}
-				],
-				"description": "The object types concerning Activity Streams."
-			},
 			"ActivityStreamsTypes": {
 				"anyOf": [
 					{
@@ -19776,222 +19500,10 @@
 				],
 				"description": "The body which contains the error."
 			},
-			"PapCreateRequest": {
-				"type": "object",
-				"properties": {
-					"uid": {
-						"type": "string"
-					},
-					"@context": {
-						"$ref": "https://schema.twindev.org/w3c-odrl/OdrlContextType"
-					},
-					"@type": {
-						"$ref": "https://schema.twindev.org/w3c-odrl/PolicyType"
-					},
-					"profile": {
-						"anyOf": [
-							{
-								"type": "string"
-							},
-							{
-								"type": "array",
-								"items": {
-									"type": "string"
-								}
-							}
-						],
-						"description": "The profile(s) this policy conforms to. IRIs identifying the ODRL Profile(s)."
-					},
-					"assigner": {
-						"anyOf": [
-							{
-								"type": "string"
-							},
-							{
-								"$ref": "https://schema.twindev.org/w3c-odrl/OdrlParty"
-							},
-							{
-								"$ref": "https://schema.twindev.org/w3c-odrl/OdrlPartyCollection"
-							},
-							{
-								"type": "array",
-								"items": {
-									"anyOf": [
-										{
-											"type": "string"
-										},
-										{
-											"$ref": "https://schema.twindev.org/w3c-odrl/OdrlParty"
-										},
-										{
-											"$ref": "https://schema.twindev.org/w3c-odrl/OdrlPartyCollection"
-										}
-									]
-								}
-							}
-						],
-						"description": "The assigner of the policy. Applies to all rules unless overridden at rule level."
-					},
-					"assignee": {
-						"anyOf": [
-							{
-								"type": "string"
-							},
-							{
-								"$ref": "https://schema.twindev.org/w3c-odrl/OdrlParty"
-							},
-							{
-								"$ref": "https://schema.twindev.org/w3c-odrl/OdrlPartyCollection"
-							},
-							{
-								"type": "array",
-								"items": {
-									"anyOf": [
-										{
-											"type": "string"
-										},
-										{
-											"$ref": "https://schema.twindev.org/w3c-odrl/OdrlParty"
-										},
-										{
-											"$ref": "https://schema.twindev.org/w3c-odrl/OdrlPartyCollection"
-										}
-									]
-								}
-							}
-						],
-						"description": "The assignee of the policy. Applies to all rules unless overridden at rule level."
-					},
-					"target": {
-						"anyOf": [
-							{
-								"type": "string"
-							},
-							{
-								"$ref": "https://schema.twindev.org/w3c-odrl/OdrlAsset"
-							},
-							{
-								"$ref": "https://schema.twindev.org/w3c-odrl/OdrlAssetCollection"
-							},
-							{
-								"type": "array",
-								"items": {
-									"anyOf": [
-										{
-											"type": "string"
-										},
-										{
-											"$ref": "https://schema.twindev.org/w3c-odrl/OdrlAsset"
-										},
-										{
-											"$ref": "https://schema.twindev.org/w3c-odrl/OdrlAssetCollection"
-										}
-									]
-								}
-							}
-						],
-						"description": "The target asset for the rule."
-					},
-					"action": {
-						"anyOf": [
-							{
-								"$ref": "https://schema.twindev.org/w3c-odrl/ActionType"
-							},
-							{
-								"type": "string"
-							},
-							{
-								"$ref": "https://schema.twindev.org/w3c-odrl/OdrlAction"
-							},
-							{
-								"type": "array",
-								"items": {
-									"anyOf": [
-										{
-											"$ref": "https://schema.twindev.org/w3c-odrl/ActionType"
-										},
-										{
-											"type": "string"
-										},
-										{
-											"$ref": "https://schema.twindev.org/w3c-odrl/OdrlAction"
-										}
-									]
-								}
-							}
-						],
-						"description": "The action associated with the rule."
-					},
-					"inheritFrom": {
-						"anyOf": [
-							{
-								"type": "string"
-							},
-							{
-								"type": "array",
-								"items": {
-									"type": "string"
-								}
-							}
-						],
-						"description": "The parent policy(ies) this policy inherits from. IRIs identifying the parent Policy(ies)."
-					},
-					"conflict": {
-						"$ref": "https://schema.twindev.org/w3c-odrl/ConflictStrategyType"
-					},
-					"permission": {
-						"anyOf": [
-							{
-								"$ref": "https://schema.twindev.org/w3c-odrl/OdrlPermission"
-							},
-							{
-								"type": "array",
-								"items": {
-									"$ref": "https://schema.twindev.org/w3c-odrl/OdrlPermission"
-								}
-							}
-						],
-						"description": "The permissions in the policy. At least one of permission, prohibition, or obligation must be present."
-					},
-					"prohibition": {
-						"anyOf": [
-							{
-								"$ref": "https://schema.twindev.org/w3c-odrl/OdrlProhibition"
-							},
-							{
-								"type": "array",
-								"items": {
-									"$ref": "https://schema.twindev.org/w3c-odrl/OdrlProhibition"
-								}
-							}
-						],
-						"description": "The prohibitions in the policy. At least one of permission, prohibition, or obligation must be present."
-					},
-					"obligation": {
-						"anyOf": [
-							{
-								"$ref": "https://schema.twindev.org/w3c-odrl/OdrlDuty"
-							},
-							{
-								"type": "array",
-								"items": {
-									"$ref": "https://schema.twindev.org/w3c-odrl/OdrlDuty"
-								}
-							}
-						],
-						"description": "The obligations in the policy. At least one of permission, prohibition, or obligation must be present."
-					}
-				},
-				"required": [
-					"@context",
-					"@type"
-				],
-				"description": "The body of the request - the policy to create (uid will be auto-generated)."
-			},
 			"PapQueryResponse": {
 				"type": "array",
 				"items": {
-					"$ref": "https://schema.twindev.org/w3c-odrl/OdrlPolicy"
+					"$ref": "https://schema.twindev.org/dataspace-protocol/DataspaceProtocolPolicy"
 				},
 				"description": "The body of the response."
 			},
@@ -20048,10 +19560,10 @@
 						"description": "Organization identity to be used when sending trust payloads."
 					},
 					"offer": {
-						"$ref": "https://schema.twindev.org/w3c-odrl/OdrlOffer"
+						"$ref": "https://schema.twindev.org/dataspace-protocol/DataspaceProtocolOffer"
 					},
 					"agreement": {
-						"$ref": "https://schema.twindev.org/w3c-odrl/OdrlAgreement"
+						"$ref": "https://schema.twindev.org/dataspace-protocol/DataspaceProtocolAgreement"
 					},
 					"trustVerificationInfo": {
 						"$ref": "#/components/schemas/TrustVerificationInfo"

package/docs/{examples.md → usage.md}

@@ -1,34 +1,85 @@
-# Examples
+# Node Usage
 
-## CLI Usage
+These commands cover local installation, on demand execution, and a complete bootstrap flow that can be reused in deployment scripts.
 
-To run the command from the package either:
+## Running
 
-Install `@twin.org/node@next` and use the following command:
+To install and run the CLI locally use the following commands:
 
 ```shell
-twin-node --help
+npm install @twin.org/node -g
+twin-node
 ```
 
-or
+or run directly using NPX:
 
 ```shell
-npx "@twin.org/node@next" --help
+npx "@twin.org/node"
 ```
 
-### Display help listing all commands
+## Help
 
-```shell
-twin-node --help
+```text
+🌩️  TWIN Node v0.0.3-next.26
+
+Command: help
+
+All the commands available are listed below, for more information use the --help option with a specific command.
+bootstrap-legacy: Bootstrap in legacy mode for backwards compatibility, **will be deprecated in future versions**
+identity-create: Create an identity
+identity-import: Import an identity
+identity-verification-method-create: Create an identity verification method
+identity-verification-method-import: Import an identity verification method
+identity-verifiable-credential-create: Create a verifiable credential
+node-set-identity: Set the node identity
+node-set-tenant: Set the node tenant
+tenant-create: Create a tenant with associated api key
+tenant-import: Import a tenant with associated api key
+tenant-update: Update a tenant with associated api key
+user-create: Create a user
+user-update: Update a user
+vault-key-create: Create a vault key for an identity
+vault-key-import: Import a vault key for an identity
 ```
 
-### Display help for specific command
+## identity-create --help
 
-```shell
-twin-node command --help
+```text
+identity-create: Create an identity
+
+env-prefix: (string, optional)
+Prefix to use for standard .env files e.g. TWIN_.
+
+mnemonic: (string, 24 words, optional)
+The mnemonic phrase to use for the identity. If not provided, a random mnemonic will be generated.
+
+identity: (string, did, optional)
+The DID of the identity to create. If not provided, a new DID will be generated.
+
+controller: (string, did, optional)
+The controller DID for the identity. If not provided, the identity will be its own controller.
+
+fund-wallet: (boolean, default: 'false', optional)
+Whether to fund the wallet associated with the identity from a faucet.
+
+load-env: (string, optional)
+Comma separated list of paths to .env files to read input parameters from.
+
+output-json: (string, optional)
+Path to a .json file to store the command output.
+
+output-env: (string, optional)
+Path to a .env file to store the command output.
+
+output-env-prefix: (string, optional)
+Prefix to use for variables in the output .env file.
+
+Example: identity-create --mnemonic="..." --fund-wallet=true
 ```
 
-### Bootstrap legacy mode **will be deprecated in future versions**
+## Example
+
+### Bootstrap legacy mode will be deprecated in future versions
 
 ```shell
 twin-node bootstrap-legacy --load-env=".env.bootstrap-legacy"
@@ -40,7 +91,7 @@ twin-node bootstrap-legacy --load-env=".env.bootstrap-legacy"
 twin-node identity-create --fund-wallet=true --output-json="node-identity.json" --output-env="node-identity.env" --output-env-prefix=node
 ```
 
-Alternatively import existing details:
+### Import existing identity details
 
 ```shell
 twin-node identity-import --load-env="my-identity.env" --identity=!MY_DID --mnemonic=!MY_MNEMONIC
@@ -58,13 +109,13 @@ twin-node node-set-identity --load-env="node-identity.env" --identity=!NODE_DID
 twin-node vault-key-create --load-env="node-identity.env" --identity=!NODE_DID --key-id=!TWIN_AUTH_SIGNING_KEY_ID --output-json="node-auth-key.json" --output-env="node-auth-key.env"
 ```
 
-Alternatively import existing details:
+### Import existing authentication signing key details
 
 ```shell
 twin-node vault-key-import --load-env="node-identity.env,node-auth-key.json" --identity=!NODE_DID --key-id=!TWIN_AUTH_SIGNING_KEY_ID --key-type=!KEY_TYPE --private-key-hex=!PRIVATE_KEY_HEX
 ```
 
-### Add a key associated with the node identity for use by the synchronised storage blob encryption
+### Add a key associated with the node identity for use by synchronised storage blob encryption
 
 ```shell
 twin-node vault-key-create --load-env="node-identity.env" --identity=!NODE_DID --key-id=!TWIN_SYNCHRONISED_STORAGE_BLOB_STORAGE_ENCRYPTION_KEY_ID --key-type=ChaCha20Poly1305 --output-json="node-synchronised-storage-encryption-key.json" --output-env="node-synchronised-storage-encryption-key.env"
@@ -76,7 +127,7 @@ twin-node vault-key-create --load-env="node-identity.env" --identity=!NODE_DID -
 twin-node vault-key-import --load-env="node-identity.env,my-key.json" --identity=!NODE_DID --key-id=!TWIN_AUTH_SIGNING_KEY_ID --key-type=!KEY_TYPE --private-key-hex=!PRIVATE_KEY_HEX
 ```
 
-Alternatively import existing details:
+### Create a tenant to be used by the node
 
 ```shell
 twin-node tenant-create --label="node" --public-origin="https://api.example.com" --output-env-prefix=node --output-json="node-tenant.json" --output-env="node-tenant.env"
@@ -94,25 +145,25 @@ twin-node tenant-import --load-env="node-tenant.json" --tenant-id=!NODE_TENANT_I
 twin-node tenant-update --load-env="node-tenant.json" --tenant-id=!NODE_TENANT_ID --label="New Label"
 ```
 
-### Associated the tenant with the node
+### Associate the tenant with the node
 
 ```shell
 twin-node node-set-tenant --load-env="node-tenant.env" --tenant-id=!NODE_TENANT_ID
 ```
 
-### Create an organization identity
+### Create an organisation identity
 
 ```shell
-twin-node identity-create --load-env="node-identity.env" --fund-wallet=true --output-json="organization-identity.json" --output-env="organization-identity.env"  --output-env-prefix=organization
+twin-node identity-create --load-env="node-identity.env" --fund-wallet=true --output-json="organization-identity.json" --output-env="organization-identity.env" --output-env-prefix=organization
 ```
 
-### Add a verification method to the organization identity for attestation
+### Add a verification method to the organisation identity for attestation
 
 ```shell
 twin-node identity-verification-method-create --load-env="node-identity.env,organization-identity.env" --identity=!ORGANIZATION_DID --controller=!NODE_DID --verification-method-id=!TWIN_ATTESTATION_VERIFICATION_METHOD_ID --output-json="organization-attestation.json" --output-env="organization-attestation.env"
 ```
 
-Alternatively import existing details:
+### Import an attestation verification method for the organisation identity
 
 ```shell
 twin-node identity-verification-method-import --load-env="node-identity.env,organization-identity.env,organization-attestation.env" --identity=!ORGANIZATION_DID --controller=!NODE_DID --verification-method-id=!DID_VERIFICATION_METHOD_ID --private-key-hex=!DID_VERIFICATION_METHOD_PRIVATE_KEY_HEX
@@ -124,25 +175,25 @@ twin-node identity-verification-method-import --load-env="node-identity.env,orga
 twin-node identity-verifiable-credential-create --load-env="organization-identity.env,organization-attestation.env" --identity=!ORGANIZATION_DID --verification-method-id=!TWIN_ATTESTATION_VERIFICATION_METHOD_ID --subject-json="subject.json" --output-json="organization-attestation-credential.json" --output-env="organization-attestation-credential.env"
 ```
 
-### Add a verification method to the organization identity for immutable proofs
+### Add a verification method to the organisation identity for immutable proofs
 
 ```shell
 twin-node identity-verification-method-create --load-env="node-identity.env,organization-identity.env" --identity=!ORGANIZATION_DID --controller=!NODE_DID --verification-method-id=!TWIN_IMMUTABLE_PROOF_VERIFICATION_METHOD_ID --output-json="organization-immutable-proof.json" --output-env="organization-immutable-proof.env"
 ```
 
-### Add a verification method to the organization identity for trust verification
+### Add a verification method to the organisation identity for trust verification
 
 ```shell
 twin-node identity-verification-method-create --load-env="node-identity.env,organization-identity.env" --identity=!ORGANIZATION_DID --controller=!NODE_DID --verification-method-id=!TWIN_TRUST_VERIFICATION_METHOD_ID --output-json="organization-trust.json" --output-env="organization-trust.env"
 ```
 
-### Add a key associated with the organization to be used for blob encryption
+### Add a key associated with the organisation to be used for blob encryption
 
 ```shell
 twin-node vault-key-create --load-env="organization-identity.env" --identity=!ORGANIZATION_DID --key-id=!TWIN_BLOB_STORAGE_ENCRYPTION_KEY_ID --key-type=ChaCha20Poly1305 --output-json="organization-blob-encryption.json" --output-env="organization-blob-encryption.env"
 ```
 
-### Create an identity associated with the organization
+### Create an identity associated with the organisation
 
 ```shell
 twin-node identity-create --load-env="organization-identity.env" --controller=!ORGANIZATION_DID --output-json="user-identity.json" --output-env="user-identity.env" --output-env-prefix=user

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@twin.org/node",
-	"version": "0.0.3-next.27",
+	"version": "0.0.3-next.28",
 	"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.27"
+		"@twin.org/node-core": "0.0.3-next.28"
 	},
 	"bugs": {
 		"url": "git+https://github.com/twinfoundation/node/issues"