Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 4 additions & 3 deletions EVES/SUMMARY.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,8 @@

## EVES

* [EVES-001: ENVITED Ecosystem Specification Process](drafts/EVES-001/eves-001.md)
* [EVES-001: ENVITED-X Ecosystem Specification Process](drafts/EVES-001/eves-001.md)

Check notice on line 9 in EVES/SUMMARY.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/SUMMARY.md#L9

[Google.Acronyms] Spell out 'EVES', if it's unfamiliar to the audience.
Raw output
{"message": "[Google.Acronyms] Spell out 'EVES', if it's unfamiliar to the audience.", "location": {"path": "EVES/SUMMARY.md", "range": {"start": {"line": 9, "column": 4}}}, "severity": "INFO"}
* [EVES-002: ENVITED-X Data Space Architecture Overview](drafts/EVES-002/eves-002.md)
* [EVES-003: ENVITED Asset Definition and Upload Process](drafts/EVES-003/eves-003.md)
* [EVES-004: Roles and Responsibilities of EVES Editors](drafts/EVES-004/eves-004.md)
* [EVES-003: ENVITED-X Asset Definition and Upload Process](drafts/EVES-003/eves-003.md)

Check notice on line 11 in EVES/SUMMARY.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/SUMMARY.md#L11

[Google.Acronyms] Spell out 'EVES', if it's unfamiliar to the audience.
Raw output
{"message": "[Google.Acronyms] Spell out 'EVES', if it's unfamiliar to the audience.", "location": {"path": "EVES/SUMMARY.md", "range": {"start": {"line": 11, "column": 4}}}, "severity": "INFO"}
* [EVES-004: ENVITED-X Roles and Responsibilities of EVES Editors](drafts/EVES-004/eves-004.md)

Check notice on line 12 in EVES/SUMMARY.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/SUMMARY.md#L12

[Google.Acronyms] Spell out 'EVES', if it's unfamiliar to the audience.
Raw output
{"message": "[Google.Acronyms] Spell out 'EVES', if it's unfamiliar to the audience.", "location": {"path": "EVES/SUMMARY.md", "range": {"start": {"line": 12, "column": 4}}}, "severity": "INFO"}

Check notice on line 12 in EVES/SUMMARY.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/SUMMARY.md#L12

[Google.Acronyms] Spell out 'EVES', if it's unfamiliar to the audience.
Raw output
{"message": "[Google.Acronyms] Spell out 'EVES', if it's unfamiliar to the audience.", "location": {"path": "EVES/SUMMARY.md", "range": {"start": {"line": 12, "column": 54}}}, "severity": "INFO"}
* [EVES-005: ENVITED-X Contract Negotiation Process](drafts/EVES-005/eves-005.md)

Check notice on line 13 in EVES/SUMMARY.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/SUMMARY.md#L13

[Google.Acronyms] Spell out 'EVES', if it's unfamiliar to the audience.
Raw output
{"message": "[Google.Acronyms] Spell out 'EVES', if it's unfamiliar to the audience.", "location": {"path": "EVES/SUMMARY.md", "range": {"start": {"line": 13, "column": 4}}}, "severity": "INFO"}
8 changes: 5 additions & 3 deletions EVES/drafts/EVES-001/eves-001.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
eves-identifier: 001
title: ENVITED Ecosystem Specification Process
title: ENVITED-X Ecosystem Specification Process
author: Carlo van Driesten (@jdsika)
discussions-to: https://github.com/ASCS-eV/EVES/issues/9
status: Draft
Expand All @@ -17,7 +17,8 @@

## Motivation

A standardized process for EVES ensures clarity, inclusivity, and accountability in the evolution of the ENVITED ecosystem. By defining roles, responsibilities, and lifecycle stages, this process aligns with best practices from similar initiatives, such as Chain Agnostic Improvement Proposals (CAIPs).
A standardized process for EVES ensures clarity, inclusivity, and accountability in the evolution of the ENVITED ecosystem.

Check failure on line 20 in EVES/drafts/EVES-001/eves-001.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-001/eves-001.md#L20

[Vale.Spelling] Did you really mean 'inclusivity'?
Raw output
{"message": "[Vale.Spelling] Did you really mean 'inclusivity'?", "location": {"path": "EVES/drafts/EVES-001/eves-001.md", "range": {"start": {"line": 20, "column": 50}}}, "severity": "ERROR"}
By defining roles, responsibilities, and lifecycle stages, this process aligns with best practices from similar initiatives, such as Chain Agnostic Improvement Proposals (CAIPs).

Check notice on line 21 in EVES/drafts/EVES-001/eves-001.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-001/eves-001.md#L21

[Google.Parens] Use parentheses judiciously.
Raw output
{"message": "[Google.Parens] Use parentheses judiciously.", "location": {"path": "EVES/drafts/EVES-001/eves-001.md", "range": {"start": {"line": 21, "column": 171}}}, "severity": "INFO"}

Check failure on line 21 in EVES/drafts/EVES-001/eves-001.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-001/eves-001.md#L21

[Vale.Spelling] Did you really mean 'CAIPs'?
Raw output
{"message": "[Vale.Spelling] Did you really mean 'CAIPs'?", "location": {"path": "EVES/drafts/EVES-001/eves-001.md", "range": {"start": {"line": 21, "column": 172}}}, "severity": "ERROR"}

## Specification

Expand Down Expand Up @@ -129,7 +130,8 @@

### 8. Governance

The process emphasizes openness, inclusivity, and accountability. Discussions, decisions, and documentation are publicly accessible on the EVES GitHub repository. Governance rules for EVES Editors are defined [here](https://openmsl.github.io/doc/OpenMSL/organization/governance_rules.html).
The process emphasizes openness, inclusivity, and accountability. Discussions, decisions, and documentation are publicly accessible on the EVES GitHub repository.

Check failure on line 133 in EVES/drafts/EVES-001/eves-001.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-001/eves-001.md#L133

[Vale.Spelling] Did you really mean 'inclusivity'?
Raw output
{"message": "[Vale.Spelling] Did you really mean 'inclusivity'?", "location": {"path": "EVES/drafts/EVES-001/eves-001.md", "range": {"start": {"line": 133, "column": 34}}}, "severity": "ERROR"}

Check notice on line 133 in EVES/drafts/EVES-001/eves-001.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-001/eves-001.md#L133

[write-good.E-Prime] Try to avoid using 'are'.
Raw output
{"message": "[write-good.E-Prime] Try to avoid using 'are'.", "location": {"path": "EVES/drafts/EVES-001/eves-001.md", "range": {"start": {"line": 133, "column": 109}}}, "severity": "INFO"}
Governance rules for EVES Editors are defined [here](https://openmsl.github.io/doc/OpenMSL/organization/governance_rules.html).

Check notice on line 134 in EVES/drafts/EVES-001/eves-001.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-001/eves-001.md#L134

[write-good.E-Prime] Try to avoid using 'are'.
Raw output
{"message": "[write-good.E-Prime] Try to avoid using 'are'.", "location": {"path": "EVES/drafts/EVES-001/eves-001.md", "range": {"start": {"line": 134, "column": 35}}}, "severity": "INFO"}

Check warning on line 134 in EVES/drafts/EVES-001/eves-001.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-001/eves-001.md#L134

[write-good.Passive] 'are defined' may be passive voice. Use active voice if you can.
Raw output
{"message": "[write-good.Passive] 'are defined' may be passive voice. Use active voice if you can.", "location": {"path": "EVES/drafts/EVES-001/eves-001.md", "range": {"start": {"line": 134, "column": 35}}}, "severity": "WARNING"}

Check notice on line 134 in EVES/drafts/EVES-001/eves-001.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-001/eves-001.md#L134

[Google.Passive] In general, use active voice instead of passive voice ('are defined').
Raw output
{"message": "[Google.Passive] In general, use active voice instead of passive voice ('are defined').", "location": {"path": "EVES/drafts/EVES-001/eves-001.md", "range": {"start": {"line": 134, "column": 35}}}, "severity": "INFO"}

## Backwards Compatibility

Expand Down
8 changes: 5 additions & 3 deletions EVES/drafts/EVES-003/eves-003.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
eves-identifier: 003
title: ENVITED Asset Definition and Upload Process
title: ENVITED-X Asset Definition and Upload Process
author: Carlo van Driesten (@jdsika)
discussions-to: https://github.com/ASCS-eV/EVES/issues/4
status: Draft
Expand Down Expand Up @@ -127,7 +127,8 @@

#### TZIP-21 rich metadata mapping

Attributes not in the table are static and the same for every mint. Examples are the first five tags or "publishers", which is always ENVITED-X and the ASCS as the mint is conducted through the website.
Attributes not in the table are static and the same for every mint.

Check notice on line 130 in EVES/drafts/EVES-003/eves-003.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-003/eves-003.md#L130

[write-good.E-Prime] Try to avoid using 'are'.
Raw output
{"message": "[write-good.E-Prime] Try to avoid using 'are'.", "location": {"path": "EVES/drafts/EVES-003/eves-003.md", "range": {"start": {"line": 130, "column": 29}}}, "severity": "INFO"}
Examples are the first five tags or "publishers", which is always ENVITED-X and the ASCS as the mint is conducted through the website.

Check notice on line 131 in EVES/drafts/EVES-003/eves-003.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-003/eves-003.md#L131

[write-good.E-Prime] Try to avoid using 'are'.
Raw output
{"message": "[write-good.E-Prime] Try to avoid using 'are'.", "location": {"path": "EVES/drafts/EVES-003/eves-003.md", "range": {"start": {"line": 131, "column": 10}}}, "severity": "INFO"}

Check failure on line 131 in EVES/drafts/EVES-003/eves-003.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-003/eves-003.md#L131

[Google.Quotes] Commas and periods go inside quotation marks.
Raw output
{"message": "[Google.Quotes] Commas and periods go inside quotation marks.", "location": {"path": "EVES/drafts/EVES-003/eves-003.md", "range": {"start": {"line": 131, "column": 37}}}, "severity": "ERROR"}

Check notice on line 131 in EVES/drafts/EVES-003/eves-003.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-003/eves-003.md#L131

[write-good.E-Prime] Try to avoid using 'is'.
Raw output
{"message": "[write-good.E-Prime] Try to avoid using 'is'.", "location": {"path": "EVES/drafts/EVES-003/eves-003.md", "range": {"start": {"line": 131, "column": 57}}}, "severity": "INFO"}

Check notice on line 131 in EVES/drafts/EVES-003/eves-003.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-003/eves-003.md#L131

[Google.Acronyms] Spell out 'ASCS', if it's unfamiliar to the audience.
Raw output
{"message": "[Google.Acronyms] Spell out 'ASCS', if it's unfamiliar to the audience.", "location": {"path": "EVES/drafts/EVES-003/eves-003.md", "range": {"start": {"line": 131, "column": 85}}}, "severity": "INFO"}

Check notice on line 131 in EVES/drafts/EVES-003/eves-003.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-003/eves-003.md#L131

[Google.Passive] In general, use active voice instead of passive voice ('is conducted').
Raw output
{"message": "[Google.Passive] In general, use active voice instead of passive voice ('is conducted').", "location": {"path": "EVES/drafts/EVES-003/eves-003.md", "range": {"start": {"line": 131, "column": 102}}}, "severity": "INFO"}

Check warning on line 131 in EVES/drafts/EVES-003/eves-003.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-003/eves-003.md#L131

[write-good.Passive] 'is conducted' may be passive voice. Use active voice if you can.
Raw output
{"message": "[write-good.Passive] 'is conducted' may be passive voice. Use active voice if you can.", "location": {"path": "EVES/drafts/EVES-003/eves-003.md", "range": {"start": {"line": 131, "column": 102}}}, "severity": "WARNING"}

| TZIP-21 | EVES-003 | Comment |
| -------------------| ---------------------------------------------------- | ------------------------------------------------------------ |
Expand Down Expand Up @@ -156,7 +157,8 @@

## Backwards Compatibility

This specification introduces new processes for asset uploads and is fully compatible with existing ENVITED-X systems. No retroactive changes to previous assets are required.
This specification introduces new processes for asset uploads and is fully compatible with existing ENVITED-X systems.

Check notice on line 160 in EVES/drafts/EVES-003/eves-003.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-003/eves-003.md#L160

[write-good.E-Prime] Try to avoid using 'is'.
Raw output
{"message": "[write-good.E-Prime] Try to avoid using 'is'.", "location": {"path": "EVES/drafts/EVES-003/eves-003.md", "range": {"start": {"line": 160, "column": 67}}}, "severity": "INFO"}
No retroactive changes to previous assets are required.

Check notice on line 161 in EVES/drafts/EVES-003/eves-003.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-003/eves-003.md#L161

[write-good.E-Prime] Try to avoid using 'are'.
Raw output
{"message": "[write-good.E-Prime] Try to avoid using 'are'.", "location": {"path": "EVES/drafts/EVES-003/eves-003.md", "range": {"start": {"line": 161, "column": 43}}}, "severity": "INFO"}

Check notice on line 161 in EVES/drafts/EVES-003/eves-003.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-003/eves-003.md#L161

[Google.Passive] In general, use active voice instead of passive voice ('are required').
Raw output
{"message": "[Google.Passive] In general, use active voice instead of passive voice ('are required').", "location": {"path": "EVES/drafts/EVES-003/eves-003.md", "range": {"start": {"line": 161, "column": 43}}}, "severity": "INFO"}

Check warning on line 161 in EVES/drafts/EVES-003/eves-003.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-003/eves-003.md#L161

[write-good.Passive] 'are required' may be passive voice. Use active voice if you can.
Raw output
{"message": "[write-good.Passive] 'are required' may be passive voice. Use active voice if you can.", "location": {"path": "EVES/drafts/EVES-003/eves-003.md", "range": {"start": {"line": 161, "column": 43}}}, "severity": "WARNING"}

## References

Expand Down
8 changes: 5 additions & 3 deletions EVES/drafts/EVES-004/eves-004.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
eves-identifier: 004
title: Roles and Responsibilities of EVES Editors
title: ENVITED-X Roles and Responsibilities of EVES Editors
author: Carlo van Driesten (@jdsika)
discussions-to:
status: Draft
Expand Down Expand Up @@ -110,6 +110,7 @@
#### 4.2 Providing Technical Designs or Implementations

- Authors and contributors are solely responsible for technical designs and reference implementations.
- Information about e.g designs and technical implementations are only exchanged for the purpose of defining the specification.

Check notice on line 113 in EVES/drafts/EVES-004/eves-004.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-004/eves-004.md#L113

[write-good.E-Prime] Try to avoid using 'are'.
Raw output
{"message": "[write-good.E-Prime] Try to avoid using 'are'.", "location": {"path": "EVES/drafts/EVES-004/eves-004.md", "range": {"start": {"line": 113, "column": 63}}}, "severity": "INFO"}

Check warning on line 113 in EVES/drafts/EVES-004/eves-004.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-004/eves-004.md#L113

[write-good.TooWordy] 'for the purpose of' is too wordy.
Raw output
{"message": "[write-good.TooWordy] 'for the purpose of' is too wordy.", "location": {"path": "EVES/drafts/EVES-004/eves-004.md", "range": {"start": {"line": 113, "column": 82}}}, "severity": "WARNING"}

#### 4.3 Advocating for Specific Proposals

Expand All @@ -127,8 +128,9 @@

#### 4.6 Promoting or Ensuring Adoption of EVES

- Editors are not tasked with promoting specific EVES or ensuring their adoption.
- Community members and stakeholders must drive the promotion and integration of Final EVES.
- Editors are not tasked with promoting specific EVES or ensuring their adoption.

Check notice on line 131 in EVES/drafts/EVES-004/eves-004.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-004/eves-004.md#L131

[Google.Contractions] Use 'aren't' instead of 'are not'.
Raw output
{"message": "[Google.Contractions] Use 'aren't' instead of 'are not'.", "location": {"path": "EVES/drafts/EVES-004/eves-004.md", "range": {"start": {"line": 131, "column": 11}}}, "severity": "INFO"}

Check notice on line 131 in EVES/drafts/EVES-004/eves-004.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-004/eves-004.md#L131

[write-good.E-Prime] Try to avoid using 'are'.
Raw output
{"message": "[write-good.E-Prime] Try to avoid using 'are'.", "location": {"path": "EVES/drafts/EVES-004/eves-004.md", "range": {"start": {"line": 131, "column": 11}}}, "severity": "INFO"}
- The adoption of EVES is the free choice of every community member.

Check notice on line 132 in EVES/drafts/EVES-004/eves-004.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-004/eves-004.md#L132

[write-good.E-Prime] Try to avoid using 'is'.
Raw output
{"message": "[write-good.E-Prime] Try to avoid using 'is'.", "location": {"path": "EVES/drafts/EVES-004/eves-004.md", "range": {"start": {"line": 132, "column": 24}}}, "severity": "INFO"}
- Community members and stakeholders are solely responsible to drive the promotion and integration of Final EVES.

Check notice on line 133 in EVES/drafts/EVES-004/eves-004.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-004/eves-004.md#L133

[write-good.E-Prime] Try to avoid using 'are'.
Raw output
{"message": "[write-good.E-Prime] Try to avoid using 'are'.", "location": {"path": "EVES/drafts/EVES-004/eves-004.md", "range": {"start": {"line": 133, "column": 38}}}, "severity": "INFO"}

#### 4.7 Maintaining Approved EVES

Expand Down
109 changes: 109 additions & 0 deletions EVES/drafts/EVES-005/eves-005.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,109 @@
---
eves-identifier: 005
title: ENVITED-X Contract Negotiation Process
author: Felix Hoops (@jfelixh), Carlo van Driesten (@jdsika)
discussions-to:
status: Draft
type: Process
created: 2024-12-02
requires: ["EVES-001", "EVES-002", "EVES-003"]
replaces: None
---

## Abstract

A market place requires processes for publishing assets, negotiating contracts, and settling these contracts as a basis for services and billing.
We focus on the negotiation process, since it influences all of the other mentioned steps.

Check warning on line 16 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L16

[Google.We] Try to avoid using first-person plural like 'We'.
Raw output
{"message": "[Google.We] Try to avoid using first-person plural like 'We'.", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 16, "column": 1}}}, "severity": "WARNING"}

Check warning on line 16 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L16

[write-good.TooWordy] 'all of' is too wordy.
Raw output
{"message": "[write-good.TooWordy] 'all of' is too wordy.", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 16, "column": 58}}}, "severity": "WARNING"}
This document is not a technical specification, but rather a high-level process description.

Check notice on line 17 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L17

[write-good.E-Prime] Try to avoid using 'is'.
Raw output
{"message": "[write-good.E-Prime] Try to avoid using 'is'.", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 17, "column": 15}}}, "severity": "INFO"}

Check notice on line 17 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L17

[Google.Contractions] Use 'isn't' instead of 'is not'.
Raw output
{"message": "[Google.Contractions] Use 'isn't' instead of 'is not'.", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 17, "column": 15}}}, "severity": "INFO"}
Data standards and specific technology choices must be settled separately.

Check warning on line 18 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L18

[write-good.Passive] 'be settled' may be passive voice. Use active voice if you can.
Raw output
{"message": "[write-good.Passive] 'be settled' may be passive voice. Use active voice if you can.", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 18, "column": 53}}}, "severity": "WARNING"}

Check notice on line 18 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L18

[Google.Passive] In general, use active voice instead of passive voice ('be settled').
Raw output
{"message": "[Google.Passive] In general, use active voice instead of passive voice ('be settled').", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 18, "column": 53}}}, "severity": "INFO"}

Check notice on line 18 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L18

[write-good.E-Prime] Try to avoid using 'be'.
Raw output
{"message": "[write-good.E-Prime] Try to avoid using 'be'.", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 18, "column": 53}}}, "severity": "INFO"}

## Motivation

Gaia-X specifications on the topic are high-level (refer to [this](https://docs.gaia-x.eu/technical-committee/architecture-document/24.04/other_concepts/#computational-contracts)).

Check notice on line 22 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L22

[Google.Parens] Use parentheses judiciously.
Raw output
{"message": "[Google.Parens] Use parentheses judiciously.", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 22, "column": 1}}}, "severity": "INFO"}

Check notice on line 22 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L22

[write-good.E-Prime] Try to avoid using 'are'.
Raw output
{"message": "[write-good.E-Prime] Try to avoid using 'are'.", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 22, "column": 36}}}, "severity": "INFO"}
Existing implementations like the Eclipse Dataspace Connector's [negotiation](https://github.com/eclipse-dataspace-protocol-base/DataspaceProtocol/blob/main/negotiation/contract.negotiation.protocol.md) are complex.

Check failure on line 23 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L23

[Vale.Spelling] Did you really mean 'Dataspace'?
Raw output
{"message": "[Vale.Spelling] Did you really mean 'Dataspace'?", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 23, "column": 43}}}, "severity": "ERROR"}

Check notice on line 23 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L23

[write-good.E-Prime] Try to avoid using 'are'.
Raw output
{"message": "[write-good.E-Prime] Try to avoid using 'are'.", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 23, "column": 204}}}, "severity": "INFO"}
Beyond that, we have specific goals that are not fulfilled by any specification we are aware of at the time of writing:

Check warning on line 24 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L24

[Google.We] Try to avoid using first-person plural like 'we'.
Raw output
{"message": "[Google.We] Try to avoid using first-person plural like 'we'.", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 24, "column": 14}}}, "severity": "WARNING"}

Check notice on line 24 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L24

[Google.Contractions] Use 'we've' instead of 'we have'.
Raw output
{"message": "[Google.Contractions] Use 'we've' instead of 'we have'.", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 24, "column": 14}}}, "severity": "INFO"}

Check notice on line 24 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L24

[Google.Contractions] Use 'aren't' instead of 'are not'.
Raw output
{"message": "[Google.Contractions] Use 'aren't' instead of 'are not'.", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 24, "column": 42}}}, "severity": "INFO"}

Check notice on line 24 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L24

[write-good.E-Prime] Try to avoid using 'are'.
Raw output
{"message": "[write-good.E-Prime] Try to avoid using 'are'.", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 24, "column": 42}}}, "severity": "INFO"}

Check warning on line 24 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L24

[Google.We] Try to avoid using first-person plural like 'we'.
Raw output
{"message": "[Google.We] Try to avoid using first-person plural like 'we'.", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 24, "column": 81}}}, "severity": "WARNING"}

Check notice on line 24 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L24

[Google.Contractions] Use 'we're' instead of 'we are'.
Raw output
{"message": "[Google.Contractions] Use 'we're' instead of 'we are'.", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 24, "column": 81}}}, "severity": "INFO"}

Check notice on line 24 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L24

[write-good.E-Prime] Try to avoid using 'are'.
Raw output
{"message": "[write-good.E-Prime] Try to avoid using 'are'.", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 24, "column": 84}}}, "severity": "INFO"}

1. Ensure that the market place can mandate the use of pre-approved contract templates to ensure fairness and collect proportional fees.
2. Finalize contracts in a way that makes them fully provable to third parties, including timestamp, to give legal security to participants.

Check warning on line 27 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L27

[write-good.TooWordy] 'Finalize' is too wordy.
Raw output
{"message": "[write-good.TooWordy] 'Finalize' is too wordy.", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 27, "column": 4}}}, "severity": "WARNING"}
3. Limit the information that external parties or the market place operator have access to to a minimum required for safe operation.

Check warning on line 28 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L28

[write-good.Illusions] 'to' is repeated!
Raw output
{"message": "[write-good.Illusions] 'to' is repeated!", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 28, "column": 89}}}, "severity": "WARNING"}

Check failure on line 28 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L28

[Vale.Repetition] 'to' is repeated!
Raw output
{"message": "[Vale.Repetition] 'to' is repeated!", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 28, "column": 89}}}, "severity": "ERROR"}

Check warning on line 28 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L28

[write-good.TooWordy] 'minimum' is too wordy.
Raw output
{"message": "[write-good.TooWordy] 'minimum' is too wordy.", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 28, "column": 97}}}, "severity": "WARNING"}
4. Allow providers to make individual contracts per consumer if desired.
5. Represent the contracts as W3C Verifiable Credentials to leverage synergies with existing components in the decentralized ecosystem, specifically to easily make them usable for access control.

## Specification

### 1. Stakeholders

The ENVITED-X Data Space place _operator_ provides and maintains the market place infrastructure.
The operator also acts as a trust anchor giving access and verifiable identities to participants.
For these services, the operator collects fees from providers based on sales volume.

The _provider_ is interested in selling an asset.

Check notice on line 40 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L40

[Google.Passive] In general, use active voice instead of passive voice ('is interested').
Raw output
{"message": "[Google.Passive] In general, use active voice instead of passive voice ('is interested').", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 40, "column": 16}}}, "severity": "INFO"}

Check warning on line 40 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L40

[write-good.Passive] 'is interested' may be passive voice. Use active voice if you can.
Raw output
{"message": "[write-good.Passive] 'is interested' may be passive voice. Use active voice if you can.", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 40, "column": 16}}}, "severity": "WARNING"}

Check notice on line 40 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L40

[write-good.E-Prime] Try to avoid using 'is'.
Raw output
{"message": "[write-good.E-Prime] Try to avoid using 'is'.", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 40, "column": 16}}}, "severity": "INFO"}

The _consumer_ is interesting in buying an asset.

Check notice on line 42 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L42

[write-good.E-Prime] Try to avoid using 'is'.
Raw output
{"message": "[write-good.E-Prime] Try to avoid using 'is'.", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 42, "column": 16}}}, "severity": "INFO"}

### 2. Initial Setup

Check warning on line 44 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L44

[Google.Headings] '2. Initial Setup' should use sentence-style capitalization.
Raw output
{"message": "[Google.Headings] '2. Initial Setup' should use sentence-style capitalization.", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 44, "column": 5}}}, "severity": "WARNING"}

The operator must set up a smart contract that allows anyone to retrieve a set of acceptable contract templates, which should have the form of ODRL policies.

Check notice on line 46 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L46

[Google.Acronyms] Spell out 'ODRL', if it's unfamiliar to the audience.
Raw output
{"message": "[Google.Acronyms] Spell out 'ODRL', if it's unfamiliar to the audience.", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 46, "column": 144}}}, "severity": "INFO"}
The operator must run a _settlement service_ that can be used to settle contracts.

Check notice on line 47 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L47

[Google.Passive] In general, use active voice instead of passive voice ('be used').
Raw output
{"message": "[Google.Passive] In general, use active voice instead of passive voice ('be used').", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 47, "column": 55}}}, "severity": "INFO"}

Check notice on line 47 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L47

[write-good.E-Prime] Try to avoid using 'be'.
Raw output
{"message": "[write-good.E-Prime] Try to avoid using 'be'.", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 47, "column": 55}}}, "severity": "INFO"}

Check warning on line 47 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L47

[write-good.Passive] 'be used' may be passive voice. Use active voice if you can.
Raw output
{"message": "[write-good.Passive] 'be used' may be passive voice. Use active voice if you can.", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 47, "column": 55}}}, "severity": "WARNING"}
Contract credentials are only considered valid once their hash has been submitted to this service, which publishes the hash (directly or indirectly) on a blockchain.

Check notice on line 48 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L48

[write-good.E-Prime] Try to avoid using 'are'.
Raw output
{"message": "[write-good.E-Prime] Try to avoid using 'are'.", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 48, "column": 22}}}, "severity": "INFO"}

Check warning on line 48 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L48

[write-good.Passive] 'been submitted' may be passive voice. Use active voice if you can.
Raw output
{"message": "[write-good.Passive] 'been submitted' may be passive voice. Use active voice if you can.", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 48, "column": 68}}}, "severity": "WARNING"}

Check notice on line 48 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L48

[write-good.E-Prime] Try to avoid using 'been'.
Raw output
{"message": "[write-good.E-Prime] Try to avoid using 'been'.", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 48, "column": 68}}}, "severity": "INFO"}

Check notice on line 48 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L48

[Google.Passive] In general, use active voice instead of passive voice ('been submitted').
Raw output
{"message": "[Google.Passive] In general, use active voice instead of passive voice ('been submitted').", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 48, "column": 68}}}, "severity": "INFO"}

Check notice on line 48 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L48

[Google.Parens] Use parentheses judiciously.
Raw output
{"message": "[Google.Parens] Use parentheses judiciously.", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 48, "column": 125}}}, "severity": "INFO"}

Check failure on line 48 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L48

[Vale.Spelling] Did you really mean 'blockchain'?
Raw output
{"message": "[Vale.Spelling] Did you really mean 'blockchain'?", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 48, "column": 155}}}, "severity": "ERROR"}
We assume that the provider and consumer run a _negotiation service_ that consists of frontend and backend.

Check warning on line 49 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L49

[Google.We] Try to avoid using first-person plural like 'We'.
Raw output
{"message": "[Google.We] Try to avoid using first-person plural like 'We'.", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 49, "column": 1}}}, "severity": "WARNING"}
It could be a part of other infrastructure, such as the dataspace connector.

Check notice on line 50 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L50

[write-good.E-Prime] Try to avoid using 'be'.
Raw output
{"message": "[write-good.E-Prime] Try to avoid using 'be'.", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 50, "column": 10}}}, "severity": "INFO"}

Check failure on line 50 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L50

[Vale.Spelling] Did you really mean 'dataspace'?
Raw output
{"message": "[Vale.Spelling] Did you really mean 'dataspace'?", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 50, "column": 57}}}, "severity": "ERROR"}
This services takes over communication between provider and consumer.

### 3. Asset Setup

Check warning on line 53 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L53

[Google.Headings] '3. Asset Setup' should use sentence-style capitalization.
Raw output
{"message": "[Google.Headings] '3. Asset Setup' should use sentence-style capitalization.", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 53, "column": 5}}}, "severity": "WARNING"}

The provider must register an asset as described in EVES-003.

Check notice on line 55 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L55

[Google.Acronyms] Spell out 'EVES', if it's unfamiliar to the audience.
Raw output
{"message": "[Google.Acronyms] Spell out 'EVES', if it's unfamiliar to the audience.", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 55, "column": 53}}}, "severity": "INFO"}

### 4. Negotiation Process

Check warning on line 57 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L57

[Google.Headings] '4. Negotiation Process' should use sentence-style capitalization.
Raw output
{"message": "[Google.Headings] '4. Negotiation Process' should use sentence-style capitalization.", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 57, "column": 5}}}, "severity": "WARNING"}

The consumer uses metadata search or similar services to identify an asset of interest, before he contacts the provider to negotiate a contract.

1. The consumer asks the provider for a contract offer (i.e., quote) for the asset.

Check notice on line 61 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L61

[Google.Parens] Use parentheses judiciously.
Raw output
{"message": "[Google.Parens] Use parentheses judiciously.", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 61, "column": 56}}}, "severity": "INFO"}

Check failure on line 61 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L61

[Google.Latin] Use 'that is' instead of 'i.e.'.
Raw output
{"message": "[Google.Latin] Use 'that is' instead of 'i.e.'.", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 61, "column": 57}}}, "severity": "ERROR"}
2. The provider creates a contract offer referencing a contract template.
This offer contains specific data, such as pricing and usage requirements.
3. The provider sends the contract offer to the consumer in the form of a Verifiable Credential.
4. The consumer checks that the offer is correctly signed and that it references a valid contract template.

Check notice on line 65 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L65

[write-good.E-Prime] Try to avoid using 'is'.
Raw output
{"message": "[write-good.E-Prime] Try to avoid using 'is'.", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 65, "column": 39}}}, "severity": "INFO"}
The offer shall not conflict with the template.

Check warning on line 66 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L66

[write-good.TooWordy] 'shall' is too wordy.
Raw output
{"message": "[write-good.TooWordy] 'shall' is too wordy.", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 66, "column": 14}}}, "severity": "WARNING"}
5. If the consumer accepts, he constructs a contract credential, which wraps the contract offer.
6. The consumer sends this contract credential back to the provider, to ensure that both parties have the full contract without involving a third party.
7. The provider validates the contract credential.
In this step, the provider could also choose to ignore the contract.
For example, if the offer has expired.
8. The provider sends the hash of the contract credential to the operator's settlement service.
9. The settlement service locally saves the hash and which provider sent it.
Then, the service commits just the hash to the public blockchain.

Check failure on line 74 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L74

[Vale.Spelling] Did you really mean 'blockchain'?
Raw output
{"message": "[Vale.Spelling] Did you really mean 'blockchain'?", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 74, "column": 58}}}, "severity": "ERROR"}
10. The consumer and provider monitor the blockchain to see if the contract has been settled.

Check warning on line 75 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L75

[write-good.TooWordy] 'monitor' is too wordy.
Raw output
{"message": "[write-good.TooWordy] 'monitor' is too wordy.", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 75, "column": 31}}}, "severity": "WARNING"}

Check failure on line 75 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L75

[Vale.Spelling] Did you really mean 'blockchain'?
Raw output
{"message": "[Vale.Spelling] Did you really mean 'blockchain'?", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 75, "column": 43}}}, "severity": "ERROR"}

Check notice on line 75 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L75

[write-good.E-Prime] Try to avoid using 'been'.
Raw output
{"message": "[write-good.E-Prime] Try to avoid using 'been'.", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 75, "column": 81}}}, "severity": "INFO"}

Check warning on line 75 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L75

[write-good.Passive] 'been settled' may be passive voice. Use active voice if you can.
Raw output
{"message": "[write-good.Passive] 'been settled' may be passive voice. Use active voice if you can.", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 75, "column": 81}}}, "severity": "WARNING"}

Check notice on line 75 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L75

[Google.Passive] In general, use active voice instead of passive voice ('been settled').
Raw output
{"message": "[Google.Passive] In general, use active voice instead of passive voice ('been settled').", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 75, "column": 81}}}, "severity": "INFO"}

At this point, the contract is fully settled and the consumer can use the asset.

Check notice on line 77 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L77

[write-good.E-Prime] Try to avoid using 'is'.
Raw output
{"message": "[write-good.E-Prime] Try to avoid using 'is'.", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 77, "column": 29}}}, "severity": "INFO"}

### 5. Fee Payment

Check warning on line 79 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L79

[Google.Headings] '5. Fee Payment' should use sentence-style capitalization.
Raw output
{"message": "[Google.Headings] '5. Fee Payment' should use sentence-style capitalization.", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 79, "column": 5}}}, "severity": "WARNING"}

On a regular basis, the providers send the accumulated fees to the operator.
To ensure the fees are correctly calculated without publishing business statistics, a provider should construct a zero knowledge proof for the accumulated amount being correct based on the submitted hashes.

Check notice on line 82 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L82

[write-good.E-Prime] Try to avoid using 'are'.
Raw output
{"message": "[write-good.E-Prime] Try to avoid using 'are'.", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 82, "column": 20}}}, "severity": "INFO"}

Check notice on line 82 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L82

[write-good.E-Prime] Try to avoid using 'being'.
Raw output
{"message": "[write-good.E-Prime] Try to avoid using 'being'.", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 82, "column": 163}}}, "severity": "INFO"}

### 6. Limitations and Discussion

Check warning on line 84 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L84

[Google.Headings] '6. Limitations and Discussion' should use sentence-style capitalization.
Raw output
{"message": "[Google.Headings] '6. Limitations and Discussion' should use sentence-style capitalization.", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 84, "column": 5}}}, "severity": "WARNING"}

We assume that the provider and consumer have an interest in properly time-stamping their contract agreement.

Check warning on line 86 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L86

[Google.We] Try to avoid using first-person plural like 'We'.
Raw output
{"message": "[Google.We] Try to avoid using first-person plural like 'We'.", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 86, "column": 1}}}, "severity": "WARNING"}
This interest ensures that the operator is aware of any transaction that may generate fees.

Check notice on line 87 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L87

[write-good.E-Prime] Try to avoid using 'is'.
Raw output
{"message": "[write-good.E-Prime] Try to avoid using 'is'.", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 87, "column": 41}}}, "severity": "INFO"}
Provider and consumer may add a status entry to their Verifiable Credentials to mark the contract or the offer in some way.
This could be useful in the case of a legal dispute to give a contract a disputed status or even entirely revoke it.

Check notice on line 89 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L89

[write-good.E-Prime] Try to avoid using 'be'.
Raw output
{"message": "[write-good.E-Prime] Try to avoid using 'be'.", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 89, "column": 12}}}, "severity": "INFO"}

Check warning on line 89 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L89

[write-good.TooWordy] 'in the case of' is too wordy.
Raw output
{"message": "[write-good.TooWordy] 'in the case of' is too wordy.", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 89, "column": 22}}}, "severity": "WARNING"}

This negotiation process heavily limits data exposure, but some information beyond what what is exposed by necessity and design can still be learned:

Check warning on line 91 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L91

[write-good.Illusions] 'what' is repeated!
Raw output
{"message": "[write-good.Illusions] 'what' is repeated!", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 91, "column": 84}}}, "severity": "WARNING"}

Check failure on line 91 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L91

[Vale.Repetition] 'what' is repeated!
Raw output
{"message": "[Vale.Repetition] 'what' is repeated!", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 91, "column": 84}}}, "severity": "ERROR"}

Check notice on line 91 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L91

[Google.Contractions] Use 'what's' instead of 'what is'.
Raw output
{"message": "[Google.Contractions] Use 'what's' instead of 'what is'.", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 91, "column": 89}}}, "severity": "INFO"}

Check warning on line 91 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L91

[write-good.Passive] 'is exposed' may be passive voice. Use active voice if you can.
Raw output
{"message": "[write-good.Passive] 'is exposed' may be passive voice. Use active voice if you can.", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 91, "column": 94}}}, "severity": "WARNING"}

Check notice on line 91 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L91

[Google.Passive] In general, use active voice instead of passive voice ('is exposed').
Raw output
{"message": "[Google.Passive] In general, use active voice instead of passive voice ('is exposed').", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 91, "column": 94}}}, "severity": "INFO"}

Check notice on line 91 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L91

[write-good.E-Prime] Try to avoid using 'is'.
Raw output
{"message": "[write-good.E-Prime] Try to avoid using 'is'.", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 91, "column": 94}}}, "severity": "INFO"}

Check notice on line 91 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L91

[write-good.E-Prime] Try to avoid using 'be'.
Raw output
{"message": "[write-good.E-Prime] Try to avoid using 'be'.", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 91, "column": 139}}}, "severity": "INFO"}

Check warning on line 91 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L91

[write-good.Passive] 'be learned' may be passive voice. Use active voice if you can.
Raw output
{"message": "[write-good.Passive] 'be learned' may be passive voice. Use active voice if you can.", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 91, "column": 139}}}, "severity": "WARNING"}

Check notice on line 91 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L91

[Google.Passive] In general, use active voice instead of passive voice ('be learned').
Raw output
{"message": "[Google.Passive] In general, use active voice instead of passive voice ('be learned').", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 91, "column": 139}}}, "severity": "INFO"}

1. Third Party

- Can read number of contract agreements happening on the entire market place in a given time period.

Check warning on line 95 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L95

[write-good.TooWordy] 'time period' is too wordy.
Raw output
{"message": "[write-good.TooWordy] 'time period' is too wordy.", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 95, "column": 93}}}, "severity": "WARNING"}

2. Operator

- Knows the number of contract agreements happening in a given time period for a given provider.

Check warning on line 99 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L99

[write-good.TooWordy] 'time period' is too wordy.
Raw output
{"message": "[write-good.TooWordy] 'time period' is too wordy.", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 99, "column": 67}}}, "severity": "WARNING"}

## Backwards Compatibility

Check warning on line 101 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L101

[Google.Headings] 'Backwards Compatibility' should use sentence-style capitalization.
Raw output
{"message": "[Google.Headings] 'Backwards Compatibility' should use sentence-style capitalization.", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 101, "column": 4}}}, "severity": "WARNING"}

This process does not conflict with prior EVES.

Check notice on line 103 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L103

[Google.Contractions] Use 'doesn't' instead of 'does not'.
Raw output
{"message": "[Google.Contractions] Use 'doesn't' instead of 'does not'.", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 103, "column": 14}}}, "severity": "INFO"}

Check notice on line 103 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L103

[Google.Acronyms] Spell out 'EVES', if it's unfamiliar to the audience.
Raw output
{"message": "[Google.Acronyms] Spell out 'EVES', if it's unfamiliar to the audience.", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 103, "column": 43}}}, "severity": "INFO"}

## References

## Implementation

This process is not yet implemented.

Check notice on line 109 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L109

[write-good.E-Prime] Try to avoid using 'is'.
Raw output
{"message": "[write-good.E-Prime] Try to avoid using 'is'.", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 109, "column": 14}}}, "severity": "INFO"}

Check notice on line 109 in EVES/drafts/EVES-005/eves-005.md

View workflow job for this annotation

GitHub Actions / vale

[vale] EVES/drafts/EVES-005/eves-005.md#L109

[Google.Contractions] Use 'isn't' instead of 'is not'.
Raw output
{"message": "[Google.Contractions] Use 'isn't' instead of 'is not'.", "location": {"path": "EVES/drafts/EVES-005/eves-005.md", "range": {"start": {"line": 109, "column": 14}}}, "severity": "INFO"}
2 changes: 1 addition & 1 deletion EVES/resources/eves-template.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
eves-identifier: 00X
title: Name describing the EVES
title: Name describing the EVES, prefixed with "ENVITED-X "
author: Name (@GitHub user)
discussions-to: https://github.com/ASCS-eV/EVES/issues/
status: Draft
Expand Down
7 changes: 4 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,8 @@ The process on how to write, submit or change specifications in defined in [EVES

| Number | Title | Type | Status |
| ------ | ----- | ---- | ------ |
| [001](./EVES/drafts/EVES-001/eves-001.md) | ENVITED Ecosystem Specification Process | Process | Draft |
| [001](./EVES/drafts/EVES-001/eves-001.md) | ENVITED-X Ecosystem Specification Process | Process | Draft |
| [002](./EVES/drafts/EVES-002/eves-002.md) | ENVITED-X Data Space Architecture Overview | Standards | Draft |
| [003](./EVES/drafts/EVES-003/eves-003.md) | ENVITED Asset Definition and Upload Process | Standards | Draft |
| [004](./EVES/drafts/EVES-004/eves-004.md) | ENVITED Roles and Responsibilities of EVES Editors | Process | Draft |
| [003](./EVES/drafts/EVES-003/eves-003.md) | ENVITED-X Asset Definition and Upload Process | Standards | Draft |
| [004](./EVES/drafts/EVES-004/eves-004.md) | ENVITED-X Roles and Responsibilities of EVES Editors | Process | Draft |
| [005](./EVES/drafts/EVES-005/eves-005.md) | ENVITED-X Contract Negotiation Process | Process | Draft |
Loading