lexicons and xrpc
lexicon
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
| field | type | description |
|---|---|---|
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:. |
signatures | array of com.fedproxy.temp.xrpc.registration#signature | Read and ignored; the subscriber sends an empty array. |
output
| field | type | description |
|---|---|---|
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
| error | description |
|---|---|
AuthenticationRequired | 401: the Authorization header is missing or not Bearer <token>, or the service-auth token does not verify (signature, aud, lxm, exp). |
InvalidRequest | 400: 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)."
}
]
}
}
}