Skip to main content

Protocol Versioning

The current protocol version is EWP 1.

The ewpVersion field in GET /ewp/profile responses indicates the highest EWP major version a node implements, expressed as a decimal integer string (e.g., "1", "2").

Versioning Rules​

  • Backward-compatible additions (new optional fields, new optional endpoints) do not require a version bump
  • Breaking changes (removed fields, changed message semantics, incompatible type changes) require a major version increment
  • Nodes that implement a higher version MUST continue to accept and correctly process EWP 1 messages from older nodes

EWP Improvement Proposals (EWIPs)​

Protocol enhancements are proposed and tracked as EWP Improvement Proposals. Each EWIP specifies the minimum ewpVersion required by the change.

See CONTRIBUTING.md and proposals/README.md.