socialweb.computer

Request and provide VMs on an atproto compute market.

lexicons and xrpc

lexicon

com.fedproxy.rbac

record key any

A requester's workload identity roles for the VMs of one accept, written in its own repo after the accept: each role lets the guest whose token carries the role's sub mint a token for the role's audience (the requester's getSecrets, a cluster node join). The winning bidder's guest control plane reads it by one getRecord at node.<accept rkey> (it lists the collection only for accepts older than 2026-10-30) and turns each role whose sub and iss match the guest into a grant. Record key: node.<accept rkey>; older records sit at secrets.<contract> or a TID.

definitions: #role #definition

record

fieldtypedescription
roles *unknown
An object from role name to #role: the VM's own role, plus <role>-node when the contract joins a cluster.
policiesunknown
An object from policy name to {meta, schemas}, the XRPC capability policies the fedproxy oauth-client-webapp (rp.fedproxy.com) enforces; the requester writes it empty.
createdAt *string datetime

#role object

One role of the record.

fieldtypedescription
role_namestring
The role name, the same as its key in roles.
definition *#definition

#definition object

Which guest token the role matches and what it grants.

fieldtypedescription
issstring
The OIDC issuer the guest's token must come from: the issuer_uri of the winning bid's compute.config.wif.simple. Empty matches any issuer.
audstring
The audience the guest may mint a token for, api://<api>?actx=<DID>: api://ATProto?actx=<requester DID> for getSecrets, the node audience of the cluster for a node join.
sub *string
The guest token's subject the role applies to, actx:<bidder>:plc:<requester>:role:<VM name>.
policiesarray of string
Names of the record's policies the role grants; the bidder's guest control plane makes them the token's scopes. The requester writes none.

used in

Compute Contract Flow - Complete Architecture Map, guest-events: events under a receipt, identity: signatures, key claims, associations, sign-in, protocol: the atproto protocol of socialweb-computer, market: the RFP flow, A provisioned workload never holds a long-lived secret

raw schema: lexicons/com/fedproxy/rbac.json
{
  "lexicon": 1,
  "id": "com.fedproxy.rbac",
  "defs": {
    "main": {
      "type": "record",
      "description": "A requester's workload identity roles for the VMs of one accept, written in its own repo after the accept: each role lets the guest whose token carries the role's sub mint a token for the role's audience (the requester's getSecrets, a cluster node join). The winning bidder's guest control plane reads it by one getRecord at node.<accept rkey> (it lists the collection only for accepts older than 2026-10-30) and turns each role whose sub and iss match the guest into a grant. Record key: node.<accept rkey>; older records sit at secrets.<contract> or a TID.",
      "key": "any",
      "record": {
        "type": "object",
        "required": [
          "roles",
          "createdAt"
        ],
        "properties": {
          "roles": {
            "type": "unknown",
            "description": "An object from role name to #role: the VM's own role, plus <role>-node when the contract joins a cluster."
          },
          "policies": {
            "type": "unknown",
            "description": "An object from policy name to {meta, schemas}, the XRPC capability policies the fedproxy oauth-client-webapp (rp.fedproxy.com) enforces; the requester writes it empty."
          },
          "createdAt": {
            "type": "string",
            "format": "datetime"
          }
        }
      }
    },
    "role": {
      "type": "object",
      "description": "One role of the record.",
      "required": [
        "definition"
      ],
      "properties": {
        "role_name": {
          "type": "string",
          "description": "The role name, the same as its key in roles."
        },
        "definition": {
          "type": "ref",
          "ref": "#definition"
        }
      }
    },
    "definition": {
      "type": "object",
      "description": "Which guest token the role matches and what it grants.",
      "required": [
        "sub"
      ],
      "properties": {
        "iss": {
          "type": "string",
          "description": "The OIDC issuer the guest's token must come from: the issuer_uri of the winning bid's compute.config.wif.simple. Empty matches any issuer."
        },
        "aud": {
          "type": "string",
          "description": "The audience the guest may mint a token for, api://<api>?actx=<DID>: api://ATProto?actx=<requester DID> for getSecrets, the node audience of the cluster for a node join."
        },
        "sub": {
          "type": "string",
          "description": "The guest token's subject the role applies to, actx:<bidder>:plc:<requester>:role:<VM name>."
        },
        "policies": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Names of the record's policies the role grants; the bidder's guest control plane makes them the token's scopes. The requester writes none."
        }
      }
    }
  }
}