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

package/dist/esm/onchain/validation/checks/checkLiquidatorEligible.js

@@ -0,0 +1,9 @@
+import { liquidatorNotEligible } from "../../../model/errors/liquidation-errors.js";
+import "../../../model/index.js";
+//#region src/onchain/validation/checks/checkLiquidatorEligible.ts
+/** The compressor's KYC check of this wallet against the liquidated assets. */
+function checkLiquidatorEligible(args) {
+	return args.eligible ? [] : [liquidatorNotEligible(args.kycProtocol, args.kycToken)];
+}
+//#endregion
+export { checkLiquidatorEligible };

package/dist/esm/onchain/validation/checks/checkMarketExpired.js

@@ -0,0 +1,9 @@
+import { marketExpired } from "../../../model/errors/operation-errors.js";
+import "../../../model/index.js";
+//#region src/onchain/validation/checks/checkMarketExpired.ts
+/** Past its expiration date the facade takes no more multicalls. */
+function checkMarketExpired(args) {
+	return args.isExpired ? [marketExpired(args.creditManager, args.expirationDate)] : [];
+}
+//#endregion
+export { checkMarketExpired };

package/dist/esm/onchain/validation/checks/checkPoolLiquidity.js

@@ -0,0 +1,24 @@
+import { insufficientPoolLiquidity } from "../../../model/errors/operation-errors.js";
+import "../../../model/index.js";
+import { amountOf } from "../helpers/amount.js";
+import "../helpers/index.js";
+//#region src/onchain/validation/checks/checkPoolLiquidity.ts
+/**
+* What the pool holds, against what is being taken out of it.
+*
+* The operator is not `checkBorrowLimit`'s: a pool holding exactly the amount
+* asked for still cannot serve it, so equality is already a refusal. That is
+* the rule the legacy withdrawal validator enforced and it is preserved to the
+* unit.
+*/
+function checkPoolLiquidity(args) {
+	const { requested, available, underlying } = args;
+	if (requested < available) return [];
+	return [insufficientPoolLiquidity({
+		requested: amountOf(underlying, requested),
+		available: amountOf(underlying, available),
+		limit: "poolAvailableLiquidity"
+	})];
+}
+//#endregion
+export { checkPoolLiquidity };

package/dist/esm/onchain/validation/checks/checkPoolPaused.js

@@ -0,0 +1,9 @@
+import { poolPaused } from "../../../model/errors/operation-errors.js";
+import "../../../model/index.js";
+//#region src/onchain/validation/checks/checkPoolPaused.ts
+/** A paused pool neither takes deposits nor serves withdrawals. */
+function checkPoolPaused(args) {
+	return args.isPaused ? [poolPaused(args.pool)] : [];
+}
+//#endregion
+export { checkPoolPaused };

package/dist/esm/onchain/validation/checks/checkPoolSunset.js

@@ -0,0 +1,9 @@
+import { poolSunset } from "../../../model/errors/operation-errors.js";
+import "../../../model/index.js";
+//#region src/onchain/validation/checks/checkPoolSunset.ts
+/** A pool winding down still serves withdrawals, so only what puts money in is refused. */
+function checkPoolSunset(args) {
+	return args.isSunset && args.isDeposit ? [poolSunset(args.pool)] : [];
+}
+//#endregion
+export { checkPoolSunset };

package/dist/esm/onchain/validation/checks/checkQuotaCount.js

@@ -0,0 +1,9 @@
+import { quotaCountExceeded } from "../../../model/errors/operation-errors.js";
+import "../../../model/index.js";
+//#region src/onchain/validation/checks/checkQuotaCount.ts
+/** How many quoted tokens the facade enables at once. */
+function checkQuotaCount(args) {
+	return args.count > args.max ? [quotaCountExceeded(args.count, args.max)] : [];
+}
+//#endregion
+export { checkQuotaCount };

package/dist/esm/onchain/validation/checks/checkQuotaLimit.js

@@ -0,0 +1,17 @@
+import { quotaLimitReached } from "../../../model/errors/operation-errors.js";
+import "../../../model/index.js";
+import { amountOf } from "../helpers/amount.js";
+import "../helpers/index.js";
+//#region src/onchain/validation/checks/checkQuotaLimit.ts
+/** The room the keeper still has for a token's quota, in the underlying. */
+function checkQuotaLimit(args) {
+	const { token, requested, available, underlying } = args;
+	if (requested !== void 0 && requested <= available) return [];
+	return [quotaLimitReached({
+		token,
+		requested: requested === void 0 ? void 0 : amountOf(underlying, requested),
+		available: amountOf(underlying, available)
+	})];
+}
+//#endregion
+export { checkQuotaLimit };

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

@@ -0,0 +1,16 @@
+import { checkBorrowLimit } from "./checkBorrowLimit.js";
+import { checkCollateralised } from "./checkCollateralised.js";
+import { checkCreditAccountFrozen } from "./checkCreditAccountFrozen.js";
+import { checkCreditManagerPaused } from "./checkCreditManagerPaused.js";
+import { checkDebtLimits } from "./checkDebtLimits.js";
+import { checkEmergencyLiquidator } from "./checkEmergencyLiquidator.js";
+import { checkForbiddenToken } from "./checkForbiddenToken.js";
+import { checkLeverage } from "./checkLeverage.js";
+import { checkLiquidatorEligible } from "./checkLiquidatorEligible.js";
+import { checkMarketExpired } from "./checkMarketExpired.js";
+import { checkPoolLiquidity } from "./checkPoolLiquidity.js";
+import { checkPoolPaused } from "./checkPoolPaused.js";
+import { checkPoolSunset } from "./checkPoolSunset.js";
+import { checkQuotaCount } from "./checkQuotaCount.js";
+import { checkQuotaLimit } from "./checkQuotaLimit.js";
+export { checkBorrowLimit, checkCollateralised, checkCreditAccountFrozen, checkCreditManagerPaused, checkDebtLimits, checkEmergencyLiquidator, checkForbiddenToken, checkLeverage, checkLiquidatorEligible, checkMarketExpired, checkPoolLiquidity, checkPoolPaused, checkPoolSunset, checkQuotaCount, checkQuotaLimit };

package/dist/esm/onchain/validation/helpers/amount.js

@@ -0,0 +1,11 @@
+//#region src/onchain/validation/helpers/amount.ts
+/** A check names what a limit was measured in, never what it is worth. */
+function amountOf(token, value) {
+	return {
+		token,
+		value,
+		valueUsd: null
+	};
+}
+//#endregion
+export { amountOf };

package/dist/esm/onchain/validation/helpers/health-factor-limits.js

@@ -0,0 +1,21 @@
+//#region src/onchain/validation/helpers/health-factor-limits.ts
+/**
+* The health-factor thresholds this codebase holds an account to.
+*
+* They are deliberately different numbers for different jobs: the facade's is
+* what a transaction must clear to land, a form's is what makes a position
+* worth signing, and a sizing helper leaves a margin above both.
+**/
+/** A factor at or below this is refused; kept for the callers that size on it. */
+const MIN_HF_LIMITED = 10100n;
+/** The same threshold as a `required` argument — the lowest factor that passes. */
+const MIN_HEALTH_FACTOR_FORM = 10101;
+/** The threshold the facade itself enforces: an account may end exactly at 1.0. */
+const MIN_HEALTH_FACTOR_FACADE = 1e4;
+/**
+* The safe-price threshold a form holds an account to. A step above the
+* facade's, because a factor of exactly 1.0 at safe prices is already refused.
+**/
+const MIN_SAFE_HEALTH_FACTOR_FORM = 10001;
+//#endregion
+export { MIN_HEALTH_FACTOR_FACADE, MIN_HEALTH_FACTOR_FORM, MIN_HF_LIMITED, MIN_SAFE_HEALTH_FACTOR_FORM };

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

@@ -0,0 +1,4 @@
+import { amountOf } from "./amount.js";
+import { MIN_HEALTH_FACTOR_FACADE, MIN_HEALTH_FACTOR_FORM, MIN_HF_LIMITED, MIN_SAFE_HEALTH_FACTOR_FORM } from "./health-factor-limits.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, toToken, toTokenAmount };

package/dist/esm/onchain/validation/{token.js → helpers/token.js}

@@ -1,6 +1,6 @@
-import { shortAddress } from "../utils/formatter.js";
-import { amountOf } from "./checks.js";
-//#region src/onchain/validation/token.ts
+import { shortAddress } from "../../utils/formatter.js";
+import { amountOf } from "./amount.js";
+//#region src/onchain/validation/helpers/token.ts
 /**
 * The token behind an address, for the refusal details that inline one.
 *

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/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 { creditAccountNotEmpty, creditAccountNotFound, emptyOpenTakesNothing, 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, creditAccountNotEmpty, creditAccountNotFound, emptyOpenTakesNothing, 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,12 +1,12 @@
 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 { creditAccountNotEmpty, creditAccountNotFound, emptyOpenTakesNothing, noStrategyTargetCollateral, toRefusalError, unexpectedFailure } from "./errors.js";
 import { withdrawableCollaterals } from "./withdrawable-collaterals.js";
 import { isAddressEqual } from "viem";
 //#region src/sdk/prepare/PrepareApi.ts
@@ -39,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]);
@@ -53,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({
@@ -348,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
@@ -451,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,
@@ -503,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,
@@ -520,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,
@@ -552,7 +545,7 @@ function routed(result, at) {
 			delayed: delayed.delayed,
 			...at
 		},
-		refused,
+		errors,
 		...at
 	});
 }
@@ -578,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 { creditAccountNotEmpty, creditAccountNotFound, emptyOpenTakesNothing, 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, creditAccountNotEmpty, creditAccountNotFound, emptyOpenTakesNothing, 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