lightnode-sdk 0.4.1 → 0.4.2

package/dist/inference.d.ts

@@ -159,7 +159,7 @@ export interface RunInferenceArgs {
     onChunk?: (chunk: string, totalSoFar: string) => void;
     /** Retry count if a worker stalls. Default 2 (so up to 3 paid attempts). */
     maxRetries?: number;
-    /** How long to wait for JobCompleted before declaring the worker stalled. Default 90s. */
+    /** How long to wait for JobCompleted before declaring the worker stalled. Default 120s. */
     jobCompletedTimeoutMs?: number;
     /**
      * WebSocket constructor. In a browser, omit and `globalThis.WebSocket` is
@@ -179,7 +179,12 @@ export interface RunInferenceResult {
     txs: {
         createSession: `0x${string}`;
         submitJob: `0x${string}`;
-        jobCompleted: `0x${string}`;
+        /**
+         * Worker's commit-result tx. Null if the on-chain event hasn't landed by the
+         * deadline but the WS-delivered, session-key-decrypted answer DID arrive -
+         * in that case the answer is still authentic; this is just the explorer link.
+         */
+        jobCompleted: `0x${string}` | null;
     };
     /** The dispatcher-assigned worker that produced this response. */
     worker: `0x${string}`;

package/dist/inference.js

@@ -190,7 +190,7 @@ function topicAsUint(hex) {
     return BigInt(hex);
 }
 async function runOneAttempt(args, attempt) {
-    const { prompt, gateway, wallet, publicClient, network, model = "llama3-8b", onChunk, jobCompletedTimeoutMs = 90000, } = args;
+    const { prompt, gateway, wallet, publicClient, network, model = "llama3-8b", onChunk, jobCompletedTimeoutMs = 120000, } = args;
     const WS = pickWebSocket(args.WebSocket);
     const relayUrl = args.relayUrl ?? `wss://relay.${network.id}.lightchain.ai/ws`;
     // 1. prepareSession
@@ -326,6 +326,11 @@ async function runOneAttempt(args, attempt) {
         throw new Error("JobSubmitted log missing in submitJob receipt");
     const jobId = topicAsUint(jobLog.topics[1]);
     // 6. wait for JobCompleted
+    // KEY INVARIANT: the real result is the WS-delivered, session-key-decrypted
+    // ciphertext. JobCompleted is an explorer pointer (the worker's commit-result
+    // tx). If the WS already produced an answer (chunks.length > 0) we MUST
+    // accept it even if the on-chain event hasn't landed - throwing stalled here
+    // wipes a delivered answer on retry, which reads as "the call returned nothing".
     const deadline = Date.now() + jobCompletedTimeoutMs;
     const jobIdTopic = (`0x${jobId.toString(16).padStart(64, "0")}`);
     let completed = null;
@@ -338,8 +343,14 @@ async function runOneAttempt(args, attempt) {
         });
         completed =
             logs.find((l) => l.topics[0] === JOB_COMPLETED_TOPIC && l.topics[1] === jobIdTopic) ?? null;
+        if (completed)
+            break;
+        // If the WS already delivered the answer, stop polling - no point burning
+        // more time on a confirmation that only serves as an explorer link.
+        if (chunks.length > 0)
+            break;
     }
-    if (!completed) {
+    if (!completed && chunks.length === 0) {
         try {
             ws.close();
         }
@@ -363,7 +374,11 @@ async function runOneAttempt(args, attempt) {
     }
     return {
         answer: chunks.join(""),
-        txs: { createSession: createTx, submitJob: submitTx, jobCompleted: completed.transactionHash },
+        // completed may be null when the answer arrived via the WS but JobCompleted
+        // hasn't landed on-chain yet. The decrypted answer is still authentic
+        // (session-key bound); callers can poll for the event later if they want
+        // the explorer-link form of the proof.
+        txs: { createSession: createTx, submitJob: submitTx, jobCompleted: completed?.transactionHash ?? null },
         worker: prepared.createSessionArgs.worker,
         sessionId,
         jobId,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lightnode-sdk",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "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",