socialweb.computer

Request and provide VMs on an atproto compute market.

lexicons and xrpc

lexicon

com.fedproxy.temp.xrpc.getRegistrationNonce

procedure HTTP POST /xrpc/com.fedproxy.temp.xrpc.getRegistrationNonce

Issues a registration nonce: served by the did:key ingress relay on its own hostname, called by a subscriber (bidder or requester) as a POST right before it opens com.fedproxy.temp.xrpc.subscribe. The nonce is bound to the key it was asked for, can be used for one successful registration, and expires after 60 s (the relay's nonce TTL). Requires a service-auth JWT in the Authorization header as Bearer (ES256K or ES256, aud did:web:<relay hostname>, lxm com.fedproxy.temp.xrpc.getRegistrationNonce, exp required). Any other method than POST is answered 404.

input

encoding application/json

fieldtypedescription
key *string did
The DID the subscriber will register (its did:key, or a DID whose atproto signing key signs the nonce); it must start with did:.
signaturesarray of com.fedproxy.temp.xrpc.registration#signature
Read and ignored; the subscriber sends an empty array.

output

encoding application/json

fieldtypedescription
nonce *string
64 random bytes, standard base64 with padding; the subscriber signs the decoded bytes, not this text.
signatures *array of com.fedproxy.temp.xrpc.registration#signature
Always an empty array: the relay does not sign the nonce.

errors

errordescription
AuthenticationRequired401: the Authorization header is missing or not Bearer <token>, or the service-auth token does not verify (signature, aud, lxm, exp).
InvalidRequest400: key is missing or does not start with did: (also when the body is not JSON).

used in

no page of these docs names it yet.

raw schema: lexicons/com/fedproxy/temp/xrpc/getRegistrationNonce.json
{
  "lexicon": 1,
  "id": "com.fedproxy.temp.xrpc.getRegistrationNonce",
  "defs": {
    "main": {
      "type": "procedure",
      "description": "Issues a registration nonce: served by the did:key ingress relay on its own hostname, called by a subscriber (bidder or requester) as a POST right before it opens com.fedproxy.temp.xrpc.subscribe. The nonce is bound to the key it was asked for, can be used for one successful registration, and expires after 60 s (the relay's nonce TTL). Requires a service-auth JWT in the Authorization header as Bearer (ES256K or ES256, aud did:web:<relay hostname>, lxm com.fedproxy.temp.xrpc.getRegistrationNonce, exp required). Any other method than POST is answered 404.",
      "input": {
        "encoding": "application/json",
        "schema": {
          "type": "object",
          "required": [
            "key"
          ],
          "properties": {
            "key": {
              "type": "string",
              "format": "did",
              "description": "The DID the subscriber will register (its did:key, or a DID whose atproto signing key signs the nonce); it must start with did:."
            },
            "signatures": {
              "type": "array",
              "items": {
                "type": "ref",
                "ref": "com.fedproxy.temp.xrpc.registration#signature"
              },
              "description": "Read and ignored; the subscriber sends an empty array."
            }
          }
        }
      },
      "output": {
        "encoding": "application/json",
        "schema": {
          "type": "object",
          "required": [
            "nonce",
            "signatures"
          ],
          "properties": {
            "nonce": {
              "type": "string",
              "description": "64 random bytes, standard base64 with padding; the subscriber signs the decoded bytes, not this text."
            },
            "signatures": {
              "type": "array",
              "items": {
                "type": "ref",
                "ref": "com.fedproxy.temp.xrpc.registration#signature"
              },
              "description": "Always an empty array: the relay does not sign the nonce."
            }
          }
        }
      },
      "errors": [
        {
          "name": "AuthenticationRequired",
          "description": "401: the Authorization header is missing or not Bearer <token>, or the service-auth token does not verify (signature, aud, lxm, exp)."
        },
        {
          "name": "InvalidRequest",
          "description": "400: key is missing or does not start with did: (also when the body is not JSON)."
        }
      ]
    }
  }
}