CATs dual-publishes signed ExecutionBom envelopes to an external Solid pod (Community Solid Server–compatible HTTP API) when configured. The data plane is unchanged: CID remains the address of record; peers resolve Invoice / log / Quantum bytes via AddressStore (gateway + verify).
Node-hosted GET /ldp/boms/ stays a local cache/mirror. HTTP PUT on the
Node LDP routes remains 405. Solid is the open-world write surface under
WAC.
| Plane | What | Address of record |
|---|---|---|
| Data | Quantum blobs, Invoice/log, IaC | CID (AddressStore) |
| Control | Signed ExecutionBom JSON-LD | Solid URI when set; else Node bom_ldp_uri |
Runtime.executesigns the BOM (Data Integrityeddsa-jcs-2022) and mintsbom_cid.- Writes local
BomLdpStore→ responsebom_ldp_uri. - If
SOLID_POD_BASE_URLis set: PUT to{base}/boms/{bom_cid}→bom_solid_uri.- Fails
Runtime.executewhen Solid is configured and PUT fails (dual-write consistency).
- Fails
- Indexes a Node-local BOM registry record (
BomRegistry.putafter locators are known; fail closed). This is not a Solid dual-write — seeBomRegistry.md. - After successful Solid PUT: best-effort LDN announce to
SOLID_LDN_INBOX_URLS(Inbox down does not fail execute). - Peers:
fetch_bom_envelope(bom_solid_uri)→ verify proof → CID refs via AddressStore.
When Solid env is unset, behavior matches the Node LDP slice only
(bom_solid_uri is null); registry indexing still runs.
- WebID:
cats/network/identity/webid.pyemits a minimal profile linking the Nodedid:keyverification method. Data Integrity proofs stay ondid:key. Override the agent URI withSOLID_WEBID; otherwise a local{CATS_HOME}/.cats/webid.jsonldfile://URI is used. - WAC bootstrap: call once after pod credentials are ready:
uv run python -c "
from cats.network.ldp import ensure_solid_bom_acl
print(ensure_solid_bom_acl())
"Grants the Node agent acl:Write / acl:Append / acl:Control on the BOM
container; readers from SOLID_BOM_READERS (comma-separated WebIDs), or
public foaf:Agent Read when unset.
Set these in the repo-root .env (see .env.example /
ENV.md). cats loads that file on import; already-exported
shell variables win. Unset SOLID_POD_BASE_URL leaves Solid off.
| Variable | Required | Description |
|---|---|---|
SOLID_POD_BASE_URL |
for Solid | Pod base URL (e.g. https://pod.example/user/) |
SOLID_BOMS_PATH |
no | BOM container path (default /boms) |
SOLID_CLIENT_ACCESS_TOKEN |
auth* | Bearer token for CSS client credentials |
SOLID_CLIENT_ID / SOLID_CLIENT_SECRET |
auth* | HTTP Basic fallback when no access token |
SOLID_LDN_INBOX_URLS |
no | Comma-separated Inbox URLs for LDN Announce |
SOLID_WEBID |
no | Agent WebID URI (else local .cats/webid.jsonld) |
SOLID_BOM_READERS |
no | Comma-separated reader WebIDs (default public Read) |
*One of Bearer token or client id+secret is required when Solid is configured.
This repo does not host a Solid server — run Community Solid Server (or compatible) separately.
BOM.md— HTTP response fieldsbom_cid,bom_ldp_uri,bom_solid_uriBomRegistry.md— Node-local query index (not the envelope store)NodeLifeCycle.md— Node LDP cache + registry query routesSTORAGE.md— ContentStore / MinIO (data plane; unchanged by Solid)ControlFeedbackLoop.md— Control-Feedback Loop + registry intake