Docs · receipts
Receipts
Every answer from GET /api/v1/find carries a signed receipt. Anyone can check it without trusting us.
The signed receipt
Signed receipt. Every response carries receipt: what ran (how the question was read and by whom, the product set searched, the model that wrote the answer, or that it came from memory), why (the picks in order with their labels and citations), when (written, served, and when each cited page was read), the cost (what this call was charged and which outside calls it made), body_sha256, a digest of the results and answer it vouches for, and blocks_sha256, a digest of the typed pieces (without the receipt piece, which only points back here). It is signed with Ed25519 under the same key as our passports: fetch /api/v1/trust-passport-public-key, remove signature, signedAt, signedBy and version, serialise the rest as JSON with sorted keys, and check the signature. No call to us is needed.
Typed pieces
Typed pieces. An answered response also carries blocks: the same answer laid out in reading order, one typed piece at a time (summary, gap, pick per product, question, suggested, sources, receipt), so any client can draw it without knowing our field names. Each pick carries evidence: every fact on the card (what it does, its label, its official doors, its install line, an operation from the maker's docs) with who decided it, its sources, and when it was last checked (null when we don't know, never a guess). Each pick, each result (score_parts) and each receipt pick also carries the ranking score term by term: relevance (how well the reranker judged it answers the question), authority and its authority_terms (use, votes, web rank, lists, official doors, as counted), named (100 when the question names it), and the two dials that scale authority, relevance_gate and aboutness.
Memory first
Memory first. An answered question is remembered for up to 24 hours: the same question, or the same search + intent + named from an agent that brings its own reading, gets the answer already written, with no new search. Add max_age (seconds) to say how old is too old: an older answer is written afresh for you, and max_age=0 always writes afresh. Every answered response carries memory: from_memory, matched_on (question or reading), answered_at, age_s and max_age_s.
Check a receipt or passport offline
The Ed25519-signed passport for any record — by page slug, record id, or package name. Verify it offline: fetch the public key from /api/v1/trust-passport-public-key, detach signature/signedAt/signedBy/version, canonicalize the rest with sorted keys, and run ed25519-verify. Copy-paste verifier: /how#verify.