How it works
A spec and its implementation for atproto accounts to request and advertise compute. It is for you if you run an organization and want decentralized identity to give your members, and their workloads and agents, access to your compute.
The flow is: Request For Proposal -> Bid -> Accept -> Receipt. Each step is a signed record in its author's own atproto repo; the other side reads it from the firehose, a Jetstream, or the XRPC call that names it.
Who is who
| actor | is | example |
|---|---|---|
| requester | an atproto account that requests a VM | aliceoa.bsky.social |
| bidder operator | an account that owns bidders | bobvmbuilder.bsky.social |
| bidder | a host that provides VMs; its own DID, an agent of its operator (ident.link) | did:plc:2l2wdry77c7jtucbslstagkj |
| guest | the VM; it holds no repo key: its bidder signs its events | - |
| guest requester | a requester inside a requested VM, an agent of its requester for that contract | CI requesting a staging network |
| release account | publishes the release channels | socialweb.computer |
Who serves whom
A bidder bids only for requesters its operator vouches for (sh.tangled.graph.vouch), and a requester accepts only
bidders it vouches for, directly or through the bidder's operator: the default policy tangled-vouch on both sides.
Agents count as their principal, up to 100 levels of ident.link associations. Requesters find bidders through relays (every repo with a market.offering and a
fresh heartbeat), never from a pinned list.
What reaches the guest
The VM boots from the compute.vm's cloud-init user_data; nothing else starts a guest. The requester reaches it over
iroh (every guest), and per tunnel over https (opentunnel) or WebRTC. Secrets never go into user_data: the guest
fetches them from the requester with a workload identity token its bidder issues.
More
- protocol/flow.md: one real contract, step by step, its records and its failure branches
- protocol/compute-contract-flow-map.md: the end-to-end map of every layer, from the lexicons to the guest transport
- protocol/README.md: every record and XRPC method; protocol/glossary.md: every NSID
- protocol/identity.md: identities, keys, associations, guest requesters
- protocol/release.md: release channels and self-update
- SYSTEM.md: the hosts and applications