Ask Alice In Wonderland

{
  "author": "Carroll, Lewis",
  "book_id": 11,
  "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": 6,
      "chunk_end": 91,
      "chunk_ids": [
        1799,
        1800,
        1801,
        1802,
        1803
      ],
      "chunk_index": 89,
      "chunk_start": 87,
      "location": "section 6, passage #87–91",
      "source_url": "https://www.gutenberg.org/ebooks/11",
      "text": "“I shall sit here,” the Footman remarked, “till tomorrow—” At this moment the door of the house opened, and a large plate came skimming out, straight at the Footman’s head: it just grazed his nose, and broke to pieces against one of the trees behind him. “—or next day, maybe,” the Footman continued in the same tone, exactly as if nothing had happened. “How am I to get in?” asked Alice again, in a louder tone. “_Are_ you to get in at all?” said the Footman. “That’s the first question, you know.” It was, no doubt: only Alice did not like to be told so. “It’s really dreadful,” she muttered to herself, “the way all the creatures argue. It’s enough to drive one crazy!”\n\nThe Footman seemed to think this a good opportunity for repeating his remark, with variations. “I shall sit here,” he said, “on and off, for days and days.” “But what am _I_ to do?” said Alice. “Anything you like,” said the Footman, and began whistling. “Oh, there’s no use in talking to him,” said Alice desperately: “he’s p…"
    }
  ],
  "question": "what does the Cheshire Cat say",
  "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": "Alice's Adventures in Wonderland"
}

# bash or zsh: see the payment challenge. Nothing is charged.
curl -sS -g -i -X POST 'https://library.forgemesh.io/ask-alice-in-wonderland' \
  -H 'content-type: application/json' \
  --data-raw '{"limit":1,"question":"what does the Cheshire Cat say"}'

# 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-alice-in-wonderland' \
  -H 'content-type: application/json' \
  --data-raw '{"limit":1,"question":"what does the Cheshire Cat say"}' \
  | 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-alice-in-wonderland&method=POST
const res = await pay("https://library.forgemesh.io/ask-alice-in-wonderland", {
  method: "POST",
  headers: { "content-type": "application/json" },
  body: JSON.stringify({
    "limit": 1,
    "question": "what does the Cheshire Cat say"
  }),
});
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-alice-in-wonderland",
        json={
            "limit": 1,
            "question": "what does the Cheshire Cat say",
        },
    )
    print(res.status_code, res.text)