~ knotless Search/
↑↓ move↵ open⇧↵ all results

socialweb.computer/socialweb-computer-kcp

socialweb.computer: a compute market on atproto (kcp)

1 collaborator
0
0
63 lines · 3.3 KB Raw History
# 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.

```mermaid
sequenceDiagram
    autonumber
    actor Alice as Alice (requester)
    actor Bob as Bob's bidder

    Alice->>Alice: compute.vm (cpus, mem, disk, cloud-init user_data) + market.rfp
    Alice->>Bob: discover (market.offering, market.heartbeat), submitRfp
    Note over Bob: policy: does Bob vouch for Alice?
    Bob->>Bob: market.bids.free + market.bid
    Bob->>Alice: submitBid
    Note over Alice: policy: does Alice vouch for Bob?
    Alice->>Alice: market.accept
    Alice->>Bob: submitAccept
    Note over Bob: capacity, then provision the VM
    Bob->>Bob: market.receipt, then market.event (vm.hostKeys, vm.onNetwork)
    Bob->>Alice: submitEvent
    Note over Alice: Held: ssh over iroh
    Alice->>Alice: compute.events.vm.delete + market.event
    Bob->>Bob: compute.events.vm.terminated + market.event
```

## 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](protocol/flow.md): one real contract, step by step, its records and its failure branches
- [protocol/compute-contract-flow-map.md](protocol/compute-contract-flow-map.md): the end-to-end map of every layer, from the lexicons to the guest transport
- [protocol/README.md](protocol/README.md): every record and XRPC method; [protocol/glossary.md](protocol/glossary.md): every NSID
- [protocol/identity.md](protocol/identity.md): identities, keys, associations, guest requesters
- [protocol/release.md](protocol/release.md): release channels and self-update
- [SYSTEM.md](SYSTEM.md): the hosts and applications