@gearbox-protocol/sdk 16.0.0-next.8 → 16.0.0

package/dist/types/onchain/validation/refusal.d.ts

@@ -0,0 +1,242 @@
+import { Bps, Token, TokenAmount } from "../../model/primitives.js";
+import { MalformedPreviewError } from "../../model/previews.js";
+import "../../model/index.js";
+import { Address } from "viem";
+//#region src/onchain/validation/refusal.d.ts
+/**
+ * Why a preview could not be produced.
+ *
+ * Every member is raised by the engine as an {@link IntentPreviewError}, with
+ * the exception of `unsupportedTokenPair` and `noRecordedIntent`, which the
+ * prepare namespace reports for a request it can refuse before planning.
+ */
+type PreviewErrorReason =
+/** The debt the request implies falls outside the facade's band. */
+"debtOutOfRange" |
+/** The leverage asked for cannot be expressed as a plan at all. */
+"leverageOutOfRange" |
+/** Nothing on the account or in the wallet can fund what was asked. */
+"insufficientSourceBalance" |
+/** Input token is not accepted by the flow (e.g. deposit of a non-underlying). */
+"unsupportedCollateralToken" |
+/**
+ * No route for the trade the plan needs: no pool pair between the tokens
+ * requested, several and none was picked, or the pathfinder itself found no
+ * path for the amounts involved.
+ */
+"unsupportedTokenPair" |
+/**
+ * The intent cannot settle with a delay: the source has no redemption config,
+ * the chain has no compressor, or the payout is one the tail cannot serve.
+ */
+"noDelayedRoute" |
+/** Several redemption venues for the source, and nothing says which. */
+"multipleDelayedWithdrawals" |
+/** A redemption of the same asset is already in flight. */
+"withdrawalInProgress" |
+/**
+ * The claim names no operation to resume: requested without an intent, or
+ * read through a compressor too old to report one.
+ */
+"noRecordedIntent" |
+/** The facade or the pool behind it is paused: nothing can be done at all. */
+"marketPaused" |
+/** The facade is past its expiration date and takes no more multicalls. */
+"marketExpired" |
+/**
+ * The pool cannot lend what the plan draws right now — its free liquidity,
+ * the manager's debt limit or the per-block cap stands in the way.
+ */
+"insufficientPoolLiquidity" |
+/** The market takes no more quota for a token the plan wants to hold. */
+"quotaLimitReached" |
+/** The plan would increase the balance of a token the market forbids. */
+"forbiddenToken" |
+/**
+ * The account would end the transaction owing more than its collateral is
+ * worth under liquidation thresholds, which the facade refuses to allow.
+ */
+"insufficientCollateral" |
+/** The pool is winding down: it still pays out, but takes no more deposits. */
+"poolSunset" |
+/**
+ * The account would end up with more quoted tokens than the facade enables
+ * at once. A count, not an amount — unlike `quotaLimitReached`.
+ */
+"quotaCountExceeded" |
+/**
+ * The transaction could not be replayed: it is malformed, and every field
+ * derived from replayed balances is guesswork.
+ */
+"malformedTransaction";
+/**
+ * The numbers behind each refusal, so a caller reads the limit that was missed
+ * instead of re-deriving it.
+ *
+ * Anything with a token and an amount is a {@link TokenAmount}; ratios carry
+ * no token. `undefined` marks a reason raised from several places, only some of
+ * which hold the numbers.
+ */
+interface PreviewErrorDetails {
+  /** All three in the market's underlying. */
+  debtOutOfRange: {
+    requested: TokenAmount;
+    minDebt: TokenAmount;
+    maxDebt: TokenAmount;
+  };
+  /**
+   * Scaled by `LEVERAGE_DECIMALS` (`100n` = 1x), as the intent states it — not
+   * the read model's `Leverage`. `undefined` where the floor is not fixed: the
+   * deposit planner's is a function of the deposit.
+   */
+  leverageOutOfRange: {
+    requested: bigint;
+    min: bigint;
+  } | undefined;
+  /** `undefined` where the request never got as far as naming an amount. */
+  insufficientSourceBalance: {
+    required: TokenAmount;
+    held: TokenAmount;
+  } | undefined;
+  unsupportedCollateralToken: {
+    token: Token;
+  };
+  /**
+   * `to` is absent where the market named no output for `from`. The whole
+   * detail is absent only when the pathfinder reverted rather than answered.
+   */
+  unsupportedTokenPair: {
+    from: Token;
+    to: Token | undefined;
+  } | undefined;
+  noDelayedRoute: {
+    token: Token;
+  } | undefined;
+  multipleDelayedWithdrawals: {
+    token: Token;
+    venues: number;
+  };
+  /** The phantom token standing for the redemption already in flight. */
+  withdrawalInProgress: {
+    inFlight: TokenAmount;
+  };
+  noRecordedIntent: undefined;
+  /**
+   * Which contract is paused. A credit account operation names the manager, an
+   * LP operation the pool — the two are never both present.
+   */
+  marketPaused: {
+    creditManager: Address;
+  } | {
+    pool: Address;
+  };
+  /** `expirationDate` is unix seconds, as the facade reports it. */
+  marketExpired: {
+    creditManager: Address;
+    expirationDate: number;
+  };
+  /**
+   * Both in the market's underlying. `binding` names which of the four ceilings
+   * ran out first, so a caller can say what would fix it — waiting for lenders
+   * and asking governance are opposite answers. `solutionAmount` is the largest
+   * position still openable, absent when even the minimum debt does not fit.
+   */
+  insufficientPoolLiquidity: {
+    requested: TokenAmount;
+    available: TokenAmount;
+    binding: BorrowLimitBinding;
+    solutionAmount?: TokenAmount;
+  };
+  /**
+   * `token` is the one whose quota is asked for; the amounts are in the
+   * **underlying**, which is what a quota is measured in. `requested` is absent
+   * for a token the market opened no quota for at all — nothing was weighed
+   * against a limit.
+   */
+  quotaLimitReached: {
+    token: Token;
+    requested: TokenAmount | undefined;
+    available: TokenAmount;
+  };
+  forbiddenToken: {
+    token: Token;
+  };
+  /**
+   * `required` is the bar the factor was weighed against — the facade's own
+   * `1.0` for a check that asks whether the transaction lands, a form's higher
+   * bar for one that asks whether it is wise. `healthFactor` is the factor
+   * compared, which for a call that hands funds over is the safe-price one;
+   * `safePrices` says which, since a preview always reports main prices.
+   */
+  insufficientCollateral: {
+    healthFactor: Bps;
+    required: Bps;
+    safePrices: boolean;
+  };
+  poolSunset: {
+    pool: Address;
+  };
+  /** How many quoted tokens the account would end with, against the cap. */
+  quotaCountExceeded: {
+    count: number;
+    max: number;
+  };
+  /**
+   * The malformed-preview warning the SDK recorded, and its human-readable
+   * detail.
+   */
+  malformedTransaction: MalformedPreviewError;
+}
+/**
+ * Which ceiling ran out when a borrow could not be served.
+ *
+ * The names are the expressions, not the legacy labels, because the two do not
+ * line up: the legacy `insufficientDebtLimit` was the manager's own headroom
+ * (`managerDebtAvailable`), `insufficientPoolDebtLimit` was `poolDebtLimit`,
+ * and `insufficientPoolLiquidity` was what the manager could still draw
+ * (`poolAvailableLiquidity`).
+ *
+ * `borrowable()` weighs only three of these — the pool's free liquidity, the
+ * manager's remaining allowance and the facade's per-block cap. `poolDebtLimit`
+ * is read by the account-opening path alone, which is why it is not among them.
+ */
+type BorrowLimitBinding = "poolAvailableLiquidity" | "poolDebtLimit" | "managerDebtAvailable" | "facadePerBlockCap";
+/**
+ * The failure half every simulation shares.
+ *
+ * Distributed over the reasons rather than written as `{ reason; detail }`, so
+ * that narrowing on `reason` narrows `detail` with it.
+ */
+type PreviewIssue = { [R in PreviewErrorReason]: {
+  reason: R;
+  detail: PreviewErrorDetails[R];
+}; }[PreviewErrorReason];
+/**
+ * The failure half every simulation shares: an issue, plus the `ok: false`
+ * that tells it apart from a preview.
+ */
+type PreviewRefusal = {
+  ok: false;
+} & PreviewIssue;
+/** Builds the refusal a caller sees. */
+declare function refuse<R extends PreviewErrorReason>(reason: R, detail: PreviewErrorDetails[R]): PreviewRefusal;
+/**
+ * Validation failure that maps onto {@link PreviewErrorReason} rather than
+ * crashing the caller: raised by the planners and the guards, turned into
+ * `{ ok: false }` by `CreditAccountOperationsService`.
+ */
+declare class IntentPreviewError<R extends PreviewErrorReason = PreviewErrorReason> extends Error {
+  readonly reason: R;
+  readonly detail: PreviewErrorDetails[R];
+  constructor(reason: R, detail: PreviewErrorDetails[R], message?: string);
+}
+/**
+ * Throws the issue a check found, with the sentence the engine logs for it.
+ *
+ * Returns normally when there is nothing to raise, so it cannot narrow a type
+ * the way a bare `throw` does — a site that guards a value for the code below
+ * it keeps throwing directly.
+ */
+declare function raise(issue: PreviewIssue | null, message: string): void;
+//#endregion
+export { BorrowLimitBinding, IntentPreviewError, PreviewErrorDetails, PreviewErrorReason, PreviewIssue, PreviewRefusal, raise, refuse };

package/dist/types/onchain/validation/token.d.ts

@@ -0,0 +1,17 @@
+import { Token, TokenAmount } from "../../model/primitives.js";
+import "../../model/index.js";
+import { OnchainSDK } from "../OnchainSDK.js";
+import { Address } from "viem";
+//#region src/onchain/validation/token.d.ts
+/**
+ * The token behind an address, for the refusal details that inline one.
+ *
+ * A token the registry does not know falls back to its own shortened address
+ * as a symbol and `decimals: 0` — an unknown token has no scale, and guessing
+ * 18 would silently misformat every amount denominated in it.
+ */
+declare function toToken(sdk: OnchainSDK, address: Address): Token;
+/** {@link toToken} plus an amount denominated in it. */
+declare function toTokenAmount(sdk: OnchainSDK, address: Address, value: bigint): TokenAmount;
+//#endregion
+export { toToken, toTokenAmount };

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

@@ -1,4 +1,6 @@
+import { InvalidDelayedIntentError } from "../onchain/accounts/withdrawal-compressor/errors.js";
 import { UnsupportedZapperFunctionError } from "../onchain/market/zapper/errors.js";
+import { BorrowLimitBinding, PreviewErrorDetails, PreviewErrorReason, PreviewIssue, PreviewRefusal, raise, refuse } from "../onchain/validation/refusal.js";
 import { AdapterOperation, AdapterOperationBase, TokenTransfer, TraceAdapterExt } from "./parse/types-adapters.js";
 import { AddCollateralOp, CloseCreditAccountOperation, CompareBalancesOp, CreditAccountOperation, DecreaseDebtOp, DirectTokenTransferOperation, FacadeOperationMetadata, IncreaseDebtOp, InnerFacadeOperation, InnerOperation, LiquidateCreditAccountOperation, MulticallOperation, OpenCreditAccountOperation, OperationMetadata, OuterFacadeOperation, PartialLiquidationOperation, StoreExpectedBalancesOp, UpdateQuotaOp, WithdrawCollateralOp } from "./parse/types-facades.js";
 import { PoolDepositOperation, PoolMintOperation, PoolOperation, PoolRedeemOperation, PoolWithdrawOperation } from "./parse/types-pools.js";
@@ -27,14 +29,19 @@ 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 { ConvertFn, buildDelayedPreview } from "./preview/buildDelayedPreview.js";
+import { buildDelayedStrategyPositionOperationPreview } from "./preview/buildDelayedStrategyPositionOperationPreview.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 { previewOperation } from "./preview/previewOperation.js";
+import { UnsupportedOperationError, adapterCallOutsideBracketError, invalidTransactionValueError, malformedBracketError, nonAdapterCallInBracketError, unpreviewableAdapterCallError, unsupportedOutOfBracketCallError } from "./preview/errors.js";
+import { estimateClaimableAt } from "./preview/estimateClaimableAt.js";
+import { previewAdjustStrategyPosition } from "./preview/previewAdjustStrategyPosition.js";
+import { CloseOrRepayOperation, previewExitOrRepayStrategyPosition } from "./preview/previewExitOrRepayStrategyPosition.js";
+import { PreviewSimulationError, SimulationError, SimulationFlowFailure, SimulationFlowSource, asPreviewSimulationError } from "./simulate/errors.js";
+import { PreviewOperationError, 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";
-export { AdapterOperation, AdapterOperationBase, AddCollateralOp, AllowanceDetail, AllowancePrerequisite, AllowanceResult, BalanceDetail, BalancePrerequisite, BalanceResult, ClassifyInnerOperationsProps, CloseCreditAccountOperation, CloseOrRepayOperation, CompareBalancesOp, ConvertFn, CreditAccountOperation, CreditAccountState, CreditAccountStateProps, DecreaseDebtOp, DetectedDelayedClaim, DetectedDelayedOperation, DirectTokenTransferOperation, ExtractTransfersResult, FacadeCallType, FacadeOperationMetadata, FacadeParsedCall, IncreaseDebtOp, InnerFacadeOperation, InnerOperation, LiquidateCreditAccountOperation, MulticallOperation, OpenCreditAccountOperation, Operation, OperationMetadata, OuterFacadeOperation, PartialLiquidationOperation, PoolDepositOperation, PoolMintOperation, PoolOperation, PoolRedeemOperation, PoolWithdrawOperation, Prerequisite, PrerequisiteContext, PrerequisiteError, PrerequisiteKind, PrerequisiteOutcome, PrerequisiteResult, PreviewOperationInput, PreviewOperationOptions, 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, checkPrerequisites, classifyCloseOrRepay, classifyInnerOperations, detectDelayedClaim, detectDelayedOperation, extractAdapterCallTraces, extractTransfers, findFacadeCalls, isCloseOrRepay, isPoolOperation, isRWAOperation, makeReplayState, parseFacadeOperationCalldata, parseOperationCalldata, parsePoolOperationCalldata, parseRWAFactoryOperationCalldata, previewAdjustCreditAccount, previewCloseOrRepayCreditAccount, previewOperation, replayInnerOperations, replayMulticall, resolveDelayedClaimIntent };
+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, type BorrowLimitBinding, CheckOperationOptions, ClassifyInnerOperationsProps, CloseCreditAccountOperation, CloseOrRepayOperation, CompareBalancesOp, CreditAccountOperation, CreditAccountState, CreditAccountStateProps, DecreaseDebtOp, DetectedDelayedClaim, DetectedDelayedOperation, DirectTokenTransferOperation, ExtractTransfersResult, FacadeCallType, FacadeOperationMetadata, FacadeParsedCall, IncreaseDebtOp, InnerFacadeOperation, InnerOperation, type InvalidDelayedIntentError, LiquidateCreditAccountOperation, MulticallOperation, OpenCreditAccountOperation, Operation, OperationMetadata, OuterFacadeOperation, PartialLiquidationOperation, PoolDepositOperation, PoolMintOperation, PoolOperation, PoolRedeemOperation, PoolWithdrawOperation, Prerequisite, PrerequisiteContext, PrerequisiteError, PrerequisiteKind, PrerequisiteOutcome, PrerequisiteResult, type PreviewErrorDetails, type PreviewErrorReason, type PreviewIssue, PreviewOperationError, PreviewOperationInput, PreviewOperationOptions, type PreviewRefusal, type PreviewSimulationError, RWAMulticallOperation, RWAOpenCreditAccountOperation, RWAOpenRequirementsDetail, RWAOpenRequirementsPrerequisite, RWAOpenRequirementsResult, RWAOperation, RWAOperationMetadata, ReplayMulticallResult, ReplayState, ReplayableOperation, type SimulationError, type SimulationFlowFailure, type SimulationFlowSource, StoreExpectedBalancesOp, TokenTransfer, TraceAdapterExt, TransferAlignmentError, UnexpectedFacadeEventOrderError, UnknownAdapterError, UnknownFacadeCallError, UnsupportedOperationError, UnsupportedPoolFunctionError, UnsupportedTargetError, type UnsupportedZapperFunctionError, UpdateQuotaOp, WeighedFactors, WithdrawCollateralAlignmentError, WithdrawCollateralEventInfo, WithdrawCollateralOp, adapterCallOutsideBracketError, asPreviewSimulationError, buildDelayedStrategyPositionOperationPreview, checkOperation, checkPrerequisites, checkSimulation, classifyCloseOrRepay, classifyInnerOperations, collateralIssue, detectDelayedClaim, detectDelayedOperation, estimateClaimableAt, extractAdapterCallTraces, extractTransfers, findFacadeCalls, invalidTransactionValueError, isCloseOrRepay, isPoolOperation, isRWAOperation, makeReplayState, malformedBracketError, marketIssues, nonAdapterCallInBracketError, parseFacadeOperationCalldata, parseOperationCalldata, parsePoolOperationCalldata, parseRWAFactoryOperationCalldata, previewAdjustStrategyPosition, previewExitOrRepayStrategyPosition, previewOperation, quotaCountIssue, raise, refuse, replayInnerOperations, replayMulticall, resolveDelayedClaimIntent, unpreviewableAdapterCallError, unsupportedOutOfBracketCallError };

package/dist/types/preview/parse/errors.d.ts

@@ -1,22 +1,29 @@
+import { IGearboxError } from "../../model/errors.js";
+import "../../model/index.js";
 import { UnsupportedZapperFunctionError } from "../../onchain/market/zapper/errors.js";
-import "../../onchain/index.js";
 import { Address } from "viem";
 //#region src/preview/parse/errors.d.ts
 /**
- * Thrown when the target of a transaction is neither a known Gearbox pool nor a
- * credit facade.
+ * Refusal answered when the target of a transaction is neither a known
+ * Gearbox pool nor a credit facade. A plain returned object per the SDK's
+ * refusal vocabulary — not a thrown `Error`.
  */
-declare class UnsupportedTargetError extends Error {
-  readonly target: Address;
-  constructor(target: Address);
+interface UnsupportedTargetError extends IGearboxError {
+  code: "unsupportedTarget";
+  /** Target address no known Gearbox contract answers for. */
+  target: Address;
 }
 /**
- * Thrown when a pool call uses a function other than ERC4626 `deposit`/`redeem`.
+ * Refusal answered when a pool call uses a function other than ERC4626
+ * `deposit`/`redeem`. A plain returned object per the SDK's refusal
+ * vocabulary — not a thrown `Error`.
  */
-declare class UnsupportedPoolFunctionError extends Error {
-  readonly pool: Address;
-  readonly functionName: string;
-  constructor(pool: Address, functionName: string);
+interface UnsupportedPoolFunctionError extends IGearboxError {
+  code: "unsupportedPoolFunction";
+  /** Pool the call targets. */
+  pool: Address;
+  /** Decoded function name the SDK cannot preview. */
+  functionName: string;
 }
 //#endregion
-export { UnsupportedPoolFunctionError, UnsupportedTargetError, UnsupportedZapperFunctionError };
+export { UnsupportedPoolFunctionError, UnsupportedTargetError, type UnsupportedZapperFunctionError };

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

@@ -10,4 +10,4 @@ import { parseFacadeOperationCalldata } from "./parseFacadeOperationCalldata.js"
 import { parseOperationCalldata } from "./parseOperationCalldata.js";
 import { parsePoolOperationCalldata } from "./parsePoolOperationCalldata.js";
 import { parseRWAFactoryOperationCalldata } from "./parseRWAFactoryOperationCalldata.js";
-export { AdapterOperation, AdapterOperationBase, AddCollateralOp, ClassifyInnerOperationsProps, CloseCreditAccountOperation, CompareBalancesOp, CreditAccountOperation, DecreaseDebtOp, DirectTokenTransferOperation, FacadeOperationMetadata, IncreaseDebtOp, InnerFacadeOperation, InnerOperation, LiquidateCreditAccountOperation, MulticallOperation, OpenCreditAccountOperation, Operation, OperationMetadata, OuterFacadeOperation, PartialLiquidationOperation, PoolDepositOperation, PoolMintOperation, PoolOperation, PoolRedeemOperation, PoolWithdrawOperation, RWAMulticallOperation, RWAOpenCreditAccountOperation, RWAOperation, RWAOperationMetadata, StoreExpectedBalancesOp, TokenTransfer, TraceAdapterExt, UnsupportedPoolFunctionError, UnsupportedTargetError, UnsupportedZapperFunctionError, UpdateQuotaOp, WithdrawCollateralOp, classifyInnerOperations, isPoolOperation, isRWAOperation, parseFacadeOperationCalldata, parseOperationCalldata, parsePoolOperationCalldata, parseRWAFactoryOperationCalldata };
+export { AdapterOperation, AdapterOperationBase, AddCollateralOp, ClassifyInnerOperationsProps, CloseCreditAccountOperation, CompareBalancesOp, CreditAccountOperation, DecreaseDebtOp, DirectTokenTransferOperation, FacadeOperationMetadata, IncreaseDebtOp, InnerFacadeOperation, InnerOperation, LiquidateCreditAccountOperation, MulticallOperation, OpenCreditAccountOperation, Operation, OperationMetadata, OuterFacadeOperation, PartialLiquidationOperation, PoolDepositOperation, PoolMintOperation, PoolOperation, PoolRedeemOperation, PoolWithdrawOperation, RWAMulticallOperation, RWAOpenCreditAccountOperation, RWAOperation, RWAOperationMetadata, StoreExpectedBalancesOp, TokenTransfer, TraceAdapterExt, UnsupportedPoolFunctionError, UnsupportedTargetError, type UnsupportedZapperFunctionError, UpdateQuotaOp, WithdrawCollateralOp, classifyInnerOperations, isPoolOperation, isRWAOperation, parseFacadeOperationCalldata, parseOperationCalldata, parsePoolOperationCalldata, parseRWAFactoryOperationCalldata };

package/dist/types/preview/parse/parseOperationCalldata.d.ts

@@ -1,6 +1,10 @@
+import { SDKReturn } from "../../model/result.js";
+import "../../model/index.js";
+import { UnsupportedZapperFunctionError } from "../../onchain/market/zapper/errors.js";
 import { PluginsMap } from "../../onchain/plugins/types.js";
 import "../../onchain/index.js";
 import { Operation } from "./types.js";
+import { UnsupportedPoolFunctionError, UnsupportedTargetError } from "./errors.js";
 import { PreviewOperationInput } from "../types.js";
 //#region src/preview/parse/parseOperationCalldata.d.ts
 /**
@@ -9,6 +13,6 @@ import { PreviewOperationInput } from "../types.js";
  * Support parsing of pool operations (including via zappers),
  * credit facade operations and RWA factory operations.
  */
-declare function parseOperationCalldata<P extends PluginsMap>(input: PreviewOperationInput<P>): Operation;
+declare function parseOperationCalldata<P extends PluginsMap>(input: PreviewOperationInput<P>): SDKReturn<Operation, UnsupportedTargetError | UnsupportedPoolFunctionError | UnsupportedZapperFunctionError>;
 //#endregion
 export { parseOperationCalldata };

package/dist/types/preview/parse/parsePoolOperationCalldata.d.ts

@@ -1,8 +1,11 @@
+import { SDKReturn } from "../../model/result.js";
+import "../../model/index.js";
 import { PoolV310Contract } from "../../onchain/market/pool/PoolV310Contract.js";
 import { OnchainSDK } from "../../onchain/OnchainSDK.js";
 import "../../onchain/index.js";
 import { PoolOperation } from "./types-pools.js";
 import "./types.js";
+import { UnsupportedPoolFunctionError } from "./errors.js";
 import { Hex } from "viem";
 //#region src/preview/parse/parsePoolOperationCalldata.d.ts
 /**
@@ -11,8 +14,8 @@ import { Hex } from "viem";
  * @param sdk - The SDK instance.
  * @param pool - The pool contract.
  * @param calldata - The calldata to parse.
- * @returns The parsed operation.
+ * @returns The parsed operation behind `ok`, or the refusal.
  */
-declare function parsePoolOperationCalldata(sdk: OnchainSDK, pool: PoolV310Contract, calldata: Hex): PoolOperation;
+declare function parsePoolOperationCalldata(sdk: OnchainSDK, pool: PoolV310Contract, calldata: Hex): SDKReturn<PoolOperation, UnsupportedPoolFunctionError>;
 //#endregion
 export { parsePoolOperationCalldata };

package/dist/types/preview/prerequisites/checkPrerequisites.d.ts

@@ -1,6 +1,11 @@
+import { SDKReturn } from "../../model/result.js";
+import "../../model/index.js";
+import { UnsupportedZapperFunctionError } from "../../onchain/market/zapper/errors.js";
 import { PluginsMap } from "../../onchain/plugins/types.js";
 import "../../onchain/index.js";
+import { UnsupportedPoolFunctionError, UnsupportedTargetError } from "../parse/errors.js";
 import { PreviewOperationInput, PreviewOperationOptions } from "../types.js";
+import "../parse/index.js";
 import { PrerequisiteResult } from "./types.js";
 //#region src/preview/prerequisites/checkPrerequisites.d.ts
 /**
@@ -18,6 +23,6 @@ import { PrerequisiteResult } from "./types.js";
  * (e.g. pool is paused) is intentionally out of scope, since the user cannot
  * resolve it.
  */
-declare function checkPrerequisites<P extends PluginsMap>(input: PreviewOperationInput<P>, options?: PreviewOperationOptions): Promise<PrerequisiteResult[]>;
+declare function checkPrerequisites<P extends PluginsMap>(input: PreviewOperationInput<P>, options?: PreviewOperationOptions): Promise<SDKReturn<PrerequisiteResult[], UnsupportedTargetError | UnsupportedPoolFunctionError | UnsupportedZapperFunctionError>>;
 //#endregion
 export { checkPrerequisites };

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

@@ -1,26 +1,22 @@
-import { InstantOperationPreview } from "../../model/previews.js";
+import { InstantStrategyPositionOperationPreview } from "../../model/previews.js";
 import "../../model/index.js";
 import { OnchainSDK } from "../../onchain/OnchainSDK.js";
 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
-/**
- * Oracle conversion, injected so unit tests don't need a market
- */
-type ConvertFn = (token: Address, to: Address, amount: bigint) => bigint;
+//#region src/preview/preview/buildDelayedStrategyPositionOperationPreview.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:
  * the claim itself followed by the intent-specific tail
  *
  * Pure function: the input states are never mutated and no network access is performed.
- * Swaps are estimated with the injected conversion; tokens it cannot price contribute
- * nothing and set a non-fatal `ERROR_UNPRICEABLE_TOKEN` error on the
- * preview.
+ * Swaps and remaining holdings are priced by the market oracle. Tokens that
+ * cannot be priced contribute nothing and set a non-fatal `unpriceableToken`
+ * warning on the preview.
  *
- * The changes (e.g. `debtChange`) are reported relative to the account
+ * The changes (e.g. `totalDebtChange`) are reported relative to the account
  * state before the whole transaction.
  *
  * @param afterInstant - Account state after the instant part of the
@@ -32,6 +28,6 @@ type ConvertFn = (token: Address, to: Address, amount: bigint) => bigint;
  * @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 buildDelayedStrategyPositionOperationPreview(afterInstant: CreditAccountState, before: CreditAccountState, detected: DetectedDelayedOperation, receivedToken: Address, sdk: OnchainSDK): InstantStrategyPositionOperationPreview;
 //#endregion
-export { ConvertFn, buildDelayedPreview };
+export { buildDelayedStrategyPositionOperationPreview };

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

@@ -1,5 +1,7 @@
 import { DelayedIntent } from "../../model/delayed-intents.js";
+import { SDKReturn } from "../../model/result.js";
 import "../../model/index.js";
+import { InvalidDelayedIntentError } from "../../onchain/accounts/withdrawal-compressor/errors.js";
 import { PluginsMap } from "../../onchain/plugins/types.js";
 import { OnchainSDK } from "../../onchain/OnchainSDK.js";
 import "../../onchain/index.js";
@@ -41,12 +43,11 @@ declare function detectDelayedClaim<P extends PluginsMap>(sdk: OnchainSDK<P>, mu
  * @param sdk - Attached SDK.
  * @param multicall - Parsed inner operations of the multicall.
  * @param blockNumber - Optional block number to read the log at.
- * @returns The decoded intent, or `undefined` when the multicall claims
- * nothing, the redemption logger is not deployed, or the log carries no
- * intent.
- * @throws InvalidDelayedIntentError when the logged `extraData` is non-empty
- * but cannot be decoded as a `DelayedIntent`.
+ * @returns The decoded intent behind `ok` (`undefined` when the multicall
+ * claims nothing, the redemption logger is not deployed, or the log carries
+ * no intent), or the `invalidDelayedIntent` refusal when the logged
+ * `extraData` is non-empty but cannot be decoded as a `DelayedIntent`.
  */
-declare function resolveDelayedClaimIntent<P extends PluginsMap>(sdk: OnchainSDK<P>, multicall: InnerOperation[], blockNumber?: bigint): Promise<DelayedIntent | undefined>;
+declare function resolveDelayedClaimIntent<P extends PluginsMap>(sdk: OnchainSDK<P>, multicall: InnerOperation[], blockNumber?: bigint): Promise<SDKReturn<DelayedIntent | undefined, InvalidDelayedIntentError>>;
 //#endregion
 export { DetectedDelayedClaim, detectDelayedClaim, resolveDelayedClaimIntent };

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

@@ -1,5 +1,7 @@
 import { DelayedIntent } from "../../model/delayed-intents.js";
+import { SDKReturn } from "../../model/result.js";
 import "../../model/index.js";
+import { InvalidDelayedIntentError } from "../../onchain/accounts/withdrawal-compressor/errors.js";
 import { DelayedWithdrawalRequest } from "../../onchain/market/adapters/types.js";
 import { PluginsMap } from "../../onchain/plugins/types.js";
 import { OnchainSDK } from "../../onchain/OnchainSDK.js";
@@ -32,6 +34,6 @@ interface DetectedDelayedOperation {
  * @throws InvalidDelayedIntentError when a request carries non-empty
  * `extraData` that cannot be decoded as a `DelayedIntent`.
  */
-declare function detectDelayedOperation<P extends PluginsMap>(sdk: OnchainSDK<P>, multicall: InnerOperation[]): DetectedDelayedOperation | undefined;
+declare function detectDelayedOperation<P extends PluginsMap>(sdk: OnchainSDK<P>, multicall: InnerOperation[]): SDKReturn<DetectedDelayedOperation | undefined, InvalidDelayedIntentError>;
 //#endregion
 export { DetectedDelayedOperation, detectDelayedOperation };

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

@@ -1,12 +1,44 @@
+import { IGearboxError } from "../../model/errors.js";
+import { AdapterCallOutsideBracketError, InvalidTransactionValueError, MalformedBracketError, MalformedBracketKind, NonAdapterCallInBracketError, UnpreviewableAdapterCallError, UnsupportedOutOfBracketCallError } from "../../model/previews.js";
+import "../../model/index.js";
+import { Address } from "viem";
 //#region src/preview/preview/errors.d.ts
 /**
- * Thrown by `previewOperation` for parsed operations it cannot preview yet.
- * Currently only pool operations and credit account opening are supported.
+ * Refusal answered by `previewOperation` for parsed operations it cannot
+ * preview yet. A plain returned object per the SDK's refusal vocabulary —
+ * not a thrown `Error`.
  */
-declare class UnsupportedOperationError extends Error {
+interface UnsupportedOperationError extends IGearboxError {
+  code: "unsupportedOperation";
   /** The parsed operation kind (the `operation` discriminant). */
-  readonly operation: string;
-  constructor(operation: string);
+  operation: string;
 }
+/**
+ * Builds a {@link MalformedBracketError} for the given bracket invariant.
+ **/
+declare function malformedBracketError(kind: MalformedBracketKind): MalformedBracketError;
+/**
+ * Builds an {@link AdapterCallOutsideBracketError} for `adapter`.
+ **/
+declare function adapterCallOutsideBracketError(adapter: Address): AdapterCallOutsideBracketError;
+/**
+ * Builds a {@link NonAdapterCallInBracketError} for `target`.
+ **/
+declare function nonAdapterCallInBracketError(target: Address): NonAdapterCallInBracketError;
+/**
+ * Builds an {@link UnpreviewableAdapterCallError} for a bracketed adapter
+ * call that could not be replayed.
+ **/
+declare function unpreviewableAdapterCallError(adapter: Address, cause: unknown): UnpreviewableAdapterCallError;
+/**
+ * Builds an {@link UnsupportedOutOfBracketCallError} for an allowed
+ * out-of-bracket adapter call that could not be replayed.
+ **/
+declare function unsupportedOutOfBracketCallError(adapter: Address, cause: unknown): UnsupportedOutOfBracketCallError;
+/**
+ * Builds an {@link InvalidTransactionValueError} when `msg.value` does not
+ * fit into the declared WETH collateral.
+ **/
+declare function invalidTransactionValueError(value: bigint, wethCollateral: bigint): InvalidTransactionValueError;
 //#endregion
-export { UnsupportedOperationError };
+export { UnsupportedOperationError, adapterCallOutsideBracketError, invalidTransactionValueError, malformedBracketError, nonAdapterCallInBracketError, unpreviewableAdapterCallError, unsupportedOutOfBracketCallError };

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

@@ -0,0 +1,19 @@
+import { Timestamp } from "../../model/primitives.js";
+import "../../model/index.js";
+import { PluginsMap } from "../../onchain/plugins/types.js";
+import { OnchainSDK } from "../../onchain/OnchainSDK.js";
+import "../../onchain/index.js";
+import { Address } from "viem";
+//#region src/preview/preview/estimateClaimableAt.d.ts
+/**
+ * Estimates when a newly requested delayed withdrawal becomes claimable:
+ * `now + withdrawalLength` of the cached withdrawable asset whose phantom
+ * token matches `phantomToken`. Same formula as
+ * `getWithdrawalRequestResult().claimableAt`.
+ *
+ * Returns `undefined` when the withdrawal compressor is missing, its assets
+ * cache is not loaded, or no asset matches the phantom token.
+ */
+declare function estimateClaimableAt<P extends PluginsMap>(sdk: OnchainSDK<P>, phantomToken: Address): Timestamp | undefined;
+//#endregion
+export { estimateClaimableAt };

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

@@ -1,12 +1,13 @@
 import { CreditAccountState, CreditAccountStateProps } from "./CreditAccountState.js";
 import { DetectedDelayedOperation, detectDelayedOperation } from "./detectDelayedOperation.js";
-import { ConvertFn, buildDelayedPreview } from "./buildDelayedPreview.js";
+import { buildDelayedStrategyPositionOperationPreview } from "./buildDelayedStrategyPositionOperationPreview.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 { previewOperation } from "./previewOperation.js";
+import { UnsupportedOperationError, adapterCallOutsideBracketError, invalidTransactionValueError, malformedBracketError, nonAdapterCallInBracketError, unpreviewableAdapterCallError, unsupportedOutOfBracketCallError } from "./errors.js";
+import { estimateClaimableAt } from "./estimateClaimableAt.js";
+import { previewAdjustStrategyPosition } from "./previewAdjustStrategyPosition.js";
+import { CloseOrRepayOperation, previewExitOrRepayStrategyPosition } from "./previewExitOrRepayStrategyPosition.js";
+import { PreviewOperationError, previewOperation } from "./previewOperation.js";
 import { ReplayState, makeReplayState, replayInnerOperations } from "./replayInnerOperations.js";
 import { ReplayMulticallResult, ReplayableOperation, replayMulticall } from "./replayMulticall.js";
-export { CloseOrRepayOperation, ConvertFn, 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, PreviewOperationError, ReplayMulticallResult, ReplayState, ReplayableOperation, UnsupportedOperationError, adapterCallOutsideBracketError, buildDelayedStrategyPositionOperationPreview, classifyCloseOrRepay, detectDelayedClaim, detectDelayedOperation, estimateClaimableAt, invalidTransactionValueError, isCloseOrRepay, makeReplayState, malformedBracketError, nonAdapterCallInBracketError, previewAdjustStrategyPosition, previewExitOrRepayStrategyPosition, previewOperation, replayInnerOperations, replayMulticall, resolveDelayedClaimIntent, unpreviewableAdapterCallError, unsupportedOutOfBracketCallError };

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

@@ -1,4 +1,4 @@
-import { AdjustCreditAccountPreview } from "../../model/previews.js";
+import { AdjustStrategyPositionPreview } 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/previewAdjustStrategyPosition.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 previewAdjustStrategyPosition<P extends PluginsMap>(input: PreviewOperationInput<P>, operation: MulticallOperation | RWAMulticallOperation, options: PreviewOperationOptions<true>): AdjustStrategyPositionPreview;
 //#endregion
-export { previewAdjustCreditAccount };
+export { previewAdjustStrategyPosition };