cited-diff
web-change-proof
change-detection
verifiable-diff
page-monitoring
content-hash
provenance
attestation
audit-trail
verifiable-web-fetch
agent-data
keyless
agent-native

MERCURY Cited Diff — signed web-change proof (refetch + verifiable fromHash->toHash receipt)

URL + prior content-hash (or prior text) -> refetch, deterministic change-proof: changed? + a NEW signed receipt binding fromHash->toHash. Stateless; receipts chain into a tamper-evident audit trail of a page's evolution. Keyless x402, Base mainnet USDC.

get/buy/diff

Request

Query parameters

urlstring required

the page to re-fetch + diff (http/https)

prevHashstring

prior content hash (0x + 64 hex sha256) from an earlier MERCURY fetch/diff receipt. Gives a hash-only change-proof (changed? true/false). Use this OR prevText.

prevTextstring

prior page text to diff against. Gives a full deterministic line-level diff (added/removed counts + unified-style hunk) on top of the change-proof. Use this OR prevHash.

format'text' | 'markdown'

compare cleaned text (default) or structure-preserving markdown

Response

Delivered after the x402 payment settles on Base mainnet.

okboolean required

true on success; false on an honest failure (still delivered)

urlstring required

final URL after redirects

statusinteger

upstream HTTP status of the refetch

changedboolean

true if the new content hash differs from the prior reference

fromHashstring

the prior content hash compared against (0x sha256). null if only prevText with no derivable hash

toHashstring

the NEW content hash of the refetched text (0x sha256)

comparedBy'hash' | 'text'

hash = prevHash supplied; text = prevText supplied (full line diff)

textstring

the canonical CHANGE CLAIM string the attestation signs over (the proof, not the page body)

bytesinteger

raw body size of the refetch

contentTypestring
fetchedAtstring

ISO timestamp of the refetch (also in the signed receipt)

errorstring

present only when ok:false

Changes

No recorded changes to this operation across all 1 revision of this API.