Jlcpcb

Make JLCPCB a node in the swamp automation graph — quote and order PCB fabrication through JLCPCB's Open API (open.jlcpcb.com), surfaced as typed, CEL-referenceable swamp evidence for factory gates.

One model INSTANCE is scoped to a SINGLE fab vendor configuration: jlcpcb is the TYPE, the instance handle is the project/organization (e.g. swamp model create @kneel/jlcpcb badge-fab). Every evidence payload carries provenance source + sha256 and the vendor identity.

Auth model

JLCPCB's Open API uses JOP — HMAC-SHA256 request signing. Each request carries an Authorization: JOP appid="...",accesskey="...",timestamp="...", nonce="...",signature="..." header. The string-to-sign is {METHOD}\n{canonical_uri}\n{timestamp}\n{nonce}\n{body}\n, signed with the secret key via HMAC-SHA256, base64-encoded.

Credentials (appId, accessKey, secretKey) are loaded from a swamp vault at runtime — never hardcoded, never passed as GlobalArgs. The vault type is @webframp/pass (or any compatible provider); the vault name is a GlobalArg (default jlcpcb).

Trust model

• The API endpoint URL is a GlobalArg (default https://open.jlcpcb.com) — trusted-operator config.
• Every caller-influenced value is validated via Zod schemas before it reaches an HTTP request. No free-form string reaches the URL path unchecked.
• Auth nonce is generated with crypto.getRandomValues — never Math.random.
• All evidence payloads are computed from parsed API responses — not trusted from status codes alone.

Methods

• upload_gerber — upload a gerber zip file → upload evidence (fileKey, fileName, sha256).
• quote — get a price estimate for board specs → quote evidence (quoteUsd, leadTimeDays, shippingOptions, vendor, source).
• order — place an order (requires fileKey + board specs + shipping address) → order evidence matching the eda-factory fabricate schema (vendor, quoteUsd, leadTimeDays, orderRef, status).
• order_status — check order progress by batchNum → order-status evidence (batchNum, status, tracking).

Quickstart

swamp model create @kneel/jlcpcb badge-fab \
  --global-arg vaultName=jlcpcb \
  --global-arg endpoint=https://open.jlcpcb.com
swamp model method run badge-fab quote \
  --input layers=2 --input width=100 --input length=80 \
  --input qty=5 --input thickness=1.6 --input surfaceFinish=HASL

Reference the evidence with CEL:

data.latest("badge-fab", "quote").attributes.quoteUsd
data.latest("badge-fab", "order").attributes.orderRef