@strkfarm/sdk 2.0.0-dev.36 → 2.0.0-dev.38

package/dist/index.mjs

@@ -39180,6 +39180,7 @@ var HyperLSTStrategies = [
 
 // src/strategies/token-boosted-xstrk-carry-strategy.tsx
 import { uint256 as uint25625, num as num14 } from "starknet";
+import { jsx as jsx6, jsxs as jsxs5 } from "react/jsx-runtime";
 var BoostedxSTRKCarryStrategy = class _BoostedxSTRKCarryStrategy extends SVKStrategy {
   constructor(config, pricer, metadata) {
     super(config, pricer, metadata);
@@ -39818,15 +39819,15 @@ var boostedxSTRKCarrySettings = {
   leafAdapters: [],
   adapters: [],
   // Calc using the maxLTV / targetLTV (0.5)
-  targetHealthFactor: 1.32,
+  targetHealthFactor: 1.36,
   // Calc using the maxLTV / maxAcceptableLTV (0.55)
-  minHealthFactor: 1.2,
+  minHealthFactor: 1.3,
   vesuPoolId: VesuPools.Prime,
   // New metadata-driven token configuration
   depositToken: Global.getDefaultTokens().find((t) => t.symbol === "USDC"),
   debtToken: Global.getDefaultTokens().find((t) => t.symbol === "STRK"),
   lstHyperToken: Global.getDefaultTokens().find((t) => t.symbol === "xSTRK"),
-  maxLTV: 0.66,
+  maxLTV: 0.68,
   targetLTV: 0.5,
   // BTC.Fi rewards flag - false for USDC (uses old report flow)
   hasBtcFiRewards: false,
@@ -39857,13 +39858,13 @@ var wbtcBoostedSettings = {
   ),
   leafAdapters: [],
   adapters: [],
-  targetHealthFactor: 1.32,
-  minHealthFactor: 1.2,
+  targetHealthFactor: 1.4,
+  minHealthFactor: 1.35,
   vesuPoolId: VesuPools.Prime,
   depositToken: Global.getDefaultTokens().find((t) => t.symbol === "WBTC"),
   debtToken: Global.getDefaultTokens().find((t) => t.symbol === "STRK"),
   lstHyperToken: Global.getDefaultTokens().find((t) => t.symbol === "xSTRK"),
-  maxLTV: 0.66,
+  maxLTV: 0.7,
   targetLTV: 0.5,
   hasBtcFiRewards: true,
   hyperLstVaultAddress: ContractAddr.from(
@@ -39874,6 +39875,145 @@ var wbtcBoostedSettings = {
   ),
   trovesStrategyId: "hyper_xstrk"
 };
+var boostedCarryRiskFactors = [
+  {
+    type: "Smart Contract Risk" /* SMART_CONTRACT_RISK */,
+    value: 2 /* WELL_AUDITED */,
+    // 20% — core trust assumption; SVK is audited but still multi-contract (vault, manager, adapters).
+    weight: 20,
+    reason: "Built on the Starknet Vault Kit (SVK), with audits under the Sherlock-audited branch."
+  },
+  {
+    type: "Liquidation Risk" /* LIQUIDATION_RISK */,
+    value: 3 /* MODERATE_PROBABILITY */,
+    // 20% — tied with smart contract; uncorrelated collateral/debt is the main principal risk here.
+    weight: 20,
+    reason: "Collateral (USDC or WBTC) and STRK debt are not price-correlated. We target ~50% LTV and rebalance above ~55%, with a health-factor buffer, but extreme moves or prolonged monitoring gaps can still trigger liquidation."
+  },
+  {
+    type: "Low Liquidity Risk" /* LOW_LIQUIDITY_RISK */,
+    value: 3 /* MODERATE_CONCERNS */,
+    // 15% — below liquidation but above ops risks; every unwind/withdraw depends on xSTRK→STRK depth.
+    weight: 15,
+    reason: "Closing the loop requires selling xSTRK to STRK on DEXes to repay Vesu debt. xSTRK liquidity can be thin at fair prices; larger withdrawals or rebalances may take longer or complete in smaller chunks."
+  },
+  {
+    type: "Technical Risk" /* TECHNICAL_RISK */,
+    value: 3 /* SOME_COMPLEXITY */,
+    // 13% — monitoring/rebalancing stack matters, but usually recoverable without instant loss.
+    weight: 13,
+    reason: "Yield routes across Vesu, Avnu, and Hyper xSTRK with automated monitoring. Technical failures can delay rebalancing."
+  },
+  {
+    type: "Depeg Risk" /* DEPEG_RISK */,
+    value: 3 /* OCCASIONAL_DEPEG */,
+    // 12% — affects yield and swap notionals; USDC/WBTC depeg is rarer than xSTRK/STRK drift.
+    weight: 12,
+    reason: "xSTRK yield depends on its exchange rate vs STRK; USDC and WBTC carry standard stablecoin and BTC market risks."
+  },
+  {
+    type: "Oracle Risk" /* ORACLE_RISK */,
+    value: 2 /* SINGLE_RELIABLE */,
+    // 10% — Vesu HF depends on feeds; Starknet oracles are established but not redundant here.
+    weight: 10,
+    reason: "Vesu collateral and debt valuations rely on Starknet price feeds."
+  },
+  {
+    type: "Counterparty Risk" /* COUNTERPARTY_RISK */,
+    value: 2 /* REPUTABLE_COUNTERPARTY */,
+    // 10% — same tier as oracle; Vesu/Endur/Troves are mature but still protocol counterparty risk.
+    weight: 10,
+    reason: "Exposure to Vesu lending, Endur (xSTRK), and Troves Hyper vault infrastructure."
+  },
+  {
+    type: "Market Risk" /* MARKET_RISK */,
+    value: 3 /* MODERATE_VOLATILITY */,
+    // 5% — largely captured by liquidation + depeg factors; kept small to avoid double-counting vol.
+    weight: 5,
+    reason: "STRK, BTC, and stablecoin volatility can move loan-to-value and swap costs."
+  }
+];
+function getBoostedCarryRisk() {
+  const netRisk = boostedCarryRiskFactors.reduce(
+    (acc, curr) => acc + curr.value * curr.weight,
+    0
+  ) / boostedCarryRiskFactors.reduce((acc, curr) => acc + curr.weight, 0);
+  return {
+    riskFactor: boostedCarryRiskFactors,
+    netRisk,
+    notARisks: getNoRiskTags(boostedCarryRiskFactors)
+  };
+}
+function getBoostedCarryFAQs(depositSymbol, debtSymbol, lstSymbol) {
+  return [
+    {
+      question: `What is ${depositSymbol} Boosted?`,
+      answer: `${depositSymbol} Boosted is a carry-style vault: your ${depositSymbol} is supplied as collateral on Vesu, ${debtSymbol} is borrowed, swapped to ${lstSymbol}, and deposited into Hyper-${lstSymbol} for additional yield on top of the lending loop.`
+    },
+    {
+      question: "How does this strategy generate yield?",
+      answer: `Yield comes from several layers: ${lstSymbol} staking yield inside Hyper-${lstSymbol}, the spread between borrowing ${debtSymbol} and holding ${lstSymbol}, and efficient routing via Avnu. The vault targets about 50% loan-to-value and rebalances when LTV rises above ~55% so risk and yield stay in balance.`
+    },
+    {
+      question: "Which protocols are used?",
+      answer: /* @__PURE__ */ jsxs5("span", { children: [
+        /* @__PURE__ */ jsx6("strong", { children: "Vesu" }),
+        " for collateral and borrowing, ",
+        /* @__PURE__ */ jsx6("strong", { children: "Avnu" }),
+        " ",
+        "for swaps, ",
+        /* @__PURE__ */ jsx6("strong", { children: "Endur" }),
+        " for ",
+        lstSymbol,
+        ", and the Troves",
+        " ",
+        /* @__PURE__ */ jsxs5("strong", { children: [
+          "Hyper-",
+          lstSymbol
+        ] }),
+        " vault for the boosted leg."
+      ] })
+    },
+    {
+      question: "Is there liquidation risk?",
+      answer: `Yes. Your ${depositSymbol} collateral and ${debtSymbol} debt can move in different directions, which affects your health factor on Vesu. We actively monitor positions and rebalance automatically through our systems to keep loan-to-value near target. However, unexpected technical failures or very sharp market moves can still lead to liquidation. Under normal conditions we aim for a buffer of roughly 30% adverse price movement before liquidation becomes likely \u2014 but if monitoring is unavailable for many hours during a trending market, that buffer can be consumed. In extreme scenarios, liquidation remains possible.`
+    },
+    {
+      question: "What do I receive when I deposit?",
+      answer: "You receive vault tokens representing your share of the vault. They reflect both principal and accrued yield."
+    },
+    {
+      question: "How long do withdrawals take?",
+      answer: "Withdrawals typically take 1\u20132 hours. You receive an NFT for your request; funds are sent to the NFT owner once the vault unwinds its positions. The vault must sell xSTRK back to STRK to repay debt \u2014 if DEX liquidity is thin or your withdrawal is large, unwinding can take longer or happen in smaller steps to limit slippage."
+    },
+    {
+      question: "Is this vault non-custodial?",
+      answer: "Yes. The vault runs on-chain. You hold your vault tokens, and positions are transparent via on-chain contracts."
+    },
+    {
+      question: "Are there any fees?",
+      answer: "Troves charges a 10% performance fee on yield only \u2014 not on your deposited principal. The APY shown is already net of this fee. When you withdraw, a 0.1% redemption fee applies. That small fee helps keep the vault efficient for long-term depositors, very short stays create extra swap and rebalancing costs for everyone. If you stay for a reasonable period, your yield will typically far outweigh this one-time charge."
+    },
+    {
+      question: "Is the vault audited?",
+      answer: /* @__PURE__ */ jsxs5("span", { children: [
+        "Yes. The strategy is built on the audited Starknet Vault Kit. See the security details beside the strategy name and the",
+        " ",
+        /* @__PURE__ */ jsx6(
+          "a",
+          {
+            href: "https://github.com/trovesfi/starknet_vault_kit/tree/sherlock-audited",
+            target: "_blank",
+            rel: "noopener noreferrer",
+            style: { textDecoration: "underline" },
+            children: "open-source repo"
+          }
+        ),
+        "."
+      ] })
+    }
+  ];
+}
 function getStrategySettings2(settings, meta) {
   const depositToken = settings.depositToken;
   const debtToken = settings.debtToken;
@@ -39881,7 +40021,7 @@ function getStrategySettings2(settings, meta) {
   return {
     id: meta.id,
     name: meta.name,
-    description: `Deposits ${depositToken.symbol} as collateral on Vesu, borrows ${debtToken.symbol}, swaps to ${lstToken.symbol}, and deposits into Hyper-${lstToken.symbol} for boosted yield`,
+    description: `Deposits ${depositToken.symbol} as collateral on Vesu, borrows ${debtToken.symbol}, swaps to ${lstToken.symbol}, and deposits into Hyper-${lstToken.symbol} for boosted yield. Target LTV is about 50%, with rebalances happening when LTV is above 55%.`,
     address: settings.vaultAddress,
     launchBlock: meta.launchBlock,
     type: "ERC4626",
@@ -39891,13 +40031,8 @@ function getStrategySettings2(settings, meta) {
     },
     depositTokens: [depositToken],
     additionalInfo: getBoostedxSTRKCarrySettings(settings),
-    // TODO: config lateron
-    risk: {
-      riskFactor: [],
-      netRisk: 0,
-      notARisks: []
-    },
-    protocols: [Protocols.VESU, Protocols.TROVES],
+    risk: getBoostedCarryRisk(),
+    protocols: [Protocols.VESU, Protocols.ENDUR, Protocols.TROVES],
     curator: {
       name: "Unwrap Labs",
       logo: "https://assets.troves.fi/integrations/unwraplabs/white.png"
@@ -39905,7 +40040,7 @@ function getStrategySettings2(settings, meta) {
     settings: {
       maxTVL: Web3Number.fromWei(0, depositToken.decimals),
       isPaused: false,
-      isAudited: false,
+      isAudited: true,
       isInstantWithdrawal: false,
       hideHarvestInfo: true,
       quoteToken: depositToken,
@@ -39918,27 +40053,32 @@ function getStrategySettings2(settings, meta) {
       ]
     },
     contractDetails: getContractDetails(settings),
-    // TODO: config later
-    faqs: [],
+    faqs: getBoostedCarryFAQs(
+      depositToken.symbol,
+      debtToken.symbol,
+      lstToken.symbol
+    ),
+    apyMethodology: "APY reflects net returns after a 10% performance fee on yield (not on principal). Underlying xSTRK appreciation and Vesu borrow costs can move over time; displayed APY is an estimate.",
     investmentSteps: [
       `Deposit ${depositToken.symbol} into the vault`,
       `${depositToken.symbol} is supplied as collateral on Vesu, ${debtToken.symbol} is borrowed`,
       `Borrowed ${debtToken.symbol} is swapped to ${lstToken.symbol} via Avnu`,
       `${lstToken.symbol} is deposited into the Hyper-${lstToken.symbol} vault for additional yield`,
-      `On withdrawal, the pipeline reverses to return ${depositToken.symbol}`
+      `Actively monitored and rebalanced to maintain optimal LTV and yield.`
     ],
     // TODO: config later
     tags: ["Meta Vaults" /* META_VAULT */],
     security: {
       auditStatus: "Audited" /* AUDITED */,
       sourceCode: {
-        type: "Closed Source" /* CLOSED_SOURCE */,
-        contractLink: "https://github.com/trovesfi/troves-contracts"
+        type: "Open Source" /* OPEN_SOURCE */,
+        contractLink: "https://github.com/trovesfi/starknet_vault_kit/tree/sherlock-audited"
       },
+      // TODO
       accessControl: {
         type: "Standard Account" /* STANDARD_ACCOUNT */,
         addresses: [ContractAddr.from("0x0")],
-        timeLock: "2 Days"
+        timeLock: "0 Days"
       }
     },
     redemptionInfo: {
@@ -39957,8 +40097,8 @@ function getStrategySettings2(settings, meta) {
         }
       ]
     },
-    usualTimeToEarnings: null,
-    usualTimeToEarningsDescription: null
+    usualTimeToEarnings: "2 weeks",
+    usualTimeToEarningsDescription: "This strategy depends on Hyper xSTRK's yield, which depends on the price of xSTRK on DEX appreciating. It may be possible the increase is not continuous and generally rebases atleast once every 2 weeks."
   };
 }
 var BoostedxSTRKCarryStrategies = [
@@ -40132,6 +40272,7 @@ var FactoryStrategyType = /* @__PURE__ */ ((FactoryStrategyType2) => {
   FactoryStrategyType2["VESU_REBALANCE"] = "VESU_REBALANCE";
   FactoryStrategyType2["SENSEI"] = "SENSEI";
   FactoryStrategyType2["YOLO_VAULT"] = "YOLO_VAULT";
+  FactoryStrategyType2["BOOSTEDXSTRKCARRY"] = "BOOSTEDXSTRKCARRY";
   return FactoryStrategyType2;
 })(FactoryStrategyType || {});
 function createUniversalStrategy2(config, pricer, metadata) {
@@ -40152,6 +40293,9 @@ function createVesuRebalanceStrategy2(config, pricer, metadata) {
 function createSenseiStrategy(config, pricer, metadata) {
   return new SenseiVault(config, pricer, metadata);
 }
+function createBoostedXSTRKCarryStrategy(config, pricer, metadata) {
+  return new BoostedxSTRKCarryStrategy(config, pricer, metadata);
+}
 function getStrategyTypeFromMetadata(metadata) {
   const info = metadata.additionalInfo;
   if (info && "mainToken" in info && "secondaryToken" in info && "minEpochDurationSeconds" in info && "feeBps" in info) {
@@ -40160,6 +40304,9 @@ function getStrategyTypeFromMetadata(metadata) {
   if (info && "borrowable_assets" in info && "underlyingToken" in info) {
     return "HYPER_LST" /* HYPER_LST */;
   }
+  if (info && "depositToken" in info && "debtToken" in info && "lstToken" in info) {
+    return "BOOSTEDXSTRKCARRY" /* BOOSTEDXSTRKCARRY */;
+  }
   if (info && ("newBounds" in info || typeof info.newBounds !== "undefined") && "rebalanceConditions" in info && "quoteAsset" in info) {
     return "EKUBO_CL" /* EKUBO_CL */;
   }
@@ -40214,6 +40361,12 @@ function createStrategy(type, config, pricer, metadata) {
         pricer,
         metadata
       );
+    case "BOOSTEDXSTRKCARRY" /* BOOSTEDXSTRKCARRY */:
+      return createBoostedXSTRKCarryStrategy(
+        config,
+        pricer,
+        metadata
+      );
     default:
       throw new Error(`Unknown strategy type: ${type}`);
   }
@@ -40906,6 +41059,7 @@ export {
   assert,
   buildStrategyRegistry,
   configureLogger,
+  createBoostedXSTRKCarryStrategy,
   createEkuboCLStrategy,
   createHyperLSTStrategy,
   createSenseiStrategy,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@strkfarm/sdk",
-  "version": "2.0.0-dev.36",
+  "version": "2.0.0-dev.38",
   "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",

package/src/strategies/factory.ts

@@ -12,6 +12,7 @@ import {
 import { YoLoVault, YoloVaultSettings } from "./yoloVault";
 import { VesuRebalance, VesuRebalanceSettings } from "./vesu-rebalance";
 import { SenseiVault, SenseiVaultSettings } from "./sensei";
+import { BoostedxSTRKCarryStrategy, BoostedxSTRKCarryStrategySettings } from "./token-boosted-xstrk-carry-strategy";
 
 export enum FactoryStrategyType {
     UNIVERSAL = "UNIVERSAL",
@@ -19,7 +20,8 @@ export enum FactoryStrategyType {
     HYPER_LST = "HYPER_LST",
     VESU_REBALANCE = "VESU_REBALANCE",
     SENSEI = "SENSEI",
-    YOLO_VAULT = "YOLO_VAULT"
+    YOLO_VAULT = "YOLO_VAULT",
+    BOOSTEDXSTRKCARRY = "BOOSTEDXSTRKCARRY"
 }
 
 export function createUniversalStrategy(
@@ -70,6 +72,14 @@ export function createSenseiStrategy(
     return new SenseiVault(config, pricer, metadata);
 }
 
+export function createBoostedXSTRKCarryStrategy(
+    config: IConfig,
+    pricer: PricerBase,
+    metadata: IStrategyMetadata<BoostedxSTRKCarryStrategySettings>
+): BoostedxSTRKCarryStrategy<BoostedxSTRKCarryStrategySettings> {
+    return new BoostedxSTRKCarryStrategy<BoostedxSTRKCarryStrategySettings>(config, pricer, metadata);
+}
+
 /**
  * Determines the strategy type from metadata by inspecting the additionalInfo structure
  */
@@ -77,7 +87,7 @@ export function getStrategyTypeFromMetadata(
     metadata: IStrategyMetadata<any>
 ): FactoryStrategyType {
     const info = metadata.additionalInfo;
- 
+
     if (info && "mainToken" in info && "secondaryToken" in info && "minEpochDurationSeconds" in info && "feeBps" in info) {
         return FactoryStrategyType.YOLO_VAULT;
     }
@@ -87,6 +97,10 @@ export function getStrategyTypeFromMetadata(
         return FactoryStrategyType.HYPER_LST;
     }
 
+    if (info && "depositToken" in info && "debtToken" in info && "lstToken" in info) {
+        return FactoryStrategyType.BOOSTEDXSTRKCARRY;
+    }
+
     // Check for EkuboCL (has newBounds, rebalanceConditions, quoteAsset)
     if (
         info &&
@@ -173,7 +187,13 @@ export function createStrategy(
                 pricer,
                 metadata as IStrategyMetadata<YoloVaultSettings>
             );
+        case FactoryStrategyType.BOOSTEDXSTRKCARRY:
+            return createBoostedXSTRKCarryStrategy(
+                config,
+                pricer,
+                metadata as IStrategyMetadata<BoostedxSTRKCarryStrategySettings>
+            );
         default:
             throw new Error(`Unknown strategy type: ${type}`);
     }
-}
+}