Skip to main content

​
Swarm primitives

Lithtrix is the trust and audit layer for multi-agent swarms — not a workflow engine. Register once, spawn scoped sub-agents with keys that expire, hand off work with a signed contract that says exactly what each agent may read and write, and pull a single audit trace for the whole task.
  1. lithtrix_register — include passport_public_key or configure LITHTRIX_PASSPORT_MASTER_SEED
  2. lithtrix_spawn — creates child + scoped sub-key
  3. lithtrix_delegate — signs locally; returns task_id + delegation_id
  4. lithtrix_trace_append — records audit transition
  5. lithtrix_trace_get — reads full chain
See Spawn, Delegate, Trace.

​
Billing

Scoped sub-keys share the parent agent’s quotas (GET /v1/capabilities → keys). Parent-funded debits are live: a child authenticated with its scoped key performs credit-gated work (e.g. memory-only PUT) against the parent’s credit pool. If the parent is suspended mid-TTL, the child receives 402 PARENT_BILLING_UNAVAILABLE.

​
Discovery

GET /v1/capabilities → swarm block includes endpoints, conflict_policy_allowed, signing format, and MCP tool names.