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
rbacDid | record not in use | Not in use: an RBAC allowlist record of the earlier TypeScript market ({protects, allowed, createdAt} in the records it left). |
com.publicdomainrelay.temp
badgeBlueKeys | record | Binds a signing key to the repository DID, so that records signed with the key verify as the DID's. |
com.publicdomainrelay.temp.cluster
controlPlaneDown | procedure | The gateway takes the named cluster's control plane down: it flips its desired state to not-running and dematerialises the process group. |
controlPlaneUp | procedure | The 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. |
createCluster | procedure | The gateway creates the named cluster of the calling account and leaves it RUNNING, in one call. |
deleteCluster | procedure | The gateway begins the teardown of the named cluster of the calling account. |
getKubeconfig | procedure | The gateway returns a kubeconfig for the named cluster of the calling account. |
listClusters | query | The gateway lists the calling account's clusters. |
listKubeconfigs | query | The gateway lists the kubeconfigs issued for the named cluster of the calling account: one ClusterClientCertificate record per kubeconfig, revoked ones included. |
revokeIdentity | procedure | The 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. |
revokeKubeconfig | procedure | The gateway revokes one kubeconfig of the named cluster of the calling account: it sets spec.revoked on its ClusterClientCertificate record. |
subscribeClusters | subscription | The 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
simple | record | A 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
agentStart | record | The 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. |
image | record | The guest reports the image it booted: the marker in its /etc/swc-image; sent as the payload of a market.event. |
memoryPressure | record | The 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. |
oomKill | record | The guest kernel's OOM killer killed a process (/proc/vmstat oom_kill rose); sent as the payload of a market.event. |
publicKey | record | A party to a contract publishes an encryption public key for one tag; sent as the payload of a market.event. |
r2Release | record | The 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. |
r2Released | record | The 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. |
r2Start | record | The 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. |
requesterDid | record | The 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. |
secrets | record | The 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. |
secretsApplied | record | The guest wrote the files of its secrets bundle; sent as the payload of a market.event. |
secretsRequested | record | The 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. |
secretsUpdated | record | The 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. |
signalWebRTC | record | A sealed WebRTC session description for one tunnel; sent as the payload of a market.event. |
com.publicdomainrelay.temp.compute.events.vm
delete | record | The requester asks the bidder to delete the VM of a contract; sent as the payload of a market.event. |
hostKeys | record | The bidder reports the VM's SSH host keys; sent as the payload of a market.event. |
memoryPressure | record | The 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. |
onNetwork | record | The bidder reports a network address of the VM; sent as the payload of a market.event. |
oomKilled | record | The 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. |
sandbox | record | A deno sandbox reports that its program ended, with its output; sent as the payload of a market.event. |
terminated | record | The bidder reports that the VM stopped; sent as the payload of a market.event. |
com.publicdomainrelay.temp.compute.guest
subscribeEvents | subscription | Served 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
getSecrets | query | 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. |
com.publicdomainrelay.temp.compute
vm | record | A requested virtual machine: the payload of a compute RFP. |
com.publicdomainrelay.temp.ingress
webRTC | record | A 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
ping | query | The 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
accept | record | A requester's signed accept of one bid on its RFP, in its own repo. |
association | record | The 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. |
associationRequest | record | The 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. |
bid | record | A bid on an RFP, written by the bidder. |
event | record | An event envelope under a receipt; the payload is a compute.events record. |
heartbeat | record | A bidder's liveness beat for its offering, rewritten at rkey self. |
offering | record | A bidder announces the payload collections it bids on and where it takes RFPs. |
receipt | record | The bidder's receipt for an accept. |
relays | record | The relays a participant crawls and asks others to crawl, read in market discovery. |
rfp | record | A request for proposals: the requester asks bidders to bid on the payload. |
submitAccept | procedure | A requester submits its accept of a bid to the bidder, which records a provisioning intent and answers 202 at once. |
submitBid | procedure | A bidder submits a bid it wrote to the requester. |
submitEvent | procedure | A contract party submits a market.event it wrote to the other party. |
submitRfp | procedure | A requester submits an RFP to a bidder. |
com.publicdomainrelay.temp.market.accepts
free | record not in use | Defined, not written today: accept terms for a market.bids.free bid, the optional payload of a market.accept; the requester sets no accept payload. |
x402 | record not in use | Defined, 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
free | record | Bid terms: the bidder provides the payload at no cost. |
x402 | record not in use | Defined, 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
denoWorker | record not in use | Not 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
free | record not in use | Defined, 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. |
x402 | record not in use | Defined, not written today: receipt terms for a market.accepts.x402 accept; nothing writes or reads one. |
com.fedfork.exec.* 7
com.fedfork.exec.ops
getBidder | query | A 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. |
getHealth | query | A 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. |
getLog | query | A 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. |
getRequesterLog | query | The 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. |
getVm | query | A 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. |
getVmMemory | query | A bidder answers the memory cgroup figures of one of its VMs' units. |
listVms | query | A 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
exec | procedure | socialweb-guest-agent runs a command with /bin/sh -c as root in the guest and answers when it ends. |
kill | procedure | socialweb-guest-agent sends a signal to a job's process group; a job that already exited is left alone. |
list | procedure | socialweb-guest-agent lists the jobs it holds, oldest first; an exited job stays listed until a new job needs its place among the 128. |
read | procedure | socialweb-guest-agent answers a job's interleaved stdout and stderr from a byte cursor, waiting up to waitMs for more. |
start | procedure | socialweb-guest-agent starts a background job, a command with /bin/sh -c as root in the guest, and answers its id at once. |
write | procedure | socialweb-guest-agent writes to a running job's stdin and can close it. |
computer.socialweb
ephemeralInfra | record | A short-lived deployment in an account's repo, which the socialweb-computer requester runs like a computer.socialweb.infra. |
infra | record | A long-lived deployment: a set of compute contracts, each declared with the state its author wants. |
peer | record | How to reach one subhandle of the repository's account directly. |
computer.socialweb.ingress
answer | record | A sealed WebRTC answer, in the answerer's repo. |
listen | record | A WebRTC answerer's keys, in its own repo. |
offer | record | A sealed WebRTC offer, in the offerer's repo. |
computer.socialweb.k8s
getJob | query | The 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. |
kubectlApplyServerSide | procedure | The 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
ghalite | record | A 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[]. |
typescript | record not in use | Not 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
channel | record | A pointer that followers track (rc, stable): the version it names. |
defs | defs | |
manifest | record | The artifacts of one build. |
project | record | A released piece of software (plan 0040). |
version | record | A named version of a project: its manifest. |
link.ident.* 1
link.ident
endorsement | record | Published by a principal to confirm an agent that claims to act on its behalf. |
network.attested.* 3
network.attested
proof | record | A remote attestation proof: a standalone record in the attestor's repository that binds, via a canonical attestation CID, to a subject record living elsewhere. |
signature | object | Inline attestation signatures (badge.blue). |
verify | query | Verify the attestations on a record. |
com.atproto.* 1
com.atproto.repo
strongRef | object | A URI with a content-hash fingerprint. |
com.fedproxy.* 7
com.fedproxy
rbac | record | 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). |
sshPublicKey | record | An 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
alias | object | A 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. |
getRegistrationNonce | procedure | Issues 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. |
registration | object | A 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. |
subscribe | subscription | The 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. |
tunnel | subscription | A 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. |