Skip to content

docs: describe protocol error codes and data plane signaling retries - #255

Merged
wolf4ood merged 1 commit into
eclipse-edc:mainfrom
wolf4ood:docs/protocol_error_handling
Nov 13, 2026
Merged

wolf4ood merged 1 commit into
eclipse-edc:mainfrom
wolf4ood:docs/protocol_error_handling

Conversation

@wolf4ood

Copy link
Copy Markdown
Contributor

What this PR changes

  • Control Plane > Reliable Messaging: how a connector answers protocol messages (400 for an invalid state transition, 404 when the process does not exist or the client is not authorized, 401 for catalog requests, 503 when the message can't be processed now), and how the sender reacts to 4xx, 5xx and timeouts.
  • Data Plane > Data Plane Signaling: which failed signals are retried by the state machine, and why slow data planes should answer asynchronously.
  • State Machines Known Limitations: a signal whose response was lost is rejected by the data plane when sent again, and retries select the data plane again.
  • Contributors > Data plane integration: how signaling failures map to ERROR_RETRY / FATAL_ERROR; the provider sends start from INITIAL, not STARTING.

Why

Further notes

List other areas of code that have changed but are not necessarily linked to the main feature. This could be method
signature changes, package declarations, bugs that were encountered and were fixed inline, etc.

Who will sponsor this feature?

Please @-mention the committer that will sponsor your feature.

Linked Issue(s)

Closes # <-- insert Issue number if one exists

Please be sure to take a look at the contributing guidelines and our etiquette for pull requests.

@wolf4ood
wolf4ood marked this pull request as ready for review November 13, 2026 15:22
@wolf4ood
wolf4ood requested a review from a team as a code owner November 13, 2026 15:22
@wolf4ood
wolf4ood merged commit 84669ba into eclipse-edc:main Nov 13, 2026
4 checks passed
@wolf4ood
wolf4ood deleted the docs/protocol_error_handling branch November 13, 2026 16:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants