@gearbox-protocol/sdk 16.1.2 → 16.3.0-next.1

package/dist/types/sdk/liquidations/LiquidationsNamespace.d.ts

@@ -4,6 +4,7 @@ import { DataResponse } from "../../model/response.js";
 import "../../model/index.js";
 import { MultichainSDK } from "../../onchain/MultichainSDK.js";
 import { BuildLiquidationTxProps, GetLiquidatableAccountsProps, GetLiquidationDetailsProps, GetLiquidationPositionsProps } from "../../onchain/accounts/liquidations/types.js";
+import { CheckLiquidationInput, CheckLiquidationOptions, LiquidationValidationError } from "../../onchain/validation/checkLiquidation.js";
 import "../../onchain/index.js";
 import { ILiquidations } from "./types.js";
 import { NamespaceOptions } from "../types.js";
@@ -30,6 +31,10 @@ declare class LiquidationsNamespace implements ILiquidations {
    * {@inheritDoc ILiquidations.getLiquidationPositions}
    **/
   getLiquidationPositions(props: GetLiquidationPositionsProps<true>): Promise<DataResponse<LiquidationPosition[]>>;
+  /**
+   * {@inheritDoc ILiquidations.checkLiquidation}
+   **/
+  checkLiquidation(props: CheckLiquidationInput, options?: CheckLiquidationOptions): Promise<LiquidationValidationError[]>;
 }
 //#endregion
 export { LiquidationsNamespace };

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

@@ -3,6 +3,7 @@ import { LiquidatableAccount, LiquidationDetails, LiquidationPosition } from "..
 import { DataResponse } from "../../model/response.js";
 import "../../model/index.js";
 import { BuildLiquidationTxProps, GetLiquidatableAccountsProps, GetLiquidationDetailsProps, GetLiquidationPositionsProps } from "../../onchain/accounts/liquidations/types.js";
+import { CheckLiquidationInput, CheckLiquidationOptions, LiquidationValidationError } from "../../onchain/validation/checkLiquidation.js";
 import "../../onchain/index.js";
 //#region src/sdk/liquidations/types.d.ts
 /**
@@ -30,6 +31,13 @@ interface ILiquidations {
    * wallet, optionally scoped to some of the SDK's chains.
    **/
   getLiquidationPositions(props: GetLiquidationPositionsProps<true>): Promise<DataResponse<LiquidationPosition[]>>;
+  /**
+   * Whether `liquidator` may send a full liquidation of this account.
+   *
+   * `details` must come from {@link ILiquidations.getLiquidationDetails} called
+   * with the same `liquidator`.
+   **/
+  checkLiquidation(props: CheckLiquidationInput, options?: CheckLiquidationOptions): Promise<LiquidationValidationError[]>;
 }
 /**
  * `sdk.liquidations` per mode: an on-chain read, absent when the SDK reads no

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

@@ -1,4 +1,6 @@
 import { Bps, ChainId } from "../../model/primitives.js";
+import { DebtOutOfRangeError, InsufficientPoolLiquidityError, LeverageOutOfRangeError } from "../../model/errors/operation-errors.js";
+import { CreditAccountNotEmptyError, CreditAccountNotFoundError, EmptyOpenTakesNothingError, MultipleDelayedWithdrawalsError, NoDelayedRouteError, NoRecordedIntentError, NoStrategyTargetCollateralError, UnexpectedFailureError, UnsupportedCollateralTokenError, UnsupportedTokenPairError, WithdrawalInProgressError } from "../../model/errors/prepare-errors.js";
 import { PositionCollateral, StrategyPosition } from "../../model/positions.js";
 import { SDKReturn } from "../../model/result.js";
 import "../../model/index.js";
@@ -9,8 +11,7 @@ import { MultichainConstruct } from "../../onchain/base/MultichainConstruct.js";
 import { LeverageBand } from "../../onchain/accounts/intents/leverage-band.js";
 import { WithdrawCeilings } from "../../onchain/accounts/intents/types.js";
 import "../../onchain/index.js";
-import { AccountFlowError, DebtOutOfRangeError, InsufficientPoolLiquidityError, LeverageOutOfRangeError, MultipleDelayedWithdrawalsError, NoDelayedRouteError, NoRecordedIntentError, NoStrategyTargetCollateralError, OpenFlowError, UnexpectedFailureError, UnsupportedCollateralTokenError, UnsupportedTokenPairError, WithRouteRefusals, WithdrawalInProgressError } from "./errors.js";
-import { AddCollateralParams, AdjustLeverageParams, DepositStrategyParams, FinalizeParams, FinalizeResult, IOpportunitiesPrepare, LpParams, LpRedeemParams, LpResult, OpenStrategyParams, OpenStrategyResult, PoolInput, PositionInput, RepayStrategyParams, StrategyInput, StrategyResult, StrategyRoutesResult, WithdrawCollateralParams, WithdrawStrategyParams } from "./types.js";
+import { AccountFlowError, AddCollateralParams, AdjustLeverageParams, DepositStrategyParams, FinalizeParams, FinalizeResult, IOpportunitiesPrepare, LpParams, LpRedeemParams, LpResult, OpenFlowError, OpenStrategyParams, OpenStrategyResult, PoolInput, PositionInput, RepayStrategyParams, StrategyInput, StrategyResult, StrategyRoutesResult, WithRouteErrors, WithdrawCollateralParams, WithdrawStrategyParams } from "./types.js";
 import { EnsureFreshChains } from "../types.js";
 import { Address } from "viem";
 //#region src/sdk/prepare/PrepareApi.d.ts
@@ -65,7 +66,7 @@ declare class PrepareApi extends MultichainConstruct implements IOpportunitiesPr
   /**
    * {@inheritDoc IOpportunitiesPrepare.openNewStrategy}
    **/
-  openNewStrategy(strategy: StrategyInput, params: OpenStrategyParams): Promise<SDKReturn<OpenStrategyResult, OpenFlowError | DebtOutOfRangeError | LeverageOutOfRangeError | UnsupportedTokenPairError | InsufficientPoolLiquidityError | NoStrategyTargetCollateralError>>;
+  openNewStrategy(strategy: StrategyInput, params: OpenStrategyParams): Promise<SDKReturn<OpenStrategyResult, OpenFlowError | DebtOutOfRangeError | LeverageOutOfRangeError | UnsupportedTokenPairError | InsufficientPoolLiquidityError | NoStrategyTargetCollateralError | EmptyOpenTakesNothingError | CreditAccountNotFoundError | CreditAccountNotEmptyError>>;
   /**
    * {@inheritDoc IOpportunitiesPrepare.depositStrategy}
    **/
@@ -73,7 +74,7 @@ declare class PrepareApi extends MultichainConstruct implements IOpportunitiesPr
   /**
    * {@inheritDoc IOpportunitiesPrepare.withdrawStrategy}
    **/
-  withdrawStrategy(position: PositionInput, params: WithdrawStrategyParams): Promise<SDKReturn<StrategyRoutesResult, (AccountFlowError | DebtOutOfRangeError | UnsupportedTokenPairError | NoDelayedRouteError | MultipleDelayedWithdrawalsError | WithdrawalInProgressError) & WithRouteRefusals>>;
+  withdrawStrategy(position: PositionInput, params: WithdrawStrategyParams): Promise<SDKReturn<StrategyRoutesResult, (AccountFlowError | DebtOutOfRangeError | UnsupportedTokenPairError | NoDelayedRouteError | MultipleDelayedWithdrawalsError | WithdrawalInProgressError) & WithRouteErrors>>;
   /**
    * {@inheritDoc IOpportunitiesPrepare.maxWithdraw}
    **/
@@ -89,7 +90,7 @@ declare class PrepareApi extends MultichainConstruct implements IOpportunitiesPr
   /**
    * {@inheritDoc IOpportunitiesPrepare.adjustLeverage}
    **/
-  adjustLeverage(position: PositionInput, params: AdjustLeverageParams): Promise<SDKReturn<StrategyRoutesResult, (AccountFlowError | DebtOutOfRangeError | UnsupportedTokenPairError | NoDelayedRouteError | MultipleDelayedWithdrawalsError | WithdrawalInProgressError | InsufficientPoolLiquidityError | LeverageOutOfRangeError) & WithRouteRefusals>>;
+  adjustLeverage(position: PositionInput, params: AdjustLeverageParams): Promise<SDKReturn<StrategyRoutesResult, (AccountFlowError | DebtOutOfRangeError | UnsupportedTokenPairError | NoDelayedRouteError | MultipleDelayedWithdrawalsError | WithdrawalInProgressError | InsufficientPoolLiquidityError | LeverageOutOfRangeError) & WithRouteErrors>>;
   /**
    * {@inheritDoc IOpportunitiesPrepare.addCollateral}
    **/

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

@@ -1,7 +1,7 @@
-import { BorrowLimitBinding, IntentPreviewError, PreviewErrorDetails, PreviewErrorReason, PreviewIssue, PreviewRefusal, raise, refuse } from "../../onchain/validation/refusal.js";
+import { CreditAccountNotEmptyError, CreditAccountNotFoundError, EmptyOpenTakesNothingError, MultipleDelayedWithdrawalsError, NoDelayedRouteError, NoRecordedIntentError, NoStrategyTargetCollateralError, UnexpectedFailureError, UnsupportedCollateralTokenError, UnsupportedTokenPairError, WithdrawalInProgressError, creditAccountNotEmpty, creditAccountNotFound, emptyOpenTakesNothing, noStrategyTargetCollateral, unexpectedFailure } from "../../model/errors/prepare-errors.js";
+import "../../model/index.js";
 import { LeverageBand } from "../../onchain/accounts/intents/leverage-band.js";
-import { OperationState, PathLossRate, WithdrawCeilings } from "../../onchain/accounts/intents/types.js";
-import { AccountFlowError, CreditAccountNotFoundError, DebtOutOfRangeError, ForbiddenTokenError, InsufficientCollateralError, InsufficientPoolLiquidityError, InsufficientSourceBalanceError, LeverageOutOfRangeError, MalformedTransactionError, MarketExpiredError, MarketPausedError, MultipleDelayedWithdrawalsError, NoDelayedRouteError, NoRecordedIntentError, NoStrategyTargetCollateralError, OpenFlowError, PoolSunsetError, QuotaCountExceededError, QuotaLimitReachedError, RefusalErrors, UnexpectedFailureError, UnsupportedCollateralTokenError, UnsupportedTokenPairError, WithRouteRefusals, WithdrawalInProgressError, creditAccountNotFound, noStrategyTargetCollateral, toRefusalError, unexpectedFailure } from "./errors.js";
-import { AddCollateralParams, AdjustLeverageParams, DelayedStrategyResult, DepositStrategyParams, FinalizeParams, FinalizeResult, IOpportunitiesPrepare, LpParams, LpRedeemParams, LpResult, LpState, OpenStrategyParams, OpenStrategyResult, PoolInput, PositionInput, PrepareOptions, RepayStrategyParams, StrategyInput, StrategyResult, StrategyRoutesResult, WithdrawCollateralParams, WithdrawStrategyParams } from "./types.js";
+import { OperationState, PathLossRate, RouteErrors, WithdrawCeilings } from "../../onchain/accounts/intents/types.js";
+import { AccountFlowError, AddCollateralParams, AdjustLeverageParams, DelayedStrategyResult, DepositStrategyParams, FinalizeParams, FinalizeResult, IOpportunitiesPrepare, LpParams, LpRedeemParams, LpResult, LpState, OpenFlowError, OpenStrategyParams, OpenStrategyResult, PoolInput, PositionInput, PrepareOptions, RepayStrategyParams, StrategyInput, StrategyResult, StrategyRoutesResult, WithRouteErrors, WithdrawCollateralParams, WithdrawStrategyParams } from "./types.js";
 import { ChainOf, PrepareApi } from "./PrepareApi.js";
-export { AccountFlowError, AddCollateralParams, AdjustLeverageParams, BorrowLimitBinding, ChainOf, CreditAccountNotFoundError, DebtOutOfRangeError, DelayedStrategyResult, DepositStrategyParams, FinalizeParams, FinalizeResult, ForbiddenTokenError, IOpportunitiesPrepare, InsufficientCollateralError, InsufficientPoolLiquidityError, InsufficientSourceBalanceError, IntentPreviewError, type LeverageBand, LeverageOutOfRangeError, LpParams, LpRedeemParams, LpResult, LpState, MalformedTransactionError, MarketExpiredError, MarketPausedError, MultipleDelayedWithdrawalsError, NoDelayedRouteError, NoRecordedIntentError, NoStrategyTargetCollateralError, OpenFlowError, OpenStrategyParams, OpenStrategyResult, type OperationState, type PathLossRate, PoolInput, PoolSunsetError, PositionInput, PrepareApi, PrepareOptions, PreviewErrorDetails, PreviewErrorReason, PreviewIssue, PreviewRefusal, QuotaCountExceededError, QuotaLimitReachedError, RefusalErrors, RepayStrategyParams, StrategyInput, StrategyResult, StrategyRoutesResult, UnexpectedFailureError, UnsupportedCollateralTokenError, UnsupportedTokenPairError, WithRouteRefusals, type WithdrawCeilings, WithdrawCollateralParams, WithdrawStrategyParams, WithdrawalInProgressError, creditAccountNotFound, noStrategyTargetCollateral, raise, refuse, toRefusalError, unexpectedFailure };
+export { AccountFlowError, AddCollateralParams, AdjustLeverageParams, ChainOf, type CreditAccountNotEmptyError, type CreditAccountNotFoundError, DelayedStrategyResult, DepositStrategyParams, type EmptyOpenTakesNothingError, FinalizeParams, FinalizeResult, IOpportunitiesPrepare, type LeverageBand, LpParams, LpRedeemParams, LpResult, LpState, type MultipleDelayedWithdrawalsError, type NoDelayedRouteError, type NoRecordedIntentError, type NoStrategyTargetCollateralError, OpenFlowError, OpenStrategyParams, OpenStrategyResult, type OperationState, type PathLossRate, PoolInput, PositionInput, PrepareApi, PrepareOptions, RepayStrategyParams, type RouteErrors, StrategyInput, StrategyResult, StrategyRoutesResult, type UnexpectedFailureError, type UnsupportedCollateralTokenError, type UnsupportedTokenPairError, WithRouteErrors, type WithdrawCeilings, WithdrawCollateralParams, WithdrawStrategyParams, type WithdrawalInProgressError, creditAccountNotEmpty, creditAccountNotFound, emptyOpenTakesNothing, noStrategyTargetCollateral, unexpectedFailure };

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

@@ -1,5 +1,7 @@
 import { Bps, Timestamp, TokenAmount } from "../../model/primitives.js";
 import { Curator } from "../../model/curators.js";
+import { CreditManagerPausedError, DebtOutOfRangeError, ForbiddenTokenError, InsufficientBalanceError, InsufficientCollateralError, InsufficientPoolLiquidityError, LeverageOutOfRangeError, MarketExpiredError, QuotaLimitReachedError } from "../../model/errors/operation-errors.js";
+import { CreditAccountNotEmptyError, CreditAccountNotFoundError, EmptyOpenTakesNothingError, MultipleDelayedWithdrawalsError, NoDelayedRouteError, NoRecordedIntentError, NoStrategyTargetCollateralError, UnexpectedFailureError, UnsupportedCollateralTokenError, UnsupportedTokenPairError, WithdrawalInProgressError } from "../../model/errors/prepare-errors.js";
 import { PoolOpportunityKey, StrategyOpportunityKey } from "../../model/opportunities.js";
 import { PositionCollateral, StrategyPosition, StrategyPositionKey } from "../../model/positions.js";
 import { SDKReturn } from "../../model/result.js";
@@ -8,15 +10,32 @@ import "../../model/index.js";
 import { Asset } from "../../onchain/base/types.js";
 import { MultiCall } from "../../onchain/types/transactions.js";
 import { PoolSimulation } from "../../onchain/pools/types.js";
-import { BorrowLimitBinding, IntentPreviewError, PreviewErrorDetails, PreviewErrorReason, PreviewIssue, PreviewRefusal, raise, refuse } from "../../onchain/validation/refusal.js";
 import { LeverageBand } from "../../onchain/accounts/intents/leverage-band.js";
 import { AccountCalculatorOperation } from "../../onchain/accounts/intents/operations.js";
-import { ClaimRemainder, DelayedStart, OperationState, PathLossRate, ResumableIntent, RouteRefusals, WithdrawCeilings } from "../../onchain/accounts/intents/types.js";
+import { ClaimRemainder, DelayedStart, OperationState, PathLossRate, ResumableIntent, RouteErrors, WithdrawCeilings } from "../../onchain/accounts/intents/types.js";
 import { OpenStrategyState } from "../../onchain/accounts/intents/open-strategy.js";
 import "../../onchain/index.js";
-import { AccountFlowError, DebtOutOfRangeError, InsufficientPoolLiquidityError, LeverageOutOfRangeError, MultipleDelayedWithdrawalsError, NoDelayedRouteError, NoRecordedIntentError, NoStrategyTargetCollateralError, OpenFlowError, UnexpectedFailureError, UnsupportedCollateralTokenError, UnsupportedTokenPairError, WithRouteRefusals, WithdrawalInProgressError } from "./errors.js";
 import { Address } from "viem";
 //#region src/sdk/prepare/types.d.ts
+/**
+ * What any operation on an existing account can answer with: the engine's
+ * shared guards, the missing account, and a wrapped crash.
+ **/
+type AccountFlowError = CreditManagerPausedError | MarketExpiredError | ForbiddenTokenError | QuotaLimitReachedError | InsufficientCollateralError | InsufficientBalanceError | CreditAccountNotFoundError | UnexpectedFailureError;
+/** Same guards for the account-less open flow. */
+type OpenFlowError = CreditManagerPausedError | MarketExpiredError | ForbiddenTokenError | QuotaLimitReachedError | InsufficientCollateralError | InsufficientBalanceError | UnexpectedFailureError;
+/**
+ * What every error of a two-route request carries on top of its own code,
+ * see {@link StrategyRoutesResult}.
+ *
+ * `errors` says why each route is missing, which is the answer a form needs
+ * even when neither exists: the error itself is the instant route's — the one
+ * a caller can usually act on — or the delayed route's when the instant one
+ * did not get far enough to have a reason of its own.
+ **/
+interface WithRouteErrors {
+  errors: RouteErrors;
+}
 /**
  * Where a pool operation leaves the wallet: the two sides of the trade as
  * `sdk.pools` prices them, plus what a screen needs beside them and the raw
@@ -104,7 +123,7 @@ interface StrategyResult {
  **/
 interface FinalizeResult extends StrategyResult {
   /**
-   * What the claim did not bring, when the venue paid out part of the matured
+   * What the claim did not bring, when the venue settled part of the matured
    * withdrawal and left the rest of it queued — only a legacy Mellow multivault
    * does. `undefined` everywhere else, which is the normal case: one request,
    * one claim, one tail.
@@ -164,27 +183,27 @@ interface DelayedStrategyResult {
  * Whether the account can sell that asset on the router, redeem it through its
  * issuer, or both, is not something the caller can know up front, so both routes
  * are quoted from one request. A route the account cannot take is `undefined`
- * with its refusal in `refused`, which is what lets a form offer exactly the
+ * with its error in `errors`, which is what lets a form offer exactly the
  * routes that exist; a failure means neither does, and the error still carries
- * `refused`, see {@link WithRouteRefusals}.
+ * `errors`, see {@link WithRouteErrors}.
  **/
 interface StrategyRoutesResult {
   /**
    * The router route: one transaction, settled on the spot. `undefined`
-   * when the asset cannot be sold, see `refused.instant`.
+   * when the asset cannot be sold, see `errors.instant`.
    **/
   instant: StrategyResult | undefined;
   /**
    * The request half of the redemption route, which
    * {@link IOpportunitiesPrepare.finalize} completes once it matures.
    * `undefined` when the route does not exist — no redemption venue for the
-   * asset, or a request that settles at once anyway — see `refused.delayed`.
+   * asset, or a request that settles at once anyway — see `errors.delayed`.
    **/
   delayed: DelayedStrategyResult | undefined;
   /**
-   * Why a missing route was refused, see {@link RouteRefusals}.
+   * Why a missing route is missing, see {@link RouteErrors}.
    **/
-  refused: RouteRefusals;
+  errors: RouteErrors;
   /** Block of the chain state this result was computed from. */
   blockNumber: number;
   /** Unix seconds of {@link blockNumber}. */
@@ -261,7 +280,7 @@ interface WithdrawStrategyParams extends PrepareOptions {
    * see {@link IOpportunitiesPrepare.withdrawStrategy}.
    **/
   amount: bigint;
-  /** Wallet receiving the payout. */
+  /** Token recipient. */
   to: Address;
   /**
    * Token the wallet receives. Defaults to the market underlying, force-unwrapped
@@ -332,6 +351,29 @@ interface OpenStrategyParams extends PrepareOptions {
   targetToken?: Address;
   /** Collateral to leave unswapped; everything else is routed into the target. */
   leftoverBalances?: Asset[];
+  /**
+   * Existing credit account to open the position on, instead of creating one.
+   *
+   * Must belong to `strategy.creditManager` and carry no debt and no quotas —
+   * an account pre-opened by an {@link empty} opening.
+   * The projection is identical either way; only the transaction differs, and
+   * `execute.buildTx` reads which one to build off the result's own
+   * `state.creditAccount`.
+   **/
+  creditAccount?: Address;
+  /**
+   * Open the account holding nothing: no collateral, no debt, no quotas, and no
+   * route quoted. A wallet holds one so a position can be put on it later, by
+   * an opening that names it as {@link creditAccount}.
+   *
+   * {@link collateral} must be empty, {@link leverage} zero and
+   * {@link creditAccount} unset — the flag and the arguments have to agree.
+   * Neither leverage nor {@link targetToken} is read: with no collateral the
+   * debt is zero at any leverage, and there is nothing to route anywhere. Zero
+   * is the one leverage an ordinary opening refuses, so it cannot be mistaken
+   * for a request.
+   **/
+  empty?: boolean;
 }
 interface LpParams {
   /**
@@ -351,7 +393,7 @@ interface LpParams {
   tokenIn?: Address;
   /**
    * Token the user receives. Defaults to the only route available for `tokenIn`;
-   * required when the pool offers several, otherwise the preparation is refused
+   * required when the pool offers several, otherwise the preparation answers
    * with `unsupportedTokenPair`.
    **/
   tokenOut?: Address;
@@ -395,11 +437,11 @@ interface FinalizeParams extends PrepareOptions {
  * pathfinder for real swap paths. Nothing is executed and nothing is signed —
  * the result is the numbers plus the calldata that would produce them.
  *
- * Not to be confused with `src/preview`, which goes the other way: it takes
+ * Not to be confused with `src/onchain/preview`, which goes the other way: it takes
  * calldata that already exists and reports what it would do.
  *
  * Every refusable method answers `SDKReturn` and names, in its own signature,
- * exactly the errors its flow can refuse with — the union is the list of
+ * exactly the errors its flow can answer with — the union is the list of
  * everything a caller has to handle, checked by the compiler. None of them
  * throws: a chain that cannot be reached or a crash on the way arrives as
  * `unexpectedFailure` with the cause attached.
@@ -438,7 +480,7 @@ interface IOpportunitiesPrepare {
    * The one flow with no account yet, so the result carries no operation list —
    * it feeds `sdk.accounts.openCA` instead.
    **/
-  openNewStrategy(strategy: StrategyInput, params: OpenStrategyParams): Promise<SDKReturn<OpenStrategyResult, OpenFlowError | DebtOutOfRangeError | LeverageOutOfRangeError | UnsupportedTokenPairError | InsufficientPoolLiquidityError | NoStrategyTargetCollateralError>>;
+  openNewStrategy(strategy: StrategyInput, params: OpenStrategyParams): Promise<SDKReturn<OpenStrategyResult, OpenFlowError | DebtOutOfRangeError | LeverageOutOfRangeError | UnsupportedTokenPairError | InsufficientPoolLiquidityError | NoStrategyTargetCollateralError | EmptyOpenTakesNothingError | CreditAccountNotFoundError | CreditAccountNotEmptyError>>;
   /**
    * Growing a position: collateral in, debt drawn on top, both converted into
    * the position token.
@@ -471,7 +513,7 @@ interface IOpportunitiesPrepare {
    * @see withdrawCollateral to move an asset out without touching debt, which
    * raises leverage instead.
    **/
-  withdrawStrategy(position: PositionInput, params: WithdrawStrategyParams): Promise<SDKReturn<StrategyRoutesResult, (AccountFlowError | DebtOutOfRangeError | UnsupportedTokenPairError | NoDelayedRouteError | MultipleDelayedWithdrawalsError | WithdrawalInProgressError) & WithRouteRefusals>>;
+  withdrawStrategy(position: PositionInput, params: WithdrawStrategyParams): Promise<SDKReturn<StrategyRoutesResult, (AccountFlowError | DebtOutOfRangeError | UnsupportedTokenPairError | NoDelayedRouteError | MultipleDelayedWithdrawalsError | WithdrawalInProgressError) & WithRouteErrors>>;
   /**
    * How much {@link withdrawStrategy} can take out, both ends of it, in
    * underlying units: `partial` is the largest withdrawal that keeps leverage
@@ -525,9 +567,9 @@ interface IOpportunitiesPrepare {
    * Answers with both routes, like {@link withdrawStrategy}, since deleveraging
    * sells the position token and may only be able to redeem it. Raising leverage
    * buys instead, so there the delayed route is always absent with
-   * `refused.delayed: "noDelayedRoute"`.
+   * `errors.delayed` set to `noDelayedRoute`.
    **/
-  adjustLeverage(position: PositionInput, params: AdjustLeverageParams): Promise<SDKReturn<StrategyRoutesResult, (AccountFlowError | DebtOutOfRangeError | UnsupportedTokenPairError | NoDelayedRouteError | MultipleDelayedWithdrawalsError | WithdrawalInProgressError | InsufficientPoolLiquidityError | LeverageOutOfRangeError) & WithRouteRefusals>>;
+  adjustLeverage(position: PositionInput, params: AdjustLeverageParams): Promise<SDKReturn<StrategyRoutesResult, (AccountFlowError | DebtOutOfRangeError | UnsupportedTokenPairError | NoDelayedRouteError | MultipleDelayedWithdrawalsError | WithdrawalInProgressError | InsufficientPoolLiquidityError | LeverageOutOfRangeError) & WithRouteErrors>>;
   /**
    * Putting the position token onto the account at fixed debt, which lowers
    * leverage and raises the health factor.
@@ -548,7 +590,7 @@ interface IOpportunitiesPrepare {
    * `maxLeverage` on the opportunity is the ceiling the liquidation threshold
    * allows, and it is the same number whatever the deposit. What a given
    * deposit reaches is decided by the debt it implies —
-   * `debt = netValue x (leverage - 1)` — and by the band the market puts that
+   * `debt = netValue x (leverage - 1)` — and by the `debtLimits` the market puts that
    * debt in.
    *
    * Synchronous, unlike the ceilings above it: those read the account from the
@@ -557,7 +599,7 @@ interface IOpportunitiesPrepare {
    * opening takes the tokens being deposited, adjusting the position's own net
    * value in the underlying.
    *
-   * Nothing at all when the market has no band to offer: a deposit too small
+   * Nothing at all when the market has no range to offer: a deposit too small
    * to carry `minDebt` at any leverage the threshold allows, or a manager with
    * no borrowing room left. Not the same answer as "every leverage works", and
    * a caller must not mark a range for it.
@@ -589,7 +631,7 @@ interface IOpportunitiesPrepare {
    * withdraw-collateral form should offer.
    *
    * `targetHF` names the health factor to leave the account at, in basis
-   * points; omitted, the SDK holds it to the bar a form would.
+   * points; omitted, the SDK holds it to the threshold a form would.
    *
    * A bare read: it answers its number, and throws on an account or a chain
    * the SDK does not hold.
@@ -613,11 +655,11 @@ interface IOpportunitiesPrepare {
    * Reports `noRecordedIntent` when the claim names no operation to resume.
    *
    * A claim can settle only part of what was queued — a legacy Mellow
-   * multivault pays out what it holds liquid and re-queues the rest — and then
+   * multivault hands over what it holds liquid and re-queues the rest — and then
    * the result serves that share and `remainder` says what is left, see
    * {@link FinalizeResult.remainder}.
    **/
   finalize(position: PositionInput, params: FinalizeParams): Promise<SDKReturn<FinalizeResult, AccountFlowError | NoRecordedIntentError | NoDelayedRouteError | WithdrawalInProgressError | UnsupportedTokenPairError>>;
 }
 //#endregion
-export { AddCollateralParams, AdjustLeverageParams, BorrowLimitBinding, DelayedStrategyResult, DepositStrategyParams, FinalizeParams, FinalizeResult, IOpportunitiesPrepare, IntentPreviewError, type LeverageBand, LpParams, LpRedeemParams, LpResult, LpState, OpenStrategyParams, OpenStrategyResult, type OperationState, type PathLossRate, PoolInput, PositionInput, PrepareOptions, PreviewErrorDetails, PreviewErrorReason, PreviewIssue, PreviewRefusal, RepayStrategyParams, StrategyInput, StrategyResult, StrategyRoutesResult, type WithdrawCeilings, WithdrawCollateralParams, WithdrawStrategyParams, raise, refuse };
+export { AccountFlowError, AddCollateralParams, AdjustLeverageParams, type CreditAccountNotEmptyError, type CreditAccountNotFoundError, DelayedStrategyResult, DepositStrategyParams, type EmptyOpenTakesNothingError, FinalizeParams, FinalizeResult, IOpportunitiesPrepare, type LeverageBand, LpParams, LpRedeemParams, LpResult, LpState, type MultipleDelayedWithdrawalsError, type NoDelayedRouteError, type NoRecordedIntentError, type NoStrategyTargetCollateralError, OpenFlowError, OpenStrategyParams, OpenStrategyResult, type OperationState, type PathLossRate, PoolInput, PositionInput, PrepareOptions, RepayStrategyParams, type RouteErrors, StrategyInput, StrategyResult, StrategyRoutesResult, type UnexpectedFailureError, type UnsupportedCollateralTokenError, type UnsupportedTokenPairError, WithRouteErrors, type WithdrawCeilings, WithdrawCollateralParams, WithdrawStrategyParams, type WithdrawalInProgressError };

package/dist/types/sdk/preview/PreviewNamespace.d.ts

@@ -2,10 +2,12 @@ import { OperationPreview, PreviewOperationInput, PreviewOperationOptions } from
 import { SDKReturn } from "../../model/result.js";
 import "../../model/index.js";
 import { MultichainSDK } from "../../onchain/MultichainSDK.js";
+import { PreviewOperationError } from "../../onchain/preview/preview/previewOperation.js";
+import { HealthFactorThresholds } from "../../onchain/validation/bundles/checkHealthFactors.js";
+import { CheckOperationOptions, OperationValidationError } from "../../onchain/validation/checkOperation.js";
+import { CheckSimulationInput, SimulationValidationError } from "../../onchain/validation/checkSimulation.js";
 import "../../onchain/index.js";
-import { PreviewOperationError } from "../../preview/preview/previewOperation.js";
-import "../../preview/index.js";
-import { IPreview } from "./types.js";
+import { CheckOperationProps, IPreview } from "./types.js";
 import { NamespaceOptions } from "../types.js";
 //#region src/sdk/preview/PreviewNamespace.d.ts
 /**
@@ -18,6 +20,14 @@ declare class PreviewNamespace implements IPreview {
    * {@inheritDoc IPreview.previewOperation}
    **/
   previewOperation(input: PreviewOperationInput, options?: PreviewOperationOptions): Promise<SDKReturn<OperationPreview, PreviewOperationError>>;
+  /**
+   * {@inheritDoc IPreview.checkOperation}
+   **/
+  checkOperation(props: CheckOperationProps, options?: CheckOperationOptions): Promise<OperationValidationError[]>;
+  /**
+   * {@inheritDoc IPreview.checkSimulation}
+   **/
+  checkSimulation(props: CheckSimulationInput, options?: HealthFactorThresholds): Promise<SimulationValidationError[]>;
 }
 //#endregion
 export { PreviewNamespace };

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

@@ -1,3 +1,3 @@
-import { IPreview, IPreviewByMode } from "./types.js";
+import { CheckOperationProps, IPreview, IPreviewByMode } from "./types.js";
 import { PreviewNamespace } from "./PreviewNamespace.js";
-export { IPreview, IPreviewByMode, PreviewNamespace };
+export { CheckOperationProps, IPreview, IPreviewByMode, PreviewNamespace };

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

@@ -1,20 +1,43 @@
+import { ChainId } from "../../model/primitives.js";
 import { OperationPreview, PreviewOperationInput, PreviewOperationOptions } from "../../model/previews.js";
 import { SDKReturn } from "../../model/result.js";
 import "../../model/index.js";
-import { PreviewOperationError } from "../../preview/preview/previewOperation.js";
-import "../../preview/index.js";
+import { PreviewOperationError } from "../../onchain/preview/preview/previewOperation.js";
+import { HealthFactorThresholds } from "../../onchain/validation/bundles/checkHealthFactors.js";
+import { CheckOperationInput, CheckOperationOptions, OperationValidationError } from "../../onchain/validation/checkOperation.js";
+import { CheckSimulationInput, SimulationValidationError } from "../../onchain/validation/checkSimulation.js";
+import "../../onchain/index.js";
 //#region src/sdk/preview/types.d.ts
 /**
- * On-chain preview of a raw operation calldata.
+ * Parsed-operation check on the namespace: the standalone input minus `sdk`,
+ * plus the chain to resolve it on. `OperationPreview` only names the chain
+ * inside a token, so `chainId` is required.
+ **/
+type CheckOperationProps = Omit<CheckOperationInput, "sdk"> & {
+  chainId: ChainId;
+};
+/**
+ * On-chain preview of a raw operation calldata, and checks of a parsed or
+ * simulated one.
  **/
 interface IPreview {
   /**
    * Decodes a raw operation and assembles an operation-specific,
-   * human-displayable preview. A refusal of the calldata — an unsupported
-   * target, function or operation, a foreign delayed intent, a failed
-   * simulation — is the `ok: false` half; genuine failures still throw.
+   * human-displayable preview.
    **/
   previewOperation(input: PreviewOperationInput, options?: PreviewOperationOptions): Promise<SDKReturn<OperationPreview, PreviewOperationError>>;
+  /**
+   * Whether a parsed operation may be signed by `sender`: protocol state first,
+   * then what the wallet has to approve, hold or sign.
+   **/
+  checkOperation(props: CheckOperationProps, options?: CheckOperationOptions): Promise<OperationValidationError[]>;
+  /**
+   * Whether a simulated operation clears the caller's own thresholds.
+   *
+   * Async because the namespace refreshes chain state first; the standalone
+   * checker is sync.
+   **/
+  checkSimulation(props: CheckSimulationInput, options?: HealthFactorThresholds): Promise<SimulationValidationError[]>;
 }
 /**
  * `sdk.preview` per mode: an on-chain read, absent when the SDK reads no chain.
@@ -25,4 +48,4 @@ interface IPreviewByMode {
   both: IPreview;
 }
 //#endregion
-export { IPreview, IPreviewByMode };
+export { CheckOperationProps, IPreview, IPreviewByMode };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gearbox-protocol/sdk",
-  "version": "16.1.2",
+  "version": "16.3.0-next.1",
   "description": "Gearbox SDK",
   "license": "MIT",
   "repository": {
@@ -59,11 +59,6 @@
       "import": "./dist/esm/permissionless/index.js",
       "default": "./dist/cjs/permissionless/index.js"
     },
-    "./preview": {
-      "types": "./dist/types/preview/index.d.ts",
-      "import": "./dist/esm/preview/index.js",
-      "default": "./dist/cjs/preview/index.js"
-    },
     "./rewards": {
       "types": "./dist/types/rewards/index.d.ts",
       "import": "./dist/esm/rewards/index.js",

package/dist/cjs/onchain/accounts/withdrawal-compressor/errors.js

@@ -1 +0,0 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });

package/dist/cjs/onchain/market/zapper/errors.js

@@ -1 +0,0 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });