@terminal3/t3n-sdk 0.3.0 → 0.4.0

package/dist/src/client/handlers.d.ts

@@ -30,20 +30,35 @@ export declare function eth_get_address(privateKey: string): string;
  * from `${baseUrl}/status` on first invocation and caches the encoded
  * response for subsequent calls.
  *
- * @param baseUrl - Optional explicit node URL. If omitted, falls back to the
- *                  current environment default (see `getNodeUrl()`).
+ * @param baseUrl - **Required**. The node URL whose `/status` endpoint should
+ *                  serve the ML-KEM public key. Must be the same URL the
+ *                  T3nClient is constructed with — otherwise the handshake
+ *                  encrypts to one node and sends ciphertext to another.
+ *
+ *                  Was optional in 0.3.x, where omitting it caused the lazy
+ *                  fetch to silently fall back to `NODE_URLS[currentEnv]` and
+ *                  hit the wrong node. Three downstream consumers (demo.ts,
+ *                  t3-apps dev wallet hooks, t3n-mcp session manager) all
+ *                  hit this trap before we tightened the type.
  */
-export declare function createMlKemPublicKeyHandler(baseUrl?: string): GuestToHostHandler;
+export declare function createMlKemPublicKeyHandler(baseUrl: string): GuestToHostHandler;
 /**
  * Create Random handler backed by crypto.getRandomValues
  * Note: The Rust Vec<u8> type serializes as an array of bytes, not a base64 string
  */
 export declare function createRandomHandler(): GuestToHostHandler;
 /**
- * Create the default handler set required by the T3n handshake
+ * Create the default handler set required by the T3n handshake.
+ *
+ * @param baseUrl - **Required**. Forwarded to `createMlKemPublicKeyHandler`
+ *                  so the lazy /status fetch hits the right node.
  */
-export declare function createDefaultHandlers(baseUrl?: string): GuestToHostHandlers;
+export declare function createDefaultHandlers(baseUrl: string): GuestToHostHandlers;
 /**
- * Merge consumer-provided handlers with defaults (user handlers take precedence)
+ * Merge consumer-provided handlers with defaults (user handlers take precedence).
+ *
+ * @param handlers - Optional consumer overrides.
+ * @param baseUrl  - **Required**. Forwarded to the default handler set so the
+ *                   ML-KEM key fetch hits the right node.
  */
-export declare function mergeWithDefaultHandlers(handlers?: GuestToHostHandlers, baseUrl?: string): GuestToHostHandlers;
+export declare function mergeWithDefaultHandlers(handlers: GuestToHostHandlers | undefined, baseUrl: string): GuestToHostHandlers;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@terminal3/t3n-sdk",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "type": "module",
   "description": "T3n TypeScript SDK - A minimal SDK that mirrors the server's RPC handler approach",
   "main": "dist/index.js",