@gearbox-protocol/sdk 13.3.3 → 13.4.0-beta.1

package/dist/types/sdk/accounts/AbstractCreditAccountsService.d.ts

@@ -2,9 +2,9 @@ import type { Address } from "viem";
 import type { CreditAccountData } from "../base/index.js";
 import { SDKConstruct } from "../base/index.js";
 import type { GearboxSDK } from "../GearboxSDK.js";
-import type { OnDemandPriceUpdates, UpdatePriceFeedsResult } from "../market/index.js";
+import type { PriceUpdateV310, UpdatePriceFeedsResult } from "../market/index.js";
 import { type Asset, type RouterCASlice } from "../router/index.js";
-import type { MultiCall } from "../types/index.js";
+import type { MultiCall, RawTx } from "../types/index.js";
 import type { AccountToCheck, AddCollateralProps, ChangeDeptProps, ClaimDelayedProps, CloseCreditAccountProps, CloseCreditAccountResult, CreditAccountOperationResult, ExecuteSwapProps, FullyLiquidateProps, FullyLiquidateResult, GetConnectedBotsResult, GetConnectedMigrationBotsResult, GetCreditAccountsOptions, GetPendingWithdrawalsProps, GetPendingWithdrawalsResult, OpenCAProps, PermitResult, PrepareUpdateQuotasProps, PreviewDelayedWithdrawalProps, PreviewDelayedWithdrawalResult, PriceUpdatesOptions, Rewards, StartDelayedWithdrawalProps, UpdateQuotasProps } from "./types.js";
 export interface CreditAccountServiceOptions {
     batchSize?: number;
@@ -177,30 +177,52 @@ export declare abstract class AbstractCreditAccountService extends SDKConstruct
      * @param ca
      */
     getOptimalHFForPartialLiquidation(ca: CreditAccountData): bigint;
-    /**
-     * Returns raw txs that are needed to update all price feeds so that all credit accounts (possibly from different markets) compute
-     *
-     * This can be used by batch liquidator
-     * @param accounts
-     * @returns
-     */
-    getUpdateForAccounts(accounts: Array<RouterCASlice>): Promise<UpdatePriceFeedsResult>;
     protected getUpdateForAccount(options: PriceUpdatesOptions): Promise<UpdatePriceFeedsResult>;
     /**
      * Returns account price updates that can be used in credit facade multicall or liquidator calls
      * @param options
      * @returns
      */
-    getOnDemandPriceUpdates(options: PriceUpdatesOptions): Promise<OnDemandPriceUpdates>;
+    getOnDemandPriceUpdates(options: PriceUpdatesOptions): Promise<PriceUpdateV310[]>;
     /**
-     * Returns price updates in format that is accepted by various credit facade methods (multicall, close/liquidate, etc...).
-     * - If there are desiredQuotas and creditAccount update quotaBalance > 0 || (balance > 10n && isEnabled). Is used when account has both: balances and quota buys.
-     * - If there is creditAccount update balance > 10n && isEnabled. Is used in credit account actions when quota is not being bought.
-     * - If there is desiredQuotas update quotaBalance > 0. Is used on credit account opening, when quota is bought for the first time.
-     * @param acc
-     * @returns
+     * Analyzes a multicall array and prepends necessary on-demand price feed updates.
+     *
+     * Deduplicates existing `onDemandPriceUpdates` calls
+     *
+     * @param creditManager - Address of the credit manager
+     * @param calls - The multicall array to prepend price updates to
+     * @param ca - Credit account slice, undefined when opening a new account
+     * @param options - Optional settings for price update generation
+     * @returns A new array with a single consolidated price update call prepended,
+     *          followed by the non-price-update calls in their original order
+     */
+    protected prependPriceUpdates(creditManager: Address, calls: MultiCall[], ca?: RouterCASlice, options?: {
+        ignoreReservePrices?: boolean;
+    }): Promise<MultiCall[]>;
+    /**
+     * Executes a multicall on a credit account, automatically prepending
+     * necessary on-demand price feed updates.
+     *
+     * @param creditAccount - Credit account to execute multicall on
+     * @param calls - Array of multicall operations (price updates will be inferred)
+     * @param options - Optional settings for price update generation
+     * @returns Raw transaction ready to be signed and sent
      */
-    getPriceUpdatesForFacade(options: PriceUpdatesOptions): Promise<Array<MultiCall>>;
+    multicall(creditAccount: RouterCASlice, calls: MultiCall[], options?: {
+        ignoreReservePrices?: boolean;
+    }): Promise<RawTx>;
+    /**
+     * Executes a bot multicall on a credit account, automatically prepending
+     * necessary on-demand price feed updates.
+     *
+     * @param creditAccount - Credit account to execute bot multicall on
+     * @param calls - Array of multicall operations (price updates will be inferred)
+     * @param options - Optional settings for price update generation
+     * @returns Raw transaction ready to be signed and sent
+     */
+    botMulticall(creditAccount: RouterCASlice, calls: MultiCall[], options?: {
+        ignoreReservePrices?: boolean;
+    }): Promise<RawTx>;
     protected prepareDisableQuotas(ca: RouterCASlice): Array<MultiCall>;
     protected prepareUpdateQuotas(creditFacade: Address, { averageQuota, minQuota }: PrepareUpdateQuotasProps): Array<MultiCall>;
     protected prepareDecreaseDebt(ca: RouterCASlice): Array<MultiCall>;

package/dist/types/sdk/accounts/multicall-utils.d.ts

@@ -0,0 +1,39 @@
+import type { PriceUpdateV310 } from "../market/pricefeeds/types.js";
+import type { MultiCall } from "../types/index.js";
+import { AddressSet } from "../utils/AddressSet.js";
+/**
+ * Splits a multicall array into existing price-update data and remaining calls.
+ *
+ * All `onDemandPriceUpdates` entries are decoded and their {@link PriceUpdate}
+ * tuples are collected into a flat array. The remaining (non-price-update)
+ * calls are returned in their original order.
+ *
+ * @param calls - Array of multicall entries to split
+ * @returns Object with `priceUpdates` (decoded price update tuples) and
+ *          `remainingCalls` (everything else, preserving order)
+ */
+export declare function extractPriceUpdates(calls: MultiCall[]): {
+    priceUpdates: PriceUpdateV310[];
+    remainingCalls: MultiCall[];
+};
+/**
+ * Extracts token addresses from `updateQuota` calls that have a positive `quotaChange`.
+ *
+ * Only tokens whose quota is being increased (i.e. `quotaChange > 0`) are
+ * returned, since those are the tokens that require fresh price feed data.
+ *
+ * @param calls - Array of multicall entries to scan
+ * @returns Unique token addresses from positive-change quota updates
+ */
+export declare function extractQuotaTokens(calls: MultiCall[]): AddressSet;
+/**
+ * Merges two {@link PriceUpdate} arrays, deduplicating by `priceFeed` address.
+ *
+ * When both arrays contain an update for the same price feed, the entry from
+ * `existing` takes priority (the caller explicitly included it).
+ *
+ * @param existing - Price updates already present in the multicall
+ * @param generated - Newly generated price updates to merge in
+ * @returns Merged array with no duplicate `priceFeed` addresses
+ */
+export declare function mergePriceUpdates(existing: PriceUpdateV310[], generated: PriceUpdateV310[]): PriceUpdateV310[];

package/dist/types/sdk/accounts/types.d.ts

@@ -3,7 +3,7 @@ import type { creditAccountCompressorAbi } from "../../abi/compressors/creditAcc
 import type { iWithdrawalCompressorV310Abi } from "../../abi/IWithdrawalCompressorV310.js";
 import type { ConnectedBotData, Construct, CreditAccountData } from "../base/index.js";
 import type { GearboxSDK } from "../GearboxSDK.js";
-import type { CreditSuite, OnDemandPriceUpdates, UpdatePriceFeedsResult } from "../market/index.js";
+import type { CreditSuite, PriceUpdateV310 } from "../market/index.js";
 import type { Asset, CreditAccountTokensSlice, RouterCASlice, RouterCloseResult } from "../router/index.js";
 import type { MultiCall, RawTx } from "../types/index.js";
 export type GetCreditAccountsArgs = ContractFunctionArgs<typeof creditAccountCompressorAbi, "pure" | "view", "getCreditAccounts">;
@@ -554,26 +554,36 @@ export interface ICreditAccountsService extends Construct {
      * @param ca
      */
     getOptimalHFForPartialLiquidation(ca: CreditAccountData): bigint;
-    /**
-     * Returns raw txs that are needed to update all price feeds so that all credit accounts (possibly from different markets) compute
-     *
-     * This can be used by batch liquidator
-     * @param accounts
-     * @returns
-     */
-    getUpdateForAccounts(accounts: Array<RouterCASlice>): Promise<UpdatePriceFeedsResult>;
     /**
      * Returns account price updates that can be used in credit facade multicall or liquidator calls
      * @param options
      * @returns
      */
-    getOnDemandPriceUpdates(options: PriceUpdatesOptions): Promise<OnDemandPriceUpdates>;
+    getOnDemandPriceUpdates(options: PriceUpdatesOptions): Promise<PriceUpdateV310[]>;
     /**
-     * Returns price updates in format that is accepted by various credit facade methods (multicall, close/liquidate, etc...).
-     * @param options
-     * @returns
+     * Executes a multicall on a credit account, automatically prepending
+     * necessary on-demand price feed updates inferred from the calls array.
+     *
+     * @param creditAccount - Credit account to execute multicall on
+     * @param calls - Array of multicall operations (price updates will be inferred)
+     * @param options - Optional settings for price update generation
+     * @returns Raw transaction ready to be signed and sent
      */
-    getPriceUpdatesForFacade(options: PriceUpdatesOptions): Promise<Array<MultiCall>>;
+    multicall(creditAccount: RouterCASlice, calls: Array<MultiCall>, options?: {
+        ignoreReservePrices?: boolean;
+    }): Promise<RawTx>;
+    /**
+     * Executes a bot multicall on a credit account, automatically prepending
+     * necessary on-demand price feed updates inferred from the calls array.
+     *
+     * @param creditAccount - Credit account to execute bot multicall on
+     * @param calls - Array of multicall operations (price updates will be inferred)
+     * @param options - Optional settings for price update generation
+     * @returns Raw transaction ready to be signed and sent
+     */
+    botMulticall(creditAccount: RouterCASlice, calls: Array<MultiCall>, options?: {
+        ignoreReservePrices?: boolean;
+    }): Promise<RawTx>;
     /**
      * Withdraws a single collateral from credit account to wallet to and updates quotas;
      * technically can withdraw several tokens at once

package/dist/types/sdk/market/credit/CreditFacadeV310Contract.d.ts

@@ -14,6 +14,7 @@ export declare class CreditFacadeV310Contract extends CreditFacadeV310BaseContra
     liquidateCreditAccount(ca: Address, to: Address, calls: MultiCall[], lossPolicyData?: Hex): RawTx;
     closeCreditAccount(ca: Address, calls: MultiCall[]): RawTx;
     multicall(ca: Address, calls: MultiCall[]): RawTx;
+    botMulticall(ca: Address, calls: MultiCall[]): RawTx;
     openCreditAccount(to: Address, calls: MultiCall[], referralCode: bigint): RawTx;
 }
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gearbox-protocol/sdk",
-  "version": "13.3.3",
+  "version": "13.4.0-beta.1",
   "description": "Gearbox SDK",
   "license": "MIT",
   "main": "./dist/cjs/sdk/index.js",
@@ -103,6 +103,7 @@
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",
     "viem-deal": "^2.0.4",
+    "vite": "^8.0.3",
     "vitest": "^4.1.2"
   },
   "peerDependencies": {