com.fedproxy.temp.xrpc.getRegistrationNonce

johnandersen777.bsky.social

Documentation

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 WebSocket session to the key.

main 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 WebSocket session to the key.

Input

Encodingapplication/json
key string Required

did:key public-key reference the caller will use to sign the returned nonce.

Output

Encodingapplication/json
nonce bytes Required

Crypto-secure random nonce, 64 bytes, that the caller must sign to complete registration.

Errors

InvalidRequest Malformed body, missing fields, or unverifiable caller signatures.
Try It

Requests are sent directly from your browser. Some servers may block requests due to CORS.

Base URL for XRPC calls (e.g., https://bsky.social)
Enter valid JSON for the request body
View raw schema 
{
  "type": "procedure",
  "input": {
    "schema": {
      "type": "object",
      "required": [
        "key",
        "signatures"
      ],
      "properties": {
        "key": {
          "type": "string",
          "description": "did:key public-key reference the caller will use to sign the returned nonce."
        },
        "signatures": {
          "ref": "network.attested.signature#signatures",
          "type": "ref",
          "description": "badge.blue attestations (network.attested.signature) presented by the caller over its key material."
        }
      }
    },
    "encoding": "application/json"
  },
  "errors": [
    {
      "name": "InvalidRequest",
      "description": "Malformed body, missing fields, or unverifiable caller signatures."
    }
  ],
  "output": {
    "schema": {
      "type": "object",
      "required": [
        "nonce",
        "signatures"
      ],
      "properties": {
        "nonce": {
          "type": "bytes",
          "description": "Crypto-secure random nonce, 64 bytes, that the caller must sign to complete registration."
        },
        "signatures": {
          "ref": "network.attested.signature#signatures",
          "type": "ref",
          "description": "badge.blue attestations (network.attested.signature) from the relay over the issued nonce."
        }
      }
    },
    "encoding": "application/json"
  },
  "description": "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 WebSocket session to the key."
}

Lexicon Garden

@