ServerDiscoveryService
Chatto exposes this service below /api/connect.
Shared message and enum definitions are documented in Shared Types And Enums.
ServerDiscoveryService
Section titled “ServerDiscoveryService”Provides unauthenticated server discovery metadata.
GetServer
Section titled “GetServer”Returns public server metadata, branding, registration status, and login provider information. This fully public RPC is available before login so clients can render the first server screen and authentication choices.
POST /api/connect/chatto.discovery.v1.ServerDiscoveryService/GetServerInput: GetServerRequest
Section titled “Input: GetServerRequest”Request for public server metadata.
Result: GetServerResponse
Section titled “Result: GetServerResponse”Public metadata clients need before they can authenticate or render the initial server view.
| Field | Type | Description |
|---|---|---|
profile | chatto.api.v1.ServerPublicProfile | Public server profile and branding. |
login | chatto.api.v1.ServerLogin | Login and registration options. |
setup_required | bool | Whether first-run setup is available before normal registration. |
ListFeatures
Section titled “ListFeatures”Lists product features without requiring a session. Clients may load this catalog on demand and cache it by server software version, locale, and version filter. Refresh when any of those values change. Older servers can return UNIMPLEMENTED; this does not prevent normal chat use.
POST /api/connect/chatto.discovery.v1.ServerDiscoveryService/ListFeaturesInput: ListFeaturesRequest
Section titled “Input: ListFeaturesRequest”Optional filters for the public feature catalog.
| Field | Type | Description |
|---|---|---|
locale | optional string | BCP 47 language tag for feature names and descriptions. The server tries this locale, its parents, then English. Invalid or unsupported locales, and omitted values, use English. |
introduced_after_version | optional string | Return only features introduced strictly after this Chatto release. Omit for the complete catalog. Must be a full Semantic Version, including any prerelease stage; invalid or empty values are INVALID_ARGUMENT. Third-party clients should omit this filter and use stable feature IDs. |
Result: ListFeaturesResponse
Section titled “Result: ListFeaturesResponse”Advisory features supported by this server software, in display order. An empty list means no entries match, not that every feature is supported.
| Field | Type | Description |
|---|---|---|
features | repeated ServerFeature | Product metadata, not a complete API capability declaration. |
ListNeighbors
Section titled “ListNeighbors”Returns the public Neighbor directory without requiring a session.
POST /api/connect/chatto.discovery.v1.ServerDiscoveryService/ListNeighborsInput: ListNeighborsRequest
Section titled “Input: ListNeighborsRequest”Request for the public Neighbor directory.
Result: ListNeighborsResponse
Section titled “Result: ListNeighborsResponse”Publicly advertised servers. The response has no ordering contract.
| Field | Type | Description |
|---|---|---|
origins | repeated string | Canonical origins of the advertised servers. |
ListNeighborhoodServers
Section titled “ListNeighborhoodServers”Returns the Neighborhood without requiring a session. The server contacts other servers in the background and caches the result. A call does not contact other servers, so a client can show the Neighborhood without revealing the user’s network address to those servers. The server refreshes the Neighborhood at least once per hour and soon after its Neighbors change.
POST /api/connect/chatto.discovery.v1.ServerDiscoveryService/ListNeighborhoodServersInput: ListNeighborhoodServersRequest
Section titled “Input: ListNeighborhoodServersRequest”Request for the Neighborhood that this server has discovered.
Result: ListNeighborhoodServersResponse
Section titled “Result: ListNeighborhoodServersResponse”Servers that the called server discovered through its Neighbors. The called server lists each of its Neighbors whose public profile loaded. It also lists servers that a mutually advertising Neighbor recommends when the recommendation is also mutual. The response has no ordering contract.
| Field | Type | Description |
|---|---|---|
servers | repeated NeighborhoodServer | Servers in the Neighborhood. |
refreshed_at | google.protobuf.Timestamp | Time when the called server last completed Neighborhood discovery. Absent before the first completed discovery. |