@twin.org/standards-dataspace-protocol 0.0.3-next.3 → 0.0.3-next.30

package/docs/reference/interfaces/IDataspaceProtocolDataService.md

@@ -0,0 +1,72 @@
+# Interface: IDataspaceProtocolDataService
+
+Data Service interface compliant with Eclipse Data Space Protocol.
+
+This interface extends IDataService  and enforces DS Protocol-specific requirements
+by overriding properties with more specific types and constraints.
+
+**Requirements per DS Protocol:**
+- `@id` MUST be present for dataset identification (REQUIRED)
+- endpointURL MUST be present (REQUIRED)
+
+**Type System Design:**
+- Interface extension allows TypeScript to override inherited property types
+- Standards packages (@twin.org/standards-w3c-*) follow W3C specs exactly
+- DS Protocol-specific constraints are defined here
+
+## See
+
+ - https://eclipse-dataspace-protocol-base.github.io/DataspaceProtocol/2025-1-err1/#lower-level-types
+ - https://www.w3.org/TR/vocab-dcat-3/ - W3C DCAT v3 spec
+
+## Extends
+
+- `Omit`\<`IDcatDataService`, `"@type"` \| `"@context"` \| `"dcat:servesDataset"` \| `"dcat:endpointURL"`\>
+
+## Indexable
+
+\[`key`: `string`\]: `string` \| `number` \| `boolean` \| `IJsonLdContextDefinition` \| `string`[] \| `IJsonLdNodeObject` \| `IJsonLdGraphObject` \| `object` & `object` \| `object` & `object` \| `object` & `object` \| `IJsonLdListObject` \| `IJsonLdSetObject` \| `IJsonLdNodePrimitive`[] \| `IJsonLdLanguageMap` \| `IJsonLdIndexMap` \| `IJsonLdNodeObject`[] \| `IJsonLdIdMap` \| `IJsonLdTypeMap` \| `IJsonLdContextDefinitionElement`[] \| `IJsonLdJsonObject` \| `IJsonLdJsonObject`[] \| \{\[`key`: `string`\]: `string`; \} \| `null` \| `undefined`
+
+\[`key`: `number`\]: `string` \| `number` \| `boolean` \| `IJsonLdContextDefinition` \| `string`[] \| `IJsonLdNodeObject` \| `IJsonLdGraphObject` \| `object` & `object` \| `object` & `object` \| `object` & `object` \| `IJsonLdListObject` \| `IJsonLdSetObject` \| `IJsonLdNodePrimitive`[] \| `IJsonLdLanguageMap` \| `IJsonLdIndexMap` \| `IJsonLdNodeObject`[] \| `IJsonLdIdMap` \| `IJsonLdTypeMap` \| `IJsonLdContextDefinitionElement`[] \| `IJsonLdJsonObject` \| `IJsonLdJsonObject`[] \| \{\[`key`: `string`\]: `string`; \} \| `null` \| `undefined`
+
+## Properties
+
+### @context
+
+> **@context**: [`DataspaceProtocolContextType`](../type-aliases/DataspaceProtocolContextType.md)
+
+LD Context. Required per Eclipse Data Space Protocol.
+
+***
+
+### @type
+
+> **@type**: `"DataService"`
+
+The type identifier for the Data Service.
+REQUIRED per Eclipse Data Space Protocol.
+
+***
+
+### @id
+
+> **@id**: `string`
+
+Unique identifier for the dataset.
+REQUIRED per Eclipse Data Space Protocol.
+
+***
+
+### endpointURL
+
+> **endpointURL**: `string`
+
+Endpoint URL
+
+***
+
+### servesDataset?
+
+> `optional` **servesDataset**: `ObjectOrArray`\<`Omit`\<[`IDataspaceProtocolDataset`](IDataspaceProtocolDataset.md), `"@context"`\>\>
+
+Datasets served.

package/docs/reference/interfaces/IDataspaceProtocolDataset.md

@@ -0,0 +1,90 @@
+# Interface: IDataspaceProtocolDataset
+
+Dataset interface compliant with Eclipse Data Space Protocol.
+
+This interface extends IDataset and enforces DS Protocol-specific requirements
+by overriding properties with more specific types and constraints.
+
+**Requirements per DS Protocol:**
+- `@id` MUST be present for dataset identification (REQUIRED)
+- `odrl:hasPolicy` MUST be present as an array of ODRL Offers (REQUIRED)
+- Array MUST contain at least one IOdrlOffer
+- Each Offer MUST have `@type`: "Offer"
+- Each Offer MUST have `@id` or `uid` for identification
+- `dcat:distribution` MUST be present (REQUIRED)
+
+**Type System Design:**
+- W3C DCAT spec defines `odrl:hasPolicy` as optional singular `IOdrlPolicy`
+- DS Protocol requires it as a REQUIRED array of `IOdrlOffer`
+- Interface extension allows TypeScript to override inherited property types
+- Standards packages (@twin.org/standards-w3c-*) follow W3C specs exactly
+- DS Protocol-specific constraints are defined here
+
+**Future Compatibility:**
+- Currently only one Offer per dataset is supported
+- Array structure allows future support for multiple offers
+
+## See
+
+ - https://eclipse-dataspace-protocol-base.github.io/DataspaceProtocol/2025-1-err1/#lower-level-types
+ - https://www.w3.org/TR/vocab-dcat-3/ - W3C DCAT v3 spec
+ - IOdrlOffer from @twin.org/standards-w3c-odrl
+ - IResource.odrl:hasPolicy from @twin.org/standards-w3c-dcat
+
+## Extends
+
+- `Omit`\<`IDcatDataset`, `"odrl:hasPolicy"` \| `"dcat:distribution"` \| `"@type"` \| `"@context"`\>
+
+## Indexable
+
+\[`key`: `string`\]: `string` \| `number` \| `boolean` \| `IJsonLdContextDefinition` \| `string`[] \| `IJsonLdNodeObject` \| `IJsonLdGraphObject` \| `object` & `object` \| `object` & `object` \| `object` & `object` \| `IJsonLdListObject` \| `IJsonLdSetObject` \| `IJsonLdNodePrimitive`[] \| `IJsonLdLanguageMap` \| `IJsonLdIndexMap` \| `IJsonLdNodeObject`[] \| `IJsonLdIdMap` \| `IJsonLdTypeMap` \| `IJsonLdContextDefinitionElement`[] \| `IJsonLdJsonObject` \| `IJsonLdJsonObject`[] \| \{\[`key`: `string`\]: `string`; \} \| `null` \| `undefined`
+
+\[`key`: `number`\]: `string` \| `number` \| `boolean` \| `IJsonLdContextDefinition` \| `string`[] \| `IJsonLdNodeObject` \| `IJsonLdGraphObject` \| `object` & `object` \| `object` & `object` \| `object` & `object` \| `IJsonLdListObject` \| `IJsonLdSetObject` \| `IJsonLdNodePrimitive`[] \| `IJsonLdLanguageMap` \| `IJsonLdIndexMap` \| `IJsonLdNodeObject`[] \| `IJsonLdIdMap` \| `IJsonLdTypeMap` \| `IJsonLdContextDefinitionElement`[] \| `IJsonLdJsonObject` \| `IJsonLdJsonObject`[] \| \{\[`key`: `string`\]: `string`; \} \| `null` \| `undefined`
+
+## Properties
+
+### @context
+
+> **@context**: [`DataspaceProtocolContextType`](../type-aliases/DataspaceProtocolContextType.md)
+
+LD Context. Required per Eclipse Data Space Protocol.
+
+***
+
+### @type
+
+> **@type**: `"Dataset"`
+
+The type identifier for the dataset.
+REQUIRED per Eclipse Data Space Protocol.
+
+***
+
+### @id
+
+> **@id**: `string`
+
+Unique identifier for the dataset.
+REQUIRED per Eclipse Data Space Protocol.
+
+***
+
+### hasPolicy
+
+> **hasPolicy**: `ObjectOrArray`\<`Omit`\<`IOdrlOffer`, `"@context"`\>\>
+
+Array of ODRL policies (Offers) as required by DS Protocol.
+
+REQUIRED per Eclipse Data Space Protocol spec.
+Must contain at least one IOdrlOffer.
+Currently only single offer is supported, but array structure
+allows for future multi-offer support.
+
+***
+
+### distribution
+
+> **distribution**: `ObjectOrArray`\<`Omit`\<[`IDataspaceProtocolDistribution`](IDataspaceProtocolDistribution.md), `"@context"`\>\>
+
+Distribution of the dataset.
+REQUIRED per Eclipse Data Space Protocol.

package/docs/reference/interfaces/IDataspaceProtocolDatasetRequestMessage.md

@@ -0,0 +1,28 @@
+# Interface: IDataspaceProtocolDatasetRequestMessage
+
+Interface for Dataspace Protocol Dataset Request Messages.
+https://eclipse-dataspace-protocol-base.github.io/DataspaceProtocol/2025-1/#dataset-request-message
+
+## Properties
+
+### @context
+
+> **@context**: [`DataspaceProtocolContextType`](../type-aliases/DataspaceProtocolContextType.md)
+
+The JSON-LD context.
+
+***
+
+### @type
+
+> **@type**: `"DatasetRequestMessage"`
+
+The type of the message.
+
+***
+
+### dataset
+
+> **dataset**: `string`
+
+The identifier of the dataset.

package/docs/reference/interfaces/IDataspaceProtocolDistribution.md

@@ -0,0 +1,98 @@
+# Interface: IDataspaceProtocolDistribution
+
+Distribution interface compliant with Eclipse Data Space Protocol.
+
+This interface extends IDistribution  and enforces DS Protocol-specific requirements
+by overriding properties with more specific types and constraints.
+
+**Requirements per DS Protocol:**
+- `@id` MUST be present for dataset identification (REQUIRED)
+- `odrl:hasPolicy` MIGHT be present as an array of ODRL Offers (OPTIONAL)
+- Array MUST contain at least one IOdrlOffer
+- Each Offer MUST have `@type`: "Offer"
+- `format` is REQUIRED.
+
+**Type System Design:**
+- W3C DCAT spec defines `odrl:hasPolicy` as optional singular `IOdrlPolicy`
+- DS Protocol requires it as a REQUIRED array of `IOdrlOffer`
+- Interface extension allows TypeScript to override inherited property types
+- Standards packages (@twin.org/standards-w3c-*) follow W3C specs exactly
+- DS Protocol-specific constraints are defined here
+
+**Future Compatibility:**
+- Currently only one Offer per dataset is supported
+- Array structure allows future support for multiple offers
+
+## See
+
+ - https://eclipse-dataspace-protocol-base.github.io/DataspaceProtocol/2025-1-err1/#lower-level-types
+ - https://www.w3.org/TR/vocab-dcat-3/ - W3C DCAT v3 spec
+ - IOdrlOffer from @twin.org/standards-w3c-odrl
+ - IResource.odrl:hasPolicy from @twin.org/standards-w3c-dcat
+
+## Extends
+
+- `Omit`\<`IDcatDistribution`, `"odrl:hasPolicy"` \| `"@type"` \| `"@context"` \| `"dcterms:format"`\>
+
+## Indexable
+
+\[`key`: `string`\]: `string` \| `number` \| `boolean` \| `IJsonLdContextDefinition` \| `string`[] \| `IJsonLdNodeObject` \| `IJsonLdGraphObject` \| `object` & `object` \| `object` & `object` \| `object` & `object` \| `IJsonLdListObject` \| `IJsonLdSetObject` \| `IJsonLdNodePrimitive`[] \| `IJsonLdLanguageMap` \| `IJsonLdIndexMap` \| `IJsonLdNodeObject`[] \| `IJsonLdIdMap` \| `IJsonLdTypeMap` \| `IJsonLdContextDefinitionElement`[] \| `IJsonLdJsonObject` \| `IJsonLdJsonObject`[] \| \{\[`key`: `string`\]: `string`; \} \| `null` \| `undefined`
+
+\[`key`: `number`\]: `string` \| `number` \| `boolean` \| `IJsonLdContextDefinition` \| `string`[] \| `IJsonLdNodeObject` \| `IJsonLdGraphObject` \| `object` & `object` \| `object` & `object` \| `object` & `object` \| `IJsonLdListObject` \| `IJsonLdSetObject` \| `IJsonLdNodePrimitive`[] \| `IJsonLdLanguageMap` \| `IJsonLdIndexMap` \| `IJsonLdNodeObject`[] \| `IJsonLdIdMap` \| `IJsonLdTypeMap` \| `IJsonLdContextDefinitionElement`[] \| `IJsonLdJsonObject` \| `IJsonLdJsonObject`[] \| \{\[`key`: `string`\]: `string`; \} \| `null` \| `undefined`
+
+## Properties
+
+### @context
+
+> **@context**: [`DataspaceProtocolContextType`](../type-aliases/DataspaceProtocolContextType.md)
+
+LD Context. Required per Eclipse Data Space Protocol.
+
+***
+
+### @type
+
+> **@type**: `"Distribution"`
+
+The type identifier for the Distribution.
+REQUIRED per Eclipse Data Space Protocol.
+
+***
+
+### @id
+
+> **@id**: `string`
+
+Unique identifier for the dataset.
+REQUIRED per Eclipse Data Space Protocol.
+
+***
+
+### hasPolicy?
+
+> `optional` **hasPolicy**: `ObjectOrArray`\<`Omit`\<`IOdrlOffer`, `"@context"`\>\>
+
+Array of ODRL policies (Offers) as required by DS Protocol.
+
+REQUIRED per Eclipse Data Space Protocol spec.
+Must contain at least one IOdrlOffer.
+Currently only single offer is supported, but array structure
+allows for future multi-offer support.
+
+***
+
+### accessService
+
+> **accessService**: `string` \| `Omit`\<[`IDataspaceProtocolDataService`](IDataspaceProtocolDataService.md), `"@context"`\>
+
+Access service.
+It can be a URI pointing to an access service or inline the access service itself
+
+***
+
+### format
+
+> **format**: `string`
+
+Distribution format.
+REQUIRED per Eclipse Data Space Protocol.

package/docs/reference/interfaces/IDataspaceProtocolEndpointProperty.md

@@ -0,0 +1,28 @@
+# Interface: IDataspaceProtocolEndpointProperty
+
+Interface for Dataspace Protocol Transfer Messages.
+https://eclipse-dataspace-protocol-base.github.io/DataspaceProtocol/#lower-level-types
+
+## Properties
+
+### @type
+
+> **@type**: `"EndpointProperty"`
+
+LD Type.
+
+***
+
+### name
+
+> **name**: `string`
+
+Property name.
+
+***
+
+### value
+
+> **value**: `string`
+
+Property value.

package/docs/reference/interfaces/IDataspaceProtocolTransferCompletionMessage.md

@@ -0,0 +1,36 @@
+# Interface: IDataspaceProtocolTransferCompletionMessage
+
+Interface for Dataspace Protocol Transfer Messages.
+https://eclipse-dataspace-protocol-base.github.io/DataspaceProtocol/#transfer-completion-message
+
+## Properties
+
+### @context
+
+> **@context**: [`DataspaceProtocolContextType`](../type-aliases/DataspaceProtocolContextType.md)
+
+LD Context
+
+***
+
+### @type
+
+> **@type**: `"TransferCompletionMessage"`
+
+LD Type
+
+***
+
+### consumerPid
+
+> **consumerPid**: `string`
+
+MUST refer to the transfer identifier of the Consumer side.
+
+***
+
+### providerPid
+
+> **providerPid**: `string`
+
+MUST refer to the transfer identifier of the Provider side.

package/docs/reference/interfaces/IDataspaceProtocolTransferError.md

@@ -0,0 +1,52 @@
+# Interface: IDataspaceProtocolTransferError
+
+Interface for Dataspace Protocol Transfer Messages.
+https://eclipse-dataspace-protocol-base.github.io/DataspaceProtocol#error-transfer-error
+
+## Properties
+
+### @context
+
+> **@context**: [`DataspaceProtocolContextType`](../type-aliases/DataspaceProtocolContextType.md)
+
+LD Context
+
+***
+
+### @type
+
+> **@type**: `"TransferError"`
+
+LD Type
+
+***
+
+### consumerPid
+
+> **consumerPid**: `string`
+
+MUST refer to the transfer identifier of the Consumer side.
+
+***
+
+### providerPid
+
+> **providerPid**: `string`
+
+MUST refer to the transfer identifier of the Provider side.
+
+***
+
+### code?
+
+> `optional` **code**: `string`
+
+The error code.
+
+***
+
+### reason?
+
+> `optional` **reason**: `any`[]
+
+The error reason(s).

package/docs/reference/interfaces/IDataspaceProtocolTransferProcess.md

@@ -0,0 +1,44 @@
+# Interface: IDataspaceProtocolTransferProcess
+
+Interface for Dataspace Protocol Transfer Messages.
+https://eclipse-dataspace-protocol-base.github.io/DataspaceProtocol/#ack-transfer-process
+
+## Properties
+
+### @context
+
+> **@context**: [`DataspaceProtocolContextType`](../type-aliases/DataspaceProtocolContextType.md)
+
+LD Context
+
+***
+
+### @type
+
+> **@type**: `"TransferProcess"`
+
+LD Type
+
+***
+
+### consumerPid
+
+> **consumerPid**: `string`
+
+MUST refer to the transfer identifier of the Consumer side.
+
+***
+
+### providerPid
+
+> **providerPid**: `string`
+
+MUST refer to the transfer identifier of the Provider side.
+
+***
+
+### state
+
+> **state**: [`DataspaceProtocolTransferProcessStateType`](../type-aliases/DataspaceProtocolTransferProcessStateType.md)
+
+The transfer process state.

package/docs/reference/interfaces/IDataspaceProtocolTransferRequestMessage.md

@@ -0,0 +1,62 @@
+# Interface: IDataspaceProtocolTransferRequestMessage
+
+Interface for Dataspace Protocol Transfer Messages.
+https://eclipse-dataspace-protocol-base.github.io/DataspaceProtocol/#transfer-request-message
+
+## Properties
+
+### @context
+
+> **@context**: [`DataspaceProtocolContextType`](../type-aliases/DataspaceProtocolContextType.md)
+
+LD Context
+
+***
+
+### @type
+
+> **@type**: `"TransferRequestMessage"`
+
+LD Type
+
+***
+
+### agreementId
+
+> **agreementId**: `string`
+
+MUST refer to an existing Agreement between the Consumer and Provider.
+
+***
+
+### callbackAddress
+
+> **callbackAddress**: `string`
+
+MUST be a URI indicating where messages to the Consumer SHOULD be sent.
+
+***
+
+### consumerPid
+
+> **consumerPid**: `string`
+
+MUST refer to the transfer identifier of the Consumer side.
+
+***
+
+### format
+
+> **format**: `string`
+
+The format property is a format specified by a Distribution for the Dataset associated with the Agreement.
+This is generally obtained from the Provider's Catalog.
+
+***
+
+### dataAddress?
+
+> `optional` **dataAddress**: [`IDataspaceProtocolDataAddress`](IDataspaceProtocolDataAddress.md)
+
+If defined MUST contain a transport-specific set of properties for pushing the data.
+It MAY include an endpoint, a temporary authorization via the endpointProperties property - depending on the endpointType.

package/docs/reference/interfaces/IDataspaceProtocolTransferStartMessage.md

@@ -0,0 +1,45 @@
+# Interface: IDataspaceProtocolTransferStartMessage
+
+Interface for Dataspace Protocol Transfer Messages.
+https://eclipse-dataspace-protocol-base.github.io/DataspaceProtocol/#transfer-start-message
+
+## Properties
+
+### @context
+
+> **@context**: [`DataspaceProtocolContextType`](../type-aliases/DataspaceProtocolContextType.md)
+
+LD Context
+
+***
+
+### @type
+
+> **@type**: `"TransferStartMessage"`
+
+LD Type
+
+***
+
+### consumerPid
+
+> **consumerPid**: `string`
+
+MUST refer to the transfer identifier of the Consumer side.
+
+***
+
+### providerPid
+
+> **providerPid**: `string`
+
+MUST refer to the transfer identifier of the Provider side.
+
+***
+
+### dataAddress?
+
+> `optional` **dataAddress**: [`IDataspaceProtocolDataAddress`](IDataspaceProtocolDataAddress.md)
+
+MUST be provided if the current transfer is a pull transfer and
+contains a transport-specific endpoint address for obtaining the data.

package/docs/reference/interfaces/IDataspaceProtocolTransferSuspensionMessage.md

@@ -0,0 +1,52 @@
+# Interface: IDataspaceProtocolTransferSuspensionMessage
+
+Interface for Dataspace Protocol Transfer Messages.
+https://eclipse-dataspace-protocol-base.github.io/DataspaceProtocol/#transfer-suspension-message
+
+## Properties
+
+### @context
+
+> **@context**: [`DataspaceProtocolContextType`](../type-aliases/DataspaceProtocolContextType.md)
+
+LD Context
+
+***
+
+### @type
+
+> **@type**: `"TransferSuspensionMessage"`
+
+LD Type
+
+***
+
+### consumerPid
+
+> **consumerPid**: `string`
+
+MUST refer to the transfer identifier of the Consumer side.
+
+***
+
+### providerPid
+
+> **providerPid**: `string`
+
+MUST refer to the transfer identifier of the Provider side.
+
+***
+
+### code?
+
+> `optional` **code**: `string`
+
+The suspension code.
+
+***
+
+### reason?
+
+> `optional` **reason**: `any`[]
+
+The suspension reason(s).

package/docs/reference/interfaces/IDataspaceProtocolTransferTerminationMessage.md

@@ -0,0 +1,52 @@
+# Interface: IDataspaceProtocolTransferTerminationMessage
+
+Interface for Dataspace Protocol Transfer Messages.
+https://eclipse-dataspace-protocol-base.github.io/DataspaceProtocol/#transfer-termination-message
+
+## Properties
+
+### @context
+
+> **@context**: [`DataspaceProtocolContextType`](../type-aliases/DataspaceProtocolContextType.md)
+
+LD Context
+
+***
+
+### @type
+
+> **@type**: `"TransferTerminationMessage"`
+
+LD Type
+
+***
+
+### consumerPid
+
+> **consumerPid**: `string`
+
+MUST refer to the transfer identifier of the Consumer side.
+
+***
+
+### providerPid
+
+> **providerPid**: `string`
+
+MUST refer to the transfer identifier of the Provider side.
+
+***
+
+### code?
+
+> `optional` **code**: `string`
+
+The termination code.
+
+***
+
+### reason?
+
+> `optional` **reason**: `any`[]
+
+The termination reason(s).

package/docs/reference/type-aliases/DataspaceProtocolCatalogTypes.md

@@ -0,0 +1,5 @@
+# Type Alias: DataspaceProtocolCatalogTypes
+
+> **DataspaceProtocolCatalogTypes** = *typeof* [`DataspaceProtocolCatalogTypes`](../variables/DataspaceProtocolCatalogTypes.md)\[keyof *typeof* [`DataspaceProtocolCatalogTypes`](../variables/DataspaceProtocolCatalogTypes.md)\]
+
+The types for Dataspace Protocol Catalog Protocol.

package/docs/reference/type-aliases/DataspaceProtocolContextType.md

@@ -0,0 +1,5 @@
+# Type Alias: DataspaceProtocolContextType
+
+> **DataspaceProtocolContextType** = *typeof* [`Context`](../variables/DataspaceProtocolContexts.md#context) \| \[*typeof* [`Context`](../variables/DataspaceProtocolContexts.md#context)\] \| \[`...IJsonLdContextDefinitionElement[]`, *typeof* [`Context`](../variables/DataspaceProtocolContexts.md#context), `IJsonLdContextDefinitionElement`\] \| \[`IJsonLdContextDefinitionElement`, *typeof* [`Context`](../variables/DataspaceProtocolContexts.md#context), `...IJsonLdContextDefinitionElement[]`\]
+
+The Dataspace Protocol JSON-LD context type.

package/docs/reference/type-aliases/DataspaceProtocolContexts.md

@@ -0,0 +1,5 @@
+# Type Alias: DataspaceProtocolContexts
+
+> **DataspaceProtocolContexts** = *typeof* [`DataspaceProtocolContexts`](../variables/DataspaceProtocolContexts.md)\[keyof *typeof* [`DataspaceProtocolContexts`](../variables/DataspaceProtocolContexts.md)\]
+
+The contexts for Dataspace Protocol Protocol.

package/docs/reference/type-aliases/DataspaceProtocolContractNegotiationEventType.md

@@ -0,0 +1,5 @@
+# Type Alias: DataspaceProtocolContractNegotiationEventType
+
+> **DataspaceProtocolContractNegotiationEventType** = *typeof* [`DataspaceProtocolContractNegotiationEventType`](../variables/DataspaceProtocolContractNegotiationEventType.md)\[keyof *typeof* [`DataspaceProtocolContractNegotiationEventType`](../variables/DataspaceProtocolContractNegotiationEventType.md)\]
+
+The types for Dataspace Protocol Contract Negotiation Events.