Skip to content

feat: endpoint groups and attributes#86

Draft
b5 wants to merge 1 commit into
mainfrom
b5/endpoint-groups-and-attributes
Draft

feat: endpoint groups and attributes#86
b5 wants to merge 1 commit into
mainfrom
b5/endpoint-groups-and-attributes

Conversation

@b5
Copy link
Copy Markdown
Member

@b5 b5 commented May 17, 2026

Add cloud-side metadata for client endpoints beyond the existing name: a single group and an arbitrary key-value attributes map. Both are settable at build time via ClientBuilder::group / attributes and updatable post-construction via Client::set_group / set_attributes, mirroring the name API. Attributes use full-replace semantics on each call. Adds matching SetGroup / SetAttributes RPC messages to the protocol, plus an endpoint_meta example that exercises both paths.

Group names follow the same 2–128 byte UTF-8 rules as endpoint names. Attribute keys share those rules; values may be empty and are capped at 128 bytes; the map is capped at 128 entries.

Description

Breaking Changes

Notes & open questions

Change checklist

  • Self-review.
  • Documentation updates following the style guide, if relevant.
  • Tests if relevant.
  • All breaking changes documented.

Add cloud-side metadata for client endpoints beyond the existing name:
a single `group` and an arbitrary key-value `attributes` map. Both are
settable at build time via `ClientBuilder::group` / `attributes` and
updatable post-construction via `Client::set_group` / `set_attributes`,
mirroring the name API. Attributes use full-replace semantics on each
call. Adds matching `SetGroup` / `SetAttributes` RPC messages to the
protocol, plus an `endpoint_meta` example that exercises both paths.

Group names follow the same 2–128 byte UTF-8 rules as endpoint names.
Attribute keys share those rules; values may be empty and are capped at
128 bytes; the map is capped at 128 entries.
@github-actions
Copy link
Copy Markdown

Documentation for this PR has been generated and is available at: https://n0-computer.github.io/iroh-services/pr/86/docs/iroh_services/

Last updated: 2026-05-17T22:28:50Z

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.

1 participant