glossary: every NSID on the wire
- every NSID that has a lexicon file is listed from the lexicons themselves: its type and the first sentence of its description, grouped by namespace, with the docs pages that name it. On the site the list is generated in place: https://socialweb.computer/docs/protocol/glossary.html (each NSID's own page: https://socialweb.computer/docs/lexicons/)
- below that list, by hand: the NSIDs we use that have no lexicon file here, and the ones other projects own
- namespaces we define: market and relay
com.publicdomainrelay.temp.*; runtime and host contractscom.fedfork.exec.*; deployments, ingress and peerscomputer.socialweb.*; the ingress relay and workload rolescom.fedproxy.*. Used, with a copy of their lexicons here, not ours: releasessoftware.release.*, associationslink.ident.*, signaturesnetwork.attested.* - names in other docs drop
com.publicdomainrelay.temp.(market.rfp)
From the lexicons
com.publicdomainrelay.temp.auth.allowlist
| NSID | type | what | docs |
|---|---|---|---|
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). | Compute Contract Flow - Complete Architecture Map, protocol: the atproto protocol of socialweb-computer |
com.publicdomainrelay.temp
| NSID | type | what | docs |
|---|---|---|---|
badgeBlueKeys | record | Binds a signing key to the repository DID, so that records signed with the key verify as the DID's. | identity: signatures, key claims, associations, sign-in, protocol: the atproto protocol of socialweb-computer |
com.publicdomainrelay.temp.cluster
| NSID | type | what | docs |
|---|---|---|---|
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
| NSID | type | what | docs |
|---|---|---|---|
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. | Compute Contract Flow - Complete Architecture Map, guest-events: events under a receipt, protocol: the atproto protocol of socialweb-computer, lexicons-market: one row per lexicon, market: the RFP flow, A provisioned workload never holds a long-lived secret, Compute Contracts - Pre-Alpha |
com.publicdomainrelay.temp.compute.events.guest
| NSID | type | what | docs |
|---|---|---|---|
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. | guest-events: events under a receipt, lexicons-market: one row per lexicon |
image | record | The guest reports the image it booted: the marker in its /etc/swc-image; sent as the payload of a market.event. | guest-events: events under a receipt, lexicons-market: one row per lexicon, market: the RFP flow |
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. | guest-events: events under a receipt, lexicons-market: one row per lexicon |
oomKill | record | The guest kernel's OOM killer killed a process (/proc/vmstat oom_kill rose); sent as the payload of a market.event. | guest-events: events under a receipt, lexicons-market: one row per lexicon |
publicKey | record | A party to a contract publishes an encryption public key for one tag; sent as the payload of a market.event. | guest-events: events under a receipt, lexicons-market: one row per lexicon |
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. | flow: one compute contract, end to end, guest-events: events under a receipt, identity: signatures, key claims, associations, sign-in, lexicons-market: one row per lexicon, market: the RFP flow |
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. | flow: one compute contract, end to end, guest-events: events under a receipt, identity: signatures, key claims, associations, sign-in, lexicons-market: one row per lexicon, market: the RFP flow |
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. | guest-events: events under a receipt, lexicons-market: one row per lexicon |
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. | guest-events: events under a receipt, lexicons-market: one row per lexicon |
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. | guest-events: events under a receipt, lexicons-market: one row per lexicon |
secretsApplied | record | The guest wrote the files of its secrets bundle; sent as the payload of a market.event. | guest-events: events under a receipt, lexicons-market: one row per lexicon |
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. | guest-events: events under a receipt, lexicons-market: one row per lexicon |
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. | guest-events: events under a receipt, identity: signatures, key claims, associations, sign-in, lexicons-market: one row per lexicon |
signalWebRTC | record | A sealed WebRTC session description for one tunnel; sent as the payload of a market.event. | guest-events: events under a receipt, lexicons-market: one row per lexicon |
com.publicdomainrelay.temp.compute.events.vm
com.publicdomainrelay.temp.compute.guest
| NSID | type | what | docs |
|---|---|---|---|
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. | Compute Contract Flow - Complete Architecture Map, flow: one compute contract, end to end, protocol: the atproto protocol of socialweb-computer, lexicons-market: one row per lexicon |
com.publicdomainrelay.temp.compute.secrets
| NSID | type | what | docs |
|---|---|---|---|
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. | Compute Contract Flow - Complete Architecture Map, protocol: the atproto protocol of socialweb-computer, lexicons-market: one row per lexicon |
com.publicdomainrelay.temp.compute
com.publicdomainrelay.temp.ingress
| NSID | type | what | docs |
|---|---|---|---|
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. | identity: signatures, key claims, associations, sign-in, protocol: the atproto protocol of socialweb-computer, lexicons-market: one row per lexicon, market: the RFP flow |
com.publicdomainrelay.temp.keepalive
| NSID | type | what | docs |
|---|---|---|---|
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. | protocol: the atproto protocol of socialweb-computer |
com.publicdomainrelay.temp.market
com.publicdomainrelay.temp.market.accepts
| NSID | type | what | docs |
|---|---|---|---|
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. | identity: signatures, key claims, associations, sign-in, lexicons-market: one row per lexicon, The protocol spec |
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. | identity: signatures, key claims, associations, sign-in, lexicons-market: one row per lexicon, The protocol spec |
com.publicdomainrelay.temp.market.bids
| NSID | type | what | docs |
|---|---|---|---|
free | record | Bid terms: the bidder provides the payload at no cost. | Compute Contract Flow - Complete Architecture Map, identity: signatures, key claims, associations, sign-in, protocol: the atproto protocol of socialweb-computer, lexicons-market: one row per lexicon, market: the RFP flow, policy: policy records, attached policies, tangled-vouch, The protocol spec, From zero to a signed contract, Four signed hops, one verifiable contract., A marketplace made of records., Open RFPs, live from the firehose, Compute Contracts - Pre-Alpha |
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. | 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, The protocol spec |
com.publicdomainrelay.temp.market.policies
| NSID | type | what | docs |
|---|---|---|---|
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. | Compute Contract Flow - Complete Architecture Map, protocol: the atproto protocol of socialweb-computer, policy: policy records, attached policies, tangled-vouch |
com.publicdomainrelay.temp.market.receipts
| NSID | type | what | docs |
|---|---|---|---|
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. | identity: signatures, key claims, associations, sign-in, lexicons-market: one row per lexicon, The protocol spec |
x402 | record not in use | Defined, not written today: receipt terms for a market.accepts.x402 accept; nothing writes or reads one. | identity: signatures, key claims, associations, sign-in, lexicons-market: one row per lexicon, The protocol spec |
com.fedfork.exec.ops
| NSID | type | what | docs |
|---|---|---|---|
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.cicd.process
| NSID | type | what | docs |
|---|---|---|---|
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
| NSID | type | what | docs |
|---|---|---|---|
ephemeralInfra | record | A short-lived deployment in an account's repo, which the socialweb-computer requester runs like a computer.socialweb.infra. | protocol: the atproto protocol of socialweb-computer |
infra | record | A long-lived deployment: a set of compute contracts, each declared with the state its author wants. | flow: one compute contract, end to end, protocol: the atproto protocol of socialweb-computer |
peer | record | How to reach one subhandle of the repository's account directly. | identity: signatures, key claims, associations, sign-in, protocol: the atproto protocol of socialweb-computer, lexicons-market: one row per lexicon |
computer.socialweb.ingress
| NSID | type | what | docs |
|---|---|---|---|
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
| NSID | type | what | docs |
|---|---|---|---|
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
| NSID | type | what | docs |
|---|---|---|---|
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[]. | Compute Contract Flow - Complete Architecture Map, market: the RFP flow, policy: policy records, attached policies, tangled-vouch |
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. | Compute Contract Flow - Complete Architecture Map, policy: policy records, attached policies, tangled-vouch |
software.release
| NSID | type | what | docs |
|---|---|---|---|
channel | record | A pointer that followers track (rc, stable): the version it names. | release: channels, versions, manifests |
defs | defs | release: channels, versions, manifests | |
manifest | record | The artifacts of one build. | release: channels, versions, manifests |
project | record | A released piece of software (plan 0040). | release: channels, versions, manifests |
version | record | A named version of a project: its manifest. | release: channels, versions, manifests |
link.ident
| NSID | type | what | docs |
|---|---|---|---|
endorsement | record | Published by a principal to confirm an agent that claims to act on its behalf. | Compute Contract Flow - Complete Architecture Map, flow: one compute contract, end to end, identity: signatures, key claims, associations, sign-in, protocol: the atproto protocol of socialweb-computer, lexicons-market: one row per lexicon, market: the RFP flow |
network.attested
| NSID | type | what | docs |
|---|---|---|---|
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. | identity: signatures, key claims, associations, sign-in |
signature | object | Inline attestation signatures (badge.blue). | Compute Contract Flow - Complete Architecture Map, flow: one compute contract, end to end, identity: signatures, key claims, associations, sign-in, protocol: the atproto protocol of socialweb-computer, market: the RFP flow |
verify | query | Verify the attestations on a record. | Compute Contract Flow - Complete Architecture Map, identity: signatures, key claims, associations, sign-in |
com.atproto.repo
| NSID | type | what | docs |
|---|---|---|---|
strongRef | object | A URI with a content-hash fingerprint. | protocol: the atproto protocol of socialweb-computer, market: the RFP flow, policy: policy records, attached policies, tangled-vouch, The protocol spec |
com.fedproxy
| NSID | type | what | docs |
|---|---|---|---|
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). | 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 |
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). | protocol: the atproto protocol of socialweb-computer |
com.fedproxy.temp.xrpc
| NSID | type | what | docs |
|---|---|---|---|
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. |
Lexicons without a description
Kept here until the lexicon file has one.
| NSID | type | one line |
|---|---|---|
software.release.defs | defs | httpArtifact, target |
Ours, no lexicon file
| NSID | type | one line | doc |
|---|---|---|---|
com.fedfork.exec.binding, com.fedfork.exec.pins | record (lexicons in atlibs lexicons/com/fedfork/exec/) | CI executor bindings and the tested atlibs pin set, in the release account's repo | ../ci-debug.md |
com.fedfork.atprotoOauthQR | GET and POST on one NSID (no file: one lexicon method is a query or a procedure) | the QR session transfer of qr.fedfork.com (did-key-associator/hono-backend/mod.ts): POST publishes a signed-in session for a CLI DID and nonce, GET (service auth, lxm this NSID) polls for it | outside.md |
Used, Not Ours
| NSID | owner | one line | doc |
|---|---|---|---|
sh.tangled.graph.vouch | tangled | a trust edge, rkey = the subject DID; read by every trust policy | outside.md |
chat.atirc.mint, chat.atirc.revoke | atirc | subhandle tokens for agents, leased to a contract | outside.md |
com.atproto.* (repo, sync, server, identity) | atproto | records, streams, sessions, getServiceAuth, listReposByCollection | outside.md |
network.bsky.jetstream.subscribeEvents | Bluesky | the Jetstream v2 stream | outside.md |
dev.cocore.devicePair.start, dev.cocore.devicePair.poll | cocore | the ssh transport's device pairing calls (client only, internal/sshtransport/cocore.go) | - |
software.release.* | not ours; a copy in lexicons/software/release/ | the release records followers read (internal/releasefollow) | release.md |
link.ident.endorsement | ident.link; a copy in lexicons/link/ident/endorsement.json | the principal confirms an agent | identity.md |
network.attested.* | not ours; a copy in lexicons/network/attested/ | network.attested.signature is the inline signature on market records; network.attested.proof and network.attested.verify are defined there and not written, served or called by this repository | identity.md |