@strkfarm/sdk 2.0.0-dev.2 → 2.0.0-dev.21

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

@@ -786,7 +786,8 @@ function getLooperSettings(
     minHealthFactor: vaultSettings.minHealthFactor,
     quoteAmountToFetchPrice: vaultSettings.quoteAmountToFetchPrice,
     ...baseAdapterConfig,
-    supportedPositions: [{asset: lstToken, isDebt: false}, {asset: Global.getDefaultTokens().find(token => token.symbol === position)!, isDebt: true}]
+    supportedPositions: [{asset: lstToken, isDebt: false}, {asset: Global.getDefaultTokens().find(token => token.symbol === position)!, isDebt: true}],
+    minimumVesuMovementAmount: 0 
   }));
 
   const unusedBalanceAdapter = new UnusedBalanceAdapter({

package/src/strategies/universal-strategy.tsx

@@ -38,6 +38,11 @@ export enum AUMTypes {
   DEFISPRING = 'defispring'
 }
 
+export enum PositionTypeAvnuExtended {
+  OPEN = 'open',
+  CLOSE = 'close'
+}
+
 // export class UniversalStrategy<
 //   S extends UniversalStrategySettings
 // > extends BaseStrategy<

package/src/strategies/vesu-extended-strategy/services/operationService.ts

@@ -1,13 +1,16 @@
 import { Web3Number } from "@/dataTypes";
-import { TokenInfo } from "@/interfaces";
 import { ExtendedAdapter } from "@/strategies/universal-adapters/extended-adapter";
 import { VesuMultiplyAdapter } from "../../universal-adapters/vesu-multiply-adapter";
-import { Call } from "starknet";
+import { CycleType, TransactionResult } from "../types/transaction-metadata";
+
 export abstract class Operations {
+
   abstract shouldMoveAssets(
     extendedAmount: Web3Number,
     vesuAmount: Web3Number
-  ): Promise<Call[]>;
+  ): Promise<TransactionResult[]>;
+
+
   abstract shouldInvest(): Promise<{
     shouldInvest: boolean;
     vesuAmount: Web3Number;
@@ -15,20 +18,26 @@ export abstract class Operations {
     extendedLeverage: number;
     vesuLeverage: number;
   }>;
+
+  /**
+   * Move assets between protocols.
+   * Returns transaction calls and metadata for DB tracking.
+   */
   abstract moveAssets(
-    params: { from: string; to: string; amount: Web3Number },
+    params: { from: string; to: string; amount: Web3Number, cycleType: CycleType },
     extendedAdapter: ExtendedAdapter,
-    vesuAdapter: VesuMultiplyAdapter
-  ): Promise<{
-    calls: Call[];
-    status: boolean;
-  }>;
-  abstract handleDeposit(): Promise<{
+    vesuAdapter: VesuMultiplyAdapter,
+  ): Promise<TransactionResult>;
+  /**
+   * Handle deposit operation.
+   * Returns transaction calls and metadata for DB tracking.
+   */
+  abstract handleDeposit(): Promise<TransactionResult<{
     extendedAmountInBTC: Web3Number;
-    calls: Call[];
-  }>;
-  abstract handleWithdraw(amount: Web3Number): Promise<{
-    calls: Call[];
-    status: boolean;
-  }> ;
+  }>>;
+  /**
+   * Handle withdrawal operation.
+   * Returns transaction calls and metadata for DB tracking.
+   */
+  abstract handleWithdraw(amount: Web3Number): Promise<TransactionResult[]>;
 }

package/src/strategies/vesu-extended-strategy/types/transaction-metadata.ts

@@ -0,0 +1,36 @@
+import { Call } from "starknet";
+
+/**
+ * Transaction metadata that SDK generates and risk engine stores in DB.
+ * This metadata is used to track transaction lifecycle without coupling SDK to DB.
+ */
+export interface TransactionMetadata {
+  protocolFrom: string;
+  protocolTo: string;
+  transactionType: 'DEPOSIT' | 'WITHDRAWAL' | 'NONE';
+  usdAmount: string;
+  status: 'COMPLETED' | 'FAILED' | 'PENDING';
+  cycleType: CycleType;
+}
+
+
+export enum CycleType {
+  INVESTMENT = 'INVESTMENT',
+  REBALANCE_PRICE_DROP = 'REBALANCE_PRICE_DROP',
+  REBALANCE_PRICE_RISE = 'REBALANCE_PRICE_RISE',
+  WITHDRAWAL = 'WITHDRAWAL',
+  DELTA_NEUTRAL_ADJUSTMENT = 'DELTA_NEUTRAL_ADJUSTMENT',
+}
+
+/**
+ * Enhanced return type for operations that generate transactions.
+ * Includes both the calls (for execution) and metadata (for DB storage).
+ */
+export interface TransactionResult<T = any> {
+  calls: Call[];
+  status: boolean;
+  transactionMetadata: TransactionMetadata;
+}
+
+
+

package/src/strategies/vesu-extended-strategy/utils/constants.ts

@@ -12,17 +12,14 @@ export const MAX_LTV_BTC_USDC =  0.8428;
 export const MAX_LIQUIDATION_RATIO =  0.86;
 export const VAULT_ID_EXTENDED= process.env.VAULT_ID_EXTENDED ?? 220774;
 export const WALLET_ADDRESS =
-  process.env.WALLET_ADDRESS ?? "0x07b84bb6E87588BdAde0bfe6173A615b3C220F9C3803456aE183C50EA1d15Ba1";
-export const TESTNET_WALLET_ADDRESS =
-  process.env.TESTNET_WALLET_ADDRESS ?? "0x07b84bb6E87588BdAde0bfe6173A615b3C220F9C3803456aE183C50EA1d15Ba1";
-export const TEST_WALLET_2 =
-  process.env.TEST_WALLET_2 ?? "0x004C1bdC61DAc7947F3C93d0163d660012E2aB0521567f7155fcf502848791A7";
+  process.env.WALLET_ADDRESS ?? "0x007E24592287427aaE9d291770B17d582E8A45f3aE54228F998793Ec769B7D13";
 export const STRK_API_TEST_RPC = process.env.STRK_API_TEST_RPC ?? "https://sepolia.starknet.a5a.ch";
 export const STRK_API_RPC = process.env.STRK_API_RPC ?? "https://mainnet.starknet.a5a.ch";
 export const MAX_RETRIES = Number(process.env.MAX_RETRIES ?? 3);
 export const MAX_DELAY = Number(process.env.MAX_DELAY ?? 100);
 export const EXTEND_MARKET_NAME = "BTC-USD";
-export const LIMIT_BALANCE = Number(process.env.LIMIT_BALANCE ?? 10);
+export const LIMIT_BALANCE = Number(process.env.LIMIT_BALANCE ?? 0.05);
+export const LIMIT_BALANCE_VALUE=10;
 export const REBALANCER_INTERVAL = Number(process.env.REBALANCER_INTERVAL ?? 180000); //3 mins
 export const WITHDRAWAL_INTERVAL = Number(process.env.WITHDRAWAL_INTERVAL ?? 18000000); //5 hours
 export const INVESTING_INTERVAL = Number(process.env.INVESTING_INTERVAL ?? 180000); //3 mins

package/src/strategies/vesu-extended-strategy/utils/helper.ts

@@ -66,12 +66,10 @@ export const calculateAmountDistribution = async (
         vesu_leverage: 0,
       };
     }
-    const extendedBTCExposure =
+    const extendedExposureUSD =
       extendedPosition.length > 0
-        ? new Web3Number(extendedPosition[0].size, WBTC_TOKEN_DECIMALS)
+        ? new Web3Number(extendedPosition[0].value, WBTC_TOKEN_DECIMALS)
         : new Web3Number(0, WBTC_TOKEN_DECIMALS);
-    const extendedExposureUSD =
-      extendedBTCExposure.multipliedBy(collateralPrice);
     const vesuBTCExposureUSD = collateralUnits.multipliedBy(collateralPrice);
     const numerator1 = vesu_leverage * amount + vesuBTCExposureUSD.toNumber();
     const numerator2 = extendedExposureUSD.toNumber();
@@ -131,9 +129,6 @@ export const calculateAmountDistributionForWithdrawal = async (
     extendedPosition.length > 0
     ? new Web3Number(extendedPosition[0].value, USDC_TOKEN_DECIMALS)
     : new Web3Number(0, USDC_TOKEN_DECIMALS);
-    console.log("THe collateral is", collateralPrice, collateralUnits);
-    // console.log("the extended exposure usd is", extendedExposureUSD.toNumber());
-    //console.log("the collateral units are", collateralUnits.toNumber());\
     const vesuExposureUSD = collateralUnits.multipliedBy(collateralPrice);
     if (vesuExposureUSD.lessThan(0)) {
       return {
@@ -223,16 +218,16 @@ export const calculateDebtAmount = (
   collateralAmount: Web3Number,
   debtAmount: Web3Number,
   debtPrice: number,
-  maxLtv: number = MAX_LTV_BTC_USDC,
+  maxLtv: number = MAX_LIQUIDATION_RATIO,
   addedAmount: Web3Number, // this is in btc
   collateralPrice: number,
   isDeposit: boolean
 ) => {
   try {
     // => X = (((collateral + legDepositAmount) * collateralPrice * ltv) - (debt * debtPrice * target hf)) / (target hf - ltv)
-    const marginAmount = addedAmount.multipliedBy(isDeposit ? 1 : -1);
-    const numerator1 = collateralAmount
-      .plus(addedAmount)
+    const addedCollateral = addedAmount.multipliedBy(isDeposit ? 1 : -1);
+    const numerator1 = (collateralAmount
+      .plus(addedCollateral))
       .multipliedBy(collateralPrice)
       .multipliedBy(maxLtv);
     const numerator2 = debtAmount
@@ -308,21 +303,60 @@ export const calculateAmountDepositOnExtendedWhenIncurringLosses = async (
     const extendedHoldings = await client.getHoldings();
     const extended_leverage = calculateExtendedLevergae();
     const latestPosition = (await client.getPositions()).data.pop();
-    console.log("the latest position is", latestPosition, extendedHoldings);
     if (!extendedHoldings || !latestPosition) {
       logger.error(`error getting extended position: extendedHoldings=${extendedHoldings}, latestPosition=${latestPosition}`);
       return null;
     }
-    const positionValueInUSD = latestPosition.value;
+    const positionValueInUSD = new Web3Number(latestPosition.value, USDC_TOKEN_DECIMALS);
     const equity = extendedHoldings.data.equity;
-    const deposit =
-      Number(positionValueInUSD) / extended_leverage - Number(equity);
-    return new Web3Number(Math.floor(deposit / 0.2) * 0.2, USDC_TOKEN_DECIMALS);
+    const deposit = positionValueInUSD.dividedBy(extended_leverage).minus(equity).toFixed(2);
+    return new Web3Number(deposit, USDC_TOKEN_DECIMALS);
   } catch (err) {
+    logger.error(`error calculating amount deposit on extended when incurring losses: ${err}`);
     return null;
   }
 };
 
+/**
+ * calculate the amount of collateral to deposit to maintain the ltv
+ * The formula is:
+ * ((debt * debtPrice * targetHF) - (collateral * collateralPrice * ltv)) / ltv
+ * @param collateralAmount in collateral units
+ * @param debtAmount in debt units
+ * @param debtPrice in usd
+ * @param maxLtv 
+ * @param collateralPrice in usd
+ * @param targetHF 
+ * @returns deltaCollateralAmountUnits in collateral units
+ *          null if there is an error
+ */
+export const calculateWBTCAmountToMaintainLTV = (
+  collateralAmount: Web3Number,
+  debtAmount: Web3Number,
+  debtPrice: number,
+  maxLtv: number = MAX_LIQUIDATION_RATIO,
+  collateralPrice: number,
+  targetHF: number = TARGET_HF,
+) =>{
+  try {
+    const numerator1 = (collateralAmount)
+      .multipliedBy(collateralPrice)
+      .multipliedBy(maxLtv)
+    const numerator2 = debtAmount
+      .multipliedBy(debtPrice)
+      .multipliedBy(targetHF);
+    const denominator = maxLtv;
+    const collateralAmountToMaintainLTV = numerator2.minus(numerator1).dividedBy(denominator);
+    let deltaCollateralAmountUnits = new Web3Number(
+      collateralAmountToMaintainLTV.dividedBy(collateralPrice).toFixed(WBTC_TOKEN_DECIMALS),
+      WBTC_TOKEN_DECIMALS
+    );
+    return {deltaCollateralAmountUnits};
+  } catch (err) {
+    return { deltaCollateralAmountUnits: null };
+  }
+}
+
 export const calculateExposureDelta = (
   exposure_extended: number,
   exposure_vesu: number