@strkfarm/sdk 2.0.0-dev.29 → 2.0.0-dev.30

package/dist/index.d.ts

@@ -451,9 +451,12 @@ interface CacheData$1 {
 }
 declare class CacheClass {
     readonly cache: Map<string, CacheData$1>;
+    isCacheEnabled: boolean;
     setCache(key: string, data: any, ttl?: number): void;
     getCache<T>(key: string): T | null;
     isCacheValid(key: string): boolean;
+    disableCache(): void;
+    enableCache(): void;
 }
 
 interface HarvestInfo {
@@ -2183,6 +2186,7 @@ interface CreateOrderRequest {
     price: string;
     side: OrderSide;
     post_only?: boolean;
+    reduce_only?: boolean;
     previous_order_id?: number;
     external_id?: string;
     time_in_force?: TimeInForce;
@@ -2258,11 +2262,15 @@ declare class ExtendedWrapper {
     private apiKey?;
     private timeout;
     private retries;
+    /** Per-market rules from GET /markets (tradingConfig); retained for process lifetime (no TTL). */
+    private marketTradingRulesCache;
+    private marketTradingRulesInflight;
     constructor(config: ExtendedWrapperConfig);
     /**
      * Make HTTP request with retry logic and error handling
      */
     private makeRequest;
+    private resolveTradingRules;
     /**
      * Create a new order on Extended Exchange
      */
@@ -2338,11 +2346,11 @@ declare class ExtendedWrapper {
      * Convenience method to create a buy order
      */
     createBuyOrder(marketName: string, amount: string, price: string, options?: {
-        postOnly?: boolean;
-        reduceOnly?: boolean;
-        previousOrderId?: number;
-        externalId?: string;
-        timeInForce?: TimeInForce;
+        post_only?: boolean;
+        reduce_only?: boolean;
+        previous_order_id?: number;
+        external_id?: string;
+        time_in_force?: TimeInForce;
     }): Promise<ExtendedApiResponse<PlacedOrder>>;
     /**
      * Get order by ID
@@ -2354,11 +2362,11 @@ declare class ExtendedWrapper {
      * Convenience method to create a sell order
      */
     createSellOrder(marketName: string, amount: string, price: string, options?: {
-        postOnly?: boolean;
-        reduceOnly?: boolean;
-        previousOrderId?: number;
-        externalId?: string;
-        timeInForce?: TimeInForce;
+        post_only?: boolean;
+        reduce_only?: boolean;
+        previous_order_id?: number;
+        external_id?: string;
+        time_in_force?: TimeInForce;
     }): Promise<ExtendedApiResponse<PlacedOrder>>;
     /**
      * Get positions for a specific market
@@ -3328,12 +3336,12 @@ declare function routeSummary(r: ExecutionRoute): string;
 declare class SolveBudget {
     private unusedBalance;
     private walletBalance;
-    /** Idle {@link StateManagerConfig.assetToken} in the vault allocator */
-    private vaultAssetBalance;
     /**
-     * Idle {@link StateManagerConfig.usdcToken} in the vault allocator.
-     * When asset and USDC are the same token, this is null (all VA stablecoin is in {@link vaultAssetBalance} only).
+     * Idle non-stable {@link StateManagerConfig.assetToken} in the vault allocator.
+     * Null when asset and USDC are the same token (VA idle stablecoin is only in {@link vaultUsdcBalance}).
      */
+    private vaultAssetBalance;
+    /** Idle {@link StateManagerConfig.usdcToken} in the vault allocator (including when it is also the strategy asset). */
     private vaultUsdcBalance;
     private extendedPositions;
     private extendedBalance;
@@ -3415,11 +3423,11 @@ declare class SolveBudget {
      */
     applyBuffer(factor: number): void;
     get vesuPoolState(): VesuPoolState;
-    /** Buffered VA USD: strategy-asset slot + optional USDC slot. */
+    /** Buffered VA USD: non-stable asset slot (if any) + USDC slot. */
     get vaUsd(): number;
     /** Buffered USD in VA strategy-asset bucket only. */
     get vaAssetUsd(): number;
-    /** Buffered USD in VA USDC bucket (0 when asset === USDC). */
+    /** Buffered USD in VA USDC bucket (includes full VA idle when asset === USDC). */
     get vaUsdcUsd(): number;
     get walletUsd(): number;
     get vaWalletUsd(): number;
@@ -3452,8 +3460,10 @@ declare class SolveBudget {
     get vesuDebtDeltas(): readonly Web3Number[];
     /** Per-pool rebalance flags derived from target HF checks. */
     get vesuRebalanceFlags(): readonly boolean[];
-    /** Raw USD in VA (USDC slot + asset slot); spend caps when executing transfers. */
+    /** Raw USD in VA (USDC slot + non-stable asset slot when distinct); spend caps when executing transfers. */
     private _vaRawUsd;
+    /** VA liquidity usable for repay / {@link spendVaRawUsd} (matches nominal balances after any {@link applyBuffer} scaling). */
+    get vaRawUsd(): number;
     private _walletRawUsd;
     /** Remove up to `usd` notional from a token balance, scaling token amount proportionally. */
     private _deductUsdFromTokenBalance;
@@ -3571,19 +3581,19 @@ declare class ExtendedSVKVesuStateManager {
      * results in private instance variables.
      */
     private _refresh;
-    /** True when strategy asset and USDC share one token — VA USDC slot is unused (all in asset balance). */
+    /** True when strategy asset and USDC share one token — VA idle balance is tracked as USDC, not as asset. */
     private _vaultAssetAndUsdcAreSameToken;
     /**
-     * Reads the {@link StateManagerConfig.assetToken} balance idle in the vault allocator.
+     * Reads idle {@link StateManagerConfig.assetToken} in the vault allocator when it differs from USDC.
+     * When asset and USDC are the same token, returns null (that balance is reported via {@link _fetchVaultAllocatorUsdcBalanceIfDistinct} only).
      */
     private _fetchVaultAllocatorAssetBalance;
     /**
-     * Reads {@link StateManagerConfig.usdcToken} in the vault allocator when it differs from
-     * {@link StateManagerConfig.assetToken}. Otherwise returns null (treat VA USDC as 0; stablecoin is only under asset).
+     * Reads {@link StateManagerConfig.usdcToken} idle in the vault allocator (always — distinct asset or USDC-as-asset).
      */
     private _fetchVaultAllocatorUsdcBalanceIfDistinct;
     /**
-     * Merges vault-allocator asset, optional vault-allocator USDC, and operator wallet
+     * Merges vault-allocator asset (if any), vault-allocator USDC, and operator wallet
      * balances into entries keyed by token address.
      */
     private _computeUnusedBalances;
@@ -3744,7 +3754,9 @@ declare class ExtendedSVKVesuStateManager {
      * Design: accumulate all ext-to-wallet moves, add transfer routes at the end (principle #3).
      */
     /**
-     * Unified LTV classifier. Computes both Vesu repay and Extended margin needs,
+     * Unified LTV / exposure classifier: `rebalance()` drives both LTV (debt, margin,
+     * funding) and Vesu↔Extended position alignment. There is no separate imbalance pass.
+     * Computes both Vesu repay and Extended margin needs,
      * then builds all routes in a single pass with no duplicate transfers.
      *
      * Vesu repay priority: VA > Wallet > ExtAvl > ExtUpnl
@@ -3756,8 +3768,9 @@ declare class ExtendedSVKVesuStateManager {
     private _isLtvRebalanceNoop;
     /**
      * Turn pure rebalance() deltas into execution routes.
-     * Order: Vesu multiply (decrease/increase) → Extended lever → aggregated transfers
-     * (REALISE_PNL, EXTENDED_TO_WALLET + WAIT, WALLET_TO_VA, VESU_BORROW, VESU_REPAY, VA_TO_EXTENDED).
+     * Order: Vesu multiply decrease → Extended decrease → aggregated transfers
+     * (REALISE_PNL, EXTENDED_TO_WALLET + WAIT, WALLET_TO_VA, VESU_BORROW, VESU_REPAY, VA_TO_EXTENDED),
+     * then Vesu multiply increase and Extended increase (need VA / Extended funded first).
      */
     private _buildLtvRoutesFromRebalanceDeltas;
     /**
@@ -3797,6 +3810,7 @@ declare class ExtendedSVKVesuStateManager {
      *          CRISIS_UNDO_EXTENDED_MAX_LEVERAGE]
      */
     private _rebalanceFunds;
+    private _scaleVesuPoolDeltasByFactor;
     /**
      * 3. New Deposits / Excess Funds
      *
@@ -3811,6 +3825,11 @@ declare class ExtendedSVKVesuStateManager {
      * Computes allocation split between Vesu and Extended, then sources
      * funds and creates lever-increase routes.
      *
+     * Order: {@link _rebalanceFunds} first → project VA / Extended liquid after the same funding
+     * routes (wallet→VA, borrow→VA, VA→Extended, Extended→wallet→VA) → ideal Vesu/Extended deltas
+     * from distributable split → cap common BTC by min(Vesu fundable, Extended fundable) → scale
+     * Vesu deltas and recompute Extended deltas so both sides stay matched.
+     *
      * Fund flow (single pass — avoid VA→Extended then Extended→wallet round-trips):
      *   1) Treat Vesu borrow headroom that the multiply route will consume as covering
      *      part of the Vesu USDC need (no standalone VESU_BORROW for that slice). Cap