@zyfai/sdk 0.2.11 → 0.2.13

package/README.md

@@ -462,12 +462,39 @@ The SDK provides access to various analytics and data endpoints:
 
 #### Get User Details
 
+Fetch complete authenticated user profile including smart wallet, chains, protocols, and all configuration settings:
+
 ```typescript
 const user = await sdk.getUserDetails();
+
 console.log("Smart Wallet:", user.user.smartWallet);
 console.log("Active Chains:", user.user.chains);
 console.log("Active Protocols:", user.user.protocols);
-```
+console.log("Strategy:", user.user.strategy); // "conservative" | "aggressive"
+console.log("Has Active Session:", user.user.hasActiveSessionKey);
+
+// Feature flags
+console.log("Auto-compounding:", user.user.autocompounding);
+console.log("Auto-select Protocols:", user.user.autoSelectProtocols);
+console.log("Omni Account:", user.user.omniAccount);
+console.log("Cross-chain Strategy:", user.user.crosschainStrategy);
+console.log("Executor Proxy:", user.user.executorProxy);
+console.log("Splitting:", user.user.splitting);
+console.log("Min Splits:", user.user.minSplits);
+
+// Optional fields
+console.log("Email:", user.user.email);
+console.log("Telegram ID:", user.user.telegramId);
+console.log("Agent Name:", user.user.agentName);
+console.log("Wallet Type:", user.user.walletType);
+```
+
+**Available Fields:**
+- **Core Info**: `id`, `address`, `smartWallet`, `chains`, `protocols`
+- **Strategy**: `strategy` (conservative or aggressive)
+- **Session**: `hasActiveSessionKey` (boolean)
+- **Features**: `autocompounding`, `autoSelectProtocols`, `omniAccount`, `crosschainStrategy`, `executorProxy`, `splitting`, `minSplits`
+- **Optional**: `email`, `telegramId`, `agentName`, `walletType`, `customization`, `registered`
 
 #### Pause Agent
 
@@ -726,26 +753,28 @@ All examples are available in the `examples/` directory:
 8. **`get-positions.ts`** - Get active positions for a wallet
 9. **`get-user-details.ts`** - Get authenticated user details
 10. **`pause-agent.ts`** - Pause agent by clearing all protocols
-11. **`get-tvl-volume.ts`** - Get TVL and trading volume
-12. **`get-active-wallets.ts`** - Get active wallets by chain
-13. **`get-smart-wallets-by-eoa.ts`** - Get smart wallets by EOA
-14. **`get-first-topup.ts`** - Get first deposit information
-15. **`get-history.ts`** - Get transaction history
+11. **`update-profile-with-protocols.ts`** - Configure user profile with protocols, chains, and advanced features
+12. **`customize-batch.ts`** - Configure specific pools for protocols across chains
+13. **`get-tvl-volume.ts`** - Get TVL and trading volume
+14. **`get-active-wallets.ts`** - Get active wallets by chain
+15. **`get-smart-wallets-by-eoa.ts`** - Get smart wallets by EOA
+16. **`get-first-topup.ts`** - Get first deposit information
+17. **`get-history.ts`** - Get transaction history
 
 ### Analytics & Earnings
 
-16. **`get-onchain-earnings.ts`** - Get/calculate onchain earnings
-17. **`get-daily-earnings.ts`** - Get daily earnings breakdown
-18. **`get-apy-history.ts`** - Get daily APY history with weighted averages
+18. **`get-onchain-earnings.ts`** - Get/calculate onchain earnings
+19. **`get-daily-earnings.ts`** - Get daily earnings breakdown
+20. **`get-apy-history.ts`** - Get daily APY history with weighted averages
 
 ### Opportunities & Rebalancing
 
-19. **`get-opportunities.ts`** - Get conservative and aggressive yield opportunities
-20. **`get-rebalance-info.ts`** - Get rebalance events and frequency tier
+21. **`get-opportunities.ts`** - Get conservative and aggressive yield opportunities
+22. **`get-rebalance-info.ts`** - Get rebalance events and frequency tier
 
 ### Premium Features
 
-21. **`get-debank-portfolio.ts`** - Get Debank multi-chain portfolio
+23. **`get-debank-portfolio.ts`** - Get Debank multi-chain portfolio
 
 ### Quick Start: Run the End-to-End Example
 

package/dist/index.d.mts

@@ -23,14 +23,17 @@ interface DeploySafeResponse {
 }
 /** @internal */
 interface UpdateUserProfileRequest {
-    smartWallet?: string;
     strategy?: string;
-    chains?: number[];
     protocols?: string[];
     autoSelectProtocols?: boolean;
-    customization?: Record<string, string[]>;
+    omniAccount?: boolean;
+    autocompounding?: boolean;
+    agentName?: string;
+    crosschainStrategy?: boolean;
+    executorProxy?: boolean;
     splitting?: boolean;
     minSplits?: number;
+    customization?: Record<string, any>;
 }
 /** @internal */
 interface UpdateUserProfileResponse {
@@ -39,6 +42,16 @@ interface UpdateUserProfileResponse {
     smartWallet?: Address;
     chains?: number[];
     strategy?: string;
+    protocols?: string[];
+    autoSelectProtocols?: boolean;
+    omniAccount?: boolean;
+    autocompounding?: boolean;
+    agentName?: string;
+    crosschainStrategy?: boolean;
+    executorProxy?: boolean;
+    splitting?: boolean;
+    minSplits?: number;
+    customization?: Record<string, any>;
 }
 /** @internal */
 interface AddSessionKeyResponse {
@@ -143,9 +156,11 @@ interface UserDetails {
     omniAccount?: boolean;
     crosschainStrategy?: boolean;
     agentName?: string;
-    customization?: Record<string, string[]>;
+    customization?: Record<string, any>;
+    executorProxy?: boolean;
     splitting?: boolean;
     minSplits?: number;
+    registered?: boolean;
 }
 interface UserDetailsResponse {
     success: boolean;
@@ -431,6 +446,27 @@ interface RegisterAgentResponse {
     chainId: number;
     smartWallet: string;
 }
+interface CustomizationConfig {
+    protocolId: string;
+    pools: string[];
+    chainId: number;
+    autoselect: boolean;
+}
+interface CustomizeBatchRequest {
+    customizations: CustomizationConfig[];
+}
+interface CustomizeBatchResponse {
+    success: boolean;
+}
+interface GetPoolsResponse {
+    success: boolean;
+    pools: string[];
+}
+interface GetSelectedPoolsResponse {
+    success: boolean;
+    pools: string[];
+    autoselect: boolean;
+}
 interface PolicyData {
     policy: Address;
     initData: Hex;
@@ -1133,6 +1169,86 @@ declare class ZyfaiSDK {
      * ```
      */
     getBestOpportunity(walletAddress: Address, chainId: SupportedChainId): Promise<BestOpportunityResponse>;
+    /**
+     * Configure protocol and pool customizations in batch.
+     *
+     * Allows granular control over which pools to use for each protocol on each chain.
+     * This is useful for advanced users who want to target specific pools with desired APY/risk profiles.
+     *
+     * @param customizations - Array of customization configurations
+     * @returns Response indicating success
+     *
+     * @example
+     * ```typescript
+     * // Configure multiple protocols across different chains
+     * await sdk.customizeBatch([
+     *   {
+     *     protocolId: "protocol-uuid-1",
+     *     pools: ["USDC Pool", "WETH Pool"],
+     *     chainId: 8453,  // Base
+     *     autoselect: false
+     *   },
+     *   {
+     *     protocolId: "protocol-uuid-1",
+     *     pools: ["USDC Vault"],
+     *     chainId: 42161,  // Arbitrum
+     *     autoselect: false
+     *   },
+     *   {
+     *     protocolId: "protocol-uuid-2",
+     *     pools: [],  // Empty array when autoselect is true
+     *     chainId: 8453,
+     *     autoselect: true  // Let engine auto-select best pools
+     *   }
+     * ]);
+     * ```
+     */
+    customizeBatch(customizations: CustomizationConfig[]): Promise<CustomizeBatchResponse>;
+    /**
+     * Get available pools for a protocol.
+     *
+     * Returns the list of pools available for a given protocol, optionally filtered by strategy.
+     *
+     * @param protocolId - The protocol UUID
+     * @param strategy - Optional strategy filter ("conservative" or "aggressive")
+     * @returns List of available pool names
+     *
+     * @example
+     * ```typescript
+     * // Get all available pools for a protocol
+     * const pools = await sdk.getAvailablePools("protocol-uuid");
+     * console.log("Available pools:", pools.pools);
+     *
+     * // Get pools for conservative strategy only
+     * const conservativePools = await sdk.getAvailablePools(
+     *   "protocol-uuid",
+     *   "conservative"
+     * );
+     * ```
+     */
+    getAvailablePools(protocolId: string, strategy?: "conservative" | "aggressive"): Promise<GetPoolsResponse>;
+    /**
+     * Get currently selected pools for a protocol on a specific chain.
+     *
+     * Returns the pools that are currently configured for the authenticated user
+     * for a given protocol and chain combination.
+     *
+     * @param protocolId - The protocol UUID
+     * @param chainId - The chain ID
+     * @returns Currently selected pools and autoselect status
+     *
+     * @example
+     * ```typescript
+     * const selected = await sdk.getSelectedPools(
+     *   "protocol-uuid",
+     *   8453  // Base
+     * );
+     *
+     * console.log("Selected pools:", selected.pools);
+     * console.log("Autoselect enabled:", selected.autoselect);
+     * ```
+     */
+    getSelectedPools(protocolId: string, chainId: number): Promise<GetSelectedPoolsResponse>;
     /**
      * Supported chain IDs for the Identity Registry (ERC-8004)
      */
@@ -1163,4 +1279,4 @@ declare class ZyfaiSDK {
     registerAgentOnIdentityRegistry(smartWallet: string, chainId: SupportedChainId): Promise<RegisterAgentResponse>;
 }
 
-export { type APYPerStrategy, type APYPerStrategyResponse, type ActionData, type ActiveWallet, type ActiveWalletsResponse, type AddWalletToSdkResponse, type Address, type BestOpportunityDetails, type BestOpportunityResponse, type ChainConfig, type ChainPortfolio, DEFAULT_TOKEN_ADDRESSES, type DailyApyEntry, type DailyApyHistoryResponse, type DailyEarning, type DailyEarningsResponse, type DebankPortfolioResponse, type DeploySafeResponse, type DepositResponse, type ERC7739Context, type ERC7739Data, type FirstTopupResponse, type Hex, type HistoryEntry, type HistoryPosition, type HistoryResponse, type OnchainEarnings, type OnchainEarningsResponse, type OpportunitiesResponse, type Opportunity, type OpportunityPosition, type PolicyData, type Pool, type PortfolioToken, type Position, type PositionSlot, type PositionsResponse, type Protocol, type ProtocolsResponse, type RebalanceFrequencyResponse, type RegisterAgentResponse, type SDKConfig, type SdkKeyTVLResponse, type Session, type SessionKeyResponse, type SmartWalletByEOAResponse, type SmartWalletResponse, type Strategy, type SupportedChainId, type TVLResponse, type UserDetails, type UserDetailsResponse, type VolumeResponse, type WalletTVL, type WithdrawResponse, ZyfaiSDK, getChainConfig, getDefaultTokenAddress, getSupportedChainIds, isSupportedChain };
+export { type APYPerStrategy, type APYPerStrategyResponse, type ActionData, type ActiveWallet, type ActiveWalletsResponse, type AddWalletToSdkResponse, type Address, type BestOpportunityDetails, type BestOpportunityResponse, type ChainConfig, type ChainPortfolio, type CustomizationConfig, type CustomizeBatchRequest, type CustomizeBatchResponse, DEFAULT_TOKEN_ADDRESSES, type DailyApyEntry, type DailyApyHistoryResponse, type DailyEarning, type DailyEarningsResponse, type DebankPortfolioResponse, type DeploySafeResponse, type DepositResponse, type ERC7739Context, type ERC7739Data, type FirstTopupResponse, type GetPoolsResponse, type GetSelectedPoolsResponse, type Hex, type HistoryEntry, type HistoryPosition, type HistoryResponse, type OnchainEarnings, type OnchainEarningsResponse, type OpportunitiesResponse, type Opportunity, type OpportunityPosition, type PolicyData, type Pool, type PortfolioToken, type Position, type PositionSlot, type PositionsResponse, type Protocol, type ProtocolsResponse, type RebalanceFrequencyResponse, type RegisterAgentResponse, type SDKConfig, type SdkKeyTVLResponse, type Session, type SessionKeyResponse, type SmartWalletByEOAResponse, type SmartWalletResponse, type Strategy, type SupportedChainId, type TVLResponse, type UserDetails, type UserDetailsResponse, type VolumeResponse, type WalletTVL, type WithdrawResponse, ZyfaiSDK, getChainConfig, getDefaultTokenAddress, getSupportedChainIds, isSupportedChain };

package/dist/index.d.ts

@@ -23,14 +23,17 @@ interface DeploySafeResponse {
 }
 /** @internal */
 interface UpdateUserProfileRequest {
-    smartWallet?: string;
     strategy?: string;
-    chains?: number[];
     protocols?: string[];
     autoSelectProtocols?: boolean;
-    customization?: Record<string, string[]>;
+    omniAccount?: boolean;
+    autocompounding?: boolean;
+    agentName?: string;
+    crosschainStrategy?: boolean;
+    executorProxy?: boolean;
     splitting?: boolean;
     minSplits?: number;
+    customization?: Record<string, any>;
 }
 /** @internal */
 interface UpdateUserProfileResponse {
@@ -39,6 +42,16 @@ interface UpdateUserProfileResponse {
     smartWallet?: Address;
     chains?: number[];
     strategy?: string;
+    protocols?: string[];
+    autoSelectProtocols?: boolean;
+    omniAccount?: boolean;
+    autocompounding?: boolean;
+    agentName?: string;
+    crosschainStrategy?: boolean;
+    executorProxy?: boolean;
+    splitting?: boolean;
+    minSplits?: number;
+    customization?: Record<string, any>;
 }
 /** @internal */
 interface AddSessionKeyResponse {
@@ -143,9 +156,11 @@ interface UserDetails {
     omniAccount?: boolean;
     crosschainStrategy?: boolean;
     agentName?: string;
-    customization?: Record<string, string[]>;
+    customization?: Record<string, any>;
+    executorProxy?: boolean;
     splitting?: boolean;
     minSplits?: number;
+    registered?: boolean;
 }
 interface UserDetailsResponse {
     success: boolean;
@@ -431,6 +446,27 @@ interface RegisterAgentResponse {
     chainId: number;
     smartWallet: string;
 }
+interface CustomizationConfig {
+    protocolId: string;
+    pools: string[];
+    chainId: number;
+    autoselect: boolean;
+}
+interface CustomizeBatchRequest {
+    customizations: CustomizationConfig[];
+}
+interface CustomizeBatchResponse {
+    success: boolean;
+}
+interface GetPoolsResponse {
+    success: boolean;
+    pools: string[];
+}
+interface GetSelectedPoolsResponse {
+    success: boolean;
+    pools: string[];
+    autoselect: boolean;
+}
 interface PolicyData {
     policy: Address;
     initData: Hex;
@@ -1133,6 +1169,86 @@ declare class ZyfaiSDK {
      * ```
      */
     getBestOpportunity(walletAddress: Address, chainId: SupportedChainId): Promise<BestOpportunityResponse>;
+    /**
+     * Configure protocol and pool customizations in batch.
+     *
+     * Allows granular control over which pools to use for each protocol on each chain.
+     * This is useful for advanced users who want to target specific pools with desired APY/risk profiles.
+     *
+     * @param customizations - Array of customization configurations
+     * @returns Response indicating success
+     *
+     * @example
+     * ```typescript
+     * // Configure multiple protocols across different chains
+     * await sdk.customizeBatch([
+     *   {
+     *     protocolId: "protocol-uuid-1",
+     *     pools: ["USDC Pool", "WETH Pool"],
+     *     chainId: 8453,  // Base
+     *     autoselect: false
+     *   },
+     *   {
+     *     protocolId: "protocol-uuid-1",
+     *     pools: ["USDC Vault"],
+     *     chainId: 42161,  // Arbitrum
+     *     autoselect: false
+     *   },
+     *   {
+     *     protocolId: "protocol-uuid-2",
+     *     pools: [],  // Empty array when autoselect is true
+     *     chainId: 8453,
+     *     autoselect: true  // Let engine auto-select best pools
+     *   }
+     * ]);
+     * ```
+     */
+    customizeBatch(customizations: CustomizationConfig[]): Promise<CustomizeBatchResponse>;
+    /**
+     * Get available pools for a protocol.
+     *
+     * Returns the list of pools available for a given protocol, optionally filtered by strategy.
+     *
+     * @param protocolId - The protocol UUID
+     * @param strategy - Optional strategy filter ("conservative" or "aggressive")
+     * @returns List of available pool names
+     *
+     * @example
+     * ```typescript
+     * // Get all available pools for a protocol
+     * const pools = await sdk.getAvailablePools("protocol-uuid");
+     * console.log("Available pools:", pools.pools);
+     *
+     * // Get pools for conservative strategy only
+     * const conservativePools = await sdk.getAvailablePools(
+     *   "protocol-uuid",
+     *   "conservative"
+     * );
+     * ```
+     */
+    getAvailablePools(protocolId: string, strategy?: "conservative" | "aggressive"): Promise<GetPoolsResponse>;
+    /**
+     * Get currently selected pools for a protocol on a specific chain.
+     *
+     * Returns the pools that are currently configured for the authenticated user
+     * for a given protocol and chain combination.
+     *
+     * @param protocolId - The protocol UUID
+     * @param chainId - The chain ID
+     * @returns Currently selected pools and autoselect status
+     *
+     * @example
+     * ```typescript
+     * const selected = await sdk.getSelectedPools(
+     *   "protocol-uuid",
+     *   8453  // Base
+     * );
+     *
+     * console.log("Selected pools:", selected.pools);
+     * console.log("Autoselect enabled:", selected.autoselect);
+     * ```
+     */
+    getSelectedPools(protocolId: string, chainId: number): Promise<GetSelectedPoolsResponse>;
     /**
      * Supported chain IDs for the Identity Registry (ERC-8004)
      */
@@ -1163,4 +1279,4 @@ declare class ZyfaiSDK {
     registerAgentOnIdentityRegistry(smartWallet: string, chainId: SupportedChainId): Promise<RegisterAgentResponse>;
 }
 
-export { type APYPerStrategy, type APYPerStrategyResponse, type ActionData, type ActiveWallet, type ActiveWalletsResponse, type AddWalletToSdkResponse, type Address, type BestOpportunityDetails, type BestOpportunityResponse, type ChainConfig, type ChainPortfolio, DEFAULT_TOKEN_ADDRESSES, type DailyApyEntry, type DailyApyHistoryResponse, type DailyEarning, type DailyEarningsResponse, type DebankPortfolioResponse, type DeploySafeResponse, type DepositResponse, type ERC7739Context, type ERC7739Data, type FirstTopupResponse, type Hex, type HistoryEntry, type HistoryPosition, type HistoryResponse, type OnchainEarnings, type OnchainEarningsResponse, type OpportunitiesResponse, type Opportunity, type OpportunityPosition, type PolicyData, type Pool, type PortfolioToken, type Position, type PositionSlot, type PositionsResponse, type Protocol, type ProtocolsResponse, type RebalanceFrequencyResponse, type RegisterAgentResponse, type SDKConfig, type SdkKeyTVLResponse, type Session, type SessionKeyResponse, type SmartWalletByEOAResponse, type SmartWalletResponse, type Strategy, type SupportedChainId, type TVLResponse, type UserDetails, type UserDetailsResponse, type VolumeResponse, type WalletTVL, type WithdrawResponse, ZyfaiSDK, getChainConfig, getDefaultTokenAddress, getSupportedChainIds, isSupportedChain };
+export { type APYPerStrategy, type APYPerStrategyResponse, type ActionData, type ActiveWallet, type ActiveWalletsResponse, type AddWalletToSdkResponse, type Address, type BestOpportunityDetails, type BestOpportunityResponse, type ChainConfig, type ChainPortfolio, type CustomizationConfig, type CustomizeBatchRequest, type CustomizeBatchResponse, DEFAULT_TOKEN_ADDRESSES, type DailyApyEntry, type DailyApyHistoryResponse, type DailyEarning, type DailyEarningsResponse, type DebankPortfolioResponse, type DeploySafeResponse, type DepositResponse, type ERC7739Context, type ERC7739Data, type FirstTopupResponse, type GetPoolsResponse, type GetSelectedPoolsResponse, type Hex, type HistoryEntry, type HistoryPosition, type HistoryResponse, type OnchainEarnings, type OnchainEarningsResponse, type OpportunitiesResponse, type Opportunity, type OpportunityPosition, type PolicyData, type Pool, type PortfolioToken, type Position, type PositionSlot, type PositionsResponse, type Protocol, type ProtocolsResponse, type RebalanceFrequencyResponse, type RegisterAgentResponse, type SDKConfig, type SdkKeyTVLResponse, type Session, type SessionKeyResponse, type SmartWalletByEOAResponse, type SmartWalletResponse, type Strategy, type SupportedChainId, type TVLResponse, type UserDetails, type UserDetailsResponse, type VolumeResponse, type WalletTVL, type WithdrawResponse, ZyfaiSDK, getChainConfig, getDefaultTokenAddress, getSupportedChainIds, isSupportedChain };

package/dist/index.js

@@ -78,7 +78,11 @@ var ENDPOINTS = {
   // Best Opportunity
   BEST_OPPORTUNITY: (walletAddress, chainId) => `/data/best-opportunity?walletAddress=${walletAddress}&chainId=${chainId}`,
   // Agent Identity Registry
-  AGENT_TOKEN_URI: "/users/me/agent-token-uri"
+  AGENT_TOKEN_URI: "/users/me/agent-token-uri",
+  // Customization
+  CUSTOMIZE_BATCH: "/customization/customize-batch",
+  CUSTOMIZATION_POOLS: (protocolId, strategy) => `/customization/pools?protocolId=${protocolId}${strategy ? `&strategy=${strategy}` : ""}`,
+  CUSTOMIZATION_SELECTED_POOLS: (protocolId, chainId) => `/customization/selected-pools?protocolId=${protocolId}&chainId=${chainId}`
 };
 var DATA_ENDPOINTS = {
   // User Initialization
@@ -794,7 +798,17 @@ var _ZyfaiSDK = class _ZyfaiSDK {
         userId: response.userId || response.id,
         smartWallet: response.smartWallet,
         chains: response.chains,
-        strategy: response.strategy
+        strategy: response.strategy,
+        protocols: response.protocols,
+        autoSelectProtocols: response.autoSelectProtocols,
+        omniAccount: response.omniAccount,
+        autocompounding: response.autocompounding,
+        agentName: response.agentName,
+        crosschainStrategy: response.crosschainStrategy,
+        executorProxy: response.executorProxy,
+        splitting: response.splitting,
+        minSplits: response.minSplits,
+        customization: response.customization
       };
     } catch (error) {
       throw new Error(
@@ -1750,8 +1764,10 @@ var _ZyfaiSDK = class _ZyfaiSDK {
           crosschainStrategy: convertedResponse.crosschainStrategy,
           agentName: convertedResponse.agentName,
           customization: convertedResponse.customization,
+          executorProxy: convertedResponse.executorProxy,
           splitting: convertedResponse.splitting,
-          minSplits: convertedResponse.minSplits
+          minSplits: convertedResponse.minSplits,
+          registered: convertedResponse.registered
         }
       };
     } catch (error) {
@@ -2583,6 +2599,134 @@ var _ZyfaiSDK = class _ZyfaiSDK {
       );
     }
   }
+  // ============================================================================
+  // Protocol/Pool Customization
+  // ============================================================================
+  /**
+   * Configure protocol and pool customizations in batch.
+   *
+   * Allows granular control over which pools to use for each protocol on each chain.
+   * This is useful for advanced users who want to target specific pools with desired APY/risk profiles.
+   *
+   * @param customizations - Array of customization configurations
+   * @returns Response indicating success
+   *
+   * @example
+   * ```typescript
+   * // Configure multiple protocols across different chains
+   * await sdk.customizeBatch([
+   *   {
+   *     protocolId: "protocol-uuid-1",
+   *     pools: ["USDC Pool", "WETH Pool"],
+   *     chainId: 8453,  // Base
+   *     autoselect: false
+   *   },
+   *   {
+   *     protocolId: "protocol-uuid-1",
+   *     pools: ["USDC Vault"],
+   *     chainId: 42161,  // Arbitrum
+   *     autoselect: false
+   *   },
+   *   {
+   *     protocolId: "protocol-uuid-2",
+   *     pools: [],  // Empty array when autoselect is true
+   *     chainId: 8453,
+   *     autoselect: true  // Let engine auto-select best pools
+   *   }
+   * ]);
+   * ```
+   */
+  async customizeBatch(customizations) {
+    try {
+      await this.authenticateUser();
+      const response = await this.httpClient.post(
+        ENDPOINTS.CUSTOMIZE_BATCH,
+        customizations
+      );
+      return response;
+    } catch (error) {
+      throw new Error(
+        `Failed to save customizations: ${error.message}`
+      );
+    }
+  }
+  /**
+   * Get available pools for a protocol.
+   *
+   * Returns the list of pools available for a given protocol, optionally filtered by strategy.
+   *
+   * @param protocolId - The protocol UUID
+   * @param strategy - Optional strategy filter ("conservative" or "aggressive")
+   * @returns List of available pool names
+   *
+   * @example
+   * ```typescript
+   * // Get all available pools for a protocol
+   * const pools = await sdk.getAvailablePools("protocol-uuid");
+   * console.log("Available pools:", pools.pools);
+   *
+   * // Get pools for conservative strategy only
+   * const conservativePools = await sdk.getAvailablePools(
+   *   "protocol-uuid",
+   *   "conservative"
+   * );
+   * ```
+   */
+  async getAvailablePools(protocolId, strategy) {
+    try {
+      let internalStrategy;
+      if (strategy) {
+        if (!isValidPublicStrategy(strategy)) {
+          throw new Error(
+            `Invalid strategy: ${strategy}. Must be "conservative" or "aggressive".`
+          );
+        }
+        internalStrategy = toInternalStrategy(strategy);
+      }
+      const response = await this.httpClient.get(
+        ENDPOINTS.CUSTOMIZATION_POOLS(protocolId, internalStrategy)
+      );
+      return response;
+    } catch (error) {
+      throw new Error(
+        `Failed to get available pools: ${error.message}`
+      );
+    }
+  }
+  /**
+   * Get currently selected pools for a protocol on a specific chain.
+   *
+   * Returns the pools that are currently configured for the authenticated user
+   * for a given protocol and chain combination.
+   *
+   * @param protocolId - The protocol UUID
+   * @param chainId - The chain ID
+   * @returns Currently selected pools and autoselect status
+   *
+   * @example
+   * ```typescript
+   * const selected = await sdk.getSelectedPools(
+   *   "protocol-uuid",
+   *   8453  // Base
+   * );
+   *
+   * console.log("Selected pools:", selected.pools);
+   * console.log("Autoselect enabled:", selected.autoselect);
+   * ```
+   */
+  async getSelectedPools(protocolId, chainId) {
+    try {
+      await this.authenticateUser();
+      const response = await this.httpClient.get(
+        ENDPOINTS.CUSTOMIZATION_SELECTED_POOLS(protocolId, chainId)
+      );
+      return response;
+    } catch (error) {
+      throw new Error(
+        `Failed to get selected pools: ${error.message}`
+      );
+    }
+  }
   /**
    * Check if a chain ID supports the Identity Registry
    */

package/dist/index.mjs

@@ -37,7 +37,11 @@ var ENDPOINTS = {
   // Best Opportunity
   BEST_OPPORTUNITY: (walletAddress, chainId) => `/data/best-opportunity?walletAddress=${walletAddress}&chainId=${chainId}`,
   // Agent Identity Registry
-  AGENT_TOKEN_URI: "/users/me/agent-token-uri"
+  AGENT_TOKEN_URI: "/users/me/agent-token-uri",
+  // Customization
+  CUSTOMIZE_BATCH: "/customization/customize-batch",
+  CUSTOMIZATION_POOLS: (protocolId, strategy) => `/customization/pools?protocolId=${protocolId}${strategy ? `&strategy=${strategy}` : ""}`,
+  CUSTOMIZATION_SELECTED_POOLS: (protocolId, chainId) => `/customization/selected-pools?protocolId=${protocolId}&chainId=${chainId}`
 };
 var DATA_ENDPOINTS = {
   // User Initialization
@@ -772,7 +776,17 @@ var _ZyfaiSDK = class _ZyfaiSDK {
         userId: response.userId || response.id,
         smartWallet: response.smartWallet,
         chains: response.chains,
-        strategy: response.strategy
+        strategy: response.strategy,
+        protocols: response.protocols,
+        autoSelectProtocols: response.autoSelectProtocols,
+        omniAccount: response.omniAccount,
+        autocompounding: response.autocompounding,
+        agentName: response.agentName,
+        crosschainStrategy: response.crosschainStrategy,
+        executorProxy: response.executorProxy,
+        splitting: response.splitting,
+        minSplits: response.minSplits,
+        customization: response.customization
       };
     } catch (error) {
       throw new Error(
@@ -1728,8 +1742,10 @@ var _ZyfaiSDK = class _ZyfaiSDK {
           crosschainStrategy: convertedResponse.crosschainStrategy,
           agentName: convertedResponse.agentName,
           customization: convertedResponse.customization,
+          executorProxy: convertedResponse.executorProxy,
           splitting: convertedResponse.splitting,
-          minSplits: convertedResponse.minSplits
+          minSplits: convertedResponse.minSplits,
+          registered: convertedResponse.registered
         }
       };
     } catch (error) {
@@ -2561,6 +2577,134 @@ var _ZyfaiSDK = class _ZyfaiSDK {
       );
     }
   }
+  // ============================================================================
+  // Protocol/Pool Customization
+  // ============================================================================
+  /**
+   * Configure protocol and pool customizations in batch.
+   *
+   * Allows granular control over which pools to use for each protocol on each chain.
+   * This is useful for advanced users who want to target specific pools with desired APY/risk profiles.
+   *
+   * @param customizations - Array of customization configurations
+   * @returns Response indicating success
+   *
+   * @example
+   * ```typescript
+   * // Configure multiple protocols across different chains
+   * await sdk.customizeBatch([
+   *   {
+   *     protocolId: "protocol-uuid-1",
+   *     pools: ["USDC Pool", "WETH Pool"],
+   *     chainId: 8453,  // Base
+   *     autoselect: false
+   *   },
+   *   {
+   *     protocolId: "protocol-uuid-1",
+   *     pools: ["USDC Vault"],
+   *     chainId: 42161,  // Arbitrum
+   *     autoselect: false
+   *   },
+   *   {
+   *     protocolId: "protocol-uuid-2",
+   *     pools: [],  // Empty array when autoselect is true
+   *     chainId: 8453,
+   *     autoselect: true  // Let engine auto-select best pools
+   *   }
+   * ]);
+   * ```
+   */
+  async customizeBatch(customizations) {
+    try {
+      await this.authenticateUser();
+      const response = await this.httpClient.post(
+        ENDPOINTS.CUSTOMIZE_BATCH,
+        customizations
+      );
+      return response;
+    } catch (error) {
+      throw new Error(
+        `Failed to save customizations: ${error.message}`
+      );
+    }
+  }
+  /**
+   * Get available pools for a protocol.
+   *
+   * Returns the list of pools available for a given protocol, optionally filtered by strategy.
+   *
+   * @param protocolId - The protocol UUID
+   * @param strategy - Optional strategy filter ("conservative" or "aggressive")
+   * @returns List of available pool names
+   *
+   * @example
+   * ```typescript
+   * // Get all available pools for a protocol
+   * const pools = await sdk.getAvailablePools("protocol-uuid");
+   * console.log("Available pools:", pools.pools);
+   *
+   * // Get pools for conservative strategy only
+   * const conservativePools = await sdk.getAvailablePools(
+   *   "protocol-uuid",
+   *   "conservative"
+   * );
+   * ```
+   */
+  async getAvailablePools(protocolId, strategy) {
+    try {
+      let internalStrategy;
+      if (strategy) {
+        if (!isValidPublicStrategy(strategy)) {
+          throw new Error(
+            `Invalid strategy: ${strategy}. Must be "conservative" or "aggressive".`
+          );
+        }
+        internalStrategy = toInternalStrategy(strategy);
+      }
+      const response = await this.httpClient.get(
+        ENDPOINTS.CUSTOMIZATION_POOLS(protocolId, internalStrategy)
+      );
+      return response;
+    } catch (error) {
+      throw new Error(
+        `Failed to get available pools: ${error.message}`
+      );
+    }
+  }
+  /**
+   * Get currently selected pools for a protocol on a specific chain.
+   *
+   * Returns the pools that are currently configured for the authenticated user
+   * for a given protocol and chain combination.
+   *
+   * @param protocolId - The protocol UUID
+   * @param chainId - The chain ID
+   * @returns Currently selected pools and autoselect status
+   *
+   * @example
+   * ```typescript
+   * const selected = await sdk.getSelectedPools(
+   *   "protocol-uuid",
+   *   8453  // Base
+   * );
+   *
+   * console.log("Selected pools:", selected.pools);
+   * console.log("Autoselect enabled:", selected.autoselect);
+   * ```
+   */
+  async getSelectedPools(protocolId, chainId) {
+    try {
+      await this.authenticateUser();
+      const response = await this.httpClient.get(
+        ENDPOINTS.CUSTOMIZATION_SELECTED_POOLS(protocolId, chainId)
+      );
+      return response;
+    } catch (error) {
+      throw new Error(
+        `Failed to get selected pools: ${error.message}`
+      );
+    }
+  }
   /**
    * Check if a chain ID supports the Identity Registry
    */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zyfai/sdk",
-  "version": "0.2.11",
+  "version": "0.2.13",
   "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",