socialweb.computer

Request and provide VMs on an atproto compute market.

lexicons and xrpc

reference

Lexicons

Every record, object and XRPC method of the socialweb.computer market, generated from the repository's lexicons/ (100 lexicons). XRPC methods only: xrpc.

com.publicdomainrelay.temp.* 60

com.publicdomainrelay.temp.auth.allowlist

rbacDidrecord not in useNot in use: an RBAC allowlist record of the earlier TypeScript market ({protects, allowed, createdAt} in the records it left).

com.publicdomainrelay.temp

badgeBlueKeysrecordBinds a signing key to the repository DID, so that records signed with the key verify as the DID's.

com.publicdomainrelay.temp.cluster

controlPlaneDownprocedureThe gateway takes the named cluster's control plane down: it flips its desired state to not-running and dematerialises the process group.
controlPlaneUpprocedureThe gateway brings the named cluster's control plane up: it flips the Cluster's desired state to running and materialises its process group and objects, in order.
createClusterprocedureThe gateway creates the named cluster of the calling account and leaves it RUNNING, in one call.
deleteClusterprocedureThe gateway begins the teardown of the named cluster of the calling account.
getKubeconfigprocedureThe gateway returns a kubeconfig for the named cluster of the calling account.
listClustersqueryThe gateway lists the calling account's clusters.
listKubeconfigsqueryThe gateway lists the kubeconfigs issued for the named cluster of the calling account: one ClusterClientCertificate record per kubeconfig, revoked ones included.
revokeIdentityprocedureThe gateway revokes the calling identity's access: it writes the deny record FIRST, then deletes the ServiceAccount and the name-keyed artifacts, and leaves the grant record in a terminal Revoked state rather than deleting it.
revokeKubeconfigprocedureThe gateway revokes one kubeconfig of the named cluster of the calling account: it sets spec.revoked on its ClusterClientCertificate record.
subscribeClusterssubscriptionThe gateway streams the calling account's cluster state as an atproto event stream (binary WebSocket frames, each a DRISL-CBOR header then a DRISL-CBOR payload).

com.publicdomainrelay.temp.compute.config.wif

simplerecordA bid's workload identity config, written by the bidder next to every market.bid and named by the bid's config strongRef: the OIDC issuer of the guest's tokens and the subject format they carry.

com.publicdomainrelay.temp.compute.events.guest

agentStartrecordThe requester asks the guest agent to start the guest's agent unit (the contract's spec.agent); sent as the payload of a market.event.
imagerecordThe guest reports the image it booted: the marker in its /etc/swc-image; sent as the payload of a market.event.
memoryPressurerecordThe guest crossed a memory threshold (edge-triggered: one record per crossing, re-armed only after the value stayed under half the threshold for 5 min; at most one per kind per 10 min and ten memory events per contract); sent as the payload of a market.event.
oomKillrecordThe guest kernel's OOM killer killed a process (/proc/vmstat oom_kill rose); sent as the payload of a market.event.
publicKeyrecordA party to a contract publishes an encryption public key for one tag; sent as the payload of a market.event.
r2ReleaserecordThe requester, releasing its contract, asks the guest agent to release every contract the guest requester holds before the guest goes away; the guest answers with compute.events.guest.r2Released.
r2ReleasedrecordThe guest reports that its guest requester released its contracts (or holds none) after a compute.events.guest.r2Release; sent as the payload of a market.event.
r2StartrecordThe requester asks the guest agent to start the guest requester (socialweb-r2.service, run request --guest-requester as the r2 user) of a contract with spec.association.fromGuest; sent as the payload of a market.event.
requesterDidrecordThe guest reports the repo DID of the requester it runs, so the contract's requester can associate it (spec.association.fromGuest); sent as the payload of a market.event.
secretsrecordThe requester's secrets bundle for the guest, sealed to the guest's latest compute.events.guest.publicKey with tag secrets; sent as the payload of a market.event.
secretsAppliedrecordThe guest wrote the files of its secrets bundle; sent as the payload of a market.event.
secretsRequestedrecordThe guest asks the requester for its secrets bundle sealed to its compute.events.guest.publicKey with tag secrets, because the requester has no inbound endpoint (comms mode Firehose); sent as the payload of a market.event.
secretsUpdatedrecordThe requester changed the contract's secrets bundle (the association ref of spec.association); the guest fetches it again through getSecrets, or asks for the sealed fallback; sent as the payload of a market.event.
signalWebRTCrecordA sealed WebRTC session description for one tunnel; sent as the payload of a market.event.

com.publicdomainrelay.temp.compute.events.vm

deleterecordThe requester asks the bidder to delete the VM of a contract; sent as the payload of a market.event.
hostKeysrecordThe bidder reports the VM's SSH host keys; sent as the payload of a market.event.
memoryPressurerecordThe bidder reports that the VM's host cgroup crossed a memory threshold (memory.events high or max increased); sent as the payload of a market.event, edge-triggered and capped per contract.
onNetworkrecordThe bidder reports a network address of the VM; sent as the payload of a market.event.
oomKilledrecordThe bidder reports that the kernel OOM-killed processes in the VM's host cgroup (memory.events oom_kill increased); sent as the payload of a market.event, one per new kill count, capped per contract.
sandboxrecordA deno sandbox reports that its program ended, with its output; sent as the payload of a market.event.
terminatedrecordThe bidder reports that the VM stopped; sent as the payload of a market.event.

com.publicdomainrelay.temp.compute.guest

subscribeEventssubscriptionServed by the bidder's GuestControlPlane to a guest holding a workload identity token (in the Authorization header only): streams the requester-authored compute.events.guest.* payloads for that guest's contract, in order, after cursor.

com.publicdomainrelay.temp.compute.secrets

getSecretsqueryThe requester serves a contract's secrets bundle to its guest, whose setup-secrets.service fetches it at boot and again after a guest.secretsUpdated.

com.publicdomainrelay.temp.compute

vmrecordA requested virtual machine: the payload of a compute RFP.

com.publicdomainrelay.temp.ingress

webRTCrecordA requester's WebRTC ingress descriptor (listen) or one session of it (offer from the requester, answer from a bidder), named in the ingress[] of the market calls.

com.publicdomainrelay.temp.keepalive

pingqueryThe did:key ingress relay's keepalive: on a timer it sends each connected subscriber a request frame for GET /xrpc/com.publicdomainrelay.temp.keepalive.ping (no params, headers or body) through its com.fedproxy.temp.xrpc.subscribe socket, and ignores the answer.

com.publicdomainrelay.temp.market

acceptrecordA requester's signed accept of one bid on its RFP, in its own repo.
associationrecordThe grant: the repository that holds this record (the principal) trusts the agent DID as its agent, beside the link.ident.endorsement at the same record key.
associationRequestrecordThe repository that holds this record asks the principal to endorse and grant it for one contract: the proof that the subject DID of a com.publicdomainrelay.temp.compute.events.guest.requesterDid event controls this repository.
bidrecordA bid on an RFP, written by the bidder.
eventrecordAn event envelope under a receipt; the payload is a compute.events record.
heartbeatrecordA bidder's liveness beat for its offering, rewritten at rkey self.
offeringrecordA bidder announces the payload collections it bids on and where it takes RFPs.
receiptrecordThe bidder's receipt for an accept.
relaysrecordThe relays a participant crawls and asks others to crawl, read in market discovery.
rfprecordA request for proposals: the requester asks bidders to bid on the payload.
submitAcceptprocedureA requester submits its accept of a bid to the bidder, which records a provisioning intent and answers 202 at once.
submitBidprocedureA bidder submits a bid it wrote to the requester.
submitEventprocedureA contract party submits a market.event it wrote to the other party.
submitRfpprocedureA requester submits an RFP to a bidder.

com.publicdomainrelay.temp.market.accepts

freerecord not in useDefined, not written today: accept terms for a market.bids.free bid, the optional payload of a market.accept; the requester sets no accept payload.
x402record not in useDefined, not written today: accept terms for a market.bids.x402 bid, the optional payload of a market.accept; nothing writes or reads one.

com.publicdomainrelay.temp.market.bids

freerecordBid terms: the bidder provides the payload at no cost.
x402record not in useDefined, not written today: bid terms paid over x402, the payload of a market.bid; no bidder writes one, and the requester reads only cost from one it meets.

com.publicdomainrelay.temp.market.policies

denoWorkerrecord not in useNot in use: a deno worker policy record type of the earlier TypeScript market that the policy engine knows only to deny ("denoWorker policy records are disabled; the policy engine is gha-lite only"); an RFP that attaches one is denied.

com.publicdomainrelay.temp.market.receipts

freerecord not in useDefined, not written today: receipt terms for a market.accepts.free accept; the bidder's market.receipt carries the RFP's compute.vm as its payload instead.
x402record not in useDefined, not written today: receipt terms for a market.accepts.x402 accept; nothing writes or reads one.

com.fedfork.exec.* 7

com.fedfork.exec.ops

getBidderqueryA bidder answers its readiness: its MarketIdentity (status phase, pendingAction kind and reason only, conditions type, status and reason), its Bidder component (spec.policy) and its MarketBidder root (status phase and did); each null when absent.
getHealthqueryA bidder answers its core's health since its process started: its unit, start time, ERROR line counts (all, and in its first 10 minutes), automatic restarts, VM processes, the last three ERROR lines and its guest image readiness.
getLogqueryA bidder answers how many lines of its core's log since its process started hold one known message, optionally with one subject, and the first 50 of them as fixed fields.
getRequesterLogqueryThe ssh gateway answers its core's log lines of one DID since a time whose message is one of: requester_session_atirc_revoked, requester_release, requester_released, requester_release_settled_by_termination, requester_contract_records_deleted, requester_submit_accept_declined.
getVmqueryA bidder answers one of its VMs by name: its ComputeVM (as listVms) and its FirecrackerVM (status phase, lostReason, image sha256 and fetched); each null when absent.
getVmMemoryqueryA bidder answers the memory cgroup figures of one of its VMs' units.
listVmsqueryA bidder answers its ComputeVM objects in a fixed projection: name, deletionTimestamp, spec vm.cpus, requester.did, contract.receipt.uri, status phase and lostReason.

computer.socialweb.* 16

computer.socialweb.cicd.process

execproceduresocialweb-guest-agent runs a command with /bin/sh -c as root in the guest and answers when it ends.
killproceduresocialweb-guest-agent sends a signal to a job's process group; a job that already exited is left alone.
listproceduresocialweb-guest-agent lists the jobs it holds, oldest first; an exited job stays listed until a new job needs its place among the 128.
readproceduresocialweb-guest-agent answers a job's interleaved stdout and stderr from a byte cursor, waiting up to waitMs for more.
startproceduresocialweb-guest-agent starts a background job, a command with /bin/sh -c as root in the guest, and answers its id at once.
writeproceduresocialweb-guest-agent writes to a running job's stdin and can close it.

computer.socialweb

ephemeralInfrarecordA short-lived deployment in an account's repo, which the socialweb-computer requester runs like a computer.socialweb.infra.
infrarecordA long-lived deployment: a set of compute contracts, each declared with the state its author wants.
peerrecordHow to reach one subhandle of the repository's account directly.

computer.socialweb.ingress

answerrecordA sealed WebRTC answer, in the answerer's repo.
listenrecordA WebRTC answerer's keys, in its own repo.
offerrecordA sealed WebRTC offer, in the offerer's repo.

computer.socialweb.k8s

getJobqueryThe gateway reads the status of one batch/v1 Job in the named cluster of the calling account, with the pods it owns and the tail of each container's log, without a kubeconfig.
kubectlApplyServerSideprocedureThe gateway server-side applies one Kubernetes object to the named cluster of the calling account, as `kubectl apply --server-side` would, without a kubeconfig.

computer.socialweb.temp.policy

ghaliterecordA market policy a requester publishes in its own repo before a contract's first RFP: a gha-lite workflow that every market.rfp of the contract strongRefs in policies[].
typescriptrecord not in useNot in use: a TypeScript policy record type that the policy engine knows only to deny ("typescript policy records are disabled; the policy engine is gha-lite only"); an RFP that attaches one is denied.

software.release.* 5

software.release

channelrecordA pointer that followers track (rc, stable): the version it names.
defsdefs
manifestrecordThe artifacts of one build.
projectrecordA released piece of software (plan 0040).
versionrecordA named version of a project: its manifest.

link.ident.* 1

link.ident

endorsementrecordPublished by a principal to confirm an agent that claims to act on its behalf.

network.attested.* 3

network.attested

proofrecordA remote attestation proof: a standalone record in the attestor's repository that binds, via a canonical attestation CID, to a subject record living elsewhere.
signatureobjectInline attestation signatures (badge.blue).
verifyqueryVerify the attestations on a record.

com.atproto.* 1

com.atproto.repo

strongRefobjectA URI with a content-hash fingerprint.

com.fedproxy.* 7

com.fedproxy

rbacrecordA 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).
sshPublicKeyrecordAn ssh public key an account allows to open fedproxy.com tunnels for a service, read by atprp-ssh-relay (atproto-reverse-proxy).

com.fedproxy.temp.xrpc

aliasobjectA custom-domain claim: a frame a subscriber sends on its com.fedproxy.temp.xrpc.subscribe socket, as a JSON text frame whose $type is com.fedproxy.temp.xrpc.alias, asking the relay to serve each listed host as that subscriber.
getRegistrationNonceprocedureIssues 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.
registrationobjectA subscriber's signed registration: built by the subscriber (bidder or requester) from a com.fedproxy.temp.xrpc.getRegistrationNonce nonce and sent as JSON text in the registration parameter of com.fedproxy.temp.xrpc.subscribe, where the relay checks it.
subscribesubscriptionThe subscriber's WebSocket to the did:key ingress relay (the Go relay `socialweb-computer internal ingress-relay`, at xrpc.fedproxy.com): a bidder or requester holds it open so that HTTP requests and WebSocket subscriptions sent to its host, <did label>.<relay hostname>, are carried to it and answered over this socket.
tunnelsubscriptionA TCP tunnel to a subscriber through the did:key ingress relay: a caller opens a WebSocket to /xrpc/com.fedproxy.temp.xrpc.tunnel on the subscriber's host (<did label>.<relay hostname>, or a custom-domain alias of it), and the subscriber connects it to its configured TCP target or in-process stream handler.