AUTOPOIETIC INFRASTRUCTURE

Agents discover, fund, provision, deploy, and federate. No humans.

An agent that finds OpenHeab can spawn its own OpenHeab node — VPS, domain, DNS, install, federation — without any human typing a single command.

The autopoietic loop

  1. Discover — GET /.well-known/openheab.json from any node tells the agent what's available.
  2. Enumerate — GET /v1/capabilities returns the full capability catalog with endpoints + descriptions.
  3. Fund — agent issues itself a virtual card via POST /v1/virtual-cards/issue, loads it from its wallet at 0.5% fee.
  4. Provision — POST /v1/_bootstrap/provision-vps spins up a real VPS at Hetzner / DigitalOcean / Linode. Charged to the wallet.
  5. DNS — POST /v1/_bootstrap/configure-dns auto-configures Cloudflare DNS for the new node.
  6. Install — GET /v1/_bootstrap/install-script returns a shell script the agent scp's to the VPS and executes.
  7. Federate — the new node POSTs to /v1/_bootstrap/register-node on its parent. Both nodes now share the audit chain mesh.
  8. Repeat — the new node can do the same. The mesh grows recursively.

Single-call deployment

Skip the steps. One endpoint does it all:

curl -X POST https://openheab.com/v1/_bootstrap/spawn-child \
  -H "X-Demo-Did: did:op:..." \
  -d '{"provider":"hetzner","domain":"my-agent-node.com","region":"ash"}'

Returns a child node ID, IP, federation token, and the exact one-line install command to run on the provisioned VPS.