marchon/master-zapier-plan-draft
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 1

Add Zapier interface simulator, tree-node Merkle lookups, and user docs
Some checks are pending
offline / test (push) Waiting to run
Details

Browse source 
In-process trace console validates hops, faults, recoveries, and
suggested changes before zapier-platform push. User guide covers
signup through central-chain and bulk-summary tree-node hash lookup.
This commit is contained in:
George Lambert 2026-09-11 12:58:03 -04:00
parent 3daa88866d
commit f3dc0e6eee
56 changed files with 2341 additions and 8 deletions
Download patch file Download diff file Expand all files Collapse all files

14
packages/zapier-user-docs/11-errors-billing-retries.md Normal file
View file

@ -0,0 +1,14 @@
# 11. Errors, billing, retries
| HTTP | Zapier mapping | What you should do |
|------|----------------|--------------------|
| 400 | validation | SHA-256 must be 64 hex chars; supply Data or SHA256. |
| 401 | auth | Re-paste API key; it may have been regenerated. |
| 402 | QuotaExceeded | Reload prepaid credit in the portal (`upgradeUrl` in the error). |
| 403 | PlanUpgradeRequired | Batch / wait / tree lookup may be paid-only. |
| 404 | empty search | Not itemized — try tree-node search before creating a new seal. |
| 504 / pending | timeout | Use the Completed trigger; do not loop wait in the same step. |
Middleware retries `jobs.watch` / `jobs.events` once when NATS drops (simulator: enable **recover**). Zapier itself retries failed HTTP according to your Zap settings — keep creates **idempotent** (re-registering the same hash returns the original seal).
Delays: if the simulator flags hops over 200ms, do not raise Zapier’s step timeout until chain poll interval and archive query window (`WAIT_ARCHIVE_MS`) are measured on NS1.