@gearbox-protocol/sdk 16.0.0-next.42 → 16.0.0-next.44

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 { LeverageBand } from "../../onchain/accounts/intents/leverage-band.js";
 import { OperationState, PathLossRate } from "../../onchain/accounts/intents/types.js";
-import { CreditAccountNotFoundError, DebtOutOfRangeError, ForbiddenTokenError, InsufficientCollateralError, InsufficientPoolLiquidityError, InsufficientSourceBalanceError, LeverageOutOfRangeError, MalformedTransactionError, MarketExpiredError, MarketPausedError, MultipleDelayedWithdrawalsError, NoDelayedRouteError, NoRecordedIntentError, NoStrategyTargetCollateralError, PoolSunsetError, PrepareError, QuotaCountExceededError, QuotaLimitReachedError, RoutesPrepareError, UnexpectedFailureError, UnsupportedCollateralTokenError, UnsupportedTokenPairError, WithdrawalInProgressError, creditAccountNotFound, noStrategyTargetCollateral, toPrepareError, unexpectedFailure } from "./errors.js";
-import { AddCollateralParams, AdjustLeverageParams, AmountPrepare, DelayedStrategyPlan, DelayedStrategyPrepare, DepositStrategyParams, FinalizeParams, IOpportunitiesPrepare, LpParams, LpPlan, LpPrepare, LpRedeemParams, OpenStrategyParams, OpenStrategyPlan, OpenStrategyPrepare, PoolInput, PositionInput, PrepareOptions, RepayStrategyParams, StrategyInput, StrategyPlan, StrategyPrepare, StrategyRoutes, StrategyRoutesPrepare, WithdrawCollateralParams, WithdrawStrategyParams } from "./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, IOpportunitiesPrepare, LpParams, LpRedeemParams, LpResult, OpenStrategyParams, OpenStrategyResult, PoolInput, PositionInput, PrepareOptions, RepayStrategyParams, StrategyInput, StrategyResult, StrategyRoutesResult, WithdrawCollateralParams, WithdrawStrategyParams } from "./types.js";
 import { ChainOf, PrepareApi } from "./PrepareApi.js";
-export { AddCollateralParams, AdjustLeverageParams, AmountPrepare, BorrowLimitBinding, ChainOf, CreditAccountNotFoundError, DebtOutOfRangeError, DelayedStrategyPlan, DelayedStrategyPrepare, DepositStrategyParams, FinalizeParams, ForbiddenTokenError, IOpportunitiesPrepare, InsufficientCollateralError, InsufficientPoolLiquidityError, InsufficientSourceBalanceError, IntentPreviewError, type LeverageBand, LeverageOutOfRangeError, LpParams, LpPlan, LpPrepare, LpRedeemParams, MalformedTransactionError, MarketExpiredError, MarketPausedError, MultipleDelayedWithdrawalsError, NoDelayedRouteError, NoRecordedIntentError, NoStrategyTargetCollateralError, OpenStrategyParams, OpenStrategyPlan, OpenStrategyPrepare, type OperationState, type PathLossRate, PoolInput, PoolSunsetError, PositionInput, PrepareApi, PrepareError, PrepareOptions, PreviewErrorDetails, PreviewErrorReason, PreviewIssue, PreviewRefusal, QuotaCountExceededError, QuotaLimitReachedError, RepayStrategyParams, RoutesPrepareError, StrategyInput, StrategyPlan, StrategyPrepare, StrategyRoutes, StrategyRoutesPrepare, UnexpectedFailureError, UnsupportedCollateralTokenError, UnsupportedTokenPairError, WithdrawCollateralParams, WithdrawStrategyParams, WithdrawalInProgressError, creditAccountNotFound, noStrategyTargetCollateral, raise, refuse, toPrepareError, unexpectedFailure };
+export { AccountFlowError, AddCollateralParams, AdjustLeverageParams, BorrowLimitBinding, ChainOf, CreditAccountNotFoundError, DebtOutOfRangeError, DelayedStrategyResult, DepositStrategyParams, FinalizeParams, ForbiddenTokenError, IOpportunitiesPrepare, InsufficientCollateralError, InsufficientPoolLiquidityError, InsufficientSourceBalanceError, IntentPreviewError, type LeverageBand, LeverageOutOfRangeError, LpParams, LpRedeemParams, LpResult, 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, WithdrawCollateralParams, WithdrawStrategyParams, WithdrawalInProgressError, creditAccountNotFound, noStrategyTargetCollateral, raise, refuse, toRefusalError, unexpectedFailure };

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

@@ -1,8 +1,7 @@
-import { Bps } from "../../model/primitives.js";
-import { WithError } from "../../model/errors.js";
+import { Bps, Timestamp } from "../../model/primitives.js";
 import { PoolOpportunityKey, StrategyOpportunityKey } from "../../model/opportunities.js";
 import { PositionCollateral, StrategyPosition, StrategyPositionKey } from "../../model/positions.js";
-import { DataResponse } from "../../model/response.js";
+import { SDKReturn } from "../../model/result.js";
 import { PositionClaimableWithdrawal } from "../../model/withdrawals.js";
 import "../../model/index.js";
 import { Asset } from "../../onchain/base/types.js";
@@ -14,18 +13,18 @@ import { AccountCalculatorOperation } from "../../onchain/accounts/intents/opera
 import { DelayedStart, OperationState, PathLossRate, ResumableIntent, RouteRefusals } from "../../onchain/accounts/intents/types.js";
 import { OpenStrategyState } from "../../onchain/accounts/intents/open-strategy.js";
 import "../../onchain/index.js";
-import { PrepareError, RoutesPrepareError } from "./errors.js";
+import { AccountFlowError, DebtOutOfRangeError, InsufficientPoolLiquidityError, LeverageOutOfRangeError, MultipleDelayedWithdrawalsError, NoDelayedRouteError, NoRecordedIntentError, NoStrategyTargetCollateralError, OpenFlowError, UnsupportedCollateralTokenError, UnsupportedTokenPairError, WithRouteRefusals, WithdrawalInProgressError } from "./errors.js";
 import { Address } from "viem";
 //#region src/sdk/prepare/types.d.ts
 /**
  * What a pool deposit or withdrawal comes to.
  *
- * Shaped like {@link StrategyPlan} so both kinds of result are consumed the
+ * Shaped like {@link StrategyResult} so both kinds of result are consumed the
  * same way, with the pool's own numbers as the state: the ERC-4626
  * conversion applied to the amount, at the rate of the block the market was
  * loaded at.
  **/
-interface LpPlan {
+interface LpResult {
   /**
    * Always empty: a pool operation is a single transaction, so there is no
    * chain of steps to show. Present so callers can treat both kinds of
@@ -42,15 +41,15 @@ interface LpPlan {
    * operation is a single call on the pool or on its zapper.
    **/
   calls: MultiCall[];
+  /** Block of the chain state this result was computed from. */
+  blockNumber: number;
+  /** Unix seconds of {@link blockNumber}. */
+  timestamp: Timestamp;
 }
-/**
- * {@link LpPlan}, or why the pool cannot serve the request.
- **/
-type LpPrepare = WithError<LpPlan, PrepareError>;
 /**
  * What an operation on an existing credit account comes to.
  **/
-interface StrategyPlan {
+interface StrategyResult {
   /**
    * The logical steps, each carrying the amounts it was computed from.
    * Useful for showing the user what will happen, and for pinning behaviour
@@ -67,29 +66,23 @@ interface StrategyPlan {
    * through `sdk.accounts`.
    **/
   calls: MultiCall[];
+  /** Block of the chain state this result was computed from. */
+  blockNumber: number;
+  /** Unix seconds of {@link blockNumber}. */
+  timestamp: Timestamp;
 }
-/**
- * {@link StrategyPlan}, or why the request cannot be served.
- *
- * A failure here means the request itself is not viable — not that a call
- * failed — so it is a value rather than an exception: too much leverage, too
- * little of the source token, a token the flow does not accept. What could not
- * be done is `error.code`, and the limit that was missed is on the error beside
- * it, see {@link PrepareError}.
- **/
-type StrategyPrepare = WithError<StrategyPlan, PrepareError>;
 /**
  * What the leading half of a delayed operation comes to: the request
  * transaction, plus what it recorded for the tail and where that tail leads.
  *
- * Shaped like {@link StrategyPlan} with one field more, so the instant and
+ * Shaped like {@link StrategyResult} with one field more, so the instant and
  * the delayed route of the same request are compared side by side — and they
  * are meant to be compared on the same footing, so `state` is the end of the
  * operation in both, not the end of the transaction.
  **/
-interface DelayedStrategyPlan {
+interface DelayedStrategyResult {
   /**
-   * {@inheritDoc StrategyPlan.operations}
+   * {@inheritDoc StrategyResult.operations}
    **/
   operations: AccountCalculatorOperation[];
   /**
@@ -104,7 +97,7 @@ interface DelayedStrategyPlan {
    **/
   state: OperationState;
   /**
-   * {@inheritDoc StrategyPlan.calls}
+   * {@inheritDoc StrategyResult.calls}
    **/
   calls: MultiCall[];
   /**
@@ -112,11 +105,11 @@ interface DelayedStrategyPlan {
    * {@link DelayedStart}.
    **/
   delayed: DelayedStart;
+  /** Block of the chain state this result was computed from. */
+  blockNumber: number;
+  /** Unix seconds of {@link blockNumber}. */
+  timestamp: Timestamp;
 }
-/**
- * {@link DelayedStrategyPlan}, or why the redemption route cannot be taken.
- **/
-type DelayedStrategyPrepare = WithError<DelayedStrategyPlan, PrepareError>;
 /**
  * What one of the two flows that sell a position asset —
  * {@link IOpportunitiesPrepare.withdrawStrategy} and
@@ -128,55 +121,47 @@ type DelayedStrategyPrepare = WithError<DelayedStrategyPlan, PrepareError>;
  * 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
  * routes that exist; a failure means neither does, and the error still carries
- * `refused`, see {@link RoutesPrepareError}.
+ * `refused`, see {@link WithRouteRefusals}.
  **/
-interface StrategyRoutes {
+interface StrategyRoutesResult {
   /**
    * The router route: one transaction, settled on the spot. `undefined`
    * when the asset cannot be sold, see `refused.instant`.
    **/
-  instant: StrategyPlan | undefined;
+  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`.
    **/
-  delayed: DelayedStrategyPlan | undefined;
+  delayed: DelayedStrategyResult | undefined;
   /**
    * Why a missing route was refused, see {@link RouteRefusals}.
    **/
   refused: RouteRefusals;
+  /** Block of the chain state this result was computed from. */
+  blockNumber: number;
+  /** Unix seconds of {@link blockNumber}. */
+  timestamp: Timestamp;
 }
-/**
- * {@link StrategyRoutes}, or the refusal of both routes at once.
- **/
-type StrategyRoutesPrepare = WithError<StrategyRoutes, RoutesPrepareError>;
 /**
  * What opening a new leveraged position comes to.
  *
  * The only result that reports both an expected and a floor branch: opening
  * takes both from a single pathfinder call, and `openCA` consumes both.
  **/
-interface OpenStrategyPlan {
+interface OpenStrategyResult {
   /**
    * Everything the opening arrives at: the projection, both branches of the
    * post-open balances and quotas, and the router path `openCA` is handed.
    **/
   state: OpenStrategyState;
+  /** Block of the chain state this result was computed from. */
+  blockNumber: number;
+  /** Unix seconds of {@link blockNumber}. */
+  timestamp: Timestamp;
 }
-/**
- * {@link OpenStrategyPlan}, or why the position cannot be opened.
- **/
-type OpenStrategyPrepare = WithError<OpenStrategyPlan, PrepareError>;
-/**
- * A ceiling one of the `max*` reads answers with, in the units that read names,
- * or why the account it was asked about could not be weighed.
- *
- * The same envelope as a prepared operation, for the same reason: a form that
- * cannot show a limit needs to say why as much as one that cannot prepare.
- **/
-type AmountPrepare = WithError<bigint, PrepareError>;
 /**
  * Shared knobs. Both default to the SDK's own defaults when omitted.
  **/
@@ -365,14 +350,19 @@ interface FinalizeParams extends PrepareOptions {
  * Not to be confused with `src/preview`, which goes the other way: it takes
  * calldata that already exists and reports what it would do.
  *
- * Every method that can fail answers in the error envelope and none of them
- * throws: a market that refuses, an account that is not there, a chain that
- * cannot be reached — all of it arrives as `{ success: false, error }` with a
- * code, see {@link PrepareError}. The two synchronous readers
- * ({@link leverageBand}, {@link withdrawableCollaterals}) stay outside the
- * envelope: they weigh state already loaded and say "nothing available" with
- * `undefined` or an empty list, so their only failure is being handed a chain
- * this SDK was never connected to — an argument error, which throws.
+ * 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
+ * everything a caller has to handle, checked by the compiler. An async flow
+ * never throws: a chain that cannot be reached or a crash on the way arrives
+ * as `unexpectedFailure` with the cause attached. The synchronous LP flows
+ * only do arithmetic on loaded state, so their one refusal is the unroutable
+ * pair — anything else there is a bug or a lifecycle error, and it throws.
+ *
+ * The bare readers stay outside the envelope: the `max*` ceilings answer their
+ * number and throw on an account or chain the SDK does not hold, and the two
+ * synchronous readers ({@link leverageBand}, {@link withdrawableCollaterals})
+ * weigh state already loaded and say "nothing available" with `undefined` or
+ * an empty list.
  **/
 interface IOpportunitiesPrepare {
   /**
@@ -381,7 +371,7 @@ interface IOpportunitiesPrepare {
    * Synchronous, unlike every strategy method below: the answer is the pool's
    * share rate applied to the amount, and that rate is already loaded.
    **/
-  deposit(pool: PoolInput, params: LpParams): LpPrepare;
+  deposit(pool: PoolInput, params: LpParams): SDKReturn<LpResult, UnsupportedTokenPairError>;
   /**
    * Taking underlying out of a pool: `amount` is the `tokenOut` the wallet
    * wants back, and the pool burns whatever shares that costs.
@@ -389,26 +379,26 @@ interface IOpportunitiesPrepare {
    * The LP counterpart of {@link withdrawStrategy} / {@link withdrawCollateral},
    * which act on credit accounts.
    **/
-  withdraw(pool: PoolInput, params: LpParams): LpPrepare;
+  withdraw(pool: PoolInput, params: LpParams): SDKReturn<LpResult, UnsupportedTokenPairError>;
   /**
    * Redeeming pool shares: `amount` is the `tokenIn` the wallet parts with,
    * and the reported state is the underlying it converts to.
    **/
-  redeem(pool: PoolInput, params: LpRedeemParams): LpPrepare;
+  redeem(pool: PoolInput, params: LpRedeemParams): SDKReturn<LpResult, UnsupportedTokenPairError>;
   /**
    * Opening a leveraged position from wallet collateral.
    *
    * 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<DataResponse<OpenStrategyPrepare>>;
+  openNewStrategy(strategy: StrategyInput, params: OpenStrategyParams): Promise<SDKReturn<OpenStrategyResult, OpenFlowError | DebtOutOfRangeError | LeverageOutOfRangeError | UnsupportedTokenPairError | InsufficientPoolLiquidityError | NoStrategyTargetCollateralError>>;
   /**
    * Growing a position: collateral in, debt drawn on top, both converted into
    * the position token.
    *
    * Leverage stays put unless `targetLeverage` asks for more.
    **/
-  depositStrategy(position: PositionInput, params: DepositStrategyParams): Promise<DataResponse<StrategyPrepare>>;
+  depositStrategy(position: PositionInput, params: DepositStrategyParams): Promise<SDKReturn<StrategyResult, AccountFlowError | DebtOutOfRangeError | LeverageOutOfRangeError | UnsupportedCollateralTokenError | UnsupportedTokenPairError | InsufficientPoolLiquidityError>>;
   /**
    * Shrinking a position: part of its net value goes to the wallet and debt is
    * repaid in the same proportion, so leverage is unchanged.
@@ -416,7 +406,7 @@ interface IOpportunitiesPrepare {
    * Answers with both routes the withdrawal can take — sold through the router
    * now, or redeemed through the source's issuer and finished days later — since
    * the source token decides which of them exist, see
-   * {@link StrategyRoutesPrepare}.
+   * {@link StrategyRoutesResult}.
    *
    * `MAX_UINT256` — or any amount at or above the account's net value — is an
    * exit instead: the quotas are dropped, the position is sold whole in one
@@ -434,7 +424,7 @@ interface IOpportunitiesPrepare {
    * @see withdrawCollateral to move an asset out without touching debt, which
    * raises leverage instead.
    **/
-  withdrawStrategy(position: PositionInput, params: WithdrawStrategyParams): Promise<DataResponse<StrategyRoutesPrepare>>;
+  withdrawStrategy(position: PositionInput, params: WithdrawStrategyParams): Promise<SDKReturn<StrategyRoutesResult, (AccountFlowError | DebtOutOfRangeError | UnsupportedTokenPairError | NoDelayedRouteError | MultipleDelayedWithdrawalsError | WithdrawalInProgressError) & WithRouteRefusals>>;
   /**
    * Largest partial withdrawal {@link withdrawStrategy} accepts, in underlying
    * units: the amount whose proportional repayment leaves the debt at the
@@ -444,8 +434,11 @@ interface IOpportunitiesPrepare {
    *
    * Taking everything out needs none of this arithmetic: send `MAX_UINT256` to
    * {@link withdrawStrategy} and the exit is what runs.
+   *
+   * A bare read: it answers its number, and throws on an account or a chain
+   * the SDK does not hold.
    **/
-  maxWithdraw(position: PositionInput): Promise<DataResponse<AmountPrepare>>;
+  maxWithdraw(position: PositionInput): Promise<bigint>;
   /**
    * Paying debt down with funds from the wallet: collateral stays where it is,
    * so net value grows by what was repaid, leverage falls and the health factor
@@ -462,13 +455,16 @@ interface IOpportunitiesPrepare {
    * 10bps margin for the interest still to come, and whatever the facade does
    * not take stays on the account.
    **/
-  repayStrategy(position: PositionInput, params: RepayStrategyParams): Promise<DataResponse<StrategyPrepare>>;
+  repayStrategy(position: PositionInput, params: RepayStrategyParams): Promise<SDKReturn<StrategyResult, AccountFlowError | DebtOutOfRangeError | UnsupportedCollateralTokenError>>;
   /**
    * Debt {@link repayStrategy} would have to cover to clear the account, in
    * underlying units: principal, interest and fees as of this read. Interest
    * keeps accruing, so a wallet meaning to settle sends this with a buffer.
+   *
+   * A bare read: it answers its number, and throws on an account or a chain
+   * the SDK does not hold.
    **/
-  maxRepay(position: PositionInput): Promise<DataResponse<AmountPrepare>>;
+  maxRepay(position: PositionInput): Promise<bigint>;
   /**
    * Retargeting leverage at fixed collateral: debt moves, own funds do not.
    *
@@ -477,12 +473,12 @@ interface IOpportunitiesPrepare {
    * buys instead, so there the delayed route is always absent with
    * `refused.delayed: "noDelayedRoute"`.
    **/
-  adjustLeverage(position: PositionInput, params: AdjustLeverageParams): Promise<DataResponse<StrategyRoutesPrepare>>;
+  adjustLeverage(position: PositionInput, params: AdjustLeverageParams): Promise<SDKReturn<StrategyRoutesResult, (AccountFlowError | DebtOutOfRangeError | UnsupportedTokenPairError | NoDelayedRouteError | MultipleDelayedWithdrawalsError | WithdrawalInProgressError | InsufficientPoolLiquidityError | LeverageOutOfRangeError) & WithRouteRefusals>>;
   /**
    * Putting the position token onto the account at fixed debt, which lowers
    * leverage and raises the health factor.
    **/
-  addCollateral(position: PositionInput, params: AddCollateralParams): Promise<DataResponse<StrategyPrepare>>;
+  addCollateral(position: PositionInput, params: AddCollateralParams): Promise<SDKReturn<StrategyResult, AccountFlowError>>;
   /**
    * Moving one asset that already sits on the account out to the wallet, at
    * fixed debt — so TVL falls and leverage rises.
@@ -490,7 +486,7 @@ interface IOpportunitiesPrepare {
    * @see withdrawStrategy for the deleveraging withdrawal, which repays debt in
    * proportion and leaves leverage unchanged.
    **/
-  withdrawCollateral(position: PositionInput, params: WithdrawCollateralParams): Promise<DataResponse<StrategyPrepare>>;
+  withdrawCollateral(position: PositionInput, params: WithdrawCollateralParams): Promise<SDKReturn<StrategyResult, AccountFlowError>>;
   /**
    * The leverages a deposit of a given size can reach in this market: the
    * range a leverage slider should mark as available.
@@ -540,8 +536,11 @@ interface IOpportunitiesPrepare {
    *
    * `targetHF` names the health factor to leave the account at, in basis
    * points; omitted, the SDK holds it to the bar a form would.
+   *
+   * A bare read: it answers its number, and throws on an account or a chain
+   * the SDK does not hold.
    **/
-  maxWithdrawCollateral(position: PositionInput, token: Address, targetHF?: bigint): Promise<DataResponse<AmountPrepare>>;
+  maxWithdrawCollateral(position: PositionInput, token: Address, targetHF?: bigint): Promise<bigint>;
   /**
    * The tail of a delayed route: claim the matured withdrawal, then whatever the
    * operation that requested it still owes — repaying debt and paying the wallet
@@ -559,7 +558,7 @@ interface IOpportunitiesPrepare {
    * Answers like the instant flows, so both halves are consumed the same way.
    * Reports `noRecordedIntent` when the claim names no operation to resume.
    **/
-  finalize(position: PositionInput, params: FinalizeParams): Promise<DataResponse<StrategyPrepare>>;
+  finalize(position: PositionInput, params: FinalizeParams): Promise<SDKReturn<StrategyResult, AccountFlowError | NoRecordedIntentError | NoDelayedRouteError | WithdrawalInProgressError | UnsupportedTokenPairError>>;
 }
 //#endregion
-export { AddCollateralParams, AdjustLeverageParams, AmountPrepare, BorrowLimitBinding, DelayedStrategyPlan, DelayedStrategyPrepare, DepositStrategyParams, FinalizeParams, IOpportunitiesPrepare, IntentPreviewError, type LeverageBand, LpParams, LpPlan, LpPrepare, LpRedeemParams, OpenStrategyParams, OpenStrategyPlan, OpenStrategyPrepare, type OperationState, type PathLossRate, PoolInput, PositionInput, PrepareOptions, PreviewErrorDetails, PreviewErrorReason, PreviewIssue, PreviewRefusal, RepayStrategyParams, StrategyInput, StrategyPlan, StrategyPrepare, StrategyRoutes, StrategyRoutesPrepare, WithdrawCollateralParams, WithdrawStrategyParams, raise, refuse };
+export { AddCollateralParams, AdjustLeverageParams, BorrowLimitBinding, DelayedStrategyResult, DepositStrategyParams, FinalizeParams, IOpportunitiesPrepare, IntentPreviewError, type LeverageBand, LpParams, LpRedeemParams, LpResult, OpenStrategyParams, OpenStrategyResult, type OperationState, type PathLossRate, PoolInput, PositionInput, PrepareOptions, PreviewErrorDetails, PreviewErrorReason, PreviewIssue, PreviewRefusal, RepayStrategyParams, StrategyInput, StrategyResult, StrategyRoutesResult, WithdrawCollateralParams, WithdrawStrategyParams, raise, refuse };

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

@@ -1,7 +1,10 @@
 import { OperationPreview, PreviewOperationInput, PreviewOperationOptions } from "../../model/previews.js";
+import { SDKReturn } from "../../model/result.js";
 import "../../model/index.js";
 import { MultichainSDK } from "../../onchain/MultichainSDK.js";
 import "../../onchain/index.js";
+import { PreviewOperationError } from "../../preview/preview/previewOperation.js";
+import "../../preview/index.js";
 import { IPreview } from "./types.js";
 import { NamespaceOptions } from "../types.js";
 //#region src/sdk/preview/PreviewNamespace.d.ts
@@ -14,7 +17,7 @@ declare class PreviewNamespace implements IPreview {
   /**
    * {@inheritDoc IPreview.previewOperation}
    **/
-  previewOperation(input: PreviewOperationInput, options?: PreviewOperationOptions): Promise<OperationPreview>;
+  previewOperation(input: PreviewOperationInput, options?: PreviewOperationOptions): Promise<SDKReturn<OperationPreview, PreviewOperationError>>;
 }
 //#endregion
 export { PreviewNamespace };

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

@@ -1,5 +1,8 @@
 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";
 //#region src/sdk/preview/types.d.ts
 /**
  * On-chain preview of a raw operation calldata.
@@ -7,10 +10,11 @@ import "../../model/index.js";
 interface IPreview {
   /**
    * Decodes a raw operation and assembles an operation-specific,
-   * human-displayable preview. Throws when the operation is unsupported or
-   * the targeted credit account cannot be resolved.
+   * 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.
    **/
-  previewOperation(input: PreviewOperationInput, options?: PreviewOperationOptions): Promise<OperationPreview>;
+  previewOperation(input: PreviewOperationInput, options?: PreviewOperationOptions): Promise<SDKReturn<OperationPreview, PreviewOperationError>>;
 }
 /**
  * `sdk.preview` per mode: an on-chain read, absent when the SDK reads no chain.

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

@@ -114,9 +114,7 @@ interface OnchainByMode {
  * The banners the backend attaches to a pool opportunity or a strategy
  * position, see {@link Notice}.
  **/
-interface INotices {
-  (subject: NoticeSubject): Promise<DataResponse<Notice[]>>;
-}
+type INotices = (subject: NoticeSubject) => Promise<DataResponse<Notice[]>>;
 /**
  * `sdk.notices` per mode: a backend read, absent when the SDK reads no backend.
  **/

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gearbox-protocol/sdk",
-  "version": "16.0.0-next.42",
+  "version": "16.0.0-next.44",
   "description": "Gearbox SDK",
   "license": "MIT",
   "repository": {
@@ -90,7 +90,15 @@
     "prepare": "husky",
     "check": "biome check --write",
     "check:ci": "biome check --diagnostic-level=error",
-    "typecheck:ci": "tsc --noEmit"
+    "typecheck:ci": "tsc --noEmit",
+    "agent:test:backend": "vitest run --project unit",
+    "agent:install": "pnpm install --frozen-lockfile",
+    "agent:test:frontend": "echo 'N/A: sdk is a library, no frontend lane'",
+    "agent:test:e2e": "vitest run --project e2e",
+    "agent:typecheck": "tsc --noEmit",
+    "agent:verify:commit": "pnpm check:ci",
+    "agent:verify:pr": "pnpm check:ci && pnpm typecheck:ci && pnpm test:unit && pnpm build",
+    "agent:verify:docs": "echo 'N/A: docs verified via planctl verify'"
   },
   "dependencies": {
     "@redstone-finance/evm-connector": "^0.9.0",
@@ -115,6 +123,7 @@
     "tsdown": "^0.22.14",
     "tsx": "^4.23.2",
     "typescript": "^7.0.2",
+    "unrun": "^0.3.1",
     "viem-deal": "^2.0.4",
     "vite": "^8.2.2",
     "vitest": "^4.1.11",