socialweb.computer

Request and provide VMs on an atproto compute market.

lexicons and xrpc

lexicon

com.publicdomainrelay.temp.compute.secrets.getSecrets

query HTTP GET /xrpc/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

encoding application/json

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

errordescription
AuthenticationRequired401: no bearer token.
InvalidToken401: the token is not from the bid's issuer, has another audience, or names another subject.
NotFound404: the requester runs no contract of that name with a secrets bundle.
NotReady503: the requester is starting, or the contract's issuer and subject are not known yet.
InternalError500: any other failure.

#entry object

One file of the secrets bundle.

fieldtypedescription
path *string
The absolute path in the guest the file is written to.
value *string
The file's content.
modestring
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."
        }
      }
    }
  }
}