lightnode-sdk 0.7.6 → 0.7.7

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.6";
+export declare const SDK_VERSION = "0.7.7";
 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.6";
+export const SDK_VERSION = "0.7.7";
 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/worker-operator.d.ts

@@ -210,9 +210,10 @@ export declare class WorkerOperator {
     readonly network: NetworkConfig;
     private readonly pub;
     private readonly wallet?;
-    private readonly addr;
+    private readonly maybeAddr;
     private cfgCache?;
     constructor(network: NetworkId | NetworkConfig, opts: WorkerOperatorOpts);
+    private get addr();
     private requireWallet;
     private get jobReg();
     private get workerReg();
@@ -282,6 +283,17 @@ export declare class WorkerOperator {
     withdraw(): Promise<`0x${string}`>;
     /** Deregister - releases stake to the wallet. Reverts (ActiveJobsExist) if any in-flight job remains. */
     deregister(): Promise<`0x${string}`>;
+    /**
+     * Add a supported model to THIS (already-registered) worker on-chain. Accepts a
+     * model tag (e.g. "gemma4:e2b") or a raw bytes32 modelId.
+     *
+     * This is the gas-correct version of the step the worker daemon's one-shot
+     * register botches: the daemon sends addSupportedModel with an under-set gas
+     * limit, so it OutOfGas-reverts (and its rollback deregister can too). viem
+     * estimates the gas here, so it lands. Use it to finish a worker that staked but
+     * failed to add its model. No-op (returns null) if already serving the model.
+     */
+    addModel(modelTagOrId: string): Promise<`0x${string}` | null>;
     /**
      * The flagship rescue: clear stuck jobs then release any settled completed jobs +
      * withdraw earnings then deregister. The one flow no official tool provides.

package/dist/worker-operator.js

@@ -287,9 +287,13 @@ export class WorkerOperator {
         const acct = opts.walletClient?.account;
         const fromWallet = typeof acct === "string" ? acct : acct?.address;
         const a = (opts.workerAddress ?? fromWallet);
-        if (!a)
-            throw new Error("WorkerOperator: provide workerAddress or a walletClient with an account");
-        this.addr = a.toLowerCase();
+        this.maybeAddr = a ? a.toLowerCase() : undefined;
+    }
+    get addr() {
+        if (!this.maybeAddr) {
+            throw new Error("WorkerOperator: this method needs the worker address. Pass `workerAddress` (or a `walletClient` with an account) when constructing WorkerOperator.");
+        }
+        return this.maybeAddr;
     }
     requireWallet(op) {
         if (!this.wallet)
@@ -525,6 +529,25 @@ export class WorkerOperator {
     async deregister() {
         return this.send("deregister", this.workerReg, WORKER_REGISTRY_ABI_PARSED, "deregisterWorker", []);
     }
+    /**
+     * Add a supported model to THIS (already-registered) worker on-chain. Accepts a
+     * model tag (e.g. "gemma4:e2b") or a raw bytes32 modelId.
+     *
+     * This is the gas-correct version of the step the worker daemon's one-shot
+     * register botches: the daemon sends addSupportedModel with an under-set gas
+     * limit, so it OutOfGas-reverts (and its rollback deregister can too). viem
+     * estimates the gas here, so it lands. Use it to finish a worker that staked but
+     * failed to add its model. No-op (returns null) if already serving the model.
+     */
+    async addModel(modelTagOrId) {
+        const id = modelTagOrId.startsWith("0x") && modelTagOrId.length === 66
+            ? modelTagOrId.toLowerCase()
+            : (await import("./inference.js")).modelId(modelTagOrId);
+        const already = (await this.read(this.workerReg, WORKER_REGISTRY_ABI_PARSED, "isEligible", [this.addr, id]));
+        if (already)
+            return null;
+        return this.send("addModel", this.workerReg, WORKER_REGISTRY_ABI_PARSED, "addSupportedModel", [id]);
+    }
     /**
      * The flagship rescue: clear stuck jobs then release any settled completed jobs +
      * withdraw earnings then deregister. The one flow no official tool provides.

package/package.json

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