@zyfai/sdk 0.1.6 → 0.1.7

package/dist/index.d.mts

@@ -54,8 +54,6 @@ interface AddSessionKeyResponse {
 }
 interface SessionKeyResponse {
     success: boolean;
-    /** Session key address (not available when alreadyActive is true) */
-    sessionKeyAddress?: Address;
     /** Signature (not available when alreadyActive is true) */
     signature?: Hex;
     sessionNonces?: bigint[];
@@ -410,10 +408,10 @@ declare class ZyfaiSDK {
     private signer;
     private walletClient;
     private bundlerApiKey?;
-    private isAuthenticated;
     private authenticatedUserId;
     private hasActiveSessionKey;
     private environment;
+    private currentProvider;
     constructor(config: SDKConfig | string);
     /**
      * Authenticate user with SIWE (Sign-In with Ethereum) & JWT token
@@ -439,6 +437,12 @@ declare class ZyfaiSDK {
      * ```
      */
     updateUserProfile(request: UpdateUserProfileRequest): Promise<UpdateUserProfileResponse>;
+    /**
+     * Handle account changes from wallet provider
+     * Resets authentication state when wallet is switched
+     * @private
+     */
+    private handleAccountsChanged;
     /**
      * Connect account for signing transactions
      * Accepts either a private key string or a modern wallet provider

package/dist/index.d.ts

@@ -54,8 +54,6 @@ interface AddSessionKeyResponse {
 }
 interface SessionKeyResponse {
     success: boolean;
-    /** Session key address (not available when alreadyActive is true) */
-    sessionKeyAddress?: Address;
     /** Signature (not available when alreadyActive is true) */
     signature?: Hex;
     sessionNonces?: bigint[];
@@ -410,10 +408,10 @@ declare class ZyfaiSDK {
     private signer;
     private walletClient;
     private bundlerApiKey?;
-    private isAuthenticated;
     private authenticatedUserId;
     private hasActiveSessionKey;
     private environment;
+    private currentProvider;
     constructor(config: SDKConfig | string);
     /**
      * Authenticate user with SIWE (Sign-In with Ethereum) & JWT token
@@ -439,6 +437,12 @@ declare class ZyfaiSDK {
      * ```
      */
     updateUserProfile(request: UpdateUserProfileRequest): Promise<UpdateUserProfileResponse>;
+    /**
+     * Handle account changes from wallet provider
+     * Resets authentication state when wallet is switched
+     * @private
+     */
+    private handleAccountsChanged;
     /**
      * Connect account for signing transactions
      * Accepts either a private key string or a modern wallet provider

package/dist/index.js

@@ -620,14 +620,15 @@ var signSessionKey = async (config, sessions, allPublicClients) => {
 // src/core/ZyfaiSDK.ts
 var import_siwe = require("siwe");
 var ZyfaiSDK = class {
-  // TODO: The environment should be removed. Having the same key for staging and production is not ideal, but for now it's fine.
+  // Store reference to current provider for event handling
   constructor(config) {
     this.signer = null;
     this.walletClient = null;
-    this.isAuthenticated = false;
     this.authenticatedUserId = null;
-    // Stored from login response
+    // If non-null, user is authenticated
     this.hasActiveSessionKey = false;
+    // TODO: The environment should be removed. Having the same key for staging and production is not ideal, but for now it's fine.
+    this.currentProvider = null;
     const sdkConfig = typeof config === "string" ? { apiKey: config } : config;
     const { apiKey, dataApiKey, environment, bundlerApiKey } = sdkConfig;
     if (!apiKey) {
@@ -646,7 +647,7 @@ var ZyfaiSDK = class {
    */
   async authenticateUser() {
     try {
-      if (this.isAuthenticated) {
+      if (this.authenticatedUserId !== null) {
         return;
       }
       const walletClient = this.getWalletClient();
@@ -685,14 +686,13 @@ var ZyfaiSDK = class {
           signature
         }
       );
-      const authToken = loginResponse.accessToken || loginResponse.token;
+      const authToken = loginResponse.accessToken;
       if (!authToken) {
         throw new Error("Authentication response missing access token");
       }
       this.httpClient.setAuthToken(authToken);
       this.authenticatedUserId = loginResponse.userId || null;
       this.hasActiveSessionKey = loginResponse.hasActiveSessionKey || false;
-      this.isAuthenticated = true;
     } catch (error) {
       throw new Error(
         `Failed to authenticate user: ${error.message}`
@@ -733,6 +733,43 @@ var ZyfaiSDK = class {
       );
     }
   }
+  /**
+   * Handle account changes from wallet provider
+   * Resets authentication state when wallet is switched
+   * @private
+   */
+  async handleAccountsChanged(accounts) {
+    if (!accounts || accounts.length === 0) {
+      await this.disconnectAccount();
+      return;
+    }
+    const newAddress = accounts[0];
+    const currentAddress = this.walletClient?.account?.address;
+    if (currentAddress && newAddress.toLowerCase() === currentAddress.toLowerCase()) {
+      return;
+    }
+    this.authenticatedUserId = null;
+    this.hasActiveSessionKey = false;
+    this.httpClient.clearAuthToken();
+    if (this.walletClient && this.currentProvider) {
+      const chainConfig = getChainConfig(
+        this.walletClient.chain?.id || 42161
+      );
+      this.walletClient = (0, import_viem4.createWalletClient)({
+        account: newAddress,
+        chain: chainConfig.chain,
+        transport: (0, import_viem4.custom)(this.currentProvider)
+      });
+      try {
+        await this.authenticateUser();
+      } catch (error) {
+        console.warn(
+          "Failed to authenticate after wallet switch:",
+          error.message
+        );
+      }
+    }
+  }
   /**
    * Connect account for signing transactions
    * Accepts either a private key string or a modern wallet provider
@@ -754,8 +791,14 @@ var ZyfaiSDK = class {
     if (!isSupportedChain(chainId)) {
       throw new Error(`Unsupported chain ID: ${chainId}`);
     }
-    this.isAuthenticated = false;
+    this.authenticatedUserId = null;
     this.httpClient.clearAuthToken();
+    if (this.currentProvider?.removeAllListeners) {
+      try {
+        this.currentProvider.removeAllListeners("accountsChanged");
+      } catch (error) {
+      }
+    }
     const chainConfig = getChainConfig(chainId);
     let connectedAddress;
     if (typeof account === "string") {
@@ -770,6 +813,7 @@ var ZyfaiSDK = class {
         transport: (0, import_viem4.http)(chainConfig.rpcUrl)
       });
       connectedAddress = this.signer.address;
+      this.currentProvider = null;
     } else {
       const provider = account;
       if (!provider) {
@@ -790,6 +834,10 @@ var ZyfaiSDK = class {
           transport: (0, import_viem4.custom)(provider)
         });
         connectedAddress = accounts[0];
+        this.currentProvider = provider;
+        if (provider.on) {
+          provider.on("accountsChanged", this.handleAccountsChanged.bind(this));
+        }
       } else if (provider.account && provider.transport) {
         this.walletClient = (0, import_viem4.createWalletClient)({
           account: provider.account,
@@ -797,6 +845,7 @@ var ZyfaiSDK = class {
           transport: provider.transport
         });
         connectedAddress = provider.account.address;
+        this.currentProvider = null;
       } else {
         throw new Error(
           "Invalid wallet provider. Expected EIP-1193 provider or viem WalletClient."
@@ -817,9 +866,15 @@ var ZyfaiSDK = class {
    * ```
    */
   async disconnectAccount() {
+    if (this.currentProvider?.removeAllListeners) {
+      try {
+        this.currentProvider.removeAllListeners("accountsChanged");
+      } catch (error) {
+      }
+    }
     this.signer = null;
     this.walletClient = null;
-    this.isAuthenticated = false;
+    this.currentProvider = null;
     this.authenticatedUserId = null;
     this.hasActiveSessionKey = false;
     this.httpClient.clearAuthToken();
@@ -1072,7 +1127,6 @@ var ZyfaiSDK = class {
       });
       return {
         success: true,
-        sessionKeyAddress: safeAddress,
         signature,
         sessionNonces
       };

package/dist/index.mjs

@@ -599,14 +599,15 @@ var signSessionKey = async (config, sessions, allPublicClients) => {
 // src/core/ZyfaiSDK.ts
 import { SiweMessage } from "siwe";
 var ZyfaiSDK = class {
-  // TODO: The environment should be removed. Having the same key for staging and production is not ideal, but for now it's fine.
+  // Store reference to current provider for event handling
   constructor(config) {
     this.signer = null;
     this.walletClient = null;
-    this.isAuthenticated = false;
     this.authenticatedUserId = null;
-    // Stored from login response
+    // If non-null, user is authenticated
     this.hasActiveSessionKey = false;
+    // TODO: The environment should be removed. Having the same key for staging and production is not ideal, but for now it's fine.
+    this.currentProvider = null;
     const sdkConfig = typeof config === "string" ? { apiKey: config } : config;
     const { apiKey, dataApiKey, environment, bundlerApiKey } = sdkConfig;
     if (!apiKey) {
@@ -625,7 +626,7 @@ var ZyfaiSDK = class {
    */
   async authenticateUser() {
     try {
-      if (this.isAuthenticated) {
+      if (this.authenticatedUserId !== null) {
         return;
       }
       const walletClient = this.getWalletClient();
@@ -664,14 +665,13 @@ var ZyfaiSDK = class {
           signature
         }
       );
-      const authToken = loginResponse.accessToken || loginResponse.token;
+      const authToken = loginResponse.accessToken;
       if (!authToken) {
         throw new Error("Authentication response missing access token");
       }
       this.httpClient.setAuthToken(authToken);
       this.authenticatedUserId = loginResponse.userId || null;
       this.hasActiveSessionKey = loginResponse.hasActiveSessionKey || false;
-      this.isAuthenticated = true;
     } catch (error) {
       throw new Error(
         `Failed to authenticate user: ${error.message}`
@@ -712,6 +712,43 @@ var ZyfaiSDK = class {
       );
     }
   }
+  /**
+   * Handle account changes from wallet provider
+   * Resets authentication state when wallet is switched
+   * @private
+   */
+  async handleAccountsChanged(accounts) {
+    if (!accounts || accounts.length === 0) {
+      await this.disconnectAccount();
+      return;
+    }
+    const newAddress = accounts[0];
+    const currentAddress = this.walletClient?.account?.address;
+    if (currentAddress && newAddress.toLowerCase() === currentAddress.toLowerCase()) {
+      return;
+    }
+    this.authenticatedUserId = null;
+    this.hasActiveSessionKey = false;
+    this.httpClient.clearAuthToken();
+    if (this.walletClient && this.currentProvider) {
+      const chainConfig = getChainConfig(
+        this.walletClient.chain?.id || 42161
+      );
+      this.walletClient = createWalletClient({
+        account: newAddress,
+        chain: chainConfig.chain,
+        transport: custom(this.currentProvider)
+      });
+      try {
+        await this.authenticateUser();
+      } catch (error) {
+        console.warn(
+          "Failed to authenticate after wallet switch:",
+          error.message
+        );
+      }
+    }
+  }
   /**
    * Connect account for signing transactions
    * Accepts either a private key string or a modern wallet provider
@@ -733,8 +770,14 @@ var ZyfaiSDK = class {
     if (!isSupportedChain(chainId)) {
       throw new Error(`Unsupported chain ID: ${chainId}`);
     }
-    this.isAuthenticated = false;
+    this.authenticatedUserId = null;
     this.httpClient.clearAuthToken();
+    if (this.currentProvider?.removeAllListeners) {
+      try {
+        this.currentProvider.removeAllListeners("accountsChanged");
+      } catch (error) {
+      }
+    }
     const chainConfig = getChainConfig(chainId);
     let connectedAddress;
     if (typeof account === "string") {
@@ -749,6 +792,7 @@ var ZyfaiSDK = class {
         transport: http3(chainConfig.rpcUrl)
       });
       connectedAddress = this.signer.address;
+      this.currentProvider = null;
     } else {
       const provider = account;
       if (!provider) {
@@ -769,6 +813,10 @@ var ZyfaiSDK = class {
           transport: custom(provider)
         });
         connectedAddress = accounts[0];
+        this.currentProvider = provider;
+        if (provider.on) {
+          provider.on("accountsChanged", this.handleAccountsChanged.bind(this));
+        }
       } else if (provider.account && provider.transport) {
         this.walletClient = createWalletClient({
           account: provider.account,
@@ -776,6 +824,7 @@ var ZyfaiSDK = class {
           transport: provider.transport
         });
         connectedAddress = provider.account.address;
+        this.currentProvider = null;
       } else {
         throw new Error(
           "Invalid wallet provider. Expected EIP-1193 provider or viem WalletClient."
@@ -796,9 +845,15 @@ var ZyfaiSDK = class {
    * ```
    */
   async disconnectAccount() {
+    if (this.currentProvider?.removeAllListeners) {
+      try {
+        this.currentProvider.removeAllListeners("accountsChanged");
+      } catch (error) {
+      }
+    }
     this.signer = null;
     this.walletClient = null;
-    this.isAuthenticated = false;
+    this.currentProvider = null;
     this.authenticatedUserId = null;
     this.hasActiveSessionKey = false;
     this.httpClient.clearAuthToken();
@@ -1051,7 +1106,6 @@ var ZyfaiSDK = class {
       });
       return {
         success: true,
-        sessionKeyAddress: safeAddress,
         signature,
         sessionNonces
       };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zyfai/sdk",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "description": "TypeScript SDK for ZyFAI Yield Optimization Engine - Deploy Safe smart wallets, manage session keys, and interact with DeFi protocols",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -28,7 +28,13 @@
     "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
     "lint": "eslint src --ext .ts",
     "test": "jest",
-    "prepublishOnly": "npm run build"
+    "prepublishOnly": "npm run build",
+    "docs": "typedoc",
+    "docs:watch": "typedoc --watch",
+    "docs:json": "typedoc --json docs/api.json",
+    "docs:dev": "cd website && pnpm start",
+    "docs:build": "pnpm docs && cd website && pnpm build",
+    "docs:serve": "cd website && pnpm serve"
   },
   "keywords": [
     "zyfai",
@@ -70,6 +76,8 @@
     "@types/node": "^20.0.0",
     "dotenv": "^17.2.3",
     "tsup": "^8.0.0",
+    "typedoc": "^0.28.15",
+    "typedoc-plugin-markdown": "^4.9.0",
     "typescript": "^5.3.0"
   },
   "peerDependencies": {