createVat (POST / on the admin socket) makes a vat with newUniqueId and returns its id, which addresses it only there. A vat is reachable only where it is mounted: ?mount=<labels> on each start, as ?egress= is granted; absent means none. The ingress reads a request's labels from its query string, plus a Toybox-Labels header for secret ones (a URL ends up in logs and Referers). It routes to the vat whose mount labels the request carries, every one: stricter than Flower's no-conflict match, since an ingress client holds no constrained handle and a label it omits must not match. Registration keeps Flower's rule, so a mount must conflict with every other and no request can carry two. The app keeps the whole path and sees its connection labels in Toybox-Connection-Labels. A vat from before ids lives at idFromName(name). PUT /by-name/<name> reaches it on the admin socket; it stays unreachable from outside until mounted. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
45 lines
1.8 KiB
Cap'n Proto
45 lines
1.8 KiB
Cap'n Proto
# toybox: vats whose code is installed at runtime, each a Durable Object facet.
|
|
#
|
|
# Sockets have no address here: whoever starts workerd hands them in
|
|
# (-S name=fd from systemd, or -s name=addr), so holding a socket is the
|
|
# authority it grants. `state` is likewise overridden with -d state=<dir>,
|
|
# and the switchboard's address with -e switchboard=<addr>.
|
|
using Workerd = import "/workerd/workerd.capnp";
|
|
|
|
const config :Workerd.Config = (
|
|
services = [
|
|
(name = "main", worker = .supervisor),
|
|
(name = "nowhere", network = (allow = [])),
|
|
# the way out: one switchboard socket, i.e. one handle (see switchboard.capnp)
|
|
(name = "switchboard", external = (address = "unix:switchboard.sock", http = ())),
|
|
(name = "state", disk = (path = "state", writable = true)),
|
|
],
|
|
sockets = [
|
|
# the ingress: reach the vat mounted at a request's labels
|
|
(name = "http", http = (), service = (name = "main", entrypoint = "Public")),
|
|
# create vats, install code, grant egress and ingress
|
|
(name = "admin", http = (), service = (name = "main", entrypoint = "Admin")),
|
|
],
|
|
);
|
|
|
|
const supervisor :Workerd.Worker = (
|
|
compatibilityDate = "2026-10-01",
|
|
modules = [
|
|
(name = "supervisor.js", esModule = embed "supervisor.js"),
|
|
(name = "labels.js", esModule = embed "labels.js"),
|
|
(name = "capnweb", esModule = embed "node_modules/capnweb/dist/index-workers.js"),
|
|
],
|
|
durableObjectNamespaces = [
|
|
(className = "Vat", uniqueKey = "toybox-vat", enableSql = true),
|
|
(className = "Directory", uniqueKey = "toybox-directory", enableSql = true),
|
|
],
|
|
durableObjectStorage = (localDisk = "state"),
|
|
bindings = [
|
|
(name = "VATS", durableObjectNamespace = "Vat"),
|
|
(name = "DIRECTORY", durableObjectNamespace = "Directory"),
|
|
(name = "LOADER", workerLoader = ()),
|
|
(name = "SWITCHBOARD", service = "switchboard"),
|
|
],
|
|
globalOutbound = "nowhere",
|
|
);
|