Peer-of-peer discovery — list of peers we've opted to share

GET

/federation/peers/visible

• Local development behind nginx (port 8088 by default)

Public unauthenticated endpoint. Returns the subset of our connected+enabled peers that have share_in_visible_list toggled on. Other instances poll this to build their “Suggested peers (via this instance)” feed per ADR 0043.

Per the spec these are advisory ONLY — a listed peer is a discovery hint, not a trust endorsement. Pairing still goes through the handshake from 1.22.B-b.

Responses

200

List of visible peers.

object

peers

required

Array<object>

Minimal projection of a peer for /federation/peers/visible. Public — no auth required to fetch. Excludes operator- private fields like notes or trust_tier.

object

instance_url

required

string

display_name

required

string

instance_public_key

required

string

fingerprint

required

string