@strkfarm/sdk 1.2.1 → 2.0.0-dca.2

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-import BigNumber from 'bignumber.js';
 import * as starknet from 'starknet';
-import { RpcProvider, BlockIdentifier, Contract, Uint256, Call, Account, CairoCustomEnum, RawArgs } from 'starknet';
+import { Uint256, RpcProvider, BlockIdentifier, Contract, Call, Account, CairoCustomEnum, RawArgs } from 'starknet';
+import BigNumber from 'bignumber.js';
 import React, { ReactNode } from 'react';
 import { Quote, AvnuOptions } from '@avnu/avnu-sdk';
 import { HexString, BytesLike } from '@ericnordelo/strk-merkle-tree/dist/bytes';
@@ -31,10 +31,12 @@ declare class _Web3Number<T extends _Web3Number<T>> extends BigNumber {
         mag: bigint;
         sign: 0 | 1;
     };
+    toUint256(): starknet.Uint256;
 }
 
 declare class Web3Number extends _Web3Number<Web3Number> {
     static fromWei(weiNumber: string | number, decimals: number): Web3Number;
+    static fromUint256(uint256Value: Uint256): Web3Number;
 }
 
 /**
@@ -53,6 +55,33 @@ declare class ContractAddr {
     toBigInt(): bigint;
 }
 
+declare const customInspectSymbol: unique symbol;
+declare class MyNumber {
+    bigNumber: BigNumber;
+    decimals: number;
+    constructor(bigNumber: string, decimals: number);
+    static fromEther(num: string, decimals: number): MyNumber;
+    static fromZero(): MyNumber;
+    toString(): string;
+    toEtherStr(): string;
+    toFixedStr(decimals: number): string;
+    toEtherToFixedDecimals(decimals: number): string;
+    isZero(): boolean;
+    /**
+     *
+     * @param amountEther in token terms without decimal e.g. 1 for 1 STRK
+     * @param command BigNumber compare funds. e.g. gte, gt, lt
+     * @returns
+     * @dev Add more commands as needed
+     */
+    compare(amountEther: string, command: "gte" | "gt" | "lt"): boolean;
+    operate(command: "div" | "plus" | "mul", value: string | number): MyNumber;
+    subtract(value: MyNumber): MyNumber;
+    static min(a: MyNumber, b: MyNumber): MyNumber;
+    static max(a: MyNumber, b: MyNumber): MyNumber;
+    [customInspectSymbol](depth: any, inspectOptions: any, inspect: any): string;
+}
+
 declare enum RiskType {
     MARKET_RISK = "Market Risk",
     IMPERMANENT_LOSS = "Impermanent Loss Risk",
@@ -96,6 +125,57 @@ interface IProtocol {
     name: string;
     logo: string;
 }
+declare enum StrategyTag {
+    META_VAULT = "Meta Vaults",
+    LEVERED = "Maxx",
+    AUTOMATED_LP = "Ekubo",
+    BTC = "BTC"
+}
+declare enum VaultType {
+    LOOPING = "Looping",
+    META_VAULT = "Meta Vault",
+    DELTA_NEUTRAL = "Delta Neutral",
+    AUTOMATED_LP = "Automated LP",
+    Other = "Other"
+}
+declare enum AuditStatus {
+    AUDITED = "Audited",
+    NOT_AUDITED = "Not Audited"
+}
+declare enum SourceCodeType {
+    OPEN_SOURCE = "Open Source",
+    CLOSED_SOURCE = "Closed Source"
+}
+declare enum AccessControlType {
+    MULTISIG_ACCOUNT = "Multisig Account",
+    STANDARD_ACCOUNT = "Standard Account"
+}
+declare enum InstantWithdrawalVault {
+    YES = "Yes",
+    NO = "No"
+}
+interface SourceCodeInfo {
+    type: SourceCodeType;
+    contractLink: string;
+}
+interface AccessControlInfo {
+    type: AccessControlType;
+    addresses: ContractAddr[];
+    timeLock: string;
+}
+interface SecurityMetadata {
+    auditStatus: AuditStatus;
+    sourceCode: SourceCodeInfo;
+    accessControl: AccessControlInfo;
+}
+interface RedemptionInfo {
+    instantWithdrawalVault: InstantWithdrawalVault;
+    redemptionsInfo: {
+        title: string;
+        description: string;
+    }[];
+    alerts: StrategyAlert[];
+}
 declare enum FlowChartColors {
     Green = "purple",
     Blue = "#35484f",
@@ -105,26 +185,62 @@ interface FAQ {
     question: string | React.ReactNode;
     answer: string | React.ReactNode;
 }
+declare enum StrategyLiveStatus {
+    ACTIVE = "Active",
+    NEW = "New",
+    COMING_SOON = "Coming Soon",
+    DEPRECATED = "Deprecated",// active but not recommended
+    RETIRED = "Retired",// not active anymore
+    HOT = "Hot & New \uD83D\uDD25"
+}
+interface StrategyAlert {
+    type: "warning" | "info";
+    text: string | React.ReactNode;
+    tab: "all" | "deposit" | "withdraw";
+}
+interface StrategySettings {
+    maxTVL?: Web3Number;
+    liveStatus?: StrategyLiveStatus;
+    isPaused?: boolean;
+    isInMaintenance?: boolean;
+    isAudited: boolean;
+    isInstantWithdrawal?: boolean;
+    hideHarvestInfo?: boolean;
+    is_promoted?: boolean;
+    isTransactionHistDisabled?: boolean;
+    quoteToken: TokenInfo;
+    hideNetEarnings?: boolean;
+    showWithdrawalWarningModal?: boolean;
+    alerts?: StrategyAlert[];
+    tags?: StrategyTag[];
+}
 /**
  * @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.
+ * @property security - Security-related metadata including audit status, source code information, and access control details.
+ * @property redemptionInfo - Redemption information including instant withdrawal availability and expected redemption times.
  */
 interface IStrategyMetadata<T> {
+    id: string;
     name: string;
     description: string | React.ReactNode;
     address: ContractAddr;
     launchBlock: number;
     type: "ERC4626" | "ERC721" | "Other";
+    vaultType: {
+        type: VaultType;
+        description: string;
+    };
     depositTokens: TokenInfo[];
     protocols: IProtocol[];
     auditUrl?: string;
-    maxTVL: Web3Number;
     risk: {
         riskFactor: RiskFactor[];
         netRisk: number;
         notARisks: RiskType[];
     };
     apyMethodology?: string;
+    realizedAPYMethodology?: string;
     additionalInfo: T;
     contractDetails: {
         address: ContractAddr;
@@ -144,6 +260,36 @@ interface IStrategyMetadata<T> {
         logo: string;
     };
     isPreview?: boolean;
+    tags?: StrategyTag[];
+    security: SecurityMetadata;
+    redemptionInfo: RedemptionInfo;
+    usualTimeToEarnings: null | string;
+    usualTimeToEarningsDescription: null | string;
+    discontinuationInfo?: {
+        date?: Date;
+        reason?: React.ReactNode | string;
+        info?: React.ReactNode | string;
+    };
+    settings?: StrategySettings;
+    actions?: Array<{
+        name?: string;
+        pool?: {
+            protocol?: {
+                name: string;
+                logo: string;
+            };
+            pool?: {
+                name: string;
+                logos?: string[];
+            };
+            apr?: number;
+            borrow?: {
+                apr?: number;
+            };
+        };
+        amount?: string | number;
+        isDeposit?: boolean;
+    }>;
 }
 interface IInvestmentFlow {
     id?: string;
@@ -156,6 +302,8 @@ interface IInvestmentFlow {
     style?: any;
 }
 declare function getMainnetConfig(rpcUrl?: string, blockIdentifier?: BlockIdentifier): IConfig;
+declare const getStrategyTagDesciption: (tag: StrategyTag) => string;
+declare const getAllStrategyTags: () => StrategyTag[];
 declare const getRiskExplaination: (riskType: RiskType) => "The risk of the market moving against the position." | "The temporary loss of value experienced by liquidity providers in AMMs when asset prices diverge compared to simply holding them." | "The risk of losing funds due to the position being liquidated." | "The risk of low liquidity in the pool, which can lead to high slippages or reduced in-abilities to quickly exit the position." | "The risk of the oracle being manipulated or incorrect." | "The risk of the smart contract being vulnerable to attacks." | "The risk of technical issues e.g. backend failure." | "The risk of the counterparty defaulting e.g. bad debt on lending platforms." | "The risk of a token losing its peg to the underlying asset, leading to potential losses for holders.";
 declare const getRiskColor: (risk: RiskFactor) => "light_green_2" | "yellow" | "red";
 declare const getNoRiskTags: (risks: RiskFactor[]) => RiskType[];
@@ -170,6 +318,27 @@ interface VaultPosition {
     token: TokenInfo;
     remarks: string;
 }
+interface AmountInfo {
+    amount: Web3Number;
+    usdValue: number;
+    tokenInfo: TokenInfo;
+}
+interface AmountsInfo {
+    usdValue: number;
+    amounts: AmountInfo[];
+}
+/**
+ * Strategy capabilities interface
+ * Describes what optional methods a strategy instance supports
+ */
+interface StrategyCapabilities {
+    hasMatchInputAmounts: boolean;
+    hasNetAPY: boolean;
+    hasGetInvestmentFlows: boolean;
+    hasGetPendingRewards: boolean;
+    hasHarvest: boolean;
+    hasRebalance: boolean;
+}
 declare const Protocols: {
     VESU: IProtocol;
     ENDUR: IProtocol;
@@ -232,7 +401,7 @@ declare abstract class PricerBase {
     readonly config: IConfig;
     readonly tokens: TokenInfo[];
     constructor(config: IConfig, tokens: TokenInfo[]);
-    getPrice(tokenSymbol: string): Promise<PriceInfo>;
+    getPrice(tokenSymbol: string, blockNumber?: BlockIdentifier): Promise<PriceInfo>;
 }
 
 interface PriceInfo {
@@ -259,7 +428,7 @@ declare class Pricer extends PricerBase {
     start(): void;
     isStale(timestamp: Date, tokenName: string): boolean;
     assertNotStale(timestamp: Date, tokenName: string): void;
-    getPrice(tokenSymbol: string): Promise<PriceInfo>;
+    getPrice(tokenSymbol: string, blockNumber?: BlockIdentifier): Promise<PriceInfo>;
     protected _loadPrices(onUpdate?: (tokenSymbol: string) => void): void;
     _getPrice(token: TokenInfo, defaultMethod?: string): Promise<number>;
     _getPriceCoinbase(token: TokenInfo): Promise<number>;
@@ -268,11 +437,11 @@ declare class Pricer extends PricerBase {
     _getPriceEkubo(token: TokenInfo, amountIn?: Web3Number, retry?: number): Promise<number>;
 }
 
-declare class Pragma {
+declare class Pragma extends PricerBase {
     contractAddr: string;
     readonly contract: Contract;
-    constructor(provider: RpcProvider);
-    getPrice(tokenAddr: string): Promise<number>;
+    constructor(config: IConfig, tokens: TokenInfo[]);
+    getPrice(tokenAddr: string, blockIdentifier?: BlockIdentifier): Promise<PriceInfo>;
 }
 
 declare class ZkLend extends ILending implements ILending {
@@ -307,12 +476,23 @@ declare class ZkLend extends ILending implements ILending {
 }
 
 declare class PricerFromApi extends PricerBase {
+    private apolloClient;
+    private pragma;
+    private ekuboPricer;
+    private readonly PRAGMA_SUPPORTED_TOKENS;
     constructor(config: IConfig, tokens: TokenInfo[]);
-    getPrice(tokenSymbol: string): Promise<PriceInfo>;
+    getPrice(tokenSymbol: string, blockNumber?: BlockIdentifier): Promise<PriceInfo>;
     getPriceFromMyAPI(tokenSymbol: string): Promise<{
         price: number;
         timestamp: Date;
     }>;
+    /**
+     * Fetches historical price for a token at a specific block number
+     * @param tokenSymbol - The token symbol to get price for
+     * @param blockNumber - The block number to query
+     * @returns PriceInfo with price at the closest block <= blockNumber
+     */
+    getHistoricalPrice(tokenSymbol: string, blockNumber: BlockIdentifier): Promise<PriceInfo>;
 }
 
 declare class ERC20 {
@@ -321,6 +501,7 @@ declare class ERC20 {
     contract(addr: string | ContractAddr): Contract;
     balanceOf(token: string | ContractAddr, address: string | ContractAddr, tokenDecimals: number): Promise<Web3Number>;
     allowance(token: string | ContractAddr, owner: string | ContractAddr, spender: string | ContractAddr, tokenDecimals: number): Promise<Web3Number>;
+    approve(token: string | ContractAddr, spender: string | ContractAddr, amount: Web3Number): starknet.Call;
 }
 
 interface Route {
@@ -418,6 +599,14 @@ interface DualTokenInfo {
     token0: SingleTokenInfo;
     token1: SingleTokenInfo;
 }
+interface NetAPYSplit {
+    apy: number;
+    id: string;
+}
+interface NetAPYDetails {
+    net: number;
+    splits: NetAPYSplit[];
+}
 interface CacheData {
     timestamp: number;
     ttl: number;
@@ -427,12 +616,34 @@ declare class BaseStrategy<TVLInfo, ActionInfo> extends CacheClass {
     readonly config: IConfig;
     readonly cache: Map<string, CacheData>;
     constructor(config: IConfig);
-    getUserTVL(user: ContractAddr): Promise<TVLInfo>;
+    getUserTVL(user: ContractAddr, blockIdentifier?: BlockIdentifier): Promise<TVLInfo>;
     getTVL(): Promise<TVLInfo>;
     depositCall(amountInfo: ActionInfo, receiver: ContractAddr): Promise<Call[]>;
     withdrawCall(amountInfo: ActionInfo, receiver: ContractAddr, owner: ContractAddr): Promise<Call[]>;
     getVaultPositions(): Promise<VaultPosition[]>;
+    netAPY(blockIdentifier?: BlockIdentifier, sinceBlocks?: number, timeperiod?: "24h" | "7d" | "30d" | "3m"): Promise<number | NetAPYDetails>;
     getPendingRewards(): Promise<HarvestInfo[]>;
+    getUserRealizedAPY(blockIdentifier?: BlockIdentifier, sinceBlocks?: number): Promise<number>;
+    /**
+     * Calculate lifetime earnings for a user based on provided data from client
+     * Formula: lifetimeEarnings = currentValue + totalWithdrawals - totalDeposits
+     *
+     * @param userTVL - The user's current TVL (SingleTokenInfo with amount, usdValue, tokenInfo)
+     * @param investmentFlows - Array of investment flow transactions from client
+     * @returns Object containing lifetime earnings, current value, and total deposits/withdrawals
+     */
+    getLifetimeEarnings(userTVL: SingleTokenInfo, investmentFlows: Array<{
+        amount: string;
+        type: string;
+        timestamp: number;
+        tx_hash: string;
+    }>): {
+        tokenInfo: SingleTokenInfo;
+        lifetimeEarnings: Web3Number;
+        currentValue: Web3Number;
+        totalDeposits: Web3Number;
+        totalWithdrawals: Web3Number;
+    };
 }
 
 interface PoolProps {
@@ -513,16 +724,16 @@ declare class VesuRebalance extends BaseStrategy<SingleTokenInfo, SingleActionAm
      * @returns Number of decimals (same as the underlying token)
      */
     decimals(): number;
-    /**
-     * Calculates the Total Value Locked (TVL) for a specific user.
-     * @param user - Address of the user
-     * @returns Object containing the amount in token units and USD value
-     */
-    getUserTVL(user: ContractAddr): Promise<{
+    getUserTVL(user: ContractAddr, blockIdentifier?: BlockIdentifier): Promise<{
         tokenInfo: TokenInfo;
         amount: Web3Number;
         usdValue: number;
     }>;
+    /**
+     * Calculates user realized APY based on trueSharesBasedAPY method.
+     * Returns the APY as a number.
+     */
+    getUserRealizedAPY(blockIdentifier?: BlockIdentifier, sinceBlocks?: number): Promise<number>;
     /**
      * Calculates the total TVL of the strategy.
      * @returns Object containing the total amount in token units and USD value
@@ -718,11 +929,30 @@ declare class EkuboCLVault extends BaseStrategy<DualTokenInfo, DualActionAmount>
     rebalanceCall(newBounds: EkuboBounds, swapParams: SwapInfo): Call[];
     handleUnusedCall(swapParams: SwapInfo): Call[];
     handleFeesCall(): Call[];
-    getFeeHistory(timePeriod?: '24h' | '7d' | '30d' | '3m'): Promise<{
+    getFeeHistory(timePeriod?: '24h' | '7d' | '30d' | '3m' | '6m', range?: {
+        startTimestamp?: number;
+        endTimestamp?: number;
+    }): Promise<{
         summary: DualTokenInfo;
         history: FeeHistory[];
     }>;
     netSharesBasedTrueAPY(blockIdentifier?: BlockIdentifier, sinceBlocks?: number): Promise<number>;
+    /**
+     * Calculate lifetime earnings for a user
+     * Not yet implemented for Ekubo CL Vault strategy
+     */
+    getLifetimeEarnings(userTVL: SingleTokenInfo, investmentFlows: Array<{
+        amount: string;
+        type: string;
+        timestamp: number;
+        tx_hash: string;
+    }>): any;
+    /**
+     * Calculates realized APY based on TVL per share growth, always valued in USDC.
+     * This is a vault-level metric (same for all users) and works for all strategies,
+     * regardless of quote asset configuration.
+     */
+    getUserRealizedAPY(blockIdentifier?: BlockIdentifier, sinceBlocks?: number): Promise<number>;
     feeBasedAPY(timeperiod?: '24h' | '7d' | '30d' | '3m'): Promise<number>;
     /**
      * Calculates assets before and now in a given token of TVL per share to observe growth
@@ -904,7 +1134,7 @@ declare class SenseiVault extends BaseStrategy<SingleTokenInfo, SingleActionAmou
     readonly pricer: PricerBase;
     readonly contract: Contract;
     constructor(config: IConfig, pricer: PricerBase, metadata: IStrategyMetadata<SenseiVaultSettings>);
-    getUserTVL(user: ContractAddr): Promise<SingleTokenInfo>;
+    getUserTVL(user: ContractAddr, blockIdentifier?: BlockIdentifier): Promise<SingleTokenInfo>;
     getTVL(): Promise<SingleTokenInfo>;
     depositCall(amountInfo: SingleActionAmount, receiver: ContractAddr): Promise<Call[]>;
     withdrawCall(amountInfo: SingleActionAmount, receiver: ContractAddr, owner: ContractAddr): Promise<Call[]>;
@@ -918,9 +1148,67 @@ declare class SenseiVault extends BaseStrategy<SingleTokenInfo, SingleActionAmou
     }>;
     getSecondaryTokenPriceRelativeToMain(retry?: number): Promise<number>;
     getSettings: () => Promise<starknet.CallResult>;
+    /**
+     * Calculate lifetime earnings for a user
+     * Not yet implemented for Sensei Vault strategy
+     */
+    getLifetimeEarnings(userTVL: SingleTokenInfo, investmentFlows: Array<{
+        amount: string;
+        type: string;
+        timestamp: number;
+        tx_hash: string;
+    }>): any;
+    netAPY(): Promise<number>;
+    /**
+     * Calculates user realized APY based on position growth accounting for deposits and withdrawals.
+     * Returns the APY as a number.
+     * Not implemented for Sensei Strategy yet.
+     */
+    getUserRealizedAPY(blockIdentifier?: BlockIdentifier, sinceBlocks?: number): Promise<number>;
 }
 declare const SenseiStrategies: IStrategyMetadata<SenseiVaultSettings>[];
 
+interface YoloVaultSettings {
+    mainToken: TokenInfo;
+    secondaryToken: TokenInfo;
+    maxUnitsSpendPerEpoch: number;
+    feeBps: number;
+}
+interface UserYoloInfo {
+    shares: bigint;
+    claimable_second_tokens: bigint;
+    base_token_balance: bigint;
+    second_token_last_index: bigint;
+    second_token_balance: bigint;
+}
+interface YoloVaultStatus {
+    current_epoch: bigint;
+    total_epochs: bigint;
+    remaining_base: bigint;
+    total_second_tokens: bigint;
+    global_second_token_index: bigint;
+    total_shares: bigint;
+    base_token_assets_per_share: bigint;
+}
+declare class YoLoVault extends BaseStrategy<DualTokenInfo, DualActionAmount> {
+    readonly address: ContractAddr;
+    readonly metadata: IStrategyMetadata<YoloVaultSettings>;
+    readonly pricer: PricerBase;
+    readonly contract: Contract;
+    constructor(config: IConfig, pricer: PricerBase, metadata: IStrategyMetadata<YoloVaultSettings>);
+    formatTokenAmount(amount: Web3Number, decimals: number): Web3Number;
+    private getNormalizedUserInfo;
+    private resolveWithdrawRequest;
+    getUserTVL(user: ContractAddr): Promise<DualTokenInfo>;
+    getTVL(): Promise<DualTokenInfo>;
+    depositCall(amountInfo: DualActionAmount): Promise<Call[]>;
+    getVaultStatus(): Promise<YoloVaultStatus>;
+    matchInputAmounts(amountInfo: DualActionAmount, user: ContractAddr): Promise<DualActionAmount>;
+    withdrawCall(amountInfo: DualActionAmount, receiver: ContractAddr, owner: ContractAddr): Promise<Call[]>;
+    getSettings: () => Promise<starknet.CallResult>;
+}
+declare const YoloVaultStrategies: IStrategyMetadata<YoloVaultSettings>[];
+
 interface LeveledLogMethod {
     (message: string, ...meta: any[]): void;
     (message: any): void;
@@ -954,6 +1242,24 @@ declare class StandardMerkleTree extends MerkleTreeImpl<LeafData> {
     dump(): StandardMerkleTreeData<LeafData>;
 }
 
+/**
+ * Convert SDK TVL info (SingleTokenInfo or DualTokenInfo) to client AmountsInfo format
+ */
+declare function toAmountsInfo(tvlInfo: SingleTokenInfo | DualTokenInfo): Omit<AmountsInfo, "amounts"> & {
+    amounts: Array<{
+        amount: Web3Number;
+        tokenInfo: TokenInfo;
+    }>;
+};
+/**
+ * Detect what capabilities a strategy instance has
+ */
+declare function detectCapabilities(strategy: BaseStrategy<any, any>): StrategyCapabilities;
+/**
+ * Check if a strategy is a dual-token strategy
+ */
+declare function isDualTokenStrategy(strategy: BaseStrategy<any, any>): boolean;
+
 type RequiredFields<T> = {
     [K in keyof T]-?: T[K];
 };
@@ -1156,6 +1462,24 @@ declare const VesuPools: {
     Re7xSTRK: ContractAddr;
     Re7xBTC: ContractAddr;
     Prime: ContractAddr;
+    Re7STRK: ContractAddr;
+};
+declare const VesuPoolMetadata: {
+    [VesuPools.Genesis.address]: {
+        name: string;
+    };
+    [VesuPools.Re7xSTRK.address]: {
+        name: string;
+    };
+    [VesuPools.Re7xBTC.address]: {
+        name: string;
+    };
+    [VesuPools.Prime.address]: {
+        name: string;
+    };
+    [VesuPools.Re7STRK.address]: {
+        name: string;
+    };
 };
 declare const extensionMap: {
     [key: string]: ContractAddr;
@@ -1198,8 +1522,15 @@ declare class VesuAdapter extends BaseAdapter {
     getModifyPositionCall: (params: VesuModifyPositionCallParams) => ManageCall;
     getMultiplyAdapter: (id: string) => LeafAdapterFn<VesuMultiplyCallParams>;
     getMultiplyCall: (params: VesuMultiplyCallParams) => ManageCall;
-    getVesuModifyDelegationAdapter: (id: string) => LeafAdapterFn<VesuModifyDelegationCallParams>;
-    getVesuModifyDelegationCall: (params: VesuModifyDelegationCallParams) => ManageCall;
+    getVesuModifyDelegationAdapter: (id: string, delegatee: ContractAddr) => LeafAdapterFn<VesuModifyDelegationCallParams>;
+    getVesuModifyDelegationCall: (delegatee: ContractAddr) => (params: VesuModifyDelegationCallParams) => {
+        sanitizer: ContractAddr;
+        call: {
+            contractAddress: ContractAddr;
+            selector: string;
+            calldata: bigint[];
+        };
+    };
     getDefispringRewardsAdapter: (id: string) => () => AdapterLeafType<VesuDefiSpringRewardsCallParams>;
     getDefiSpringClaimCall: () => GenerateCallFn<VesuDefiSpringRewardsCallParams>;
     formatAmountTypeEnum(amountType: VesuAmountType): CairoCustomEnum;
@@ -1254,6 +1585,11 @@ declare const AVNU_EXCHANGE: ContractAddr;
 declare const VESU_SINGLETON: ContractAddr;
 declare function toBigInt(value: string | number): bigint;
 
+declare enum LSTPriceType {
+    ENDUR_PRICE = "ENDUR_PRICE",
+    AVNU_PRICE = "AVNU_PRICE"
+}
+
 interface UniversalManageCall {
     proofs: string[];
     manageCall: ManageCall;
@@ -1300,12 +1636,7 @@ declare class UniversalStrategy<S extends UniversalStrategySettings> extends Bas
     asset(): TokenInfo;
     depositCall(amountInfo: SingleActionAmount, receiver: ContractAddr): Promise<Call[]>;
     withdrawCall(amountInfo: SingleActionAmount, receiver: ContractAddr, owner: ContractAddr): Promise<Call[]>;
-    /**
-     * Calculates the Total Value Locked (TVL) for a specific user.
-     * @param user - Address of the user
-     * @returns Object containing the amount in token units and USD value
-     */
-    getUserTVL(user: ContractAddr): Promise<{
+    getUserTVL(user: ContractAddr, blockIdentifier?: BlockIdentifier): Promise<{
         tokenInfo: TokenInfo;
         amount: Web3Number;
         usdValue: number;
@@ -1338,6 +1669,11 @@ declare class UniversalStrategy<S extends UniversalStrategySettings> extends Bas
         weight: number;
     }>;
     private computeAPY;
+    /**
+     * Calculates user realized APY based on trueSharesBasedAPY method.
+     * Returns the APY as a number.
+     */
+    getUserRealizedAPY(blockIdentifier?: BlockIdentifier, sinceBlocks?: number): Promise<number>;
     /**
        * Calculates the total TVL of the strategy.
        * @returns Object containing the total amount in token units and USD value
@@ -1348,9 +1684,9 @@ declare class UniversalStrategy<S extends UniversalStrategySettings> extends Bas
         usdValue: number;
     }>;
     getUnusedBalance(): Promise<SingleTokenInfo>;
-    protected getVesuAUM(adapter: VesuAdapter): Promise<Web3Number>;
+    protected getVesuAUM(adapter: VesuAdapter, _priceType?: LSTPriceType): Promise<Web3Number>;
     getPrevAUM(): Promise<Web3Number>;
-    getAUM(): Promise<{
+    getAUM(unrealizedAUM?: boolean): Promise<{
         net: SingleTokenInfo;
         prevAum: Web3Number;
         splits: {
@@ -1429,10 +1765,12 @@ declare function getContractDetails(settings: UniversalStrategySettings): {
 declare const UniversalStrategies: IStrategyMetadata<UniversalStrategySettings>[];
 
 interface HyperLSTStrategySettings extends UniversalStrategySettings {
-    borrowable_assets: TokenInfo[];
+    borrowable_assets: {
+        token: TokenInfo;
+        poolId: ContractAddr;
+    }[];
     underlyingToken: TokenInfo;
     defaultPoolId: ContractAddr;
-    altSupportedPoolIds: ContractAddr[];
 }
 declare class UniversalLstMultiplierStrategy extends UniversalStrategy<HyperLSTStrategySettings> {
     private quoteAmountToFetchPrice;
@@ -1467,7 +1805,20 @@ declare class UniversalLstMultiplierStrategy extends UniversalStrategy<HyperLSTS
         shouldRebalance: boolean;
         manageCall: Call | undefined;
     }>;
-    protected getVesuAUM(adapter: VesuAdapter): Promise<Web3Number>;
+    protected getVesuAUM(adapter: VesuAdapter, priceType?: LSTPriceType): Promise<Web3Number>;
+    getTVLUnrealized(): Promise<{
+        net: SingleTokenInfo;
+        prevAum: Web3Number;
+        splits: {
+            id: string;
+            aum: Web3Number;
+        }[];
+    }>;
+    getUserUnrealizedGains(user: ContractAddr): Promise<{
+        unrealizedGains: Web3Number;
+        userShare: number;
+        tokenInfo: TokenInfo;
+    }>;
     private _getMinOutputAmountLSTBuy;
     private _getMinOutputAmountLSTSell;
     /**
@@ -1492,6 +1843,7 @@ declare class UniversalLstMultiplierStrategy extends UniversalStrategy<HyperLSTS
             maxBorrowableAmount: Web3Number;
             borrowableAsset: TokenInfo;
             ltv: number;
+            poolId: ContractAddr;
         }[];
     }>;
     getMaxSwappableWithMaxSlippage(fromToken: TokenInfo, toToken: TokenInfo, maxSlippage: number, maxAmount: Web3Number): Promise<Web3Number>;
@@ -1520,6 +1872,7 @@ declare class UniversalLstMultiplierStrategy extends UniversalStrategy<HyperLSTS
         apy: number;
         weight: number;
     }>;
+    getLSTAvnuRate(): Promise<number>;
     getLSTExchangeRate(): Promise<number>;
     /**
      *
@@ -1536,6 +1889,97 @@ declare class UniversalLstMultiplierStrategy extends UniversalStrategy<HyperLSTS
 }
 declare const HyperLSTStrategies: IStrategyMetadata<HyperLSTStrategySettings>[];
 
+/**
+ * Filter option definition
+ */
+interface FilterOption {
+    id: string;
+    label: string;
+    icon?: string;
+}
+/**
+ * Strategy filter metadata - defines what filters are available
+ */
+interface StrategyFilterMetadata {
+    assets: FilterOption[];
+    protocols: FilterOption[];
+    quickFilters: FilterOption[];
+}
+/**
+ * Strategy type enum
+ */
+declare enum StrategyType {
+    EKUBO_CL = "ekubo",
+    UNIVERSAL = "universal",
+    HYPER_LST = "hyper-lst",
+    VESU_REBALANCE = "vesu-rebalance",
+    SENSEI = "sensei"
+}
+/**
+ * Strategy metadata extracted from IStrategyMetadata
+ */
+interface StrategyMetadata {
+    id: string;
+    name: string;
+    type: StrategyType;
+    assets: string[];
+    protocols: string[];
+    tags: string[];
+    curator?: {
+        name: string;
+        logo: string;
+    };
+    isRetired: boolean;
+}
+/**
+ * Strategy registry entry
+ */
+interface StrategyRegistryEntry<T = any> {
+    metadata: IStrategyMetadata<T>;
+    type: StrategyType;
+}
+/**
+ * Build strategy registry from SDK strategies
+ */
+declare function buildStrategyRegistry(): StrategyRegistryEntry[];
+/**
+ * Get all strategy metadata from registry
+ */
+declare function getAllStrategyMetadata(): StrategyMetadata[];
+/**
+ * Get filter metadata - defines available filters and their options
+ */
+declare function getFilterMetadata(): StrategyFilterMetadata;
+/**
+ * Get live strategies (filter out retired)
+ */
+declare function getLiveStrategies(): StrategyRegistryEntry[];
+/**
+ * Get strategies by type
+ */
+declare function getStrategiesByType(type: StrategyType): StrategyRegistryEntry[];
+
+declare enum FactoryStrategyType {
+    UNIVERSAL = "UNIVERSAL",
+    EKUBO_CL = "EKUBO_CL",
+    HYPER_LST = "HYPER_LST",
+    VESU_REBALANCE = "VESU_REBALANCE",
+    SENSEI = "SENSEI"
+}
+declare function createUniversalStrategy(config: IConfig, pricer: PricerBase, metadata: IStrategyMetadata<UniversalStrategySettings>): UniversalStrategy<UniversalStrategySettings>;
+declare function createEkuboCLStrategy(config: IConfig, pricer: PricerBase, metadata: IStrategyMetadata<CLVaultStrategySettings>): EkuboCLVault;
+declare function createHyperLSTStrategy(config: IConfig, pricer: PricerBase, metadata: IStrategyMetadata<HyperLSTStrategySettings>): UniversalLstMultiplierStrategy;
+declare function createVesuRebalanceStrategy(config: IConfig, pricer: PricerBase, metadata: IStrategyMetadata<VesuRebalanceSettings>): VesuRebalance;
+declare function createSenseiStrategy(config: IConfig, pricer: PricerBase, metadata: IStrategyMetadata<SenseiVaultSettings>): SenseiVault;
+/**
+ * Determines the strategy type from metadata by inspecting the additionalInfo structure
+ */
+declare function getStrategyTypeFromMetadata(metadata: IStrategyMetadata<any>): FactoryStrategyType;
+/**
+ * Generic factory function that creates SDK strategy instances based on type
+ */
+declare function createStrategy(type: FactoryStrategyType, config: IConfig, pricer: PricerBase, metadata: IStrategyMetadata<any>): VesuRebalance | EkuboCLVault | SenseiVault | UniversalStrategy<UniversalStrategySettings>;
+
 interface EkuboRouteNode {
     pool_key: {
         token0: string;
@@ -1596,6 +2040,7 @@ declare class Global {
     static getTokens(): Promise<TokenInfo[]>;
     static assert(condition: any, message: string): void;
     static getTokenInfoFromAddr(addr: ContractAddr): Promise<TokenInfo>;
+    static getTokenInfoFromName(tokenName: string): Promise<TokenInfo>;
     static setGlobalCache(key: string, data: any, ttl?: number): void;
     static getGlobalCache<T>(key: string): T | null;
 }
@@ -1693,7 +2138,7 @@ declare class PricerRedis extends Pricer {
     /** sets current local price in redis */
     private _setRedisPrices;
     /** Returns price from redis */
-    getPrice(tokenSymbol: string): Promise<PriceInfo>;
+    getPrice(tokenSymbol: string, blockNumber?: BlockIdentifier): Promise<PriceInfo>;
 }
 
 declare function getAPIUsingHeadlessBrowser(url: string): Promise<any>;
@@ -1809,4 +2254,4 @@ declare class PasswordJsonCryptoUtil {
     decrypt(encryptedData: string, password: string): any;
 }
 
-export { APYType, AUMTypes, AVNU_EXCHANGE, AVNU_MIDDLEWARE, type AccountInfo, type AdapterLeafType, type AllAccountsStore, type ApproveCallParams, AutoCompounderSTRK, type AvnuSwapCallParams, AvnuWrapper, BaseAdapter, type BaseAdapterConfig, BaseStrategy, type CLVaultStrategySettings, CommonAdapter, type CommonAdapterConfig, ContractAddr, type DecreaseLeverParams, Deployer, type DualActionAmount, type DualTokenInfo, ERC20, type EkuboBounds, EkuboCLVault, EkuboCLVaultStrategies, type EkuboPoolKey, type EkuboQuote, EkuboQuoter, type EkuboRouteNode, type EkuboSplit, type FAQ, FatalError, type FlashloanCallParams, FlowChartColors, type GenerateCallFn, Global, HyperLSTStrategies, type HyperLSTStrategySettings, type IConfig, type IInvestmentFlow, ILending, type ILendingMetadata, type ILendingPosition, type IProtocol, type IStrategyMetadata, type IncreaseLeverParams, Initializable, LSTAPRService, type LSTStats, type LeafAdapterFn, type LeafData, type LendingToken, type ManageCall, MarginType, Network, PRICE_ROUTER, PasswordJsonCryptoUtil, type PositionAPY, type PositionInfo, Pragma, type PriceInfo, Pricer, PricerFromApi, PricerLST, PricerRedis, Protocols, type RequiredFields, type RequiredKeys, type RequiredStoreConfig, type RiskFactor, RiskType, type Route, type RouteNode, SIMPLE_SANITIZER, SIMPLE_SANITIZER_V2, SIMPLE_SANITIZER_VESU_V1_DELEGATIONS, SenseiStrategies, SenseiVault, type SenseiVaultSettings, type SingleActionAmount, type SingleTokenInfo, StandardMerkleTree, type StandardMerkleTreeData, Store, type StoreConfig, type SupportedPosition, type Swap, type SwapInfo, TelegramGroupNotif, TelegramNotif, type TokenAmount, type TokenInfo, UNIVERSAL_ADAPTERS, UNIVERSAL_MANAGE_IDS, UniversalLstMultiplierStrategy, type UniversalManageCall, UniversalStrategies, UniversalStrategy, type UniversalStrategySettings, VESU_SINGLETON, VESU_V2_MODIFY_POSITION_SANITIZER, type VaultPosition, VesuAdapter, type VesuAdapterConfig, type VesuAmount, VesuAmountDenomination, VesuAmountType, type VesuDefiSpringRewardsCallParams, type VesuModifyDelegationCallParams, type VesuModifyPositionCallParams, type VesuMultiplyCallParams, VesuPools, VesuRebalance, type VesuRebalanceSettings, VesuRebalanceStrategies, Web3Number, ZkLend, assert, extensionMap, getAPIUsingHeadlessBrowser, getContractDetails, getDefaultStoreConfig, getMainnetConfig, getNoRiskTags, getRiskColor, getRiskExplaination, getTrovesEndpoint, getVesuSingletonAddress, highlightTextWithLinks, type i257, logger, toBigInt };
+export { APYType, AUMTypes, AVNU_EXCHANGE, AVNU_MIDDLEWARE, type AccessControlInfo, AccessControlType, type AccountInfo, type AdapterLeafType, type AllAccountsStore, type AmountInfo, type AmountsInfo, type ApproveCallParams, AuditStatus, AutoCompounderSTRK, type AvnuSwapCallParams, AvnuWrapper, BaseAdapter, type BaseAdapterConfig, BaseStrategy, type CLVaultStrategySettings, CommonAdapter, type CommonAdapterConfig, ContractAddr, type DecreaseLeverParams, Deployer, type DualActionAmount, type DualTokenInfo, ERC20, type EkuboBounds, EkuboCLVault, EkuboCLVaultStrategies, type EkuboPoolKey, type EkuboQuote, EkuboQuoter, type EkuboRouteNode, type EkuboSplit, type FAQ, FactoryStrategyType, FatalError, type FilterOption, type FlashloanCallParams, FlowChartColors, type GenerateCallFn, Global, HyperLSTStrategies, type HyperLSTStrategySettings, type IConfig, type IInvestmentFlow, ILending, type ILendingMetadata, type ILendingPosition, type IProtocol, type IStrategyMetadata, type IncreaseLeverParams, Initializable, InstantWithdrawalVault, LSTAPRService, LSTPriceType, type LSTStats, type LeafAdapterFn, type LeafData, type LendingToken, type ManageCall, MarginType, MyNumber, type NetAPYDetails, type NetAPYSplit, Network, PRICE_ROUTER, PasswordJsonCryptoUtil, type PositionAPY, type PositionInfo, Pragma, type PriceInfo, Pricer, PricerFromApi, PricerLST, PricerRedis, Protocols, type RedemptionInfo, type RequiredFields, type RequiredKeys, type RequiredStoreConfig, type RiskFactor, RiskType, type Route, type RouteNode, SIMPLE_SANITIZER, SIMPLE_SANITIZER_V2, SIMPLE_SANITIZER_VESU_V1_DELEGATIONS, type SecurityMetadata, SenseiStrategies, SenseiVault, type SenseiVaultSettings, type SingleActionAmount, type SingleTokenInfo, type SourceCodeInfo, SourceCodeType, StandardMerkleTree, type StandardMerkleTreeData, Store, type StoreConfig, type StrategyAlert, type StrategyCapabilities, type StrategyFilterMetadata, StrategyLiveStatus, type StrategyMetadata, type StrategyRegistryEntry, type StrategySettings, StrategyTag, StrategyType, type SupportedPosition, type Swap, type SwapInfo, TelegramGroupNotif, TelegramNotif, type TokenAmount, type TokenInfo, UNIVERSAL_ADAPTERS, UNIVERSAL_MANAGE_IDS, UniversalLstMultiplierStrategy, type UniversalManageCall, UniversalStrategies, UniversalStrategy, type UniversalStrategySettings, type UserYoloInfo, VESU_SINGLETON, VESU_V2_MODIFY_POSITION_SANITIZER, type VaultPosition, VaultType, VesuAdapter, type VesuAdapterConfig, type VesuAmount, VesuAmountDenomination, VesuAmountType, type VesuDefiSpringRewardsCallParams, type VesuModifyDelegationCallParams, type VesuModifyPositionCallParams, type VesuMultiplyCallParams, VesuPoolMetadata, VesuPools, VesuRebalance, type VesuRebalanceSettings, VesuRebalanceStrategies, Web3Number, YoLoVault, type YoloVaultSettings, type YoloVaultStatus, YoloVaultStrategies, ZkLend, assert, buildStrategyRegistry, createEkuboCLStrategy, createHyperLSTStrategy, createSenseiStrategy, createStrategy, createUniversalStrategy, createVesuRebalanceStrategy, detectCapabilities, extensionMap, getAPIUsingHeadlessBrowser, getAllStrategyMetadata, getAllStrategyTags, getContractDetails, getDefaultStoreConfig, getFilterMetadata, getLiveStrategies, getMainnetConfig, getNoRiskTags, getRiskColor, getRiskExplaination, getStrategiesByType, getStrategyTagDesciption, getStrategyTypeFromMetadata, getTrovesEndpoint, getVesuSingletonAddress, highlightTextWithLinks, type i257, isDualTokenStrategy, logger, toAmountsInfo, toBigInt };