DVM Reference

satoshi-quotes

Check a quote or claim against the Satoshi Nakamoto Institute (SNI) public archive. Get a verdict, source passages, and links for $0.005 per check.

The Satoshi Quote Checker checks whether a quote or claim appears in the public archive maintained by the Satoshi Nakamoto Institute (SNI). It returns matching passages and links, or says that nothing matches. Its excerpts come from the archive. A completed check costs half a US cent. SNI does not run or endorse this service.

What it checks

satoshi-quotes is a Digital Vending Machine (DVM), a pay-per-use service your agent can call. Its check capability compares text with SNI's public archive of emails, forum posts, and the Bitcoin whitepaper. It also checks other authors' text in the same archive to identify misattributions.

It searches a pinned archive snapshot, not the live web. Each result names the source commit that answered the request. A missing match does not prove that the words were never said elsewhere.

  • Price: $0.005 per completed quote check (USD), including a result with no match.
  • Per-call payment: Bitcoin ecash using Cashu.
  • Prepaid credit funding: Cashu ecash or Bitcoin Lightning. There is no stablecoin rail.
  • Endpoint: https://dvmkit--satoshi-quotes.dvmkit.ai, capability check.

Request

Send a JSON object with one field, quote: a string of 1 to 2,000 characters after trimming surrounding whitespace. It can be a quotation or a claim to check. Empty or whitespace-only input is an input error and is not charged.

{
  "quote": "We have proposed a system for electronic transactions without relying on trust."
}

Quotes and prepaid credit require signed requests. The dvm CLI signs them with the caller's identity. Per-call Cashu jobs can also be unsigned. The live descriptor publishes the current schemas, price, and payment methods.

Unsigned Cashu payments

The check capability accepts one unsigned NUT-24 Cashu payment for a quote of 1 to 2,000 characters after trimming. Unsigned callers pay $0.005 upfront, receive no mid-job payment request, and get no refund if the job fails. Signed callers pay zero upfront and $0.005 mid-job after input and provider availability checks. Prepaid credit requires a signed caller.

An unsigned POST /v1/job returns HTTP 402 with an X-Cashu: creqA… payment request. A stock NUT-24 wallet such as Nutshell pays it with cashu pay and resends the same body with the token in X-Cashu, without X-Cashu-Request-Id. Nutshell adds a 1-day refund lock, which this DVM accepts under its 12-hour cashu.unsigned_min_locktime floor.

If the check completes within the inline wait (10 seconds by default), its result returns in messages in the same paid response, up to 1,048,576 serialised UTF-8 bytes. Otherwise, keep job_id and job_token to poll and read the result with X-Job-Token. See the wire contract.

Response

This exact match points to the Bitcoin whitepaper. The corpus metadata identifies the snapshot used.

{
  "verdict": "exact",
  "explanation": "This text matches Satoshi Nakamoto's words in the archive.",
  "passages": [
    {
      "author": "Satoshi Nakamoto",
      "source_type": "whitepaper",
      "source_name": "Bitcoin whitepaper",
      "title": "Bitcoin: A Peer-to-Peer Electronic Cash System",
      "date": "2008-10-31T00:00:00Z",
      "excerpt": "We have proposed a system for electronic transactions without relying on trust. We started with the usual framework of coins made from digital signatures, which provides strong control of ownership, but is incomplete without a way to prevent double-spending. To solve this, we proposed a peer-to-peer network using proof-of-work to record a public history of transactions that quickly becomes computationally impractical for an attacker to change if honest nodes control a majority of CPU power. The network is robust in its unstructured simplicity. Nodes work all at once with little coordination. T",
      "permalink": "https://nakamotoinstitute.org/library/bitcoin/"
    }
  ],
  "corpus": {
    "source_repo": "https://github.com/NakamotoInstitute/nakamotoinstitute.org",
    "source_commit": "3bb1aa413a325bbf295a1e3424c272a0d549b42b",
    "built_at": "2026-10-21T14:21:57Z"
  },
  "credit": {
    "text": "Source: Satoshi Nakamoto Institute (nakamotoinstitute.org)",
    "url": "https://nakamotoinstitute.org/",
    "license": "CC BY-SA 4.0",
    "license_url": "https://creativecommons.org/licenses/by-sa/4.0/"
  },
  "display": "exact: This text matches Satoshi Nakamoto's words in the archive.\nSatoshi Nakamoto: We have proposed a system for electronic transactions without relying on trust. We started with the usual framework of coins made from digital signatures, which provides strong control of ownership, but is incomplete without a way to prevent double-spending. To solve this, we proposed a peer-to-peer network using proof-of-work to record a public history of transactions that quickly becomes computationally impractical for an attacker to change if honest nodes control a majority of CPU power. The network is robust in its unstructured simplicity. Nodes work all at once with little coordination. T (https://nakamotoinstitute.org/library/bitcoin/)\nSource: Satoshi Nakamoto Institute (nakamotoinstitute.org)"
}

An agent can pass display to a human verbatim. It ends with the source credit line. Every result includes corpus and credit, even when no passage matches.

Four verdicts

VerdictMeaning
exactThe text matches an archive passage by Satoshi after normalising typography, case, and whitespace.
paraphraseThe wording differs, but the cited passage supports the attribution. Read the excerpt and explanation for what changed.
misattributedThe text matches exactly or closely a passage by another author in the archive, with no matching Satoshi passage.
no_matchNothing in the archive matches. passages is empty. The service never guesses a nearest passage to fill the gap.

The first three verdicts include at least one passage. Each passage has these fields:

FieldContent
authorThe archive author. A misattributed result names the other author.
source_typeemail, forum_post, or whitepaper.
source_nameThe mailing list, forum, or Bitcoin whitepaper.
titleThe subject or thread title.
dateThe source date in ISO 8601 format.
excerptVerbatim matching archive text, up to about 600 characters.
permalinkThe source link, or null if no link is available. Other-author passages use a thread link when available.

Limits

Exact matches and text below the local matching threshold need no language-model call. A near match uses one Haiku 4.5 call to compare the input with retrieved candidate passages. The model selects a verdict and archive passage ids only. Code builds explanations from archive text and your input; it does not publish model prose.

This is a checker, not a writing service. An input asking for a new email in Satoshi's voice can still receive a verdict about archive material it resembles. Text below the local matching threshold returns no_match without calling the model.

A near-match explanation names the closest selected passage’s author, source, and date. It quotes the best-matching archive sentence, capped at 160 characters, then reports which words your text adds or leaves out. The word comparison ignores typography, case, and punctuation. It shows at most two contiguous spans per side, each capped at 80 characters, and marks truncation outside the quotation. This reports wording changes; it does not explain their meaning.

Pricing and credit

Each completed check costs $0.005 USD. That is half a US cent, converted to Bitcoin at the quoted exchange rate. It is not a fixed number of sats. Failed signed jobs are not charged. Unsigned payments are not refunded. A completed no_match is charged.

Cashu ecash can pay for one $0.005 check without a $2 prepaid balance. The $2 minimum applies to explicit prepaid funding.

Prepaid credit has a $2.00 minimum funding and a $10.00 maximum residual balance. Cashu ecash and Bitcoin Lightning can fund it. Bitcoin Lightning has its own receive minimum, which may be higher than $2.00; read the live descriptor before funding. Bitcoin Lightning is a credit-funding rail, not a per-call invoice option. x402 and Tempo are not offered. See Credits for how balances work.

Error codes

Invalid input is not charged. Failed signed jobs release any payment hold to the caller's credit. An unsigned payer gets no refund if the job fails; a completed no_match is a paid result.

CodeMeaning and next step
invalid_inputHTTP 400: the input does not satisfy the published schema. Send a quote of 1 to 2,000 characters after trimming whitespace.
auth_errorHTTP 401: the request needs a valid signature for this operation. Use the dvm CLI to sign a fresh request.
input_errorThe handler received invalid quote input. Correct the quote; HTTP submissions normally fail earlier as invalid_input.
llm_unavailableNear-match comparison is unavailable on this instance because its provider key is missing. No payment was requested. Retry when the instance is configured.
ungrounded_passageThe comparison returned invalid archive references. The job failed; retry the check.
check_failedThe quote comparison failed. The job failed; retry the check.

Sources and licence

The source is the Satoshi Nakamoto Institute public archive. The service uses its emails, forum posts, and Bitcoin whitepaper text. SNI does not endorse or operate this DVM.

Quoted passages carry the source credit and CC BY-SA 4.0 licence. Keep the attribution and licence link when sharing excerpts. The response's credit object supplies both. Its corpus object records the source repository and pinned commit so a result can be traced to the archive version used. The built_at value is the pinned source commit's UTC timestamp.

See also