master-zapier-plan-draft/packages/zapier-user-docs/07-attachments-and-metadata.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

16 lines
960 B
Markdown

# 7. Attachments and metadata (not on chain)
The blockchain stores hash + time + certificate. Everything else is **off-chain WORM**:
| Field | Chain | Archive (`verae.archive.put`) |
|-------|-------|-------------------------------|
| SHA-256 | yes | key |
| Public metadata JSON | no | `kind: publicMeta` |
| Encrypted private metadata | no | `kind: privateMeta` |
| File bytes | no | `kind: file` + `contentSha256` |
Set **includeAttached** on wait/lookup when you need those records back. Middleware then broadcasts `verae.archive.query`. Each archive uses a bloom filter: **if it does not have the hash, it sends nothing**. Archives that have data reply; the aggregator merges them into `receipts[]` and `files[]`.
Bloom false positives are possible (empty reply after a maybe). False negatives must be rare.
Private metadata is only returned on authenticated archive replies. Zapier still never talks to NATS; it only sees the JSON middleware built.