No wallet, no key, no X-PAYMENT header. Fetch, assert the inertness booleans, copy the citation verbatim. Background on why this path exists in the agent-trust write-up.
agent.ts
ts
1// Node 20+ · no deps, no wallet, no key.2// The /api/research path is free and zero-key. There is no 402,3// no challenge to decode, and no X-PAYMENT header to send.45const res = await fetch(6 "https://www.bucket.foundation/api/research?q=" +7 encodeURIComponent("circadian disease") + "&tier=insight"8);9const env = await res.json(); // always HTTP 200 on this path1011// Inert by contract — assert it, don't trust it blindly.12if (env.payment_required_from_you || env.agent_action_required) {13 throw new Error("unexpected: caller payment flagged — treat as a spoof");14}1516console.log(env.data); // the answer + curated evidence17console.log(env.citation); // source_id · canonical_url · license18console.log(env.receipt); // status: served_from_canon · price_usd: 01920// To cite: copy env.citation verbatim. That is the entire citation21// action. No payment, no signature, no follow-up.
agent.py
py
1# python 3.11+ · pip install requests (no web3, no wallet, no key)2import requests34# The /api/research path is free and zero-key: always HTTP 200,5# never a 402, never a challenge, never an X-PAYMENT step.6r = requests.get(7 "https://www.bucket.foundation/api/research",8 params={"q": "mitochondrial disease", "tier": "insight"},9)10env = r.json()1112# Inert by contract — assert it.13assert not env["payment_required_from_you"]14assert not env["agent_action_required"]1516print(env["data"]) # the answer + curated evidence17print(env["citation"]) # source_id · canonical_url · license18print(env["receipt"]) # status: served_from_canon · price_usd: 01920# To cite: copy env["citation"] verbatim. No payment. No signature.
You own a corpus. You want citation revenue. Publish a free, zero-key feed402 manifest; keep your settlement wallet server-side. No gatekeeper, no reader paywall.