lightnode-sdk 0.3.2 → 0.4.1

package/README.md

@@ -81,8 +81,12 @@ npx lightnode fee llama3-8b               # on-chain job fee
 npx lightnode analytics --csv             # per-model performance (CSV)
 npx lightnode reliability --csv           # per-worker reliability (CSV)
 
-# Scaffold inference into an existing project (auto-detects Next.js, Hono, or Node):
-npx lightnode add inference [--template auto|nextjs-api|hono|node] [--net testnet|mainnet] [--force]
+# Patch an existing project (auto-detects Next.js, Hono, or Node):
+npx lightnode add inference                    # encrypted inference route/script
+npx lightnode add chat                         # chat-style UI with conversation history
+npx lightnode add analytics-dashboard          # read-only network + worker analytics page
+npx lightnode add nft-mint-with-inference      # AI-generated NFT metadata with on-chain provenance
+# All `add` commands accept [--template auto|nextjs-api|hono|node] [--net testnet|mainnet] [--force]
 
 # Or scaffold a brand-new project:
 npm create lightnode-app my-app
@@ -90,6 +94,34 @@ npm create lightnode-app my-app
 
 ## Submitting inference
 
+**Easy mode (`runInference` — v0.4+):** one async call drives the whole protocol —
+SIWE → prepareSession → on-chain createSession → relay WS → encrypt + upload prompt
+→ on-chain submitJob → decrypt streamed chunks → wait for `JobCompleted` →
+return the assembled answer + three tx hashes. Built-in retry on `StalledWorkerError`.
+
+```ts
+import { LightNode, GatewayClient, runInference } from "lightnode-sdk";
+import WS from "ws"; // omit in the browser
+
+const ln = new LightNode("testnet");
+const gateway = new GatewayClient({ network: "testnet", bearer: await getJwt() });
+const { answer, txs } = await runInference({
+  prompt: "Reply with a one-sentence fun fact about the ocean.",
+  gateway, wallet, publicClient, network: ln.network,
+  WebSocket: WS,
+  onChunk: (chunk) => process.stdout.write(chunk), // live streaming
+  maxRetries: 2,                                    // auto-retry on stall
+});
+console.log("\n", txs); // { createSession, submitJob, jobCompleted }
+```
+
+The lower-level helpers (`prepareSession`, `submitPrompt`, `decryptResponse`,
+the typed errors `StalledWorkerError` / `OnChainRevertError` / `GatewayAuthError`
+/ `RelayTokenTimeoutError`) stay exported for builders who want a different
+retry policy or to reuse a session across prompts.
+
+### Manual mode (the full surface)
+
 `v0.3+` ships the encrypted inference-submit flow end to end. Wire-compatible with
 the reference client [`lcai-chat-v2`](https://github.com/lightchain-protocol/lcai-chat-v2)
 (same ECDH-P256 + AES-256-GCM, same gateway endpoints, same `JobRegistry` calls).

package/dist/add.d.ts

@@ -30,4 +30,28 @@ export declare function addInference(opts?: AddOpts): {
     template: Template;
     network: Network;
 };
+export declare function addAnalyticsDashboard(opts?: AddOpts): {
+    written: WrittenFile[];
+    install: string;
+    template: Template;
+    network: Network;
+};
+export declare function addAgent(opts?: AddOpts): {
+    written: WrittenFile[];
+    install: string;
+    template: Template;
+    network: Network;
+};
+export declare function addChat(opts?: AddOpts): {
+    written: WrittenFile[];
+    install: string;
+    template: Template;
+    network: Network;
+};
+export declare function addNftMint(opts?: AddOpts): {
+    written: WrittenFile[];
+    install: string;
+    template: Template;
+    network: Network;
+};
 export {};