lightnode-sdk 0.7.19 → 0.8.0

package/README.md

@@ -484,11 +484,15 @@ npx lightnode add judge-web3                    # evaluator UI, wallet-signed
 npx lightnode add wagmi-setup                   # wallet wiring: lib/wagmi + providers + connect button
 ```
 
-The `*-web3` scaffolders and `wagmi-setup` write Next.js pages, so run them
-inside a Next.js app (`npx create-next-app@latest .` first if you have none).
+The `*-web3` scaffolders are one command end to end: run in an empty folder and
+they scaffold a Next.js app, write the page with a wired Connect button, bundle
+the wagmi config + providers + connect button, wrap your layout with
+`<Providers>`, and `npm install` the deps. Run inside an existing Next.js app
+and they skip the scaffold and just add what's missing. Opt out of the
+automation with `--no-scaffold` and `--no-install`.
 
 All `add` commands accept `--template auto|nextjs-api|hono|node`,
-`--net testnet|mainnet`, and `--force`.
+`--net testnet|mainnet`, `--force`, `--no-install`, and `--no-scaffold`.
 
 > If `add <name>` reports an unknown target, your `npx` cache is serving an
 > older CLI. Force the current release: `npx lightnode-sdk@latest add <name>`.

package/dist/add.d.ts

@@ -109,6 +109,16 @@ export declare function addWagmiSetup(opts?: AddOpts): {
     template: Template;
     network: Network;
 };
+export interface LayoutPatch {
+    path: string;
+    patched: boolean;
+    reason?: string;
+}
+/**
+ * Patch the project's root layout to import and wrap children in <Providers>.
+ * Returns what happened so the CLI can report it; never throws.
+ */
+export declare function patchLayoutWithProviders(cwd?: string): LayoutPatch;
 export declare function addJudge(opts?: AddOpts): {
     written: WrittenFile[];
     install: string;

package/dist/add.js

@@ -321,6 +321,17 @@ function depsNeeded(template) {
     // installed too, otherwise `tsx ...` fails with "command not found".
     return ["lightnode-sdk", "viem", "ws", "tsx"];
 }
+/** Full `npm install` line for a template's next-steps, including the dev type
+ *  packages an editor needs. The node/script template uses Node builtins
+ *  (`node:process`, `node:readline`) and imports `ws`, so without @types/node
+ *  and @types/ws a freshly-scaffolded file is a wall of red squiggles in any
+ *  TypeScript-aware editor even though `tsx` runs it fine. */
+function installLine(template) {
+    const runtime = `npm install ${depsNeeded(template).join(" ")}`;
+    if (template === "node")
+        return `${runtime} && npm install -D @types/node @types/ws`;
+    return runtime;
+}
 /**
  * Implementation called by `lightnode add inference [...]`.
  * Returns the list of files written + the install command the user should run.
@@ -347,7 +358,7 @@ export function addInference(opts = {}) {
     written.push(writeFile(path.join(cwd, ".env.example"), ENV_EXAMPLE(network), force));
     return {
         written,
-        install: `npm install ${depsNeeded(template).join(" ")}`,
+        install: installLine(template),
         template,
         network,
     };
@@ -953,6 +964,7 @@ const NEXTJS_CHAT_WEB3_PAGE = `// app/chat-web3/page.tsx
 import { useEffect, useState } from "react";
 import { useAccount, useWalletClient, usePublicClient } from "wagmi";
 import { siweSignIn, GatewayClient, runInference, estimateJobFee, NETWORKS } from "lightnode-sdk";
+import { ConnectButton } from "@/components/connect-button";
 
 type Turn = {
   role: "user" | "assistant";
@@ -1063,16 +1075,19 @@ export default function ChatWeb3() {
 
   return (
     <main style={{ maxWidth: 720, margin: "32px auto", padding: 16, fontFamily: "system-ui" }}>
-      <h1>Chat (user-pays)</h1>
+      <div style={{ display: "flex", alignItems: "center", justifyContent: "space-between", gap: 12 }}>
+        <h1>Chat (user-pays)</h1>
+        <ConnectButton />
+      </div>
       <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 style={{ border: "1px solid #ddd", borderRadius: 8, padding: 12, margin: "12px 0", display: "flex", alignItems: "center", gap: 12 }}>
+          <span>Connect a wallet to start chatting.</span>
+          <ConnectButton />
         </div>
       )}
 
@@ -1155,6 +1170,7 @@ const NEXTJS_INFERENCE_WEB3_PAGE = `// app/inference-web3/page.tsx
 import { useEffect, useState } from "react";
 import { useAccount, useWalletClient, usePublicClient } from "wagmi";
 import { siweSignIn, GatewayClient, runInference, estimateJobFee, NETWORKS } from "lightnode-sdk";
+import { ConnectButton } from "@/components/connect-button";
 
 type Result = {
   answer: string;
@@ -1243,15 +1259,19 @@ export default function InferenceWeb3() {
 
   return (
     <main style={{ maxWidth: 720, margin: "32px auto", padding: 16, fontFamily: "system-ui" }}>
-      <h1>Inference (user-pays)</h1>
+      <div style={{ display: "flex", alignItems: "center", justifyContent: "space-between", gap: 12 }}>
+        <h1>Inference (user-pays)</h1>
+        <ConnectButton />
+      </div>
       <p style={{ color: "#666" }}>
         Signs one encrypted inference from your wallet on{" "}
         <code>{network ?? "(connect a wallet)"}</code>. Fee:{" "}
         <code>{feeLcai != null ? \`\${feeLcai} LCAI\` : "(fetching)"}</code> per call plus a small gas amount.
       </p>
       {!address && (
-        <div style={{ border: "1px solid #ddd", borderRadius: 8, padding: 12, margin: "12px 0" }}>
-          Connect a wallet to run inference. Drop &lt;ConnectButton /&gt; here or wherever your app exposes one.
+        <div style={{ border: "1px solid #ddd", borderRadius: 8, padding: 12, margin: "12px 0", display: "flex", alignItems: "center", gap: 12 }}>
+          <span>Connect a wallet to run inference.</span>
+          <ConnectButton />
         </div>
       )}
 
@@ -1310,6 +1330,7 @@ const NEXTJS_JUDGE_WEB3_PAGE = `// app/judge-web3/page.tsx
 import { useEffect, useState } from "react";
 import { useAccount, useWalletClient, usePublicClient } from "wagmi";
 import { siweSignIn, GatewayClient, runInference, estimateJobFee, NETWORKS } from "lightnode-sdk";
+import { ConnectButton } from "@/components/connect-button";
 
 type Verdict = {
   passed: boolean;
@@ -1423,15 +1444,19 @@ Reply with STRICT JSON only, matching: { "passed": boolean, "confidence": 0-1, "
 
   return (
     <main style={{ maxWidth: 720, margin: "32px auto", padding: 16, fontFamily: "system-ui" }}>
-      <h1>AI Judge (user-pays)</h1>
+      <div style={{ display: "flex", alignItems: "center", justifyContent: "space-between", gap: 12 }}>
+        <h1>AI Judge (user-pays)</h1>
+        <ConnectButton />
+      </div>
       <p style={{ color: "#666" }}>
         Each submission signs one inference from your wallet on{" "}
         <code>{network ?? "(connect a wallet)"}</code>. Cost:{" "}
         <code>{feeLcai != null ? \`\${feeLcai} LCAI\` : "(fetching)"}</code> plus gas. Verdict comes back with on-chain proof.
       </p>
       {!address && (
-        <div style={{ border: "1px solid #ddd", borderRadius: 8, padding: 12, margin: "12px 0" }}>
-          Connect a wallet to submit. Drop &lt;ConnectButton /&gt; here or wherever your app exposes one.
+        <div style={{ border: "1px solid #ddd", borderRadius: 8, padding: 12, margin: "12px 0", display: "flex", alignItems: "center", gap: 12 }}>
+          <span>Connect a wallet to submit.</span>
+          <ConnectButton />
         </div>
       )}
 
@@ -1708,7 +1733,7 @@ export function addAgent(opts = {}) {
         written.push(writeFile(path.join(cwd, "agent.ts"), NODE_AGENT_SCRIPT, force));
     }
     written.push(writeFile(path.join(cwd, ".env.example"), ENV_EXAMPLE(network), force));
-    return { written, install: `npm install ${depsNeeded(template).join(" ")}`, template, network };
+    return { written, install: installLine(template), template, network };
 }
 export function addChat(opts = {}) {
     const cwd = opts.cwd ?? process.cwd();
@@ -1732,7 +1757,7 @@ export function addChat(opts = {}) {
         written.push(writeFile(path.join(cwd, "chat-repl.ts"), NODE_CHAT_REPL, force));
     }
     written.push(writeFile(path.join(cwd, ".env.example"), ENV_EXAMPLE(network), force));
-    return { written, install: `npm install ${depsNeeded(template).join(" ")}`, template, network };
+    return { written, install: installLine(template), template, network };
 }
 /**
  * `lightnode add chat-web3` - the user-pays counterpart to addChat.
@@ -1972,6 +1997,67 @@ export function addWagmiSetup(opts = {}) {
         network,
     };
 }
+function findLayoutFile(cwd) {
+    const candidates = ["app/layout.tsx", "app/layout.jsx", "src/app/layout.tsx", "src/app/layout.jsx"];
+    for (const rel of candidates) {
+        const abs = path.join(cwd, rel);
+        if (fs.existsSync(abs))
+            return abs;
+    }
+    return null;
+}
+function withProvidersImport(source) {
+    if (/from\s+["']\.\/providers["']/.test(source))
+        return source;
+    const importLine = `import { Providers } from "./providers";`;
+    const lines = source.split("\n");
+    let lastImport = -1;
+    for (let i = 0; i < lines.length; i++) {
+        if (/^\s*import\s/.test(lines[i]))
+            lastImport = i;
+    }
+    if (lastImport === -1)
+        return `${importLine}\n${source}`;
+    return [...lines.slice(0, lastImport + 1), importLine, ...lines.slice(lastImport + 1)].join("\n");
+}
+function withWrappedChildren(source) {
+    if (/<Providers>/.test(source))
+        return source;
+    if (!source.includes("{children}"))
+        return null;
+    return source.replace("{children}", "<Providers>{children}</Providers>");
+}
+/**
+ * Patch the project's root layout to import and wrap children in <Providers>.
+ * Returns what happened so the CLI can report it; never throws.
+ */
+export function patchLayoutWithProviders(cwd = process.cwd()) {
+    const abs = findLayoutFile(cwd);
+    if (!abs)
+        return { path: "app/layout.tsx", patched: false, reason: "no layout file found" };
+    const rel = path.relative(cwd, abs) || abs;
+    let source;
+    try {
+        source = fs.readFileSync(abs, "utf8");
+    }
+    catch (e) {
+        return { path: rel, patched: false, reason: `could not read layout (${e.message})` };
+    }
+    if (/<Providers>/.test(source) && /from\s+["']\.\/providers["']/.test(source)) {
+        return { path: rel, patched: false, reason: "already wrapped with <Providers>" };
+    }
+    const wrapped = withWrappedChildren(withProvidersImport(source));
+    if (wrapped === null) {
+        return { path: rel, patched: false, reason: "no {children} found - wrap with <Providers> manually" };
+    }
+    try {
+        fs.writeFileSync(abs, wrapped);
+    }
+    catch (e) {
+        return { path: rel, patched: false, reason: `could not write layout (${e.message})` };
+    }
+    return { path: rel, patched: true };
+}
 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
@@ -2114,7 +2200,7 @@ export function addJudge(opts = {}) {
         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 };
+    return { written, install: installLine(template), template, network };
 }
 export function addNftMint(opts = {}) {
     const cwd = opts.cwd ?? process.cwd();
@@ -2132,7 +2218,7 @@ export function addNftMint(opts = {}) {
     written.push(writeFile(path.join(cwd, ".env.example"), ENV_EXAMPLE(network), force));
     return {
         written,
-        install: `npm install ${depsNeeded(template).join(" ")}`,
+        install: installLine(template),
         template,
         network,
     };

package/dist/cli.js

@@ -1,8 +1,11 @@
 #!/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, addInferenceWeb3, addJudgeWeb3, addAnalyticsDashboard, addNftMint, addChat, addChatWeb3, addAgent, addJudge, addWagmiSetup } from "./add.js";
+import { LightNode, modelStatsCsv, workerStatsCsv, workerJobsCsv, runInferenceWithKey, runInferenceBatch, Agent, isStalledWorker, workerPreflight, workerWatch, WorkerOperator, isWorkerOpError, BRIDGE_ROUTE, DAO, DAO_ADDRESSES, SDK_VERSION } from "./index.js";
+import { addInference, addInferenceWeb3, addJudgeWeb3, addAnalyticsDashboard, addNftMint, addChat, addChatWeb3, addAgent, addJudge, addWagmiSetup, patchLayoutWithProviders } from "./add.js";
 import { createPublicClient, createWalletClient, http, parseEther } from "viem";
 import { privateKeyToAccount, generatePrivateKey } from "viem/accounts";
+import { existsSync, readdirSync, renameSync, rmSync } from "node:fs";
+import { join } from "node:path";
+import { spawnSync } from "node:child_process";
 function flag(name) {
     const i = process.argv.indexOf(name);
     return i >= 0 ? process.argv[i + 1] : undefined;
@@ -17,6 +20,71 @@ function die(msg) {
 }
 const lcai = (wei) => (wei ? Number(BigInt(wei)) / 1e18 : 0);
 const rate = (r) => (r == null ? "-" : `${Math.round(r * 100)}%`);
+// `add` targets that are always a Next.js client page. In a bare folder these
+// get a real Next.js app scaffolded first so the generated page can render.
+const NEXT_PAGE_TARGETS = new Set(["chat-web3", "inference-web3", "judge-web3", "wagmi-setup"]);
+function printWritten(files) {
+    for (const f of files) {
+        if (f.skipped)
+            console.log(`  ⤴ ${f.path} (skipped - ${f.reason})`);
+        else
+            console.log(`  ✓ ${f.path}`);
+    }
+}
+/**
+ * Scaffold a Next.js app into cwd via create-next-app. Returns true on success.
+ *
+ * We scaffold into a fixed-name subfolder and move the files up rather than
+ * passing ".", because create-next-app derives the project name from the
+ * target and rejects names npm won't allow (capital letters, leading dots,
+ * etc.) - which would make this fail in any folder like "MyApp". The subfolder
+ * name is one we control, so that validation always passes.
+ */
+function scaffoldNextApp(cwd, target) {
+    console.log(`\nNo Next.js app here yet - scaffolding one with create-next-app...\n`);
+    const stageName = "lightnode-next-app-stage";
+    const args = [
+        "--yes", "create-next-app@latest", stageName,
+        "--ts", "--app", "--no-src-dir", "--eslint", "--tailwind",
+        "--use-npm", "--no-turbopack", "--import-alias", "@/*",
+    ];
+    const r = spawnSync("npx", args, { cwd, stdio: "inherit" });
+    if (r.status !== 0) {
+        console.error(`\ncreate-next-app did not complete (exit ${r.status ?? "?"}).`);
+        console.error(`If this folder already had files, scaffold manually then re-run:`);
+        console.error(`  npx create-next-app@latest .  &&  npx lightnode-sdk@latest add ${target}`);
+        return false;
+    }
+    return relocateScaffold(join(cwd, stageName), cwd, target);
+}
+/** Move every entry from the staged scaffold dir up into cwd, then remove it. */
+function relocateScaffold(from, cwd, target) {
+    try {
+        for (const entry of readdirSync(from)) {
+            const dest = join(cwd, entry);
+            if (existsSync(dest))
+                continue; // never clobber files the user already had
+            renameSync(join(from, entry), dest);
+        }
+        rmSync(from, { recursive: true, force: true });
+        return true;
+    }
+    catch (e) {
+        console.error(`\nScaffolded into ${from} but could not move it up (${e.message}).`);
+        console.error(`Move its contents into this folder, then re-run: npx lightnode-sdk@latest add ${target}`);
+        return false;
+    }
+}
+/** Run an `npm install ...` line in cwd. The line is an internal constant
+ *  (never user input), so running it through a shell is safe here. */
+function installDeps(installLine, cwd) {
+    console.log(`\nInstalling dependencies: ${installLine}\n`);
+    const r = spawnSync(installLine, { cwd, stdio: "inherit", shell: true });
+    if (r.status === 0)
+        return true;
+    console.error(`\nDependency install failed (exit ${r.status ?? "?"}). Run it yourself:\n  ${installLine}`);
+    return false;
+}
 const HELP = `lightnode <command> [--net mainnet|testnet]
 
 Run one inference (needs PRIVATE_KEY in env):
@@ -77,7 +145,12 @@ Scaffold templates into the current project (run inside a Next.js app):
     add wagmi-setup               wallet wiring: lib/wagmi + providers + connect button
                                   (all add commands: [--template auto|nextjs-api|hono|node] [--net testnet|mainnet] [--force])
 
-To scaffold a new project instead, run: npm create lightnode-app my-app`;
+To scaffold a new project instead, run: npm create lightnode-app my-app
+
+Diagnostics:
+  version                  print this CLI's version (also: --version, -v)
+                           (a missing 'add' target usually means an old install -
+                            update with: npm install -g lightnode-sdk@latest)`;
 function pickKey() {
     const k = flag("--key") ?? process.env.PRIVATE_KEY;
     if (!k || !k.startsWith("0x") || k.length !== 66) {
@@ -120,6 +193,14 @@ async function workerJobIds(n, address) {
     return jobs.map((j) => Number(j.id)).filter((x) => Number.isFinite(x));
 }
 async function main() {
+    // Answer `version` / `--version` / `-v` before anything else so a user who
+    // suspects they're on a stale binary can confirm it without a network call
+    // or a funded key. This is the first thing to check when an `add` target
+    // "doesn't exist" - an old global install is the common cause.
+    if (cmd === "version" || process.argv.includes("--version") || process.argv.includes("-v")) {
+        console.log(SDK_VERSION);
+        return;
+    }
     const ln = new LightNode(net);
     switch (cmd) {
         case "chat": {
@@ -474,16 +555,34 @@ async function main() {
                 const lines = [
                     `usage: lightnode add <${known.join("|")}> [--template auto|nextjs-api|hono|node] [--net testnet|mainnet] [--force]`,
                 ];
-                // If the requested name is valid in a newer release but missing here,
-                // the user is almost certainly running a stale npx-cached CLI. Point
-                // them at @latest rather than letting them think the command is gone.
+                // A target that's missing here but valid in a newer release means the
+                // user is running an OLD lightnode-sdk. The usual cause is an outdated
+                // GLOBAL install (`npm i -g lightnode-sdk`) on PATH, which npx prefers
+                // over the registry - so `npx lightnode-sdk add ...` keeps hitting the
+                // stale binary. We can't know the latest version offline, but we can
+                // show what THIS binary is and the two commands that fix it. Listing
+                // the global update first because that's the one most people miss.
                 if (sub) {
                     lines.push("");
-                    lines.push(`unknown add target "${sub}". If you expected this to work, you may be on an`);
-                    lines.push(`older cached CLI. Force the current version:  npx lightnode-sdk@latest add ${sub}`);
+                    lines.push(`unknown add target "${sub}" - this CLI is lightnode-sdk v${SDK_VERSION}, which`);
+                    lines.push(`does not have it. You're likely on an older install. Update, then retry:`);
+                    lines.push(`  npm install -g lightnode-sdk@latest     # if 'lightnode' is on your PATH`);
+                    lines.push(`  npx lightnode-sdk@latest add ${sub}   # or force the latest for one run`);
                 }
                 die(lines.join("\n"));
             }
+            // ---- one-command setup: flags + optional scaffold ----
+            const noInstall = process.argv.includes("--no-install");
+            const noScaffold = process.argv.includes("--no-scaffold");
+            const cwd = process.cwd();
+            const isWeb3Page = sub === "chat-web3" || sub === "inference-web3" || sub === "judge-web3";
+            // A Next.js client page needs a Next.js app to live in. In a bare folder,
+            // scaffold one first so the generated page renders instead of throwing
+            // "Cannot find module 'react'". Opt out with --no-scaffold.
+            if (NEXT_PAGE_TARGETS.has(sub ?? "") && !existsSync(join(cwd, "package.json")) && !noScaffold) {
+                scaffoldNextApp(cwd, sub ?? "");
+            }
+            // ---- write the requested files ----
             const result = sub === "analytics-dashboard" ? addAnalyticsDashboard({ template, network, force })
                 : sub === "nft-mint-with-inference" ? addNftMint({ template, network, force })
                     : sub === "chat-web3" ? addChatWeb3({ template, network, force })
@@ -495,61 +594,53 @@ async function main() {
                                             : 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)
-                    console.log(`  ⤴ ${f.path} (skipped - ${f.reason})`);
+            printWritten(result.written);
+            // ---- web3 pages: bundle the wagmi wiring + wrap the root layout so the
+            // page's <ConnectButton /> and wagmi hooks have a provider to resolve. ----
+            let layout = null;
+            if (isWeb3Page) {
+                const wagmi = addWagmiSetup({ template: result.template, network, force });
+                printWritten(wagmi.written);
+            }
+            if (isWeb3Page || sub === "wagmi-setup") {
+                layout = patchLayoutWithProviders(cwd);
+                if (layout.patched)
+                    console.log(`  ✓ ${layout.path} (wrapped children with <Providers>)`);
                 else
-                    console.log(`  ✓ ${f.path}`);
-            }
-            const anyWritten = result.written.some((f) => !f.skipped);
-            if (!anyWritten) {
-                console.log("\nNothing to do - all target files already exist. Pass --force to overwrite.");
-            }
-            else {
-                // The *-web3 pages and wagmi-setup are Next.js React files. If no
-                // Next.js app was detected (e.g. an empty folder), nothing can render
-                // what we just wrote - surface that before the numbered steps so the
-                // user scaffolds an app first instead of chasing a non-running page.
-                const isNextOnly = sub === "chat-web3" || sub === "inference-web3" || sub === "judge-web3" || sub === "wagmi-setup";
-                if (isNextOnly && result.template !== "nextjs-api") {
-                    console.log(`\nNo Next.js app detected in this folder. ${sub} is a Next.js page, so`);
-                    console.log(`create one here first, then re-run this command:`);
-                    console.log(`  npx create-next-app@latest .`);
+                    console.log(`  ⤴ ${layout.path} (${layout.reason})`);
+            }
+            // ---- install dependencies (opt out with --no-install) ----
+            const installed = noInstall ? false : installDeps(result.install, cwd);
+            // ---- next steps ----
+            const layoutNeedsManual = layout != null && !layout.patched && !/already/.test(layout.reason ?? "");
+            if (isWeb3Page) {
+                const route = sub === "chat-web3" ? "/chat-web3" : sub === "inference-web3" ? "/inference-web3" : "/judge-web3";
+                const chainId = result.network === "mainnet" ? "9200" : "8200";
+                console.log(`\n${installed ? "✓ Done - deps installed, wagmi + layout wired. Just run it:" : "Files written. Next:"}`);
+                if (!installed)
+                    console.log(`  ${result.install}`);
+                console.log(`  npm run dev`);
+                console.log(`  open http://localhost:3000${route}  and click Connect wallet (chainId ${chainId})`);
+                console.log(`  ${result.network === "mainnet" ? "llama3-8b costs 0.02 LCAI per call" : "testnet is free"}`);
+                if (layoutNeedsManual) {
+                    console.log(`\nHeads up: couldn't auto-wire the layout (${layout?.reason}).`);
+                    console.log(`Wrap {children} with <Providers> in app/layout.tsx (import from "./providers").`);
                 }
-                console.log(`\nNext steps (these files were added to your CURRENT folder, not a new project):`);
-                console.log(`  1. ${result.install}`);
-                if (sub === "wagmi-setup") {
-                    console.log(`  2. Import Providers in app/layout.tsx and wrap children:`);
-                    console.log(`     import { Providers } from "./providers";`);
-                    console.log(`     // <body><Providers>{children}</Providers></body>`);
-                    console.log(`  3. Drop <ConnectButton /> anywhere you want a connect UI:`);
-                    console.log(`     import { ConnectButton } from "@/components/connect-button";`);
-                    console.log(`  4. You can now use any wagmi hook (useAccount, useWalletClient, ...).`);
-                    console.log(`     Wallets on chains other than 9200/8200 will be prompted to switch.`);
+                console.log(`\n  No server-side route - deploy static (Vercel/Netlify/Cloudflare free tier all work).`);
+            }
+            else if (sub === "wagmi-setup") {
+                console.log(`\n${installed ? "✓ Done - deps installed and layout wired." : "Files written. Run: " + result.install}`);
+                console.log(`\nUse it: import { ConnectButton } from "@/components/connect-button"; drop <ConnectButton /> anywhere.`);
+                console.log(`Any wagmi hook (useAccount, useWalletClient, ...) now works app-wide. Off-network wallets get a switch prompt.`);
+                if (layoutNeedsManual) {
+                    console.log(`\nHeads up: couldn't auto-wire the layout (${layout?.reason}). Wrap {children} with <Providers> in app/layout.tsx.`);
                 }
-                else if (sub === "chat-web3" || sub === "inference-web3" || sub === "judge-web3") {
-                    // *-web3 variants have no PRIVATE_KEY (each visitor pays their own way).
-                    const needsWagmi = result.needsWagmi;
-                    const route = sub === "chat-web3" ? "/chat-web3"
-                        : sub === "inference-web3" ? "/inference-web3"
-                            : "/judge-web3";
-                    if (needsWagmi) {
-                        console.log(`  2. Get wagmi wired up with one command:`);
-                        console.log(`     npx lightnode add wagmi-setup`);
-                        console.log(`     (drops lib/wagmi.ts + app/providers.tsx + components/connect-button.tsx)`);
-                        console.log(`  3. Wrap your layout with <Providers> and drop <ConnectButton /> on the page.`);
-                        console.log(`  4. npm run dev, open ${route}, connect on chainId ${result.network === "mainnet" ? "9200" : "8200"}.`);
-                        console.log(`     Mainnet llama3-8b is 0.02 LCAI per call; testnet is free from https://lightfaucet.ai`);
-                    }
-                    else {
-                        console.log(`  2. npm run dev, open ${route}`);
-                        console.log(`  3. Connect a wallet on LightChain ${result.network === "mainnet" ? "mainnet (chainId 9200)" : "testnet (chainId 8200)"}.`);
-                        console.log(`     Mainnet llama3-8b is 0.02 LCAI per call; testnet is free from https://lightfaucet.ai`);
-                    }
-                    console.log(`\n  Note: ${sub} has NO server-side route, so it scales infinitely on`);
-                    console.log(`  static hosting (Vercel/Netlify/Cloudflare Pages free tier all work).`);
-                }
-                else if (sub === "nft-mint-with-inference" || sub === "inference" || sub === "chat" || sub === "agent" || sub === "judge") {
+            }
+            else {
+                // server-paid + read-only targets keep the detailed guidance.
+                console.log(`\nNext steps:`);
+                console.log(`  1. ${installed ? "(done) " : ""}${result.install}`);
+                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`);
@@ -607,8 +698,6 @@ async function main() {
                     }
                 }
                 // Hosting note: the Docker setup we shipped is the recommended path.
-                // The managed platforms (Vercel etc.) are the fallback if a builder is
-                // already committed to one.
                 if (result.template === "nextjs-api"
                     && (sub === "inference" || sub === "chat" || sub === "judge")) {
                     console.log(`\n  Hosting: a mainnet inference takes 60-90s. The Dockerfile + docker-compose.yml`);
@@ -617,13 +706,13 @@ async function main() {
                     console.log(`  Don't use Vercel Hobby (10s cap, every call times out). Vercel Pro works at`);
                     console.log(`  60s if you'd rather stay on Vercel. See LIGHTNODE-HOSTING.md for the full table.`);
                 }
-                if (result.network === "testnet") {
-                    console.log(`\nNo wallet yet? Make one:  npx lightnode wallet new   then fund it free below.`);
-                }
-                console.log(`\nFree testnet LCAI: https://lightfaucet.ai`);
-                console.log(`Builder docs:     https://lightnode.app/build`);
-                console.log(`New to all this?  See GETTING-STARTED.md in the lightnode repo.`);
             }
+            if (result.network === "testnet") {
+                console.log(`\nNo wallet yet? Make one:  npx lightnode wallet new   then fund it free below.`);
+            }
+            console.log(`\nFree testnet LCAI: https://lightfaucet.ai`);
+            console.log(`Builder docs:     https://lightnode.app/build`);
+            console.log(`New to all this?  See GETTING-STARTED.md in the lightnode repo.`);
             break;
         }
         case "batch": {

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.18";
+export declare const SDK_VERSION = "0.7.20";
 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.18";
+export const SDK_VERSION = "0.7.20";
 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.19",
+  "version": "0.8.0",
   "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",