lightnode-sdk 0.7.3 → 0.7.4

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { NETWORKS, WORKER_REGISTRY, REGISTRY_TOPICS } from "./networks.js";
-import { fromWei, resolveJobTransactions } from "./subgraph.js";
+import { fetchWorkerModels, fromWei, resolveJobTransactions } from "./subgraph.js";
 import { aggregateModelStats, aggregateWorkerStats, networkAnalytics, modelStatsCsv, workerStatsCsv, workerJobsCsv } from "./analytics.js";
 import { modelId as computeModelId, estimateJobFee, JOB_REGISTRY_CONSUMER_ABI, consumerGatewayUrl, consumerGatewayHost, prepareSession, submitPrompt, decryptResponse, generateEcdhKeyPair, runInference, runInferenceWithKey, runInferenceStream } from "./inference.js";
 import { Conversation, chat } from "./chat.js";
@@ -13,7 +13,7 @@ import { OnchainModelRegistry, AIVM_MODEL_REGISTRY_ABI, BENCHMARK_REGISTRY_ABI,
 import { StalledWorkerError, OnChainRevertError, RelayTokenTimeoutError, GatewayAuthError, isStalledWorker } from "./errors.js";
 import { GatewayClient, GatewayHttpError } from "./gateway.js";
 import * as crypto from "./crypto.js";
-import type { NetworkId, NetworkConfig, Worker, Job, JobTransactions, ModelInfo, NetworkStats, ModelStat, WorkerStat, NetworkAnalytics } from "./types.js";
+import type { NetworkId, NetworkConfig, Worker, Job, JobTransactions, ModelInfo, WorkerModel, NetworkStats, ModelStat, WorkerStat, NetworkAnalytics } from "./types.js";
 /**
  * Read-only client for a LightChain AI network. Pure reads from the public indexer
  * and the chain; no keys, no writes. Independent, community-built.
@@ -33,6 +33,15 @@ export declare class LightNode {
     getWorker(address: string): Promise<Worker | null>;
     /** Recent jobs for one worker, newest first. */
     getWorkerJobs(address: string, first?: number): Promise<Job[]>;
+    /**
+     * The on-chain model whitelist for one worker (rows from WorkerRegistry
+     * events). Use this when you need to answer "what models is this worker
+     * offering" - it is the authoritative signal, not derived from past jobs.
+     * Rows can be `is_active: false` (operator removed the registration) or
+     * outlive deregister: combine with {@link getWorker}.status to decide
+     * whether the worker is currently serving them.
+     */
+    getWorkerModels(address: string): Promise<WorkerModel[]>;
     /** The network's registered models (name, fee, output limit, whitelist flags). */
     getModels(): Promise<ModelInfo[]>;
     /** Registered workers (default top 200). */
@@ -113,8 +122,8 @@ 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.3";
-export { NETWORKS, WORKER_REGISTRY, REGISTRY_TOPICS, aggregateModelStats, aggregateWorkerStats, networkAnalytics, modelStatsCsv, workerStatsCsv, workerJobsCsv, fromWei, resolveJobTransactions, 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 declare const SDK_VERSION = "0.7.4";
+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";
 export type { ChatRole, ChatMessage, ConversationOptions, ConversationSendResult } from "./chat.js";
@@ -125,4 +134,4 @@ export type { BridgeChain, BridgeEndpoints, BridgeTransferArgs } from "./bridge.
 export type { DaoChain, DaoAddresses, ProposalSummary, ProposalRow, DaoConfig } from "./dao.js";
 export type { BaseModel, ModelVariant, AccessTier, AccessPolicy, Benchmark, OnchainModelRegistryOptions } from "./onchain-models.js";
 export type { MinimalWalletClient, MinimalPublicClient, WorkerOperatorOpts, WorkerProtocolConfig, WorkerStatus, DeregisterReadiness, StuckJob, EarningsBreakdown, OnchainJob, JobState, DecodedWorkerError, } from "./worker-operator.js";
-export type { NetworkId, NetworkConfig, Worker, Job, JobTransactions, ModelInfo, NetworkStats, ModelStat, WorkerStat, NetworkAnalytics };
+export type { NetworkId, NetworkConfig, Worker, Job, JobTransactions, ModelInfo, WorkerModel, NetworkStats, ModelStat, WorkerStat, NetworkAnalytics };

package/dist/index.js

@@ -1,5 +1,5 @@
 import { NETWORKS, WORKER_REGISTRY, REGISTRY_TOPICS } from "./networks.js";
-import { fetchWorker, fetchWorkerJobs, fetchRecentJobs, fetchJob, fetchModels, fetchWorkers, summarize, fromWei, resolveJobTransactions, } from "./subgraph.js";
+import { fetchWorker, fetchWorkerJobs, fetchWorkerModels, fetchRecentJobs, fetchJob, fetchModels, fetchWorkers, summarize, fromWei, resolveJobTransactions, } from "./subgraph.js";
 import { isRegistered } from "./onchain.js";
 import { aggregateModelStats, aggregateWorkerStats, networkAnalytics, modelStatsCsv, workerStatsCsv, workerJobsCsv, } from "./analytics.js";
 import { modelId as computeModelId, estimateJobFee, JOB_REGISTRY_CONSUMER_ABI, consumerGatewayUrl, consumerGatewayHost, prepareSession, submitPrompt, decryptResponse, generateEcdhKeyPair, runInference, runInferenceWithKey, runInferenceStream, } from "./inference.js";
@@ -40,6 +40,17 @@ export class LightNode {
     getWorkerJobs(address, first = 20) {
         return fetchWorkerJobs(this.network, address, first);
     }
+    /**
+     * The on-chain model whitelist for one worker (rows from WorkerRegistry
+     * events). Use this when you need to answer "what models is this worker
+     * offering" - it is the authoritative signal, not derived from past jobs.
+     * Rows can be `is_active: false` (operator removed the registration) or
+     * outlive deregister: combine with {@link getWorker}.status to decide
+     * whether the worker is currently serving them.
+     */
+    getWorkerModels(address) {
+        return fetchWorkerModels(this.network, address);
+    }
     /** The network's registered models (name, fee, output limit, whitelist flags). */
     getModels() {
         return fetchModels(this.network);
@@ -170,11 +181,14 @@ 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.3";
+export const SDK_VERSION = "0.7.4";
 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).
-resolveJobTransactions, computeModelId as modelId, estimateJobFee, JOB_REGISTRY_CONSUMER_ABI, consumerGatewayUrl, consumerGatewayHost, 
+resolveJobTransactions, 
+// v0.7.4 per-worker model-registration list (the authoritative "what is
+// this worker offering to serve" signal, not derived from past jobs).
+fetchWorkerModels, computeModelId as modelId, estimateJobFee, JOB_REGISTRY_CONSUMER_ABI, consumerGatewayUrl, consumerGatewayHost, 
 // v0.3 inference-submit surface (BETA - see README "Submitting inference").
 GatewayClient, GatewayHttpError, prepareSession, submitPrompt, decryptResponse, generateEcdhKeyPair, crypto, 
 // v0.4 high-level orchestrator: one call, full flow.

package/dist/subgraph.d.ts

@@ -1,5 +1,5 @@
 import type { PublicClient } from "viem";
-import type { NetworkConfig, Worker, Job, JobTransactions, ModelInfo, NetworkStats } from "./types.js";
+import type { NetworkConfig, Worker, Job, JobTransactions, ModelInfo, NetworkStats, WorkerModel } from "./types.js";
 /** Convert a wei string to a number of whole tokens (18 decimals). */
 export declare function fromWei(wei?: string): number;
 export declare function fetchWorker(cfg: NetworkConfig, address: string): Promise<Worker | null>;
@@ -28,6 +28,13 @@ export declare function resolveJobTransactions(cfg: NetworkConfig, jobId: string
     publicClient?: PublicClient;
     job?: Job | null;
 }): Promise<JobTransactions>;
+/**
+ * The on-chain model registrations for one worker. The Graph entity name is
+ * `workermodels` (lowercase), and `is_active` flips when the operator
+ * removes a registration. Independent of `Worker.status`: a deregistered
+ * worker can still have rows here from when it was live.
+ */
+export declare function fetchWorkerModels(cfg: NetworkConfig, address: string): Promise<WorkerModel[]>;
 export declare function fetchModels(cfg: NetworkConfig): Promise<ModelInfo[]>;
 export declare function fetchWorkers(cfg: NetworkConfig, first?: number): Promise<Worker[]>;
 export declare function summarize(workers: Worker[], models: ModelInfo[]): NetworkStats;

package/dist/subgraph.js

@@ -142,6 +142,16 @@ async function fetchTxHashForJobEvent(client, address, eventTopic, jobTopic, blo
         return null;
     }
 }
+/**
+ * The on-chain model registrations for one worker. The Graph entity name is
+ * `workermodels` (lowercase), and `is_active` flips when the operator
+ * removes a registration. Independent of `Worker.status`: a deregistered
+ * worker can still have rows here from when it was live.
+ */
+export async function fetchWorkerModels(cfg, address) {
+    const data = await gql(cfg.subgraph, `{ workermodels(where:{worker:"${checksum(address)}"}) { id worker model_id is_active created_at updated_at } }`);
+    return data.workermodels ?? [];
+}
 export async function fetchModels(cfg) {
     const data = await gql(cfg.subgraph, `{ modelinfos { id name fee max_output_tokens is_whitelisted is_enabled } }`);
     return data.modelinfos ?? [];

package/dist/types.d.ts

@@ -63,6 +63,21 @@ export interface ModelInfo {
     is_whitelisted: boolean;
     is_enabled: boolean;
 }
+/**
+ * Per-worker model registration row. The on-chain truth for "which models has
+ * this worker offered to serve" - indexed from WorkerRegistry events.
+ * `is_active` flips to false when the operator removes the registration; it
+ * is independent of whether the worker itself is currently registered in the
+ * protocol.
+ */
+export interface WorkerModel {
+    id: string;
+    worker: string;
+    model_id: string;
+    is_active: boolean;
+    created_at?: number;
+    updated_at?: number;
+}
 export interface NetworkStats {
     total: number;
     active: number;

package/package.json

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