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

package/dist/esm/onchain/validation/index.js

@@ -1,4 +1,43 @@
-import { MIN_HEALTH_FACTOR_FACADE, MIN_HEALTH_FACTOR_FORM, MIN_HF_LIMITED, MIN_SAFE_HEALTH_FACTOR_FORM, amountOf, checkBorrowLimit, checkCollateralised, checkCreditManagerPaused, checkDebtInBand, checkForbiddenToken, checkFunding, checkLeverageAtLeastOne, checkMarketExpired, checkPoolPaused, checkPoolPayout, checkPoolSunset, checkPreviewError, checkQuotaCount, checkQuotaLimit, isMalformedPreviewError } from "./checks.js";
-import { raise, refuse } from "./refusal.js";
-import { toToken, toTokenAmount } from "./token.js";
-export { MIN_HEALTH_FACTOR_FACADE, MIN_HEALTH_FACTOR_FORM, MIN_HF_LIMITED, MIN_SAFE_HEALTH_FACTOR_FORM, amountOf, checkBorrowLimit, checkCollateralised, checkCreditManagerPaused, checkDebtInBand, checkForbiddenToken, checkFunding, checkLeverageAtLeastOne, checkMarketExpired, checkPoolPaused, checkPoolPayout, checkPoolSunset, checkPreviewError, checkQuotaCount, checkQuotaLimit, isMalformedPreviewError, raise, refuse, toToken, toTokenAmount };
+import { amountOf } from "./helpers/amount.js";
+import { MIN_HEALTH_FACTOR_FACADE, MIN_HEALTH_FACTOR_FORM, MIN_HF_LIMITED, MIN_SAFE_HEALTH_FACTOR_FORM } from "./helpers/health-factor-limits.js";
+import { toToken, toTokenAmount } from "./helpers/token.js";
+import "./helpers/index.js";
+import { checkBorrowLimit } from "./checks/checkBorrowLimit.js";
+import { checkCollateralised } from "./checks/checkCollateralised.js";
+import { checkCreditAccountFrozen } from "./checks/checkCreditAccountFrozen.js";
+import { checkCreditManagerPaused } from "./checks/checkCreditManagerPaused.js";
+import { checkDebtLimits } from "./checks/checkDebtLimits.js";
+import { checkEmergencyLiquidator } from "./checks/checkEmergencyLiquidator.js";
+import { checkForbiddenToken } from "./checks/checkForbiddenToken.js";
+import { checkLeverage } from "./checks/checkLeverage.js";
+import { checkLiquidatorEligible } from "./checks/checkLiquidatorEligible.js";
+import { checkMarketExpired } from "./checks/checkMarketExpired.js";
+import { checkPoolLiquidity } from "./checks/checkPoolLiquidity.js";
+import { checkPoolPaused } from "./checks/checkPoolPaused.js";
+import { checkPoolSunset } from "./checks/checkPoolSunset.js";
+import { checkQuotaCount } from "./checks/checkQuotaCount.js";
+import { checkQuotaLimit } from "./checks/checkQuotaLimit.js";
+import "./checks/index.js";
+import { checkAccountQuotas } from "./bundles/checkAccountQuotas.js";
+import { checkWalletAllowance } from "./bundles/checkWalletAllowance.js";
+import { checkWalletBalance } from "./bundles/checkWalletBalance.js";
+import { checkCollateralFunding } from "./bundles/checkCollateralFunding.js";
+import { checkDraw } from "./bundles/checkDraw.js";
+import { checkHealthFactors } from "./bundles/checkHealthFactors.js";
+import { checkMarket } from "./bundles/checkMarket.js";
+import { checkObtained } from "./bundles/checkObtained.js";
+import { checkQuotasAsked } from "./bundles/checkQuotasAsked.js";
+import { checkRWAOpenRequirements } from "./bundles/checkRWAOpenRequirements.js";
+import { checkRWAOpening } from "./bundles/checkRWAOpening.js";
+import { checkCreditOperation } from "./bundles/checkCreditOperation.js";
+import { checkLiquidationEligibility } from "./bundles/checkLiquidationEligibility.js";
+import { checkLiquidationFunding } from "./bundles/checkLiquidationFunding.js";
+import { checkWallet } from "./bundles/checkWallet.js";
+import { checkPoolFunding } from "./bundles/checkPoolFunding.js";
+import { checkPoolOperation } from "./bundles/checkPoolOperation.js";
+import "./bundles/index.js";
+import { checkLiquidation } from "./checkLiquidation.js";
+import { checkOperation } from "./checkOperation.js";
+import { checkSimulation } from "./checkSimulation.js";
+import { raise } from "./raise.js";
+export { MIN_HEALTH_FACTOR_FACADE, MIN_HEALTH_FACTOR_FORM, MIN_HF_LIMITED, MIN_SAFE_HEALTH_FACTOR_FORM, amountOf, checkAccountQuotas, checkBorrowLimit, checkCollateralFunding, checkCollateralised, checkCreditAccountFrozen, checkCreditManagerPaused, checkCreditOperation, checkDebtLimits, checkDraw, checkEmergencyLiquidator, checkForbiddenToken, checkHealthFactors, checkLeverage, checkLiquidation, checkLiquidationEligibility, checkLiquidationFunding, checkLiquidatorEligible, checkMarket, checkMarketExpired, checkObtained, checkOperation, checkPoolFunding, checkPoolLiquidity, checkPoolOperation, checkPoolPaused, checkPoolSunset, checkQuotaCount, checkQuotaLimit, checkQuotasAsked, checkRWAOpenRequirements, checkRWAOpening, checkSimulation, checkWallet, checkWalletAllowance, checkWalletBalance, raise, toToken, toTokenAmount };

package/dist/esm/onchain/validation/raise.js

@@ -0,0 +1,31 @@
+//#region src/onchain/validation/raise.ts
+/**
+* Engine-internal throw: planners and guards raise one error object, and the
+* service boundary turns it into {@link SDKError}.
+**/
+var IntentPreviewError = class IntentPreviewError extends Error {
+	error;
+	constructor(error, message) {
+		super(message ?? error.message);
+		this.name = "IntentPreviewError";
+		this.error = error;
+	}
+	/** The same wrap the checks hand out, with an optional engine-side sentence. */
+	static of(error, message) {
+		return new IntentPreviewError(error, message);
+	}
+};
+/**
+* Throws the first error a check found, with the sentence the engine logs for
+* it. An empty array is a pass.
+*
+* 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.
+**/
+function raise(errors, message) {
+	const [first] = errors;
+	if (first) throw IntentPreviewError.of(first, message);
+}
+//#endregion
+export { IntentPreviewError, raise };

package/dist/esm/sdk/execute/ExecuteApi.js

@@ -59,6 +59,7 @@ async function openTx(sdk, request) {
 		calls: state.calls,
 		averageQuota: state.averageQuota,
 		minQuota: state.minQuota,
+		reopenCreditAccount: state.creditAccount,
 		permits: {},
 		referralCode: 0n,
 		rwaOptions: await openRwaOptions(sdk, request)

package/dist/esm/sdk/index.js

@@ -1,4 +1,4 @@
-import { IntentPreviewError, raise, refuse } from "../onchain/validation/refusal.js";
+import { creditAccountNotEmpty, creditAccountNotFound, emptyOpenTakesNothing, noStrategyTargetCollateral, unexpectedFailure } from "../model/errors/prepare-errors.js";
 import { AllSourcesFailedError } from "./errors/AllSourcesFailedError.js";
 import { SourceChainMismatchError } from "./errors/SourceChainMismatchError.js";
 import { assertSameChains } from "./errors/assertSameChains.js";
@@ -14,7 +14,6 @@ import { LiquidationsNamespace } from "./liquidations/LiquidationsNamespace.js";
 import "./liquidations/index.js";
 import { ExecuteApi } from "./execute/ExecuteApi.js";
 import "./execute/index.js";
-import { creditAccountNotFound, noStrategyTargetCollateral, toRefusalError, unexpectedFailure } from "./prepare/errors.js";
 import { PrepareApi } from "./prepare/PrepareApi.js";
 import "./prepare/index.js";
 import { filterResponse } from "./utils/filterResponse.js";
@@ -28,4 +27,4 @@ import { PreviewNamespace } from "./preview/PreviewNamespace.js";
 import "./preview/index.js";
 import { DEFAULT_MAX_STATE_AGE, GearboxSDK } from "./GearboxSDK.js";
 import "./types.js";
-export { AbstractNamespace, AllSourcesFailedError, AnalyticsNamespace, DEFAULT_MAX_OFFCHAIN_LAG, DEFAULT_MAX_STATE_AGE, ExecuteApi, GearboxSDK, IntentPreviewError, LiquidationsNamespace, MissingSourceError, NoSourceServedError, OpportunitiesNamespace, PositionsNamespace, PrepareApi, PreviewNamespace, SourceChainMismatchError, SourceUnavailableError, assertSameChains, creditAccountNotFound, everyChainFailed, filterResponse, mergeChainList, mergeChainOne, noStrategyTargetCollateral, raise, refuse, toRefusalError, unexpectedFailure };
+export { AbstractNamespace, AllSourcesFailedError, AnalyticsNamespace, DEFAULT_MAX_OFFCHAIN_LAG, DEFAULT_MAX_STATE_AGE, ExecuteApi, GearboxSDK, LiquidationsNamespace, MissingSourceError, NoSourceServedError, OpportunitiesNamespace, PositionsNamespace, PrepareApi, PreviewNamespace, SourceChainMismatchError, SourceUnavailableError, assertSameChains, creditAccountNotEmpty, creditAccountNotFound, emptyOpenTakesNothing, everyChainFailed, filterResponse, mergeChainList, mergeChainOne, noStrategyTargetCollateral, unexpectedFailure };

package/dist/esm/sdk/liquidations/LiquidationsNamespace.js

@@ -1,4 +1,5 @@
 import { toChainIds } from "../../onchain/chain/chains.js";
+import { checkLiquidation } from "../../onchain/validation/checkLiquidation.js";
 import "../../onchain/index.js";
 //#region src/sdk/liquidations/LiquidationsNamespace.ts
 /**
@@ -39,6 +40,14 @@ var LiquidationsNamespace = class {
 		await this.#ensureFresh?.(props.chainIds);
 		return this.#onchain.liquidations.getLiquidationPositions(props);
 	}
+	/**
+	* {@inheritDoc ILiquidations.checkLiquidation}
+	**/
+	async checkLiquidation(props, options) {
+		await this.#ensureFresh?.([props.details.chainId]);
+		const sdk = this.#onchain.chain(props.details.chainId);
+		return checkLiquidation(sdk, props, options);
+	}
 };
 //#endregion
 export { LiquidationsNamespace };

package/dist/esm/sdk/prepare/PrepareApi.js

@@ -1,13 +1,14 @@
 import { hexEq } from "../../onchain/utils/hex.js";
 import { MultichainConstruct } from "../../onchain/base/MultichainConstruct.js";
+import { creditAccountNotEmpty, creditAccountNotFound, emptyOpenTakesNothing, noRecordedIntent, noStrategyTargetCollateral, unexpectedFailure, unsupportedTokenPair } from "../../model/errors/prepare-errors.js";
 import { sdkErr, sdkOk } from "../../model/result.js";
 import "../../model/index.js";
-import { toToken } from "../../onchain/validation/token.js";
+import { toToken } from "../../onchain/validation/helpers/token.js";
 import { toCreditAccountSlice } from "../../onchain/accounts/intents/utils/credit-account-slice.js";
 import { CreditAccountOperationsService } from "../../onchain/accounts/intents/index.js";
 import "../../onchain/index.js";
-import { creditAccountNotFound, noStrategyTargetCollateral, toRefusalError, unexpectedFailure } from "./errors.js";
 import { withdrawableCollaterals } from "./withdrawable-collaterals.js";
+import { isAddressEqual } from "viem";
 //#region src/sdk/prepare/PrepareApi.ts
 /**
 * {@inheritDoc IOpportunitiesPrepare}
@@ -38,7 +39,7 @@ var PrepareApi = class extends MultichainConstruct {
 	}
 	/**
 	* The chain an async method reads, revalidated first so the state it is
-	* about to weigh is no older than the SDK's freshness bar.
+	* about to weigh is no older than the SDK's freshness threshold.
 	**/
 	async #chain(chainId) {
 		await this.#ensureFresh?.([this.sdk.chain(chainId).chainId]);
@@ -52,10 +53,7 @@ var PrepareApi = class extends MultichainConstruct {
 			const sdk = await this.#chain(position.chainId);
 			const at = stateBlock(sdk);
 			const intent = resumable(params.intent ?? params.claimable.intent);
-			if (!intent) return sdkErr(toRefusalError({
-				reason: "noRecordedIntent",
-				detail: void 0
-			}));
+			if (!intent) return sdkErr(noRecordedIntent());
 			const creditAccount = await slice(sdk, position.creditAccount);
 			if (!creditAccount) return sdkErr(creditAccountNotFound(position.creditAccount));
 			return finalized(await service(sdk).finishIntent({
@@ -181,8 +179,23 @@ var PrepareApi = class extends MultichainConstruct {
 		try {
 			const sdk = await this.#chain(strategy.chainId);
 			const at = stateBlock(sdk);
+			if (params.empty) {
+				if (params.collateral.length > 0 || params.creditAccount || params.leverage !== 0n) return sdkErr(emptyOpenTakesNothing());
+				return opened(await service(sdk).openStrategyIntent({
+					sdk,
+					creditManager: strategy.creditManager,
+					empty: true
+				}), at);
+			}
 			const targetToken = params.targetToken ?? sdk.marketRegister.findCreditManager(strategy.creditManager).strategyTargetCollateral;
 			if (!targetToken) return sdkErr(noStrategyTargetCollateral(strategy.creditManager));
+			let creditAccount;
+			if (params.creditAccount) {
+				const reused = await slice(sdk, params.creditAccount);
+				if (!reused || !isAddressEqual(reused.creditManager, strategy.creditManager)) return sdkErr(creditAccountNotFound(params.creditAccount));
+				if (reused.totalDebt > 0n || reused.tokens.some((t) => t.quota > 0n)) return sdkErr(creditAccountNotEmpty(params.creditAccount));
+				creditAccount = reused;
+			}
 			return opened(await service(sdk).openStrategyIntent({
 				sdk,
 				creditManager: strategy.creditManager,
@@ -191,7 +204,8 @@ var PrepareApi = class extends MultichainConstruct {
 				leverage: params.leverage,
 				leftoverBalances: params.leftoverBalances,
 				slippage: params.slippage,
-				quotaReserve: params.quotaReserve
+				quotaReserve: params.quotaReserve,
+				creditAccount
 			}), at);
 		} catch (e) {
 			return sdkErr(unexpectedFailure(e));
@@ -331,7 +345,7 @@ var PrepareApi = class extends MultichainConstruct {
 	/**
 	* Shared path of the two flows that sell a position asset, and therefore
 	* have two routes to offer: one account read, one intent, both routes
-	* quoted. Every refusal, the crash wrap included, carries `refused` so a
+	* quoted. Every error, the crash wrap included, carries `errors` so a
 	* form can say which routes were ruled out and why.
 	*
 	* @typeParam X - The codes the calling flow can raise beyond the shared
@@ -434,43 +448,39 @@ function toClaimableWithdrawal(claimable) {
 	};
 }
 /**
-* The engine's refusal as one flow's failure half.
+* The engine's error as one flow's failure half.
 *
-* The engine answers with the open union of every reason it can raise
+* The engine answers with the open union of every error it can raise
 * anywhere; which of them a given flow actually reaches is the engine trace
 * written into the public signatures. This cast is the one place the open
 * union is narrowed onto them — a code added to or removed from a flow has to
 * move its signature, which `types.test-d.ts` pins.
 **/
-function refusal(issue) {
-	return sdkErr(toRefusalError(issue));
+function methodError(result) {
+	return result;
 }
 /**
-* A flow with two routes, refused before either could be quoted: the error is
+* A flow with two routes, stopped before either could be quoted: the error is
 * the same one any other flow would report, with nothing to say about the
 * routes because neither was reached.
 **/
 function neitherRoute(error) {
 	return sdkErr({
 		...error,
-		refused: {
-			instant: void 0,
-			delayed: void 0
-		}
+		errors: {}
 	});
 }
 /**
 * The engine's answer, as the envelope the namespace speaks in: what the
 * operation comes to under `data`, stamped with the block it was computed
-* from, or the refusal as an error carrying its own numbers, see
-* {@link refusal}.
+* from, or the error carrying its own numbers.
 *
 * The engine keeps its `ok` union — it is the shape the planners, the guards
 * and their tests are written against — and the boundary is the one place the
 * two vocabularies meet.
 **/
 function planned(result, at) {
-	if (!result.ok) return refusal(result);
+	if (!result.ok) return methodError(result);
 	const { operations, state, calls } = result;
 	return sdkOk({
 		operations,
@@ -486,7 +496,7 @@ function planned(result, at) {
 * built on finished the withdrawal, or left part of it queued for another one.
 **/
 function finalized(result, at) {
-	if (!result.ok) return refusal(result);
+	if (!result.ok) return methodError(result);
 	const { operations, state, calls, remainder } = result;
 	return sdkOk({
 		operations,
@@ -503,24 +513,24 @@ function opened(result, at) {
 	return result.ok ? sdkOk({
 		state: result.state,
 		...at
-	}) : refusal(result);
+	}) : methodError(result);
 }
 /**
 * {@inheritDoc planned}
 *
-* Both routes are payload, refusal and all: `refused` says why a missing one is
+* Both routes are payload, error and all: `errors` says why a missing one is
 * missing, and it stays on the error when neither route answered, since that is
 * the same question asked of a request that has no viable half at all.
 **/
 function routed(result, at) {
 	if (!result.ok) {
-		const { refused, ...issue } = result;
+		const { errors, error } = result;
 		return sdkErr({
-			...toRefusalError(issue),
-			refused
+			...error,
+			errors
 		});
 	}
-	const { instant, delayed, refused } = result;
+	const { instant, delayed, errors } = result;
 	return sdkOk({
 		instant: instant && {
 			operations: instant.operations,
@@ -535,7 +545,7 @@ function routed(result, at) {
 			delayed: delayed.delayed,
 			...at
 		},
-		refused,
+		errors,
 		...at
 	});
 }
@@ -561,19 +571,16 @@ async function lpState(sdk, pool, wallet, simulation, moved) {
 	};
 }
 /**
-* A pool route the market does not offer, as the refusal a caller reads.
+* A pool route the market does not offer, as the error a caller reads.
 *
 * `to` is absent where {@link lpRoute} found no output to name at all, which
 * is the usual way of it; both are present where a pair exists but nothing of
 * ours implements it.
 **/
 function unroutable(sdk, from, to) {
-	return sdkErr(toRefusalError({
-		reason: "unsupportedTokenPair",
-		detail: {
-			from: toToken(sdk, from),
-			to: to === void 0 ? void 0 : toToken(sdk, to)
-		}
+	return sdkErr(unsupportedTokenPair({
+		from: toToken(sdk, from),
+		to: to === void 0 ? void 0 : toToken(sdk, to)
 	}));
 }
 /**

package/dist/esm/sdk/prepare/index.js

@@ -1,5 +1,5 @@
-import { IntentPreviewError, raise, refuse } from "../../onchain/validation/refusal.js";
-import { creditAccountNotFound, noStrategyTargetCollateral, toRefusalError, unexpectedFailure } from "./errors.js";
+import { creditAccountNotEmpty, creditAccountNotFound, emptyOpenTakesNothing, noStrategyTargetCollateral, unexpectedFailure } from "../../model/errors/prepare-errors.js";
+import "../../model/index.js";
 import { PrepareApi } from "./PrepareApi.js";
 import "./types.js";
-export { IntentPreviewError, PrepareApi, creditAccountNotFound, noStrategyTargetCollateral, raise, refuse, toRefusalError, unexpectedFailure };
+export { PrepareApi, creditAccountNotEmpty, creditAccountNotFound, emptyOpenTakesNothing, noStrategyTargetCollateral, unexpectedFailure };

package/dist/esm/sdk/prepare/types.js

@@ -1,2 +1 @@
-import { IntentPreviewError, raise, refuse } from "../../onchain/validation/refusal.js";
-export { IntentPreviewError, raise, refuse };
+export {};

package/dist/esm/sdk/preview/PreviewNamespace.js

@@ -1,5 +1,7 @@
-import { previewOperation } from "../../preview/preview/previewOperation.js";
-import "../../preview/index.js";
+import { checkOperation } from "../../onchain/validation/checkOperation.js";
+import { checkSimulation } from "../../onchain/validation/checkSimulation.js";
+import { previewOperation } from "../../onchain/preview/preview/previewOperation.js";
+import "../../onchain/index.js";
 //#region src/sdk/preview/PreviewNamespace.ts
 /**
 * {@inheritDoc IPreview}
@@ -7,11 +9,9 @@ import "../../preview/index.js";
 var PreviewNamespace = class {
 	#onchain;
 	#ensureFresh;
-	#logger;
 	constructor(onchain, options) {
 		this.#onchain = onchain;
 		this.#ensureFresh = options.ensureFresh;
-		this.#logger = options.logger?.child?.({ name: "Preview" }) ?? options.logger;
 	}
 	/**
 	* {@inheritDoc IPreview.previewOperation}
@@ -19,16 +19,27 @@ var PreviewNamespace = class {
 	async previewOperation(input, options) {
 		await this.#ensureFresh?.([input.chainId]);
 		const sdk = this.#onchain.chain(input.chainId);
-		return previewOperation({
+		return previewOperation(sdk, input, options);
+	}
+	/**
+	* {@inheritDoc IPreview.checkOperation}
+	**/
+	async checkOperation(props, options) {
+		const { chainId, ...input } = props;
+		await this.#ensureFresh?.([chainId]);
+		const sdk = this.#onchain.chain(chainId);
+		return checkOperation({
 			sdk,
-			to: input.to,
-			calldata: input.calldata,
-			sender: input.sender,
-			value: input.value
-		}, {
-			blockNumber: options?.blockNumber,
-			logger: this.#logger
-		});
+			...input
+		}, options);
+	}
+	/**
+	* {@inheritDoc IPreview.checkSimulation}
+	**/
+	async checkSimulation(props, options) {
+		await this.#ensureFresh?.([props.chainId]);
+		const sdk = this.#onchain.chain(props.chainId);
+		return checkSimulation(sdk, props, options);
 	}
 };
 //#endregion

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

@@ -1,11 +1,10 @@
 import { AddressMap } from "../onchain/utils/AddressMap.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 { FacadeParsedCall } from "../preview/trace/types.js";
-import "../preview/trace/index.js";
+import { WithdrawCollateralEventInfo } from "./trace/extractTransfers.js";
+import { FacadeParsedCall } from "./trace/types.js";
+import "./trace/index.js";
 import { HistoryFacadeMetadata, OuterFacadeOperation } from "./types.js";
 import { Address } from "viem";
 //#region src/history/assembleOperations.d.ts

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 };