@strkfarm/sdk 2.0.0-dev.35 → 2.0.0-dev.37

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@strkfarm/sdk",
-  "version": "2.0.0-dev.35",
+  "version": "2.0.0-dev.37",
   "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",
@@ -56,8 +56,8 @@
   "peerDependencies": {
     "@types/react": "^19.1.2",
     "axios": "^1.7.2",
-    "react": "19.1.0",
-    "starknet": "8.5.2"
+    "react": "19.1.2",
+    "starknet": "9.2.1"
   },
   "dependencies": {
     "@apollo/client": "3.11.8",

package/src/data/universal-vault.abi.json

@@ -1628,32 +1628,32 @@
       {
         "name": "ERC20Event",
         "type": "openzeppelin_token::erc20::erc20::ERC20Component::Event",
-        "kind": "nested"
+        "kind": "flat"
       },
       {
         "name": "ERC4626Event",
         "type": "openzeppelin_token::erc20::extensions::erc4626::erc4626::ERC4626Component::Event",
-        "kind": "nested"
+        "kind": "flat"
       },
       {
         "name": "SRC5Event",
         "type": "openzeppelin_introspection::src5::SRC5Component::Event",
-        "kind": "nested"
+        "kind": "flat"
       },
       {
         "name": "AccessControlEvent",
         "type": "openzeppelin_access::accesscontrol::accesscontrol::AccessControlComponent::Event",
-        "kind": "nested"
+        "kind": "flat"
       },
       {
         "name": "UpgradeableEvent",
         "type": "openzeppelin_upgrades::upgradeable::UpgradeableComponent::Event",
-        "kind": "nested"
+        "kind": "flat"
       },
       {
         "name": "PausableEvent",
         "type": "openzeppelin_security::pausable::PausableComponent::Event",
-        "kind": "nested"
+        "kind": "flat"
       },
       {
         "name": "RedeemRequested",
@@ -1677,4 +1677,5 @@
       }
     ]
   }
-]
+]
+

package/src/dataTypes/bignumber.browser.ts

@@ -1,4 +1,4 @@
-import BigNumber from "bignumber.js";
+import { Uint256, uint256 } from "starknet";
 import { _Web3Number } from "./_bignumber";
 
 export class Web3Number extends _Web3Number<Web3Number> {
@@ -10,4 +10,8 @@ export class Web3Number extends _Web3Number<Web3Number> {
     static fromNumber(number: number, decimals: number) {
         return new Web3Number(number.toString(), decimals);
     }
+
+    static fromUint256(uint256Value: Uint256): Web3Number {
+        return this.fromWei(uint256.uint256ToBN(uint256Value).toString(), 18);
+    }
 }

package/src/dataTypes/bignumber.node.ts

@@ -1,5 +1,6 @@
 import util from 'util';
 import { _Web3Number } from "./_bignumber";
+import { Uint256, uint256 } from 'starknet';
 
 export class Web3Number extends _Web3Number<Web3Number> {
 
@@ -12,6 +13,10 @@ export class Web3Number extends _Web3Number<Web3Number> {
         return new Web3Number(number.toString(), decimals);
     }
 
+    static fromUint256(uint256Value: Uint256): Web3Number {
+        return this.fromWei(uint256.uint256ToBN(uint256Value).toString(), 18);
+    }
+
     [util.inspect.custom](depth: any, opts: any): string {
         return this.toString();
     }

package/src/global.ts

@@ -230,7 +230,27 @@ const defaultTokens: TokenInfo[] = [
     coingeckId: undefined,
     displayDecimals: 2,
     priceCheckAmount: 100,
-}]
+}, {
+    name: 'strkBTC',
+    symbol: 'strkBTC',
+    logo: 'https://assets.troves.fi/integrations/tokens/strkbtc.svg',
+    address: ContractAddr.from('0x0787150e306e6eae6e3f79dea881770e8bbff2c1b8eb490f969669ee945b3135'),
+    decimals: 8,
+    coingeckId: undefined,
+    displayDecimals: 6,
+    priceCheckAmount: 0.001, // 112000 * 0.0001 = $110.2
+    priceProxySymbol: 'WBTC',
+}, {
+    name: 'xstrkBTC',
+    symbol: 'xstrkBTC',
+    logo: 'https://assets.troves.fi/integrations/tokens/xstrkbtc.svg',
+    address: ContractAddr.from('0x047751b3532fabca89b0f2e35ca1cb45e5a7b11d5e3d3663dfa1f4406b45fd88'),
+    decimals: 8,
+    coingeckId: undefined,
+    displayDecimals: 6,
+    priceCheckAmount: 0.001,
+    priceProxySymbol: 'WBTC',
+},]
 const tokens: TokenInfo[] = defaultTokens;
 
 /** Contains globally useful functions.

package/src/interfaces/common.tsx

@@ -55,6 +55,11 @@ export interface IProtocol {
   logo: string;
 }
 
+export interface ICurator {
+  name: string;
+  logo: string;
+}
+
 export enum StrategyTag {
   META_VAULT = "Meta Vaults",
   LEVERED = "Maxx",
@@ -67,6 +72,7 @@ export enum VaultType {
   META_VAULT = "Meta Vault",
   DELTA_NEUTRAL = "Delta Neutral",
   AUTOMATED_LP = "Automated LP",
+  TVA = "Troves Value Averaging",
 }
 
 // Security metadata enums
@@ -83,6 +89,7 @@ export enum SourceCodeType {
 export enum AccessControlType {
   MULTISIG_ACCOUNT = "Multisig Account",
   STANDARD_ACCOUNT = "Standard Account",
+  ROLE_BASED_ACCESS = "Role Based Access",
 }
 
 export enum InstantWithdrawalVault {
@@ -99,7 +106,7 @@ export interface SourceCodeInfo {
 export interface AccessControlInfo {
   type: AccessControlType;
   addresses: ContractAddr[];
-  timeLock: string;
+  timeLock?: string;
 }
 
 export interface SecurityMetadata {
@@ -160,6 +167,13 @@ export interface StrategySettings {
     tags?: StrategyTag[];
 }
 
+export interface StrategyApyHistoryUIConfig {
+  // Defaults to true in UI if omitted.
+  showApyHistory?: boolean;
+  // Optional message shown when APY history is hidden.
+  noApyHistoryMessage?: string;
+}
+
 /**
  * @property risk.riskFactor.factor - The risk factors that are considered for the strategy.
  * @property risk.riskFactor.factor - The value of the risk factor from 0 to 10, 0 being the lowest and 10 being the highest.
@@ -170,6 +184,19 @@ export interface IStrategyMetadata<T> {
   id: string;
   name: string;
   description: string | React.ReactNode;
+  /**
+   * Optional UI sort priority. Higher shows earlier.
+   * Intended for pinning flagship parent vaults (e.g. BTC above STRK).
+   */
+  priority?: number;
+  /**
+   * Optional UI config for the variant intro popup (strategy page).
+   * Should be identical across strategies that share the same `parentId`.
+   */
+  variantIntro?: {
+    title: string;
+    description: string;
+  };
   address: ContractAddr;
   launchBlock: number;
   type: "ERC4626" | "ERC721" | "Other";
@@ -186,7 +213,7 @@ export interface IStrategyMetadata<T> {
     notARisks: RiskType[];
   };
   apyMethodology?: string;
-  realizedAPYMethodology?: string;
+  realizedApyMethodology?: string;
   additionalInfo: T;
   contractDetails: {
     address: ContractAddr;
@@ -197,7 +224,7 @@ export interface IStrategyMetadata<T> {
   points?: {multiplier: number, logo: string, toolTip?: string}[];
   docs?: string;
   investmentSteps: string[];
-  curator?: { name: string, logo: string },
+  curator?: ICurator,
   isPreview?: boolean;
   tags?: StrategyTag[];
   security: SecurityMetadata;
@@ -210,6 +237,7 @@ export interface IStrategyMetadata<T> {
     info?: React.ReactNode | string;
   };
   settings?: StrategySettings;
+  apyHistoryUIConfig?: StrategyApyHistoryUIConfig;
     // Legacy field for multi-step strategies (deprecated, use investmentFlows instead)
     actions?: Array<{
         name?: string;
@@ -222,6 +250,8 @@ export interface IStrategyMetadata<T> {
         amount?: string | number;
         isDeposit?: boolean;
     }>;
+  parentId?: string;
+  parentName?: string;
 }
 
 export interface IInvestmentFlow {
@@ -337,7 +367,7 @@ export function highlightTextWithLinks(
       {parts.map((part, i) => {
         const match = highlights.find(m => m.highlight.toLowerCase() === part.toLowerCase());
         return match ? (
-          <a key={i} href={match.link} target="_blank" style={{ color: 'var(--chakra-colors-white)', background: 'var(--chakra-colors-highlight)' }}>
+          <a key={i} href={match.link} target="_blank" style={{ color: 'white', background: 'rgba(255, 255, 255, 0.04)' }}>
             {part}
           </a>
         ) : (
@@ -429,4 +459,9 @@ export const Protocols = {
   AVNU: AvnuProtocol,
   VAULT: VaultProtocol,
   TROVES: TrovesProtocol
+}
+
+export const UnwrapLabsCurator: ICurator = {
+  name: "Unwrap Labs",
+  logo: "https://assets.troves.fi/integrations/unwraplabs/white.png"
 }

package/src/modules/avnu.ts

@@ -4,7 +4,7 @@ import { Call, Uint256 } from "starknet";
 import { AvnuOptions, fetchBuildExecuteTransaction, fetchQuotes, Quote } from "@avnu/avnu-sdk";
 import { assert } from "../utils";
 import { logger } from "@/utils/logger";
-import { ContractAddr } from "@/dataTypes";
+import { ContractAddr, Web3Number } from "@/dataTypes";
 
 export interface Route {
     token_from: string,
@@ -15,12 +15,12 @@ export interface Route {
 }
 
 export interface SwapInfo {
-    token_from_address: string, 
-    token_from_amount: Uint256, 
-    token_to_address: string,   
-    token_to_amount: Uint256, 
-    token_to_min_amount: Uint256,  
-    beneficiary: string,  
+    token_from_address: string,
+    token_from_amount: Uint256,
+    token_to_address: string,
+    token_to_amount: Uint256,
+    token_to_min_amount: Uint256,
+    beneficiary: string,
     integrator_fee_amount_bps: number,
     integrator_fee_recipient: string,
     routes: Route[]
@@ -37,7 +37,7 @@ export class AvnuWrapper {
     excludeSources = ['Haiko(Solvers)']
   ): Promise<Quote> {
     const MAX_RETRY = 5;
-    // logger.verbose(`${AvnuWrapper.name}: getQuotes => Getting quotes for ${fromToken} -> ${toToken}, amount: ${amountWei}, taker: ${taker}, retry: ${retry}`);
+    logger.verbose(`${AvnuWrapper.name}: getQuotes => Getting quotes for ${fromToken} -> ${toToken}, amount: ${amountWei}, taker: ${taker}, retry: ${retry}`);
     const params: any = {
       sellTokenAddress: fromToken,
       buyTokenAddress: toToken,
@@ -59,7 +59,7 @@ export class AvnuWrapper {
         }
         throw new Error('no quotes found')
     }
-    
+
     return filteredQuotes[0];
   }
 
@@ -140,12 +140,21 @@ export class AvnuWrapper {
   async getSwapCallData(
     quote: Pick<Quote, 'quoteId' | 'buyTokenAddress' | 'buyAmount' | 'sellTokenAddress' | 'sellAmount'>,
     taker: string,
+    minAmount?: Web3Number,
   ) {
     const calldata = await fetchBuildExecuteTransaction(quote.quoteId, taker, undefined, false);
     const result = calldata.calls.map((call: Call) => {
       const data = call.calldata as string[];
       return data.map(x => BigInt(x));
     });
+
+    // override with given min amount out
+    if (minAmount) {
+      logger.verbose(`AvnuWrapper: minAmount passed ${minAmount.toString()}`)
+      const u256 = uint256.bnToUint256(minAmount.toWei());
+      result[0][6] = BigInt(u256.low);
+      result[0][7] = BigInt(u256.high);
+    }
     return result;
   }
-}
+}

package/src/modules/index.ts

@@ -10,4 +10,4 @@ export * from './pricer-lst';
 export * from './lst-apr';
 export * from './pricerBase';
 export * from './midas';
-export * from './ExtendedWrapperSDk';
+export * from './ekubo-pricer';

package/src/strategies/base-strategy.ts

@@ -29,6 +29,9 @@ export interface DualTokenInfo {
     token1: SingleTokenInfo
 }
 
+export type StrategyInputMode = "single" | "dual";
+export type InputModeFromAction<T> = T extends DualActionAmount ? "dual" : "single";
+
 export interface NetAPYSplit {
   apy: number;
   id: string;
@@ -39,18 +42,59 @@ export interface NetAPYDetails {
   splits: NetAPYSplit[];
 }
 
+export type UserPositionCardSubValueColor = "default" | "positive" | "negative" | "info";
+
+export interface UserPositionCard {
+  title: string;
+  value: string;
+  tooltip?: string;
+  subValue?: string;
+  subValueColor?: UserPositionCardSubValueColor;
+}
+
+export interface UserPositionCardsInput {
+  user: ContractAddr;
+  investmentFlows?: Array<{ amount: string; type: string; timestamp: number; tx_hash: string }>;
+  usualTimeToEarnings?: string | null;
+  usualTimeToEarningsDescription?: string | null;
+}
+
 interface CacheData {
   timestamp: number;
   ttl: number;
   data: any;
 }
-export class BaseStrategy<TVLInfo, ActionInfo> extends CacheClass {
-    readonly config: IConfig;
-    readonly cache: Map<string, CacheData> = new Map();
-
-    constructor(config: IConfig) {
+export class BaseStrategy<
+  TVLInfo,
+  DepositActionInfo,
+  WithdrawActionInfo = DepositActionInfo,
+> extends CacheClass {
+  readonly config: IConfig;
+  readonly cache: Map<string, CacheData> = new Map();
+  private readonly _depositInputMode: InputModeFromAction<DepositActionInfo>;
+  private readonly _withdrawInputMode: InputModeFromAction<WithdrawActionInfo>;
+
+    constructor(
+      config: IConfig,
+      inputModes?: {
+        depositInputMode?: InputModeFromAction<DepositActionInfo>;
+        withdrawInputMode?: InputModeFromAction<WithdrawActionInfo>;
+      }
+    ) {
         super();
         this.config = config;
+        this._depositInputMode = (inputModes?.depositInputMode ??
+          ("single" as InputModeFromAction<DepositActionInfo>));
+        this._withdrawInputMode = (inputModes?.withdrawInputMode ??
+          ("single" as InputModeFromAction<WithdrawActionInfo>));
+    }
+
+    depositInputMode(): InputModeFromAction<DepositActionInfo> {
+      return this._depositInputMode;
+    }
+
+    withdrawInputMode(): InputModeFromAction<WithdrawActionInfo> {
+      return this._withdrawInputMode;
     }
 
     async getUserTVL(user: ContractAddr, blockIdentifier?: BlockIdentifier): Promise<TVLInfo> {
@@ -61,11 +105,11 @@ export class BaseStrategy<TVLInfo, ActionInfo> extends CacheClass {
         throw new Error("Not implemented");
     }
 
-    async depositCall(amountInfo: ActionInfo, receiver: ContractAddr): Promise<Call[]> {
+    async depositCall(amountInfo: DepositActionInfo, receiver: ContractAddr): Promise<Call[]> {
         throw new Error("Not implemented");
     }
 
-    async withdrawCall(amountInfo: ActionInfo, receiver: ContractAddr, owner: ContractAddr): Promise<Call[]> {
+    async withdrawCall(amountInfo: WithdrawActionInfo, receiver: ContractAddr, owner: ContractAddr): Promise<Call[]> {
         throw new Error("Not implemented");
     }
 
@@ -77,7 +121,7 @@ export class BaseStrategy<TVLInfo, ActionInfo> extends CacheClass {
         blockIdentifier?: BlockIdentifier,
         sinceBlocks?: number,
         timeperiod?: "24h" | "7d" | "30d" | "3m"
-    ): Promise<number | NetAPYDetails> {
+    ): Promise<number | string | NetAPYDetails> {
         throw new Error("Not implemented");
     }
 
@@ -92,6 +136,46 @@ export class BaseStrategy<TVLInfo, ActionInfo> extends CacheClass {
         throw new Error("Not implemented");
     }
 
+    async getUserPositionCards(_input: UserPositionCardsInput): Promise<UserPositionCard[]> {
+      throw new Error("Not implemented");
+    }
+
+    async getMaxTVL() : Promise<Web3Number> {
+      // Can throw an error as well if needed, RN returning 0
+      return new Web3Number('0', 18)
+    }
+
+    protected formatTokenAmountForCard(amount: Web3Number, tokenInfo: TokenInfo): string {
+      const displayDecimals = tokenInfo.displayDecimals ?? 2;
+      const fixed = Number(amount.toFixed(displayDecimals));
+      const normalized = Number.isFinite(fixed) ? fixed : 0;
+      return `${normalized.toLocaleString("en-US", {
+        maximumFractionDigits: displayDecimals,
+        minimumFractionDigits: 0,
+      })} ${tokenInfo.symbol}`;
+    }
+
+    protected formatPercentForCard(value: number): string {
+      if (!Number.isFinite(value)) return "N/A";
+      return `${(value * 100).toFixed(2)}%`;
+    }
+
+    protected formatUSDForCard(value: number): string {
+      if (!Number.isFinite(value)) return "$0.00";
+      return new Intl.NumberFormat("en-US", {
+        style: "currency",
+        currency: "USD",
+        maximumFractionDigits: 2,
+      }).format(value);
+    }
+
+    protected getSubValueColorFromSignedNumber(value: number): UserPositionCardSubValueColor {
+      if (!Number.isFinite(value)) return "default";
+      if (value > 0) return "positive";
+      if (value < 0) return "negative";
+      return "default";
+    }
+
     /**
      * Calculate lifetime earnings for a user based on provided data from client
      * Formula: lifetimeEarnings = currentValue + totalWithdrawals - totalDeposits

package/src/strategies/constants.ts

@@ -1,12 +1,17 @@
 import { ContractAddr } from "@/dataTypes";
 
-export const COMMON_CONTRACTS = [{
+export const MY_ACCESS_CONTROL = {
   address: ContractAddr.from("0x0636a3f51cc37f5729e4da4b1de6a8549a28f3c0d5bf3b17f150971e451ff9c2"),
   name: "Access Controller",
   sourceCodeUrl: "https://github.com/strkfarm/strkfarm-contracts/blob/main/src/components/accessControl.cairo",
-}];
+};
+
+export const COMMON_CONTRACTS = [MY_ACCESS_CONTROL];
 
 export const ENDPOINTS = {
   VESU_BASE: "https://proxy.api.troves.fi/vesu",
   VESU_BASE_STAGING: "https://proxy.api.troves.fi/vesu-staging"
-}
+}
+
+
+export const MAX_AVNU_RETRY_DELAY = Number(process.env.MAX_AVNU_RETRY_DELAY ?? 100);