@zyfai/sdk 0.2.10 → 0.2.12

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,7 +753,8 @@ 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
+11. **`update-profile-with-protocols.ts`** - Configure user profile with protocols, chains, and advanced features
+12. **`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

package/dist/index.d.mts

@@ -28,9 +28,14 @@ interface UpdateUserProfileRequest {
     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 +44,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 +158,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;
@@ -996,6 +1013,51 @@ declare class ZyfaiSDK {
      * ```
      */
     getAggressiveOpportunities(chainId?: number): Promise<OpportunitiesResponse>;
+    /**
+     * Get active conservative opportunities (status = "live") with risk and utilization data
+     * Returns pool info, liquidity depth (true if > 1M), utilization rate, stability metrics, avg APY, and collateral
+     *
+     * @param chainId - Optional chain ID filter
+     * @returns Active conservative opportunities with risk data
+     *
+     * @example
+     * ```typescript
+     * const opps = await sdk.getActiveConservativeOppsRisk(8453);
+     * console.log(JSON.stringify(opps, null, 2));
+     * ```
+     */
+    getActiveConservativeOppsRisk(chainId?: number): Promise<any>;
+    /**
+     * Get active aggressive opportunities (status = "live") with risk and utilization data
+     * Returns pool info, liquidity depth (true if > 1M), utilization rate, stability metrics, avg APY, and collateral
+     *
+     * @param chainId - Optional chain ID filter
+     * @returns Active aggressive opportunities with risk data
+     *
+     * @example
+     * ```typescript
+     * const opps = await sdk.getActiveAggressiveOppsRisk(8453);
+     * console.log(JSON.stringify(opps, null, 2));
+     * ```
+     */
+    getActiveAggressiveOppsRisk(chainId?: number): Promise<any>;
+    /**
+     * Get conservative pool status with derived health, risk, APY trend, and yield consistency
+     * Builds on getActiveConservativeOppsRisk and computes higher-level status indicators
+     *
+     * @param chainId - Optional chain ID filter
+     * @returns Conservative pools with status data
+     */
+    getConservativePoolStatus(chainId?: number): Promise<any>;
+    /**
+     * Get aggressive pool status with derived health, risk, APY trend, and yield consistency
+     * Builds on getActiveAggressiveOppsRisk and computes higher-level status indicators
+     *
+     * @param chainId - Optional chain ID filter
+     * @returns Aggressive pools with status data
+     */
+    getAggressivePoolStatus(chainId?: number): Promise<any>;
+    private derivePoolStatus;
     /**
      * Get daily APY history with weighted average for a wallet
      *

package/dist/index.d.ts

@@ -28,9 +28,14 @@ interface UpdateUserProfileRequest {
     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 +44,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 +158,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;
@@ -996,6 +1013,51 @@ declare class ZyfaiSDK {
      * ```
      */
     getAggressiveOpportunities(chainId?: number): Promise<OpportunitiesResponse>;
+    /**
+     * Get active conservative opportunities (status = "live") with risk and utilization data
+     * Returns pool info, liquidity depth (true if > 1M), utilization rate, stability metrics, avg APY, and collateral
+     *
+     * @param chainId - Optional chain ID filter
+     * @returns Active conservative opportunities with risk data
+     *
+     * @example
+     * ```typescript
+     * const opps = await sdk.getActiveConservativeOppsRisk(8453);
+     * console.log(JSON.stringify(opps, null, 2));
+     * ```
+     */
+    getActiveConservativeOppsRisk(chainId?: number): Promise<any>;
+    /**
+     * Get active aggressive opportunities (status = "live") with risk and utilization data
+     * Returns pool info, liquidity depth (true if > 1M), utilization rate, stability metrics, avg APY, and collateral
+     *
+     * @param chainId - Optional chain ID filter
+     * @returns Active aggressive opportunities with risk data
+     *
+     * @example
+     * ```typescript
+     * const opps = await sdk.getActiveAggressiveOppsRisk(8453);
+     * console.log(JSON.stringify(opps, null, 2));
+     * ```
+     */
+    getActiveAggressiveOppsRisk(chainId?: number): Promise<any>;
+    /**
+     * Get conservative pool status with derived health, risk, APY trend, and yield consistency
+     * Builds on getActiveConservativeOppsRisk and computes higher-level status indicators
+     *
+     * @param chainId - Optional chain ID filter
+     * @returns Conservative pools with status data
+     */
+    getConservativePoolStatus(chainId?: number): Promise<any>;
+    /**
+     * Get aggressive pool status with derived health, risk, APY trend, and yield consistency
+     * Builds on getActiveAggressiveOppsRisk and computes higher-level status indicators
+     *
+     * @param chainId - Optional chain ID filter
+     * @returns Aggressive pools with status data
+     */
+    getAggressivePoolStatus(chainId?: number): Promise<any>;
+    private derivePoolStatus;
     /**
      * Get daily APY history with weighted average for a wallet
      *

package/dist/index.js

@@ -794,7 +794,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 +1760,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) {
@@ -2249,6 +2261,156 @@ var _ZyfaiSDK = class _ZyfaiSDK {
       );
     }
   }
+  /**
+   * Get active conservative opportunities (status = "live") with risk and utilization data
+   * Returns pool info, liquidity depth (true if > 1M), utilization rate, stability metrics, avg APY, and collateral
+   *
+   * @param chainId - Optional chain ID filter
+   * @returns Active conservative opportunities with risk data
+   *
+   * @example
+   * ```typescript
+   * const opps = await sdk.getActiveConservativeOppsRisk(8453);
+   * console.log(JSON.stringify(opps, null, 2));
+   * ```
+   */
+  async getActiveConservativeOppsRisk(chainId) {
+    try {
+      const response = await this.httpClient.dataGet(
+        DATA_ENDPOINTS.OPPORTUNITIES_SAFE(chainId)
+      );
+      const data = response.data || response || [];
+      const active = Array.isArray(data) ? data.filter((o) => o.status === "live").map((o) => {
+        const tvl = o.tvl || 0;
+        const liquidity = o.liquidity || 0;
+        const utilizationRate = tvl > 0 ? (tvl - liquidity) / tvl : 0;
+        return {
+          poolName: o.pool_name,
+          protocolName: o.protocol_name,
+          chainId: o.chain_id,
+          liquidityDepth: liquidity > 1e7 ? "deep" : liquidity > 1e6 ? "moderate" : "shallow",
+          utilizationRate: Math.round(utilizationRate * 1e4) / 100,
+          tvlStability: o.isTvlStable ?? null,
+          apyStability: o.isApyStable30Days ?? null,
+          tvlApyCombinedRisk: o.isApyTvlStable ?? null,
+          avgCombinedApy7d: o.averageCombinedApy7Days ?? null,
+          avgCombinedApy15d: o.averageCombinedApy15Days ?? null,
+          avgCombinedApy30d: o.averageCombinedApy30Days ?? null,
+          collateralSymbols: o.collateral_symbols || []
+        };
+      }) : [];
+      return active;
+    } catch (error) {
+      throw new Error(
+        `Failed to get active conservative opportunities risk: ${error.message}`
+      );
+    }
+  }
+  /**
+   * Get active aggressive opportunities (status = "live") with risk and utilization data
+   * Returns pool info, liquidity depth (true if > 1M), utilization rate, stability metrics, avg APY, and collateral
+   *
+   * @param chainId - Optional chain ID filter
+   * @returns Active aggressive opportunities with risk data
+   *
+   * @example
+   * ```typescript
+   * const opps = await sdk.getActiveAggressiveOppsRisk(8453);
+   * console.log(JSON.stringify(opps, null, 2));
+   * ```
+   */
+  async getActiveAggressiveOppsRisk(chainId) {
+    try {
+      const response = await this.httpClient.dataGet(
+        DATA_ENDPOINTS.OPPORTUNITIES_DEGEN(chainId)
+      );
+      const data = response.data || response || [];
+      const active = Array.isArray(data) ? data.filter((o) => o.status === "live").map((o) => {
+        const tvl = o.tvl || 0;
+        const liquidity = o.liquidity || 0;
+        const utilizationRate = tvl > 0 ? (tvl - liquidity) / tvl : 0;
+        return {
+          poolName: o.pool_name,
+          protocolName: o.protocol_name,
+          chainId: o.chain_id,
+          liquidityDepth: liquidity > 1e7 ? "deep" : liquidity > 1e6 ? "moderate" : "shallow",
+          utilizationRate: Math.round(utilizationRate * 1e4) / 100,
+          tvlStability: o.isTvlStable ?? null,
+          apyStability: o.isApyStable30Days ?? null,
+          tvlApyCombinedRisk: o.isApyTvlStable ?? null,
+          avgCombinedApy7d: o.averageCombinedApy7Days ?? null,
+          avgCombinedApy15d: o.averageCombinedApy15Days ?? null,
+          avgCombinedApy30d: o.averageCombinedApy30Days ?? null,
+          collateralSymbols: o.collateral_symbols || []
+        };
+      }) : [];
+      return active;
+    } catch (error) {
+      throw new Error(
+        `Failed to get active aggressive opportunities risk: ${error.message}`
+      );
+    }
+  }
+  /**
+   * Get conservative pool status with derived health, risk, APY trend, and yield consistency
+   * Builds on getActiveConservativeOppsRisk and computes higher-level status indicators
+   *
+   * @param chainId - Optional chain ID filter
+   * @returns Conservative pools with status data
+   */
+  async getConservativePoolStatus(chainId) {
+    const pools = await this.getActiveConservativeOppsRisk(chainId);
+    return pools.map((p) => this.derivePoolStatus(p));
+  }
+  /**
+   * Get aggressive pool status with derived health, risk, APY trend, and yield consistency
+   * Builds on getActiveAggressiveOppsRisk and computes higher-level status indicators
+   *
+   * @param chainId - Optional chain ID filter
+   * @returns Aggressive pools with status data
+   */
+  async getAggressivePoolStatus(chainId) {
+    const pools = await this.getActiveAggressiveOppsRisk(chainId);
+    return pools.map((p) => this.derivePoolStatus(p));
+  }
+  derivePoolStatus(p) {
+    let riskSignals = 0;
+    if (p.tvlStability === false) riskSignals++;
+    if (p.apyStability === false) riskSignals++;
+    if (p.tvlApyCombinedRisk === false) riskSignals++;
+    if (p.liquidityDepth === "shallow") riskSignals++;
+    if (p.utilizationRate > 90) riskSignals++;
+    const riskLevel = riskSignals >= 3 ? "high" : riskSignals >= 1 ? "medium" : "low";
+    const stabilityScore = (p.tvlStability === true ? 1 : 0) + (p.apyStability === true ? 1 : 0) + (p.tvlApyCombinedRisk === true ? 1 : 0);
+    const liquidityBonus = p.liquidityDepth === "deep" ? 1 : p.liquidityDepth === "moderate" ? 0.5 : 0;
+    const healthTotal = stabilityScore + liquidityBonus;
+    const healthScore = healthTotal >= 3 ? "healthy" : healthTotal >= 1.5 ? "moderate" : "risky";
+    const apy7d = p.avgCombinedApy7d;
+    const apy30d = p.avgCombinedApy30d;
+    let apyTrend = "stable";
+    if (apy7d != null && apy30d != null && apy30d !== 0) {
+      const change = (apy7d - apy30d) / apy30d;
+      if (change > 0.1) apyTrend = "rising";
+      else if (change < -0.1) apyTrend = "falling";
+    }
+    let yieldConsistency = "consistent";
+    if (apy7d != null && apy30d != null && apy30d !== 0) {
+      const spread = Math.abs(apy7d - apy30d) / apy30d;
+      if (spread > 0.3) yieldConsistency = "volatile";
+      else if (spread > 0.1) yieldConsistency = "mixed";
+    }
+    return {
+      poolName: p.poolName,
+      protocolName: p.protocolName,
+      chainId: p.chainId,
+      healthScore,
+      riskLevel,
+      apyTrend,
+      yieldConsistency,
+      liquidityDepth: p.liquidityDepth,
+      avgCombinedApy7d: p.avgCombinedApy7d
+    };
+  }
   // ============================================================================
   // APY History Methods (Data API v2)
   // ============================================================================

package/dist/index.mjs

@@ -772,7 +772,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 +1738,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) {
@@ -2227,6 +2239,156 @@ var _ZyfaiSDK = class _ZyfaiSDK {
       );
     }
   }
+  /**
+   * Get active conservative opportunities (status = "live") with risk and utilization data
+   * Returns pool info, liquidity depth (true if > 1M), utilization rate, stability metrics, avg APY, and collateral
+   *
+   * @param chainId - Optional chain ID filter
+   * @returns Active conservative opportunities with risk data
+   *
+   * @example
+   * ```typescript
+   * const opps = await sdk.getActiveConservativeOppsRisk(8453);
+   * console.log(JSON.stringify(opps, null, 2));
+   * ```
+   */
+  async getActiveConservativeOppsRisk(chainId) {
+    try {
+      const response = await this.httpClient.dataGet(
+        DATA_ENDPOINTS.OPPORTUNITIES_SAFE(chainId)
+      );
+      const data = response.data || response || [];
+      const active = Array.isArray(data) ? data.filter((o) => o.status === "live").map((o) => {
+        const tvl = o.tvl || 0;
+        const liquidity = o.liquidity || 0;
+        const utilizationRate = tvl > 0 ? (tvl - liquidity) / tvl : 0;
+        return {
+          poolName: o.pool_name,
+          protocolName: o.protocol_name,
+          chainId: o.chain_id,
+          liquidityDepth: liquidity > 1e7 ? "deep" : liquidity > 1e6 ? "moderate" : "shallow",
+          utilizationRate: Math.round(utilizationRate * 1e4) / 100,
+          tvlStability: o.isTvlStable ?? null,
+          apyStability: o.isApyStable30Days ?? null,
+          tvlApyCombinedRisk: o.isApyTvlStable ?? null,
+          avgCombinedApy7d: o.averageCombinedApy7Days ?? null,
+          avgCombinedApy15d: o.averageCombinedApy15Days ?? null,
+          avgCombinedApy30d: o.averageCombinedApy30Days ?? null,
+          collateralSymbols: o.collateral_symbols || []
+        };
+      }) : [];
+      return active;
+    } catch (error) {
+      throw new Error(
+        `Failed to get active conservative opportunities risk: ${error.message}`
+      );
+    }
+  }
+  /**
+   * Get active aggressive opportunities (status = "live") with risk and utilization data
+   * Returns pool info, liquidity depth (true if > 1M), utilization rate, stability metrics, avg APY, and collateral
+   *
+   * @param chainId - Optional chain ID filter
+   * @returns Active aggressive opportunities with risk data
+   *
+   * @example
+   * ```typescript
+   * const opps = await sdk.getActiveAggressiveOppsRisk(8453);
+   * console.log(JSON.stringify(opps, null, 2));
+   * ```
+   */
+  async getActiveAggressiveOppsRisk(chainId) {
+    try {
+      const response = await this.httpClient.dataGet(
+        DATA_ENDPOINTS.OPPORTUNITIES_DEGEN(chainId)
+      );
+      const data = response.data || response || [];
+      const active = Array.isArray(data) ? data.filter((o) => o.status === "live").map((o) => {
+        const tvl = o.tvl || 0;
+        const liquidity = o.liquidity || 0;
+        const utilizationRate = tvl > 0 ? (tvl - liquidity) / tvl : 0;
+        return {
+          poolName: o.pool_name,
+          protocolName: o.protocol_name,
+          chainId: o.chain_id,
+          liquidityDepth: liquidity > 1e7 ? "deep" : liquidity > 1e6 ? "moderate" : "shallow",
+          utilizationRate: Math.round(utilizationRate * 1e4) / 100,
+          tvlStability: o.isTvlStable ?? null,
+          apyStability: o.isApyStable30Days ?? null,
+          tvlApyCombinedRisk: o.isApyTvlStable ?? null,
+          avgCombinedApy7d: o.averageCombinedApy7Days ?? null,
+          avgCombinedApy15d: o.averageCombinedApy15Days ?? null,
+          avgCombinedApy30d: o.averageCombinedApy30Days ?? null,
+          collateralSymbols: o.collateral_symbols || []
+        };
+      }) : [];
+      return active;
+    } catch (error) {
+      throw new Error(
+        `Failed to get active aggressive opportunities risk: ${error.message}`
+      );
+    }
+  }
+  /**
+   * Get conservative pool status with derived health, risk, APY trend, and yield consistency
+   * Builds on getActiveConservativeOppsRisk and computes higher-level status indicators
+   *
+   * @param chainId - Optional chain ID filter
+   * @returns Conservative pools with status data
+   */
+  async getConservativePoolStatus(chainId) {
+    const pools = await this.getActiveConservativeOppsRisk(chainId);
+    return pools.map((p) => this.derivePoolStatus(p));
+  }
+  /**
+   * Get aggressive pool status with derived health, risk, APY trend, and yield consistency
+   * Builds on getActiveAggressiveOppsRisk and computes higher-level status indicators
+   *
+   * @param chainId - Optional chain ID filter
+   * @returns Aggressive pools with status data
+   */
+  async getAggressivePoolStatus(chainId) {
+    const pools = await this.getActiveAggressiveOppsRisk(chainId);
+    return pools.map((p) => this.derivePoolStatus(p));
+  }
+  derivePoolStatus(p) {
+    let riskSignals = 0;
+    if (p.tvlStability === false) riskSignals++;
+    if (p.apyStability === false) riskSignals++;
+    if (p.tvlApyCombinedRisk === false) riskSignals++;
+    if (p.liquidityDepth === "shallow") riskSignals++;
+    if (p.utilizationRate > 90) riskSignals++;
+    const riskLevel = riskSignals >= 3 ? "high" : riskSignals >= 1 ? "medium" : "low";
+    const stabilityScore = (p.tvlStability === true ? 1 : 0) + (p.apyStability === true ? 1 : 0) + (p.tvlApyCombinedRisk === true ? 1 : 0);
+    const liquidityBonus = p.liquidityDepth === "deep" ? 1 : p.liquidityDepth === "moderate" ? 0.5 : 0;
+    const healthTotal = stabilityScore + liquidityBonus;
+    const healthScore = healthTotal >= 3 ? "healthy" : healthTotal >= 1.5 ? "moderate" : "risky";
+    const apy7d = p.avgCombinedApy7d;
+    const apy30d = p.avgCombinedApy30d;
+    let apyTrend = "stable";
+    if (apy7d != null && apy30d != null && apy30d !== 0) {
+      const change = (apy7d - apy30d) / apy30d;
+      if (change > 0.1) apyTrend = "rising";
+      else if (change < -0.1) apyTrend = "falling";
+    }
+    let yieldConsistency = "consistent";
+    if (apy7d != null && apy30d != null && apy30d !== 0) {
+      const spread = Math.abs(apy7d - apy30d) / apy30d;
+      if (spread > 0.3) yieldConsistency = "volatile";
+      else if (spread > 0.1) yieldConsistency = "mixed";
+    }
+    return {
+      poolName: p.poolName,
+      protocolName: p.protocolName,
+      chainId: p.chainId,
+      healthScore,
+      riskLevel,
+      apyTrend,
+      yieldConsistency,
+      liquidityDepth: p.liquidityDepth,
+      avgCombinedApy7d: p.avgCombinedApy7d
+    };
+  }
   // ============================================================================
   // APY History Methods (Data API v2)
   // ============================================================================

package/package.json

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