@strkfarm/sdk 1.0.31 → 1.0.33

package/dist/index.browser.mjs

@@ -2089,7 +2089,7 @@ var AutoCompounderSTRK = class {
   }
 };
 
-// src/strategies/vesu-rebalance.ts
+// src/strategies/vesu-rebalance.tsx
 import { CairoCustomEnum, Contract as Contract5, num as num3, uint256 as uint2563 } from "starknet";
 
 // src/data/vesu-rebalance.abi.json
@@ -12697,7 +12697,7 @@ var vesu_pools_default = {
   ]
 };
 
-// src/strategies/vesu-rebalance.ts
+// src/strategies/vesu-rebalance.tsx
 var VesuRebalance = class _VesuRebalance extends BaseStrategy {
   // 10000 bps = 100%
   /**
@@ -13198,7 +13198,7 @@ var VesuRebalanceStrategies = [{
   //     },
 }];
 
-// src/strategies/ekubo-cl-vault.ts
+// src/strategies/ekubo-cl-vault.tsx
 import { Contract as Contract6, num as num4, uint256 as uint2564 } from "starknet";
 
 // src/data/cl-vault.abi.json
@@ -18100,7 +18100,8 @@ var erc4626_abi_default = [
   }
 ];
 
-// src/strategies/ekubo-cl-vault.ts
+// src/strategies/ekubo-cl-vault.tsx
+import { jsx, jsxs } from "react/jsx-runtime";
 var EkuboCLVault = class _EkuboCLVault extends BaseStrategy {
   /**
    * Creates a new VesuRebalance strategy instance.
@@ -18629,11 +18630,10 @@ var EkuboCLVault = class _EkuboCLVault extends BaseStrategy {
    * @returns Array of contract calls needed for rebalancing
    * @throws Error if max retries reached without successful rebalance
    */
-  async rebalanceIter(swapInfo, acc, estimateCall, retry = 0, adjustmentFactor = 1, isToken0Deficit = true) {
-    const MAX_RETRIES = 20;
-    const MIN_ADJUSTMENT = 1e-3;
+  async rebalanceIter(swapInfo, acc, estimateCall, isSellTokenToken0 = true, retry = 0, lowerLimit = 0n, upperLimit = 0n) {
+    const MAX_RETRIES = 40;
     logger.verbose(
-      `Rebalancing ${this.metadata.name}: retry=${retry}, adjustment=${adjustmentFactor}%, token0Deficit=${isToken0Deficit}`
+      `Rebalancing ${this.metadata.name}: retry=${retry}, lowerLimit=${lowerLimit}, upperLimit=${upperLimit}, isSellTokenToken0=${isSellTokenToken0}`
     );
     const fromAmount = uint2564.uint256ToBN(swapInfo.token_from_amount);
     logger.verbose(
@@ -18648,38 +18648,69 @@ var EkuboCLVault = class _EkuboCLVault extends BaseStrategy {
         logger.error(`Rebalance failed after ${MAX_RETRIES} retries`);
         throw err;
       }
-      if (adjustmentFactor < MIN_ADJUSTMENT) {
-        logger.error("Adjustment factor too small, likely oscillating");
-        throw new Error("Failed to converge on valid swap amount");
-      }
       logger.error(`Rebalance attempt ${retry + 1} failed, adjusting swap amount...`);
       const newSwapInfo = { ...swapInfo };
       const currentAmount = Web3Number.fromWei(fromAmount.toString(), 18);
+      logger.verbose(`Current amount: ${currentAmount.toString()}`);
       if (err.message.includes("invalid token0 balance") || err.message.includes("invalid token0 amount")) {
-        logger.verbose("Reducing swap amount - excess token0");
-        newSwapInfo.token_from_amount = uint2564.bnToUint256(
-          currentAmount.multipliedBy((100 - adjustmentFactor) / 100).toWei()
-        );
-        adjustmentFactor = isToken0Deficit ? adjustmentFactor * 2 : adjustmentFactor / 2;
-        isToken0Deficit = true;
-      } else if (err.message.includes("invalid token1 balance") || err.message.includes("invalid token1 amount")) {
-        logger.verbose("Increasing swap amount - excess token1");
-        newSwapInfo.token_from_amount = uint2564.bnToUint256(
-          currentAmount.multipliedBy((100 + adjustmentFactor) / 100).toWei()
-        );
-        adjustmentFactor = isToken0Deficit ? adjustmentFactor / 2 : adjustmentFactor * 2;
-        isToken0Deficit = false;
+        if (!isSellTokenToken0) {
+          logger.verbose("Reducing swap amount - excess token0");
+          let nextAmount = (fromAmount + lowerLimit) / 2n;
+          upperLimit = fromAmount;
+          if (nextAmount <= lowerLimit) {
+            logger.error("Convergence failed: nextAmount <= lowerLimit");
+            throw err;
+          }
+          newSwapInfo.token_from_amount = uint2564.bnToUint256(nextAmount);
+        } else {
+          logger.verbose("Increasing swap amount - deficit token0");
+          let nextAmount = (fromAmount + upperLimit) / 2n;
+          if (upperLimit == 0n) {
+            nextAmount = fromAmount * 2n;
+          }
+          lowerLimit = fromAmount;
+          if (upperLimit != 0n && nextAmount >= upperLimit) {
+            logger.error("Convergence failed: nextAmount >= upperLimit");
+            throw err;
+          }
+          newSwapInfo.token_from_amount = uint2564.bnToUint256(nextAmount);
+        }
+      } else if (err.message.includes("invalid token1 amount") || err.message.includes("invalid token1 balance")) {
+        if (isSellTokenToken0) {
+          logger.verbose("Reducing swap amount - excess token1");
+          let nextAmount = (fromAmount + lowerLimit) / 2n;
+          upperLimit = fromAmount;
+          if (nextAmount <= lowerLimit) {
+            logger.error("Convergence failed: nextAmount <= lowerLimit");
+            throw err;
+          }
+          newSwapInfo.token_from_amount = uint2564.bnToUint256(nextAmount);
+        } else {
+          logger.verbose("Increasing swap amount - deficit token1");
+          let nextAmount = (fromAmount + upperLimit) / 2n;
+          if (upperLimit == 0n) {
+            nextAmount = fromAmount * 2n;
+          }
+          lowerLimit = fromAmount;
+          if (upperLimit != 0n && nextAmount >= upperLimit) {
+            logger.error("Convergence failed: nextAmount >= upperLimit");
+            throw err;
+          }
+          newSwapInfo.token_from_amount = uint2564.bnToUint256(nextAmount);
+        }
       } else {
         logger.error("Unexpected error:", err);
+        throw err;
       }
       newSwapInfo.token_to_min_amount = uint2564.bnToUint256("0");
       return this.rebalanceIter(
         newSwapInfo,
         acc,
         estimateCall,
+        isSellTokenToken0,
         retry + 1,
-        adjustmentFactor,
-        isToken0Deficit
+        lowerLimit,
+        upperLimit
       );
     }
   }
@@ -18814,7 +18845,13 @@ var _riskFactor2 = [
 var AUDIT_URL2 = "https://assets.strkfarm.com/strkfarm/audit_report_vesu_and_ekubo_strats.pdf";
 var EkuboCLVaultStrategies = [{
   name: "Ekubo xSTRK/STRK",
-  description: _description2.replace("{{POOL_NAME}}", "xSTRK/STRK"),
+  description: /* @__PURE__ */ jsxs("div", { children: [
+    /* @__PURE__ */ jsx("p", { children: _description2.replace("{{POOL_NAME}}", "xSTRK/STRK") }),
+    /* @__PURE__ */ jsxs("ul", { style: { marginLeft: "20px", listStyle: "circle", fontSize: "12px" }, children: [
+      /* @__PURE__ */ jsx("li", { style: { marginTop: "10px" }, children: "During withdrawal, you may receive either or both tokens depending on market conditions and prevailing prices." }),
+      /* @__PURE__ */ jsx("li", { style: { marginTop: "10px" }, children: "Sometimes you might see a negative APY \u2014 this is usually not a big deal. It happens when xSTRK's price drops on DEXes, but things typically bounce back within a few days or a week." })
+    ] })
+  ] }),
   address: ContractAddr.from("0x01f083b98674bc21effee29ef443a00c7b9a500fd92cf30341a3da12c73f2324"),
   type: "Other",
   // must be same order as poolKey token0 and token1

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 import BigNumber from 'bignumber.js';
 import * as starknet from 'starknet';
 import { RpcProvider, BlockIdentifier, Contract, Uint256, Call, Account } from 'starknet';
+import React from 'react';
 import { Quote } from '@avnu/avnu-sdk';
 import * as util from 'util';
 import TelegramBot from 'node-telegram-bot-api';
@@ -90,7 +91,7 @@ declare enum FlowChartColors {
  */
 interface IStrategyMetadata<T> {
     name: string;
-    description: string;
+    description: string | React.ReactNode;
     address: ContractAddr;
     type: 'ERC4626' | 'ERC721' | 'Other';
     depositTokens: TokenInfo[];
@@ -716,7 +717,7 @@ declare class EkuboCLVault extends BaseStrategy<DualTokenInfo, DualActionAmount>
      * @returns Array of contract calls needed for rebalancing
      * @throws Error if max retries reached without successful rebalance
      */
-    rebalanceIter(swapInfo: SwapInfo, acc: Account, estimateCall: (swapInfo: SwapInfo) => Promise<Call[]>, retry?: number, adjustmentFactor?: number, isToken0Deficit?: boolean): Promise<Call[]>;
+    rebalanceIter(swapInfo: SwapInfo, acc: Account, estimateCall: (swapInfo: SwapInfo) => Promise<Call[]>, isSellTokenToken0?: boolean, retry?: number, lowerLimit?: bigint, upperLimit?: bigint): Promise<Call[]>;
     static tickToi129(tick: number): {
         mag: number;
         sign: number;

package/dist/index.js

@@ -2178,7 +2178,7 @@ var AutoCompounderSTRK = class {
   }
 };
 
-// src/strategies/vesu-rebalance.ts
+// src/strategies/vesu-rebalance.tsx
 var import_starknet8 = require("starknet");
 
 // src/data/vesu-rebalance.abi.json
@@ -12786,7 +12786,7 @@ var vesu_pools_default = {
   ]
 };
 
-// src/strategies/vesu-rebalance.ts
+// src/strategies/vesu-rebalance.tsx
 var VesuRebalance = class _VesuRebalance extends BaseStrategy {
   // 10000 bps = 100%
   /**
@@ -13287,7 +13287,7 @@ var VesuRebalanceStrategies = [{
   //     },
 }];
 
-// src/strategies/ekubo-cl-vault.ts
+// src/strategies/ekubo-cl-vault.tsx
 var import_starknet9 = require("starknet");
 
 // src/data/cl-vault.abi.json
@@ -18189,7 +18189,8 @@ var erc4626_abi_default = [
   }
 ];
 
-// src/strategies/ekubo-cl-vault.ts
+// src/strategies/ekubo-cl-vault.tsx
+var import_jsx_runtime = require("react/jsx-runtime");
 var EkuboCLVault = class _EkuboCLVault extends BaseStrategy {
   /**
    * Creates a new VesuRebalance strategy instance.
@@ -18718,11 +18719,10 @@ var EkuboCLVault = class _EkuboCLVault extends BaseStrategy {
    * @returns Array of contract calls needed for rebalancing
    * @throws Error if max retries reached without successful rebalance
    */
-  async rebalanceIter(swapInfo, acc, estimateCall, retry = 0, adjustmentFactor = 1, isToken0Deficit = true) {
-    const MAX_RETRIES = 20;
-    const MIN_ADJUSTMENT = 1e-3;
+  async rebalanceIter(swapInfo, acc, estimateCall, isSellTokenToken0 = true, retry = 0, lowerLimit = 0n, upperLimit = 0n) {
+    const MAX_RETRIES = 40;
     logger.verbose(
-      `Rebalancing ${this.metadata.name}: retry=${retry}, adjustment=${adjustmentFactor}%, token0Deficit=${isToken0Deficit}`
+      `Rebalancing ${this.metadata.name}: retry=${retry}, lowerLimit=${lowerLimit}, upperLimit=${upperLimit}, isSellTokenToken0=${isSellTokenToken0}`
     );
     const fromAmount = import_starknet9.uint256.uint256ToBN(swapInfo.token_from_amount);
     logger.verbose(
@@ -18737,38 +18737,69 @@ var EkuboCLVault = class _EkuboCLVault extends BaseStrategy {
         logger.error(`Rebalance failed after ${MAX_RETRIES} retries`);
         throw err;
       }
-      if (adjustmentFactor < MIN_ADJUSTMENT) {
-        logger.error("Adjustment factor too small, likely oscillating");
-        throw new Error("Failed to converge on valid swap amount");
-      }
       logger.error(`Rebalance attempt ${retry + 1} failed, adjusting swap amount...`);
       const newSwapInfo = { ...swapInfo };
       const currentAmount = Web3Number.fromWei(fromAmount.toString(), 18);
+      logger.verbose(`Current amount: ${currentAmount.toString()}`);
       if (err.message.includes("invalid token0 balance") || err.message.includes("invalid token0 amount")) {
-        logger.verbose("Reducing swap amount - excess token0");
-        newSwapInfo.token_from_amount = import_starknet9.uint256.bnToUint256(
-          currentAmount.multipliedBy((100 - adjustmentFactor) / 100).toWei()
-        );
-        adjustmentFactor = isToken0Deficit ? adjustmentFactor * 2 : adjustmentFactor / 2;
-        isToken0Deficit = true;
-      } else if (err.message.includes("invalid token1 balance") || err.message.includes("invalid token1 amount")) {
-        logger.verbose("Increasing swap amount - excess token1");
-        newSwapInfo.token_from_amount = import_starknet9.uint256.bnToUint256(
-          currentAmount.multipliedBy((100 + adjustmentFactor) / 100).toWei()
-        );
-        adjustmentFactor = isToken0Deficit ? adjustmentFactor / 2 : adjustmentFactor * 2;
-        isToken0Deficit = false;
+        if (!isSellTokenToken0) {
+          logger.verbose("Reducing swap amount - excess token0");
+          let nextAmount = (fromAmount + lowerLimit) / 2n;
+          upperLimit = fromAmount;
+          if (nextAmount <= lowerLimit) {
+            logger.error("Convergence failed: nextAmount <= lowerLimit");
+            throw err;
+          }
+          newSwapInfo.token_from_amount = import_starknet9.uint256.bnToUint256(nextAmount);
+        } else {
+          logger.verbose("Increasing swap amount - deficit token0");
+          let nextAmount = (fromAmount + upperLimit) / 2n;
+          if (upperLimit == 0n) {
+            nextAmount = fromAmount * 2n;
+          }
+          lowerLimit = fromAmount;
+          if (upperLimit != 0n && nextAmount >= upperLimit) {
+            logger.error("Convergence failed: nextAmount >= upperLimit");
+            throw err;
+          }
+          newSwapInfo.token_from_amount = import_starknet9.uint256.bnToUint256(nextAmount);
+        }
+      } else if (err.message.includes("invalid token1 amount") || err.message.includes("invalid token1 balance")) {
+        if (isSellTokenToken0) {
+          logger.verbose("Reducing swap amount - excess token1");
+          let nextAmount = (fromAmount + lowerLimit) / 2n;
+          upperLimit = fromAmount;
+          if (nextAmount <= lowerLimit) {
+            logger.error("Convergence failed: nextAmount <= lowerLimit");
+            throw err;
+          }
+          newSwapInfo.token_from_amount = import_starknet9.uint256.bnToUint256(nextAmount);
+        } else {
+          logger.verbose("Increasing swap amount - deficit token1");
+          let nextAmount = (fromAmount + upperLimit) / 2n;
+          if (upperLimit == 0n) {
+            nextAmount = fromAmount * 2n;
+          }
+          lowerLimit = fromAmount;
+          if (upperLimit != 0n && nextAmount >= upperLimit) {
+            logger.error("Convergence failed: nextAmount >= upperLimit");
+            throw err;
+          }
+          newSwapInfo.token_from_amount = import_starknet9.uint256.bnToUint256(nextAmount);
+        }
       } else {
         logger.error("Unexpected error:", err);
+        throw err;
       }
       newSwapInfo.token_to_min_amount = import_starknet9.uint256.bnToUint256("0");
       return this.rebalanceIter(
         newSwapInfo,
         acc,
         estimateCall,
+        isSellTokenToken0,
         retry + 1,
-        adjustmentFactor,
-        isToken0Deficit
+        lowerLimit,
+        upperLimit
       );
     }
   }
@@ -18903,7 +18934,13 @@ var _riskFactor2 = [
 var AUDIT_URL2 = "https://assets.strkfarm.com/strkfarm/audit_report_vesu_and_ekubo_strats.pdf";
 var EkuboCLVaultStrategies = [{
   name: "Ekubo xSTRK/STRK",
-  description: _description2.replace("{{POOL_NAME}}", "xSTRK/STRK"),
+  description: /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { children: [
+    /* @__PURE__ */ (0, import_jsx_runtime.jsx)("p", { children: _description2.replace("{{POOL_NAME}}", "xSTRK/STRK") }),
+    /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("ul", { style: { marginLeft: "20px", listStyle: "circle", fontSize: "12px" }, children: [
+      /* @__PURE__ */ (0, import_jsx_runtime.jsx)("li", { style: { marginTop: "10px" }, children: "During withdrawal, you may receive either or both tokens depending on market conditions and prevailing prices." }),
+      /* @__PURE__ */ (0, import_jsx_runtime.jsx)("li", { style: { marginTop: "10px" }, children: "Sometimes you might see a negative APY \u2014 this is usually not a big deal. It happens when xSTRK's price drops on DEXes, but things typically bounce back within a few days or a week." })
+    ] })
+  ] }),
   address: ContractAddr.from("0x01f083b98674bc21effee29ef443a00c7b9a500fd92cf30341a3da12c73f2324"),
   type: "Other",
   // must be same order as poolKey token0 and token1

package/dist/index.mjs

@@ -2109,7 +2109,7 @@ var AutoCompounderSTRK = class {
   }
 };
 
-// src/strategies/vesu-rebalance.ts
+// src/strategies/vesu-rebalance.tsx
 import { CairoCustomEnum, Contract as Contract5, num as num3, uint256 as uint2563 } from "starknet";
 
 // src/data/vesu-rebalance.abi.json
@@ -12717,7 +12717,7 @@ var vesu_pools_default = {
   ]
 };
 
-// src/strategies/vesu-rebalance.ts
+// src/strategies/vesu-rebalance.tsx
 var VesuRebalance = class _VesuRebalance extends BaseStrategy {
   // 10000 bps = 100%
   /**
@@ -13218,7 +13218,7 @@ var VesuRebalanceStrategies = [{
   //     },
 }];
 
-// src/strategies/ekubo-cl-vault.ts
+// src/strategies/ekubo-cl-vault.tsx
 import { Contract as Contract6, num as num4, uint256 as uint2564 } from "starknet";
 
 // src/data/cl-vault.abi.json
@@ -18120,7 +18120,8 @@ var erc4626_abi_default = [
   }
 ];
 
-// src/strategies/ekubo-cl-vault.ts
+// src/strategies/ekubo-cl-vault.tsx
+import { jsx, jsxs } from "react/jsx-runtime";
 var EkuboCLVault = class _EkuboCLVault extends BaseStrategy {
   /**
    * Creates a new VesuRebalance strategy instance.
@@ -18649,11 +18650,10 @@ var EkuboCLVault = class _EkuboCLVault extends BaseStrategy {
    * @returns Array of contract calls needed for rebalancing
    * @throws Error if max retries reached without successful rebalance
    */
-  async rebalanceIter(swapInfo, acc, estimateCall, retry = 0, adjustmentFactor = 1, isToken0Deficit = true) {
-    const MAX_RETRIES = 20;
-    const MIN_ADJUSTMENT = 1e-3;
+  async rebalanceIter(swapInfo, acc, estimateCall, isSellTokenToken0 = true, retry = 0, lowerLimit = 0n, upperLimit = 0n) {
+    const MAX_RETRIES = 40;
     logger.verbose(
-      `Rebalancing ${this.metadata.name}: retry=${retry}, adjustment=${adjustmentFactor}%, token0Deficit=${isToken0Deficit}`
+      `Rebalancing ${this.metadata.name}: retry=${retry}, lowerLimit=${lowerLimit}, upperLimit=${upperLimit}, isSellTokenToken0=${isSellTokenToken0}`
     );
     const fromAmount = uint2564.uint256ToBN(swapInfo.token_from_amount);
     logger.verbose(
@@ -18668,38 +18668,69 @@ var EkuboCLVault = class _EkuboCLVault extends BaseStrategy {
         logger.error(`Rebalance failed after ${MAX_RETRIES} retries`);
         throw err;
       }
-      if (adjustmentFactor < MIN_ADJUSTMENT) {
-        logger.error("Adjustment factor too small, likely oscillating");
-        throw new Error("Failed to converge on valid swap amount");
-      }
       logger.error(`Rebalance attempt ${retry + 1} failed, adjusting swap amount...`);
       const newSwapInfo = { ...swapInfo };
       const currentAmount = Web3Number.fromWei(fromAmount.toString(), 18);
+      logger.verbose(`Current amount: ${currentAmount.toString()}`);
       if (err.message.includes("invalid token0 balance") || err.message.includes("invalid token0 amount")) {
-        logger.verbose("Reducing swap amount - excess token0");
-        newSwapInfo.token_from_amount = uint2564.bnToUint256(
-          currentAmount.multipliedBy((100 - adjustmentFactor) / 100).toWei()
-        );
-        adjustmentFactor = isToken0Deficit ? adjustmentFactor * 2 : adjustmentFactor / 2;
-        isToken0Deficit = true;
-      } else if (err.message.includes("invalid token1 balance") || err.message.includes("invalid token1 amount")) {
-        logger.verbose("Increasing swap amount - excess token1");
-        newSwapInfo.token_from_amount = uint2564.bnToUint256(
-          currentAmount.multipliedBy((100 + adjustmentFactor) / 100).toWei()
-        );
-        adjustmentFactor = isToken0Deficit ? adjustmentFactor / 2 : adjustmentFactor * 2;
-        isToken0Deficit = false;
+        if (!isSellTokenToken0) {
+          logger.verbose("Reducing swap amount - excess token0");
+          let nextAmount = (fromAmount + lowerLimit) / 2n;
+          upperLimit = fromAmount;
+          if (nextAmount <= lowerLimit) {
+            logger.error("Convergence failed: nextAmount <= lowerLimit");
+            throw err;
+          }
+          newSwapInfo.token_from_amount = uint2564.bnToUint256(nextAmount);
+        } else {
+          logger.verbose("Increasing swap amount - deficit token0");
+          let nextAmount = (fromAmount + upperLimit) / 2n;
+          if (upperLimit == 0n) {
+            nextAmount = fromAmount * 2n;
+          }
+          lowerLimit = fromAmount;
+          if (upperLimit != 0n && nextAmount >= upperLimit) {
+            logger.error("Convergence failed: nextAmount >= upperLimit");
+            throw err;
+          }
+          newSwapInfo.token_from_amount = uint2564.bnToUint256(nextAmount);
+        }
+      } else if (err.message.includes("invalid token1 amount") || err.message.includes("invalid token1 balance")) {
+        if (isSellTokenToken0) {
+          logger.verbose("Reducing swap amount - excess token1");
+          let nextAmount = (fromAmount + lowerLimit) / 2n;
+          upperLimit = fromAmount;
+          if (nextAmount <= lowerLimit) {
+            logger.error("Convergence failed: nextAmount <= lowerLimit");
+            throw err;
+          }
+          newSwapInfo.token_from_amount = uint2564.bnToUint256(nextAmount);
+        } else {
+          logger.verbose("Increasing swap amount - deficit token1");
+          let nextAmount = (fromAmount + upperLimit) / 2n;
+          if (upperLimit == 0n) {
+            nextAmount = fromAmount * 2n;
+          }
+          lowerLimit = fromAmount;
+          if (upperLimit != 0n && nextAmount >= upperLimit) {
+            logger.error("Convergence failed: nextAmount >= upperLimit");
+            throw err;
+          }
+          newSwapInfo.token_from_amount = uint2564.bnToUint256(nextAmount);
+        }
       } else {
         logger.error("Unexpected error:", err);
+        throw err;
       }
       newSwapInfo.token_to_min_amount = uint2564.bnToUint256("0");
       return this.rebalanceIter(
         newSwapInfo,
         acc,
         estimateCall,
+        isSellTokenToken0,
         retry + 1,
-        adjustmentFactor,
-        isToken0Deficit
+        lowerLimit,
+        upperLimit
       );
     }
   }
@@ -18834,7 +18865,13 @@ var _riskFactor2 = [
 var AUDIT_URL2 = "https://assets.strkfarm.com/strkfarm/audit_report_vesu_and_ekubo_strats.pdf";
 var EkuboCLVaultStrategies = [{
   name: "Ekubo xSTRK/STRK",
-  description: _description2.replace("{{POOL_NAME}}", "xSTRK/STRK"),
+  description: /* @__PURE__ */ jsxs("div", { children: [
+    /* @__PURE__ */ jsx("p", { children: _description2.replace("{{POOL_NAME}}", "xSTRK/STRK") }),
+    /* @__PURE__ */ jsxs("ul", { style: { marginLeft: "20px", listStyle: "circle", fontSize: "12px" }, children: [
+      /* @__PURE__ */ jsx("li", { style: { marginTop: "10px" }, children: "During withdrawal, you may receive either or both tokens depending on market conditions and prevailing prices." }),
+      /* @__PURE__ */ jsx("li", { style: { marginTop: "10px" }, children: "Sometimes you might see a negative APY \u2014 this is usually not a big deal. It happens when xSTRK's price drops on DEXes, but things typically bounce back within a few days or a week." })
+    ] })
+  ] }),
   address: ContractAddr.from("0x01f083b98674bc21effee29ef443a00c7b9a500fd92cf30341a3da12c73f2324"),
   type: "Other",
   // must be same order as poolKey token0 and token1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@strkfarm/sdk",
-  "version": "1.0.31",
+  "version": "1.0.33",
   "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",
@@ -41,6 +41,7 @@
   "devDependencies": {
     "@types/jest": "^29.5.12",
     "@types/node-telegram-bot-api": "^0.64.7",
+    "@types/react": "^19.1.2",
     "jest": "^29.7.0",
     "jest-environment-jsdom": "^29.7.0",
     "ts-jest": "^29.1.5",
@@ -49,6 +50,9 @@
     "typedoc": "^0.26.3",
     "typescript": "^5.5.3"
   },
+  "peerDependencies": {
+    "react": "19.1.0"
+  },
   "dependencies": {
     "@avnu/avnu-sdk": "^3.0.2",
     "axios": "^1.7.2",

package/src/interfaces/common.ts

@@ -1,5 +1,6 @@
 import { ContractAddr, Web3Number } from "@/dataTypes"
 import { BlockIdentifier, RpcProvider } from "starknet"
+import React from 'react';
 
 export enum RiskType {
     MARKET_RISK = 'Market Risk',
@@ -62,7 +63,7 @@ export enum FlowChartColors {
  */
 export interface IStrategyMetadata<T> {
     name: string,
-    description: string,
+    description: string | React.ReactNode,
     address: ContractAddr,
     type: 'ERC4626' | 'ERC721' | 'Other',
     depositTokens: TokenInfo[],