@terminal3/t3n-sdk 0.3.0 → 0.4.1

package/dist/index.d.ts

@@ -155,22 +155,22 @@ 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
@@ -224,7 +224,7 @@ 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;
 }
@@ -320,9 +320,16 @@ declare function createOidcAuthInput(credentials: OidcCredentials): OidcAuthInpu
  */
 /**
  * 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.
  */
-type GuestToHostHandler = (requestData: any) => Promise<Uint8Array>;
+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
@@ -361,7 +368,7 @@ interface GuestToHostHandlers {
 interface JsonRpcRequest {
     jsonrpc: "2.0";
     method: string;
-    params: any;
+    params: unknown;
     id: string | number;
 }
 /**
@@ -369,11 +376,11 @@ interface JsonRpcRequest {
  */
 interface JsonRpcResponse {
     jsonrpc: "2.0";
-    result?: any;
+    result?: unknown;
     error?: {
         code: number;
         message: string;
-        data?: any;
+        data?: unknown;
     };
     id: string | number;
 }
@@ -435,7 +442,7 @@ 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
      */
@@ -567,6 +574,14 @@ declare class T3nClient {
  * Examples: signing challenges, providing public keys, generating random bytes.
  */
 
+/**
+ * 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)
@@ -574,7 +589,7 @@ declare class T3nClient {
  *   Pass a custom logger to override logging behavior for this handler.
  * @param privateKey - Optional private key for signing (if provided, MetaMask is not used)
  */
-declare function metamask_sign(account: any, logger?: Logger, privateKey?: string | undefined): GuestToHostHandler;
+declare function metamask_sign(account: EthAccount, logger?: Logger, privateKey?: string | undefined): GuestToHostHandler;
 /**
  * Get the current MetaMask address
  * @returns Ethereum address (lowercase, 0x prefixed)
@@ -591,19 +606,30 @@ 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.
  */
-declare function createMlKemPublicKeyHandler(baseUrl?: string): GuestToHostHandler;
+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
  */
 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.
  */
-declare function createDefaultHandlers(baseUrl?: string): GuestToHostHandlers;
+declare function createDefaultHandlers(baseUrl: string): GuestToHostHandlers;
 
 /**
  * Cryptographic utilities for T3n SDK
@@ -709,7 +735,7 @@ declare function extractWasmError(error: unknown): string;
 /**
  * Redact secrets from values before logging
  */
-declare function redactSecrets(value: any): any;
+declare function redactSecrets(value: unknown): unknown;
 /**
  * Redact secrets from a JSON string
  */