Lexicon Garden

com.fedproxy.temp.xrpc.subscribe

Open a relay channel. The subscriber presents a com.fedproxy.temp.xrpc.registration: a record signed (network.attested.signature) over the nonce previously issued by com.fedproxy.temp.xrpc.getRegistrationNonce. The relay verifies the registration's signatures against the issued nonce and the did:key, then binds the WebSocket to that key. On connect the relay sends a #registered frame with the assigned serviceId/proxyRef; subsequent #request frames carry inbound XRPC calls the subscriber answers with #response frames.

Repository @johnandersen777.bsky.social did:plc:5svqtrhheairglgiiyvutzik namespace authority
Details · subscription
Kindsubscription
Authorityxrpc.temp.fedproxy.com
Indexed
Compare Edit in builder → Fork →

Subscription

subscription · WebSocket

Parameters

query string

registration

requiredstring

The full com.fedproxy.temp.xrpc.registration object as URL-encoded JSON, signing the nonce from getRegistrationNonce. Sent inline (not an AT-URI) so the subscriber needs no PDS to host the record.

Messages

DAG-CBOR frames

#registered

object

First frame sent by the relay on connect, assigning this subscriber a serviceId.

#request

object

An inbound XRPC call relayed to the subscriber to handle.

#response

object

The subscriber's reply to a #request, keyed by the same requestId.

Errors

InvalidRequest

Malformed or missing registration.

Unauthorized

Registration signatures do not verify against the issued nonce or did:key, or the nonce is unknown/expired.

#registered

object

First frame sent by the relay on connect, assigning this subscriber a serviceId.

Properties

proxyRef

requiredstring

did:web:HOST#serviceId value callers pass as the atproto-proxy header to route XRPC calls to this subscriber.

serviceId

requiredstring

Opaque id the relay assigns to this subscriber for the connection lifetime.

#request

object

An inbound XRPC call relayed to the subscriber to handle.

Properties

body

unknown

callerDid

requiredstring · did

method

requiredstring

nsid

requiredstring · nsid

params

requiredunknown

Query params as a map of string keys to string values.

requestId

requiredstring

#response

object

The subscriber's reply to a #request, keyed by the same requestId.

Properties

body

unknown

contentType

string

requestId

requiredstring

status

requiredinteger

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

  • com.fedproxy.temp.xrpc.registration

    record

    A subscriber's signed registration. Proves custody of the did:key by carrying badge.blue attestations (network.attested.signature) over the nonce returned from com.fedproxy.temp.xrpc.getRegistrationNonce. Presented as the parameter to com.fedproxy.temp.xrpc.subscribe to open a relay channel bound to this key.

  • com.fedproxy.temp.xrpc.getRegistrationNonce

    procedure

    Request a one-time registration nonce from the relay before subscribing. The caller presents its did:key and badge.blue attestations (network.attested.signature) over its own key material; the relay replies with a crypto-secure random nonce and its own attestations over that nonce. The subscriber then signs the returned nonce and presents the resulting com.fedproxy.temp.xrpc.registration record as the parameter to com.fedproxy.temp.xrpc.subscribe, proving liveness and key custody and binding the