@gearbox-protocol/sdk 16.0.0-next.5 → 16.0.0-next.51

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

@@ -0,0 +1,27 @@
+import { shortAddress } from "../utils/formatter.js";
+import { amountOf } from "./checks.js";
+//#region src/onchain/validation/token.ts
+/**
+* The token behind an address, for the refusal details that inline one.
+*
+* A token the registry does not know falls back to its own shortened address
+* as a symbol and `decimals: 0` — an unknown token has no scale, and guessing
+* 18 would silently misformat every amount denominated in it.
+*/
+function toToken(sdk, address) {
+	const known = sdk.tokensMeta.getToken(address);
+	if (known) return known;
+	return {
+		chainId: sdk.chainId,
+		address,
+		symbol: shortAddress(address),
+		name: "",
+		decimals: 0
+	};
+}
+/** {@link toToken} plus an amount denominated in it. */
+function toTokenAmount(sdk, address, value) {
+	return amountOf(toToken(sdk, address), value);
+}
+//#endregion
+export { toToken, toTokenAmount };

package/dist/esm/preview/index.js

@@ -1,11 +1,10 @@
-import { UnsupportedZapperFunctionError } from "../onchain/market/zapper/errors.js";
+import { raise, refuse } from "../onchain/validation/refusal.js";
 import { TransferAlignmentError, UnexpectedFacadeEventOrderError, UnknownAdapterError, UnknownFacadeCallError, WithdrawCollateralAlignmentError } from "./trace/errors.js";
 import { extractAdapterCallTraces } from "./trace/extractAdapterCallTraces.js";
 import { extractTransfers } from "./trace/extractTransfers.js";
 import { findFacadeCalls } from "./trace/findFacadeCalls.js";
 import "./trace/index.js";
 import { classifyInnerOperations } from "./parse/classifyInnerOperations.js";
-import { UnsupportedPoolFunctionError, UnsupportedTargetError } from "./parse/errors.js";
 import { parseFacadeOperationCalldata } from "./parse/parseFacadeOperationCalldata.js";
 import { parsePoolOperationCalldata } from "./parse/parsePoolOperationCalldata.js";
 import { parseRWAFactoryOperationCalldata } from "./parse/parseRWAFactoryOperationCalldata.js";
@@ -18,17 +17,22 @@ import { BalancePrerequisite } from "./prerequisites/BalancePrerequisite.js";
 import { RWAOpenRequirementsPrerequisite } from "./prerequisites/RWAOpenRequirementsPrerequisite.js";
 import { checkPrerequisites } from "./prerequisites/checkPrerequisites.js";
 import "./prerequisites/index.js";
-import { buildDelayedPreview } from "./preview/buildDelayedPreview.js";
+import { buildDelayedStrategyPositionOperationPreview } from "./preview/buildDelayedStrategyPositionOperationPreview.js";
 import { CreditAccountState } from "./preview/CreditAccountState.js";
 import { classifyCloseOrRepay, isCloseOrRepay } from "./preview/detectCloseOrRepay.js";
 import { detectDelayedClaim, resolveDelayedClaimIntent } from "./preview/detectDelayedClaim.js";
 import { detectDelayedOperation } from "./preview/detectDelayedOperation.js";
-import { UnsupportedOperationError } from "./preview/errors.js";
+import { adapterCallOutsideBracketError, invalidTransactionValueError, malformedBracketError, nonAdapterCallInBracketError, unpreviewableAdapterCallError, unsupportedOutOfBracketCallError } from "./preview/errors.js";
+import { estimateClaimableAt } from "./preview/estimateClaimableAt.js";
 import { makeReplayState, replayInnerOperations } from "./preview/replayInnerOperations.js";
 import { replayMulticall } from "./preview/replayMulticall.js";
-import { previewAdjustCreditAccount } from "./preview/previewAdjustCreditAccount.js";
-import { previewCloseOrRepayCreditAccount } from "./preview/previewCloseOrRepayCreditAccount.js";
+import { previewAdjustStrategyPosition } from "./preview/previewAdjustStrategyPosition.js";
+import { previewExitOrRepayStrategyPosition } from "./preview/previewExitOrRepayStrategyPosition.js";
+import { asPreviewSimulationError } from "./simulate/errors.js";
 import { previewOperation } from "./preview/previewOperation.js";
 import "./preview/index.js";
 import "./types.js";
-export { AllowancePrerequisite, BalancePrerequisite, CreditAccountState, Prerequisite, RWAOpenRequirementsPrerequisite, TransferAlignmentError, UnexpectedFacadeEventOrderError, UnknownAdapterError, UnknownFacadeCallError, UnsupportedOperationError, UnsupportedPoolFunctionError, UnsupportedTargetError, UnsupportedZapperFunctionError, WithdrawCollateralAlignmentError, buildDelayedPreview, checkPrerequisites, classifyCloseOrRepay, classifyInnerOperations, detectDelayedClaim, detectDelayedOperation, extractAdapterCallTraces, extractTransfers, findFacadeCalls, isCloseOrRepay, isPoolOperation, isRWAOperation, makeReplayState, parseFacadeOperationCalldata, parseOperationCalldata, parsePoolOperationCalldata, parseRWAFactoryOperationCalldata, previewAdjustCreditAccount, previewCloseOrRepayCreditAccount, previewOperation, replayInnerOperations, replayMulticall, resolveDelayedClaimIntent };
+import { checkOperation, collateralIssue, marketIssues, quotaCountIssue } from "./validate/checkOperation.js";
+import { checkSimulation } from "./validate/checkSimulation.js";
+import "./validate/index.js";
+export { AllowancePrerequisite, BalancePrerequisite, CreditAccountState, Prerequisite, RWAOpenRequirementsPrerequisite, TransferAlignmentError, UnexpectedFacadeEventOrderError, UnknownAdapterError, UnknownFacadeCallError, WithdrawCollateralAlignmentError, adapterCallOutsideBracketError, asPreviewSimulationError, buildDelayedStrategyPositionOperationPreview, checkOperation, checkPrerequisites, checkSimulation, classifyCloseOrRepay, classifyInnerOperations, collateralIssue, detectDelayedClaim, detectDelayedOperation, estimateClaimableAt, extractAdapterCallTraces, extractTransfers, findFacadeCalls, invalidTransactionValueError, isCloseOrRepay, isPoolOperation, isRWAOperation, makeReplayState, malformedBracketError, marketIssues, nonAdapterCallInBracketError, parseFacadeOperationCalldata, parseOperationCalldata, parsePoolOperationCalldata, parseRWAFactoryOperationCalldata, previewAdjustStrategyPosition, previewExitOrRepayStrategyPosition, previewOperation, quotaCountIssue, raise, refuse, replayInnerOperations, replayMulticall, resolveDelayedClaimIntent, unpreviewableAdapterCallError, unsupportedOutOfBracketCallError };

package/dist/esm/preview/parse/errors.js

@@ -1,30 +1 @@
-import { UnsupportedZapperFunctionError } from "../../onchain/market/zapper/errors.js";
-import "../../onchain/index.js";
-//#region src/preview/parse/errors.ts
-/**
-* Thrown when the target of a transaction is neither a known Gearbox pool nor a
-* credit facade.
-*/
-var UnsupportedTargetError = class extends Error {
-	target;
-	constructor(target) {
-		super(`unsupported transaction target: ${target}`);
-		this.name = "UnsupportedTargetError";
-		this.target = target;
-	}
-};
-/**
-* Thrown when a pool call uses a function other than ERC4626 `deposit`/`redeem`.
-*/
-var UnsupportedPoolFunctionError = class extends Error {
-	pool;
-	functionName;
-	constructor(pool, functionName) {
-		super(`unsupported pool function "${functionName}" on ${pool}`);
-		this.name = "UnsupportedPoolFunctionError";
-		this.pool = pool;
-		this.functionName = functionName;
-	}
-};
-//#endregion
-export { UnsupportedPoolFunctionError, UnsupportedTargetError, UnsupportedZapperFunctionError };
+export {};

package/dist/esm/preview/parse/index.js

@@ -1,9 +1,8 @@
-import { UnsupportedZapperFunctionError } from "../../onchain/market/zapper/errors.js";
 import { classifyInnerOperations } from "./classifyInnerOperations.js";
-import { UnsupportedPoolFunctionError, UnsupportedTargetError } from "./errors.js";
+import "./errors.js";
 import { parseFacadeOperationCalldata } from "./parseFacadeOperationCalldata.js";
 import { parsePoolOperationCalldata } from "./parsePoolOperationCalldata.js";
 import { parseRWAFactoryOperationCalldata } from "./parseRWAFactoryOperationCalldata.js";
 import { parseOperationCalldata } from "./parseOperationCalldata.js";
 import { isPoolOperation, isRWAOperation } from "./types.js";
-export { UnsupportedPoolFunctionError, UnsupportedTargetError, UnsupportedZapperFunctionError, classifyInnerOperations, isPoolOperation, isRWAOperation, parseFacadeOperationCalldata, parseOperationCalldata, parsePoolOperationCalldata, parseRWAFactoryOperationCalldata };
+export { classifyInnerOperations, isPoolOperation, isRWAOperation, parseFacadeOperationCalldata, parseOperationCalldata, parsePoolOperationCalldata, parseRWAFactoryOperationCalldata };

package/dist/esm/preview/parse/parseOperationCalldata.js

@@ -1,9 +1,10 @@
 import { CreditFacadeV310Contract } from "../../onchain/market/credit/CreditFacadeV310Contract.js";
+import { isSDKError, sdkErr, sdkOk } from "../../model/result.js";
+import "../../model/index.js";
 import { PoolV310Contract } from "../../onchain/market/pool/PoolV310Contract.js";
 import { ZapperContract } from "../../onchain/market/zapper/ZapperContract.js";
 import { isRWAFactory } from "../../onchain/market/rwa/types.js";
 import "../../onchain/index.js";
-import { UnsupportedTargetError } from "./errors.js";
 import { parseFacadeOperationCalldata } from "./parseFacadeOperationCalldata.js";
 import { parsePoolOperationCalldata } from "./parsePoolOperationCalldata.js";
 import { parseRWAFactoryOperationCalldata } from "./parseRWAFactoryOperationCalldata.js";
@@ -19,19 +20,24 @@ function parseOperationCalldata(input) {
 	const contract = sdk.getContract(to);
 	if (contract instanceof PoolV310Contract) return parsePoolOperationCalldata(sdk, contract, calldata);
 	if (contract instanceof ZapperContract) {
-		const parsed = contract.parseOperation(calldata, value);
-		if (parsed.operation === "Deposit") return {
-			operation: "Deposit",
-			pool: parsed.pool,
-			receiver: parsed.receiver,
-			assets: parsed.assets,
-			underlying: parsed.underlying,
-			tokenIn: contract.tokenIn.addr,
-			tokenOut: contract.tokenOut.addr,
-			zapper: parsed.zapper,
-			referralCode: parsed.referralCode
-		};
-		return {
+		const answer = contract.parseOperation(calldata, value);
+		if (isSDKError(answer)) return answer;
+		const parsed = answer.data;
+		if (parsed.operation === "Deposit") {
+			const op = {
+				operation: "Deposit",
+				pool: parsed.pool,
+				receiver: parsed.receiver,
+				assets: parsed.assets,
+				underlying: parsed.underlying,
+				tokenIn: contract.tokenIn.addr,
+				tokenOut: contract.tokenOut.addr,
+				zapper: parsed.zapper,
+				referralCode: parsed.referralCode
+			};
+			return sdkOk(op);
+		}
+		const op = {
 			operation: "Redeem",
 			pool: parsed.pool,
 			receiver: parsed.receiver,
@@ -42,10 +48,15 @@ function parseOperationCalldata(input) {
 			tokenOut: contract.tokenIn.addr,
 			zapper: parsed.zapper
 		};
+		return sdkOk(op);
 	}
-	if (contract instanceof CreditFacadeV310Contract) return parseFacadeOperationCalldata(sdk, contract, calldata);
-	if (contract && isRWAFactory(contract)) return parseRWAFactoryOperationCalldata(sdk, contract, calldata);
-	throw new UnsupportedTargetError(to);
+	if (contract instanceof CreditFacadeV310Contract) return sdkOk(parseFacadeOperationCalldata(sdk, contract, calldata));
+	if (contract && isRWAFactory(contract)) return sdkOk(parseRWAFactoryOperationCalldata(sdk, contract, calldata));
+	return sdkErr({
+		code: "unsupportedTarget",
+		message: `unsupported transaction target: ${to}`,
+		target: to
+	});
 }
 //#endregion
 export { parseOperationCalldata };

package/dist/esm/preview/parse/parsePoolOperationCalldata.js

@@ -1,4 +1,5 @@
-import { UnsupportedPoolFunctionError } from "./errors.js";
+import { sdkErr, sdkOk } from "../../model/result.js";
+import "../../model/index.js";
 //#region src/preview/parse/parsePoolOperationCalldata.ts
 /**
 * Decodes pool calldata into a {@link PoolOperation}.
@@ -6,7 +7,7 @@ import { UnsupportedPoolFunctionError } from "./errors.js";
 * @param sdk - The SDK instance.
 * @param pool - The pool contract.
 * @param calldata - The calldata to parse.
-* @returns The parsed operation.
+* @returns The parsed operation behind `ok`, or the refusal.
 */
 function parsePoolOperationCalldata(sdk, pool, calldata) {
 	const parsed = sdk.parseFunctionDataV2(pool.address, calldata);
@@ -15,7 +16,7 @@ function parsePoolOperationCalldata(sdk, pool, calldata) {
 	const underlying = pool.underlying;
 	switch (functionName) {
 		case "deposit":
-		case "depositWithReferral": return {
+		case "depositWithReferral": return sdkOk({
 			operation: "Deposit",
 			pool: pool.address,
 			receiver: rawArgs.receiver,
@@ -25,9 +26,9 @@ function parsePoolOperationCalldata(sdk, pool, calldata) {
 			tokenOut: pool.address,
 			zapper: void 0,
 			referralCode: functionName === "depositWithReferral" ? rawArgs.referralCode : void 0
-		};
+		});
 		case "mint":
-		case "mintWithReferral": return {
+		case "mintWithReferral": return sdkOk({
 			operation: "Mint",
 			pool: pool.address,
 			receiver: rawArgs.receiver,
@@ -37,8 +38,8 @@ function parsePoolOperationCalldata(sdk, pool, calldata) {
 			tokenOut: pool.address,
 			zapper: void 0,
 			referralCode: functionName === "mintWithReferral" ? rawArgs.referralCode : void 0
-		};
-		case "withdraw": return {
+		});
+		case "withdraw": return sdkOk({
 			operation: "Withdraw",
 			pool: pool.address,
 			receiver: rawArgs.receiver,
@@ -48,8 +49,8 @@ function parsePoolOperationCalldata(sdk, pool, calldata) {
 			tokenIn: pool.address,
 			tokenOut: underlying,
 			zapper: void 0
-		};
-		case "redeem": return {
+		});
+		case "redeem": return sdkOk({
 			operation: "Redeem",
 			pool: pool.address,
 			receiver: rawArgs.receiver,
@@ -59,8 +60,13 @@ function parsePoolOperationCalldata(sdk, pool, calldata) {
 			tokenIn: pool.address,
 			tokenOut: underlying,
 			zapper: void 0
-		};
-		default: throw new UnsupportedPoolFunctionError(pool.address, parsed.functionName);
+		});
+		default: return sdkErr({
+			code: "unsupportedPoolFunction",
+			message: `unsupported pool function "${parsed.functionName}" on ${pool.address}`,
+			pool: pool.address,
+			functionName: parsed.functionName
+		});
 	}
 }
 //#endregion

package/dist/esm/preview/prerequisites/checkPrerequisites.js

@@ -1,3 +1,5 @@
+import { isSDKError, sdkOk } from "../../model/result.js";
+import "../../model/index.js";
 import { parseOperationCalldata } from "../parse/parseOperationCalldata.js";
 import "../parse/index.js";
 import { buildCollateralPrerequisites } from "./buildCollateralPrerequisites.js";
@@ -23,14 +25,15 @@ import { buildRWAPrerequisites } from "./buildRWAPrerequisites.js";
 async function checkPrerequisites(input, options) {
 	const { sdk, sender: wallet } = input;
 	const tx = parseOperationCalldata(input);
+	if (isSDKError(tx)) return tx;
 	const ctx = {
 		sdk,
 		wallet,
 		blockNumber: options?.blockNumber,
 		value: input.value ?? 0n
 	};
-	const prereqs = await buildPrerequisites(tx, ctx);
-	return Promise.all(prereqs.map((p) => p.verify(ctx)));
+	const prereqs = await buildPrerequisites(tx.data, ctx);
+	return sdkOk(await Promise.all(prereqs.map((p) => p.verify(ctx))));
 }
 /**
 * Dispatches a parsed operation to the per-operation-family prerequisite

package/dist/esm/preview/preview/{buildDelayedPreview.js → buildDelayedStrategyPositionOperationPreview.js}

@@ -1,24 +1,24 @@
 import { AssetsMap } from "../../onchain/utils/AssetsMap.js";
 import { BigIntMath } from "../../onchain/utils/bigint-math.js";
 import { DUST_THRESHOLD } from "../../onchain/constants/math.js";
-import { calcPositionLeverage } from "../../onchain/market/math.js";
-import { ERROR_UNPRICEABLE_TOKEN } from "../../model/previews.js";
+import { asEstimated } from "../../model/previews.js";
 import "../../model/index.js";
+import { unpriceableTokenError } from "../../onchain/market/oracle/errors.js";
 import "../../onchain/index.js";
-import "../../common-utils/index.js";
 import { isAddressEqual } from "viem";
-//#region src/preview/preview/buildDelayedPreview.ts
+//#region src/preview/preview/buildDelayedStrategyPositionOperationPreview.ts
 /**
 * Builds the best-effort preview of the account state after the detected
 * delayed withdrawal is claimed and its intent (if any) is resumed:
 * the claim itself followed by the intent-specific tail
 *
 * Pure function: the input states are never mutated and no network access is performed.
-* Swaps are estimated with the injected conversion; tokens it cannot price contribute
-* nothing and set a non-fatal `ERROR_UNPRICEABLE_TOKEN` error on the
+* Swaps are estimated with the injected conversion; remaining holdings are
+* priced by `MarketSuite.valueInUnderlying`. Tokens that cannot be priced
+* contribute nothing and set a non-fatal `unpriceableToken` warning on the
 * preview.
 *
-* The changes (e.g. `debtChange`) are reported relative to the account
+* The changes (e.g. `totalDebtChange`) are reported relative to the account
 * state before the whole transaction.
 *
 * @param afterInstant - Account state after the instant part of the
@@ -30,7 +30,7 @@ import { isAddressEqual } from "viem";
 * @param sdk - Market data source for the position metrics of the resulting
 * state; read synchronously, no network access.
 */
-function buildDelayedPreview(afterInstant, before, detected, convert, receivedToken, sdk) {
+function buildDelayedStrategyPositionOperationPreview(afterInstant, before, detected, convert, receivedToken, sdk) {
 	const { request, intent } = detected;
 	const post = afterInstant.clone();
 	const converter = makeSafeConverter(convert);
@@ -46,21 +46,18 @@ function buildDelayedPreview(afterInstant, before, detected, convert, receivedTo
 	return buildAdjustPreview(post, before, collateralWithdrawn, converter, sdk);
 }
 function makeSafeConverter(convert) {
-	let error;
+	let warning;
 	return {
 		convert: (token, to, amount) => {
 			try {
 				return convert(token, to, amount);
 			} catch {
-				error ??= {
-					code: ERROR_UNPRICEABLE_TOKEN,
-					message: `cannot price token ${token}`
-				};
+				warning ??= unpriceableTokenError(token);
 				return 0n;
 			}
 		},
-		get error() {
-			return error;
+		get warning() {
+			return warning;
 		}
 	};
 }
@@ -150,64 +147,54 @@ function repayFromClaim(post, claimToken, convert, amount) {
 	post.repay(received);
 }
 /**
-* Oracle estimate of the account's total value in the underlying, ignoring
-* balances at or below `dust`.
-*/
-function totalValueInUnderlying(post, convert, dust) {
-	return post.balances.sum((token, balance) => balance > dust ? convert(token, post.underlying, balance) : 0n);
-}
-/**
 * `CLOSE_ACCOUNT` operation tail: everything is swapped into the
 * underlying, the debt is repaid in full and the remainder is withdrawn to
 * the user as `receivedToken`.
 */
 function buildClosePreview(post, converter, receivedToken, sdk) {
-	const totalValue = totalValueInUnderlying(post, converter.convert, 0n);
-	const oracle = sdk.marketRegister.findByCreditManager(post.creditManager).priceOracle;
+	const market = sdk.marketRegister.findByCreditManager(post.creditManager);
+	const priced = market.valueInUnderlying(post.balances.toAssets(), 0n);
+	const oracle = market.priceOracle;
+	const suite = sdk.marketRegister.findCreditManager(post.creditManager);
 	return {
 		operation: "CloseCreditAccount",
 		permanent: false,
-		creditManager: post.creditManager,
-		name: sdk.marketRegister.findCreditManager(post.creditManager).name,
+		...asEstimated(sdk.positions.projection({
+			creditManager: post.creditManager,
+			assets: [],
+			quotas: [],
+			totalDebt: 0n,
+			totalValue: 0n
+		}, { availableLiquidityChange: post.totalDebt })),
 		creditAccount: post.creditAccount,
-		receivedAmount: oracle.toTokenAmount(receivedToken, BigIntMath.max(totalValue - post.totalDebt, 0n)),
-		error: converter.error
+		name: suite.accountStrategyName(post.creditAccount),
+		targetCollateral: suite.accountTargetCollateral(post.creditAccount),
+		receivedAmount: oracle.toTokenAmount(receivedToken, BigIntMath.max(priced.value - post.totalDebt, 0n)),
+		warning: converter.warning ?? (priced.unpriceable ? unpriceableTokenError(priced.unpriceable) : void 0)
 	};
 }
 function buildAdjustPreview(post, before, collateralWithdrawn, converter, sdk) {
-	const totalValue = totalValueInUnderlying(post, converter.convert, DUST_THRESHOLD);
-	const assets = post.balances.toAssets(DUST_THRESHOLD);
-	const quotas = post.quotas.toAssets(0n);
-	const snap = post.toSnapshot(totalValue);
 	const market = sdk.marketRegister.findByCreditManager(post.creditManager);
+	const priced = market.valueInUnderlying(post.balances.toAssets());
+	const snap = post.toSnapshot(priced.value);
+	const suite = sdk.marketRegister.findCreditManager(post.creditManager);
 	const oracle = market.priceOracle;
 	return {
 		operation: "AdjustCreditAccount",
-		creditManager: post.creditManager,
-		name: sdk.marketRegister.findCreditManager(post.creditManager).name,
+		...asEstimated(sdk.positions.projection(snap, { availableLiquidityChange: before.totalDebt - post.totalDebt })),
 		creditAccount: post.creditAccount,
+		name: suite.accountStrategyName(post.creditAccount),
+		targetCollateral: suite.accountTargetCollateral(post.creditAccount),
 		collateralAdded: [],
 		collateralWithdrawn: collateralWithdrawn.toAssets().map((a) => oracle.toTokenAmount(a.token, a.balance)),
-		totalValue,
-		debt: post.totalDebt,
-		debtChange: post.totalDebt - before.totalDebt,
-		quotas: quotas.map((q) => ({
-			token: sdk.tokensMeta.mustGetToken(q.token),
-			...oracle.toAmount(market.underlying, q.balance)
-		})),
+		totalDebtChange: market.toUnderlyingAmount(post.totalDebt - before.totalDebt),
 		quotasChange: post.quotas.difference(before.quotas).toAssets().map((q) => ({
 			token: sdk.tokensMeta.mustGetToken(q.token),
 			...oracle.toAmount(market.underlying, q.balance)
 		})),
-		assets: assets.map((a) => oracle.toTokenAmount(a.token, a.balance)),
 		assetsChange: post.balances.difference(before.balances).toAssets(DUST_THRESHOLD).map((a) => oracle.toTokenAmount(a.token, a.balance)),
-		error: converter.error,
-		healthFactor: sdk.positions.healthFactor(snap),
-		borrowRate: sdk.positions.borrowRate(snap, { availableLiquidityChange: before.totalDebt - post.totalDebt }),
-		timeToLiquidation: sdk.positions.timeToLiquidation(snap, { availableLiquidityChange: before.totalDebt - post.totalDebt }),
-		liquidationPrice: sdk.positions.liquidationPrice(snap),
-		leverage: calcPositionLeverage(totalValue, post.totalDebt)
+		warning: converter.warning ?? (priced.unpriceable ? unpriceableTokenError(priced.unpriceable) : void 0)
 	};
 }
 //#endregion
-export { buildDelayedPreview };
+export { buildDelayedStrategyPositionOperationPreview };

package/dist/esm/preview/preview/detectDelayedClaim.js

@@ -1,4 +1,6 @@
 import { AbstractAdapterContract } from "../../onchain/market/adapters/contracts/AbstractAdapter.js";
+import { sdkOk } from "../../model/result.js";
+import "../../model/index.js";
 import "../../onchain/index.js";
 //#region src/preview/preview/detectDelayedClaim.ts
 /**
@@ -29,16 +31,16 @@ function detectDelayedClaim(sdk, multicall) {
 * @param sdk - Attached SDK.
 * @param multicall - Parsed inner operations of the multicall.
 * @param blockNumber - Optional block number to read the log at.
-* @returns The decoded intent, or `undefined` when the multicall claims
-* nothing, the redemption logger is not deployed, or the log carries no
-* intent.
-* @throws InvalidDelayedIntentError when the logged `extraData` is non-empty
-* but cannot be decoded as a `DelayedIntent`.
+* @returns The decoded intent behind `ok` (`undefined` when the multicall
+* claims nothing, the redemption logger is not deployed, or the log carries
+* no intent), or the `invalidDelayedIntent` refusal when the logged
+* `extraData` is non-empty but cannot be decoded as a `DelayedIntent`.
 */
 async function resolveDelayedClaimIntent(sdk, multicall, blockNumber) {
 	const claim = detectDelayedClaim(sdk, multicall);
-	if (!claim) return;
-	return sdk.redemptionLogger?.getDelayedIntent(claim.redeemer, blockNumber);
+	const logger = sdk.redemptionLogger;
+	if (!claim || !logger) return sdkOk(void 0);
+	return logger.getDelayedIntent(claim.redeemer, blockNumber);
 }
 //#endregion
 export { detectDelayedClaim, resolveDelayedClaimIntent };

package/dist/esm/preview/preview/detectDelayedOperation.js

@@ -1,6 +1,7 @@
 import { AbstractAdapterContract } from "../../onchain/market/adapters/contracts/AbstractAdapter.js";
+import { sdkErr, sdkOk } from "../../model/result.js";
+import "../../model/index.js";
 import { decodeDelayedIntent } from "../../onchain/accounts/withdrawal-compressor/intent-codec.js";
-import { InvalidDelayedIntentError } from "../../onchain/accounts/withdrawal-compressor/errors.js";
 import "../../onchain/index.js";
 import { isAddressEqual } from "viem";
 //#region src/preview/preview/detectDelayedOperation.ts
@@ -35,13 +36,19 @@ function detectDelayedOperation(sdk, multicall) {
 		if (request.extraData && request.extraData !== "0x") try {
 			intent = decodeDelayedIntent(request.extraData);
 		} catch (e) {
-			throw new InvalidDelayedIntentError(request.extraData, e);
+			return sdkErr({
+				code: "invalidDelayedIntent",
+				message: `cannot decode delayed intent from extraData ${request.extraData}`,
+				extraData: request.extraData,
+				cause: e instanceof Error ? e : new Error(String(e))
+			});
 		}
-		return {
+		return sdkOk({
 			request,
 			intent
-		};
+		});
 	}
+	return sdkOk(void 0);
 }
 //#endregion
 export { detectDelayedOperation };

package/dist/esm/preview/preview/errors.js

@@ -1,16 +1,79 @@
 //#region src/preview/preview/errors.ts
-/**
-* Thrown by `previewOperation` for parsed operations it cannot preview yet.
-* Currently only pool operations and credit account opening are supported.
-*/
-var UnsupportedOperationError = class extends Error {
-	/** The parsed operation kind (the `operation` discriminant). */
-	operation;
-	constructor(operation) {
-		super(`operation "${operation}" is not supported by previewOperation`);
-		this.name = "UnsupportedOperationError";
-		this.operation = operation;
-	}
+const MALFORMED_BRACKET_MESSAGE = {
+	nested: "nested storeExpectedBalances/compareBalances bracket",
+	unmatchedCompare: "compareBalances without a preceding storeExpectedBalances",
+	unmatchedStore: "storeExpectedBalances without a matching compareBalances"
 };
+/**
+* Builds a {@link MalformedBracketError} for the given bracket invariant.
+**/
+function malformedBracketError(kind) {
+	return {
+		code: "malformedBracket",
+		message: MALFORMED_BRACKET_MESSAGE[kind],
+		kind
+	};
+}
+/**
+* Builds an {@link AdapterCallOutsideBracketError} for `adapter`.
+**/
+function adapterCallOutsideBracketError(adapter) {
+	return {
+		code: "adapterCallOutsideBracket",
+		message: `call to ${adapter} outside of a storeExpectedBalances/compareBalances bracket`,
+		adapter
+	};
+}
+/**
+* Builds a {@link NonAdapterCallInBracketError} for `target`.
+**/
+function nonAdapterCallInBracketError(target) {
+	return {
+		code: "nonAdapterCallInBracket",
+		message: `call to ${target} between storeExpectedBalances and compareBalances is not an adapter call`,
+		target
+	};
+}
+function asCause(cause) {
+	return cause instanceof Error ? cause : new Error(String(cause));
+}
+/**
+* Builds an {@link UnpreviewableAdapterCallError} for a bracketed adapter
+* call that could not be replayed.
+**/
+function unpreviewableAdapterCallError(adapter, cause) {
+	const err = asCause(cause);
+	return {
+		code: "unpreviewableAdapterCall",
+		message: err.message,
+		adapter,
+		cause: err
+	};
+}
+/**
+* Builds an {@link UnsupportedOutOfBracketCallError} for an allowed
+* out-of-bracket adapter call that could not be replayed.
+**/
+function unsupportedOutOfBracketCallError(adapter, cause) {
+	const err = asCause(cause);
+	return {
+		code: "unsupportedOutOfBracketCall",
+		message: err.message,
+		adapter,
+		cause: err
+	};
+}
+/**
+* Builds an {@link InvalidTransactionValueError} when `msg.value` does not
+* fit into the declared WETH collateral.
+**/
+function invalidTransactionValueError(value, wethCollateral) {
+	return {
+		code: "invalidTransactionValue",
+		message: `transaction value ${value} exceeds WETH collateral ${wethCollateral}`,
+		value,
+		wethCollateral
+	};
+}
 //#endregion
-export { UnsupportedOperationError };
+export { adapterCallOutsideBracketError, invalidTransactionValueError, malformedBracketError, nonAdapterCallInBracketError, unpreviewableAdapterCallError, unsupportedOutOfBracketCallError };

package/dist/esm/preview/preview/estimateClaimableAt.js

@@ -0,0 +1,20 @@
+import { isAddressEqual } from "viem";
+//#region src/preview/preview/estimateClaimableAt.ts
+/**
+* Estimates when a newly requested delayed withdrawal becomes claimable:
+* `now + withdrawalLength` of the cached withdrawable asset whose phantom
+* token matches `phantomToken`. Same formula as
+* `getWithdrawalRequestResult().claimableAt`.
+*
+* Returns `undefined` when the withdrawal compressor is missing, its assets
+* cache is not loaded, or no asset matches the phantom token.
+*/
+function estimateClaimableAt(sdk, phantomToken) {
+	const compressor = sdk.withdrawalCompressor;
+	if (!compressor?.state) return;
+	const asset = compressor.getWithdrawableAssets().find((a) => isAddressEqual(a.withdrawalPhantomToken, phantomToken));
+	if (!asset) return;
+	return Math.floor(Date.now() / 1e3) + Number(asset.withdrawalLength);
+}
+//#endregion
+export { estimateClaimableAt };

package/dist/esm/preview/preview/index.js

@@ -1,12 +1,13 @@
-import { buildDelayedPreview } from "./buildDelayedPreview.js";
+import { buildDelayedStrategyPositionOperationPreview } from "./buildDelayedStrategyPositionOperationPreview.js";
 import { CreditAccountState } from "./CreditAccountState.js";
 import { classifyCloseOrRepay, isCloseOrRepay } from "./detectCloseOrRepay.js";
 import { detectDelayedClaim, resolveDelayedClaimIntent } from "./detectDelayedClaim.js";
 import { detectDelayedOperation } from "./detectDelayedOperation.js";
-import { UnsupportedOperationError } from "./errors.js";
+import { adapterCallOutsideBracketError, invalidTransactionValueError, malformedBracketError, nonAdapterCallInBracketError, unpreviewableAdapterCallError, unsupportedOutOfBracketCallError } from "./errors.js";
+import { estimateClaimableAt } from "./estimateClaimableAt.js";
 import { makeReplayState, replayInnerOperations } from "./replayInnerOperations.js";
 import { replayMulticall } from "./replayMulticall.js";
-import { previewAdjustCreditAccount } from "./previewAdjustCreditAccount.js";
-import { previewCloseOrRepayCreditAccount } from "./previewCloseOrRepayCreditAccount.js";
+import { previewAdjustStrategyPosition } from "./previewAdjustStrategyPosition.js";
+import { previewExitOrRepayStrategyPosition } from "./previewExitOrRepayStrategyPosition.js";
 import { previewOperation } from "./previewOperation.js";
-export { CreditAccountState, UnsupportedOperationError, buildDelayedPreview, classifyCloseOrRepay, detectDelayedClaim, detectDelayedOperation, isCloseOrRepay, makeReplayState, previewAdjustCreditAccount, previewCloseOrRepayCreditAccount, previewOperation, replayInnerOperations, replayMulticall, resolveDelayedClaimIntent };
+export { CreditAccountState, adapterCallOutsideBracketError, buildDelayedStrategyPositionOperationPreview, classifyCloseOrRepay, detectDelayedClaim, detectDelayedOperation, estimateClaimableAt, invalidTransactionValueError, isCloseOrRepay, makeReplayState, malformedBracketError, nonAdapterCallInBracketError, previewAdjustStrategyPosition, previewExitOrRepayStrategyPosition, previewOperation, replayInnerOperations, replayMulticall, resolveDelayedClaimIntent, unpreviewableAdapterCallError, unsupportedOutOfBracketCallError };