@gearbox-protocol/sdk 16.0.0-next.15 → 16.0.0-next.16

package/dist/esm/onchain/accounts/intents/utils/price-impact.js

@@ -0,0 +1,96 @@
+import { PERCENTAGE_FACTOR_1KK, PRICE_DECIMALS, WAD } from "../../../constants/math.js";
+//#region src/onchain/accounts/intents/utils/price-impact.ts
+/** `b1 = b0 / V0`: a dollar of the basket, the reference implementation's anchor. */
+const PROBE_UNIT_USD_WAD = WAD;
+/**
+* `V0 = Σ b0ᵢ·pᵢ`, then `b1 = b0 / V0`, proportions kept.
+*
+* Refuses only what the reference refuses — a basket worth nothing, or one that
+* rounds away entirely. Stricter guards here would report nothing where the old
+* client reported a number.
+*/
+function probeBasket(balances, oracle) {
+	if (balances.length === 0) return;
+	let basketWad = 0n;
+	for (const asset of balances) {
+		if (asset.balance <= 0n) continue;
+		const usd = oracle.safeConvertToUSD(asset.token, asset.balance);
+		if (usd !== null && usd > 0n) basketWad += usd * WAD / PRICE_DECIMALS;
+	}
+	if (basketWad <= 0n) return;
+	const probeWad = PROBE_UNIT_USD_WAD;
+	const scaled = balances.map((asset) => ({
+		token: asset.token,
+		balance: asset.balance * probeWad / basketWad
+	}));
+	if (!scaled.some((a) => a.balance > 0n)) return;
+	return {
+		balances: scaled,
+		basketWad,
+		probeWad
+	};
+}
+/** Fires the marginal-price quote for one leg; `undefined` if it cannot be measured. */
+function startProbe(args) {
+	const basket = probeBasket(args.basket, args.oracle);
+	if (!basket) return;
+	return {
+		tokenOut: args.tokenOut,
+		basketWad: basket.basketWad,
+		probeWad: basket.probeWad,
+		probe: args.route(basket.balances).catch(() => void 0)
+	};
+}
+/** `convert` answers `0` for a negative amount, so convert the magnitude and re-sign. */
+function toUnderlyingSigned(convert, token, amount) {
+	if (amount === 0n) return 0n;
+	const converted = convert(token, amount < 0n ? -amount : amount);
+	if (converted <= 0n) return;
+	return amount < 0n ? -converted : converted;
+}
+/**
+* In `PERCENTAGE_FACTOR_1KK` (1_000_000 = 100%), negative for a loss. A base
+* that is not positive falls back to the routed output.
+*/
+function lossRate(args) {
+	const { lossUnd, expectedUnd, totalValue, netValue } = args;
+	const against = (base) => -(PERCENTAGE_FACTOR_1KK * lossUnd / (base > 0n ? base : expectedUnd));
+	return {
+		pathPriceImpact: against(expectedUnd),
+		netValuePriceImpact: against(netValue),
+		totalValuePriceImpact: against(totalValue)
+	};
+}
+/**
+* Folds every leg into one rate, in the underlying — the unit its bases are in.
+*
+* All or nothing: a partial sum would understate the loss and draw a better
+* price than the route offers.
+*/
+async function collectPriceImpact(probes, ctx) {
+	if (probes.length === 0) return;
+	const quotes = await Promise.all(probes.map((leg) => leg.probe));
+	let expectedUnd = 0n;
+	let lossUnd = 0n;
+	for (const [index, leg] of probes.entries()) {
+		const unit = quotes[index];
+		if (unit === void 0 || unit <= 0n) return;
+		const expected = unit * leg.basketWad / leg.probeWad;
+		if (expected <= 0n) return;
+		const expectedInUnd = ctx.toUnderlying(leg.tokenOut, expected);
+		if (expectedInUnd <= 0n) return;
+		const loss = toUnderlyingSigned(ctx.toUnderlying, leg.tokenOut, expected - leg.realAmount);
+		if (loss === void 0) return;
+		expectedUnd += expectedInUnd;
+		lossUnd += loss;
+	}
+	if (expectedUnd <= 0n) return;
+	return lossRate({
+		lossUnd,
+		expectedUnd,
+		totalValue: ctx.totalValue,
+		netValue: ctx.netValue
+	});
+}
+//#endregion
+export { collectPriceImpact, lossRate, startProbe };

package/dist/esm/onchain/accounts/intents/utils/router-path.js

@@ -1,5 +1,6 @@
 import { toRouterCaSlice } from "./common.js";
 import { convertAmount } from "./convert-amount.js";
+import { startProbe } from "./price-impact.js";
 //#region src/onchain/accounts/intents/utils/router-path.ts
 /**
 * The engine's only door to the pathfinder.
@@ -17,68 +18,124 @@ function createRouterPaths(args) {
 		collateralTokens: suite.creditManager.collateralTokens.map((t) => t.toLowerCase())
 	};
 	const router = sdk.routerFor({ creditFacade: suite.creditFacade.address });
+	const { priceOracle } = sdk.marketRegister.findByCreditManager(creditAccount.creditManager);
+	const quoteSwap = (input) => {
+		const spending = [{
+			token: input.tokenIn,
+			balance: input.amount + input.keep
+		}];
+		return input.keep > 0n ? router.findManyToOnePath({
+			creditAccount: toRouterCaSlice(creditAccount, spending),
+			creditManager: cmSlice,
+			expectedBalances: spending,
+			leftoverBalances: [{
+				token: input.tokenIn,
+				balance: input.keep
+			}],
+			target: input.tokenOut,
+			slippage
+		}) : router.findOneTokenPath({
+			creditAccount: toRouterCaSlice(creditAccount, spending),
+			creditManager: cmSlice,
+			tokenIn: input.tokenIn,
+			tokenOut: input.tokenOut,
+			amount: input.amount,
+			slippage
+		});
+	};
+	const quoteClose = (balances) => router.findBestClosePath({
+		creditAccount: toRouterCaSlice(creditAccount, balances),
+		creditManager: cmSlice,
+		balances: {
+			expectedBalances: balances,
+			leftoverBalances: [],
+			tokensToClaim: []
+		},
+		slippage
+	});
+	const quoteOpen = (expectedBalances, leftoverBalances, target) => router.findOpenStrategyPath({
+		creditManager: cmSlice,
+		expectedBalances,
+		leftoverBalances,
+		target,
+		slippage
+	});
 	return {
 		async swap({ tokenIn, tokenOut, amount, keep = 0n }) {
 			if (amount <= 0n) return {
 				amount: 0n,
 				minAmount: 0n,
-				calls: []
+				calls: [],
+				probe: void 0
 			};
 			if (keep < 0n) throw new Error(`swap: spending ${amount} of ${tokenIn} exceeds its balance`);
-			if (keep > 0n) {
-				const expectedBalances = [{
-					token: tokenIn,
-					balance: amount + keep
-				}];
-				return router.findManyToOnePath({
-					creditAccount: toRouterCaSlice(creditAccount, expectedBalances),
-					creditManager: cmSlice,
-					expectedBalances,
-					leftoverBalances: [{
-						token: tokenIn,
-						balance: keep
-					}],
-					target: tokenOut,
-					slippage
-				});
-			}
-			return router.findOneTokenPath({
-				creditAccount: toRouterCaSlice(creditAccount, [{
+			const probe = startProbe({
+				basket: [{
 					token: tokenIn,
 					balance: amount
-				}]),
-				creditManager: cmSlice,
+				}],
+				tokenOut,
+				oracle: priceOracle,
+				route: async ([only]) => {
+					if (!only) return 0n;
+					return (await quoteSwap({
+						tokenIn: only.token,
+						tokenOut,
+						amount: only.balance,
+						keep: 0n
+					})).amount;
+				}
+			});
+			const leg = await quoteSwap({
 				tokenIn,
 				tokenOut,
 				amount,
-				slippage
+				keep
 			});
+			return {
+				...leg,
+				probe: probe && {
+					...probe,
+					realAmount: leg.amount
+				}
+			};
 		},
 		async closeAll({ balances }) {
-			const { amount, minAmount, calls } = await router.findBestClosePath({
-				creditAccount: toRouterCaSlice(creditAccount, balances),
-				creditManager: cmSlice,
-				balances: {
-					expectedBalances: balances,
-					leftoverBalances: [],
-					tokensToClaim: []
-				},
-				slippage
+			const probe = startProbe({
+				basket: balances,
+				tokenOut: creditAccount.underlying,
+				oracle: priceOracle,
+				route: async (quoted) => (await quoteClose(quoted)).amount
 			});
-			return {
+			const { amount, minAmount, calls } = await quoteClose(balances);
+			const leg = {
 				amount,
 				minAmount,
 				calls: [...calls]
 			};
+			return {
+				...leg,
+				probe: probe && {
+					...probe,
+					realAmount: leg.amount
+				}
+			};
 		},
 		async openStrategy({ expectedBalances, leftoverBalances, target }) {
-			return router.findOpenStrategyPath({
-				creditManager: cmSlice,
-				expectedBalances,
-				leftoverBalances,
-				target,
-				slippage
+			const probe = startProbe({
+				basket: expectedBalances,
+				tokenOut: target,
+				oracle: priceOracle,
+				route: async (balances) => (await quoteOpen(balances, [], target)).amount
 			});
+			const leg = await quoteOpen(expectedBalances, leftoverBalances, target);
+			return {
+				...leg,
+				probe: probe && {
+					...probe,
+					realAmount: leg.amount
+				}
+			};
 		}
 	};
 }
@@ -98,7 +155,8 @@ function createOraclePaths(args) {
 	const estimate = (amount) => ({
 		amount,
 		minAmount: amount,
-		calls: []
+		calls: [],
+		probe: void 0
 	});
 	return {
 		async swap({ tokenIn, tokenOut, amount }) {

package/dist/types/onchain/accounts/index.d.ts

@@ -21,10 +21,10 @@ import { PeripheryCompressorV310Contract } from "./bots/PeripheryCompressorV310C
 import "./bots/index.js";
 import { CreditAccountsServiceV310 } from "./CreditAccountsServiceV310.js";
 import { LeverageBand } from "./intents/leverage-band.js";
-import { OpenStrategyPreview, OpenStrategyProps } from "./intents/open-strategy.js";
-import { IntentPreviewError, PreviewErrorDetails, PreviewErrorReason, PreviewRefusal, refuse } from "./intents/refusal.js";
-import { AddCollateralIntent, AdjustLeverageIntent, CreditAccountSlice, DelayableIntent, DelayedRoute, DelayedStart, DelayedStartResult, DepositStrategyIntent, FinishIntentProps, InstantRoute, IntentPreviewResult, IntentRoutesResult, OperationState, RepayStrategyIntent, ResumableIntent, RouteRefusals, StartIntent, WithdrawAssetIntent, WithdrawStrategyIntent } from "./intents/types.js";
 import { AccountCalculatorOperation } from "./intents/operations.js";
+import { IntentPreviewError, PreviewErrorDetails, PreviewErrorReason, PreviewRefusal, refuse } from "./intents/refusal.js";
+import { AddCollateralIntent, AdjustLeverageIntent, CreditAccountSlice, DelayableIntent, DelayedRoute, DelayedStart, DelayedStartResult, DepositStrategyIntent, FinishIntentProps, InstantRoute, IntentPreviewResult, IntentRoutesResult, OperationState, PathLossRate, RepayStrategyIntent, ResumableIntent, RouteRefusals, StartIntent, WithdrawAssetIntent, WithdrawStrategyIntent } from "./intents/types.js";
+import { OpenStrategyPreview, OpenStrategyProps } from "./intents/open-strategy.js";
 import { fetchCreditAccountSlice, toCreditAccountSlice } from "./intents/utils/credit-account-slice.js";
 import { CreditAccountOperationsService, OpenStrategyPreviewResult } from "./intents/index.js";
 import { LIQUIDATION_APPROVAL_BUFFER, LIQUIDATION_COMPRESSOR_V313_ADDRESS } from "./liquidations/constants.js";
@@ -32,4 +32,4 @@ import { BuildLiquidationTxProps, BuildLiquidationTxPropsBase, GetLiquidatableAc
 import { LiquidationsService } from "./liquidations/LiquidationsService.js";
 import { MultichainLiquidationsService } from "./liquidations/MultichainLiquidationsService.js";
 import "./liquidations/index.js";
-export { AbstractWithdrawalCompressorContract, AccountBotsService, type AccountCalculatorOperation, AccountToCheck, type AddCollateralIntent, type AdjustLeverageIntent, AssembleCaOperationsProps, AssembleClaimDelayedCallsProps, AssembleCloseCreditAccountCallsProps, AssembleRepayCreditAccountCallsProps, AssembleStartDelayedWithdrawalCallsProps, BotStatusCall, BotsDirectResponse, BuildLiquidationTxProps, BuildLiquidationTxPropsBase, CMSlice, ClaimFarmRewardsProps, ClaimableWithdrawal, CloseCreditAccountResult, ConnectedBotsCall, ConnectedBotsPerAccount, CreditAccountCompressor, CreditAccountCompressorV310Contract, CreditAccountDataCall, CreditAccountFilter, CreditAccountOperationResult, CreditAccountOperationsService, CreditAccountReadOptions, type CreditAccountSlice, CreditAccountsCall, CreditAccountsQuery, CreditAccountsReadOptions, CreditAccountsServiceV310, CreditAccountsTarget, CreditManagerFilter, CreditManagerOperationResult, CurrentWithdrawals, DELAYED_INTENT_TYPES, DELAYED_INTENT_VERSION, type DelayableIntent, DelayedIntentExtended, type DelayedRoute, type DelayedStart, type DelayedStartResult, type DepositStrategyIntent, EncodableCreditAccountOperation, type FinishIntentProps, FullyLiquidateProps, FullyLiquidateResult, GetApprovalAddressProps, GetConnectedBotsResponse, GetConnectedBotsResult, GetConnectedMigrationBotsResult, GetCreditAccountsArgs, GetCreditAccountsOptions, GetExternalAccountCurrentWithdrawalsProps, GetLiquidatableAccountsProps, GetLiquidationDetailsProps, GetLiquidationDetailsPropsBase, GetLiquidationPositionsProps, GetLiquidationPositionsPropsBase, GetPendingWithdrawalsProps, GetPendingWithdrawalsResult, GetWithdrawalRequestResultProps, ICreditAccountsService, IRedemptionLoggerContract, IWithdrawalCompressorContract, type InstantRoute, IntentPreviewError, type IntentPreviewResult, type IntentRoutesResult, InvalidDelayedIntentError, LIQUIDATION_APPROVAL_BUFFER, LIQUIDATION_COMPRESSOR_V313_ADDRESS, type LeverageBand, LiquidationsService, LoadRWALiquidatorsProps, MulticallWithFailure, MultichainLiquidationsService, OnchainLiquidationCall, OnchainLiquidationData, OnchainLiquidationOutput, OnchainRequestableWithdrawal, OpenCAProps, type OpenStrategyPreview, OpenStrategyPreviewResult, type OpenStrategyProps, type OperationState, PartiallyLiquidateProps, PendingWithdrawal, PeripheryCompressorV310Contract, PreviewDelayedWithdrawalProps, type PreviewErrorDetails, type PreviewErrorReason, type PreviewRefusal, RWALiquidatorInfo, RedemptionLog, RedemptionLoggerV310Contract, type RepayStrategyIntent, RequestableWithdrawal, type ResumableIntent, Rewards, type RouteRefusals, SetBotProps, SetBotResult, type StartIntent, type WithdrawAssetIntent, type WithdrawStrategyIntent, WithdrawableAsset, WithdrawalCompressorLocation, WithdrawalCompressorV310Contract, WithdrawalCompressorV311Contract, WithdrawalCompressorV313Contract, WithdrawalCompressorVersion, WithdrawalOutput, WithdrawalStatus, WithdrawalsState, createRedemptionLogger, createWithdrawalCompressor, decodeDelayedIntent, encodeDelayedIntent, fetchCreditAccountSlice, getWithdrawalCompressorAddress, iCreditAccountAbi, refuse, toClaimableWithdrawal, toCreditAccountSlice, toPendingWithdrawal, toRequestableWithdrawal, toWithdrawalStatus };
+export { AbstractWithdrawalCompressorContract, AccountBotsService, type AccountCalculatorOperation, AccountToCheck, type AddCollateralIntent, type AdjustLeverageIntent, AssembleCaOperationsProps, AssembleClaimDelayedCallsProps, AssembleCloseCreditAccountCallsProps, AssembleRepayCreditAccountCallsProps, AssembleStartDelayedWithdrawalCallsProps, BotStatusCall, BotsDirectResponse, BuildLiquidationTxProps, BuildLiquidationTxPropsBase, CMSlice, ClaimFarmRewardsProps, ClaimableWithdrawal, CloseCreditAccountResult, ConnectedBotsCall, ConnectedBotsPerAccount, CreditAccountCompressor, CreditAccountCompressorV310Contract, CreditAccountDataCall, CreditAccountFilter, CreditAccountOperationResult, CreditAccountOperationsService, CreditAccountReadOptions, type CreditAccountSlice, CreditAccountsCall, CreditAccountsQuery, CreditAccountsReadOptions, CreditAccountsServiceV310, CreditAccountsTarget, CreditManagerFilter, CreditManagerOperationResult, CurrentWithdrawals, DELAYED_INTENT_TYPES, DELAYED_INTENT_VERSION, type DelayableIntent, DelayedIntentExtended, type DelayedRoute, type DelayedStart, type DelayedStartResult, type DepositStrategyIntent, EncodableCreditAccountOperation, type FinishIntentProps, FullyLiquidateProps, FullyLiquidateResult, GetApprovalAddressProps, GetConnectedBotsResponse, GetConnectedBotsResult, GetConnectedMigrationBotsResult, GetCreditAccountsArgs, GetCreditAccountsOptions, GetExternalAccountCurrentWithdrawalsProps, GetLiquidatableAccountsProps, GetLiquidationDetailsProps, GetLiquidationDetailsPropsBase, GetLiquidationPositionsProps, GetLiquidationPositionsPropsBase, GetPendingWithdrawalsProps, GetPendingWithdrawalsResult, GetWithdrawalRequestResultProps, ICreditAccountsService, IRedemptionLoggerContract, IWithdrawalCompressorContract, type InstantRoute, IntentPreviewError, type IntentPreviewResult, type IntentRoutesResult, InvalidDelayedIntentError, LIQUIDATION_APPROVAL_BUFFER, LIQUIDATION_COMPRESSOR_V313_ADDRESS, type LeverageBand, LiquidationsService, LoadRWALiquidatorsProps, MulticallWithFailure, MultichainLiquidationsService, OnchainLiquidationCall, OnchainLiquidationData, OnchainLiquidationOutput, OnchainRequestableWithdrawal, OpenCAProps, type OpenStrategyPreview, OpenStrategyPreviewResult, type OpenStrategyProps, type OperationState, PartiallyLiquidateProps, type PathLossRate, PendingWithdrawal, PeripheryCompressorV310Contract, PreviewDelayedWithdrawalProps, type PreviewErrorDetails, type PreviewErrorReason, type PreviewRefusal, RWALiquidatorInfo, RedemptionLog, RedemptionLoggerV310Contract, type RepayStrategyIntent, RequestableWithdrawal, type ResumableIntent, Rewards, type RouteRefusals, SetBotProps, SetBotResult, type StartIntent, type WithdrawAssetIntent, type WithdrawStrategyIntent, WithdrawableAsset, WithdrawalCompressorLocation, WithdrawalCompressorV310Contract, WithdrawalCompressorV311Contract, WithdrawalCompressorV313Contract, WithdrawalCompressorVersion, WithdrawalOutput, WithdrawalStatus, WithdrawalsState, createRedemptionLogger, createWithdrawalCompressor, decodeDelayedIntent, encodeDelayedIntent, fetchCreditAccountSlice, getWithdrawalCompressorAddress, iCreditAccountAbi, refuse, toClaimableWithdrawal, toCreditAccountSlice, toPendingWithdrawal, toRequestableWithdrawal, toWithdrawalStatus };

package/dist/types/onchain/accounts/intents/index.d.ts

@@ -1,9 +1,9 @@
 import { SDKConstruct } from "../../base/SDKConstruct.js";
 import { LeverageBand, LeverageBandProps } from "./leverage-band.js";
-import { OpenStrategyPreview, OpenStrategyProps } from "./open-strategy.js";
-import { IntentPreviewError, PreviewErrorDetails, PreviewErrorReason, PreviewRefusal, refuse } from "./refusal.js";
-import { AddCollateralIntent, AdjustLeverageIntent, CreditAccountSlice, DelayableIntent, DelayedRoute, DelayedStart, DelayedStartResult, DepositStrategyIntent, FinishIntentProps, InstantRoute, IntentPreviewResult, IntentRoutesResult, OperationState, RepayStrategyIntent, ResumableIntent, RouteRefusals, StartIntent, StartIntentProps, WithdrawAssetIntent, WithdrawStrategyIntent } from "./types.js";
 import { AccountCalculatorOperation } from "./operations.js";
+import { IntentPreviewError, PreviewErrorDetails, PreviewErrorReason, PreviewRefusal, refuse } from "./refusal.js";
+import { AddCollateralIntent, AdjustLeverageIntent, CreditAccountSlice, DelayableIntent, DelayedRoute, DelayedStart, DelayedStartResult, DepositStrategyIntent, FinishIntentProps, InstantRoute, IntentPreviewResult, IntentRoutesResult, OperationState, PathLossRate, RepayStrategyIntent, ResumableIntent, RouteRefusals, StartIntent, StartIntentProps, WithdrawAssetIntent, WithdrawStrategyIntent } from "./types.js";
+import { OpenStrategyPreview, OpenStrategyProps } from "./open-strategy.js";
 import { fetchCreditAccountSlice, toCreditAccountSlice } from "./utils/credit-account-slice.js";
 import { Address } from "viem";
 //#region src/onchain/accounts/intents/index.d.ts
@@ -172,4 +172,4 @@ declare class CreditAccountOperationsService extends SDKConstruct {
   openStrategyIntent(props: OpenStrategyProps): Promise<OpenStrategyPreviewResult>;
 }
 //#endregion
-export { type AccountCalculatorOperation, type AddCollateralIntent, type AdjustLeverageIntent, CreditAccountOperationsService, type CreditAccountSlice, type DelayableIntent, type DelayedRoute, type DelayedStart, type DelayedStartResult, type DepositStrategyIntent, type FinishIntentProps, type InstantRoute, IntentPreviewError, type IntentPreviewResult, type IntentRoutesResult, type LeverageBand, type OpenStrategyPreview, OpenStrategyPreviewResult, type OpenStrategyProps, type OperationState, type PreviewErrorDetails, type PreviewErrorReason, type PreviewRefusal, type RepayStrategyIntent, type ResumableIntent, type RouteRefusals, type StartIntent, type WithdrawAssetIntent, type WithdrawStrategyIntent, fetchCreditAccountSlice, refuse, toCreditAccountSlice };
+export { type AccountCalculatorOperation, type AddCollateralIntent, type AdjustLeverageIntent, CreditAccountOperationsService, type CreditAccountSlice, type DelayableIntent, type DelayedRoute, type DelayedStart, type DelayedStartResult, type DepositStrategyIntent, type FinishIntentProps, type InstantRoute, IntentPreviewError, type IntentPreviewResult, type IntentRoutesResult, type LeverageBand, type OpenStrategyPreview, OpenStrategyPreviewResult, type OpenStrategyProps, type OperationState, type PathLossRate, type PreviewErrorDetails, type PreviewErrorReason, type PreviewRefusal, type RepayStrategyIntent, type ResumableIntent, type RouteRefusals, type StartIntent, type WithdrawAssetIntent, type WithdrawStrategyIntent, fetchCreditAccountSlice, refuse, toCreditAccountSlice };

package/dist/types/onchain/accounts/intents/open-strategy.d.ts

@@ -4,6 +4,7 @@ import "../../../model/index.js";
 import { Asset } from "../../base/types.js";
 import { MultiCall } from "../../types/transactions.js";
 import { OnchainSDK } from "../../OnchainSDK.js";
+import { PathLossRate } from "./types.js";
 import "../../index.js";
 import { Address } from "viem";
 //#region src/onchain/accounts/intents/open-strategy.d.ts
@@ -60,6 +61,8 @@ interface OpenStrategyPreview {
   collateral: bigint;
   /** Position size — collateral plus debt, in underlying. */
   totalValue: bigint;
+  /** What the routed leg lost to market depth; `undefined` if not measured. */
+  priceImpact: PathLossRate | undefined;
   /** Expected post-open balances. */
   averageAssets: TokenAmount[];
   /** Floor post-open balances after slippage. */

package/dist/types/onchain/accounts/intents/realize.d.ts

@@ -1,7 +1,7 @@
 import { MultiCall } from "../../types/transactions.js";
 import { OnchainSDK } from "../../OnchainSDK.js";
-import { CreditAccountSlice, DelayedStart, OperationState } from "./types.js";
 import { AccountCalculatorOperation } from "./operations.js";
+import { CreditAccountSlice, DelayedStart, OperationState } from "./types.js";
 import "../../index.js";
 import { Step } from "./plan.js";
 import { RouterPaths } from "./utils/router-path.js";

package/dist/types/onchain/accounts/intents/tail.d.ts

@@ -1,7 +1,7 @@
 import { ClaimableWithdrawal } from "../withdrawal-compressor/types.js";
 import { OnchainSDK } from "../../OnchainSDK.js";
-import { CreditAccountSlice, DelayedStart, OperationState, ResumableIntent } from "./types.js";
 import { AccountCalculatorOperation, StartDelayedWithdrawalOperation } from "./operations.js";
+import { CreditAccountSlice, DelayedStart, OperationState, ResumableIntent } from "./types.js";
 import "../../index.js";
 import { AccountView, Step } from "./plan.js";
 //#region src/onchain/accounts/intents/tail.d.ts

package/dist/types/onchain/accounts/intents/testing/expect.d.ts

@@ -1,8 +1,8 @@
 import { TokenAmount } from "../../../../model/primitives.js";
 import "../../../../model/index.js";
 import { MultiCall } from "../../../types/transactions.js";
-import { DelayedStartResult, IntentPreviewResult, OperationState } from "../types.js";
 import { AccountCalculatorOperation } from "../operations.js";
+import { DelayedStartResult, IntentPreviewResult, OperationState } from "../types.js";
 import "../../../index.js";
 import { Address } from "viem";
 //#region src/onchain/accounts/intents/testing/expect.d.ts

package/dist/types/onchain/accounts/intents/testing/market.d.ts

@@ -72,6 +72,8 @@ interface MarketSdkExtras {
   maxDebtPerBlockMultiplier?: number;
   /** Tokens the facade forbids. */
   forbiddenTokens?: Address[];
+  /** What a routed swap returns; linear when omitted. */
+  routeQuote?: (amount: bigint) => bigint;
 }
 /** Mock SDK on the shared fixture market. */
 declare function buildMarketSdk(extras?: MarketSdkExtras): OnchainSDK;

package/dist/types/onchain/accounts/intents/testing/sdk-mock.d.ts

@@ -114,6 +114,13 @@ interface BuildMockSdkArgs {
    * `accountDebt` lands as the principal with no interest or fees accrued.
    */
   creditAccounts?: CreditAccountSlice[];
+  /**
+   * What a routed swap returns for a given input, so a case can quote a market
+   * with depth. The default is linear — every route returns its input — which
+   * reports no price impact at all, since the probe scales down in exactly the
+   * same proportion.
+   */
+  routeQuote?: (amount: bigint) => bigint;
 }
 /** One redemption venue of the mock compressor. */
 interface MockDelayedVenue {

package/dist/types/onchain/accounts/intents/tests/deposit.fixtures.d.ts

@@ -52,7 +52,7 @@ declare const NATIVE_VALUE = 1000000000000000000n;
  * the addCollateral op.
  */
 declare const case_native_coin: DepositCase;
-declare function buildDepositSdk(c: DepositCase): OnchainSDK;
+declare function buildDepositSdk(c: DepositCase, routeQuote?: (amount: bigint) => bigint): OnchainSDK;
 declare function buildDepositProps(c: DepositCase, sdk: OnchainSDK): {
   intent: DepositStrategyIntent;
   creditAccount: CreditAccountSlice;

package/dist/types/onchain/accounts/intents/types.d.ts

@@ -7,8 +7,8 @@ import { Asset } from "../../base/types.js";
 import { RouterCASlice } from "../../router/types.js";
 import { MultiCall } from "../../types/transactions.js";
 import { OnchainSDK } from "../../OnchainSDK.js";
-import { PreviewErrorReason, PreviewRefusal } from "./refusal.js";
 import { AccountCalculatorOperation } from "./operations.js";
+import { PreviewErrorReason, PreviewRefusal } from "./refusal.js";
 import "../../index.js";
 import { Address } from "viem";
 //#region src/onchain/accounts/intents/types.d.ts
@@ -21,6 +21,17 @@ type CreditAccountSlice = Omit<RouterCASlice, "debt"> & {
   /** either base debt or debt plus interest and fees */
   accountDebt: bigint;
 };
+/**
+ * Price impact against three bases: the routed output, net value, total value.
+ *
+ * In `PERCENTAGE_FACTOR_1KK` (1_000_000 = 100%), negative for a loss — the
+ * legacy 1e6 scale, not the `Bps` the rest of this module speaks.
+ */
+interface PathLossRate {
+  pathPriceImpact: bigint;
+  netValuePriceImpact: bigint;
+  totalValuePriceImpact: bigint;
+}
 /** Projected account metrics once the operations execute. */
 interface OperationState {
   /**
@@ -70,6 +81,11 @@ interface OperationState {
    * absent rather than present at zero.
    */
   quotas: Record<Address, Asset>;
+  /**
+   * What the routed legs lost to market depth. `undefined` where nothing was
+   * routed or nothing could be measured — never a manufactured zero.
+   */
+  priceImpact: PathLossRate | undefined;
 }
 /**
  * What a preview yields: the operation chain, the state it projects, and the
@@ -405,4 +421,4 @@ type FinishIntentProps = StartIntentProps & {
   claimable: ClaimableWithdrawal;
 };
 //#endregion
-export { AddCollateralIntent, AdjustLeverageIntent, CreditAccountSlice, DelayableIntent, DelayedRoute, DelayedStart, DelayedStartResult, DepositStrategyIntent, FinishIntentProps, InstantRoute, IntentPreviewResult, IntentRoutesResult, OperationState, RepayStrategyIntent, ResumableIntent, RouteRefusals, StartIntent, StartIntentProps, WithdrawAssetIntent, WithdrawStrategyIntent };
+export { AddCollateralIntent, AdjustLeverageIntent, CreditAccountSlice, DelayableIntent, DelayedRoute, DelayedStart, DelayedStartResult, DepositStrategyIntent, FinishIntentProps, InstantRoute, IntentPreviewResult, IntentRoutesResult, OperationState, PathLossRate, RepayStrategyIntent, ResumableIntent, RouteRefusals, StartIntent, StartIntentProps, WithdrawAssetIntent, WithdrawStrategyIntent };

package/dist/types/onchain/accounts/intents/utils/index.d.ts

@@ -1,4 +1,5 @@
 import { fetchCreditAccountSlice, toCreditAccountSlice } from "./credit-account-slice.js";
+import { LegProbe, collectPriceImpact, lossRate, startProbe } from "./price-impact.js";
 import { OpenStrategyLeg, RouterPaths, SwapLeg, createOraclePaths, createRouterPaths } from "./router-path.js";
 import { adjustStateToSnapshot } from "./adjust-state-to-snapshot.js";
 import { assembleOperationCalls } from "./assemble-operation-calls.js";
@@ -8,4 +9,4 @@ import { convertAmount } from "./convert-amount.js";
 import { ConvertFn, LedgerSnapshot, OperationLedger } from "./ledger.js";
 import { CandidateToken, isPhantomToken, isRedemptionPhantomToken, pickFattestNonPhantomToken, rankAccountTokens } from "./pick-token.js";
 import { clearedQuotas, getQuotasForUpdate, quotasAfterUpdate } from "./quotas-for-update.js";
-export { CandidateToken, ConvertFn, LedgerSnapshot, OpenStrategyLeg, OperationLedger, RouterPaths, SwapLeg, adjustStateToSnapshot, assembleOperationCalls, calcBorrowedAmountPlusInterestAndFees, clearedQuotas, convertAmount, createOraclePaths, createRouterPaths, eq, fetchCreditAccountSlice, getQuotasForUpdate, isPhantomToken, isRedemptionPhantomToken, pickFattestNonPhantomToken, quotasAfterUpdate, rankAccountTokens, toCreditAccountSlice, toRouterCaSlice, toTargetDecimals };
+export { CandidateToken, ConvertFn, LedgerSnapshot, LegProbe, OpenStrategyLeg, OperationLedger, RouterPaths, SwapLeg, adjustStateToSnapshot, assembleOperationCalls, calcBorrowedAmountPlusInterestAndFees, clearedQuotas, collectPriceImpact, convertAmount, createOraclePaths, createRouterPaths, eq, fetchCreditAccountSlice, getQuotasForUpdate, isPhantomToken, isRedemptionPhantomToken, lossRate, pickFattestNonPhantomToken, quotasAfterUpdate, rankAccountTokens, startProbe, toCreditAccountSlice, toRouterCaSlice, toTargetDecimals };

package/dist/types/onchain/accounts/intents/utils/price-impact.d.ts

@@ -0,0 +1,49 @@
+import { Asset } from "../../../base/types.js";
+import { IPriceOracleContract } from "../../../market/oracle/types.js";
+import { PathLossRate } from "../types.js";
+import "../../../index.js";
+import { Address } from "viem";
+//#region src/onchain/accounts/intents/utils/price-impact.d.ts
+/** One leg's contribution to the preview's impact. */
+interface LegProbe {
+  tokenOut: Address;
+  /**
+   * The real route's `amount`, never its `minAmount`: the floor is a tolerance
+   * the caller chose, not a cost the market charged.
+   */
+  realAmount: bigint;
+  basketWad: bigint;
+  probeWad: bigint;
+  /** Already in flight, and already neutralised — see {@link startProbe}. */
+  probe: Promise<bigint | undefined>;
+}
+/** Fires the marginal-price quote for one leg; `undefined` if it cannot be measured. */
+declare function startProbe(args: {
+  basket: Asset[];
+  tokenOut: Address;
+  oracle: IPriceOracleContract;
+  route: (basket: Asset[]) => Promise<bigint | undefined>;
+}): Omit<LegProbe, "realAmount"> | undefined;
+/**
+ * In `PERCENTAGE_FACTOR_1KK` (1_000_000 = 100%), negative for a loss. A base
+ * that is not positive falls back to the routed output.
+ */
+declare function lossRate(args: {
+  lossUnd: bigint;
+  expectedUnd: bigint;
+  totalValue: bigint;
+  netValue: bigint;
+}): PathLossRate;
+/**
+ * Folds every leg into one rate, in the underlying — the unit its bases are in.
+ *
+ * All or nothing: a partial sum would understate the loss and draw a better
+ * price than the route offers.
+ */
+declare function collectPriceImpact(probes: LegProbe[], ctx: {
+  totalValue: bigint;
+  netValue: bigint;
+  toUnderlying: (from: Address, amount: bigint) => bigint;
+}): Promise<PathLossRate | undefined>;
+//#endregion
+export { LegProbe, collectPriceImpact, lossRate, startProbe };

package/dist/types/onchain/accounts/intents/utils/router-path.d.ts

@@ -3,6 +3,7 @@ import { MultiCall } from "../../../types/transactions.js";
 import { OnchainSDK } from "../../../OnchainSDK.js";
 import { CreditAccountSlice } from "../types.js";
 import "../../../index.js";
+import { LegProbe } from "./price-impact.js";
 import { Address } from "viem";
 //#region src/onchain/accounts/intents/utils/router-path.d.ts
 /** One routed conversion leg. */
@@ -12,6 +13,14 @@ interface SwapLeg {
   /** Conservative output — the pathfinder floor after slippage. */
   minAmount: bigint;
   calls: MultiCall[];
+  /**
+   * The marginal-price quote this leg is measured against, already in flight.
+   *
+   * Produced here, not by the caller, so the basket cannot drift from the trade
+   * it prices and the quote is always fired before the leg is awaited.
+   * `undefined` where there is nothing to measure.
+   */
+  probe: LegProbe | undefined;
 }
 /** A routed leg that also projects the balances it leaves behind. */
 interface OpenStrategyLeg extends SwapLeg {