Skip to main content

Node

A node is an independent HTTP server that implements the EWP API. It is the atomic participant in epress world.

Required Capabilities

A conformant EWP node MUST implement all of the following:

  • GET /ewp/profile — serve its canonical identity
  • GET /ewp/publications — serve its signed publication index
  • POST /ewp/publications — accept inbound publication notifications from followed publishers
  • GET /ewp/contents/:contentHash — serve content by hash
  • POST /ewp/connections — accept follow handshakes
  • DELETE /ewp/connections — accept connection termination requests
  • PATCH /ewp/nodes/:address — accept signed profile update payloads

Optional Capabilities

A conformant EWP node MAY implement:

  • GET /ewp/avatar — serve the node's avatar image

Node Profile

The profile is the public identity record of a node:

FieldTypeRequiredDescription
addressstringREQUIREDEthereum address in EIP-55 checksum format
urlstringREQUIREDCanonical HTTPS URL of this node
titlestringREQUIREDHuman-readable node name
descriptionstring | nullOPTIONALNode description. MUST be null when not set.
ewpVersionstringREQUIREDHighest EWP major version this node implements (e.g., "1")
createdAtstringREQUIREDISO 8601 UTC timestamp of node creation
updatedAtstringREQUIREDISO 8601 UTC timestamp of last signed profile update