lightnode-sdk 0.4.6 → 0.4.8

package/dist/crypto.d.ts

@@ -5,43 +5,50 @@
  * The format here MUST match the workers' Go implementation byte for byte,
  * which is what the `lcai-chat-v2` reference client also targets:
  *   - ECDH P-256 key exchange.
- *   - Raw shared secret used DIRECTLY as the AES-256 key (no HKDF).
+ *   - Raw shared secret X coordinate used DIRECTLY as the AES-256 key (no HKDF).
  *   - AES-GCM ciphertext layout: nonce(12) || ciphertext || tag(16).
  *   - Encrypted session key layout: ephemeralPub(65) || nonce(12) || ciphertext || tag(16).
  *
- * Uses the Web Crypto API. Tries `globalThis.crypto` first (real browsers +
- * Node 19+ where it is global), then falls back to `node:crypto`'s
- * `webcrypto` export (Node 18 and StackBlitz's WebContainer, which exposes
- * the node: module but not the global). No hard dependency on Node, and no
- * polyfill in the browser bundle.
+ * Implementation note: this module used to be built on Web Crypto (subtle.*).
+ * That broke in environments where the runtime has a partial Web Crypto
+ * implementation - notably StackBlitz / Bolt WebContainer, where
+ * subtle.generateKey({name:"ECDH",namedCurve:"P-256"}) throws "Unsupported".
+ * The flow is now backed by @noble/curves (P-256) and @noble/ciphers (AES-GCM)
+ * which are pure-JS and identical across every runtime. The only Web Crypto
+ * surface left is getRandomValues, which is reliable everywhere (when missing
+ * we fall back to node:crypto).
  */
+export interface EcdhKeyPair {
+    privateKey: Uint8Array;
+    publicKey: Uint8Array;
+}
 /** A fresh 32-byte symmetric session key (random, never derived). */
 export declare function generateSessionKey(): Promise<Uint8Array>;
-/** Fresh ECDH P-256 keypair (extractable; we need to export the public key on the wire). */
-export declare function generateEcdhKeyPair(): Promise<CryptoKeyPair>;
-/** Export an ECDH public key to its raw uncompressed P-256 encoding (65 bytes). */
-export declare function exportPublicKey(key: CryptoKey): Promise<Uint8Array>;
-/** Import a raw uncompressed P-256 public key (65 bytes) into a CryptoKey. */
-export declare function importPublicKey(raw: Uint8Array): Promise<CryptoKey>;
+/** Fresh ECDH P-256 keypair (32-byte private scalar, 65-byte uncompressed pub). */
+export declare function generateEcdhKeyPair(): Promise<EcdhKeyPair>;
+/** Identity passthrough kept for API back-compat. Public keys are already raw bytes. */
+export declare function exportPublicKey(key: Uint8Array): Uint8Array;
+/** Validate that raw is a well-formed uncompressed P-256 public key (65 bytes). */
+export declare function importPublicKey(raw: Uint8Array): Uint8Array;
 /**
- * Derive a 32-byte shared secret from a local ECDH private key and a remote
- * public key. Returns the raw x-coordinate; deliberately no HKDF, matching the
+ * Derive a 32-byte shared secret (X coordinate of the shared point) from a
+ * local ECDH private key and a remote public key. No HKDF, matching the
  * protocol's `priv.ECDH(remotePub)` output exactly.
  */
-export declare function deriveSharedSecret(privateKey: CryptoKey, remotePublicKey: CryptoKey): Promise<Uint8Array>;
+export declare function deriveSharedSecret(privateKey: Uint8Array, remotePublicKey: Uint8Array): Uint8Array;
 /** Encrypt with AES-256-GCM. Output: nonce(12) || ciphertext || tag(16). */
 export declare function encrypt(key: Uint8Array, plaintext: Uint8Array): Promise<Uint8Array>;
 /** Decrypt AES-256-GCM. Input: nonce(12) || ciphertext || tag(16). */
 export declare function decrypt(key: Uint8Array, ciphertext: Uint8Array): Promise<Uint8Array>;
 /**
- * Wrap (encrypt) a 32-byte session key for delivery to a remote party (e.g. the
- * worker), using a fresh ephemeral ECDH keypair.
+ * Wrap (encrypt) a 32-byte session key for delivery to a remote party
+ * (e.g. the worker), using a fresh ephemeral ECDH keypair.
  *
  * Output: ephemeralPub(65) || nonce(12) || AES-GCM(sharedSecret, sessionKey)
  */
-export declare function encryptSessionKey(sessionKey: Uint8Array, remotePublicKey: CryptoKey): Promise<Uint8Array>;
+export declare function encryptSessionKey(sessionKey: Uint8Array, remotePublicKey: Uint8Array): Promise<Uint8Array>;
 /** Unwrap a session key encrypted by `encryptSessionKey` using the local ECDH private key. */
-export declare function decryptSessionKey(encWorkerKey: Uint8Array, privateKey: CryptoKey): Promise<Uint8Array>;
+export declare function decryptSessionKey(encWorkerKey: Uint8Array, privateKey: Uint8Array): Promise<Uint8Array>;
 export declare function utf8ToBytes(s: string): Uint8Array;
 export declare function bytesToUtf8(b: Uint8Array): string;
 export declare function bytesToHex(b: Uint8Array): `0x${string}`;

package/dist/crypto.js

@@ -5,100 +5,119 @@
  * The format here MUST match the workers' Go implementation byte for byte,
  * which is what the `lcai-chat-v2` reference client also targets:
  *   - ECDH P-256 key exchange.
- *   - Raw shared secret used DIRECTLY as the AES-256 key (no HKDF).
+ *   - Raw shared secret X coordinate used DIRECTLY as the AES-256 key (no HKDF).
  *   - AES-GCM ciphertext layout: nonce(12) || ciphertext || tag(16).
  *   - Encrypted session key layout: ephemeralPub(65) || nonce(12) || ciphertext || tag(16).
  *
- * Uses the Web Crypto API. Tries `globalThis.crypto` first (real browsers +
- * Node 19+ where it is global), then falls back to `node:crypto`'s
- * `webcrypto` export (Node 18 and StackBlitz's WebContainer, which exposes
- * the node: module but not the global). No hard dependency on Node, and no
- * polyfill in the browser bundle.
+ * Implementation note: this module used to be built on Web Crypto (subtle.*).
+ * That broke in environments where the runtime has a partial Web Crypto
+ * implementation - notably StackBlitz / Bolt WebContainer, where
+ * subtle.generateKey({name:"ECDH",namedCurve:"P-256"}) throws "Unsupported".
+ * The flow is now backed by @noble/curves (P-256) and @noble/ciphers (AES-GCM)
+ * which are pure-JS and identical across every runtime. The only Web Crypto
+ * surface left is getRandomValues, which is reliable everywhere (when missing
+ * we fall back to node:crypto).
  */
+import { p256 } from "@noble/curves/p256";
+import { gcm } from "@noble/ciphers/aes";
 const AES_KEY_BYTES = 32;
 const GCM_NONCE_BYTES = 12;
-const P256_UNCOMPRESSED_KEY_BYTES = 65;
+const GCM_TAG_BYTES = 16;
+const P256_UNCOMPRESSED_KEY_BYTES = 65; // 0x04 || X(32) || Y(32)
 const SESSION_KEY_BYTES = 32;
-let resolvedCrypto = null;
-let resolvingCrypto = null;
-async function getCrypto() {
-    if (resolvedCrypto)
-        return resolvedCrypto;
-    if (resolvingCrypto)
-        return resolvingCrypto;
-    resolvingCrypto = (async () => {
+// Random source: try globalThis.crypto.getRandomValues (every modern browser
+// and Node 19+ global), fall back to node:crypto.webcrypto.getRandomValues
+// (Node 18, WebContainer). All algorithm-side crypto is pure JS, so this is
+// the only Web-Crypto-flavored thing the SDK still needs.
+let resolvedRng = null;
+let resolvingRng = null;
+async function getRng() {
+    if (resolvedRng)
+        return resolvedRng;
+    if (resolvingRng)
+        return resolvingRng;
+    resolvingRng = (async () => {
         const g = globalThis.crypto;
-        if (g?.subtle && typeof g.getRandomValues === "function") {
-            const provider = { subtle: g.subtle, getRandomValues: g.getRandomValues.bind(g) };
-            resolvedCrypto = provider;
-            return provider;
+        if (g && typeof g.getRandomValues === "function") {
+            const bound = g.getRandomValues.bind(g);
+            resolvedRng = bound;
+            return bound;
         }
-        // Node 18 + StackBlitz WebContainer: globalThis.crypto is missing, but
-        // `node:crypto` exposes the same Web Crypto API via `webcrypto`.
         try {
             const mod = (await import("node:crypto"));
             const wc = mod.webcrypto;
-            if (wc?.subtle && typeof wc.getRandomValues === "function") {
-                const provider = { subtle: wc.subtle, getRandomValues: wc.getRandomValues.bind(wc) };
-                resolvedCrypto = provider;
-                return provider;
+            if (wc && typeof wc.getRandomValues === "function") {
+                const bound = wc.getRandomValues.bind(wc);
+                resolvedRng = bound;
+                return bound;
             }
         }
         catch {
-            // node:crypto not importable - we're in a browser bundle without a
-            // global crypto. The fall-through error below explains the fix.
+            // browser bundle without a global crypto - fall through to the throw
         }
-        throw new Error("Web Crypto unavailable: globalThis.crypto is missing and node:crypto could not be loaded. " +
-            "The SDK requires Node 18+ or a modern browser.");
+        throw new Error("Secure random source unavailable: neither globalThis.crypto.getRandomValues nor " +
+            "node:crypto.webcrypto.getRandomValues was found. Requires Node 18+ or a modern browser.");
     })();
     try {
-        return await resolvingCrypto;
+        return await resolvingRng;
     }
     finally {
-        resolvingCrypto = null;
+        resolvingRng = null;
     }
 }
-async function subtle() {
-    return (await getCrypto()).subtle;
-}
 async function randomBytes(n) {
     const buf = new Uint8Array(n);
-    (await getCrypto()).getRandomValues(buf);
+    (await getRng())(buf);
     return buf;
 }
 /** A fresh 32-byte symmetric session key (random, never derived). */
 export function generateSessionKey() {
     return randomBytes(SESSION_KEY_BYTES);
 }
-/** Fresh ECDH P-256 keypair (extractable; we need to export the public key on the wire). */
+/** Fresh ECDH P-256 keypair (32-byte private scalar, 65-byte uncompressed pub). */
 export async function generateEcdhKeyPair() {
-    return (await subtle()).generateKey({ name: "ECDH", namedCurve: "P-256" }, true, ["deriveBits"]);
-}
-/** Export an ECDH public key to its raw uncompressed P-256 encoding (65 bytes). */
-export async function exportPublicKey(key) {
-    return new Uint8Array(await (await subtle()).exportKey("raw", key));
-}
-/** Import a raw uncompressed P-256 public key (65 bytes) into a CryptoKey. */
-export async function importPublicKey(raw) {
-    return (await subtle()).importKey("raw", raw, { name: "ECDH", namedCurve: "P-256" }, true, []);
+    // Use our RNG (proven available) instead of noble's, so a missing
+    // globalThis.crypto fails loudly at one site rather than in noble's internals.
+    const privateKey = await randomBytes(32);
+    // P-256 private scalars must be < n; the chance of collision is astronomically
+    // small, but noble validates this when we call getPublicKey, so any bad draw
+    // throws (and we'd just retry - but it has never been hit in practice).
+    const publicKey = p256.getPublicKey(privateKey, false);
+    return { privateKey, publicKey };
+}
+/** Identity passthrough kept for API back-compat. Public keys are already raw bytes. */
+export function exportPublicKey(key) {
+    return key;
+}
+/** Validate that raw is a well-formed uncompressed P-256 public key (65 bytes). */
+export function importPublicKey(raw) {
+    if (raw.length !== P256_UNCOMPRESSED_KEY_BYTES || raw[0] !== 0x04) {
+        throw new Error(`expected uncompressed P-256 public key (${P256_UNCOMPRESSED_KEY_BYTES} bytes, leading 0x04)`);
+    }
+    // Round-trip through noble to confirm the point is on the curve. Throws if not.
+    p256.ProjectivePoint.fromHex(raw);
+    return raw;
 }
 /**
- * Derive a 32-byte shared secret from a local ECDH private key and a remote
- * public key. Returns the raw x-coordinate; deliberately no HKDF, matching the
+ * Derive a 32-byte shared secret (X coordinate of the shared point) from a
+ * local ECDH private key and a remote public key. No HKDF, matching the
  * protocol's `priv.ECDH(remotePub)` output exactly.
  */
-export async function deriveSharedSecret(privateKey, remotePublicKey) {
-    return new Uint8Array(await (await subtle()).deriveBits({ name: "ECDH", public: remotePublicKey }, privateKey, 256));
+export function deriveSharedSecret(privateKey, remotePublicKey) {
+    // noble returns 65 bytes uncompressed (0x04 || X || Y) when isCompressed=false.
+    // The protocol's shared secret is just X.
+    const sharedPoint = p256.getSharedSecret(privateKey, remotePublicKey, false);
+    return sharedPoint.slice(1, 1 + AES_KEY_BYTES);
 }
 /** Encrypt with AES-256-GCM. Output: nonce(12) || ciphertext || tag(16). */
 export async function encrypt(key, plaintext) {
     if (key.length !== AES_KEY_BYTES)
         throw new Error(`AES key must be ${AES_KEY_BYTES} bytes`);
-    const s = await subtle();
-    const aesKey = await s.importKey("raw", key, "AES-GCM", false, ["encrypt"]);
     const nonce = await randomBytes(GCM_NONCE_BYTES);
-    const ctPlusTag = new Uint8Array(await s.encrypt({ name: "AES-GCM", iv: nonce }, aesKey, plaintext));
-    const out = new Uint8Array(GCM_NONCE_BYTES + ctPlusTag.byteLength);
+    // noble's gcm returns plaintext.length + 16 (tag appended). Layout in our
+    // wire format is nonce || ct+tag.
+    const ctPlusTag = gcm(key, nonce).encrypt(plaintext);
+    const out = new Uint8Array(GCM_NONCE_BYTES + ctPlusTag.length);
     out.set(nonce, 0);
     out.set(ctPlusTag, GCM_NONCE_BYTES);
     return out;
@@ -107,17 +126,15 @@ export async function encrypt(key, plaintext) {
 export async function decrypt(key, ciphertext) {
     if (key.length !== AES_KEY_BYTES)
         throw new Error(`AES key must be ${AES_KEY_BYTES} bytes`);
-    if (ciphertext.length < GCM_NONCE_BYTES + 16)
+    if (ciphertext.length < GCM_NONCE_BYTES + GCM_TAG_BYTES)
         throw new Error("ciphertext too short");
-    const s = await subtle();
-    const aesKey = await s.importKey("raw", key, "AES-GCM", false, ["decrypt"]);
     const nonce = ciphertext.slice(0, GCM_NONCE_BYTES);
     const body = ciphertext.slice(GCM_NONCE_BYTES);
-    return new Uint8Array(await s.decrypt({ name: "AES-GCM", iv: nonce }, aesKey, body));
+    return gcm(key, nonce).decrypt(body);
 }
 /**
- * Wrap (encrypt) a 32-byte session key for delivery to a remote party (e.g. the
- * worker), using a fresh ephemeral ECDH keypair.
+ * Wrap (encrypt) a 32-byte session key for delivery to a remote party
+ * (e.g. the worker), using a fresh ephemeral ECDH keypair.
  *
  * Output: ephemeralPub(65) || nonce(12) || AES-GCM(sharedSecret, sessionKey)
  */
@@ -125,22 +142,21 @@ export async function encryptSessionKey(sessionKey, remotePublicKey) {
     if (sessionKey.length !== SESSION_KEY_BYTES)
         throw new Error(`session key must be ${SESSION_KEY_BYTES} bytes`);
     const ephemeral = await generateEcdhKeyPair();
-    const shared = await deriveSharedSecret(ephemeral.privateKey, remotePublicKey);
+    const shared = deriveSharedSecret(ephemeral.privateKey, remotePublicKey);
     const ct = await encrypt(shared, sessionKey);
-    const pub = await exportPublicKey(ephemeral.publicKey);
-    const out = new Uint8Array(pub.length + ct.length);
-    out.set(pub, 0);
-    out.set(ct, pub.length);
+    const out = new Uint8Array(ephemeral.publicKey.length + ct.length);
+    out.set(ephemeral.publicKey, 0);
+    out.set(ct, ephemeral.publicKey.length);
     return out;
 }
 /** Unwrap a session key encrypted by `encryptSessionKey` using the local ECDH private key. */
 export async function decryptSessionKey(encWorkerKey, privateKey) {
-    if (encWorkerKey.length < P256_UNCOMPRESSED_KEY_BYTES + GCM_NONCE_BYTES + 16) {
+    if (encWorkerKey.length < P256_UNCOMPRESSED_KEY_BYTES + GCM_NONCE_BYTES + GCM_TAG_BYTES) {
         throw new Error("encrypted session key too short");
     }
-    const ephemeralPub = await importPublicKey(encWorkerKey.slice(0, P256_UNCOMPRESSED_KEY_BYTES));
+    const ephemeralPub = importPublicKey(encWorkerKey.slice(0, P256_UNCOMPRESSED_KEY_BYTES));
     const ct = encWorkerKey.slice(P256_UNCOMPRESSED_KEY_BYTES);
-    const shared = await deriveSharedSecret(privateKey, ephemeralPub);
+    const shared = deriveSharedSecret(privateKey, ephemeralPub);
     const sk = await decrypt(shared, ct);
     if (sk.length !== SESSION_KEY_BYTES)
         throw new Error(`session key must be ${SESSION_KEY_BYTES} bytes`);

package/dist/index.d.ts

@@ -60,6 +60,13 @@ export declare class LightNode {
         baseUrl?: string;
     }): GatewayClient;
 }
+/**
+ * Build-time SDK version. Useful for diagnostic prints in examples and apps so
+ * the operator can confirm which version of the SDK is loaded at runtime
+ * (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.4.8";
 export { NETWORKS, WORKER_REGISTRY, REGISTRY_TOPICS, aggregateModelStats, aggregateWorkerStats, networkAnalytics, modelStatsCsv, workerStatsCsv, workerJobsCsv, fromWei, computeModelId as modelId, estimateJobFee, JOB_REGISTRY_CONSUMER_ABI, consumerGatewayUrl, consumerGatewayHost, GatewayClient, GatewayHttpError, prepareSession, submitPrompt, decryptResponse, generateEcdhKeyPair, crypto, runInference, runInferenceWithKey, StalledWorkerError, OnChainRevertError, RelayTokenTimeoutError, GatewayAuthError, isStalledWorker, };
 export type { BearerSource, GatewayClientOptions, SelectSessionResult, PrepareSessionResult, UploadBlobResult, SessionTokenResult } from "./gateway.js";
 export type { SessionPreparation, RunInferenceArgs, RunInferenceResult, RunInferenceWithKeyArgs } from "./inference.js";

package/dist/index.js

@@ -90,6 +90,13 @@ export class LightNode {
         return new GatewayClient({ network: this.network, ...opts });
     }
 }
+/**
+ * Build-time SDK version. Useful for diagnostic prints in examples and apps so
+ * the operator can confirm which version of the SDK is loaded at runtime
+ * (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.4.8";
 export { NETWORKS, WORKER_REGISTRY, REGISTRY_TOPICS, aggregateModelStats, aggregateWorkerStats, networkAnalytics, modelStatsCsv, workerStatsCsv, workerJobsCsv, fromWei, 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, 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lightnode-sdk",
-  "version": "0.4.6",
+  "version": "0.4.8",
   "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",
@@ -46,6 +46,8 @@
     "url": "https://github.com/marinom2/lightnode/issues"
   },
   "dependencies": {
+    "@noble/ciphers": "^1.0.0",
+    "@noble/curves": "^1.0.0",
     "viem": ">=2"
   },
   "engines": {