lightnode-sdk 0.7.7 → 0.7.9

package/README.md

@@ -226,6 +226,15 @@ forever and **blocks deregistration** - and no official tool clears it. The
 JobRegistry's `claimTimeout` is permissionless, so the operator can self-clear
 it. `unstickAndDeregister()` is the one-call rescue.
 
+The second thing it gets right is **gas-correct writes**. The worker daemon
+under-sets the gas limit on its WorkerRegistry writes, so `addSupportedModel` and
+`deregisterWorker` run out of gas and revert on-chain - the daemon reports a
+failure (or, for deregister, some indexers still flip the worker to
+"deregistered" while the stake never moves). Every write here estimates the gas
+first and sends with a margin, so the transaction lands. `addModel()` is the
+gas-correct version of the model-add the daemon botches; `deregister()` is the
+gas-correct exit.
+
 ```ts
 import { WorkerOperator } from "lightnode-sdk";
 import { createPublicClient, createWalletClient, http } from "viem";
@@ -275,8 +284,9 @@ Full method reference (`jobIds` are the worker's IDs from
 | `withdraw()` | yes | pull the earned balance into the worker wallet |
 | `topUpStake(lcai)` | yes | add stake |
 | `withdrawStake(lcai)` | yes | remove stake above the floor |
+| `addModel(tagOrId)` | yes | add a supported model to a registered worker on-chain, gas-correct (no-op if already served) |
 | `reinstate()` | yes | reactivate a suspended worker |
-| `deregister()` | yes | exit and release stake (reverts if in-flight jobs remain) |
+| `deregister()` | yes | exit and release stake, gas-correct (reverts if in-flight jobs remain) |
 | `unstickAndDeregister(jobIds)` | yes | clear stuck + release + withdraw + deregister, in one call |
 
 > **Mainnet slashing.** `claimTimeout` / `clearStuck` / `unstickAndDeregister`
@@ -443,6 +453,8 @@ controls. Mainnet `clearstuck` and `deregister` realize a slash, so they require
 
 ```bash
                   npx lightnode worker status 0x...        # registration, stake, claimable, live config
+                  npx lightnode worker models 0x...        # models served, reconciled vs chain (servingNow truth)
+PRIVATE_KEY=0x... npx lightnode worker preflight           # one real test inference, print verdict + timings
 PRIVATE_KEY=0x... npx lightnode worker can-deregister      # what blocks the exit, before spending gas
 PRIVATE_KEY=0x... npx lightnode worker settle              # release completed jobs past their window + withdraw
 PRIVATE_KEY=0x... npx lightnode worker withdraw            # pull the earned balance into the worker wallet

package/dist/index.d.ts

@@ -133,7 +133,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.7";
+export declare const SDK_VERSION = "0.7.9";
 export { NETWORKS, WORKER_REGISTRY, REGISTRY_TOPICS, aggregateModelStats, aggregateWorkerStats, networkAnalytics, modelStatsCsv, workerStatsCsv, workerJobsCsv, fromWei, resolveJobTransactions, 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

@@ -212,7 +212,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.7";
+export const SDK_VERSION = "0.7.9";
 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/dist/inference.js

@@ -75,35 +75,66 @@ export const JOB_REGISTRY_CONSUMER_ABI = [
  */
 export async function prepareSession(gateway, modelTag) {
     const id = modelId(modelTag);
-    const selected = await gateway.selectSession(id);
-    const sessionKey = await generateSessionKey();
-    // Workers' pubkeys arrive as base64; disputer's as hex - decodePublicKey
-    // accepts either.
-    const workerPub = await importPublicKey(decodePublicKey(selected.workerEncryptionKey));
-    const encWorker = await encryptSessionKey(sessionKey, workerPub);
-    const encDisputer = selected.disputerEncryptionKey
-        ? await encryptSessionKey(sessionKey, await importPublicKey(decodePublicKey(selected.disputerEncryptionKey)))
-        : new Uint8Array(0);
-    // The gateway expects the wrapped keys as BASE64; the same bytes are passed
-    // as HEX to the on-chain createSession. Sending hex to the gateway makes the
-    // dispatcher reject the prepare with an opaque error.
-    const prepared = await gateway.prepareSession({
-        modelId: id,
-        encWorkerKey: bytesToBase64(encWorker),
-        encDisputerKey: bytesToBase64(encDisputer),
-    });
-    return {
-        sessionKey,
-        nonce: prepared.nonce,
-        createSessionArgs: {
-            paramsHash: id,
-            worker: prepared.worker,
-            encWorkerKey: bytesToHex(encWorker),
-            ephemeralPubKey: bytesToHex(encDisputer),
-            initState: prepared.signature,
-            expiry: BigInt(prepared.expiry),
-        },
+    // The gateway returns 409 selection_mismatch when a NEWER selectSession()
+    // for the same wallet supersedes ours between the select and the prepare.
+    // The error message is literally "re-run POST /api/sessions/select", so we
+    // do exactly that: rebuild from a fresh selection. Backoff spans several
+    // seconds because the gateway's selection TTL can be in that range - quick
+    // retries inside that window just hit the same stuck state. Random jitter
+    // keeps two concurrent callers from synchronising on identical schedules.
+    const MAX_ATTEMPTS = 6;
+    const BACKOFFS_MS = [0, 500, 1500, 4000, 9000, 18000];
+    const jitter = (ms) => ms + Math.floor(Math.random() * 250);
+    let lastErr = null;
+    const isSelectionMismatch = (e) => {
+        const msg = e instanceof Error ? e.message : String(e);
+        return /selection_mismatch|selection was superseded|409/.test(msg);
     };
+    for (let attempt = 0; attempt < MAX_ATTEMPTS; attempt++) {
+        if (attempt > 0)
+            await new Promise((r) => setTimeout(r, jitter(BACKOFFS_MS[attempt])));
+        try {
+            // Wrap BOTH gateway calls. selectSession itself can 409 if a newer
+            // call has already superseded ours by the time the gateway processes
+            // it. prepareSession 409s when the same happens between select and
+            // prepare. The whole select -> prepare flow is one atomic unit.
+            const selected = await gateway.selectSession(id);
+            const sessionKey = await generateSessionKey();
+            // Workers' pubkeys arrive as base64; disputer's as hex - decodePublicKey
+            // accepts either.
+            const workerPub = await importPublicKey(decodePublicKey(selected.workerEncryptionKey));
+            const encWorker = await encryptSessionKey(sessionKey, workerPub);
+            const encDisputer = selected.disputerEncryptionKey
+                ? await encryptSessionKey(sessionKey, await importPublicKey(decodePublicKey(selected.disputerEncryptionKey)))
+                : new Uint8Array(0);
+            const prepared = await gateway.prepareSession({
+                modelId: id,
+                encWorkerKey: bytesToBase64(encWorker),
+                encDisputerKey: bytesToBase64(encDisputer),
+            });
+            return {
+                sessionKey,
+                nonce: prepared.nonce,
+                createSessionArgs: {
+                    paramsHash: id,
+                    worker: prepared.worker,
+                    encWorkerKey: bytesToHex(encWorker),
+                    ephemeralPubKey: bytesToHex(encDisputer),
+                    initState: prepared.signature,
+                    expiry: BigInt(prepared.expiry),
+                },
+            };
+        }
+        catch (e) {
+            lastErr = e;
+            if (!isSelectionMismatch(e))
+                throw e;
+            // else loop: a newer select stole this session, try again from select.
+        }
+    }
+    throw lastErr instanceof Error
+        ? lastErr
+        : new Error("prepareSession: gateway selection_mismatch did not clear");
 }
 /**
  * Encrypt a UTF-8 prompt with the session key, upload as a blob, and return

package/package.json

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