socialweb.computer

Request and provide VMs on an atproto compute market.

lexicons and xrpc

lexicon

com.publicdomainrelay.temp.compute.events.vm.onNetwork

record key any

The bidder reports a network address of the VM; sent as the payload of a market.event.

record

fieldtypedescription
kindstring
What address is. Absent, it reads as iroh when tag is absent and https when tag is present; the bidder leaves it absent for those two. iroh: address is the VM's iroh ticket. https: tag names the tunnel and address is its https URL. webrtc: tag names the tunnel and address is the guest agent's DTLS certificate fingerprint ("sha-256 AB:CD:..."), which the requester checks against the a=fingerprint of the guest's answer. sandbox: a deno sandbox (compute.vm kind deno) is running, address sandbox://<ComputeVM name>, no tag.
knownValues ["iroh","https","webrtc","sandbox"] maxLength 16
addressstring
The VM's address for kind: the iroh ticket (iroh), the URL of the tagged tunnel (https), the guest agent's DTLS certificate fingerprint "sha-256 AB:CD:..." (webrtc), or sandbox://<ComputeVM name> (sandbox).
tagstring
Names one of the VM's tunnels (spec.tunnels of the contract); absent, address is the VM's iroh ticket.
maxLength 32
createdAt *string datetime
signaturesnetwork.attested.signature#signatures

used in

Compute Contract Flow - Complete Architecture Map, flow: one compute contract, end to end, guest-events: events under a receipt, protocol: the atproto protocol of socialweb-computer, lexicons-market: one row per lexicon, The protocol spec, Four signed hops, one verifiable contract.

raw schema: lexicons/com/publicdomainrelay/temp/compute/events/vm/onNetwork.json
{
  "lexicon": 1,
  "id": "com.publicdomainrelay.temp.compute.events.vm.onNetwork",
  "description": "The bidder reports a network address of the VM; sent as the payload of a market.event.",
  "defs": {
    "main": {
      "type": "record",
      "key": "any",
      "record": {
        "type": "object",
        "required": [
          "createdAt"
        ],
        "properties": {
          "kind": {
            "type": "string",
            "knownValues": [
              "iroh",
              "https",
              "webrtc",
              "sandbox"
            ],
            "maxLength": 16,
            "description": "What address is. Absent, it reads as iroh when tag is absent and https when tag is present; the bidder leaves it absent for those two. iroh: address is the VM's iroh ticket. https: tag names the tunnel and address is its https URL. webrtc: tag names the tunnel and address is the guest agent's DTLS certificate fingerprint (\"sha-256 AB:CD:...\"), which the requester checks against the a=fingerprint of the guest's answer. sandbox: a deno sandbox (compute.vm kind deno) is running, address sandbox://<ComputeVM name>, no tag."
          },
          "address": {
            "type": "string",
            "description": "The VM's address for kind: the iroh ticket (iroh), the URL of the tagged tunnel (https), the guest agent's DTLS certificate fingerprint \"sha-256 AB:CD:...\" (webrtc), or sandbox://<ComputeVM name> (sandbox)."
          },
          "tag": {
            "type": "string",
            "maxLength": 32,
            "description": "Names one of the VM's tunnels (spec.tunnels of the contract); absent, address is the VM's iroh ticket."
          },
          "createdAt": {
            "type": "string",
            "format": "datetime"
          },
          "signatures": {
            "type": "ref",
            "ref": "network.attested.signature#signatures"
          }
        }
      }
    }
  }
}