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

package/dist/cjs/preview/preview/previewAdjustStrategyPosition.js

@@ -0,0 +1,49 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_onchain_constants_address_provider = require("../../onchain/constants/address-provider.js");
+const require_onchain_constants_math = require("../../onchain/constants/math.js");
+const require_model_previews = require("../../model/previews.js");
+require("../../model/index.js");
+require("../../onchain/index.js");
+const require_preview_preview_replayMulticall = require("./replayMulticall.js");
+const require_preview_preview_unwrapNativeCollateral = require("./unwrapNativeCollateral.js");
+//#region src/preview/preview/previewAdjustStrategyPosition.ts
+/**
+* Previews a `multicall`/`botMulticall` operation on an existing credit
+* account: threads the multicall through {@link replayMulticall} over the
+* pre-resolved account state (`options.creditAccount`) and reports the
+* minimal guaranteed post-state alongside the changes relative to the
+* pre-state.
+*/
+function previewAdjustStrategyPosition(input, operation, options) {
+	const { sdk, value = 0n } = input;
+	const market = sdk.marketRegister.findByCreditManager(operation.creditManager);
+	const suite = sdk.marketRegister.findCreditManager(operation.creditManager);
+	const oracle = market.priceOracle;
+	const { before, after, warning: replayWarning } = require_preview_preview_replayMulticall.replayMulticall(sdk, operation, options);
+	const account = after.account;
+	let warning = replayWarning;
+	const { assets: collateralAdded, warning: unwrapWarning } = require_preview_preview_unwrapNativeCollateral.unwrapNativeCollateral(after.collateralAdded.toAssets(), value, sdk.addressProvider.getAddress(require_onchain_constants_address_provider.AP_WETH_TOKEN, 0));
+	warning ??= unwrapWarning;
+	const assetsChange = account.balances.difference(before.balances).toAssets(require_onchain_constants_math.DUST_THRESHOLD);
+	const priced = oracle.safeConvertAssets(account.balances.toAssets(), market.underlying);
+	warning ??= priced.error;
+	const snap = account.toSnapshot(priced.value);
+	return {
+		operation: "AdjustCreditAccount",
+		...require_model_previews.asEstimated(sdk.positions.projection(snap, { availableLiquidityChange: before.totalDebt - account.totalDebt })),
+		creditAccount: operation.creditAccount,
+		name: suite.accountStrategyName(operation.creditAccount),
+		targetCollateral: suite.accountTargetCollateral(operation.creditAccount),
+		collateralAdded: collateralAdded.map((a) => oracle.toTokenAmount(a.token, a.balance)),
+		collateralWithdrawn: after.collateralWithdrawn.toAssets().map((a) => oracle.toTokenAmount(a.token, a.balance)),
+		totalDebtChange: market.toUnderlyingAmount(account.totalDebt - before.totalDebt),
+		quotasChange: account.quotas.difference(before.quotas).toAssets().map((q) => ({
+			token: sdk.tokensMeta.mustGetToken(q.token),
+			...oracle.toAmount(market.underlying, q.balance)
+		})),
+		assetsChange: assetsChange.map((a) => oracle.toTokenAmount(a.token, a.balance)),
+		warning
+	};
+}
+//#endregion
+exports.previewAdjustStrategyPosition = previewAdjustStrategyPosition;

package/dist/cjs/preview/preview/{previewCloseOrRepayCreditAccount.js → previewExitOrRepayStrategyPosition.js}

@@ -1,18 +1,20 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_onchain_constants_address_provider = require("../../onchain/constants/address-provider.js");
 require("../../onchain/constants/math.js");
+const require_model_previews = require("../../model/previews.js");
+require("../../model/index.js");
 require("../../onchain/index.js");
 const require_preview_preview_detectCloseOrRepay = require("./detectCloseOrRepay.js");
 const require_preview_preview_replayMulticall = require("./replayMulticall.js");
 const require_preview_preview_unwrapNativeCollateral = require("./unwrapNativeCollateral.js");
-//#region src/preview/preview/previewCloseOrRepayCreditAccount.ts
-async function previewCloseOrRepayCreditAccount(input, operation, permanent, options) {
+//#region src/preview/preview/previewExitOrRepayStrategyPosition.ts
+function previewExitOrRepayStrategyPosition(input, operation, permanent, options) {
 	const { sdk } = input;
 	const market = sdk.marketRegister.findByCreditManager(operation.creditManager);
 	const exitTokens = [market.underlying];
 	const meta = sdk.tokensMeta.get(market.underlying);
 	if (meta && sdk.tokensMeta.isRWAUnderlying(meta)) exitTokens.push(meta.asset);
-	const replay = await require_preview_preview_replayMulticall.replayMulticall(sdk, operation, options);
+	const replay = require_preview_preview_replayMulticall.replayMulticall(sdk, operation, options);
 	return require_preview_preview_detectCloseOrRepay.classifyCloseOrRepay(operation.multicall, exitTokens) === "close" ? previewCloseCreditAccount(input, operation, permanent, replay) : previewRepayCreditAccount(input, operation, permanent, replay);
 }
 /**
@@ -23,7 +25,12 @@ async function previewCloseOrRepayCreditAccount(input, operation, permanent, opt
 function previewCloseCreditAccount(input, operation, permanent, replay) {
 	const { sdk } = input;
 	const market = sdk.marketRegister.findByCreditManager(operation.creditManager);
-	const { after, error } = replay;
+	const { before, after, warning: replayWarning } = replay;
+	const account = after.account;
+	let warning = replayWarning;
+	const priced = market.priceOracle.safeConvertAssets(account.balances.toAssets(), market.underlying);
+	warning ??= priced.error;
+	const suite = sdk.marketRegister.findCreditManager(operation.creditManager);
 	let receivedToken = market.underlying;
 	for (const m of operation.multicall) if (m.operation === "WithdrawCollateral" && m.amount === 115792089237316195423570985008687907853269984665640564039457584007913129639935n) {
 		receivedToken = m.token;
@@ -32,11 +39,12 @@ function previewCloseCreditAccount(input, operation, permanent, replay) {
 	return {
 		operation: "CloseCreditAccount",
 		permanent,
-		creditManager: operation.creditManager,
-		name: sdk.marketRegister.findCreditManager(operation.creditManager).name,
+		...require_model_previews.asEstimated(sdk.positions.projection(account.toSnapshot(priced.value), { availableLiquidityChange: before.totalDebt - account.totalDebt })),
 		creditAccount: operation.creditAccount,
+		name: suite.accountStrategyName(operation.creditAccount),
+		targetCollateral: suite.accountTargetCollateral(operation.creditAccount),
 		receivedAmount: market.priceOracle.toTokenAmount(receivedToken, after.collateralWithdrawn.getOrZero(receivedToken)),
-		error
+		warning
 	};
 }
 /**
@@ -47,20 +55,25 @@ function previewCloseCreditAccount(input, operation, permanent, replay) {
 function previewRepayCreditAccount(input, operation, permanent, replay) {
 	const { sdk, value = 0n } = input;
 	const market = sdk.marketRegister.findByCreditManager(operation.creditManager);
-	const { before, after, error: replayError } = replay;
-	const { assets: collateralAdded, error: unwrapError } = require_preview_preview_unwrapNativeCollateral.unwrapNativeCollateral(after.collateralAdded.toAssets(), value, sdk.addressProvider.getAddress(require_onchain_constants_address_provider.AP_WETH_TOKEN, 0));
-	const error = replayError ?? unwrapError;
+	const { before, after, warning: replayWarning } = replay;
+	const account = after.account;
+	const { assets: collateralAdded, warning: unwrapWarning } = require_preview_preview_unwrapNativeCollateral.unwrapNativeCollateral(after.collateralAdded.toAssets(), value, sdk.addressProvider.getAddress(require_onchain_constants_address_provider.AP_WETH_TOKEN, 0));
+	let warning = replayWarning ?? unwrapWarning;
+	const priced = market.priceOracle.safeConvertAssets(account.balances.toAssets(), market.underlying);
+	warning ??= priced.error;
+	const suite = sdk.marketRegister.findCreditManager(operation.creditManager);
 	return {
 		operation: "RepayCreditAccount",
 		permanent,
-		creditManager: operation.creditManager,
-		name: sdk.marketRegister.findCreditManager(operation.creditManager).name,
+		...require_model_previews.asEstimated(sdk.positions.projection(account.toSnapshot(priced.value), { availableLiquidityChange: before.totalDebt - account.totalDebt })),
 		creditAccount: operation.creditAccount,
+		name: suite.accountStrategyName(operation.creditAccount),
+		targetCollateral: suite.accountTargetCollateral(operation.creditAccount),
 		collateralAdded: collateralAdded.map((a) => market.priceOracle.toTokenAmount(a.token, a.balance)),
-		debtRepaid: before.totalDebt - after.account.totalDebt,
+		debtRepaid: market.toUnderlyingAmount(before.totalDebt - account.totalDebt),
 		collateralWithdrawn: after.collateralWithdrawn.toAssets().map((a) => market.priceOracle.toTokenAmount(a.token, a.balance)),
-		error
+		warning
 	};
 }
 //#endregion
-exports.previewCloseOrRepayCreditAccount = previewCloseOrRepayCreditAccount;
+exports.previewExitOrRepayStrategyPosition = previewExitOrRepayStrategyPosition;

package/dist/cjs/preview/preview/previewOpenStrategyPosition.js

@@ -0,0 +1,50 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_onchain_constants_address_provider = require("../../onchain/constants/address-provider.js");
+const require_model_previews = require("../../model/previews.js");
+require("../../model/index.js");
+require("../../onchain/index.js");
+const require_preview_preview_CreditAccountState = require("./CreditAccountState.js");
+const require_preview_preview_replayInnerOperations = require("./replayInnerOperations.js");
+const require_preview_preview_unwrapNativeCollateral = require("./unwrapNativeCollateral.js");
+//#region src/preview/preview/previewOpenStrategyPosition.ts
+function previewOpenStrategyPosition(input, operation) {
+	const { sdk, value = 0n } = input;
+	const market = sdk.marketRegister.findByCreditManager(operation.creditManager);
+	const oracle = market.priceOracle;
+	const state = require_preview_preview_replayInnerOperations.makeReplayState(require_preview_preview_CreditAccountState.CreditAccountState.beforeOpen(operation.creditManager, market.underlying));
+	let warning = require_preview_preview_replayInnerOperations.replayInnerOperations(sdk, operation.multicall, state);
+	const account = state.account;
+	let priceWarning;
+	const netValue = state.collateralAdded.sum((token, balance) => {
+		const priced = oracle.safeConvert(token, market.underlying, balance);
+		priceWarning ??= priced.error;
+		return priced.value;
+	});
+	const { assets: collateral, warning: unwrapWarning } = require_preview_preview_unwrapNativeCollateral.unwrapNativeCollateral(state.collateralAdded.toAssets(), value, sdk.addressProvider.getAddress(require_onchain_constants_address_provider.AP_WETH_TOKEN, 0));
+	warning ??= unwrapWarning ?? priceWarning;
+	const snap = account.toSnapshot(netValue + account.totalDebt);
+	const targetAsset = inferTargetAsset(operation.multicall, account.balances);
+	return {
+		operation: operation.operation,
+		...require_model_previews.asEstimated(sdk.positions.projection(snap, { availableLiquidityChange: -account.totalDebt })),
+		targetCollateral: targetAsset ? oracle.toTokenAmount(targetAsset.token, targetAsset.balance) : void 0,
+		collateralAdded: collateral.map((a) => oracle.toTokenAmount(a.token, a.balance)),
+		warning
+	};
+}
+/**
+* Infers the strategy target token of an account opening: the first quoted
+* token (first `UpdateQuota` with a positive change), with its balance taken
+* from the computed assets. Returns `undefined` when nothing is quoted.
+*/
+function inferTargetAsset(multicall, balances) {
+	for (const op of multicall) if (op.operation === "UpdateQuota" && op.change > 0n) {
+		const balance = balances.get(op.token);
+		return balance ? {
+			token: op.token,
+			balance
+		} : void 0;
+	}
+}
+//#endregion
+exports.previewOpenStrategyPosition = previewOpenStrategyPosition;

package/dist/cjs/preview/preview/previewOperation.js

@@ -1,34 +1,50 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_model_result = require("../../model/result.js");
+require("../../model/index.js");
 const require_preview_parse_parseOperationCalldata = require("../parse/parseOperationCalldata.js");
 const require_preview_parse_types = require("../parse/types.js");
 require("../parse/index.js");
-const require_preview_preview_buildDelayedPreview = require("./buildDelayedPreview.js");
+const require_preview_preview_buildDelayedStrategyPositionOperationPreview = require("./buildDelayedStrategyPositionOperationPreview.js");
 const require_preview_preview_detectCloseOrRepay = require("./detectCloseOrRepay.js");
 const require_preview_preview_detectDelayedClaim = require("./detectDelayedClaim.js");
 const require_preview_preview_detectDelayedOperation = require("./detectDelayedOperation.js");
-const require_preview_preview_errors = require("./errors.js");
+const require_preview_preview_estimateClaimableAt = require("./estimateClaimableAt.js");
 const require_preview_preview_replayMulticall = require("./replayMulticall.js");
-const require_preview_preview_previewAdjustCreditAccount = require("./previewAdjustCreditAccount.js");
-const require_preview_preview_previewCloseOrRepayCreditAccount = require("./previewCloseOrRepayCreditAccount.js");
-const require_preview_preview_previewOpenCreditAccount = require("./previewOpenCreditAccount.js");
-const require_preview_preview_previewPoolOperation = require("./previewPoolOperation.js");
+const require_preview_preview_previewAdjustStrategyPosition = require("./previewAdjustStrategyPosition.js");
+const require_preview_preview_previewExitOrRepayStrategyPosition = require("./previewExitOrRepayStrategyPosition.js");
+const require_preview_preview_previewOpenStrategyPosition = require("./previewOpenStrategyPosition.js");
+const require_preview_preview_previewPoolPositionOperation = require("./previewPoolPositionOperation.js");
 //#region src/preview/preview/previewOperation.ts
 /**
 * Previews a raw operation calldata: decodes it into a typed operation and
 * assembles an operation-specific, human-displayable preview.
+*
+* Answers an {@link SDKReturn} envelope: the preview behind `ok: true`, or —
+* when the transaction is one the previewer refuses to read — a
+* {@link PreviewOperationError} behind `ok: false`. A thrown exception
+* still means the SDK could not do its job (a read failed, the targeted
+* credit account could not be resolved), not a refusal of the transaction.
 */
 async function previewOperation(input, options) {
-	const operation = require_preview_parse_parseOperationCalldata.parseOperationCalldata(input);
-	if (require_preview_parse_types.isPoolOperation(operation)) return require_preview_preview_previewPoolOperation.previewPoolOperation(input, operation, options);
-	if (operation.operation === "OpenCreditAccount" || operation.operation === "RWAOpenCreditAccount") return require_preview_preview_previewOpenCreditAccount.previewOpenCreditAccount(input, operation);
+	const parsed = require_preview_parse_parseOperationCalldata.parseOperationCalldata(input);
+	if (require_model_result.isSDKError(parsed)) return parsed;
+	const operation = parsed.data;
+	if (require_preview_parse_types.isPoolOperation(operation)) return require_preview_preview_previewPoolPositionOperation.previewPoolPositionOperation(input, operation, options);
+	if (operation.operation === "OpenCreditAccount" || operation.operation === "RWAOpenCreditAccount") return require_model_result.sdkOk(await require_preview_preview_previewOpenStrategyPosition.previewOpenStrategyPosition(input, operation));
 	if (operation.operation === "CloseCreditAccount") {
 		const resolved = await resolveCreditAccount(input, operation, options);
-		const preview = await require_preview_preview_previewCloseOrRepayCreditAccount.previewCloseOrRepayCreditAccount(input, operation, true, resolved);
-		preview.intent = await require_preview_preview_detectDelayedClaim.resolveDelayedClaimIntent(input.sdk, operation.multicall, options?.blockNumber);
-		return preview;
+		const preview = require_preview_preview_previewExitOrRepayStrategyPosition.previewExitOrRepayStrategyPosition(input, operation, true, resolved);
+		const intent = await require_preview_preview_detectDelayedClaim.resolveDelayedClaimIntent(input.sdk, operation.multicall, options?.blockNumber);
+		if (require_model_result.isSDKError(intent)) return intent;
+		preview.intent = intent.data;
+		return require_model_result.sdkOk(preview);
 	}
 	if (operation.operation === "MultiCall" || operation.operation === "BotMulticall" || operation.operation === "RWAMulticall") return previewMulticallOperation(input, operation, await resolveCreditAccount(input, operation, options));
-	throw new require_preview_preview_errors.UnsupportedOperationError(operation.operation);
+	return require_model_result.sdkErr({
+		code: "unsupportedOperation",
+		message: `operation "${operation.operation}" is not supported by previewOperation`,
+		operation: operation.operation
+	});
 }
 /**
 * Resolves the pre-state of the credit account an operation targets: uses the
@@ -53,26 +69,32 @@ async function resolveCreditAccount(input, operation, options) {
 */
 async function previewMulticallOperation(input, operation, options) {
 	const { sdk } = input;
-	const instantPreview = require_preview_preview_detectCloseOrRepay.isCloseOrRepay(operation.multicall) ? await require_preview_preview_previewCloseOrRepayCreditAccount.previewCloseOrRepayCreditAccount(input, operation, false, options) : await require_preview_preview_previewAdjustCreditAccount.previewAdjustCreditAccount(input, operation, options);
-	const delayed = require_preview_preview_detectDelayedOperation.detectDelayedOperation(sdk, operation.multicall);
+	const instantPreview = require_preview_preview_detectCloseOrRepay.isCloseOrRepay(operation.multicall) ? require_preview_preview_previewExitOrRepayStrategyPosition.previewExitOrRepayStrategyPosition(input, operation, false, options) : require_preview_preview_previewAdjustStrategyPosition.previewAdjustStrategyPosition(input, operation, options);
+	const detected = require_preview_preview_detectDelayedOperation.detectDelayedOperation(sdk, operation.multicall);
+	if (require_model_result.isSDKError(detected)) return detected;
+	const delayed = detected.data;
 	if (!delayed) {
-		instantPreview.intent = await require_preview_preview_detectDelayedClaim.resolveDelayedClaimIntent(sdk, operation.multicall, options?.blockNumber);
-		return instantPreview;
+		const intent = await require_preview_preview_detectDelayedClaim.resolveDelayedClaimIntent(sdk, operation.multicall, options?.blockNumber);
+		if (require_model_result.isSDKError(intent)) return intent;
+		instantPreview.intent = intent.data;
+		return require_model_result.sdkOk(instantPreview);
 	}
-	const { before, after } = await require_preview_preview_replayMulticall.replayMulticall(sdk, operation, options);
+	const { before, after } = require_preview_preview_replayMulticall.replayMulticall(sdk, operation, options);
 	const market = sdk.marketRegister.findByCreditManager(operation.creditManager);
-	const convert = (token, to, amount) => market.priceOracle.convert(token, to, amount);
 	const meta = sdk.tokensMeta.get(market.underlying);
 	const receivedToken = meta && sdk.tokensMeta.isRWAUnderlying(meta) ? meta.asset : market.underlying;
-	return {
+	const suite = sdk.marketRegister.findCreditManager(operation.creditManager);
+	return require_model_result.sdkOk({
 		operation: "DelayedCreditAccountOperation",
 		creditAccount: operation.creditAccount,
-		creditManager: operation.creditManager,
-		name: sdk.marketRegister.findCreditManager(operation.creditManager).name,
+		...suite.creditOperationMarket(),
+		name: suite.accountStrategyName(operation.creditAccount),
+		targetCollateral: suite.accountTargetCollateral(operation.creditAccount),
 		intent: delayed.intent,
+		estClaimableAt: require_preview_preview_estimateClaimableAt.estimateClaimableAt(sdk, delayed.request.phantomToken),
 		instantPreview,
-		delayedPreview: require_preview_preview_buildDelayedPreview.buildDelayedPreview(after.account, before, delayed, convert, receivedToken, sdk)
-	};
+		delayedPreview: require_preview_preview_buildDelayedStrategyPositionOperationPreview.buildDelayedStrategyPositionOperationPreview(after.account, before, delayed, receivedToken, sdk)
+	});
 }
 //#endregion
 exports.previewOperation = previewOperation;

package/dist/cjs/preview/preview/previewPoolPositionOperation.js

@@ -0,0 +1,49 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_abi_iERC20 = require("../../abi/iERC20.js");
+const require_model_result = require("../../model/result.js");
+require("../../model/index.js");
+const require_preview_simulate_errors = require("../simulate/errors.js");
+const require_preview_simulate_simulatePoolOperation = require("../simulate/simulatePoolOperation.js");
+//#region src/preview/preview/previewPoolPositionOperation.ts
+async function previewPoolPositionOperation(input, operation, options) {
+	const { sdk } = input;
+	const { tokenIn, tokenOut } = operation;
+	const market = sdk.marketRegister.findByPool(operation.pool);
+	const pool = market.pool.pool;
+	const holder = "owner" in operation ? operation.owner : operation.receiver;
+	let previewAmount;
+	let shares;
+	try {
+		[previewAmount, shares] = await sdk.client.multicall({
+			contracts: [require_preview_simulate_simulatePoolOperation.previewContract(operation), {
+				address: operation.pool,
+				abi: require_abi_iERC20.ierc20Abi,
+				functionName: "balanceOf",
+				args: [holder]
+			}],
+			allowFailure: false,
+			batchSize: 0,
+			blockNumber: options?.blockNumber
+		});
+	} catch (cause) {
+		const error = require_preview_simulate_errors.asPreviewSimulationError(cause, "multicall");
+		options?.logger?.error(error, "pool operation simulation failed");
+		return require_model_result.sdkErr(error);
+	}
+	const sim = require_preview_simulate_simulatePoolOperation.amountsInOut(operation, previewAmount);
+	const inflow = operation.operation === "Deposit" || operation.operation === "Mint";
+	const after = shares + (inflow ? sim.amountOut : -sim.amountIn);
+	return require_model_result.sdkOk({
+		operation: operation.operation,
+		pool: operation.pool,
+		name: sdk.tokensMeta.mustGetToken(operation.pool).name,
+		underlyingToken: market.underlyingToken,
+		shareRate: pool.dieselRate,
+		tokenIn: market.priceOracle.toTokenAmount(tokenIn, sim.amountIn),
+		tokenOut: market.priceOracle.toTokenAmount(tokenOut, sim.amountOut),
+		curator: market.curator,
+		netValue: market.toUnderlyingAmount(pool.sharesToUnderlying(after > 0n ? after : 0n))
+	});
+}
+//#endregion
+exports.previewPoolPositionOperation = previewPoolPositionOperation;

package/dist/cjs/preview/preview/replayInnerOperations.js

@@ -2,11 +2,8 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_onchain_utils_AssetsMap = require("../../onchain/utils/AssetsMap.js");
 require("../../onchain/constants/math.js");
 const require_onchain_market_adapters_contracts_AbstractAdapter = require("../../onchain/market/adapters/contracts/AbstractAdapter.js");
-const require_onchain_market_adapters_contracts_ERC4626AdapterContract = require("../../onchain/market/adapters/contracts/ERC4626AdapterContract.js");
-const require_model_previews = require("../../model/previews.js");
-require("../../model/index.js");
 require("../../onchain/index.js");
-const require_preview_preview_applyRWAWrapUnwrap = require("./applyRWAWrapUnwrap.js");
+const require_preview_preview_errors = require("./errors.js");
 //#region src/preview/preview/replayInnerOperations.ts
 /**
 * Creates a {@link ReplayState} around the given account seed, with empty
@@ -24,16 +21,16 @@ function makeReplayState(account) {
 * facade execution order. The result is the *minimal guaranteed* post-state.
 *
 * The function assumes that the call was generated by our frontend using
-* router/withdrawal compressor, otherwise it returns an error, but still
+* router/withdrawal compressor, otherwise it returns a warning, but still
 * proceeds best-effort.
 *
-* @returns `undefined` on success, the error on a malformed multicall.
+* @returns `undefined` on success, the warning on a malformed multicall.
 */
-async function replayInnerOperations(sdk, multicall, state) {
+function replayInnerOperations(sdk, multicall, state) {
 	let inBracket = false;
-	let error;
+	let warning;
 	for (const op of multicall) {
-		let opError;
+		let opWarning;
 		switch (op.operation) {
 			case "AddCollateral":
 				applyAddCollateral(state, op);
@@ -51,29 +48,20 @@ async function replayInnerOperations(sdk, multicall, state) {
 				state.account.updateQuota(op.token, op.change);
 				break;
 			case "StoreExpectedBalances":
-				if (inBracket) opError = {
-					code: require_model_previews.ERROR_MALFORMED_BRACKET,
-					message: "nested storeExpectedBalances/compareBalances bracket"
-				};
+				if (inBracket) opWarning = require_preview_preview_errors.malformedBracketError("nested");
 				inBracket = true;
 				for (const { token, balance } of op.deltas) state.account.balances.inc(token, balance);
 				break;
 			case "CompareBalances":
-				if (!inBracket) opError = {
-					code: require_model_previews.ERROR_MALFORMED_BRACKET,
-					message: "compareBalances without a preceding storeExpectedBalances"
-				};
+				if (!inBracket) opWarning = require_preview_preview_errors.malformedBracketError("unmatchedCompare");
 				inBracket = false;
 				break;
-			case "Execute": opError = await applyExecute(sdk, op, inBracket, state.account.balances);
+			case "Execute": opWarning = applyExecute(sdk, op, inBracket, state.account.balances);
 		}
-		error ??= opError;
+		warning ??= opWarning;
 	}
-	if (inBracket) error ??= {
-		code: require_model_previews.ERROR_MALFORMED_BRACKET,
-		message: "storeExpectedBalances without a matching compareBalances"
-	};
-	return error;
+	if (inBracket) warning ??= require_preview_preview_errors.malformedBracketError("unmatchedStore");
+	return warning;
 }
 function applyAddCollateral(state, op) {
 	state.collateralAdded.inc(op.token, op.amount);
@@ -94,52 +82,27 @@ function applyWithdrawCollateral(state, op) {
 *
 * Inside a bracket, the adapter's balance changes are previewed via
 * {@link AbstractAdapterContract.previewBalanceChanges}. Outside a bracket,
-* only RWA wrap/unwrap calls are allowed (see {@link applyRWAWrapUnwrap});
-* nothing enforces the outcome of any other out-of-bracket adapter call
-* on-chain, so its effect on balances cannot be previewed.
+* only calls that {@link AbstractAdapterContract.replayOutOfBracketCall}
+* accepts are allowed; nothing enforces the outcome of any other out-of-bracket
+* adapter call on-chain, so its effect on balances cannot be previewed.
 */
-async function applyExecute(sdk, op, inBracket, balances) {
+function applyExecute(sdk, op, inBracket, balances) {
 	const adapter = sdk.getContract(op.adapter);
 	if (!inBracket) {
-		if (!isRWAShare(sdk, adapter)) return {
-			code: require_model_previews.ERROR_ADAPTER_CALL_OUTSIDE_BRACKET,
-			message: `call to ${op.adapter} outside of a storeExpectedBalances/compareBalances bracket`
-		};
-		try {
-			require_preview_preview_applyRWAWrapUnwrap.applyRWAWrapUnwrap(adapter, op.calldata, balances);
-			return;
+		if (adapter instanceof require_onchain_market_adapters_contracts_AbstractAdapter.AbstractAdapterContract) try {
+			if (adapter.replayOutOfBracketCall(balances, op.calldata)) return;
 		} catch (e) {
-			return {
-				code: require_model_previews.ERROR_UNPREVIEWABLE_RWA_WRAP_UNWRAP,
-				message: e instanceof Error ? e.message : String(e)
-			};
+			return require_preview_preview_errors.unsupportedOutOfBracketCallError(op.adapter, e);
 		}
+		return require_preview_preview_errors.adapterCallOutsideBracketError(op.adapter);
 	}
-	if (!(adapter instanceof require_onchain_market_adapters_contracts_AbstractAdapter.AbstractAdapterContract)) return {
-		code: require_model_previews.ERROR_NON_ADAPTER_CALL_IN_BRACKET,
-		message: `call to ${op.adapter} between storeExpectedBalances and compareBalances is not an adapter call`
-	};
+	if (!(adapter instanceof require_onchain_market_adapters_contracts_AbstractAdapter.AbstractAdapterContract)) return require_preview_preview_errors.nonAdapterCallInBracketError(op.adapter);
 	try {
-		await adapter.previewBalanceChanges(balances, op.calldata);
+		adapter.previewBalanceChanges(balances, op.calldata);
 		return;
 	} catch (e) {
-		return {
-			code: require_model_previews.ERROR_UNPREVIEWABLE_ADAPTER_CALL,
-			message: e instanceof Error ? e.message : String(e)
-		};
-	}
-}
-/**
-* True when the ERC4626 adapter converts an RWA underlying, i.e. it is the
-* wrap/unwrap adapter of an RWA market rather than a regular vault strategy
-* adapter.
-*/
-function isRWAShare(sdk, adapter) {
-	if (adapter instanceof require_onchain_market_adapters_contracts_ERC4626AdapterContract.ERC4626AdapterContract) {
-		const meta = sdk.tokensMeta.get(adapter.share);
-		return !!meta && sdk.tokensMeta.isRWAUnderlying(meta);
+		return require_preview_preview_errors.unpreviewableAdapterCallError(op.adapter, e);
 	}
-	return false;
 }
 //#endregion
 exports.makeReplayState = makeReplayState;

package/dist/cjs/preview/preview/replayMulticall.js

@@ -6,13 +6,13 @@ const require_preview_preview_replayInnerOperations = require("./replayInnerOper
 * Replays the operation's multicall over the account's pre-resolved
 * pre-state (`options.creditAccount`) via {@link replayInnerOperations}.
 */
-async function replayMulticall(sdk, operation, options) {
+function replayMulticall(sdk, operation, options) {
 	const before = require_preview_preview_CreditAccountState.CreditAccountState.fromCreditAccountData(options.creditAccount);
 	const after = require_preview_preview_replayInnerOperations.makeReplayState(before.clone());
 	return {
 		before,
 		after,
-		error: await require_preview_preview_replayInnerOperations.replayInnerOperations(sdk, operation.multicall, after)
+		warning: require_preview_preview_replayInnerOperations.replayInnerOperations(sdk, operation.multicall, after)
 	};
 }
 //#endregion

package/dist/cjs/preview/preview/unwrapNativeCollateral.js

@@ -1,9 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_onchain_utils_AssetsMap = require("../../onchain/utils/AssetsMap.js");
 const require_onchain_constants_addresses = require("../../onchain/constants/addresses.js");
-const require_model_previews = require("../../model/previews.js");
-require("../../model/index.js");
 require("../../onchain/index.js");
+const require_preview_preview_errors = require("./errors.js");
 //#region src/preview/preview/unwrapNativeCollateral.ts
 /**
 * Represents the transaction's attached native value as a `NATIVE_ADDRESS`
@@ -17,14 +16,13 @@ require("../../onchain/index.js");
 *
 * When `nativeAmount` is positive but the WETH collateral is missing or
 * smaller than it, the transaction is malformed: the collateral is returned
-* as-is (no unwrapping) together with an `ERROR_INVALID_TRANSACTION_VALUE`
-* error.
+* as-is (no unwrapping) together with an `invalidTransactionValue` warning.
 *
 * @param collateral - Collateral assets as declared by the multicall.
 * @param nativeAmount - Transaction `msg.value`.
 * @param wethToken - Wrapped native token address.
 * @returns Collateral with the native amount unwrapped from the WETH entry,
-* plus the error on a malformed transaction value.
+* plus the warning on a malformed transaction value.
 */
 function unwrapNativeCollateral(collateral, nativeAmount, wethToken) {
 	if (nativeAmount === 0n) return { assets: collateral };
@@ -32,10 +30,7 @@ function unwrapNativeCollateral(collateral, nativeAmount, wethToken) {
 	const wethBalance = balances.get(wethToken) ?? 0n;
 	if (wethBalance < nativeAmount) return {
 		assets: collateral,
-		error: {
-			code: require_model_previews.ERROR_INVALID_TRANSACTION_VALUE,
-			message: `transaction value ${nativeAmount} exceeds WETH collateral ${wethBalance}`
-		}
+		warning: require_preview_preview_errors.invalidTransactionValueError(nativeAmount, wethBalance)
 	};
 	balances.upsert(wethToken, wethBalance === nativeAmount ? void 0 : wethBalance - nativeAmount);
 	balances.inc(require_onchain_constants_addresses.NATIVE_ADDRESS, nativeAmount);

package/dist/cjs/preview/simulate/errors.js

@@ -2,34 +2,26 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_abi_errors = require("../../abi/errors.js");
 let viem = require("viem");
 //#region src/preview/simulate/errors.ts
-/**
-* Error returned by the pool simulation when it fails. It wraps the flow's
-* decoded revert reason (see {@link failures}).
-*/
-var PreviewSimulationError = class extends viem.BaseError {
-	name = "PreviewSimulationError";
-	/** Per-flow decoded failures behind this error. */
-	failures;
-	constructor(failures) {
-		const shortMessage = failures.length <= 1 ? failures[0]?.detail.reason ?? "simulation failed" : "all simulation flows failed";
-		const cause = failures.find((f) => f.detail.cause instanceof Error)?.detail.cause;
-		super(shortMessage, {
-			metaMessages: failures.map((f) => `[${f.source}] ${f.detail.reason}`),
-			cause
-		});
-		this.failures = failures;
-	}
-};
+function isPreviewSimulationError(value) {
+	return typeof value === "object" && value !== null && !(value instanceof Error) && value.code === "previewSimulationFailed";
+}
 /**
 * Normalises an unknown rejection reason into a {@link PreviewSimulationError}.
 * Pass-through when it already is one; otherwise decodes it under `source`.
 */
 function asPreviewSimulationError(reason, source) {
-	if (reason instanceof PreviewSimulationError) return reason;
-	return new PreviewSimulationError([{
-		source,
-		detail: decodeSimulationError({ error: reason instanceof Error ? reason : new Error(String(reason)) })
-	}]);
+	if (isPreviewSimulationError(reason)) return reason;
+	const error = reason instanceof Error ? reason : new Error(String(reason));
+	const detail = decodeSimulationError({ error });
+	return {
+		code: "previewSimulationFailed",
+		message: detail.reason,
+		failures: [{
+			source,
+			detail
+		}],
+		cause: error
+	};
 }
 /**
 * Decodes a simulated call revert into a {@link SimulationError}.
@@ -77,6 +69,5 @@ function formatDecodedError(errorName, args) {
 	return `${errorName}(${args.map((arg) => String(arg)).join(", ")})`;
 }
 //#endregion
-exports.PreviewSimulationError = PreviewSimulationError;
 exports.asPreviewSimulationError = asPreviewSimulationError;
 exports.decodeSimulationError = decodeSimulationError;

package/dist/cjs/preview/simulate/index.js

@@ -1,10 +1,10 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_preview_simulate_errors = require("./errors.js");
-const require_preview_simulate_simulateFacadeOperation = require("./simulateFacadeOperation.js");
 const require_preview_simulate_simulatePoolOperation = require("./simulatePoolOperation.js");
+const require_preview_simulate_simulateFacadeOperation = require("./simulateFacadeOperation.js");
 const require_preview_simulate_simulateRWAOperation = require("./simulateRWAOperation.js");
 const require_preview_simulate_simulateOperation = require("./simulateOperation.js");
-exports.PreviewSimulationError = require_preview_simulate_errors.PreviewSimulationError;
+exports.asPreviewSimulationError = require_preview_simulate_errors.asPreviewSimulationError;
 exports.simulateFacadeOperation = require_preview_simulate_simulateFacadeOperation.simulateFacadeOperation;
 exports.simulateOperation = require_preview_simulate_simulateOperation.simulateOperation;
 exports.simulatePoolOperation = require_preview_simulate_simulatePoolOperation.simulatePoolOperation;