@gearbox-protocol/sdk 16.0.0-next.26 → 16.0.0-next.28

package/dist/types/onchain/positions/PositionsService.d.ts

@@ -1,5 +1,6 @@
 import { Bps } from "../../model/primitives.js";
 import { BorrowRateBreakdown, Position, StrategyPosition } from "../../model/positions.js";
+import { AccountMetrics, AccountProjection } from "../../model/previews.js";
 import "../../model/index.js";
 import { AccountSnapshot, ListPositionsProps, ListStrategyPositionsProps } from "./types.js";
 import { SDKConstruct } from "../base/SDKConstruct.js";
@@ -67,6 +68,35 @@ declare class PositionsService extends SDKConstruct {
    * non-underlying assets.
    **/
   liquidationPrice(snapshot: AccountSnapshot): bigint | null;
+  /**
+   * Every derived number of an account state at once — the whole
+   * {@link AccountMetrics} half of a projection.
+   *
+   * This is what both halves of the SDK fill their answers from: `prepare`, for
+   * a state it walked an intent into, and `preview`, for one it replayed out of
+   * calldata. One snapshot in, one set of metrics out, so the two descriptions
+   * of the same operation cannot disagree because one of them grew its own
+   * formula.
+   *
+   * Identical to the four methods above field for field, and cheaper than
+   * calling them one by one: the market data is collected once, and the health
+   * factor and borrow rate the time to liquidation decays at are the very ones
+   * reported beside it.
+   **/
+  metrics(snapshot: AccountSnapshot, options?: ProjectedPoolOptions): AccountMetrics;
+  /**
+   * A projected account state as both halves of the SDK report it: the holdings
+   * priced and named, and the metrics of {@link PositionsService.metrics}.
+   *
+   * The snapshot is taken at its word — what it lists is what comes back, so a
+   * caller that drops dust before the walk reports an account without it, and
+   * one that keeps wei reports them. That is the whole of the policy left to
+   * the caller; everything downstream of the balances is decided here.
+   *
+   * @param options - The operation's effect on the pool, for the rate the
+   * metrics are quoted at, see {@link ProjectedPoolOptions}.
+   **/
+  projection(snapshot: AccountSnapshot, options?: ProjectedPoolOptions): AccountProjection;
 }
 //#endregion
 export { PositionsService, ProjectedPoolOptions };

package/dist/types/preview/index.d.ts

@@ -28,17 +28,17 @@ import { checkPrerequisites } from "./prerequisites/checkPrerequisites.js";
 import "./prerequisites/index.js";
 import { CreditAccountState, CreditAccountStateProps } from "./preview/CreditAccountState.js";
 import { DetectedDelayedOperation, detectDelayedOperation } from "./preview/detectDelayedOperation.js";
-import { buildDelayedPreview } from "./preview/buildDelayedPreview.js";
+import { buildDelayedStrategyVerify } from "./preview/buildDelayedStrategyVerify.js";
 import { classifyCloseOrRepay, isCloseOrRepay } from "./preview/detectCloseOrRepay.js";
 import { DetectedDelayedClaim, detectDelayedClaim, resolveDelayedClaimIntent } from "./preview/detectDelayedClaim.js";
 import { UnsupportedOperationError } from "./preview/errors.js";
-import { previewAdjustCreditAccount } from "./preview/previewAdjustCreditAccount.js";
-import { CloseOrRepayOperation, previewCloseOrRepayCreditAccount } from "./preview/previewCloseOrRepayCreditAccount.js";
+import { previewAdjustStrategyVerify } from "./preview/previewAdjustStrategyVerify.js";
+import { CloseOrRepayOperation, previewExitOrRepayStrategyVerify } from "./preview/previewExitOrRepayStrategyVerify.js";
 import { previewOperation } from "./preview/previewOperation.js";
 import { ReplayState, makeReplayState, replayInnerOperations } from "./preview/replayInnerOperations.js";
 import { ReplayMulticallResult, ReplayableOperation, replayMulticall } from "./preview/replayMulticall.js";
 import "./preview/index.js";
-import { CheckOperationOptions, checkOperation, collateralIssue, marketIssues, quotaCountIssue } from "./validate/checkOperation.js";
+import { CheckOperationOptions, WeighedFactors, checkOperation, collateralIssue, marketIssues, quotaCountIssue } from "./validate/checkOperation.js";
 import { checkSimulation } from "./validate/checkSimulation.js";
 import "./validate/index.js";
-export { AdapterOperation, AdapterOperationBase, AddCollateralOp, AllowanceDetail, AllowancePrerequisite, AllowanceResult, BalanceDetail, BalancePrerequisite, BalanceResult, BorrowLimitBinding, CheckOperationOptions, ClassifyInnerOperationsProps, CloseCreditAccountOperation, CloseOrRepayOperation, CompareBalancesOp, CreditAccountOperation, CreditAccountState, CreditAccountStateProps, DecreaseDebtOp, DetectedDelayedClaim, DetectedDelayedOperation, DirectTokenTransferOperation, ExtractTransfersResult, FacadeCallType, FacadeOperationMetadata, FacadeParsedCall, IncreaseDebtOp, InnerFacadeOperation, InnerOperation, IntentPreviewError, LiquidateCreditAccountOperation, MulticallOperation, OpenCreditAccountOperation, Operation, OperationMetadata, OuterFacadeOperation, PartialLiquidationOperation, PoolDepositOperation, PoolMintOperation, PoolOperation, PoolRedeemOperation, PoolWithdrawOperation, Prerequisite, PrerequisiteContext, PrerequisiteError, PrerequisiteKind, PrerequisiteOutcome, PrerequisiteResult, PreviewErrorDetails, PreviewErrorReason, PreviewIssue, PreviewOperationInput, PreviewOperationOptions, PreviewRefusal, RWAMulticallOperation, RWAOpenCreditAccountOperation, RWAOpenRequirementsDetail, RWAOpenRequirementsPrerequisite, RWAOpenRequirementsResult, RWAOperation, RWAOperationMetadata, ReplayMulticallResult, ReplayState, ReplayableOperation, StoreExpectedBalancesOp, TokenTransfer, TraceAdapterExt, TransferAlignmentError, UnexpectedFacadeEventOrderError, UnknownAdapterError, UnknownFacadeCallError, UnsupportedOperationError, UnsupportedPoolFunctionError, UnsupportedTargetError, UnsupportedZapperFunctionError, UpdateQuotaOp, WithdrawCollateralAlignmentError, WithdrawCollateralEventInfo, WithdrawCollateralOp, buildDelayedPreview, checkOperation, checkPrerequisites, checkSimulation, classifyCloseOrRepay, classifyInnerOperations, collateralIssue, detectDelayedClaim, detectDelayedOperation, extractAdapterCallTraces, extractTransfers, findFacadeCalls, isCloseOrRepay, isPoolOperation, isRWAOperation, makeReplayState, marketIssues, parseFacadeOperationCalldata, parseOperationCalldata, parsePoolOperationCalldata, parseRWAFactoryOperationCalldata, previewAdjustCreditAccount, previewCloseOrRepayCreditAccount, previewOperation, quotaCountIssue, raise, refuse, replayInnerOperations, replayMulticall, resolveDelayedClaimIntent };
+export { AdapterOperation, AdapterOperationBase, AddCollateralOp, AllowanceDetail, AllowancePrerequisite, AllowanceResult, BalanceDetail, BalancePrerequisite, BalanceResult, BorrowLimitBinding, CheckOperationOptions, ClassifyInnerOperationsProps, CloseCreditAccountOperation, CloseOrRepayOperation, CompareBalancesOp, CreditAccountOperation, CreditAccountState, CreditAccountStateProps, DecreaseDebtOp, DetectedDelayedClaim, DetectedDelayedOperation, DirectTokenTransferOperation, ExtractTransfersResult, FacadeCallType, FacadeOperationMetadata, FacadeParsedCall, IncreaseDebtOp, InnerFacadeOperation, InnerOperation, IntentPreviewError, LiquidateCreditAccountOperation, MulticallOperation, OpenCreditAccountOperation, Operation, OperationMetadata, OuterFacadeOperation, PartialLiquidationOperation, PoolDepositOperation, PoolMintOperation, PoolOperation, PoolRedeemOperation, PoolWithdrawOperation, Prerequisite, PrerequisiteContext, PrerequisiteError, PrerequisiteKind, PrerequisiteOutcome, PrerequisiteResult, PreviewErrorDetails, PreviewErrorReason, PreviewIssue, PreviewOperationInput, PreviewOperationOptions, PreviewRefusal, RWAMulticallOperation, RWAOpenCreditAccountOperation, RWAOpenRequirementsDetail, RWAOpenRequirementsPrerequisite, RWAOpenRequirementsResult, RWAOperation, RWAOperationMetadata, ReplayMulticallResult, ReplayState, ReplayableOperation, StoreExpectedBalancesOp, TokenTransfer, TraceAdapterExt, TransferAlignmentError, UnexpectedFacadeEventOrderError, UnknownAdapterError, UnknownFacadeCallError, UnsupportedOperationError, UnsupportedPoolFunctionError, UnsupportedTargetError, UnsupportedZapperFunctionError, UpdateQuotaOp, WeighedFactors, WithdrawCollateralAlignmentError, WithdrawCollateralEventInfo, WithdrawCollateralOp, buildDelayedStrategyVerify, checkOperation, checkPrerequisites, checkSimulation, classifyCloseOrRepay, classifyInnerOperations, collateralIssue, detectDelayedClaim, detectDelayedOperation, extractAdapterCallTraces, extractTransfers, findFacadeCalls, isCloseOrRepay, isPoolOperation, isRWAOperation, makeReplayState, marketIssues, parseFacadeOperationCalldata, parseOperationCalldata, parsePoolOperationCalldata, parseRWAFactoryOperationCalldata, previewAdjustStrategyVerify, previewExitOrRepayStrategyVerify, previewOperation, quotaCountIssue, raise, refuse, replayInnerOperations, replayMulticall, resolveDelayedClaimIntent };

package/dist/types/preview/preview/{buildDelayedPreview.d.ts → buildDelayedStrategyVerify.d.ts}

@@ -1,4 +1,4 @@
-import { InstantOperationPreview } from "../../model/previews.js";
+import { PreviewInstantStrategyVerify } from "../../model/previews.js";
 import "../../model/index.js";
 import { ConvertFn } from "../../onchain/market/oracle/types.js";
 import { OnchainSDK } from "../../onchain/OnchainSDK.js";
@@ -6,7 +6,7 @@ import "../../onchain/index.js";
 import { CreditAccountState } from "./CreditAccountState.js";
 import { DetectedDelayedOperation } from "./detectDelayedOperation.js";
 import { Address } from "viem";
-//#region src/preview/preview/buildDelayedPreview.d.ts
+//#region src/preview/preview/buildDelayedStrategyVerify.d.ts
 /**
  * Builds the best-effort preview of the account state after the detected
  * delayed withdrawal is claimed and its intent (if any) is resumed:
@@ -29,6 +29,6 @@ import { Address } from "viem";
  * @param sdk - Market data source for the position metrics of the resulting
  * state; read synchronously, no network access.
  */
-declare function buildDelayedPreview(afterInstant: CreditAccountState, before: CreditAccountState, detected: DetectedDelayedOperation, convert: ConvertFn, receivedToken: Address, sdk: OnchainSDK): InstantOperationPreview;
+declare function buildDelayedStrategyVerify(afterInstant: CreditAccountState, before: CreditAccountState, detected: DetectedDelayedOperation, convert: ConvertFn, receivedToken: Address, sdk: OnchainSDK): PreviewInstantStrategyVerify;
 //#endregion
-export { buildDelayedPreview };
+export { buildDelayedStrategyVerify };

package/dist/types/preview/preview/index.d.ts

@@ -1,12 +1,12 @@
 import { CreditAccountState, CreditAccountStateProps } from "./CreditAccountState.js";
 import { DetectedDelayedOperation, detectDelayedOperation } from "./detectDelayedOperation.js";
-import { buildDelayedPreview } from "./buildDelayedPreview.js";
+import { buildDelayedStrategyVerify } from "./buildDelayedStrategyVerify.js";
 import { classifyCloseOrRepay, isCloseOrRepay } from "./detectCloseOrRepay.js";
 import { DetectedDelayedClaim, detectDelayedClaim, resolveDelayedClaimIntent } from "./detectDelayedClaim.js";
 import { UnsupportedOperationError } from "./errors.js";
-import { previewAdjustCreditAccount } from "./previewAdjustCreditAccount.js";
-import { CloseOrRepayOperation, previewCloseOrRepayCreditAccount } from "./previewCloseOrRepayCreditAccount.js";
+import { previewAdjustStrategyVerify } from "./previewAdjustStrategyVerify.js";
+import { CloseOrRepayOperation, previewExitOrRepayStrategyVerify } from "./previewExitOrRepayStrategyVerify.js";
 import { previewOperation } from "./previewOperation.js";
 import { ReplayState, makeReplayState, replayInnerOperations } from "./replayInnerOperations.js";
 import { ReplayMulticallResult, ReplayableOperation, replayMulticall } from "./replayMulticall.js";
-export { CloseOrRepayOperation, CreditAccountState, CreditAccountStateProps, DetectedDelayedClaim, DetectedDelayedOperation, ReplayMulticallResult, ReplayState, ReplayableOperation, UnsupportedOperationError, buildDelayedPreview, classifyCloseOrRepay, detectDelayedClaim, detectDelayedOperation, isCloseOrRepay, makeReplayState, previewAdjustCreditAccount, previewCloseOrRepayCreditAccount, previewOperation, replayInnerOperations, replayMulticall, resolveDelayedClaimIntent };
+export { CloseOrRepayOperation, CreditAccountState, CreditAccountStateProps, DetectedDelayedClaim, DetectedDelayedOperation, ReplayMulticallResult, ReplayState, ReplayableOperation, UnsupportedOperationError, buildDelayedStrategyVerify, classifyCloseOrRepay, detectDelayedClaim, detectDelayedOperation, isCloseOrRepay, makeReplayState, previewAdjustStrategyVerify, previewExitOrRepayStrategyVerify, previewOperation, replayInnerOperations, replayMulticall, resolveDelayedClaimIntent };

package/dist/types/preview/preview/{previewAdjustCreditAccount.d.ts → previewAdjustStrategyVerify.d.ts}

@@ -1,4 +1,4 @@
-import { AdjustCreditAccountPreview } from "../../model/previews.js";
+import { PreviewAdjustStrategyVerify } from "../../model/previews.js";
 import "../../model/index.js";
 import { PluginsMap } from "../../onchain/plugins/types.js";
 import "../../onchain/index.js";
@@ -6,7 +6,7 @@ import { MulticallOperation } from "../parse/types-facades.js";
 import { RWAMulticallOperation } from "../parse/types-rwa.js";
 import { PreviewOperationInput, PreviewOperationOptions } from "../types.js";
 import "../parse/index.js";
-//#region src/preview/preview/previewAdjustCreditAccount.d.ts
+//#region src/preview/preview/previewAdjustStrategyVerify.d.ts
 /**
  * Previews a `multicall`/`botMulticall` operation on an existing credit
  * account: threads the multicall through {@link replayMulticall} over the
@@ -14,6 +14,6 @@ import "../parse/index.js";
  * minimal guaranteed post-state alongside the changes relative to the
  * pre-state.
  */
-declare function previewAdjustCreditAccount<P extends PluginsMap>(input: PreviewOperationInput<P>, operation: MulticallOperation | RWAMulticallOperation, options: PreviewOperationOptions<true>): Promise<AdjustCreditAccountPreview>;
+declare function previewAdjustStrategyVerify<P extends PluginsMap>(input: PreviewOperationInput<P>, operation: MulticallOperation | RWAMulticallOperation, options: PreviewOperationOptions<true>): Promise<PreviewAdjustStrategyVerify>;
 //#endregion
-export { previewAdjustCreditAccount };
+export { previewAdjustStrategyVerify };

package/dist/types/preview/preview/{previewCloseOrRepayCreditAccount.d.ts → previewExitOrRepayStrategyVerify.d.ts}

@@ -1,4 +1,4 @@
-import { CloseCreditAccountPreview, RepayCreditAccountPreview } from "../../model/previews.js";
+import { PreviewExitStrategyVerify, PreviewRepayStrategyVerify } from "../../model/previews.js";
 import "../../model/index.js";
 import { PluginsMap } from "../../onchain/plugins/types.js";
 import "../../onchain/index.js";
@@ -6,13 +6,13 @@ import { CloseCreditAccountOperation, MulticallOperation } from "../parse/types-
 import { RWAMulticallOperation } from "../parse/types-rwa.js";
 import { PreviewOperationInput, PreviewOperationOptions } from "../types.js";
 import "../parse/index.js";
-//#region src/preview/preview/previewCloseOrRepayCreditAccount.d.ts
+//#region src/preview/preview/previewExitOrRepayStrategyVerify.d.ts
 /**
  * Any parsed operation that fully closes or repays a credit account: the
  * facade `closeCreditAccount` entry point (permanent closure) or a plain
  * multicall detected by `isCloseOrRepay` (`decreaseDebt(MAX)`).
  */
 type CloseOrRepayOperation = CloseCreditAccountOperation | MulticallOperation | RWAMulticallOperation;
-declare function previewCloseOrRepayCreditAccount<P extends PluginsMap>(input: PreviewOperationInput<P>, operation: CloseOrRepayOperation, permanent: boolean, options: PreviewOperationOptions<true>): Promise<CloseCreditAccountPreview | RepayCreditAccountPreview>;
+declare function previewExitOrRepayStrategyVerify<P extends PluginsMap>(input: PreviewOperationInput<P>, operation: CloseOrRepayOperation, permanent: boolean, options: PreviewOperationOptions<true>): Promise<PreviewExitStrategyVerify | PreviewRepayStrategyVerify>;
 //#endregion
-export { CloseOrRepayOperation, previewCloseOrRepayCreditAccount };
+export { CloseOrRepayOperation, previewExitOrRepayStrategyVerify };

package/dist/types/preview/preview/previewLpVerify.d.ts

@@ -0,0 +1,11 @@
+import { PreviewLpVerify } from "../../model/previews.js";
+import "../../model/index.js";
+import { PluginsMap } from "../../onchain/plugins/types.js";
+import "../../onchain/index.js";
+import { PoolOperation } from "../parse/types-pools.js";
+import { PreviewOperationInput, PreviewOperationOptions } from "../types.js";
+import "../parse/index.js";
+//#region src/preview/preview/previewLpVerify.d.ts
+declare function previewLpVerify<P extends PluginsMap>(input: PreviewOperationInput<P>, operation: PoolOperation, options?: PreviewOperationOptions): Promise<PreviewLpVerify>;
+//#endregion
+export { previewLpVerify };

package/dist/types/preview/preview/previewOpenStrategyVerify.d.ts

@@ -0,0 +1,12 @@
+import { PreviewOpenStrategyVerify } from "../../model/previews.js";
+import "../../model/index.js";
+import { PluginsMap } from "../../onchain/plugins/types.js";
+import "../../onchain/index.js";
+import { OpenCreditAccountOperation } from "../parse/types-facades.js";
+import { RWAOpenCreditAccountOperation } from "../parse/types-rwa.js";
+import { PreviewOperationInput } from "../types.js";
+import "../parse/index.js";
+//#region src/preview/preview/previewOpenStrategyVerify.d.ts
+declare function previewOpenStrategyVerify<P extends PluginsMap>(input: PreviewOperationInput<P>, operation: OpenCreditAccountOperation | RWAOpenCreditAccountOperation): Promise<PreviewOpenStrategyVerify>;
+//#endregion
+export { previewOpenStrategyVerify };

package/dist/types/preview/validate/checkOperation.d.ts

@@ -1,5 +1,5 @@
 import { Bps } from "../../model/primitives.js";
-import { AccountProjection, OperationPreview } from "../../model/previews.js";
+import { AccountHoldings, AccountMetrics, AccountProjection, OperationPreview } from "../../model/previews.js";
 import "../../model/index.js";
 import { AddressMap } from "../../onchain/utils/AddressMap.js";
 import { CreditSuite } from "../../onchain/market/credit/CreditSuite.js";
@@ -49,7 +49,15 @@ declare function marketIssues(suite: CreditSuite): PreviewIssue | null;
  * need an operation's *delta* between them, and the caller acts on the first
  * issue reported.
  */
-declare function quotaCountIssue(suite: CreditSuite, projection: AccountProjection): PreviewIssue | null;
+declare function quotaCountIssue(suite: CreditSuite, account: Pick<AccountProjection, "quotas">): PreviewIssue | null;
+/**
+ * An account's factors, in whichever branch of a routed leg the caller means to
+ * be held to: `prepare` reports the outcome the router expects, `preview` the
+ * floor its calldata guarantees. The bar is indifferent — it weighs the numbers
+ * it is handed — and passing them one by one is what makes the choice visible
+ * where it is made.
+ */
+interface WeighedFactors extends Pick<AccountHoldings, "totalDebt">, Pick<AccountMetrics, "healthFactor" | "safeHealthFactor"> {}
 /**
  * The account against whichever bars the caller holds it to.
  *
@@ -58,6 +66,6 @@ declare function quotaCountIssue(suite: CreditSuite, projection: AccountProjecti
  *
  * {@inheritDoc quotaCountIssue}
  */
-declare function collateralIssue(projection: AccountProjection, options: CheckOperationOptions): PreviewIssue | null;
+declare function collateralIssue(account: WeighedFactors, options: CheckOperationOptions): PreviewIssue | null;
 //#endregion
-export { CheckOperationOptions, checkOperation, collateralIssue, marketIssues, quotaCountIssue };
+export { CheckOperationOptions, WeighedFactors, checkOperation, collateralIssue, marketIssues, quotaCountIssue };

package/dist/types/preview/validate/index.d.ts

@@ -1,3 +1,3 @@
-import { CheckOperationOptions, checkOperation, collateralIssue, marketIssues, quotaCountIssue } from "./checkOperation.js";
+import { CheckOperationOptions, WeighedFactors, checkOperation, collateralIssue, marketIssues, quotaCountIssue } from "./checkOperation.js";
 import { checkSimulation } from "./checkSimulation.js";
-export { CheckOperationOptions, checkOperation, checkSimulation, collateralIssue, marketIssues, quotaCountIssue };
+export { CheckOperationOptions, WeighedFactors, checkOperation, checkSimulation, collateralIssue, marketIssues, quotaCountIssue };

package/dist/types/rewards/rewards/api.d.ts

@@ -1,11 +1,11 @@
-import { ChainId, Token } from "../../model/primitives.js";
+import { ChainId, Token, TokenAmount } from "../../model/primitives.js";
 import "../../model/index.js";
 import { OnchainSDK } from "../../onchain/OnchainSDK.js";
 import "../../onchain/index.js";
 import { Address } from "viem";
 //#region src/rewards/rewards/api.d.ts
 /**
- * One claimable Merkl liquidity-mining reward, denominated.
+ * One claimable Merkl liquidity-mining reward, denominated and priced.
  *
  * Both tokens arrive resolved, so a consumer neither looks one up nor
  * reassembles one out of the loose fields Merkl sends.
@@ -16,10 +16,16 @@ interface MerklReward {
   readonly pool: Address;
   /** That pool's share token — what the campaign is keyed on. */
   readonly poolToken: Token;
-  /** The incentive token being handed out. */
-  readonly rewardToken: Token;
-  /** Claimable amount, i.e. distributed minus already claimed. Always > 0. */
-  readonly amount: bigint;
+  /**
+   * The incentive token being handed out, how much of it is claimable
+   * (distributed minus already claimed, always > 0) and what that is worth.
+   *
+   * Priced by Merkl, not by the market oracles: a campaign's incentive token
+   * is rarely collateral in the pool it incentivises, so the oracles usually
+   * do not know it — GEAR, which most Gearbox campaigns pay in, among them.
+   * `valueUsd` is `null` for a token Merkl does not price either.
+   */
+  readonly amount: TokenAmount;
 }
 type ReportHandler = (e: unknown, description?: string) => void;
 /**

package/dist/types/rewards/rewards/merkl-api.d.ts

@@ -20,6 +20,12 @@ interface MerkleXYZUserRewardsV4 {
       chainId: number;
       symbol: string;
       decimals: number;
+      /**
+       * USD price of one whole token. Optional because Merkl omits the key
+       * outright for the tokens it does not price — points and the like —
+       * rather than sending a null.
+       */
+      price?: number;
     };
     breakdowns: Array<{
       reason: string;

package/dist/types/sdk/prepare/PrepareApi.d.ts

@@ -1,4 +1,5 @@
 import { Bps, ChainId } from "../../model/primitives.js";
+import { PositionCollateral, StrategyPosition } from "../../model/positions.js";
 import { DataResponse } from "../../model/response.js";
 import "../../model/index.js";
 import { Asset } from "../../onchain/base/types.js";
@@ -92,6 +93,10 @@ declare class PrepareApi extends MultichainConstruct implements IOpportunitiesPr
    * {@inheritDoc IOpportunitiesPrepare.leverageBand}
    **/
   leverageBand(strategy: StrategyInput, collateral: readonly Asset[], targetHF?: Bps): LeverageBand | undefined;
+  /**
+   * {@inheritDoc IOpportunitiesPrepare.withdrawableCollaterals}
+   **/
+  withdrawableCollaterals(position: StrategyPosition): PositionCollateral[];
   /**
    * {@inheritDoc IOpportunitiesPrepare.maxWithdrawCollateral}
    **/

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

@@ -1,6 +1,6 @@
 import { Bps } from "../../model/primitives.js";
 import { PoolOpportunityKey, StrategyOpportunityKey } from "../../model/opportunities.js";
-import { StrategyPositionKey } from "../../model/positions.js";
+import { PositionCollateral, StrategyPosition, StrategyPositionKey } from "../../model/positions.js";
 import { DataResponse } from "../../model/response.js";
 import "../../model/index.js";
 import { ClaimableWithdrawal } from "../../onchain/accounts/withdrawal-compressor/types.js";
@@ -485,6 +485,23 @@ interface IOpportunitiesPrepare {
    * a caller must not mark a range for it.
    **/
   leverageBand(strategy: StrategyInput, collateral: readonly Asset[], targetHF?: Bps): LeverageBand | undefined;
+  /**
+   * The collaterals an account can actually take out, most valuable first —
+   * what a withdraw-collateral picker offers.
+   *
+   * `StrategyPosition.collaterals` is everything the account holds, in the
+   * order the manager keeps its tokens. Phantoms are in there: the position
+   * reports one as itself and puts the asset it redeems into under
+   * `withdrawals`, and {@link withdrawCollateral} cannot move a balance that
+   * is not transferable. Balances below dust are already gone — the position
+   * drops them as it is built.
+   *
+   * Synchronous, like {@link leverageBand}: it reads loaded token metadata and
+   * the position it was handed, so a form can ask on every render. Nothing is
+   * quoted here — which of these the router can sell is a different question,
+   * and the answer to it is a simulation.
+   **/
+  withdrawableCollaterals(position: StrategyPosition): PositionCollateral[];
   /**
    * Largest amount of one collateral {@link withdrawCollateral} can move out
    * while the account stays safely collateralised, in the token's units: the

package/dist/types/sdk/prepare/withdrawable-collaterals.d.ts

@@ -0,0 +1,11 @@
+import { PositionCollateral, StrategyPosition } from "../../model/positions.js";
+import "../../model/index.js";
+import { OnchainSDK } from "../../onchain/OnchainSDK.js";
+import "../../onchain/index.js";
+//#region src/sdk/prepare/withdrawable-collaterals.d.ts
+/**
+ * {@inheritDoc IOpportunitiesPrepare.withdrawableCollaterals}
+ **/
+declare function withdrawableCollaterals(sdk: OnchainSDK, position: StrategyPosition): PositionCollateral[];
+//#endregion
+export { withdrawableCollaterals };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gearbox-protocol/sdk",
-  "version": "16.0.0-next.26",
+  "version": "16.0.0-next.28",
   "description": "Gearbox SDK",
   "license": "MIT",
   "repository": {

package/dist/types/preview/preview/previewOpenCreditAccount.d.ts

@@ -1,12 +0,0 @@
-import { OpenCreditAccountPreview } from "../../model/previews.js";
-import "../../model/index.js";
-import { PluginsMap } from "../../onchain/plugins/types.js";
-import "../../onchain/index.js";
-import { OpenCreditAccountOperation } from "../parse/types-facades.js";
-import { RWAOpenCreditAccountOperation } from "../parse/types-rwa.js";
-import { PreviewOperationInput } from "../types.js";
-import "../parse/index.js";
-//#region src/preview/preview/previewOpenCreditAccount.d.ts
-declare function previewOpenCreditAccount<P extends PluginsMap>(input: PreviewOperationInput<P>, operation: OpenCreditAccountOperation | RWAOpenCreditAccountOperation): Promise<OpenCreditAccountPreview>;
-//#endregion
-export { previewOpenCreditAccount };

package/dist/types/preview/preview/previewPoolOperation.d.ts

@@ -1,11 +0,0 @@
-import { PoolOperationPreview } from "../../model/previews.js";
-import "../../model/index.js";
-import { PluginsMap } from "../../onchain/plugins/types.js";
-import "../../onchain/index.js";
-import { PoolOperation } from "../parse/types-pools.js";
-import { PreviewOperationInput, PreviewOperationOptions } from "../types.js";
-import "../parse/index.js";
-//#region src/preview/preview/previewPoolOperation.d.ts
-declare function previewPoolOperation<P extends PluginsMap>(input: PreviewOperationInput<P>, operation: PoolOperation, options?: PreviewOperationOptions): Promise<PoolOperationPreview>;
-//#endregion
-export { previewPoolOperation };