master-zapier-plan-draft/packages/zapier-user-docs/10-reading-receipts.md
George Lambert f3dc0e6eee
Some checks are pending
offline / test (push) Waiting to run
Add Zapier interface simulator, tree-node Merkle lookups, and user docs
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.
2026-09-11 12:58:03 -04:00

28 lines
1.1 KiB
Markdown

# 10. Reading receipts
Completed JSON (wait, hook, or lookup):
```json
{
"jobId": "…",
"status": "completed",
"sha256": "…",
"receipts": [
{ "kind": "seal", "timestamp": "…", "certificate": "…", "blockIndex": 42 },
{ "kind": "metadata-attach", "attachedAt": "…", "publicMetadata": {} },
{ "kind": "tree-leaf", "merkleRoot": "…", "proof": [], "itemizedOnMainChain": false }
],
"files": [{ "id": "invoice.pdf", "sha256": "…", "archiveId": "archive-b" }],
"archivesQueried": true,
"archiveReplies": 2
}
```
| `kind` | Meaning |
|--------|---------|
| `seal` | Chain certificate. If `of: merkleRoot`, this seal covers a batch, not the leaf itself. |
| `metadata-attach` | Public or private metadata added later. |
| `file-attach` | Off-chain file (content hash in the record). |
| `tree-leaf` | Inclusion proof for a hash that is not itemized on the main chain. |
**Verify Timestamp** takes a `certificate` string and returns `{ valid, timestamp, blockIndex }`. For a bulk leaf, verify the **root** certificate, then trust the leaf only if `proofOk` is true.