lexicons and xrpc
lexicon
com.publicdomainrelay.temp.compute.secrets.getSecrets
The requester serves a contract's secrets bundle to its guest, whose setup-secrets.service fetches it at boot and again after a guest.secretsUpdated. The route carries the contract name as one more path segment: GET /xrpc/com.publicdomainrelay.temp.compute.secrets.getSecrets/<contract> on the requester's ingress. The bearer is the guest's workload identity token from its bidder's OIDC issuer (the issuer_uri of the bid's compute.config.wif.simple), with audience api://ATProto?actx=<requester DID> and a wid_sub claim equal to the VM's subject.
definitions: #entry
output
A JSON array of #entry: the bundle as the requester holds it, less the atirc agent's env file and iroh key until the requester has written them.
errors
| error | description |
|---|---|
AuthenticationRequired | 401: no bearer token. |
InvalidToken | 401: the token is not from the bid's issuer, has another audience, or names another subject. |
NotFound | 404: the requester runs no contract of that name with a secrets bundle. |
NotReady | 503: the requester is starting, or the contract's issuer and subject are not known yet. |
InternalError | 500: any other failure. |
#entry object
One file of the secrets bundle.
| field | type | description |
|---|---|---|
path * | string | The absolute path in the guest the file is written to. |
value * | string | The file's content. |
mode | string | The octal file mode, at most 0600. setup-secrets.sh writes every file 0600 whatever it says; only the sealed fallback (guest.secrets) applies it. |
used in
Compute Contract Flow - Complete Architecture Map, protocol: the atproto protocol of socialweb-computer, lexicons-market: one row per lexicon
raw schema: lexicons/com/publicdomainrelay/temp/compute/secrets/getSecrets.json
{
"lexicon": 1,
"id": "com.publicdomainrelay.temp.compute.secrets.getSecrets",
"defs": {
"main": {
"type": "query",
"description": "The requester serves a contract's secrets bundle to its guest, whose setup-secrets.service fetches it at boot and again after a guest.secretsUpdated. The route carries the contract name as one more path segment: GET /xrpc/com.publicdomainrelay.temp.compute.secrets.getSecrets/<contract> on the requester's ingress. The bearer is the guest's workload identity token from its bidder's OIDC issuer (the issuer_uri of the bid's compute.config.wif.simple), with audience api://ATProto?actx=<requester DID> and a wid_sub claim equal to the VM's subject.",
"output": {
"encoding": "application/json",
"description": "A JSON array of #entry: the bundle as the requester holds it, less the atirc agent's env file and iroh key until the requester has written them."
},
"errors": [
{
"name": "AuthenticationRequired",
"description": "401: no bearer token."
},
{
"name": "InvalidToken",
"description": "401: the token is not from the bid's issuer, has another audience, or names another subject."
},
{
"name": "NotFound",
"description": "404: the requester runs no contract of that name with a secrets bundle."
},
{
"name": "NotReady",
"description": "503: the requester is starting, or the contract's issuer and subject are not known yet."
},
{
"name": "InternalError",
"description": "500: any other failure."
}
]
},
"entry": {
"type": "object",
"description": "One file of the secrets bundle.",
"required": [
"path",
"value"
],
"properties": {
"path": {
"type": "string",
"description": "The absolute path in the guest the file is written to."
},
"value": {
"type": "string",
"description": "The file's content."
},
"mode": {
"type": "string",
"description": "The octal file mode, at most 0600. setup-secrets.sh writes every file 0600 whatever it says; only the sealed fallback (guest.secrets) applies it."
}
}
}
}
}