@gearbox-protocol/sdk 17.0.0-next.3 → 17.0.0

package/dist/cjs/onchain/accounts/intents/realize.js

@@ -1,4 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_onchain_constants_math = require("../../constants/math.js");
 const require_model_errors_operation_errors = require("../../../model/errors/operation-errors.js");
 const require_model_errors_prepare_errors = require("../../../model/errors/prepare-errors.js");
 require("../../../model/index.js");
@@ -12,6 +13,7 @@ const require_onchain_accounts_intents_utils_price_impact = require("./utils/pri
 const require_onchain_accounts_intents_utils_quotas_for_update = require("./utils/quotas-for-update.js");
 const require_onchain_accounts_intents_utils_router_path = require("./utils/router-path.js");
 const require_onchain_accounts_intents_operations = require("./operations.js");
+const require_onchain_accounts_intents_withdraw_limits = require("./withdraw-limits.js");
 //#region src/onchain/accounts/intents/realize.ts
 /**
 * Turns a plan into operations: the one place that talks to the router, knows
@@ -49,6 +51,7 @@ async function realize(steps, props) {
 	* can revert.
 	*/
 	const ledger = new require_onchain_accounts_intents_utils_ledger.OperationLedger(start);
+	const opening = ledger.snapshot();
 	/**
 	* The same walk with every routed leg counted at the amount the pathfinder
 	* expects to return. Nothing is built from it: it is where the position
@@ -72,6 +75,26 @@ async function realize(steps, props) {
 	let raised = 0n;
 	/** The request, before the walk's end state can be attached to it. */
 	let delayed;
+	/** Oracle value in the underlying of what routed legs and requests spend and return. */
+	const traded = {
+		spentUnd: 0n,
+		returnedUnd: 0n,
+		priced: true
+	};
+	const trade = (spent, returned) => {
+		const underlyingValue = (legs) => {
+			let sum = 0n;
+			for (const { token, amount } of legs) {
+				if (amount === 0n) continue;
+				const value = price(token, underlying, amount);
+				if (value <= 0n) traded.priced = false;
+				sum += value;
+			}
+			return sum;
+		};
+		traded.spentUnd += underlyingValue(spent);
+		traded.returnedUnd += underlyingValue(returned);
+	};
 	/**
 	* Set by a `clearQuotas` step, which settles the quotas mid-walk instead of
 	* at the end — and settles them at none, whatever the balances turn out to be.
@@ -173,6 +196,13 @@ async function realize(steps, props) {
 				...swap,
 				amountOut: leg.amount
 			});
+			trade([{
+				token: step.from,
+				amount
+			}], [{
+				token: step.to,
+				amount: leg.amount
+			}]);
 			raised = leg.minAmount;
 			break;
 		}
@@ -198,6 +228,13 @@ async function realize(steps, props) {
 						})),
 						amountOut: leg.amount
 					});
+					trade(balances.map((a) => ({
+						token: a.token,
+						amount: a.balance
+					})), [{
+						token: underlying,
+						amount: leg.amount
+					}]);
 				}
 			}
 			raised = ledger.balanceOf(underlying);
@@ -242,6 +279,13 @@ async function realize(steps, props) {
 					amount: require_onchain_accounts_intents_utils_common.toTargetDecimals(queued.amount, queued.token, asset.underlying, sdk)
 				} : void 0
 			};
+			trade([{
+				token: preview.token,
+				amount: preview.amountIn
+			}], [...preview.outputs.filter((o) => !o.isDelayed).map((o) => ({
+				token: o.token,
+				amount: o.amount
+			})), ...delayed.claim ? [delayed.claim] : []]);
 			raised = require_onchain_accounts_intents_operations.instantOutput(preview.outputs)?.amount ?? 0n;
 			break;
 		}
@@ -320,19 +364,32 @@ async function realize(steps, props) {
 		totalValue: projected.totalValue
 	};
 	const projection = sdk.positions.projection(snapshot, { availableLiquidityChange: creditAccount.totalDebt - debt });
-	require_onchain_accounts_intents_guards.assertCollateralised(sdk.positions.healthFactor({
+	const settled = {
 		...snapshot,
 		assets,
 		totalValue: floor.totalValue
-	}, { safePrices: withdrawsCollateral }), withdrawsCollateral);
+	};
+	require_onchain_accounts_intents_guards.assertCollateralised(sdk.positions.healthFactor(settled, { safePrices: withdrawsCollateral }), withdrawsCollateral, () => ({
+		atMainPrices: sdk.positions.healthFactor(settled, { safePrices: false }),
+		withdrawable: require_onchain_validation_helpers_token.toTokenAmount(sdk, underlying, require_onchain_accounts_intents_withdraw_limits.withdrawLimits({
+			creditAccount,
+			sdk
+		}).safePartial)
+	}));
 	const priceImpact = await require_onchain_accounts_intents_utils_price_impact.collectPriceImpact(probes, {
 		totalValue: projected.totalValue,
-		netValue: projected.totalValue - debt,
-		toUnderlying: (from, amount) => price(from, underlying, amount)
+		netValue: opening.totalValue - opening.debt,
+		toUnderlying: (from, amount) => price(from, underlying, amount),
+		toUnderlyingAmount: market.toUnderlyingAmount
 	});
+	const executionCost = traded.priced && traded.spentUnd > 0n ? {
+		amount: market.toUnderlyingAmount(traded.returnedUnd - traded.spentUnd),
+		rate: require_onchain_constants_math.PERCENTAGE_FACTOR_1KK * (traded.returnedUnd - traded.spentUnd) / traded.spentUnd
+	} : void 0;
 	const state = {
 		...projection,
 		priceImpact,
+		executionCost,
 		currentPrice: sdk.positions.currentPrice(snapshot)
 	};
 	return {

package/dist/cjs/onchain/accounts/intents/tail.js

@@ -8,8 +8,8 @@ const require_onchain_accounts_intents_utils_common = require("./utils/common.js
 const require_onchain_accounts_intents_utils_router_path = require("./utils/router-path.js");
 const require_onchain_accounts_intents_plan = require("./plan.js");
 const require_onchain_accounts_intents_operations = require("./operations.js");
-const require_onchain_accounts_intents_realize = require("./realize.js");
 const require_onchain_accounts_intents_view = require("./view.js");
+const require_onchain_accounts_intents_realize = require("./realize.js");
 //#region src/onchain/accounts/intents/tail.ts
 /**
 * The second half of a delayed intent: the claim, then whatever the intent

package/dist/cjs/onchain/accounts/intents/testing/sdk-mock.js

@@ -203,6 +203,7 @@ function buildMockSdk(args) {
 			liquidationThresholds,
 			collateralTokens,
 			feeInterest: args.feeInterest ?? 0,
+			maxEnabledTokens: args.maxEnabledTokens ?? 4,
 			maxLeverage: (collateral, targetHF) => require_onchain_market_math.calcMaxLeverage(liquidationThresholds.get(collateral) ?? 0, targetHF)
 		},
 		creditFacade: {

package/dist/cjs/onchain/accounts/intents/utils/common.js

@@ -3,6 +3,24 @@ const require_onchain_utils_AddressMap = require("../../../utils/AddressMap.js")
 //#region src/onchain/accounts/intents/utils/common.ts
 /** Case-insensitive address equality. */
 const eq = (a, b) => a.toLowerCase() === b.toLowerCase();
+/**
+* The suite and market behind a credit manager, or nothing where the register
+* has no entry for it.
+*
+* For the reads a form calls on every keystroke, including before the SDK has
+* finished attaching: a question the register cannot answer yet is not an
+* error. Everything that prepares a transaction wants the throw instead.
+*/
+function resolveCreditManager(sdk, creditManager) {
+	try {
+		return {
+			suite: sdk.marketRegister.findCreditManager(creditManager),
+			market: sdk.marketRegister.findByCreditManager(creditManager)
+		};
+	} catch {
+		return;
+	}
+}
 function toTargetDecimals(fromAmount, fromToken, toToken, sdk) {
 	const fromDecimals = sdk.tokensMeta.get(fromToken)?.decimals ?? 18;
 	const toDecimals = sdk.tokensMeta.get(toToken)?.decimals ?? 18;
@@ -39,5 +57,6 @@ function toRouterCaSlice(creditAccount, expectedBalances = []) {
 }
 //#endregion
 exports.eq = eq;
+exports.resolveCreditManager = resolveCreditManager;
 exports.toRouterCaSlice = toRouterCaSlice;
 exports.toTargetDecimals = toTargetDecimals;

package/dist/cjs/onchain/accounts/intents/utils/credit-account-slice.js

@@ -27,6 +27,26 @@ function toCreditAccountSlice(ca) {
 	};
 }
 /**
+* The slice a flow that has no account yet quotes against.
+*
+* Nothing of it exists on chain until the transaction lands, and nothing has
+* to: the pathfinder is asked about the credit manager, and every balance the
+* flow reasons about is one the transaction itself puts there. The zero
+* address stands in for the account so the shape is complete.
+*/
+function unopenedAccountSlice(args) {
+	return {
+		creditAccount: "0x0000000000000000000000000000000000000000",
+		creditManager: args.creditManager.toLowerCase(),
+		creditFacade: args.creditFacade.toLowerCase(),
+		underlying: args.underlying.toLowerCase(),
+		enabledTokensMask: 0n,
+		totalDebtUSD: 0n,
+		totalDebt: 0n,
+		tokens: []
+	};
+}
+/**
 * Reads an account by address and narrows it to {@link CreditAccountSlice}.
 *
 * The shared read model's `StrategyPosition` carries neither `tokens` nor
@@ -43,3 +63,4 @@ async function fetchCreditAccountSlice(sdk, creditAccount) {
 //#endregion
 exports.fetchCreditAccountSlice = fetchCreditAccountSlice;
 exports.toCreditAccountSlice = toCreditAccountSlice;
+exports.unopenedAccountSlice = unopenedAccountSlice;

package/dist/cjs/onchain/accounts/intents/utils/index.js

@@ -26,7 +26,9 @@ exports.lossRate = require_onchain_accounts_intents_utils_price_impact.lossRate;
 exports.pickFattestNonPhantomToken = require_onchain_accounts_intents_utils_pick_token.pickFattestNonPhantomToken;
 exports.quotasAfterUpdate = require_onchain_accounts_intents_utils_quotas_for_update.quotasAfterUpdate;
 exports.rankAccountTokens = require_onchain_accounts_intents_utils_pick_token.rankAccountTokens;
+exports.resolveCreditManager = require_onchain_accounts_intents_utils_common.resolveCreditManager;
 exports.startProbe = require_onchain_accounts_intents_utils_price_impact.startProbe;
 exports.toCreditAccountSlice = require_onchain_accounts_intents_utils_credit_account_slice.toCreditAccountSlice;
 exports.toRouterCaSlice = require_onchain_accounts_intents_utils_common.toRouterCaSlice;
 exports.toTargetDecimals = require_onchain_accounts_intents_utils_common.toTargetDecimals;
+exports.unopenedAccountSlice = require_onchain_accounts_intents_utils_credit_account_slice.unopenedAccountSlice;

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

@@ -19,12 +19,12 @@ function probeBasket(balances, oracle) {
 		if (usd > 0n) basketWad += usd * require_onchain_constants_math.WAD / require_onchain_constants_math.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
+		balance: asset.balance * PROBE_UNIT_USD_WAD / basketWad
 	}));
-	if (!scaled.some((a) => a.balance > 0n)) return;
+	const probeWad = scaled.reduce((sum, a) => sum + oracle.safeConvertToUSD(a.token, a.balance).value * require_onchain_constants_math.WAD / require_onchain_constants_math.PRICE_DECIMALS, 0n);
+	if (probeWad <= 0n) return;
 	return {
 		balances: scaled,
 		basketWad,
@@ -86,12 +86,15 @@ async function collectPriceImpact(probes, ctx) {
 		lossUnd += loss;
 	}
 	if (expectedUnd <= 0n) return;
-	return lossRate({
-		lossUnd,
-		expectedUnd,
-		totalValue: ctx.totalValue,
-		netValue: ctx.netValue
-	});
+	return {
+		...lossRate({
+			lossUnd,
+			expectedUnd,
+			totalValue: ctx.totalValue,
+			netValue: ctx.netValue
+		}),
+		absolutePriceImpact: ctx.toUnderlyingAmount(-lossUnd)
+	};
 }
 //#endregion
 exports.collectPriceImpact = collectPriceImpact;

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

@@ -3,11 +3,8 @@ const require_onchain_accounts_intents_utils_common = require("./common.js");
 const require_onchain_accounts_intents_utils_price_impact = require("./price-impact.js");
 //#region src/onchain/accounts/intents/utils/router-path.ts
 /**
-* The engine's only door to the pathfinder.
-*
-* Deliberately not a quoter abstraction with an oracle-priced twin: paths are
-* always resolved on-chain, because a preview whose swap amounts came from
-* oracle prices could not produce the calldata that realises them.
+* The engine's only door to the pathfinder, and the only quoter whose legs can
+* be sent. {@link createOraclePaths} is the twin for a walk that only projects.
 */
 function createRouterPaths(args) {
 	const { sdk, creditAccount, slippage } = args;
@@ -92,6 +89,7 @@ function createRouterPaths(args) {
 				amount,
 				keep
 			});
+			if (leg.calls.length === 0) throw new Error("swap: missing router calls");
 			return {
 				...leg,
 				probe: probe && {
@@ -108,6 +106,7 @@ function createRouterPaths(args) {
 				route: async (quoted) => (await quoteClose(quoted)).amount
 			});
 			const { amount, minAmount, calls } = await quoteClose(balances);
+			if (calls.length === 0 && minAmount > 0n) throw new Error("closeAll: missing router calls");
 			const leg = {
 				amount,
 				minAmount,

package/dist/cjs/onchain/accounts/intents/withdraw-limits.js

@@ -0,0 +1,97 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_onchain_utils_bigint_math = require("../../utils/bigint-math.js");
+require("../../utils/index.js");
+const require_onchain_validation_helpers_health_factor_limits = require("../../validation/helpers/health-factor-limits.js");
+require("../../validation/index.js");
+const require_onchain_accounts_intents_utils_common = require("./utils/common.js");
+const require_onchain_accounts_intents_math = require("./math.js");
+const require_onchain_accounts_intents_collateral_valuation = require("./collateral-valuation.js");
+const require_onchain_accounts_intents_view = require("./view.js");
+//#region src/onchain/accounts/intents/withdraw-limits.ts
+/**
+* Every limit a `WITHDRAW` answers to, in underlying units.
+*
+* The one place they are assembled, so the figure a form is offered and the
+* figure the collateral guard names when it turns a withdrawal down cannot
+* drift apart: `CreditAccountOperationsService` reports this, and the guard
+* quotes it back.
+*
+* @param props - Account slice, the SDK holding its market, and optionally the
+* collateral the withdrawal would be funded from
+* @returns The three limits, see {@link WithdrawCeilings}
+**/
+function withdrawLimits(props) {
+	const { creditAccount, sdk } = props;
+	const view = require_onchain_accounts_intents_view.accountView(creditAccount, sdk);
+	const partial = require_onchain_accounts_intents_math.maxProportionalWithdrawal(view, view.debtLimits);
+	const safe = maxSafeWithdrawal({
+		...props,
+		targetHF: BigInt(require_onchain_validation_helpers_health_factor_limits.MIN_HEALTH_FACTOR_FACADE)
+	});
+	return {
+		partial,
+		safePartial: require_onchain_utils_bigint_math.BigIntMath.min(partial, safe),
+		exit: view.collateral > 0n ? view.collateral : 0n
+	};
+}
+/**
+* Largest proportional withdrawal the safe-price collateral check still clears,
+* in underlying units.
+*
+* A withdrawal hands funds over, so the facade weighs the account it leaves
+* behind at safe prices rather than main ones — see {@link collateralValuation}.
+* That is a second limit on top of the facade's `debtLimits`, and the two are
+* independent: a caller wanting the amount a form may actually offer takes the
+* lesser of this and `maxProportionalWithdrawal`.
+*
+* The arithmetic is the check solved for the amount. Taking `W` out at fixed
+* leverage repays `dD = D·W/C`, so `W·TVL/C` of value is sold out of the source
+* token; each dollar of that sale costs the check the source's threshold times
+* its safe-to-main price ratio, while the repayment relieves `targetHF` per
+* dollar of debt. Both terms are linear in `W`, which is why one division
+* answers instead of a search — and why the answer is exact rather than a
+* bound, as long as the plan really does fund itself from `sourceToken`.
+*
+* Two consequences worth stating, because they surprise:
+*
+* - An account whose collateral is entirely a token the reserve feed marks
+*   down cannot withdraw at all once it is under the threshold. A proportional
+*   withdrawal scales collateral and debt together, so it leaves the safe-price
+*   factor exactly where it found it — no amount climbs back over.
+* - Leaving entirely is never refused for this reason: the exit settles the
+*   debt instead of shrinking it, and a check with no debt to divide by has
+*   nothing to refuse.
+*
+* @returns Amount in underlying units. The account's net value when safe prices
+* do not limit the withdrawal at all, so the caller's `min` is a no-op; `0n`
+* when the account already sits below `targetHF` at safe prices, and only the
+* exit is left
+**/
+function maxSafeWithdrawal(props) {
+	const { creditAccount, sdk, targetHF } = props;
+	const view = require_onchain_accounts_intents_view.accountView(creditAccount, sdk);
+	if (view.collateral <= 0n) return 0n;
+	if (view.debt === 0n) return view.collateral;
+	const valuation = require_onchain_accounts_intents_collateral_valuation.collateralValuation(creditAccount, sdk);
+	const source = props.sourceToken ?? view.fattest();
+	const holding = source === void 0 ? void 0 : creditAccount.tokens.find((t) => require_onchain_accounts_intents_utils_common.eq(t.token, source));
+	if (!holding) return view.collateral;
+	let total = 0n;
+	for (const t of creditAccount.tokens) if (valuation.counts(t)) total += valuation.weigh(t);
+	const debtUsd = valuation.mainUsd(valuation.underlying, view.debt);
+	if (debtUsd === void 0 || debtUsd <= 0n) return view.collateral;
+	const slack = total - debtUsd * targetHF;
+	if (slack < 0n) return 0n;
+	const sourceMainUsd = valuation.mainUsd(holding.token, holding.balance);
+	if (sourceMainUsd === void 0 || sourceMainUsd <= 0n) return view.collateral;
+	const sourceRate = valuation.lt(holding.token) * valuation.checkedUsd(holding);
+	const tvlUsd = valuation.mainUsd(valuation.underlying, view.collateral + view.debt);
+	if (tvlUsd === void 0) return view.collateral;
+	const drain = sourceRate * tvlUsd - targetHF * debtUsd * sourceMainUsd;
+	if (drain <= 0n) return view.collateral;
+	const limit = view.collateral * slack * sourceMainUsd / drain;
+	return limit < view.collateral ? limit : view.collateral;
+}
+//#endregion
+exports.maxSafeWithdrawal = maxSafeWithdrawal;
+exports.withdrawLimits = withdrawLimits;

package/dist/cjs/onchain/accounts/liquidations/LiquidationsService.js

@@ -10,9 +10,9 @@ require("../../utils/index.js");
 const require_onchain_base_SDKConstruct = require("../../base/SDKConstruct.js");
 require("../../base/index.js");
 const require_onchain_market_math = require("../../market/math.js");
+const require_onchain_market_rwa_midas_constants = require("../../market/rwa/midas/constants.js");
 const require_model_liquidations = require("../../../model/liquidations.js");
 require("../../../model/index.js");
-const require_onchain_market_rwa_midas_constants = require("../../market/rwa/midas/constants.js");
 const require_onchain_market_rwa_securitize_constants = require("../../market/rwa/securitize/constants.js");
 const require_onchain_market_credit_collateralUtils = require("../../market/credit/collateralUtils.js");
 const require_onchain_market_rwa_midas_MidasLiquidatorContract = require("../../market/rwa/midas/MidasLiquidatorContract.js");

package/dist/cjs/onchain/constants/address-provider.js

@@ -33,7 +33,6 @@ const AP_WETH_GATEWAY = "WETH_GATEWAY";
 const AP_WETH_TOKEN = "WETH_TOKEN";
 const AP_ZAPPER_REGISTER = "ZAPPER_REGISTER";
 const AP_ZERO_PRICE_FEED = "ZERO_PRICE_FEED";
-const AP_RWA_COMPRESSOR = "GLOBAL::RWA_COMPRESSOR";
 const AP_REDEMPTION_LOGGER = "LOCAL::REDEMPTION_LOGGER";
 /**
 * Default address provider address for v3.1.0
@@ -69,7 +68,6 @@ exports.AP_PRICE_ORACLE = AP_PRICE_ORACLE;
 exports.AP_REDEMPTION_LOGGER = AP_REDEMPTION_LOGGER;
 exports.AP_REWARDS_COMPRESSOR = AP_REWARDS_COMPRESSOR;
 exports.AP_ROUTER = AP_ROUTER;
-exports.AP_RWA_COMPRESSOR = AP_RWA_COMPRESSOR;
 exports.AP_TOKEN_COMPRESSOR = AP_TOKEN_COMPRESSOR;
 exports.AP_TREASURY = AP_TREASURY;
 exports.AP_WETH_GATEWAY = AP_WETH_GATEWAY;

package/dist/cjs/onchain/constants/index.js

@@ -35,7 +35,6 @@ exports.AP_PRICE_ORACLE = require_onchain_constants_address_provider.AP_PRICE_OR
 exports.AP_REDEMPTION_LOGGER = require_onchain_constants_address_provider.AP_REDEMPTION_LOGGER;
 exports.AP_REWARDS_COMPRESSOR = require_onchain_constants_address_provider.AP_REWARDS_COMPRESSOR;
 exports.AP_ROUTER = require_onchain_constants_address_provider.AP_ROUTER;
-exports.AP_RWA_COMPRESSOR = require_onchain_constants_address_provider.AP_RWA_COMPRESSOR;
 exports.AP_TOKEN_COMPRESSOR = require_onchain_constants_address_provider.AP_TOKEN_COMPRESSOR;
 exports.AP_TREASURY = require_onchain_constants_address_provider.AP_TREASURY;
 exports.AP_WETH_GATEWAY = require_onchain_constants_address_provider.AP_WETH_GATEWAY;

package/dist/cjs/onchain/core/createAddressProvider.js

@@ -1,15 +1,12 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_abi_iVersion = require("../../abi/iVersion.js");
-const require_onchain_constants_address_provider = require("../constants/address-provider.js");
+require("../constants/address-provider.js");
 const require_onchain_constants_versions = require("../constants/versions.js");
 require("../constants/index.js");
 const require_onchain_utils_hex = require("../utils/hex.js");
 const require_onchain_core_AddressProviderV310Contract = require("./AddressProviderV310Contract.js");
 //#region src/onchain/core/createAddressProvider.ts
-const OVERRIDE_ADDRESSES = { Mainnet: {
-	[require_onchain_constants_address_provider.AP_PRICE_FEED_COMPRESSOR]: { 311: "0x1fA2637B9fab0CD14290A7EE908DDc9688a15120" },
-	[require_onchain_constants_address_provider.AP_MARKET_COMPRESSOR]: { 311: "0x0C27F242f6e9F2A9AD3261bE6e439De3B948bcA2" }
-} };
+const OVERRIDE_ADDRESSES = {};
 async function createAddressProvider(sdk, address) {
 	let v;
 	if (require_onchain_utils_hex.hexEq(address, "0xF7f0a609BfAb9a0A98786951ef10e5FE26cC1E38")) v = 310n;