socialweb.computer

Request and provide VMs on an atproto compute market.

lexicons and xrpc

lexicon

com.fedproxy.temp.xrpc.registration

object

A subscriber's signed registration: built by the subscriber (bidder or requester) from a com.fedproxy.temp.xrpc.getRegistrationNonce nonce and sent as JSON text in the registration parameter of com.fedproxy.temp.xrpc.subscribe, where the relay checks it. It is accepted when key and nonce are present, the nonce is known, unexpired and was issued for key, and at least one entry of signatures verifies over the nonce bytes, whoever its signer is (the relay does not require the signer to be key); the nonce is then used up. The $type com.fedproxy.temp.xrpc.registration the subscriber sets is not checked. A refusal closes the subscribe socket with code 1008 and registration rejected: <reason> (missing key, missing nonce, unknown or expired nonce, nonce was issued for a different key, no signatures provided, nonce is not base64, no signature verifies over the nonce).

definitions: #signature

fieldtypedescription
key *string did
The DID being registered; it must equal the nonce request's key and the subscribe did parameter.
nonce *string
The nonce exactly as getRegistrationNonce returned it (standard base64).
signatures *array of #signature
Signatures over the decoded nonce bytes; one that verifies is enough. The subscriber sends one, by key.

#signature object

One signature over a registration nonce, with the DID whose key made it; an entry with an empty key or signature, an unresolvable key or a signature that is not base64 is skipped.

fieldtypedescription
key *string did
The signer: a did:key (its public key is the DID itself), or another DID whose atproto signing key the relay resolves from its DID document (resolved again once, after a cache purge, when no signature verifies).
signature *string
The signature (atproto crypto: SHA-256 of the nonce bytes, signed with the P-256 or K-256 key, compact r||s with low S), standard base64 with padding.

used in

no page of these docs names it yet.

raw schema: lexicons/com/fedproxy/temp/xrpc/registration.json
{
  "lexicon": 1,
  "id": "com.fedproxy.temp.xrpc.registration",
  "defs": {
    "main": {
      "type": "object",
      "description": "A subscriber's signed registration: built by the subscriber (bidder or requester) from a com.fedproxy.temp.xrpc.getRegistrationNonce nonce and sent as JSON text in the registration parameter of com.fedproxy.temp.xrpc.subscribe, where the relay checks it. It is accepted when key and nonce are present, the nonce is known, unexpired and was issued for key, and at least one entry of signatures verifies over the nonce bytes, whoever its signer is (the relay does not require the signer to be key); the nonce is then used up. The $type com.fedproxy.temp.xrpc.registration the subscriber sets is not checked. A refusal closes the subscribe socket with code 1008 and registration rejected: <reason> (missing key, missing nonce, unknown or expired nonce, nonce was issued for a different key, no signatures provided, nonce is not base64, no signature verifies over the nonce).",
      "required": [
        "key",
        "nonce",
        "signatures"
      ],
      "properties": {
        "key": {
          "type": "string",
          "format": "did",
          "description": "The DID being registered; it must equal the nonce request's key and the subscribe did parameter."
        },
        "nonce": {
          "type": "string",
          "description": "The nonce exactly as getRegistrationNonce returned it (standard base64)."
        },
        "signatures": {
          "type": "array",
          "items": {
            "type": "ref",
            "ref": "#signature"
          },
          "description": "Signatures over the decoded nonce bytes; one that verifies is enough. The subscriber sends one, by key."
        }
      }
    },
    "signature": {
      "type": "object",
      "description": "One signature over a registration nonce, with the DID whose key made it; an entry with an empty key or signature, an unresolvable key or a signature that is not base64 is skipped.",
      "required": [
        "key",
        "signature"
      ],
      "properties": {
        "key": {
          "type": "string",
          "format": "did",
          "description": "The signer: a did:key (its public key is the DID itself), or another DID whose atproto signing key the relay resolves from its DID document (resolved again once, after a cache purge, when no signature verifies)."
        },
        "signature": {
          "type": "string",
          "description": "The signature (atproto crypto: SHA-256 of the nonce bytes, signed with the P-256 or K-256 key, compact r||s with low S), standard base64 with padding."
        }
      }
    }
  }
}