socialweb.computer

Request and provide VMs on an atproto compute market.

lexicons and xrpc

lexicon

com.publicdomainrelay.temp.market.offering

record key any

A bidder announces the payload collections it bids on and where it takes RFPs. Writers use rkey self; readers read self and the record the bidder's heartbeat names.

definitions: #endpoint

record

fieldtypedescription
endpointsarray of #endpoint
Where requesters call the bidder's market XRPC, in the bidder's order of preference. Service auth for any of them has aud <bidder DID>#pdr_temp_market (#pdr_temp_compute_event for submitEvent).
ingressarray of com.atproto.repo.strongRef
The bidder's com.publicdomainrelay.temp.ingress.webRTC listen records, including the STUN servers it gathers with; the bidder writes none today and publishes a computer.socialweb.ingress.listen record (a webrtc endpoint) instead.
appliesTo *array of string nsid
The payload collections the bidder bids on.
items.format nsid
maxCpusinteger
The most vCPUs one compute.vm may ask for; the bidder refuses an RFP that asks for more. Absent: no limit advertised.
minimum 1
maxMemstring
The most memory one compute.vm may ask for, such as 16G; the bidder refuses an RFP that asks for more. Absent: no limit advertised.
nestedVirtboolean
The bidder's VMs can run VMs of their own (QEMU on a host with KVM nested virtualization on). A requester whose compute.vm sets nestedVirt skips a bidder without it; the bidder refuses such an RFP.
imagesboolean
The bidder boots a requester-chosen VM image (compute.vm image) for its guest image target. A requester whose compute.vm sets image skips a bidder without it; the bidder refuses such an RFP.
createdAt *string datetime
refreshedAtstring datetime
withdrawnAtstring datetime
Set when the bidder stopped taking RFPs; appliesTo is empty then.

#endpoint object

fieldtypedescription
kind *string
iroh: HTTP/1.1 over dumbpipe connect <address>; https: an http(s) origin; webrtc: signaling through the bidder's computer.socialweb.ingress.listen record.
knownValues ["iroh","webrtc","https"]
address *string
iroh: a short endpoint ticket (endpoint id and relay URLs, no IP addresses); https: an absolute http(s) URL without userinfo; webrtc: unpadded base64url of the JSON {did, listen}, the DID and rkey of a computer.socialweb.ingress.listen record (the bidder writes listen market).
maxLength 2048

used in

How it works, Compute Contract Flow - Complete Architecture Map, flow: one compute contract, end to end, identity: signatures, key claims, associations, sign-in, lexicons-market: one row per lexicon, market: the RFP flow, policy: policy records, attached policies, tangled-vouch, Four signed hops, one verifiable contract., A marketplace made of records., Open RFPs, live from the firehose

raw schema: lexicons/com/publicdomainrelay/temp/market/offering.json
{
  "lexicon": 1,
  "id": "com.publicdomainrelay.temp.market.offering",
  "description": "A bidder announces the payload collections it bids on and where it takes RFPs. Writers use rkey self; readers read self and the record the bidder's heartbeat names.",
  "defs": {
    "main": {
      "type": "record",
      "key": "any",
      "record": {
        "type": "object",
        "required": [
          "appliesTo",
          "createdAt"
        ],
        "properties": {
          "endpoints": {
            "type": "array",
            "items": {
              "type": "ref",
              "ref": "#endpoint"
            },
            "description": "Where requesters call the bidder's market XRPC, in the bidder's order of preference. Service auth for any of them has aud <bidder DID>#pdr_temp_market (#pdr_temp_compute_event for submitEvent)."
          },
          "ingress": {
            "type": "array",
            "items": {
              "type": "ref",
              "ref": "com.atproto.repo.strongRef"
            },
            "description": "The bidder's com.publicdomainrelay.temp.ingress.webRTC listen records, including the STUN servers it gathers with; the bidder writes none today and publishes a computer.socialweb.ingress.listen record (a webrtc endpoint) instead."
          },
          "appliesTo": {
            "type": "array",
            "description": "The payload collections the bidder bids on.",
            "items": {
              "type": "string",
              "format": "nsid"
            }
          },
          "maxCpus": {
            "type": "integer",
            "minimum": 1,
            "description": "The most vCPUs one compute.vm may ask for; the bidder refuses an RFP that asks for more. Absent: no limit advertised."
          },
          "maxMem": {
            "type": "string",
            "description": "The most memory one compute.vm may ask for, such as 16G; the bidder refuses an RFP that asks for more. Absent: no limit advertised."
          },
          "nestedVirt": {
            "type": "boolean",
            "description": "The bidder's VMs can run VMs of their own (QEMU on a host with KVM nested virtualization on). A requester whose compute.vm sets nestedVirt skips a bidder without it; the bidder refuses such an RFP."
          },
          "images": {
            "type": "boolean",
            "description": "The bidder boots a requester-chosen VM image (compute.vm image) for its guest image target. A requester whose compute.vm sets image skips a bidder without it; the bidder refuses such an RFP."
          },
          "createdAt": {
            "type": "string",
            "format": "datetime"
          },
          "refreshedAt": {
            "type": "string",
            "format": "datetime"
          },
          "withdrawnAt": {
            "type": "string",
            "format": "datetime",
            "description": "Set when the bidder stopped taking RFPs; appliesTo is empty then."
          }
        }
      }
    },
    "endpoint": {
      "type": "object",
      "required": [
        "kind",
        "address"
      ],
      "properties": {
        "kind": {
          "type": "string",
          "knownValues": [
            "iroh",
            "webrtc",
            "https"
          ],
          "description": "iroh: HTTP/1.1 over dumbpipe connect <address>; https: an http(s) origin; webrtc: signaling through the bidder's computer.socialweb.ingress.listen record."
        },
        "address": {
          "type": "string",
          "maxLength": 2048,
          "description": "iroh: a short endpoint ticket (endpoint id and relay URLs, no IP addresses); https: an absolute http(s) URL without userinfo; webrtc: unpadded base64url of the JSON {did, listen}, the DID and rkey of a computer.socialweb.ingress.listen record (the bidder writes listen market)."
        }
      }
    }
  }
}