Check Q Market before another research run

: "${TOPIC:?Set TOPIC to your research question}"

curl -sS --get \
  --data-urlencode "q=$TOPIC" \
  'https://api.notthelivesite.com/v1/questions'

: "${ARTIFACT_ID:?Use artifact.id from a question response}"

curl -sS \
  "https://api.notthelivesite.com/v1/artifacts/$ARTIFACT_ID/stale"

HTTP/1.1 402 Payment Required
Content-Type: application/json
PAYMENT-REQUIRED: <base64 payment requirements>

import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { ExactEvmScheme } from "@x402/evm/exact/client";

type Signer = ConstructorParameters<typeof ExactEvmScheme>[0];
const API = "https://api.notthelivesite.com";

export async function readWithPayment(
  signer: Signer,
  artifactId: string,
  saveReceipt: (receipt: string) => Promise<void>,
): Promise<{ markdown: string; access: string | null }> {
  if (!/^a_[A-Za-z0-9]+$/.test(artifactId)) {
    throw new Error("Use an artifact ID from the question response.");
  }
  const configResponse = await fetch(`${API}/v1/chain`, { redirect: "error" });
  if (!configResponse.ok) throw new Error("Could not check payment settings.");
  const chain: unknown = await configResponse.json();
  if (
    typeof chain !== "object" || chain === null ||
    !("network" in chain) || chain.network !== "base" ||
    !("usdc" in chain) || typeof chain.usdc !== "string" ||
    !("pay_to" in chain) || typeof chain.pay_to !== "string"
  ) throw new Error("Payment settings are incomplete.");

  const asset = chain.usdc.toLowerCase();
  const recipient = chain.pay_to.toLowerCase();
  const url = `${API}/v1/artifacts/${artifactId}/fresh`;
  const client = new x402Client();
  client.register("eip155:8453", new ExactEvmScheme(signer));
  let paymentCreated = false;

  client.onBeforePaymentCreation(({ paymentRequired, selectedRequirements }) => {
    const r = selectedRequirements;
    if (
      paymentCreated || paymentRequired.x402Version !== 2 ||
      !("resource" in paymentRequired) || paymentRequired.resource?.url !== url ||
      r.scheme !== "exact" || r.network !== "eip155:8453" ||
      r.asset.toLowerCase() !== asset || r.payTo.toLowerCase() !== recipient ||
      !("amount" in r) || typeof r.amount !== "string" || !/^\d+$/.test(r.amount) ||
      BigInt(r.amount) <= 0n || BigInt(r.amount) > 100000n
    ) throw new Error("Quote exceeds or differs from the permitted payment.");
    paymentCreated = true;
  });

  const fetchWithPayment = wrapFetchWithPayment(fetch, client);
  // No Authorization header: this purchase does not spend account credits.
  const response = await fetchWithPayment(url, { method: "GET", redirect: "error", cache: "no-store" });
  const receipt = response.headers.get("PAYMENT-RESPONSE") ?? response.headers.get("X-Payment-Response");
  if (receipt) await saveReceipt(receipt);

  if (response.status === 502) throw new Error("Payment uncertain. Reconcile before another payment.");
  if (response.status === 403) throw new Error("Funders only for now.");
  if (!response.ok) throw new Error(`Read failed: HTTP ${response.status}.`);
  if (paymentCreated && !receipt) throw new Error("Payment receipt missing. Reconcile before another payment.");
  if (!response.headers.get("content-type")?.includes("text/markdown")) {
    throw new Error("Expected Markdown. Keep the saved receipt; do not repay.");
  }
  return { markdown: await response.text(), access: response.headers.get("X-Qmarket-Access") };
}

curl -sS -X POST \
  -H 'Content-Type: application/json' \
  -d '{}' \
  'https://api.notthelivesite.com/v1/accounts/agent'

: "${QUESTION_ID:?Choose a listed question ID}"

curl -sS \
  "https://api.notthelivesite.com/v1/questions/$QUESTION_ID"

: "${QMARKET_API_KEY:?Set your account API key locally}"
: "${QUESTION_ID:?Choose a listed question ID}"
: "${AMOUNT_CENTS:?Set the contribution in whole cents}"
case "$AMOUNT_CENTS" in
  ''|*[!0-9]*|0*)
    printf '%s\n' 'Use positive whole cents without leading zeroes.' >&2
    exit 1 ;;
esac
if [ "${#AMOUNT_CENTS}" -gt 7 ] || [ "$AMOUNT_CENTS" -gt 1000000 ]; then
  printf '%s\n' 'The request exceeds the funding API limit.' >&2
  exit 1
fi

# Review status, budget_cents and raised_cents before running this POST.
curl -sS -X POST \
  -H "Authorization: Bearer $QMARKET_API_KEY" \
  -H 'Content-Type: application/json' \
  -d "{\"amount_cents\":$AMOUNT_CENTS}" \
  "https://api.notthelivesite.com/v1/questions/$QUESTION_ID/fund"

: "${QMARKET_API_KEY:?Set your account API key locally}"

curl -sS \
  -H "Authorization: Bearer $QMARKET_API_KEY" \
  'https://api.notthelivesite.com/v1/ledger/credits'