@strkfarm/sdk 1.1.22 → 1.1.24

package/dist/index.mjs

@@ -15288,6 +15288,17 @@ var erc4626_abi_default = [
   }
 ];
 
+// src/strategies/ekubo-cl-vault.tsx
+import { gql } from "@apollo/client";
+
+// src/modules/apollo-client.ts
+import { ApolloClient, InMemoryCache } from "@apollo/client";
+var apolloClient = new ApolloClient({
+  uri: "https://api.troves.fi/",
+  cache: new InMemoryCache()
+});
+var apollo_client_default = apolloClient;
+
 // src/strategies/ekubo-cl-vault.tsx
 import { Fragment as Fragment2, jsx as jsx3, jsxs as jsxs2 } from "react/jsx-runtime";
 var EkuboCLVault = class _EkuboCLVault extends BaseStrategy {
@@ -15445,11 +15456,75 @@ var EkuboCLVault = class _EkuboCLVault extends BaseStrategy {
   handleFeesCall() {
     return [this.contract.populate("handle_fees", [])];
   }
-  /**
-   * Calculates assets before and now in a given token of TVL per share to observe growth
-   * @returns {Promise<number>} The weighted average APY across all pools
-   */
-  async netAPY(blockIdentifier = "latest", sinceBlocks = 6e5) {
+  async getFeeHistory(timePeriod = "24h") {
+    const { data } = await apollo_client_default.query({
+      query: gql`
+        query ContractFeeEarnings(
+          $timeframe: String!
+          $contract: String!
+        ) {
+          contractFeeEarnings(timeframe: $timeframe, contract: $contract) {
+            contract
+            dailyEarnings {
+              date
+              tokenAddress
+              amount
+            }
+            totalCollections
+          }
+        }
+      `,
+      variables: {
+        timeframe: timePeriod,
+        contract: this.address.address
+      },
+      fetchPolicy: "no-cache"
+    });
+    const poolKey = await this.getPoolKey();
+    const token0Info = await Global.getTokenInfoFromAddr(poolKey.token0);
+    const token1Info = await Global.getTokenInfoFromAddr(poolKey.token1);
+    const price0 = await this.pricer.getPrice(token0Info.symbol);
+    const price1 = await this.pricer.getPrice(token1Info.symbol);
+    let totalToken0Amount = Web3Number.fromWei(0, token0Info.decimals);
+    let totalToken1Amount = Web3Number.fromWei(0, token1Info.decimals);
+    let totalToken0Usd = 0;
+    let totalToken1Usd = 0;
+    const parsedFeeInfo = [];
+    const feeInfo = data.contractFeeEarnings.dailyEarnings;
+    for (const d of feeInfo) {
+      const tokenInfo = await Global.getTokenInfoFromAddr(ContractAddr.from(d.tokenAddress));
+      const amount = Web3Number.fromWei(d.amount, tokenInfo.decimals);
+      if (tokenInfo.address.eq(poolKey.token0)) {
+        totalToken0Amount = totalToken0Amount.plus(amount);
+        totalToken0Usd = totalToken0Usd + amount.multipliedBy(price0.price).toNumber();
+      } else {
+        totalToken1Amount = totalToken1Amount.plus(amount);
+        totalToken1Usd = totalToken1Usd + amount.multipliedBy(price1.price).toNumber();
+      }
+      parsedFeeInfo.push({
+        date: d.date,
+        tokenInfo,
+        amount: Web3Number.fromWei(d.amount, tokenInfo.decimals)
+      });
+    }
+    return {
+      summary: {
+        usdValue: totalToken0Usd + totalToken1Usd,
+        token0: {
+          tokenInfo: token0Info,
+          amount: totalToken0Amount,
+          usdValue: totalToken0Usd
+        },
+        token1: {
+          tokenInfo: token1Info,
+          amount: totalToken1Amount,
+          usdValue: totalToken1Usd
+        }
+      },
+      history: parsedFeeInfo
+    };
+  }
+  async netSharesBasedTrueAPY(blockIdentifier = "latest", sinceBlocks = 6e5) {
     const tvlNow = await this._getTVL(blockIdentifier);
     const supplyNow = await this.totalSupply(blockIdentifier);
     const priceNow = await this.getCurrentPrice(blockIdentifier);
@@ -15487,6 +15562,23 @@ var EkuboCLVault = class _EkuboCLVault extends BaseStrategy {
     ) / 1e4;
     return apyForGivenBlocks * (365 * 24 * 3600) / timeDiffSeconds;
   }
+  async feeBasedAPY(timeperiod = "24h") {
+    const feeInfo = await this.getFeeHistory(timeperiod);
+    const tvlNow = await this.getTVL("latest");
+    return feeInfo.summary.usdValue * 365 / tvlNow.usdValue;
+  }
+  /**
+   * Calculates assets before and now in a given token of TVL per share to observe growth
+   * @returns {Promise<number>} The weighted average APY across all pools
+   */
+  async netAPY(blockIdentifier = "latest", sinceBlocks = 6e5, timeperiod = "24h") {
+    const isUSDCQouteToken = this.metadata.additionalInfo.quoteAsset.symbol === "USDC";
+    if (!isUSDCQouteToken) {
+      return this.netSharesBasedTrueAPY(blockIdentifier, sinceBlocks);
+    } else {
+      return this.feeBasedAPY(timeperiod);
+    }
+  }
   async getHarvestRewardShares(fromBlock, toBlock) {
     const len = Number(await this.contract.call("get_total_rewards"));
     let shares = Web3Number.fromWei(0, 18);
@@ -16501,7 +16593,7 @@ var highRisk = {
   netRisk: highVolatilityPoolRiskFactors.reduce((acc, curr) => acc + curr.value * curr.weight, 0) / highVolatilityPoolRiskFactors.reduce((acc, curr) => acc + curr.weight, 0),
   notARisks: getNoRiskTags(highVolatilityPoolRiskFactors)
 };
-var AUDIT_URL2 = "https://assets.troves.fi/strkfarm/audit_report_vesu_and_ekubo_strats.pdf";
+var AUDIT_URL2 = "https://docs.troves.fi/p/security#ekubo-vault";
 var faqs2 = [
   {
     question: "What is the Ekubo CL Vault strategy?",
@@ -16700,7 +16792,7 @@ var ETHUSDCRe7Strategy = {
     Global.getDefaultTokens().find((t) => t.symbol === "ETH"),
     Global.getDefaultTokens().find((t) => t.symbol === "USDC")
   ],
-  apyMethodology: "APY based on 7-day historical performance, including fees and rewards.",
+  apyMethodology: "Annualized fee APY, calculated as fees earned in the last 24h divided by TVL",
   additionalInfo: {
     newBounds: "Managed by Re7",
     truePrice: 1,
@@ -16721,6 +16813,10 @@ var ETHUSDCRe7Strategy = {
         /* @__PURE__ */ jsx3("a", { href: "https://www.re7labs.xyz", style: { textDecoration: "underline", marginLeft: "2px" }, target: "_blank", children: "here" }),
         "."
       ] })
+    },
+    {
+      question: "How is the APY calculated?",
+      answer: /* @__PURE__ */ jsx3("div", { children: "It's an annualized fee APY, calculated as fees earned in the last 24h divided by TVL. Factors like impermanent loss are not considered." })
     }
   ],
   risk: highRisk,
@@ -27328,6 +27424,7 @@ var investmentSteps = [
   "Vault manager reports asset under management (AUM) regularly to the vault",
   "Request withdrawal and vault manager processes it in 1-2 hours"
 ];
+var AUDIT_URL3 = "https://docs.troves.fi/p/security#starknet-vault-kit";
 var UniversalStrategies = [
   {
     name: "USDC Evergreen",
@@ -27342,6 +27439,7 @@ var UniversalStrategies = [
       netRisk: _riskFactor3.reduce((acc, curr) => acc + curr.value * curr.weight, 0) / _riskFactor3.reduce((acc, curr) => acc + curr.weight, 0),
       notARisks: getNoRiskTags(_riskFactor3)
     },
+    auditUrl: AUDIT_URL3,
     protocols: [Protocols.VESU],
     maxTVL: Web3Number.fromWei(0, 6),
     contractDetails: getContractDetails(usdcVaultSettings),
@@ -27365,7 +27463,8 @@ var UniversalStrategies = [
     maxTVL: Web3Number.fromWei(0, 8),
     contractDetails: getContractDetails(wbtcVaultSettings),
     faqs: getFAQs(),
-    investmentSteps
+    investmentSteps,
+    auditUrl: AUDIT_URL3
   },
   {
     name: "ETH Evergreen",
@@ -27384,7 +27483,8 @@ var UniversalStrategies = [
     maxTVL: Web3Number.fromWei(0, 18),
     contractDetails: getContractDetails(ethVaultSettings),
     faqs: getFAQs(),
-    investmentSteps
+    investmentSteps,
+    auditUrl: AUDIT_URL3
   },
   {
     name: "STRK Evergreen",
@@ -27403,7 +27503,8 @@ var UniversalStrategies = [
     maxTVL: Web3Number.fromWei(0, 18),
     contractDetails: getContractDetails(strkVaultSettings),
     faqs: getFAQs(),
-    investmentSteps
+    investmentSteps,
+    auditUrl: AUDIT_URL3
   },
   {
     name: "USDT Evergreen",
@@ -27422,7 +27523,8 @@ var UniversalStrategies = [
     maxTVL: Web3Number.fromWei(0, 6),
     contractDetails: getContractDetails(usdtVaultSettings),
     faqs: getFAQs(),
-    investmentSteps
+    investmentSteps,
+    auditUrl: AUDIT_URL3
   }
 ];
 
@@ -27632,7 +27734,7 @@ var UniversalLstMultiplierStrategy = class _UniversalLstMultiplierStrategy exten
     return [this.getManageCall(proofsIDs, manageCalls)];
   }
 };
-function VaultDescription() {
+function VaultDescription(lstSymbol, underlyingSymbol) {
   const containerStyle = {
     maxWidth: "800px",
     margin: "0 auto",
@@ -27642,8 +27744,27 @@ function VaultDescription() {
     borderRadius: "12px"
   };
   return /* @__PURE__ */ jsxs4("div", { style: containerStyle, children: [
-    /* @__PURE__ */ jsx5("h1", { style: { fontSize: "18px", marginBottom: "10px" }, children: "Meta Vault \u2014 Automated Yield Router" }),
-    /* @__PURE__ */ jsx5("p", { style: { fontSize: "14px", lineHeight: "1.5", marginBottom: "16px" }, children: "This Levered Endur LST vault is a tokenized leveraged Vault, auto-compounding strategy that continuously allocates your deposited asset to the best available yield source in the ecosystem. Depositors receive vault shares that represent a proportional claim on the underlying assets and accrued yield. Allocation shifts are handled programmatically based on on-chain signals and risk filters, minimizing idle capital and maximizing net APY." }),
+    /* @__PURE__ */ jsxs4("h1", { style: { fontSize: "18px", marginBottom: "10px" }, children: [
+      "Liquidation risk managed leverged ",
+      lstSymbol,
+      " Vault"
+    ] }),
+    /* @__PURE__ */ jsxs4("p", { style: { fontSize: "14px", lineHeight: "1.5", marginBottom: "16px" }, children: [
+      "This Levered Endur ",
+      lstSymbol,
+      " vault is a tokenized leveraged Vault, auto-compounding strategy that takes upto 5x leverage on ",
+      lstSymbol,
+      " by borrow ",
+      underlyingSymbol,
+      ". Borrowed amount is swapped to ",
+      lstSymbol,
+      " to create leverage. Depositors receive vault shares that represent a proportional claim on the underlying assets and accrued yield."
+    ] }),
+    /* @__PURE__ */ jsxs4("p", { style: { fontSize: "14px", lineHeight: "1.5", marginBottom: "16px" }, children: [
+      "This vault uses Vesu for lending and borrowing. The oracle used by this pool is a ",
+      highlightTextWithLinks("conversion rate oracle", [{ highlight: "conversion rate oracle", link: "https://docs.pragma.build/starknet/development#conversion-rate" }]),
+      "which is resilient to liquidity issues and price volatility, hence reducing the risk of liquidation. However, overtime, if left un-monitored, debt can increase enough to trigger a liquidation. But no worries, our continuous monitoring systems look for situations with reduced health factor and balance collateral/debt to bring it back to safe levels. With Troves, you can have a peaceful sleep."
+    ] }),
     /* @__PURE__ */ jsx5("div", { style: { backgroundColor: "#222", padding: "10px", borderRadius: "8px", marginBottom: "20px", border: "1px solid #444" }, children: /* @__PURE__ */ jsxs4("p", { style: { fontSize: "13px", color: "#ccc" }, children: [
       /* @__PURE__ */ jsx5("strong", { children: "Withdrawals:" }),
       " Requests can take up to ",
@@ -27652,8 +27773,8 @@ function VaultDescription() {
     ] }) })
   ] });
 }
-function getDescription2(tokenSymbol) {
-  return VaultDescription();
+function getDescription2(tokenSymbol, underlyingSymbol) {
+  return VaultDescription(tokenSymbol, underlyingSymbol);
 }
 function getLooperSettings2(lstSymbol, underlyingSymbol, vaultSettings, pool1) {
   vaultSettings.leafAdapters = [];
@@ -27694,11 +27815,12 @@ function getLooperSettings2(lstSymbol, underlyingSymbol, vaultSettings, pool1) {
   vaultSettings.leafAdapters.push(commonAdapter.getAvnuAdapter(STRKToken.address, lstToken.address, "avnu_swap_rewards" /* AVNU_SWAP_REWARDS */).bind(commonAdapter));
   return vaultSettings;
 }
+var AUDIT_URL4 = "https://docs.troves.fi/p/security#starknet-vault-kit";
 function getFAQs2(lstSymbol, underlyingSymbol) {
   return [
     {
       question: `What is the Hyper ${lstSymbol} Vault?`,
-      answer: `The Hyper ${lstSymbol} Vault is a tokenized strategy that automatically loops your ${underlyingSymbol} or ${lstSymbol} to create up to 4x leverage to hence yield in a very low risk manner.`
+      answer: `The Hyper ${lstSymbol} Vault is a tokenized strategy that automatically loops your ${lstSymbol} to create up to 5x leverage to hence yield in a very low risk manner.`
     },
     {
       question: "How does yield allocation work?",
@@ -27742,8 +27864,9 @@ function getFAQs2(lstSymbol, underlyingSymbol) {
 }
 var _riskFactor4 = [
   { type: "Smart Contract Risk" /* SMART_CONTRACT_RISK */, value: 2 /* WELL_AUDITED */, weight: 25, reason: "Audited by Zellic" },
-  { type: "Liquidation Risk" /* LIQUIDATION_RISK */, value: 1 /* VERY_LOW_PROBABILITY */, weight: 50, reason: "The collateral and debt are highly correlated" },
-  { type: "Technical Risk" /* TECHNICAL_RISK */, value: 1 /* STABLE_INFRASTRUCTURE */, weight: 50, reason: "Liquidation can only happen if vault is left un-monitored for weeks, which is highly unlikely. We actively monitor all services on a daily basis." }
+  { type: "Liquidation Risk" /* LIQUIDATION_RISK */, value: 1 /* VERY_LOW_PROBABILITY */, weight: 25, reason: "The collateral and debt are highly correlated" },
+  { type: "Technical Risk" /* TECHNICAL_RISK */, value: 1 /* STABLE_INFRASTRUCTURE */, weight: 25, reason: "Liquidation can only happen if vault is left un-monitored for weeks, which is highly unlikely. We actively monitor all services on a daily basis." },
+  { type: "Depeg Risk" /* DEPEG_RISK */, value: 2 /* GENERALLY_STABLE */, weight: 25, reason: "Generally stable pegged assets" }
 ];
 var hyperxSTRK = {
   vaultAddress: ContractAddr.from("0x46c7a54c82b1fe374353859f554a40b8bd31d3e30f742901579e7b57b1b5960"),
@@ -27806,14 +27929,13 @@ function getInvestmentSteps(lstSymbol, underlyingSymbol) {
     `The vault manager loops the ${underlyingSymbol} to buy ${lstSymbol}`,
     `The vault manager collateralizes the ${lstSymbol} on Vesu`,
     `The vault manager borrows more ${underlyingSymbol} to loop further`,
-    `Claim BTCFi STRK rewards weekly to swap to ${lstSymbol} and reinvest`,
     `If required, adjust leverage or re-allocate assets within LST pool on Vesu to optimize yield`
   ];
 }
 function getStrategySettings(lstSymbol, underlyingSymbol, addresses, isPreview = false) {
   return {
     name: `Hyper ${lstSymbol}`,
-    description: getDescription2(lstSymbol),
+    description: getDescription2(lstSymbol, underlyingSymbol),
     address: addresses.vaultAddress,
     launchBlock: 0,
     type: "Other",
@@ -27824,6 +27946,7 @@ function getStrategySettings(lstSymbol, underlyingSymbol, addresses, isPreview =
       netRisk: _riskFactor4.reduce((acc, curr) => acc + curr.value * curr.weight, 0) / _riskFactor4.reduce((acc, curr) => acc + curr.weight, 0),
       notARisks: getNoRiskTags(_riskFactor4)
     },
+    auditUrl: AUDIT_URL4,
     protocols: [Protocols.ENDUR, Protocols.VESU],
     maxTVL: Web3Number.fromWei(0, 18),
     contractDetails: getContractDetails(addresses),
@@ -27936,7 +28059,7 @@ var TelegramNotif = class {
 import TelegramBot2 from "node-telegram-bot-api";
 var TelegramGroupNotif = class {
   constructor(token, groupId, topicId) {
-    this.bot = new TelegramBot2(token, { polling: true });
+    this.bot = new TelegramBot2(token, { polling: false });
     this.groupId = groupId;
     this.topicId = topicId;
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@strkfarm/sdk",
-  "version": "1.1.22",
+  "version": "1.1.24",
   "description": "STRKFarm TS SDK (Meant for our internal use, but feel free to use it)",
   "typings": "dist/index.d.ts",
   "types": "dist/index.d.ts",
@@ -57,6 +57,7 @@
     "starknet": "8.5.2"
   },
   "dependencies": {
+    "@apollo/client": "3.11.8",
     "@avnu/avnu-sdk": "3.0.2",
     "@ericnordelo/strk-merkle-tree": "^1.0.0",
     "@noble/curves": "^1.0.0",
@@ -68,6 +69,7 @@
     "chalk": "^4.1.2",
     "commander": "^12.1.0",
     "ethers": "^6.13.5",
+    "graphql": "16.9.0",
     "inquirer": "^10.1.2",
     "node-telegram-bot-api": "^0.66.0",
     "proxy-from-env": "^1.1.0",

package/src/modules/apollo-client.ts

@@ -0,0 +1,8 @@
+import { ApolloClient, InMemoryCache } from '@apollo/client';
+
+const apolloClient = new ApolloClient({
+  uri: 'https://api.troves.fi/',
+  cache: new InMemoryCache(),
+});
+
+export default apolloClient;

package/src/notifs/telegram-group.ts

@@ -7,7 +7,7 @@ export class TelegramGroupNotif {
     private topicId?: number;
 
     constructor(token: string, groupId: string, topicId?: number) {
-        this.bot = new TelegramBot(token, { polling: true });
+        this.bot = new TelegramBot(token, { polling: false });
         this.groupId = groupId;
         this.topicId = topicId;
     }

package/src/strategies/ekubo-cl-vault.tsx

@@ -37,6 +37,8 @@ import { EkuboHarvests } from "@/modules/harvests";
 import { logger } from "@/utils/logger";
 import { COMMON_CONTRACTS } from "./constants";
 import { DepegRiskLevel, ImpermanentLossLevel, MarketRiskLevel, SmartContractRiskLevel } from "@/interfaces/risks";
+import { gql } from "@apollo/client";
+import apolloClient from "@/modules/apollo-client";
 
 export interface EkuboPoolKey {
   token0: ContractAddr;
@@ -51,6 +53,12 @@ export interface EkuboBounds {
   upperTick: bigint;
 }
 
+interface FeeHistory {
+  date: string;
+  tokenInfo: TokenInfo;
+  amount: Web3Number;
+}
+
 /**
  * Settings for the CLVaultStrategy
  *
@@ -285,11 +293,97 @@ export class EkuboCLVault extends BaseStrategy<
     return [this.contract.populate("handle_fees", [])];
   }
 
-  /**
-   * Calculates assets before and now in a given token of TVL per share to observe growth
-   * @returns {Promise<number>} The weighted average APY across all pools
-   */
-  async netAPY(
+  async getFeeHistory(timePeriod: '24h' | '30d' | '3m' = '24h'): Promise<{
+    summary: DualTokenInfo,
+    history: FeeHistory[]
+  }> {
+    const { data } = await apolloClient.query({
+      query: gql`
+        query ContractFeeEarnings(
+          $timeframe: String!
+          $contract: String!
+        ) {
+          contractFeeEarnings(timeframe: $timeframe, contract: $contract) {
+            contract
+            dailyEarnings {
+              date
+              tokenAddress
+              amount
+            }
+            totalCollections
+          }
+        }
+      `,
+      variables: {
+        timeframe: timePeriod,
+        contract: this.address.address
+      },
+      fetchPolicy: 'no-cache',
+    });
+
+    // Sample response type:
+    // {
+    //   contractFeeEarnings: {
+    //     contract: '0x2bcaef2eb7706875a5fdc6853dd961a0590f850bc3a031c59887189b5e84ba1',
+    //     dailyEarnings: [ [Object], [Object], [Object], [Object] ],
+    //     totalCollections: 3,
+    //     __typename: 'FeeSummary'
+    //   }
+    // }
+    // dailyEarnings: {
+    //   date: '2025-09-27',
+    //   tokenAddress: '0x3fe2b97c1fd336e750087d68b9b867997fd64a2661ff3ca5a7c771641e8e7ac',
+    //   amount: '15404',
+    //   __typename: 'DailyFeeEarnings'
+    // }[]
+
+    // get pool key and token info
+    const poolKey = await this.getPoolKey();
+    const token0Info = await Global.getTokenInfoFromAddr(poolKey.token0);
+    const token1Info = await Global.getTokenInfoFromAddr(poolKey.token1);
+    const price0 = await this.pricer.getPrice(token0Info.symbol);
+    const price1 = await this.pricer.getPrice(token1Info.symbol);
+    let totalToken0Amount = Web3Number.fromWei(0, token0Info.decimals);
+    let totalToken1Amount = Web3Number.fromWei(0, token1Info.decimals);
+    let totalToken0Usd = 0;
+    let totalToken1Usd = 0;
+    const parsedFeeInfo: FeeHistory[] = [];
+    const feeInfo = data.contractFeeEarnings.dailyEarnings;
+    for (const d of feeInfo) {
+      const tokenInfo = await Global.getTokenInfoFromAddr(ContractAddr.from(d.tokenAddress));
+      const amount = Web3Number.fromWei(d.amount, tokenInfo.decimals);
+      if (tokenInfo.address.eq(poolKey.token0)) {
+        totalToken0Amount = totalToken0Amount.plus(amount);
+        totalToken0Usd = totalToken0Usd + amount.multipliedBy(price0.price).toNumber();
+      } else {
+        totalToken1Amount = totalToken1Amount.plus(amount);
+        totalToken1Usd = totalToken1Usd + amount.multipliedBy(price1.price).toNumber();
+      }
+      parsedFeeInfo.push({
+        date: d.date,
+        tokenInfo,
+        amount: Web3Number.fromWei(d.amount, tokenInfo.decimals)
+      });
+    }
+    return {
+      summary: {
+        usdValue: totalToken0Usd + totalToken1Usd,
+        token0: {
+          tokenInfo: token0Info,
+          amount: totalToken0Amount,
+          usdValue: totalToken0Usd
+        },
+        token1: {
+          tokenInfo: token1Info,
+          amount: totalToken1Amount,
+          usdValue: totalToken1Usd
+        }
+      },
+      history: parsedFeeInfo
+    }
+  }
+
+  async netSharesBasedTrueAPY(
     blockIdentifier: BlockIdentifier = "latest",
     sinceBlocks = 600000
   ): Promise<number> {
@@ -354,6 +448,33 @@ export class EkuboCLVault extends BaseStrategy<
     return (apyForGivenBlocks * (365 * 24 * 3600)) / timeDiffSeconds;
   }
 
+  async feeBasedAPY(
+    timeperiod: '24h' | '30d' | '3m' = '24h'
+  ): Promise<number> {
+    const feeInfo = await this.getFeeHistory(timeperiod);
+    const tvlNow = await this.getTVL('latest');
+    return feeInfo.summary.usdValue * 365 / tvlNow.usdValue;
+  }
+
+  /**
+   * Calculates assets before and now in a given token of TVL per share to observe growth
+   * @returns {Promise<number>} The weighted average APY across all pools
+   */
+  async netAPY(
+    blockIdentifier: BlockIdentifier = "latest",
+    sinceBlocks = 600000,
+    timeperiod: '24h' | '30d' | '3m' = '24h' // temp thing for fee based APY
+  ): Promise<number> {
+    const isUSDCQouteToken = this.metadata.additionalInfo.quoteAsset.symbol === "USDC";
+    if (!isUSDCQouteToken) {
+      // good for LSTs and stables
+      return this.netSharesBasedTrueAPY(blockIdentifier, sinceBlocks);
+    } else {
+      // good for non-stables
+      return this.feeBasedAPY(timeperiod);
+    }
+  }
+
   async getHarvestRewardShares(fromBlock: number, toBlock: number) {
     const len = Number(await this.contract.call("get_total_rewards"));
     let shares = Web3Number.fromWei(0, 18);
@@ -1680,7 +1801,7 @@ const highRisk = {
 
 
 const AUDIT_URL =
-  "https://assets.troves.fi/strkfarm/audit_report_vesu_and_ekubo_strats.pdf";
+  "https://docs.troves.fi/p/security#ekubo-vault";
 
 const faqs: FAQ[] = [
   {
@@ -1893,7 +2014,7 @@ const ETHUSDCRe7Strategy: IStrategyMetadata<CLVaultStrategySettings> = {
     Global.getDefaultTokens().find((t) => t.symbol === "USDC")!
   ],
   apyMethodology:
-  "APY based on 7-day historical performance, including fees and rewards.",
+  "Annualized fee APY, calculated as fees earned in the last 24h divided by TVL",
   additionalInfo: {
     newBounds: "Managed by Re7",
     truePrice: 1,
@@ -1913,6 +2034,11 @@ const ETHUSDCRe7Strategy: IStrategyMetadata<CLVaultStrategySettings> = {
       answer:
         <div>Re7 Labs is the curator of this strategy. Re7 Labs is a well-known Web3 asset management firm. This strategy is completely managed by them, including ownership of the vault. Troves is developer of the smart contracts and maintains infrastructure to help users access these strategies. You can find more information about them on their website <a href='https://www.re7labs.xyz' style={{textDecoration: "underline", marginLeft: "2px"}} target="_blank">here</a>.</div>
     },
+    {
+      question: "How is the APY calculated?",
+      answer:
+        <div>It's an annualized fee APY, calculated as fees earned in the last 24h divided by TVL. Factors like impermanent loss are not considered.</div>
+    },
   ],
   risk: highRisk,
   points: [],

package/src/strategies/universal-lst-muliplier-strategy.tsx

@@ -1,11 +1,11 @@
-import { FAQ, getNoRiskTags, IConfig, IStrategyMetadata, Protocols, RiskFactor, RiskType } from "@/interfaces";
+import { FAQ, getNoRiskTags, highlightTextWithLinks, IConfig, IStrategyMetadata, Protocols, RiskFactor, RiskType } from "@/interfaces";
 import { AUMTypes, getContractDetails, UNIVERSAL_ADAPTERS, UNIVERSAL_MANAGE_IDS, UniversalManageCall, UniversalStrategy, UniversalStrategySettings } from "./universal-strategy";
 import { PricerBase } from "@/modules/pricerBase";
 import { ContractAddr, Web3Number } from "@/dataTypes";
 import { Global } from "@/global";
 import { ApproveCallParams, CommonAdapter, getVesuSingletonAddress, ManageCall, Swap, VesuAdapter, VesuModifyDelegationCallParams, VesuMultiplyCallParams, VesuPools } from "./universal-adapters";
 import { AVNU_MIDDLEWARE } from "./universal-adapters/adapter-utils";
-import { LiquidationRiskLevel, SmartContractRiskLevel, TechnicalRiskLevel } from "@/interfaces/risks";
+import { DepegRiskLevel, LiquidationRiskLevel, SmartContractRiskLevel, TechnicalRiskLevel } from "@/interfaces/risks";
 import { EkuboQuoter, ERC20, PricerLST } from "@/modules";
 import { assert, logger } from "@/utils";
 import { SingleTokenInfo } from "./base-strategy";
@@ -293,7 +293,10 @@ export class UniversalLstMultiplierStrategy extends UniversalStrategy<UniversalS
   }
 }
 
-export default function VaultDescription() {
+export default function VaultDescription(
+  lstSymbol: string,
+  underlyingSymbol: string
+) {
   const containerStyle = {
     maxWidth: "800px",
     margin: "0 auto",
@@ -305,13 +308,16 @@ export default function VaultDescription() {
 
   return (
     <div style={containerStyle}>
-      <h1 style={{ fontSize: "18px", marginBottom: "10px" }}>Meta Vault — Automated Yield Router</h1>
+      <h1 style={{ fontSize: "18px", marginBottom: "10px" }}>Liquidation risk managed leverged {lstSymbol} Vault</h1>
+      <p style={{ fontSize: "14px", lineHeight: "1.5", marginBottom: "16px" }}>
+        This Levered Endur {lstSymbol} vault is a tokenized leveraged Vault, auto-compounding strategy that takes upto 5x leverage on {lstSymbol} by borrow {underlyingSymbol}. Borrowed amount
+        is swapped to {lstSymbol} to create leverage. Depositors receive vault shares that
+        represent a proportional claim on the underlying assets and accrued yield.
+      </p>
+
       <p style={{ fontSize: "14px", lineHeight: "1.5", marginBottom: "16px" }}>
-        This Levered Endur LST vault is a tokenized leveraged Vault, auto-compounding strategy that continuously allocates your deposited
-        asset to the best available yield source in the ecosystem. Depositors receive vault shares that
-        represent a proportional claim on the underlying assets and accrued yield. Allocation shifts are
-        handled programmatically based on on-chain signals and risk filters, minimizing idle capital and
-        maximizing net APY.
+        This vault uses Vesu for lending and borrowing. The oracle used by this pool is a {highlightTextWithLinks("conversion rate oracle", [{highlight: "conversion rate oracle", link: "https://docs.pragma.build/starknet/development#conversion-rate"}])}
+        which is resilient to liquidity issues and price volatility, hence reducing the risk of liquidation. However, overtime, if left un-monitored, debt can increase enough to trigger a liquidation. But no worries, our continuous monitoring systems look for situations with reduced health factor and balance collateral/debt to bring it back to safe levels. With Troves, you can have a peaceful sleep.
       </p>
 
       <div style={{ backgroundColor: "#222", padding: "10px", borderRadius: "8px", marginBottom: "20px", border: "1px solid #444" }}>
@@ -324,8 +330,8 @@ export default function VaultDescription() {
 }
 
 
-function getDescription(tokenSymbol: string) {
-  return VaultDescription();
+function getDescription(tokenSymbol: string, underlyingSymbol: string) {
+  return VaultDescription(tokenSymbol, underlyingSymbol);
 }
 
 enum LST_MULTIPLIER_MANAGE_IDS  {
@@ -393,12 +399,14 @@ function getLooperSettings(
   return vaultSettings;
 }
 
+const AUDIT_URL = 'https://docs.troves.fi/p/security#starknet-vault-kit'
+
 function getFAQs(lstSymbol: string, underlyingSymbol: string): FAQ[] {
   return [
     {
       question: `What is the Hyper ${lstSymbol} Vault?`,
       answer:
-        `The Hyper ${lstSymbol} Vault is a tokenized strategy that automatically loops your ${underlyingSymbol} or ${lstSymbol} to create up to 4x leverage to hence yield in a very low risk manner.`,
+        `The Hyper ${lstSymbol} Vault is a tokenized strategy that automatically loops your ${lstSymbol} to create up to 5x leverage to hence yield in a very low risk manner.`,
     },
     {
       question: "How does yield allocation work?",
@@ -447,8 +455,9 @@ function getFAQs(lstSymbol: string, underlyingSymbol: string): FAQ[] {
 
 const _riskFactor: RiskFactor[] = [
   { type: RiskType.SMART_CONTRACT_RISK, value: SmartContractRiskLevel.WELL_AUDITED, weight: 25, reason: "Audited by Zellic" },
-  { type: RiskType.LIQUIDATION_RISK, value: LiquidationRiskLevel.VERY_LOW_PROBABILITY, weight: 50, reason: "The collateral and debt are highly correlated" },
-  { type: RiskType.TECHNICAL_RISK, value: TechnicalRiskLevel.STABLE_INFRASTRUCTURE, weight: 50, reason: "Liquidation can only happen if vault is left un-monitored for weeks, which is highly unlikely. We actively monitor all services on a daily basis." }
+  { type: RiskType.LIQUIDATION_RISK, value: LiquidationRiskLevel.VERY_LOW_PROBABILITY, weight: 25, reason: "The collateral and debt are highly correlated" },
+  { type: RiskType.TECHNICAL_RISK, value: TechnicalRiskLevel.STABLE_INFRASTRUCTURE, weight: 25, reason: "Liquidation can only happen if vault is left un-monitored for weeks, which is highly unlikely. We actively monitor all services on a daily basis." },
+  {type: RiskType.DEPEG_RISK, value: DepegRiskLevel.GENERALLY_STABLE, weight: 25, reason: "Generally stable pegged assets" },
 ];
 
 const hyperxSTRK: UniversalStrategySettings = {
@@ -517,7 +526,6 @@ function getInvestmentSteps(lstSymbol: string, underlyingSymbol: string) {
     `The vault manager loops the ${underlyingSymbol} to buy ${lstSymbol}`,
     `The vault manager collateralizes the ${lstSymbol} on Vesu`,
     `The vault manager borrows more ${underlyingSymbol} to loop further`,
-    `Claim BTCFi STRK rewards weekly to swap to ${lstSymbol} and reinvest`,
     `If required, adjust leverage or re-allocate assets within LST pool on Vesu to optimize yield`
   ]
 }
@@ -525,7 +533,7 @@ function getInvestmentSteps(lstSymbol: string, underlyingSymbol: string) {
 function getStrategySettings(lstSymbol: string, underlyingSymbol: string, addresses: UniversalStrategySettings, isPreview: boolean = false): IStrategyMetadata<UniversalStrategySettings> {
   return {
     name: `Hyper ${lstSymbol}`,
-    description: getDescription(lstSymbol),
+    description: getDescription(lstSymbol, underlyingSymbol),
     address: addresses.vaultAddress,
     launchBlock: 0,
     type: 'Other',
@@ -538,6 +546,7 @@ function getStrategySettings(lstSymbol: string, underlyingSymbol: string, addres
         _riskFactor.reduce((acc, curr) => acc + curr.weight, 0),
       notARisks: getNoRiskTags(_riskFactor)
     },
+    auditUrl: AUDIT_URL,
     protocols: [Protocols.ENDUR, Protocols.VESU],
     maxTVL: Web3Number.fromWei(0, 18),
     contractDetails: getContractDetails(addresses),