Ask Frankenstein

{
  "author": "Shelley, Mary Wollstonecraft",
  "book_id": 84,
  "chapter_detection": "heading",
  "count": 1,
  "location_note": "Chapter values are detected section indices, not guaranteed printed chapter numbers. Section 0 (text before the first detected heading) is excluded.",
  "method": "Full-text retrieval with common word variants and surrounding source text; no generated answer or summary. Up to 12 content terms, expanded into word variants, must match a local passage window.",
  "passages": [
    {
      "chapter": 17,
      "chunk_end": 254,
      "chunk_ids": [
        1446,
        1447,
        1448,
        1449,
        1450
      ],
      "chunk_index": 252,
      "chunk_start": 250,
      "location": "section 17, passage #250–254",
      "source_url": "https://www.gutenberg.org/ebooks/84",
      "text": "“In the meanwhile also the black ground was covered with herbage, and the green banks interspersed with innumerable flowers, sweet to the scent and the eyes, stars of pale radiance among the moonlight woods; the sun became warmer, the nights clear and balmy; and my nocturnal rambles were an extreme pleasure to me, although they were considerably shortened by the late setting and early rising of the sun, for I never ventured abroad during daylight, fearful of meeting with the same treatment I had formerly endured in the first village which I entered.\n\n“My days were spent in close attention, that I might more speedily master the language; and I may boast that I improved more rapidly than the Arabian, who understood very little and conversed in broken accents, whilst I comprehended and could imitate almost every word that was spoken. “While I improved in speech, I also learned the science of letters as it was taught to the stranger, and this opened before me a wide field for wonder and d…"
    }
  ],
  "question": "how does the creature learn to speak",
  "ranking_scope": "Book-local relevance ranking; works over 6000 chunks use up to 300 matching corpus-index candidates before ranking. Matches are evidence to inspect, not verified answers.",
  "title": "Frankenstein; or, the modern prometheus"
}

# bash or zsh: see the payment challenge. Nothing is charged.
curl -sS -g -i -X POST 'https://library.forgemesh.io/ask-frankenstein' \
  -H 'content-type: application/json' \
  --data-raw '{"limit":1,"question":"how does the creature learn to speak"}'

# x402 v2 sends the challenge base64-encoded in the PAYMENT-REQUIRED header (v1 sends it in the body).
# To read the header:
curl -sS -g -o /dev/null -D - -X POST 'https://library.forgemesh.io/ask-frankenstein' \
  -H 'content-type: application/json' \
  --data-raw '{"limit":1,"question":"how does the creature learn to speak"}' \
  | grep -i '^payment-required:' | cut -d' ' -f2 | tr -d '\r' | base64 --decode

// npm i @x402/fetch @x402/evm viem
import { wrapFetchWithPayment, x402Client } from "@x402/fetch";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

// Pays at most $0.01 per call.
const client = new x402Client().setSpendControls({ maxAmountPerPayment: "$0.01" });
registerExactEvmScheme(client, { signer: privateKeyToAccount(process.env.EVM_PRIVATE_KEY) });
const pay = wrapFetchWithPayment(fetch, client);

// Not sure it's safe to pay? ToolVet checks it first for $0.005. Pay for that from a separate
// client: this one is capped at $0.01 per payment. GET https://toolvet.app/api/v1/check?url=https%3A%2F%2Flibrary.forgemesh.io%2Fask-frankenstein&method=POST
const res = await pay("https://library.forgemesh.io/ask-frankenstein", {
  method: "POST",
  headers: { "content-type": "application/json" },
  body: JSON.stringify({
    "limit": 1,
    "question": "how does the creature learn to speak"
  }),
});
console.log(res.status, await res.text());

# pip install "x402[requests,evm]"
import os
from eth_account import Account
from x402 import x402ClientSync
from x402.http.clients import x402_requests
from x402.mechanisms.evm import EthAccountSigner
from x402.mechanisms.evm.exact.register import register_exact_evm_client

# Pays at most $0.01 per call.
client = x402ClientSync().set_spend_controls({"max_amount_per_payment": "$0.01"})
register_exact_evm_client(client, EthAccountSigner(Account.from_key(os.environ["EVM_PRIVATE_KEY"])))

with x402_requests(client) as session:
    res = session.post(
        "https://library.forgemesh.io/ask-frankenstein",
        json={
            "limit": 1,
            "question": "how does the creature learn to speak",
        },
    )
    print(res.status_code, res.text)