@terminal3/t3n-sdk 0.3.0 → 0.4.1

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

@@ -6,6 +6,14 @@
  */
 import { GuestToHostHandler, GuestToHostHandlers } from "../types";
 import { Logger } from "../utils/logger";
+/**
+ * Account — MetaMask handler accepts either a plain address string or an
+ * object with an `address` field (for compatibility with various wallet
+ * libraries).
+ */
+type EthAccount = string | {
+    address: string;
+};
 /**
  * Create an EthSign handler using MetaMask (window.ethereum)
  * @param account - MetaMask account (string address or object with address property)
@@ -13,7 +21,7 @@ import { Logger } from "../utils/logger";
  *   Pass a custom logger to override logging behavior for this handler.
  * @param privateKey - Optional private key for signing (if provided, MetaMask is not used)
  */
-export declare function metamask_sign(account: any, logger?: Logger, privateKey?: string | undefined): GuestToHostHandler;
+export declare function metamask_sign(account: EthAccount, logger?: Logger, privateKey?: string | undefined): GuestToHostHandler;
 /**
  * Get the current MetaMask address
  * @returns Ethereum address (lowercase, 0x prefixed)
@@ -30,20 +38,36 @@ 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;
+export {};

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

@@ -10,7 +10,7 @@
 export interface JsonRpcRequest {
     jsonrpc: "2.0";
     method: string;
-    params: any;
+    params: unknown;
     id: string | number;
 }
 /**
@@ -18,11 +18,11 @@ export interface JsonRpcRequest {
  */
 export interface JsonRpcResponse {
     jsonrpc: "2.0";
-    result?: any;
+    result?: unknown;
     error?: {
         code: number;
         message: string;
-        data?: any;
+        data?: unknown;
     };
     id: string | number;
 }
@@ -84,7 +84,7 @@ export declare class MockTransport implements Transport {
     /**
      * Mock an error response for a specific method
      */
-    mockError(method: string, code: number, message: string, data?: any): void;
+    mockError(method: string, code: number, message: string, data?: unknown): void;
     /**
      * Get all requests that were sent
      */

package/dist/src/types/index.d.ts

@@ -3,9 +3,16 @@
  */
 /**
  * Guest-to-Host request handler function type
- * Handles requests from WASM guest that need host (SDK) to perform side effects
+ *
+ * Handles requests from WASM guest that need host (SDK) to perform side
+ * effects. The exact shape of `requestData` depends on the specific
+ * handler — see `GuestToHostHandlers` below for the per-handler shapes.
+ * The wrapper layer in `T3nClient.handleGuestToHost` parses the JSON
+ * envelope and calls the matching handler with the parsed data, so
+ * each handler's implementation should narrow `requestData` to its
+ * own expected shape.
  */
-export type GuestToHostHandler = (requestData: any) => Promise<Uint8Array>;
+export type GuestToHostHandler = (requestData: Record<string, unknown>) => Promise<Uint8Array>;
 /**
  * Map of guest-to-host request handlers
  * Keys match the guest_to_host tag values from the WASM

package/dist/src/utils/logger.d.ts

@@ -49,22 +49,22 @@ export interface Logger {
      * Log a debug message (most verbose)
      * @param args - Arguments to log
      */
-    debug(...args: any[]): void;
+    debug(...args: unknown[]): void;
     /**
      * Log an info message
      * @param args - Arguments to log
      */
-    info(...args: any[]): void;
+    info(...args: unknown[]): void;
     /**
      * Log a warning message
      * @param args - Arguments to log
      */
-    warn(...args: any[]): void;
+    warn(...args: unknown[]): void;
     /**
      * Log an error message (least verbose)
      * @param args - Arguments to log
      */
-    error(...args: any[]): void;
+    error(...args: unknown[]): void;
 }
 /**
  * Set the global default log level for all components

package/dist/src/utils/redaction.d.ts

@@ -6,7 +6,7 @@
 /**
  * Redact secrets from values before logging
  */
-export declare function redactSecrets(value: any): any;
+export declare function redactSecrets(value: unknown): unknown;
 /**
  * Redact secrets from a JSON string
  */

package/dist/src/wasm/loader.d.ts

@@ -16,7 +16,7 @@ export interface WasmLoadConfig {
     /** Custom fetch function for loading WASM */
     fetchFn?: typeof fetch;
     /** Additional initialization options */
-    initOptions?: Record<string, any>;
+    initOptions?: Record<string, unknown>;
     /** Optional logger instance - if not provided, uses global default */
     logger?: Logger;
 }

package/package.json

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