@gearbox-protocol/sdk 16.2.0 → 16.3.0-next.2

package/dist/types/history/classifyMulticallOperations.d.ts

@@ -1,12 +1,11 @@
 import { AddressMap } from "../onchain/utils/AddressMap.js";
 import { ParsedCallV2 } from "../onchain/base/types.js";
 import { CallTrace } from "../onchain/utils/trace.js";
+import { TokenTransfer } from "../onchain/market/adapters/transfers.js";
 import { ChainContractsRegister } from "../onchain/base/ChainContractsRegister.js";
 import "../onchain/index.js";
-import { TokenTransfer } from "../preview/parse/types-adapters.js";
-import "../preview/parse/index.js";
-import { WithdrawCollateralEventInfo } from "../preview/trace/extractTransfers.js";
-import "../preview/trace/index.js";
+import { WithdrawCollateralEventInfo } from "./trace/extractTransfers.js";
+import "./trace/index.js";
 import { InnerOperation } from "./types.js";
 import { Address } from "viem";
 //#region src/history/classifyMulticallOperations.d.ts

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

@@ -1,7 +1,13 @@
-import { AddCollateralOp, DecreaseDebtOp, FacadeOperationMetadata, IncreaseDebtOp, InnerFacadeOperation, OperationMetadata, UpdateQuotaOp, WithdrawCollateralOp } from "../preview/parse/types-facades.js";
+import { AddCollateralOp, DecreaseDebtOp, FacadeOperationMetadata, IncreaseDebtOp, InnerFacadeOperation, OperationMetadata, UpdateQuotaOp, WithdrawCollateralOp } from "../onchain/preview/parse/types-facades.js";
+import { TransferAlignmentError, UnexpectedFacadeEventOrderError, UnknownAdapterError, UnknownFacadeCallError, WithdrawCollateralAlignmentError } from "./trace/errors.js";
+import { extractAdapterCallTraces } from "./trace/extractAdapterCallTraces.js";
+import { ExtractTransfersResult, WithdrawCollateralEventInfo, extractTransfers } from "./trace/extractTransfers.js";
+import { FacadeCallType, FacadeParsedCall } from "./trace/types.js";
+import { findFacadeCalls } from "./trace/findFacadeCalls.js";
+import "./trace/index.js";
 import { AdapterOperation, CloseCreditAccountOperation, CreditAccountOperation, DirectTokenTransferOperation, HistoryAdapterExt, HistoryFacadeMetadata, InnerOperation, LiquidateCreditAccountOperation, MulticallOperation, OpenCreditAccountOperation, OuterFacadeOperation, PartialLiquidationOperation } from "./types.js";
 import { OperationVisitor, mapOperations } from "./mapOperations.js";
 import { parseCreditAccountTransaction } from "./parseCreditAccountTransaction.js";
 import { DeploymentLike, PopulateContractsRegisterOptions, populateContractsRegister } from "./populateContractsRegister.js";
 import { LegacyApiOperation, LegacyMulticallOp, LegacyVisitorParams, createLegacyVisitor, toLegacyOperations } from "./toLegacyOperation.js";
-export { AdapterOperation, type AddCollateralOp, CloseCreditAccountOperation, CreditAccountOperation, type DecreaseDebtOp, DeploymentLike, DirectTokenTransferOperation, type FacadeOperationMetadata, HistoryAdapterExt, HistoryFacadeMetadata, type IncreaseDebtOp, type InnerFacadeOperation, InnerOperation, LegacyApiOperation, LegacyMulticallOp, LegacyVisitorParams, LiquidateCreditAccountOperation, MulticallOperation, OpenCreditAccountOperation, type OperationMetadata, OperationVisitor, OuterFacadeOperation, PartialLiquidationOperation, PopulateContractsRegisterOptions, type UpdateQuotaOp, type WithdrawCollateralOp, createLegacyVisitor, mapOperations, parseCreditAccountTransaction, populateContractsRegister, toLegacyOperations };
+export { AdapterOperation, type AddCollateralOp, CloseCreditAccountOperation, CreditAccountOperation, type DecreaseDebtOp, DeploymentLike, DirectTokenTransferOperation, ExtractTransfersResult, FacadeCallType, type FacadeOperationMetadata, FacadeParsedCall, HistoryAdapterExt, HistoryFacadeMetadata, type IncreaseDebtOp, type InnerFacadeOperation, InnerOperation, LegacyApiOperation, LegacyMulticallOp, LegacyVisitorParams, LiquidateCreditAccountOperation, MulticallOperation, OpenCreditAccountOperation, type OperationMetadata, OperationVisitor, OuterFacadeOperation, PartialLiquidationOperation, PopulateContractsRegisterOptions, TransferAlignmentError, UnexpectedFacadeEventOrderError, UnknownAdapterError, UnknownFacadeCallError, type UpdateQuotaOp, WithdrawCollateralAlignmentError, WithdrawCollateralEventInfo, type WithdrawCollateralOp, createLegacyVisitor, extractAdapterCallTraces, extractTransfers, findFacadeCalls, mapOperations, parseCreditAccountTransaction, populateContractsRegister, toLegacyOperations };

package/dist/types/history/mapOperations.d.ts

@@ -1,4 +1,4 @@
-import { AddCollateralOp, DecreaseDebtOp, IncreaseDebtOp, UpdateQuotaOp, WithdrawCollateralOp } from "../preview/parse/types-facades.js";
+import { AddCollateralOp, DecreaseDebtOp, IncreaseDebtOp, UpdateQuotaOp, WithdrawCollateralOp } from "../onchain/preview/parse/types-facades.js";
 import { AdapterOperation, CloseCreditAccountOperation, CreditAccountOperation, DirectTokenTransferOperation, HistoryFacadeMetadata, LiquidateCreditAccountOperation, MulticallOperation, OpenCreditAccountOperation, PartialLiquidationOperation } from "./types.js";
 //#region src/history/mapOperations.d.ts
 /**

package/dist/types/{preview → history}/trace/errors.d.ts

@@ -1,5 +1,5 @@
 import { Address, Hex } from "viem";
-//#region src/preview/trace/errors.d.ts
+//#region src/history/trace/errors.d.ts
 declare class UnknownAdapterError extends Error {
   readonly address: Address;
   constructor(address: Address);

package/dist/types/{preview → history}/trace/extractAdapterCallTraces.d.ts

@@ -1,5 +1,5 @@
 import { CallTrace } from "../../onchain/utils/trace.js";
-//#region src/preview/trace/extractAdapterCallTraces.d.ts
+//#region src/history/trace/extractAdapterCallTraces.d.ts
 /**
  * Extracts the user multicall's adapter-level call traces from a single facade
  * call trace.

package/dist/types/{preview → history}/trace/extractTransfers.d.ts

@@ -1,9 +1,8 @@
 import { AddressMap } from "../../onchain/utils/AddressMap.js";
+import { TokenTransfer } from "../../onchain/market/adapters/transfers.js";
 import "../../onchain/index.js";
-import { TokenTransfer } from "../parse/types-adapters.js";
-import "../parse/index.js";
 import { Address, Log } from "viem";
-//#region src/preview/trace/extractTransfers.d.ts
+//#region src/history/trace/extractTransfers.d.ts
 type RawLog = Log<bigint | number, number, false>;
 /**
  * Effective `withdrawCollateral` outcome decoded from the facade's

package/dist/types/{preview → history}/trace/findFacadeCalls.d.ts

@@ -3,7 +3,7 @@ import { ChainContractsRegister } from "../../onchain/base/ChainContractsRegiste
 import "../../onchain/index.js";
 import { FacadeParsedCall } from "./types.js";
 import { Address } from "viem";
-//#region src/preview/trace/findFacadeCalls.d.ts
+//#region src/history/trace/findFacadeCalls.d.ts
 /**
  * Walks a `debug_traceTransaction` callTracer tree, finds all non-reverted
  * calls to the credit facade, parses them via the register, and returns

package/dist/types/{preview → history}/trace/types.d.ts

@@ -2,7 +2,7 @@ import { ParsedCallV2 } from "../../onchain/base/types.js";
 import { CallTrace } from "../../onchain/utils/trace.js";
 import "../../onchain/index.js";
 import { Address } from "viem";
-//#region src/preview/trace/types.d.ts
+//#region src/history/trace/types.d.ts
 /**
  * The set of credit facade entry-point functions that produce history operations.
  */

package/dist/types/history/types.d.ts

@@ -1,8 +1,7 @@
 import { LegacyAdapterOperation } from "../onchain/market/adapters/legacyAdapterOperations.js";
+import { AdapterOperation as AdapterOperation$1, TraceAdapterExt } from "../onchain/preview/parse/types-adapters.js";
+import { AddCollateralOp, CloseCreditAccountOperation as CloseCreditAccountOperation$1, DecreaseDebtOp, DirectTokenTransferOperation as DirectTokenTransferOperation$1, FacadeOperationMetadata, IncreaseDebtOp, InnerFacadeOperation, InnerOperation as InnerOperation$1, LiquidateCreditAccountOperation as LiquidateCreditAccountOperation$1, MulticallOperation as MulticallOperation$1, OpenCreditAccountOperation as OpenCreditAccountOperation$1, OperationMetadata, PartialLiquidationOperation as PartialLiquidationOperation$1, UpdateQuotaOp, WithdrawCollateralOp } from "../onchain/preview/parse/types-facades.js";
 import "../onchain/index.js";
-import { AdapterOperation as AdapterOperation$1, TraceAdapterExt } from "../preview/parse/types-adapters.js";
-import { AddCollateralOp, CloseCreditAccountOperation as CloseCreditAccountOperation$1, DecreaseDebtOp, DirectTokenTransferOperation as DirectTokenTransferOperation$1, FacadeOperationMetadata, IncreaseDebtOp, InnerFacadeOperation, InnerOperation as InnerOperation$1, LiquidateCreditAccountOperation as LiquidateCreditAccountOperation$1, MulticallOperation as MulticallOperation$1, OpenCreditAccountOperation as OpenCreditAccountOperation$1, OperationMetadata, PartialLiquidationOperation as PartialLiquidationOperation$1, UpdateQuotaOp, WithdrawCollateralOp } from "../preview/parse/types-facades.js";
-import "../preview/parse/index.js";
 //#region src/history/types.d.ts
 /**
  * History-specific adapter-operation extension: trace-derived data

package/dist/types/model/errors/base.d.ts

@@ -0,0 +1,28 @@
+//#region src/model/errors/base.d.ts
+/**
+ * What every error the SDK reports has.
+ *
+ * `code` is the discriminant: switch on it and the error narrows to the shape
+ * carrying that failure's own numbers.
+ **/
+interface IGearboxError {
+  /**
+   * Machine-readable identity of the failure, and the discriminant of the
+   * union a method returns.
+   **/
+  code: string;
+  /**
+   * One sentence naming what was refused, in English, safe to log. Not a
+   * message to show a user as-is: a screen renders the code and the numbers
+   * beside it in its own words and its own language.
+   **/
+  message: string;
+  /**
+   * The failure this one was raised for, where one error stands in front of
+   * another. Absent for a refusal that is its own reason, which is most of
+   * them.
+   **/
+  cause?: IGearboxError | Error;
+}
+//#endregion
+export { IGearboxError };

package/dist/types/model/errors/index.d.ts

@@ -0,0 +1,7 @@
+import { IGearboxError } from "./base.js";
+import { CreditAccountFrozenError, LiquidatorNotEligibleError, NotEmergencyLiquidatorError, creditAccountFrozen, liquidatorNotEligible, notEmergencyLiquidator } from "./liquidation-errors.js";
+import { BorrowLimitCause, CreditManagerPausedError, DebtOutOfRangeError, ForbiddenTokenError, InsufficientAllowanceError, InsufficientBalanceError, InsufficientCollateralError, InsufficientPoolLiquidityError, LeverageOutOfRangeError, MarketExpiredError, PoolPausedError, PoolSunsetError, QuotaCountExceededError, QuotaLimitReachedError, RWAOpenRequirementsError, creditManagerPaused, debtOutOfRange, forbiddenToken, insufficientAllowance, insufficientBalance, insufficientCollateral, insufficientPoolLiquidity, leverageOutOfRange, marketExpired, poolPaused, poolSunset, quotaCountExceeded, quotaLimitReached, rwaOpenRequirementsNotMet } from "./operation-errors.js";
+import { UnpriceableTokenError, unpriceableTokenError } from "./oracle-errors.js";
+import { CreditAccountNotEmptyError, CreditAccountNotFoundError, EmptyOpenTakesNothingError, MultipleDelayedWithdrawalsError, NoDelayedRouteError, NoRecordedIntentError, NoStrategyTargetCollateralError, UnexpectedFailureError, UnsupportedCollateralTokenError, UnsupportedTokenPairError, WithdrawalInProgressError, creditAccountNotEmpty, creditAccountNotFound, emptyOpenTakesNothing, multipleDelayedWithdrawals, noDelayedRoute, noRecordedIntent, noStrategyTargetCollateral, unexpectedFailure, unsupportedCollateralToken, unsupportedTokenPair, withdrawalInProgress } from "./prepare-errors.js";
+import { InvalidDelayedIntentError, MalformedTransactionError, PoolOperationPreviewError, UnsupportedOperationError, UnsupportedPoolFunctionError, UnsupportedTargetError, UnsupportedZapperFunctionError, malformedTransaction } from "./preview-errors.js";
+export { BorrowLimitCause, CreditAccountFrozenError, CreditAccountNotEmptyError, CreditAccountNotFoundError, CreditManagerPausedError, DebtOutOfRangeError, EmptyOpenTakesNothingError, ForbiddenTokenError, IGearboxError, InsufficientAllowanceError, InsufficientBalanceError, InsufficientCollateralError, InsufficientPoolLiquidityError, InvalidDelayedIntentError, LeverageOutOfRangeError, LiquidatorNotEligibleError, MalformedTransactionError, MarketExpiredError, MultipleDelayedWithdrawalsError, NoDelayedRouteError, NoRecordedIntentError, NoStrategyTargetCollateralError, NotEmergencyLiquidatorError, PoolOperationPreviewError, PoolPausedError, PoolSunsetError, QuotaCountExceededError, QuotaLimitReachedError, RWAOpenRequirementsError, UnexpectedFailureError, UnpriceableTokenError, UnsupportedCollateralTokenError, UnsupportedOperationError, UnsupportedPoolFunctionError, UnsupportedTargetError, UnsupportedTokenPairError, UnsupportedZapperFunctionError, WithdrawalInProgressError, creditAccountFrozen, creditAccountNotEmpty, creditAccountNotFound, creditManagerPaused, debtOutOfRange, emptyOpenTakesNothing, forbiddenToken, insufficientAllowance, insufficientBalance, insufficientCollateral, insufficientPoolLiquidity, leverageOutOfRange, liquidatorNotEligible, malformedTransaction, marketExpired, multipleDelayedWithdrawals, noDelayedRoute, noRecordedIntent, noStrategyTargetCollateral, notEmergencyLiquidator, poolPaused, poolSunset, quotaCountExceeded, quotaLimitReached, rwaOpenRequirementsNotMet, unexpectedFailure, unpriceableTokenError, unsupportedCollateralToken, unsupportedTokenPair, withdrawalInProgress };

package/dist/types/model/errors/liquidation-errors.d.ts

@@ -0,0 +1,45 @@
+import { Token } from "../primitives.js";
+import { IGearboxError } from "./base.js";
+import { Address } from "viem";
+//#region src/model/errors/liquidation-errors.d.ts
+/**
+ * The RWA factory has frozen this credit account, so its RWA collateral
+ * cannot move and a liquidation cannot run.
+ **/
+interface CreditAccountFrozenError extends IGearboxError {
+  code: "creditAccountFrozen";
+  creditAccount: Address;
+}
+/** {@inheritDoc CreditAccountFrozenError} */
+declare function creditAccountFrozen(creditAccount: Address): CreditAccountFrozenError;
+/**
+ * The market is paused and `liquidator` is not one of its emergency liquidators,
+ * so a liquidation would revert.
+ **/
+interface NotEmergencyLiquidatorError extends IGearboxError {
+  code: "notEmergencyLiquidator";
+  creditManager: Address;
+  liquidator: Address;
+}
+/** {@inheritDoc NotEmergencyLiquidatorError} */
+declare function notEmergencyLiquidator(creditManager: Address, liquidator: Address): NotEmergencyLiquidatorError;
+/**
+ * The liquidator does not pass the KYC check of the liquidated assets.
+ **/
+interface LiquidatorNotEligibleError extends IGearboxError {
+  code: "liquidatorNotEligible";
+  /**
+   * KYC protocol the liquidator must be whitelisted in (e.g. `"securitize"`).
+   * Absent when the compressor did not name one.
+   **/
+  kycProtocol?: string;
+  /**
+   * Token the liquidator must be whitelisted for in {@link kycProtocol}.
+   * Absent when the liquidation is not KYC-gated, or the token is unknown.
+   **/
+  kycToken?: Token;
+}
+/** {@inheritDoc LiquidatorNotEligibleError} */
+declare function liquidatorNotEligible(kycProtocol?: string, kycToken?: Token): LiquidatorNotEligibleError;
+//#endregion
+export { CreditAccountFrozenError, LiquidatorNotEligibleError, NotEmergencyLiquidatorError, creditAccountFrozen, liquidatorNotEligible, notEmergencyLiquidator };

package/dist/types/model/errors/operation-errors.d.ts

@@ -0,0 +1,216 @@
+import { Bps, Token, TokenAmount } from "../primitives.js";
+import { IGearboxError } from "./base.js";
+import { RWAMissingOpenAccountRequirements, RWAOpenAccountRequirements } from "../rwa.js";
+import { Address } from "viem";
+//#region src/model/errors/operation-errors.d.ts
+/**
+ * Which limit stopped a borrow.
+ *
+ * - `poolAvailableLiquidity` — the pool's available liquidity
+ * - `managerDebtAvailable` — this credit manager's remaining debt allowance
+ * - `maxDebt` — the facade's per-account `debtLimits.maxDebt`
+ * - `debtPerBlockLimit` — facade takes no new debt this block; in practice
+ *   `maxDebtPerBlockMultiplier == 0` after a with-loss liquidation
+ * - `poolDebtLimit` — pool-wide debt cap; used on account-opening only
+ **/
+type BorrowLimitCause = "poolAvailableLiquidity" | "managerDebtAvailable" | "maxDebt" | "debtPerBlockLimit" | "poolDebtLimit";
+/**
+ * The credit manager is paused and takes no multicall at all.
+ **/
+interface CreditManagerPausedError extends IGearboxError {
+  code: "creditManagerPaused";
+  creditManager: Address;
+}
+/** {@inheritDoc CreditManagerPausedError} */
+declare function creditManagerPaused(creditManager: Address): CreditManagerPausedError;
+/**
+ * The pool is paused: it neither takes deposits nor serves withdrawals.
+ **/
+interface PoolPausedError extends IGearboxError {
+  code: "poolPaused";
+  pool: Address;
+}
+/** {@inheritDoc PoolPausedError} */
+declare function poolPaused(pool: Address): PoolPausedError;
+/**
+ * The facade is past its expiration date and takes no more multicalls.
+ **/
+interface MarketExpiredError extends IGearboxError {
+  code: "marketExpired";
+  creditManager: Address;
+  /** Unix seconds, as the facade reports it. */
+  expirationDate: number;
+}
+/** {@inheritDoc MarketExpiredError} */
+declare function marketExpired(creditManager: Address, expirationDate: number): MarketExpiredError;
+/**
+ * The pool is winding down: it still serves withdrawals, but takes no more deposits.
+ **/
+interface PoolSunsetError extends IGearboxError {
+  code: "poolSunset";
+  pool: Address;
+}
+/** {@inheritDoc PoolSunsetError} */
+declare function poolSunset(pool: Address): PoolSunsetError;
+/**
+ * The pool cannot lend what the operation asks for.
+ **/
+interface InsufficientPoolLiquidityError extends IGearboxError {
+  code: "insufficientPoolLiquidity";
+  /** Both in the market's underlying. */
+  requested: TokenAmount;
+  available: TokenAmount;
+  /**
+   * Which limit ran out. See {@link BorrowLimitCause}.
+   **/
+  limit: BorrowLimitCause;
+  /**
+   * Largest debt a new position can still take, omitted when even `minDebt`
+   * does not fit.
+   **/
+  maxBorrowAmount?: TokenAmount;
+}
+/** {@inheritDoc InsufficientPoolLiquidityError} */
+declare function insufficientPoolLiquidity(args: Omit<InsufficientPoolLiquidityError, "code" | "message">): InsufficientPoolLiquidityError;
+/**
+ * The debt the operation implies falls outside the facade's `debtLimits`
+ * (`minDebt`/`maxDebt`).
+ **/
+interface DebtOutOfRangeError extends IGearboxError {
+  code: "debtOutOfRange";
+  /** All three in the market's underlying. */
+  requested: TokenAmount;
+  minDebt: TokenAmount;
+  maxDebt: TokenAmount;
+}
+/** {@inheritDoc DebtOutOfRangeError} */
+declare function debtOutOfRange(args: Omit<DebtOutOfRangeError, "code" | "message">): DebtOutOfRangeError;
+/**
+ * The leverage asked for cannot be expressed as a plan at all.
+ **/
+interface LeverageOutOfRangeError extends IGearboxError {
+  code: "leverageOutOfRange";
+  /**
+   * Scaled by `LEVERAGE_DECIMALS` (`100n` = 1x), as the intent states it — not
+   * the read model's `Leverage`. Both are absent where the floor is not fixed:
+   * the deposit planner's is a function of the deposit.
+   **/
+  requested?: bigint;
+  min?: bigint;
+}
+/** {@inheritDoc LeverageOutOfRangeError} */
+declare function leverageOutOfRange(args?: Omit<LeverageOutOfRangeError, "code" | "message">): LeverageOutOfRangeError;
+/**
+ * The account would end the operation owing more than its collateral is worth
+ * under liquidation thresholds, which the facade refuses to allow.
+ **/
+interface InsufficientCollateralError extends IGearboxError {
+  code: "insufficientCollateral";
+  /**
+   * The factor that was compared, which for a call that hands funds over is
+   * the safe-price one; `safePrices` says which, since a projection always
+   * reports main prices.
+   **/
+  healthFactor: Bps;
+  /**
+   * The threshold it was weighed against — the facade's own `1.0` for a check
+   * that asks whether the transaction lands, a form's higher threshold for one
+   * that asks whether it is wise.
+   **/
+  healthFactorThreshold: Bps;
+  safePrices: boolean;
+}
+/** {@inheritDoc InsufficientCollateralError} */
+declare function insufficientCollateral(args: Omit<InsufficientCollateralError, "code" | "message">): InsufficientCollateralError;
+/**
+ * The operation would increase the balance of a token the market forbids.
+ **/
+interface ForbiddenTokenError extends IGearboxError {
+  code: "forbiddenToken";
+  token: Token;
+}
+/** {@inheritDoc ForbiddenTokenError} */
+declare function forbiddenToken(token: Token): ForbiddenTokenError;
+/**
+ * The market takes no more quota for a token the operation wants to hold.
+ **/
+interface QuotaLimitReachedError extends IGearboxError {
+  code: "quotaLimitReached";
+  /** The token whose quota is asked for. */
+  token: Token;
+  /**
+   * In the **underlying**, which is what a quota is measured in. Absent for a
+   * token the market opened no quota for at all — nothing was weighed against
+   * a limit, the token simply counts as no collateral.
+   **/
+  requested: TokenAmount | undefined;
+  available: TokenAmount;
+}
+/** {@inheritDoc QuotaLimitReachedError} */
+declare function quotaLimitReached(args: Omit<QuotaLimitReachedError, "code" | "message">): QuotaLimitReachedError;
+/**
+ * The account would end up with more quoted tokens than the facade enables at
+ * once. A count, not an amount — unlike {@link QuotaLimitReachedError}.
+ **/
+interface QuotaCountExceededError extends IGearboxError {
+  code: "quotaCountExceeded";
+  count: number;
+  max: number;
+}
+/** {@inheritDoc QuotaCountExceededError} */
+declare function quotaCountExceeded(count: number, max: number): QuotaCountExceededError;
+/**
+ * A balance is too small to fund the operation's step.
+ *
+ * One error for both sides of the question, since both state the same fact —
+ * holder H lacks amount X of token T — and differ only in whose balance is
+ * short.
+ **/
+interface InsufficientBalanceError extends IGearboxError {
+  code: "insufficientBalance";
+  /**
+   * Both absent where the operation was refused before any pair of amounts
+   * existed, which is most of the sites that raise this. The `message` carries
+   * the explanation in that case.
+   **/
+  required?: TokenAmount;
+  held?: TokenAmount;
+  /** Who is short of funds. Absent when planning never resolved one. */
+  holderKind?: "wallet" | "creditAccount";
+  /** The address short of funds, when known. */
+  holder?: Address;
+}
+/** {@inheritDoc InsufficientBalanceError} */
+declare function insufficientBalance(args?: Omit<InsufficientBalanceError, "code" | "message">): InsufficientBalanceError;
+/**
+ * `owner` has not approved `spender` for what the operation pulls.
+ **/
+interface InsufficientAllowanceError extends IGearboxError {
+  code: "insufficientAllowance";
+  owner: Address;
+  spender: Address;
+  /** The token rides inside, as on {@link InsufficientBalanceError}. */
+  required: TokenAmount;
+  /** What is approved today. */
+  allowed: TokenAmount;
+}
+/** {@inheritDoc InsufficientAllowanceError} */
+declare function insufficientAllowance(args: Omit<InsufficientAllowanceError, "code" | "message">): InsufficientAllowanceError;
+/**
+ * The RWA factory still wants something from the borrower before this token
+ * can be opened on.
+ **/
+interface RWAOpenRequirementsError extends IGearboxError {
+  code: "rwaOpenRequirementsNotMet";
+  token: Token;
+  creditManager: Address;
+  factory: Address;
+  /** Always present on the error. */
+  requirements: RWAOpenAccountRequirements;
+  /** Absent when only issuer-side registration is pending. */
+  missing?: RWAMissingOpenAccountRequirements;
+}
+/** {@inheritDoc RWAOpenRequirementsError} */
+declare function rwaOpenRequirementsNotMet(args: Omit<RWAOpenRequirementsError, "code" | "message">): RWAOpenRequirementsError;
+//#endregion
+export { BorrowLimitCause, CreditManagerPausedError, DebtOutOfRangeError, ForbiddenTokenError, InsufficientAllowanceError, InsufficientBalanceError, InsufficientCollateralError, InsufficientPoolLiquidityError, LeverageOutOfRangeError, MarketExpiredError, PoolPausedError, PoolSunsetError, QuotaCountExceededError, QuotaLimitReachedError, RWAOpenRequirementsError, creditManagerPaused, debtOutOfRange, forbiddenToken, insufficientAllowance, insufficientBalance, insufficientCollateral, insufficientPoolLiquidity, leverageOutOfRange, marketExpired, poolPaused, poolSunset, quotaCountExceeded, quotaLimitReached, rwaOpenRequirementsNotMet };

package/dist/types/{onchain/market/oracle/errors.d.ts → model/errors/oracle-errors.d.ts}

@@ -1,10 +1,8 @@
-import { IGearboxError } from "../../../model/errors.js";
+import { IGearboxError } from "./base.js";
 import { Address } from "viem";
-//#region src/onchain/market/oracle/errors.d.ts
+//#region src/model/errors/oracle-errors.d.ts
 /**
- * The oracle has no price for `token`. Preview callers attach this with
- * `warning ??=` so a malformed-transaction warning already recorded keeps
- * precedence.
+ * The oracle has no price for token
  **/
 interface UnpriceableTokenError extends IGearboxError {
   code: "unpriceableToken";

package/dist/types/model/errors/prepare-errors.d.ts

@@ -0,0 +1,131 @@
+import { Token, TokenAmount } from "../primitives.js";
+import { IGearboxError } from "./base.js";
+import { Address } from "viem";
+//#region src/model/errors/prepare-errors.d.ts
+/**
+ * Input token is not accepted by the flow (e.g. deposit of a non-underlying).
+ **/
+interface UnsupportedCollateralTokenError extends IGearboxError {
+  code: "unsupportedCollateralToken";
+  token: Token;
+}
+/** {@inheritDoc UnsupportedCollateralTokenError} */
+declare function unsupportedCollateralToken(token: Token): UnsupportedCollateralTokenError;
+/**
+ * No route for the trade the plan needs: no pool pair between the tokens,
+ * several and none was picked, or the pathfinder found no path.
+ **/
+interface UnsupportedTokenPairError extends IGearboxError {
+  code: "unsupportedTokenPair";
+  /**
+   * `to` is absent where the market named no output for `from`; both are absent
+   * when the pathfinder reverted rather than answered.
+   **/
+  from?: Token;
+  to?: Token;
+}
+/** {@inheritDoc UnsupportedTokenPairError} */
+declare function unsupportedTokenPair(args?: Omit<UnsupportedTokenPairError, "code" | "message">): UnsupportedTokenPairError;
+/**
+ * The intent cannot settle with a delay: the source has no redemption config,
+ * the chain has no compressor, or the tail cannot serve the token asked for.
+ **/
+interface NoDelayedRouteError extends IGearboxError {
+  code: "noDelayedRoute";
+  /** Absent where the error is the intent's, not the token's. */
+  token?: Token;
+}
+/** {@inheritDoc NoDelayedRouteError} */
+declare function noDelayedRoute(token?: Token): NoDelayedRouteError;
+/** Several redemption venues for the source, and nothing says which. */
+interface MultipleDelayedWithdrawalsError extends IGearboxError {
+  code: "multipleDelayedWithdrawals";
+  token: Token;
+  venues: number;
+}
+/** {@inheritDoc MultipleDelayedWithdrawalsError} */
+declare function multipleDelayedWithdrawals(token: Token, venues: number): MultipleDelayedWithdrawalsError;
+/** A redemption of the same asset is already in flight. */
+interface WithdrawalInProgressError extends IGearboxError {
+  code: "withdrawalInProgress";
+  /** The phantom token standing for the redemption already in flight. */
+  inFlight: TokenAmount;
+}
+/** {@inheritDoc WithdrawalInProgressError} */
+declare function withdrawalInProgress(inFlight: TokenAmount): WithdrawalInProgressError;
+/**
+ * The claim names no operation to resume: requested without an intent, or read
+ * through a compressor too old to report one.
+ **/
+interface NoRecordedIntentError extends IGearboxError {
+  code: "noRecordedIntent";
+}
+/** {@inheritDoc NoRecordedIntentError} */
+declare function noRecordedIntent(): NoRecordedIntentError;
+/**
+ * Opening asked for no target token and the market names none of its own, so
+ * there is nothing to put the position into.
+ *
+ * A market fact, not a bad argument: pass a `targetToken` to open against a
+ * manager that has no default one.
+ **/
+interface NoStrategyTargetCollateralError extends IGearboxError {
+  code: "noStrategyTargetCollateral";
+  creditManager: Address;
+}
+/** {@inheritDoc NoStrategyTargetCollateralError} */
+declare function noStrategyTargetCollateral(creditManager: Address): NoStrategyTargetCollateralError;
+/**
+ * No account at that address in the markets this SDK is connected to — closed
+ * since it was listed, or read on the wrong chain.
+ **/
+interface CreditAccountNotFoundError extends IGearboxError {
+  code: "creditAccountNotFound";
+  creditAccount: Address;
+}
+/** {@inheritDoc CreditAccountNotFoundError} */
+declare function creditAccountNotFound(creditAccount: Address): CreditAccountNotFoundError;
+/**
+ * The account named to open a position on carries debt or quotas.
+ *
+ * Growing a position that already exists is `depositStrategy`.
+ **/
+interface CreditAccountNotEmptyError extends IGearboxError {
+  code: "creditAccountNotEmpty";
+  creditAccount: Address;
+}
+/** {@inheritDoc CreditAccountNotEmptyError} */
+declare function creditAccountNotEmpty(creditAccount: Address): CreditAccountNotEmptyError;
+/**
+ * An empty opening was asked for with something to open it with: collateral to
+ * spend, an account to reuse, or a leverage to reach.
+ **/
+interface EmptyOpenTakesNothingError extends IGearboxError {
+  code: "emptyOpenTakesNothing";
+}
+/** {@inheritDoc EmptyOpenTakesNothingError} */
+declare function emptyOpenTakesNothing(): EmptyOpenTakesNothingError;
+/**
+ * The SDK could not answer at all: a read that failed, a chain it is not
+ * connected to, a market or token address it knows nothing about, a contract
+ * that reverted where nothing should, a bug of ours.
+ *
+ * The one code that is not a verdict on the request — everything above says
+ * "this cannot be done", this one says "we do not know". It exists so that a
+ * prepare method or a check always answers: what used to escape as an
+ * exception arrives here instead, whole, under `cause`.
+ **/
+interface UnexpectedFailureError extends IGearboxError {
+  code: "unexpectedFailure";
+  /** What actually went wrong, for a log and a bug report. */
+  cause: Error;
+}
+/**
+ * {@inheritDoc UnexpectedFailureError}
+ *
+ * Takes what was thrown, whatever that is: a `throw` is not obliged to raise an
+ * `Error`, and `cause` promises one.
+ **/
+declare function unexpectedFailure(thrown: unknown, action?: string): UnexpectedFailureError;
+//#endregion
+export { CreditAccountNotEmptyError, CreditAccountNotFoundError, EmptyOpenTakesNothingError, MultipleDelayedWithdrawalsError, NoDelayedRouteError, NoRecordedIntentError, NoStrategyTargetCollateralError, UnexpectedFailureError, UnsupportedCollateralTokenError, UnsupportedTokenPairError, WithdrawalInProgressError, creditAccountNotEmpty, creditAccountNotFound, emptyOpenTakesNothing, multipleDelayedWithdrawals, noDelayedRoute, noRecordedIntent, noStrategyTargetCollateral, unexpectedFailure, unsupportedCollateralToken, unsupportedTokenPair, withdrawalInProgress };

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

@@ -0,0 +1,72 @@
+import { IGearboxError } from "./base.js";
+import { Address, Hex } from "viem";
+//#region src/model/errors/preview-errors.d.ts
+/**
+ * Target of a transaction is not a known Gearbox contract
+ * (pool/facade/etc.)
+ */
+interface UnsupportedTargetError extends IGearboxError {
+  code: "unsupportedTarget";
+  /** Target address no known Gearbox contract answers for. */
+  target: Address;
+}
+/**
+ * Pool call uses a function other than ERC4626 `deposit`/`redeem`.
+ */
+interface UnsupportedPoolFunctionError extends IGearboxError {
+  code: "unsupportedPoolFunction";
+  /** Pool the call targets. */
+  pool: Address;
+  /** Decoded function name the SDK cannot preview. */
+  functionName: string;
+}
+/**
+ * Zapper call uses a function other than a known `deposit`/`redeem` variant.
+ */
+interface UnsupportedZapperFunctionError extends IGearboxError {
+  code: "unsupportedZapperFunction";
+  /** Zapper contract the call targets. */
+  zapper: Address;
+  /** Decoded function name the SDK cannot preview. */
+  functionName: string;
+}
+/**
+ * Refusal answered by `previewOperation` for parsed operations it cannot
+ * preview yet.
+ */
+interface UnsupportedOperationError extends IGearboxError {
+  code: "unsupportedOperation";
+  /** The parsed operation kind (the `operation` discriminant). */
+  operation: string;
+}
+/**
+ * Delayed-withdrawal request or redemption log carries
+ * non-empty `extraData` that cannot be decoded as a `DelayedIntent`.
+ */
+interface InvalidDelayedIntentError extends IGearboxError {
+  code: "invalidDelayedIntent";
+  /** Raw `extraData` that failed to decode. */
+  extraData: Hex;
+  /** The decoding failure this refusal stands in front of. */
+  cause?: Error;
+}
+/**
+ * Pool operation preview read (ERC4626 preview/`balanceOf`) fails.
+ */
+interface PoolOperationPreviewError extends IGearboxError {
+  code: "poolOperationPreviewError";
+  /** Pool the operation targeted. */
+  pool: Address;
+}
+/**
+ * The transaction could not be replayed: it is malformed.
+ * Facade multicalls theoretically allow many more combinations of calls,
+ * but sdk generates and parses only certain combinations.
+ */
+interface MalformedTransactionError extends IGearboxError {
+  code: "malformedTransaction";
+}
+/** {@inheritDoc MalformedTransactionError} */
+declare function malformedTransaction(detail: string, cause?: Error): MalformedTransactionError;
+//#endregion
+export { InvalidDelayedIntentError, MalformedTransactionError, PoolOperationPreviewError, UnsupportedOperationError, UnsupportedPoolFunctionError, UnsupportedTargetError, UnsupportedZapperFunctionError, malformedTransaction };