@zyfai/sdk 0.2.9 → 0.2.11

package/dist/index.d.mts

@@ -425,6 +425,12 @@ interface BestOpportunityResponse {
     };
     enabledChains?: number[];
 }
+interface RegisterAgentResponse {
+    success: boolean;
+    txHash: string;
+    chainId: number;
+    smartWallet: string;
+}
 interface PolicyData {
     policy: Address;
     initData: Hex;
@@ -990,6 +996,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
      *
@@ -1082,6 +1133,34 @@ declare class ZyfaiSDK {
      * ```
      */
     getBestOpportunity(walletAddress: Address, chainId: SupportedChainId): Promise<BestOpportunityResponse>;
+    /**
+     * Supported chain IDs for the Identity Registry (ERC-8004)
+     */
+    private static readonly IDENTITY_REGISTRY_CHAIN_IDS;
+    /**
+     * Check if a chain ID supports the Identity Registry
+     */
+    private isSupportedIdentityRegistryChain;
+    /**
+     * Register an agent on the Identity Registry (ERC-8004)
+     *
+     * Fetches a tokenUri from the Zyfai API for the given smart wallet,
+     * then calls `register(tokenUri)` on the Identity Registry contract.
+     *
+     * @param smartWallet - The smart wallet address to register as an agent
+     * @param chainId - Chain ID to register on (only Base 8453 and Arbitrum 42161 supported)
+     * @returns Response with transaction hash and registration details
+     *
+     * @example
+     * ```typescript
+     * const sdk = new ZyfaiSDK({ apiKey: "your-api-key" });
+     * await sdk.connectAccount(privateKey, 8453);
+     *
+     * const result = await sdk.registerAgentOnIdentityRegistry("0xSmartWallet", 8453);
+     * console.log("Tx hash:", result.txHash);
+     * ```
+     */
+    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 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, 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 };

package/dist/index.d.ts

@@ -425,6 +425,12 @@ interface BestOpportunityResponse {
     };
     enabledChains?: number[];
 }
+interface RegisterAgentResponse {
+    success: boolean;
+    txHash: string;
+    chainId: number;
+    smartWallet: string;
+}
 interface PolicyData {
     policy: Address;
     initData: Hex;
@@ -990,6 +996,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
      *
@@ -1082,6 +1133,34 @@ declare class ZyfaiSDK {
      * ```
      */
     getBestOpportunity(walletAddress: Address, chainId: SupportedChainId): Promise<BestOpportunityResponse>;
+    /**
+     * Supported chain IDs for the Identity Registry (ERC-8004)
+     */
+    private static readonly IDENTITY_REGISTRY_CHAIN_IDS;
+    /**
+     * Check if a chain ID supports the Identity Registry
+     */
+    private isSupportedIdentityRegistryChain;
+    /**
+     * Register an agent on the Identity Registry (ERC-8004)
+     *
+     * Fetches a tokenUri from the Zyfai API for the given smart wallet,
+     * then calls `register(tokenUri)` on the Identity Registry contract.
+     *
+     * @param smartWallet - The smart wallet address to register as an agent
+     * @param chainId - Chain ID to register on (only Base 8453 and Arbitrum 42161 supported)
+     * @returns Response with transaction hash and registration details
+     *
+     * @example
+     * ```typescript
+     * const sdk = new ZyfaiSDK({ apiKey: "your-api-key" });
+     * await sdk.connectAccount(privateKey, 8453);
+     *
+     * const result = await sdk.registerAgentOnIdentityRegistry("0xSmartWallet", 8453);
+     * console.log("Tx hash:", result.txHash);
+     * ```
+     */
+    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 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, 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 };

package/dist/index.js

@@ -76,7 +76,9 @@ var ENDPOINTS = {
   SDK_ALLOWED_WALLETS: "/data/sdk-allowed-wallets",
   SDK_TVL: "/data/sdk-tvl",
   // Best Opportunity
-  BEST_OPPORTUNITY: (walletAddress, chainId) => `/data/best-opportunity?walletAddress=${walletAddress}&chainId=${chainId}`
+  BEST_OPPORTUNITY: (walletAddress, chainId) => `/data/best-opportunity?walletAddress=${walletAddress}&chainId=${chainId}`,
+  // Agent Identity Registry
+  AGENT_TOKEN_URI: "/users/me/agent-token-uri"
 };
 var DATA_ENDPOINTS = {
   // User Initialization
@@ -288,6 +290,7 @@ var HttpClient = class {
 };
 
 // src/config/abis.ts
+var import_viem = require("viem");
 var ERC20_ABI = [
   {
     name: "transfer",
@@ -355,16 +358,22 @@ var ERC20_ABI = [
     outputs: [{ name: "", type: "uint256" }]
   }
 ];
+var IDENTITY_REGISTRY_ABI = (0, import_viem.parseAbi)([
+  "function register() external returns (uint256 agentId)",
+  "function register(string tokenUri) external returns (uint256 agentId)",
+  "function register(string tokenUri, (string key, bytes value)[] metadata) external returns (uint256 agentId)"
+]);
+var IDENTITY_REGISTRY_ADDRESS = "0x8004A169FB4a3325136EB29fA0ceB6D2e539a432";
 
 // src/core/ZyfaiSDK.ts
 var import_accounts2 = require("viem/accounts");
-var import_viem4 = require("viem");
+var import_viem5 = require("viem");
 
 // src/config/chains.ts
-var import_viem = require("viem");
-var import_chains = require("viem/chains");
 var import_viem2 = require("viem");
-var plasma = (0, import_viem2.defineChain)({
+var import_chains = require("viem/chains");
+var import_viem3 = require("viem");
+var plasma = (0, import_viem3.defineChain)({
   id: 9745,
   name: "Plasma",
   nativeCurrency: {
@@ -417,9 +426,9 @@ var getChainConfig = (chainId, rpcUrls) => {
     throw new Error(`Unsupported chain ID: ${chainId}`);
   }
   const rpcUrl = rpcUrls && rpcUrls[chainId] || DEFAULT_RPC_URLS[chainId];
-  const publicClient = (0, import_viem.createPublicClient)({
+  const publicClient = (0, import_viem2.createPublicClient)({
     chain,
-    transport: (0, import_viem.http)(rpcUrl)
+    transport: (0, import_viem2.http)(rpcUrl)
   });
   return {
     chain,
@@ -437,7 +446,7 @@ var getSupportedChainIds = () => {
 // src/utils/safe-account.ts
 var import_module_sdk = require("@rhinestone/module-sdk");
 var import_accounts = require("permissionless/accounts");
-var import_viem3 = require("viem");
+var import_viem4 = require("viem");
 var import_account_abstraction = require("viem/account-abstraction");
 var SAFE_7579_ADDRESS = "0x7579EE8307284F293B1927136486880611F20002";
 var ERC7579_LAUNCHPAD_ADDRESS = "0x7579011aB74c46090561ea277Ba79D510c6C00ff";
@@ -447,12 +456,12 @@ var getSafeAccount = async (config) => {
   if (!safeOwnerAddress) {
     throw new Error("Safe owner address is required");
   }
-  const formattedOwnerAddress = (0, import_viem3.getAddress)(safeOwnerAddress);
+  const formattedOwnerAddress = (0, import_viem4.getAddress)(safeOwnerAddress);
   const ownableValidator = (0, import_module_sdk.getOwnableValidator)({
     owners: [formattedOwnerAddress],
     threshold: 1
   });
-  const saltHex = (0, import_viem3.fromHex)((0, import_viem3.toHex)(ACCOUNT_SALT), "bigint");
+  const saltHex = (0, import_viem4.fromHex)((0, import_viem4.toHex)(ACCOUNT_SALT), "bigint");
   const tempOwner = {
     address: formattedOwnerAddress,
     type: "json-rpc"
@@ -663,7 +672,7 @@ function convertStrategiesToPublic(array) {
 
 // src/core/ZyfaiSDK.ts
 var import_siwe = require("siwe");
-var ZyfaiSDK = class {
+var _ZyfaiSDK = class _ZyfaiSDK {
   constructor(config) {
     this.signer = null;
     this.walletClient = null;
@@ -692,7 +701,7 @@ var ZyfaiSDK = class {
         return;
       }
       const walletClient = this.getWalletClient();
-      const userAddress = (0, import_viem4.getAddress)(walletClient.account.address);
+      const userAddress = (0, import_viem5.getAddress)(walletClient.account.address);
       const chainId = this.currentChainId || walletClient.chain?.id || 8453;
       const challengeResponse = await this.httpClient.post(ENDPOINTS.AUTH_CHALLENGE, {});
       let uri;
@@ -971,10 +980,10 @@ var ZyfaiSDK = class {
         this.walletClient.chain?.id || 8453,
         this.rpcUrls
       );
-      this.walletClient = (0, import_viem4.createWalletClient)({
+      this.walletClient = (0, import_viem5.createWalletClient)({
         account: newAddress,
         chain: chainConfig.chain,
-        transport: (0, import_viem4.custom)(this.currentProvider)
+        transport: (0, import_viem5.custom)(this.currentProvider)
       });
       this.currentChainId = this.walletClient.chain?.id || null;
       try {
@@ -1026,10 +1035,10 @@ var ZyfaiSDK = class {
       }
       this.signer = (0, import_accounts2.privateKeyToAccount)(privateKey);
       this.currentChainId = chainId;
-      this.walletClient = (0, import_viem4.createWalletClient)({
+      this.walletClient = (0, import_viem5.createWalletClient)({
         account: this.signer,
         chain: chainConfig.chain,
-        transport: (0, import_viem4.http)(chainConfig.rpcUrl)
+        transport: (0, import_viem5.http)(chainConfig.rpcUrl)
       });
       connectedAddress = this.signer.address;
       this.currentProvider = null;
@@ -1047,10 +1056,10 @@ var ZyfaiSDK = class {
         if (!accounts || accounts.length === 0) {
           throw new Error("No accounts found in wallet provider");
         }
-        this.walletClient = (0, import_viem4.createWalletClient)({
+        this.walletClient = (0, import_viem5.createWalletClient)({
           account: accounts[0],
           chain: chainConfig.chain,
-          transport: (0, import_viem4.custom)(provider)
+          transport: (0, import_viem5.custom)(provider)
         });
         connectedAddress = accounts[0];
         this.currentProvider = provider;
@@ -1059,7 +1068,7 @@ var ZyfaiSDK = class {
           provider.on("accountsChanged", this.handleAccountsChanged.bind(this));
         }
       } else if (provider.account && provider.transport) {
-        this.walletClient = (0, import_viem4.createWalletClient)({
+        this.walletClient = (0, import_viem5.createWalletClient)({
           account: provider.account,
           chain: chainConfig.chain,
           transport: provider.transport
@@ -1112,10 +1121,10 @@ var ZyfaiSDK = class {
         targetChainId,
         this.rpcUrls
       );
-      return (0, import_viem4.createWalletClient)({
+      return (0, import_viem5.createWalletClient)({
         account: this.signer,
         chain: targetChainConfig.chain,
-        transport: (0, import_viem4.http)(targetChainConfig.rpcUrl)
+        transport: (0, import_viem5.http)(targetChainConfig.rpcUrl)
       });
     } else {
       if (!this.walletClient) {
@@ -2240,6 +2249,156 @@ var ZyfaiSDK = class {
       );
     }
   }
+  /**
+   * 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)
   // ============================================================================
@@ -2424,7 +2583,88 @@ var ZyfaiSDK = class {
       );
     }
   }
+  /**
+   * Check if a chain ID supports the Identity Registry
+   */
+  isSupportedIdentityRegistryChain(chainId) {
+    return _ZyfaiSDK.IDENTITY_REGISTRY_CHAIN_IDS.includes(chainId);
+  }
+  /**
+   * Register an agent on the Identity Registry (ERC-8004)
+   *
+   * Fetches a tokenUri from the Zyfai API for the given smart wallet,
+   * then calls `register(tokenUri)` on the Identity Registry contract.
+   *
+   * @param smartWallet - The smart wallet address to register as an agent
+   * @param chainId - Chain ID to register on (only Base 8453 and Arbitrum 42161 supported)
+   * @returns Response with transaction hash and registration details
+   *
+   * @example
+   * ```typescript
+   * const sdk = new ZyfaiSDK({ apiKey: "your-api-key" });
+   * await sdk.connectAccount(privateKey, 8453);
+   *
+   * const result = await sdk.registerAgentOnIdentityRegistry("0xSmartWallet", 8453);
+   * console.log("Tx hash:", result.txHash);
+   * ```
+   */
+  async registerAgentOnIdentityRegistry(smartWallet, chainId) {
+    if (!smartWallet) {
+      throw new Error("Smart wallet address is required");
+    }
+    if (!this.isSupportedIdentityRegistryChain(chainId)) {
+      throw new Error(
+        `Chain ${chainId} is not supported for Identity Registry. Supported chains: Base (8453), Arbitrum (42161)`
+      );
+    }
+    try {
+      const tokenUriResponse = await this.httpClient.post(
+        ENDPOINTS.AGENT_TOKEN_URI,
+        { smartWallet }
+      );
+      if (!tokenUriResponse.tokenUri) {
+        throw new Error("API did not return a tokenUri");
+      }
+      const callData = (0, import_viem5.encodeFunctionData)({
+        abi: IDENTITY_REGISTRY_ABI,
+        functionName: "register",
+        args: [tokenUriResponse.tokenUri]
+      });
+      const walletClient = this.getWalletClient(chainId);
+      const chainConfig = getChainConfig(chainId, this.rpcUrls);
+      const txHash = await walletClient.sendTransaction({
+        to: IDENTITY_REGISTRY_ADDRESS,
+        data: callData,
+        chain: chainConfig.chain,
+        account: walletClient.account
+      });
+      const receipt = await chainConfig.publicClient.waitForTransactionReceipt({
+        hash: txHash
+      });
+      if (receipt.status !== "success") {
+        throw new Error("Identity Registry registration transaction failed");
+      }
+      return {
+        success: true,
+        txHash,
+        chainId,
+        smartWallet
+      };
+    } catch (error) {
+      throw new Error(
+        `Failed to register agent on Identity Registry: ${error.message}`
+      );
+    }
+  }
 };
+// ============================================================================
+// Agent Identity Registry
+// ============================================================================
+/**
+ * Supported chain IDs for the Identity Registry (ERC-8004)
+ */
+_ZyfaiSDK.IDENTITY_REGISTRY_CHAIN_IDS = [8453, 42161];
+var ZyfaiSDK = _ZyfaiSDK;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   DEFAULT_TOKEN_ADDRESSES,

package/dist/index.mjs

@@ -35,7 +35,9 @@ var ENDPOINTS = {
   SDK_ALLOWED_WALLETS: "/data/sdk-allowed-wallets",
   SDK_TVL: "/data/sdk-tvl",
   // Best Opportunity
-  BEST_OPPORTUNITY: (walletAddress, chainId) => `/data/best-opportunity?walletAddress=${walletAddress}&chainId=${chainId}`
+  BEST_OPPORTUNITY: (walletAddress, chainId) => `/data/best-opportunity?walletAddress=${walletAddress}&chainId=${chainId}`,
+  // Agent Identity Registry
+  AGENT_TOKEN_URI: "/users/me/agent-token-uri"
 };
 var DATA_ENDPOINTS = {
   // User Initialization
@@ -247,6 +249,7 @@ var HttpClient = class {
 };
 
 // src/config/abis.ts
+import { parseAbi } from "viem";
 var ERC20_ABI = [
   {
     name: "transfer",
@@ -314,6 +317,12 @@ var ERC20_ABI = [
     outputs: [{ name: "", type: "uint256" }]
   }
 ];
+var IDENTITY_REGISTRY_ABI = parseAbi([
+  "function register() external returns (uint256 agentId)",
+  "function register(string tokenUri) external returns (uint256 agentId)",
+  "function register(string tokenUri, (string key, bytes value)[] metadata) external returns (uint256 agentId)"
+]);
+var IDENTITY_REGISTRY_ADDRESS = "0x8004A169FB4a3325136EB29fA0ceB6D2e539a432";
 
 // src/core/ZyfaiSDK.ts
 import { privateKeyToAccount } from "viem/accounts";
@@ -321,7 +330,8 @@ import {
   createWalletClient,
   custom,
   http as http2,
-  getAddress as getAddress2
+  getAddress as getAddress2,
+  encodeFunctionData
 } from "viem";
 
 // src/config/chains.ts
@@ -640,7 +650,7 @@ function convertStrategiesToPublic(array) {
 
 // src/core/ZyfaiSDK.ts
 import { SiweMessage } from "siwe";
-var ZyfaiSDK = class {
+var _ZyfaiSDK = class _ZyfaiSDK {
   constructor(config) {
     this.signer = null;
     this.walletClient = null;
@@ -2217,6 +2227,156 @@ var ZyfaiSDK = class {
       );
     }
   }
+  /**
+   * 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)
   // ============================================================================
@@ -2401,7 +2561,88 @@ var ZyfaiSDK = class {
       );
     }
   }
+  /**
+   * Check if a chain ID supports the Identity Registry
+   */
+  isSupportedIdentityRegistryChain(chainId) {
+    return _ZyfaiSDK.IDENTITY_REGISTRY_CHAIN_IDS.includes(chainId);
+  }
+  /**
+   * Register an agent on the Identity Registry (ERC-8004)
+   *
+   * Fetches a tokenUri from the Zyfai API for the given smart wallet,
+   * then calls `register(tokenUri)` on the Identity Registry contract.
+   *
+   * @param smartWallet - The smart wallet address to register as an agent
+   * @param chainId - Chain ID to register on (only Base 8453 and Arbitrum 42161 supported)
+   * @returns Response with transaction hash and registration details
+   *
+   * @example
+   * ```typescript
+   * const sdk = new ZyfaiSDK({ apiKey: "your-api-key" });
+   * await sdk.connectAccount(privateKey, 8453);
+   *
+   * const result = await sdk.registerAgentOnIdentityRegistry("0xSmartWallet", 8453);
+   * console.log("Tx hash:", result.txHash);
+   * ```
+   */
+  async registerAgentOnIdentityRegistry(smartWallet, chainId) {
+    if (!smartWallet) {
+      throw new Error("Smart wallet address is required");
+    }
+    if (!this.isSupportedIdentityRegistryChain(chainId)) {
+      throw new Error(
+        `Chain ${chainId} is not supported for Identity Registry. Supported chains: Base (8453), Arbitrum (42161)`
+      );
+    }
+    try {
+      const tokenUriResponse = await this.httpClient.post(
+        ENDPOINTS.AGENT_TOKEN_URI,
+        { smartWallet }
+      );
+      if (!tokenUriResponse.tokenUri) {
+        throw new Error("API did not return a tokenUri");
+      }
+      const callData = encodeFunctionData({
+        abi: IDENTITY_REGISTRY_ABI,
+        functionName: "register",
+        args: [tokenUriResponse.tokenUri]
+      });
+      const walletClient = this.getWalletClient(chainId);
+      const chainConfig = getChainConfig(chainId, this.rpcUrls);
+      const txHash = await walletClient.sendTransaction({
+        to: IDENTITY_REGISTRY_ADDRESS,
+        data: callData,
+        chain: chainConfig.chain,
+        account: walletClient.account
+      });
+      const receipt = await chainConfig.publicClient.waitForTransactionReceipt({
+        hash: txHash
+      });
+      if (receipt.status !== "success") {
+        throw new Error("Identity Registry registration transaction failed");
+      }
+      return {
+        success: true,
+        txHash,
+        chainId,
+        smartWallet
+      };
+    } catch (error) {
+      throw new Error(
+        `Failed to register agent on Identity Registry: ${error.message}`
+      );
+    }
+  }
 };
+// ============================================================================
+// Agent Identity Registry
+// ============================================================================
+/**
+ * Supported chain IDs for the Identity Registry (ERC-8004)
+ */
+_ZyfaiSDK.IDENTITY_REGISTRY_CHAIN_IDS = [8453, 42161];
+var ZyfaiSDK = _ZyfaiSDK;
 export {
   DEFAULT_TOKEN_ADDRESSES,
   ZyfaiSDK,

package/package.json

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