lightnode-sdk 0.7.13 → 0.7.15

package/dist/add.d.ts

@@ -48,6 +48,34 @@ export declare function addChat(opts?: AddOpts): {
     template: Template;
     network: Network;
 };
+/**
+ * `lightnode add chat-web3` - the user-pays counterpart to addChat.
+ *
+ * Architecture:
+ *   - Each visitor's own wallet signs SIWE + createSession per turn.
+ *   - The dev's app holds zero funds; cost is borne by each user (0.02 LCAI
+ *     per llama3-8b turn on mainnet).
+ *   - No backend, no PRIVATE_KEY, no server-side hot wallet.
+ *
+ * Fit:
+ *   - Web3 dApps where users already have a wallet (NFT, meme coin, on-chain
+ *     games, LightChallenge-style challenge platforms).
+ *   - For SaaS chatbots where users do NOT have a wallet, use `add chat`
+ *     instead (dev pays, server-side route).
+ */
+export declare function addChatWeb3(opts?: AddOpts): {
+    written: WrittenFile[];
+    install: string;
+    template: Template;
+    network: Network;
+    needsWagmi: boolean;
+};
+export declare function addJudge(opts?: AddOpts): {
+    written: WrittenFile[];
+    install: string;
+    template: Template;
+    network: Network;
+};
 export declare function addNftMint(opts?: AddOpts): {
     written: WrittenFile[];
     install: string;

package/dist/add.js

@@ -39,109 +39,48 @@ MODEL=llama3-8b
 `;
 const NEXTJS_ROUTE = `// app/api/inference/route.ts
 // Generated by 'lightnode add inference'. See https://lightnode.app/build
+// Uses runInferenceWithKey: one call, full encrypted-inference flow.
 import { NextResponse } from "next/server";
-import WS from "ws";
-import { createPublicClient, createWalletClient, http, parseAbi, parseAbiItem, parseEther, type Log } from "viem";
-import { privateKeyToAccount } from "viem/accounts";
-import {
-  LightNode, prepareSession, submitPrompt, decryptResponse,
-  estimateJobFee, consumerGatewayUrl, JOB_REGISTRY_CONSUMER_ABI,
-  GatewayClient, type NetworkId,
-} from "lightnode-sdk";
+import { runInferenceWithKey } from "lightnode-sdk";
 
 export const runtime = "nodejs";
 export const dynamic = "force-dynamic";
+// Mainnet 8b takes 60-90s under load; give the function room to finish.
 export const maxDuration = 120;
 
-const NETWORK = (process.env.NETWORK ?? "testnet") as NetworkId;
+const NETWORK = (process.env.NETWORK ?? "testnet") as "mainnet" | "testnet";
 const MODEL = process.env.MODEL ?? "llama3-8b";
 
 export async function POST(req: Request) {
   if (!process.env.PRIVATE_KEY?.startsWith("0x")) {
     return NextResponse.json({ error: "PRIVATE_KEY not configured" }, { status: 500 });
   }
-  const body = (await req.json().catch(() => ({}))) as { prompt?: string };
+  const body = (await req.json().catch(() => ({}))) as { prompt?: string; system?: string };
   const prompt = body.prompt?.trim();
   if (!prompt) return NextResponse.json({ error: "prompt is required" }, { status: 400 });
 
-  const ln = new LightNode(NETWORK);
-  const cfg = ln.network;
-  const acct = privateKeyToAccount(process.env.PRIVATE_KEY as \`0x\${string}\`);
-  const chain = { id: cfg.chainId, name: cfg.label, nativeCurrency: { name: "LCAI", symbol: "LCAI", decimals: 18 }, rpcUrls: { default: { http: [cfg.rpc] } } };
-  const pub = createPublicClient({ transport: http(cfg.rpc), chain });
-  const wal = createWalletClient({ account: acct, transport: http(cfg.rpc), chain });
-  const abi = parseAbi(JOB_REGISTRY_CONSUMER_ABI);
-
-  const ch = await (await fetch(\`\${consumerGatewayUrl(NETWORK)}/api/auth/challenge?address=\${acct.address}\`)).json() as { message?: string };
-  if (!ch.message) return NextResponse.json({ error: "auth challenge failed" }, { status: 502 });
-  const sig = await wal.signMessage({ message: ch.message });
-  const verify = await (await fetch(\`\${consumerGatewayUrl(NETWORK)}/api/auth/verify\`, {
-    method: "POST", headers: { "Content-Type": "application/json" },
-    body: JSON.stringify({ message: ch.message, signature: sig }),
-  })).json() as { token?: string };
-  if (!verify.token) return NextResponse.json({ error: "auth verify failed" }, { status: 502 });
-
-  const gateway = new GatewayClient({ network: NETWORK, bearer: verify.token });
-  const { sessionKey, createSessionArgs } = await prepareSession(gateway, MODEL);
-  const fee = await estimateJobFee(cfg, MODEL);
-  const createTx = await wal.writeContract({
-    address: cfg.jobRegistry as \`0x\${string}\`, abi, functionName: "createSession",
-    args: [createSessionArgs.paramsHash, createSessionArgs.worker, createSessionArgs.encWorkerKey, createSessionArgs.ephemeralPubKey, createSessionArgs.initState, createSessionArgs.expiry],
-    gas: 1_000_000n,
-  });
-  const createReceipt = await pub.waitForTransactionReceipt({ hash: createTx });
-  const sessionCreated = parseAbiItem("event SessionCreated(uint256 indexed sessionId, address indexed user, bytes32 indexed paramsHash, address worker, bytes encWorkerKey, bytes ephemeralPubKey)");
-  const sessionLog = (await pub.getLogs({ address: cfg.jobRegistry as \`0x\${string}\`, event: sessionCreated, blockHash: createReceipt.blockHash })).find((l) => l.transactionHash === createTx);
-  const sessionId = sessionLog?.args.sessionId;
-  if (!sessionId) return NextResponse.json({ error: "SessionCreated missing" }, { status: 500 });
-
-  let relayToken: string | undefined;
-  for (let i = 0; i < 30 && !relayToken; i++) {
-    const r = await gateway.getSessionToken(Number(sessionId));
-    if ("token" in r && r.token) relayToken = r.token; else await new Promise((res) => setTimeout(res, 1000));
-  }
-  if (!relayToken) return NextResponse.json({ error: "relay token never became ready" }, { status: 504 });
-  const ws = new WS(\`wss://relay.\${NETWORK}.lightchain.ai/ws?token=\${encodeURIComponent(relayToken)}\`);
-  const chunks: string[] = [];
-  await new Promise<void>((res, rej) => { ws.once("open", () => res()); ws.once("error", rej); });
-  ws.on("message", async (data: Buffer) => {
-    let f: { type?: string; payload?: string };
-    try { f = JSON.parse(data.toString("utf8")); } catch { return; }
-    if (!f.payload) return;
-    if (f.type === "chunk") { try { chunks.push(await decryptResponse(sessionKey, f.payload)); } catch {} }
-    else if (f.type === "complete" && chunks.length === 0) { try { chunks.push(await decryptResponse(sessionKey, f.payload)); } catch {} }
-  });
-
-  const promptHash = await submitPrompt(gateway, sessionKey, prompt);
-  const submitTx = await wal.writeContract({
-    address: cfg.jobRegistry as \`0x\${string}\`, abi, functionName: "submitJob",
-    args: [sessionId, promptHash], value: parseEther(String(fee)), gas: 500_000n,
-  });
-  const submitReceipt = await pub.waitForTransactionReceipt({ hash: submitTx });
-  const jobSubmitted = parseAbiItem("event JobSubmitted(uint256 indexed jobId, uint256 indexed sessionId, address worker)");
-  const jobLog = (await pub.getLogs({ address: cfg.jobRegistry as \`0x\${string}\`, event: jobSubmitted, blockHash: submitReceipt.blockHash })).find((l) => l.transactionHash === submitTx);
-  const jobId = jobLog?.args.jobId;
-  if (!jobId) return NextResponse.json({ error: "JobSubmitted missing" }, { status: 500 });
-
-  const jobCompleted = parseAbiItem("event JobCompleted(uint256 indexed jobId, address indexed worker, bytes32 responseHash, bytes32 ciphertextHash)");
-  const deadline = Date.now() + 90_000;
-  let completed: Log | null = null;
-  while (!completed && Date.now() < deadline) {
-    await new Promise((res) => setTimeout(res, 3000));
-    const logs = await pub.getLogs({ address: cfg.jobRegistry as \`0x\${string}\`, event: jobCompleted, args: { jobId }, fromBlock: submitReceipt.blockNumber });
-    if (logs.length) completed = logs[0] as Log;
+  try {
+    const { answer, worker, txs, jobId } = await runInferenceWithKey({
+      network: NETWORK,
+      privateKey: process.env.PRIVATE_KEY as \`0x\${string}\`,
+      model: MODEL,
+      // Optional system prompt - leave undefined for raw user prompts.
+      system: body.system?.trim() || undefined,
+      prompt,
+    });
+    return NextResponse.json({
+      answer,
+      worker,
+      jobId: jobId.toString(),
+      txs: {
+        createSession: txs.createSession,
+        submitJob: txs.submitJob,
+        jobCompleted: txs.jobCompleted,
+      },
+    });
+  } catch (e) {
+    return NextResponse.json({ error: (e as Error).message }, { status: 500 });
   }
-  await new Promise((res) => setTimeout(res, 4000));
-  ws.close();
-  if (!completed) return NextResponse.json({ error: "worker stalled", txs: { createSession: createTx, submitJob: submitTx } }, { status: 504 });
-
-  return NextResponse.json({
-    answer: chunks.join(""),
-    txs: { createSession: createTx, submitJob: submitTx, jobCompleted: completed.transactionHash },
-    sessionId: sessionId.toString(),
-    jobId: jobId.toString(),
-    worker: createSessionArgs.worker,
-  });
 }
 `;
 const HONO_HANDLER = `// lightchain-inference.ts
@@ -153,179 +92,65 @@ const HONO_HANDLER = `// lightchain-inference.ts
 //   const app = new Hono();
 //   app.post("/inference", inferenceHandler);
 //
-import WS from "ws";
-import { createPublicClient, createWalletClient, http, parseAbi, parseAbiItem, parseEther, type Log } from "viem";
-import { privateKeyToAccount } from "viem/accounts";
 import type { Context } from "hono";
-import {
-  LightNode, prepareSession, submitPrompt, decryptResponse,
-  estimateJobFee, consumerGatewayUrl, JOB_REGISTRY_CONSUMER_ABI,
-  GatewayClient, type NetworkId,
-} from "lightnode-sdk";
+import { runInferenceWithKey } from "lightnode-sdk";
 
-const NETWORK = (process.env.NETWORK ?? "testnet") as NetworkId;
+const NETWORK = (process.env.NETWORK ?? "testnet") as "mainnet" | "testnet";
 const MODEL = process.env.MODEL ?? "llama3-8b";
 
 export async function inferenceHandler(c: Context) {
   if (!process.env.PRIVATE_KEY?.startsWith("0x")) return c.json({ error: "PRIVATE_KEY not set" }, 500);
-  const body = await c.req.json().catch(() => ({} as { prompt?: string }));
+  const body = (await c.req.json().catch(() => ({}))) as { prompt?: string; system?: string };
   const prompt = body.prompt?.trim();
   if (!prompt) return c.json({ error: "prompt is required" }, 400);
 
-  const ln = new LightNode(NETWORK);
-  const cfg = ln.network;
-  const acct = privateKeyToAccount(process.env.PRIVATE_KEY as \`0x\${string}\`);
-  const chain = { id: cfg.chainId, name: cfg.label, nativeCurrency: { name: "LCAI", symbol: "LCAI", decimals: 18 }, rpcUrls: { default: { http: [cfg.rpc] } } };
-  const pub = createPublicClient({ transport: http(cfg.rpc), chain });
-  const wal = createWalletClient({ account: acct, transport: http(cfg.rpc), chain });
-  const abi = parseAbi(JOB_REGISTRY_CONSUMER_ABI);
-
-  const ch = await (await fetch(\`\${consumerGatewayUrl(NETWORK)}/api/auth/challenge?address=\${acct.address}\`)).json() as { message?: string };
-  if (!ch.message) return c.json({ error: "auth challenge failed" }, 502);
-  const sig = await wal.signMessage({ message: ch.message });
-  const verify = await (await fetch(\`\${consumerGatewayUrl(NETWORK)}/api/auth/verify\`, { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify({ message: ch.message, signature: sig }) })).json() as { token?: string };
-  if (!verify.token) return c.json({ error: "auth verify failed" }, 502);
-  const gateway = new GatewayClient({ network: NETWORK, bearer: verify.token });
-
-  const { sessionKey, createSessionArgs } = await prepareSession(gateway, MODEL);
-  const fee = await estimateJobFee(cfg, MODEL);
-  const createTx = await wal.writeContract({
-    address: cfg.jobRegistry as \`0x\${string}\`, abi, functionName: "createSession",
-    args: [createSessionArgs.paramsHash, createSessionArgs.worker, createSessionArgs.encWorkerKey, createSessionArgs.ephemeralPubKey, createSessionArgs.initState, createSessionArgs.expiry],
-    gas: 1_000_000n,
-  });
-  const createReceipt = await pub.waitForTransactionReceipt({ hash: createTx });
-  const sessionCreated = parseAbiItem("event SessionCreated(uint256 indexed sessionId, address indexed user, bytes32 indexed paramsHash, address worker, bytes encWorkerKey, bytes ephemeralPubKey)");
-  const sessionLog = (await pub.getLogs({ address: cfg.jobRegistry as \`0x\${string}\`, event: sessionCreated, blockHash: createReceipt.blockHash })).find((l) => l.transactionHash === createTx);
-  const sessionId = sessionLog?.args.sessionId;
-  if (!sessionId) return c.json({ error: "SessionCreated missing" }, 500);
-
-  let relayToken: string | undefined;
-  for (let i = 0; i < 30 && !relayToken; i++) { const r = await gateway.getSessionToken(Number(sessionId)); if ("token" in r && r.token) relayToken = r.token; else await new Promise((res) => setTimeout(res, 1000)); }
-  if (!relayToken) return c.json({ error: "relay token never became ready" }, 504);
-  const ws = new WS(\`wss://relay.\${NETWORK}.lightchain.ai/ws?token=\${encodeURIComponent(relayToken)}\`);
-  const chunks: string[] = [];
-  await new Promise<void>((res, rej) => { ws.once("open", () => res()); ws.once("error", rej); });
-  ws.on("message", async (data: Buffer) => {
-    let f: { type?: string; payload?: string };
-    try { f = JSON.parse(data.toString("utf8")); } catch { return; }
-    if (!f.payload) return;
-    if (f.type === "chunk") { try { chunks.push(await decryptResponse(sessionKey, f.payload)); } catch {} }
-    else if (f.type === "complete" && chunks.length === 0) { try { chunks.push(await decryptResponse(sessionKey, f.payload)); } catch {} }
-  });
-
-  const promptHash = await submitPrompt(gateway, sessionKey, prompt);
-  const submitTx = await wal.writeContract({
-    address: cfg.jobRegistry as \`0x\${string}\`, abi, functionName: "submitJob",
-    args: [sessionId, promptHash], value: parseEther(String(fee)), gas: 500_000n,
-  });
-  const submitReceipt = await pub.waitForTransactionReceipt({ hash: submitTx });
-  const jobSubmitted = parseAbiItem("event JobSubmitted(uint256 indexed jobId, uint256 indexed sessionId, address worker)");
-  const jobLog = (await pub.getLogs({ address: cfg.jobRegistry as \`0x\${string}\`, event: jobSubmitted, blockHash: submitReceipt.blockHash })).find((l) => l.transactionHash === submitTx);
-  const jobId = jobLog?.args.jobId;
-  if (!jobId) return c.json({ error: "JobSubmitted missing" }, 500);
-
-  const jobCompleted = parseAbiItem("event JobCompleted(uint256 indexed jobId, address indexed worker, bytes32 responseHash, bytes32 ciphertextHash)");
-  const deadline = Date.now() + 90_000;
-  let completed: Log | null = null;
-  while (!completed && Date.now() < deadline) {
-    await new Promise((res) => setTimeout(res, 3000));
-    const logs = await pub.getLogs({ address: cfg.jobRegistry as \`0x\${string}\`, event: jobCompleted, args: { jobId }, fromBlock: submitReceipt.blockNumber });
-    if (logs.length) completed = logs[0] as Log;
+  try {
+    const { answer, worker, txs, jobId } = await runInferenceWithKey({
+      network: NETWORK,
+      privateKey: process.env.PRIVATE_KEY as \`0x\${string}\`,
+      model: MODEL,
+      system: body.system?.trim() || undefined,
+      prompt,
+    });
+    return c.json({
+      answer,
+      worker,
+      jobId: jobId.toString(),
+      txs: {
+        createSession: txs.createSession,
+        submitJob: txs.submitJob,
+        jobCompleted: txs.jobCompleted,
+      },
+    });
+  } catch (e) {
+    return c.json({ error: (e as Error).message }, 500);
   }
-  await new Promise((res) => setTimeout(res, 4000));
-  ws.close();
-  if (!completed) return c.json({ error: "worker stalled", txs: { createSession: createTx, submitJob: submitTx } }, 504);
-  return c.json({ answer: chunks.join(""), txs: { createSession: createTx, submitJob: submitTx, jobCompleted: completed.transactionHash }, sessionId: sessionId.toString(), jobId: jobId.toString(), worker: createSessionArgs.worker });
 }
 `;
 const NODE_SCRIPT = `// lightchain-inference.ts
 // Generated by 'lightnode add inference'. Run with: tsx lightchain-inference.ts "your prompt"
-import WS from "ws";
-import { createPublicClient, createWalletClient, http, parseAbi, parseAbiItem, parseEther, type Log } from "viem";
-import { privateKeyToAccount } from "viem/accounts";
-import {
-  LightNode, prepareSession, submitPrompt, decryptResponse,
-  estimateJobFee, consumerGatewayUrl, JOB_REGISTRY_CONSUMER_ABI,
-  GatewayClient, type NetworkId,
-} from "lightnode-sdk";
+import { runInferenceWithKey, LightNode } from "lightnode-sdk";
 
-const NETWORK = (process.env.NETWORK ?? "testnet") as NetworkId;
+const NETWORK = (process.env.NETWORK ?? "testnet") as "mainnet" | "testnet";
 const MODEL = process.env.MODEL ?? "llama3-8b";
 const PROMPT = process.argv.slice(2).join(" ").trim() || "Reply with a one-sentence fun fact.";
 const PRIVATE_KEY = process.env.PRIVATE_KEY as \`0x\${string}\` | undefined;
-if (!PRIVATE_KEY?.startsWith("0x") || PRIVATE_KEY.length !== 66) { console.error("set PRIVATE_KEY in .env"); process.exit(1); }
+if (!PRIVATE_KEY) { console.error("PRIVATE_KEY not set. Put one in .env (testnet faucet: https://lightfaucet.ai)"); process.exit(1); }
+const KEY = PRIVATE_KEY as \`0x\${string}\`;
 
 const ln = new LightNode(NETWORK);
-const cfg = ln.network;
-const acct = privateKeyToAccount(PRIVATE_KEY);
-const chain = { id: cfg.chainId, name: cfg.label, nativeCurrency: { name: "LCAI", symbol: "LCAI", decimals: 18 }, rpcUrls: { default: { http: [cfg.rpc] } } };
-const pub = createPublicClient({ transport: http(cfg.rpc), chain });
-const wal = createWalletClient({ account: acct, transport: http(cfg.rpc), chain });
-const abi = parseAbi(JOB_REGISTRY_CONSUMER_ABI);
-
-const ch = await (await fetch(\`\${consumerGatewayUrl(NETWORK)}/api/auth/challenge?address=\${acct.address}\`)).json() as { message?: string };
-if (!ch.message) throw new Error("auth challenge failed");
-const sig = await wal.signMessage({ message: ch.message });
-const verify = await (await fetch(\`\${consumerGatewayUrl(NETWORK)}/api/auth/verify\`, { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify({ message: ch.message, signature: sig }) })).json() as { token?: string };
-if (!verify.token) throw new Error("auth verify failed");
-const gateway = new GatewayClient({ network: NETWORK, bearer: verify.token });
-
-const { sessionKey, createSessionArgs } = await prepareSession(gateway, MODEL);
-const fee = await estimateJobFee(cfg, MODEL);
-const createTx = await wal.writeContract({
-  address: cfg.jobRegistry as \`0x\${string}\`, abi, functionName: "createSession",
-  args: [createSessionArgs.paramsHash, createSessionArgs.worker, createSessionArgs.encWorkerKey, createSessionArgs.ephemeralPubKey, createSessionArgs.initState, createSessionArgs.expiry],
-  gas: 1_000_000n,
+const { answer, worker, txs, jobId } = await runInferenceWithKey({
+  network: NETWORK,
+  privateKey: KEY,
+  model: MODEL,
+  prompt: PROMPT,
 });
-const createReceipt = await pub.waitForTransactionReceipt({ hash: createTx });
-const sessionCreated = parseAbiItem("event SessionCreated(uint256 indexed sessionId, address indexed user, bytes32 indexed paramsHash, address worker, bytes encWorkerKey, bytes ephemeralPubKey)");
-const sessionLog = (await pub.getLogs({ address: cfg.jobRegistry as \`0x\${string}\`, event: sessionCreated, blockHash: createReceipt.blockHash })).find((l) => l.transactionHash === createTx);
-if (!sessionLog?.args.sessionId) throw new Error("SessionCreated missing");
-const sessionId = sessionLog.args.sessionId;
 
-let relayToken: string | undefined;
-for (let i = 0; i < 30 && !relayToken; i++) {
-  const r = await gateway.getSessionToken(Number(sessionId));
-  if ("token" in r && r.token) relayToken = r.token; else await new Promise((res) => setTimeout(res, 1000));
-}
-if (!relayToken) throw new Error("relay token never became ready");
-const ws = new WS(\`wss://relay.\${NETWORK}.lightchain.ai/ws?token=\${encodeURIComponent(relayToken)}\`);
-const chunks: string[] = [];
-await new Promise<void>((res, rej) => { ws.once("open", () => res()); ws.once("error", rej); });
-ws.on("message", async (data: Buffer) => {
-  let f: { type?: string; payload?: string };
-  try { f = JSON.parse(data.toString("utf8")); } catch { return; }
-  if (!f.payload) return;
-  if (f.type === "chunk") { try { chunks.push(await decryptResponse(sessionKey, f.payload)); } catch {} }
-  else if (f.type === "complete" && chunks.length === 0) { try { chunks.push(await decryptResponse(sessionKey, f.payload)); } catch {} }
-});
-
-const promptHash = await submitPrompt(gateway, sessionKey, PROMPT);
-const submitTx = await wal.writeContract({
-  address: cfg.jobRegistry as \`0x\${string}\`, abi, functionName: "submitJob",
-  args: [sessionId, promptHash], value: parseEther(String(fee)), gas: 500_000n,
-});
-const submitReceipt = await pub.waitForTransactionReceipt({ hash: submitTx });
-const jobSubmitted = parseAbiItem("event JobSubmitted(uint256 indexed jobId, uint256 indexed sessionId, address worker)");
-const jobLog = (await pub.getLogs({ address: cfg.jobRegistry as \`0x\${string}\`, event: jobSubmitted, blockHash: submitReceipt.blockHash })).find((l) => l.transactionHash === submitTx);
-const jobId = jobLog?.args.jobId;
-if (!jobId) throw new Error("JobSubmitted missing");
-
-const jobCompleted = parseAbiItem("event JobCompleted(uint256 indexed jobId, address indexed worker, bytes32 responseHash, bytes32 ciphertextHash)");
-const deadline = Date.now() + 90_000;
-let completed: Log | null = null;
-while (!completed && Date.now() < deadline) {
-  await new Promise((res) => setTimeout(res, 3000));
-  const logs = await pub.getLogs({ address: cfg.jobRegistry as \`0x\${string}\`, event: jobCompleted, args: { jobId }, fromBlock: submitReceipt.blockNumber });
-  if (logs.length) completed = logs[0] as Log;
-}
-if (!completed) { console.error("worker stalled - re-run for a different worker"); process.exit(1); }
-await new Promise((res) => setTimeout(res, 4000));
-ws.close();
-console.log("\\n=== ANSWER ===\\n" + chunks.join("") + "\\n");
-console.log("createSession:", createTx, "\\nsubmitJob:    ", submitTx, "\\njobCompleted: ", completed.transactionHash);
-process.exit(0);
+console.log("\\nanswer       :", answer);
+console.log("job id       :", jobId.toString());
+console.log("worker       :", worker);
+console.log("submitJob tx :", ln.explorerTxUrl(txs.submitJob));
+if (txs.jobCompleted) console.log("completed tx :", ln.explorerTxUrl(txs.jobCompleted));
 `;
 function writeFile(abs, contents, force) {
     const rel = path.relative(process.cwd(), abs) || abs;
@@ -846,6 +671,207 @@ export default function Chat() {
   );
 }
 `;
+const NEXTJS_CHAT_WEB3_PAGE = `// app/chat-web3/page.tsx
+// Generated by 'lightnode add chat-web3'. User-pays chat: each visitor's own
+// wallet signs SIWE + createSession per turn. Your app holds zero funds.
+//
+// Prereqs:
+//   - wagmi configured in your app (https://wagmi.sh/react/getting-started)
+//   - the connected wallet has LCAI on the LightChain network it is on
+//     (mainnet 9200 or testnet 8200). Mainnet llama3-8b costs 0.02 LCAI per
+//     turn plus a small gas amount.
+"use client";
+
+import { useEffect, useState } from "react";
+import { useAccount, useWalletClient, usePublicClient } from "wagmi";
+import { siweSignIn, GatewayClient, runInference, estimateJobFee, NETWORKS } from "lightnode-sdk";
+
+type Turn = {
+  role: "user" | "assistant";
+  text: string;
+  worker?: string | null;
+  jobId?: string | null;
+  submitTx?: \`0x\${string}\` | null;
+  jobCompletedTx?: \`0x\${string}\` | null;
+};
+
+const MODEL = "llama3-8b";
+
+export default function ChatWeb3() {
+  const { address, chain } = useAccount();
+  const network: "mainnet" | "testnet" | null =
+    chain?.id === 9200 ? "mainnet" : chain?.id === 8200 ? "testnet" : null;
+  const { data: walletClient } = useWalletClient({ chainId: chain?.id });
+  const publicClient = usePublicClient({ chainId: chain?.id });
+
+  const [turns, setTurns] = useState<Turn[]>([]);
+  const [input, setInput] = useState("");
+  const [busy, setBusy] = useState(false);
+  const [busyStage, setBusyStage] = useState("");
+  const [err, setErr] = useState<string | null>(null);
+  const [feeLcai, setFeeLcai] = useState<number | null>(null);
+
+  // Read the on-chain fee for the connected network so we can show the
+  // visitor the real cost per turn before they click Send.
+  useEffect(() => {
+    if (!network) { setFeeLcai(null); return; }
+    let cancelled = false;
+    estimateJobFee(NETWORKS[network], MODEL).then(
+      (fee) => { if (!cancelled) setFeeLcai(fee); },
+      () => { if (!cancelled) setFeeLcai(null); },
+    );
+    return () => { cancelled = true; };
+  }, [network]);
+
+  /** Build a single prompt from history + new user input. */
+  function composePrompt(history: Turn[], next: string, system: string): string {
+    const lines: string[] = [];
+    for (const t of history) {
+      lines.push(\`\${t.role === "user" ? "User" : "Assistant"}: \${t.text}\`);
+    }
+    lines.push(\`User: \${next}\`);
+    lines.push("Assistant:");
+    return system ? \`\${system}\\n\\n\${lines.join("\\n\\n")}\` : lines.join("\\n\\n");
+  }
+
+  async function send() {
+    if (!walletClient || !publicClient || !address || !network) {
+      setErr("Connect a wallet on LightChain mainnet (9200) or testnet (8200) first.");
+      return;
+    }
+    const next = input.trim();
+    if (!next) return;
+    setBusy(true);
+    setErr(null);
+    const history = [...turns];
+    // Optimistic user bubble so it appears immediately.
+    setTurns([...history, { role: "user", text: next }]);
+    setInput("");
+    try {
+      const system = "You are a concise assistant. Reply in one or two short sentences.";
+      const prompt = composePrompt(history, next, system);
+
+      setBusyStage("Sign in with your wallet (SIWE)...");
+      const session = await siweSignIn(walletClient as unknown as Parameters<typeof siweSignIn>[0], network);
+
+      setBusyStage("Approve the createSession transaction in your wallet...");
+      const gateway = new GatewayClient({ network, bearer: session.bearer });
+      const result = await runInference({
+        prompt,
+        gateway,
+        wallet: walletClient as unknown as Parameters<typeof runInference>[0]["wallet"],
+        publicClient: publicClient as unknown as Parameters<typeof runInference>[0]["publicClient"],
+        network: NETWORKS[network],
+        model: MODEL,
+        jobCompletedTimeoutMs: 120_000,
+        maxRetries: 1,
+      });
+
+      setTurns([...history, { role: "user", text: next }, {
+        role: "assistant",
+        text: result.answer,
+        worker: result.worker,
+        jobId: result.jobId?.toString() ?? null,
+        submitTx: result.txs?.submitJob ?? null,
+        jobCompletedTx: result.txs?.jobCompleted ?? null,
+      }]);
+    } catch (e) {
+      // Roll back the optimistic user bubble so the visitor can retry.
+      setTurns(history);
+      setInput(next);
+      const msg = (e as Error).message ?? "chat failed";
+      setErr(
+        /user rejected|user denied|reject/i.test(msg)
+          ? "You rejected the wallet popup. Try again."
+          : /insufficient funds|insufficient balance/i.test(msg)
+            ? \`Your wallet has no \${network === "mainnet" ? "LCAI" : "testnet LCAI"}. Top it up before sending.\`
+            : msg.split("\\n")[0],
+      );
+    } finally {
+      setBusy(false);
+      setBusyStage("");
+    }
+  }
+
+  return (
+    <main style={{ maxWidth: 720, margin: "32px auto", padding: 16, fontFamily: "system-ui" }}>
+      <h1>Chat (user-pays)</h1>
+      <p style={{ color: "#666" }}>
+        Each turn signs one createSession transaction from your wallet on{" "}
+        <code>{network ?? "(connect a wallet)"}</code>. Fee:{" "}
+        <code>{feeLcai != null ? \`\${feeLcai} LCAI\` : "(fetching)"}</code> per turn plus a small gas amount.
+      </p>
+      {!address && (
+        <div style={{ border: "1px solid #ddd", borderRadius: 8, padding: 12, margin: "12px 0" }}>
+          Connect a wallet to start chatting. (Use whichever connector your app exposes - e.g. RainbowKit,
+          ConnectKit, Reown AppKit, or wagmi&apos;s useConnect directly.)
+        </div>
+      )}
+
+      <div style={{ display: "flex", flexDirection: "column", gap: 8, margin: "16px 0" }}>
+        {turns.map((t, i) => (
+          <div
+            key={i}
+            style={{
+              alignSelf: t.role === "user" ? "flex-end" : "flex-start",
+              maxWidth: "85%",
+              borderRadius: 12,
+              padding: "8px 12px",
+              background: t.role === "user" ? "#e9e7ff" : "#f5f5f7",
+            }}
+          >
+            <div style={{ whiteSpace: "pre-wrap", wordBreak: "break-word" }}>{t.text}</div>
+            {t.role === "assistant" && t.submitTx ? (
+              <div style={{ marginTop: 6, fontSize: 11, color: "#666", display: "flex", gap: 8, flexWrap: "wrap" }}>
+                {t.worker && (
+                  <a href={\`https://\${network}.lightscan.app/address/\${t.worker}\`} target="_blank" rel="noopener noreferrer">
+                    worker
+                  </a>
+                )}
+                {t.jobId && <span>job #{t.jobId}</span>}
+                {t.submitTx && (
+                  <a href={\`https://\${network}.lightscan.app/tx/\${t.submitTx}\`} target="_blank" rel="noopener noreferrer">
+                    submitJob
+                  </a>
+                )}
+                {t.jobCompletedTx && (
+                  <a href={\`https://\${network}.lightscan.app/tx/\${t.jobCompletedTx}\`} target="_blank" rel="noopener noreferrer">
+                    completed
+                  </a>
+                )}
+              </div>
+            ) : null}
+          </div>
+        ))}
+      </div>
+
+      <textarea
+        value={input}
+        onChange={(e) => setInput(e.target.value)}
+        onKeyDown={(e) => {
+          if (e.key === "Enter" && (e.metaKey || e.ctrlKey)) { e.preventDefault(); if (!busy && input.trim()) send(); }
+        }}
+        rows={2}
+        placeholder={turns.length === 0 ? "Say hello (cmd+enter to send)" : "Reply..."}
+        style={{ width: "100%", padding: 8, fontFamily: "inherit" }}
+      />
+      <button
+        type="button"
+        onClick={() => send()}
+        disabled={busy || !input.trim() || !address || !network}
+        style={{ marginTop: 8, padding: "8px 16px" }}
+      >
+        {busy ? (busyStage || "Sending...") : (turns.length === 0 ? "Send first message" : "Send")}
+      </button>
+      {err && (
+        <p style={{ marginTop: 8, padding: "8px 12px", border: "1px solid #f5c2c7", background: "#f8d7da", color: "#842029", borderRadius: 6 }}>
+          {err}
+        </p>
+      )}
+    </main>
+  );
+}
+`;
 const NODE_CHAT_REPL = `// chat-repl.ts
 // Generated by 'lightnode add chat'. Interactive chat REPL in your terminal.
 //   npm install lightnode-sdk viem ws
@@ -1083,6 +1109,186 @@ export function addChat(opts = {}) {
     written.push(writeFile(path.join(cwd, ".env.example"), ENV_EXAMPLE(network), force));
     return { written, install: `npm install ${depsNeeded(template).join(" ")}`, template, network };
 }
+/**
+ * `lightnode add chat-web3` - the user-pays counterpart to addChat.
+ *
+ * Architecture:
+ *   - Each visitor's own wallet signs SIWE + createSession per turn.
+ *   - The dev's app holds zero funds; cost is borne by each user (0.02 LCAI
+ *     per llama3-8b turn on mainnet).
+ *   - No backend, no PRIVATE_KEY, no server-side hot wallet.
+ *
+ * Fit:
+ *   - Web3 dApps where users already have a wallet (NFT, meme coin, on-chain
+ *     games, LightChallenge-style challenge platforms).
+ *   - For SaaS chatbots where users do NOT have a wallet, use `add chat`
+ *     instead (dev pays, server-side route).
+ */
+export function addChatWeb3(opts = {}) {
+    const cwd = opts.cwd ?? process.cwd();
+    const network = opts.network ?? "mainnet";
+    // chat-web3 is browser-only. If the project is not Next.js (or another
+    // React framework we'd detect), fall back to nextjs-api anyway and warn
+    // the user in the CLI's next-steps that the file expects a Next.js
+    // setup with wagmi.
+    const detected = detectTemplate(cwd);
+    const template = opts.template && opts.template !== "auto" ? opts.template : detected;
+    const force = !!opts.force;
+    const written = [];
+    // Detect whether the project already has wagmi; if not, the next-steps
+    // output prints the install line.
+    const pkg = readPackageJson(cwd);
+    const deps = { ...(pkg?.dependencies ?? {}), ...(pkg?.devDependencies ?? {}) };
+    const hasWagmi = Boolean(deps["wagmi"]);
+    written.push(writeFile(path.join(cwd, "app/chat-web3/page.tsx"), NEXTJS_CHAT_WEB3_PAGE, force));
+    return {
+        written,
+        install: `npm install lightnode-sdk viem` + (hasWagmi ? "" : " wagmi @tanstack/react-query"),
+        template,
+        network,
+        needsWagmi: !hasWagmi,
+    };
+}
+const NEXTJS_JUDGE_ROUTE = `// app/api/judge/route.ts
+// Generated by 'lightnode add judge'. See https://lightnode.app/build
+// The LightChallenge-style evaluator: post evidence + criteria, get a
+// pass/fail verdict + confidence + reason, plus an on-chain receipt
+// (submitJob + jobCompleted tx) anyone can verify.
+import { NextResponse } from "next/server";
+import { runInferenceWithKey } from "lightnode-sdk";
+
+export const runtime = "nodejs";
+export const dynamic = "force-dynamic";
+export const maxDuration = 120;
+
+const NETWORK = (process.env.NETWORK ?? "testnet") as "mainnet" | "testnet";
+const MODEL = process.env.MODEL ?? "llama3-8b";
+
+interface JudgeRequest {
+  criteria: string;     // what the user has to satisfy
+  evidence: unknown;    // anything serialisable (the proof to grade)
+  // Optional: extend the rubric the model uses. Defaults to passed/confidence/reason.
+  schema?: string;
+}
+
+interface Verdict {
+  passed: boolean;
+  confidence: number;
+  reason: string;
+}
+
+const DEFAULT_SCHEMA = '{ "passed": boolean, "confidence": 0-1, "reason": string }';
+
+export async function POST(req: Request) {
+  if (!process.env.PRIVATE_KEY?.startsWith("0x")) {
+    return NextResponse.json({ error: "PRIVATE_KEY not configured" }, { status: 500 });
+  }
+  const body = (await req.json().catch(() => ({}))) as Partial<JudgeRequest>;
+  if (!body.criteria?.trim()) return NextResponse.json({ error: "criteria is required" }, { status: 400 });
+  if (body.evidence === undefined) return NextResponse.json({ error: "evidence is required" }, { status: 400 });
+
+  const schema = body.schema?.trim() || DEFAULT_SCHEMA;
+  const prompt = \`Criteria: \${body.criteria.trim()}
+
+Evidence: \${JSON.stringify(body.evidence)}
+
+Reply with STRICT JSON only, matching: \${schema}\`;
+
+  try {
+    const { answer, worker, txs, jobId } = await runInferenceWithKey({
+      network: NETWORK,
+      privateKey: process.env.PRIVATE_KEY as \`0x\${string}\`,
+      model: MODEL,
+      system: "You are a careful judge. Reply with STRICT JSON only, no prose.",
+      prompt,
+    });
+    // Parse the verdict defensively. If the model adds prose, extract the
+    // first {...} block. Surface the raw answer either way so callers can
+    // audit when the parser falls back.
+    let verdict: Verdict | null = null;
+    try {
+      verdict = JSON.parse(answer) as Verdict;
+    } catch {
+      const m = answer.match(/\{[\s\\S]*\}/);
+      if (m) {
+        try { verdict = JSON.parse(m[0]) as Verdict; } catch { /* keep null */ }
+      }
+    }
+    return NextResponse.json({
+      verdict,
+      raw: answer,
+      worker,
+      jobId: jobId.toString(),
+      txs: {
+        createSession: txs.createSession,
+        submitJob: txs.submitJob,
+        jobCompleted: txs.jobCompleted,
+      },
+    });
+  } catch (e) {
+    return NextResponse.json({ error: (e as Error).message }, { status: 500 });
+  }
+}
+`;
+const NODE_JUDGE_SCRIPT = `// judge.ts
+// Generated by 'lightnode add judge'. Run with: tsx judge.ts '<criteria>' '<evidence>'
+// Example:
+//   tsx judge.ts 'Run a mile under 8 minutes' '{"distance_km":1.61,"time_minutes":7.4}'
+import { runInferenceWithKey, LightNode } from "lightnode-sdk";
+
+const NETWORK = (process.env.NETWORK ?? "testnet") as "mainnet" | "testnet";
+const MODEL = process.env.MODEL ?? "llama3-8b";
+const PRIVATE_KEY = process.env.PRIVATE_KEY as \`0x\${string}\` | undefined;
+if (!PRIVATE_KEY) { console.error("PRIVATE_KEY not set. Put one in .env (testnet faucet: https://lightfaucet.ai)"); process.exit(1); }
+const KEY = PRIVATE_KEY as \`0x\${string}\`;
+
+const [criteria, evidenceJson] = process.argv.slice(2);
+if (!criteria || !evidenceJson) {
+  console.error("usage: tsx judge.ts '<criteria>' '<evidence-json>'");
+  process.exit(2);
+}
+const evidence = JSON.parse(evidenceJson);
+
+const ln = new LightNode(NETWORK);
+const { answer, worker, txs, jobId } = await runInferenceWithKey({
+  network: NETWORK,
+  privateKey: KEY,
+  model: MODEL,
+  system: "You are a careful judge. Reply with STRICT JSON only, no prose.",
+  prompt: \`Criteria: \${criteria}
+
+Evidence: \${JSON.stringify(evidence)}
+
+Reply with STRICT JSON only: { "passed": boolean, "confidence": 0-1, "reason": string }\`,
+});
+
+console.log("\\nraw answer  :", answer);
+let verdict: { passed: boolean; confidence: number; reason: string } | null = null;
+try { verdict = JSON.parse(answer); } catch {
+  const m = answer.match(/\\\{[\\\s\\S]*\\\}/);
+  if (m) { try { verdict = JSON.parse(m[0]); } catch { /* keep null */ } }
+}
+console.log("verdict     :", verdict);
+console.log("job id      :", jobId.toString());
+console.log("worker      :", worker);
+console.log("submitJob tx:", ln.explorerTxUrl(txs.submitJob));
+if (txs.jobCompleted) console.log("completed tx:", ln.explorerTxUrl(txs.jobCompleted));
+`;
+export function addJudge(opts = {}) {
+    const cwd = opts.cwd ?? process.cwd();
+    const network = opts.network ?? "testnet";
+    const template = opts.template && opts.template !== "auto" ? opts.template : detectTemplate(cwd);
+    const force = !!opts.force;
+    const written = [];
+    if (template === "nextjs-api") {
+        written.push(writeFile(path.join(cwd, "app/api/judge/route.ts"), NEXTJS_JUDGE_ROUTE, force));
+    }
+    else {
+        written.push(writeFile(path.join(cwd, "judge.ts"), NODE_JUDGE_SCRIPT, force));
+    }
+    written.push(writeFile(path.join(cwd, ".env.example"), ENV_EXAMPLE(network), force));
+    return { written, install: `npm install ${depsNeeded(template).join(" ")}`, template, network };
+}
 export function addNftMint(opts = {}) {
     const cwd = opts.cwd ?? process.cwd();
     const network = opts.network ?? "testnet";

package/dist/cli.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { LightNode, modelStatsCsv, workerStatsCsv, workerJobsCsv, runInferenceWithKey, runInferenceBatch, Agent, isStalledWorker, workerPreflight, workerWatch, WorkerOperator, isWorkerOpError, BRIDGE_ROUTE, DAO, DAO_ADDRESSES } from "./index.js";
-import { addInference, addAnalyticsDashboard, addNftMint, addChat, addAgent } from "./add.js";
+import { addInference, addAnalyticsDashboard, addNftMint, addChat, addChatWeb3, addAgent, addJudge } from "./add.js";
 import { createPublicClient, createWalletClient, http, parseEther } from "viem";
 import { privateKeyToAccount, generatePrivateKey } from "viem/accounts";
 function flag(name) {
@@ -462,7 +462,7 @@ async function main() {
             const template = flag("--template") ?? "auto";
             const force = process.argv.includes("--force");
             const network = (net === "mainnet" ? "mainnet" : "testnet");
-            const known = ["inference", "chat", "agent", "analytics-dashboard", "nft-mint-with-inference"];
+            const known = ["inference", "chat", "chat-web3", "agent", "judge", "analytics-dashboard", "nft-mint-with-inference"];
             if (!known.includes(sub ?? "")) {
                 die(`usage: lightnode add <${known.join("|")}> [--template auto|nextjs-api|hono|node] [--net testnet|mainnet] [--force]`);
             }
@@ -470,11 +470,15 @@ async function main() {
                 ? addAnalyticsDashboard({ template, network, force })
                 : sub === "nft-mint-with-inference"
                     ? addNftMint({ template, network, force })
-                    : sub === "chat"
-                        ? addChat({ template, network, force })
-                        : sub === "agent"
-                            ? addAgent({ template, network, force })
-                            : addInference({ template, network, force });
+                    : sub === "chat-web3"
+                        ? addChatWeb3({ template, network, force })
+                        : sub === "chat"
+                            ? addChat({ template, network, force })
+                            : sub === "agent"
+                                ? addAgent({ template, network, force })
+                                : sub === "judge"
+                                    ? addJudge({ template, network, force })
+                                    : addInference({ template, network, force });
             console.log(`▶ add ${sub} (${result.template} template, default network ${result.network})`);
             for (const f of result.written) {
                 if (f.skipped)
@@ -489,7 +493,25 @@ async function main() {
             else {
                 console.log(`\nNext steps (these files were added to your CURRENT folder, not a new project):`);
                 console.log(`  1. ${result.install}`);
-                if (sub === "nft-mint-with-inference" || sub === "inference" || sub === "chat" || sub === "agent") {
+                if (sub === "chat-web3") {
+                    // chat-web3 has no PRIVATE_KEY (each visitor pays their own way).
+                    const needsWagmi = result.needsWagmi;
+                    if (needsWagmi) {
+                        console.log(`  2. Set up wagmi in your app if you have not already.`);
+                        console.log(`     See https://wagmi.sh/react/getting-started - wrap your root layout with`);
+                        console.log(`     <WagmiProvider config={wagmiConfig}> and add a Connect button using`);
+                        console.log(`     useConnect / RainbowKit / Reown AppKit / ConnectKit, whatever you prefer.`);
+                        console.log(`  3. npm run dev, open /chat-web3`);
+                        console.log(`  4. Connect a wallet on LightChain ${result.network === "mainnet" ? "mainnet (chainId 9200)" : "testnet (chainId 8200)"}.`);
+                        console.log(`     Mainnet llama3-8b costs 0.02 LCAI per turn; testnet is free from https://lightfaucet.ai`);
+                    }
+                    else {
+                        console.log(`  2. npm run dev, open /chat-web3`);
+                        console.log(`  3. Connect a wallet on LightChain ${result.network === "mainnet" ? "mainnet (chainId 9200)" : "testnet (chainId 8200)"}.`);
+                        console.log(`     Mainnet llama3-8b costs 0.02 LCAI per turn; testnet is free from https://lightfaucet.ai`);
+                    }
+                }
+                else if (sub === "nft-mint-with-inference" || sub === "inference" || sub === "chat" || sub === "agent" || sub === "judge") {
                     console.log(`  2. cp .env.example .env  (and put a funded ${result.network} PRIVATE_KEY in it)`);
                     if (sub === "agent" && result.template === "nextjs-api") {
                         console.log(`  3. Set CRON_SECRET in your Vercel env vars + edit AGENT_TASK in .env`);
@@ -505,6 +527,14 @@ async function main() {
                     else if (sub === "chat") {
                         console.log(`  3. npx tsx chat-repl.ts  (interactive terminal chat)`);
                     }
+                    else if (sub === "judge" && result.template === "nextjs-api") {
+                        console.log(`  3. npm run dev`);
+                        console.log(`  4. curl -X POST localhost:3000/api/judge -H 'content-type: application/json' \\\\`);
+                        console.log(`         -d '{"criteria":"Run a mile under 8 minutes","evidence":{"time_minutes":7.4,"distance_km":1.61}}'`);
+                    }
+                    else if (sub === "judge") {
+                        console.log(`  3. npx tsx judge.ts 'Run a mile under 8 minutes' '{"time_minutes":7.4,"distance_km":1.61}'`);
+                    }
                     else if (sub === "nft-mint-with-inference" && result.template === "nextjs-api") {
                         console.log(`  3. Make sure /api/inference is mounted too (run: npx lightnode add inference)`);
                         console.log(`  4. npm run dev, open /nft-mint`);

package/dist/index.d.ts

@@ -134,7 +134,7 @@ export declare class LightNode {
  * (especially in registry-proxy environments like StackBlitz where lockfiles
  * may pin an older minor than the local install command suggests).
  */
-export declare const SDK_VERSION = "0.7.13";
+export declare const SDK_VERSION = "0.7.15";
 export { NETWORKS, WORKER_REGISTRY, REGISTRY_TOPICS, aggregateModelStats, aggregateWorkerStats, networkAnalytics, modelStatsCsv, workerStatsCsv, workerJobsCsv, fromWei, resolveJobTransactions, siweSignIn, siweChallenge, siweVerify, fetchWorkerModels, computeModelId as modelId, estimateJobFee, JOB_REGISTRY_CONSUMER_ABI, consumerGatewayUrl, consumerGatewayHost, GatewayClient, GatewayHttpError, prepareSession, submitPrompt, decryptResponse, generateEcdhKeyPair, crypto, runInference, runInferenceWithKey, runInferenceStream, Conversation, chat, runInferenceBatch, Agent, parseAgentOutput, workerPreflight, workerWatch, Bridge, BRIDGE_ROUTE, HYPERLANE_ROUTER_ABI, ERC20_ABI, addressToBytes32, quoteBridgeFee, bridgeableBalance, bridgeAllowance, approveBridge, bridgeTransfer, DAO, DAO_ADDRESSES, ProposalState, PROPOSAL_STATE_LABEL, VoteSupport, GOVERNOR_ABI, VOTES_ABI, OnchainModelRegistry, AIVM_MODEL_REGISTRY_ABI, BENCHMARK_REGISTRY_ABI, ModelStatus, MODEL_STATUS_LABEL, StalledWorkerError, OnChainRevertError, RelayTokenTimeoutError, GatewayAuthError, isStalledWorker, WorkerOperator, WORKER_REGISTRY_ABI, JOB_REGISTRY_OPERATOR_ABI, AI_CONFIG_ABI, JOB_STATE, decodeWorkerError, WorkerOpError, isWorkerOpError, };
 export type { BearerSource, GatewayClientOptions, SelectSessionResult, PrepareSessionResult, UploadBlobResult, SessionTokenResult } from "./gateway.js";
 export type { SessionPreparation, RunInferenceArgs, RunInferenceResult, RunInferenceWithKeyArgs, RunInferenceStreamResult } from "./inference.js";

package/dist/index.js

@@ -213,7 +213,7 @@ export class LightNode {
  * (especially in registry-proxy environments like StackBlitz where lockfiles
  * may pin an older minor than the local install command suggests).
  */
-export const SDK_VERSION = "0.7.13";
+export const SDK_VERSION = "0.7.15";
 export { NETWORKS, WORKER_REGISTRY, REGISTRY_TOPICS, aggregateModelStats, aggregateWorkerStats, networkAnalytics, modelStatsCsv, workerStatsCsv, workerJobsCsv, fromWei, 
 // v0.7.3 per-job transaction-hash resolver (lifts the upstream
 // subgraph's "block-only" Job entity to a deep-linkable Job + tx pair).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lightnode-sdk",
-  "version": "0.7.13",
+  "version": "0.7.15",
   "description": "Read-only TypeScript client for LightChain AI: workers, jobs, models, on-chain registration, and per-model network analytics. Independent, community-built (not an official LightChain package).",
   "type": "module",
   "main": "./dist/index.js",