@gearbox-protocol/sdk 15.1.0-next.2 → 15.1.0-next.20

package/dist/cjs/common-utils/charts/credit-session.js

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_sdk_utils_mappers = require("../../sdk/utils/mappers.js");
 const require_sdk_constants_math = require("../../sdk/constants/math.js");
+const require_sdk_utils_mappers = require("../../sdk/utils/mappers.js");
 const require_sdk_utils_formatter = require("../../sdk/utils/formatter.js");
 //#region src/common-utils/charts/credit-session.ts
 const CREDIT_SESSION_STATUS_BY_ID = {

package/dist/cjs/common-utils/index.js

@@ -2,6 +2,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_common_utils_axios_cache_AxiosCache = require("./axios-cache/AxiosCache.js");
 require("./axios-cache/index.js");
 const require_sdk_utils_bigint_math = require("../sdk/utils/bigint-math.js");
+const require_common_utils_utils_trace = require("./utils/trace.js");
 const require_common_utils_utils_creditAccount_quota_utils = require("./utils/creditAccount/quota-utils.js");
 const require_common_utils_charts_credit_manager = require("./charts/credit-manager.js");
 const require_common_utils_charts_credit_session = require("./charts/credit-session.js");
@@ -92,7 +93,6 @@ const require_common_utils_utils_strategies_strategy_info_get_cm_you_can_earn =
 const require_common_utils_utils_strategies_strategy_info_get_strategy_info_core = require("./utils/strategies/strategy-info/get-strategy-info-core.js");
 const require_common_utils_utils_strategies_strategy_info_get_strategy_info = require("./utils/strategies/strategy-info/get-strategy-info.js");
 const require_common_utils_utils_strategies_strategy_info_get_strategy_you_can_earn = require("./utils/strategies/strategy-info/get-strategy-you-can-earn.js");
-const require_common_utils_utils_trace = require("./utils/trace.js");
 require("./utils/index.js");
 exports.AssetUtils = require_common_utils_utils_assets_math.AssetUtils;
 exports.AxiosCache = require_common_utils_axios_cache_AxiosCache.AxiosCache;

package/dist/cjs/common-utils/utils/apy/get-single-quota-borrow-rate.js

@@ -5,6 +5,8 @@ const require_common_utils_utils_creditAccount_calc_quota_borrow_rate = require(
 /**
 * Under the hood sums up rates for all given quotas and then multiplies them by 1+feeInterest,
 * but it is expected that the ONLY quota will be passed
+*
+* @deprecated Use `calcBorrowRate` from `sdk/positions` instead.
 */
 function getSingleQuotaBorrowRate(props) {
 	const qr = require_common_utils_utils_creditAccount_calc_quota_borrow_rate.calcQuotaBorrowRate(props);

package/dist/cjs/common-utils/utils/creditAccount/calc-health-factor.js

@@ -1,10 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_sdk_utils_bigint_math = require("../../../sdk/utils/bigint-math.js");
-const require_sdk_constants_math = require("../../../sdk/constants/math.js");
-require("../../../sdk/index.js");
-const require_common_utils_utils_price_math = require("../price-math.js");
+const require_sdk_positions_calcHealthFactor = require("../../../sdk/positions/calcHealthFactor.js");
 //#region src/common-utils/utils/creditAccount/calc-health-factor.ts
-const MAX_UINT16 = 65535;
 /**
 * Computes account health factor in percentage-factor units.
 *
@@ -15,25 +11,31 @@ const MAX_UINT16 = 65535;
 * @param props Credit account balances, quotas, prices, thresholds, and debt context.
 * @returns Health factor as a number in `PERCENTAGE_FACTOR` scale,
 * or `65535` when debt is zero.
+*
+* @deprecated Use `calcHealthFactor` from `sdk/positions` instead; this
+* wrapper only maps the legacy props onto an `AccountSnapshot`.
 */
 function calcHealthFactor({ assets, quotas, quotasInfo, liquidationThresholds, underlyingToken, debt, prices, tokensList }) {
-	if (debt === 0n) return MAX_UINT16;
-	const underlyingDecimals = tokensList[underlyingToken]?.decimals || 18;
-	const underlyingPrice = prices[underlyingToken] || 0n;
-	const assetMoney = assets.reduce((acc, { token: tokenAddress, balance: amount }) => {
-		const tokenDecimals = tokensList[tokenAddress]?.decimals || 18;
-		const lt = liquidationThresholds[tokenAddress] || 0n;
-		const price = prices[tokenAddress] || 0n;
-		const tokenLtMoney = require_common_utils_utils_price_math.PriceUtils.calcTotalPrice(price, amount, tokenDecimals) * lt / require_sdk_constants_math.PERCENTAGE_FACTOR;
-		const { isActive = false } = quotasInfo?.[tokenAddress] || {};
-		const quota = quotas[tokenAddress];
-		const quotaBalance = isActive ? quota?.balance || 0n : 0n;
-		const quotaMoney = require_common_utils_utils_price_math.PriceUtils.calcTotalPrice(underlyingPrice, quotaBalance, underlyingDecimals);
-		return acc + (quota ? require_sdk_utils_bigint_math.BigIntMath.min(quotaMoney, tokenLtMoney) : tokenLtMoney);
-	}, 0n);
-	const borrowedMoney = require_common_utils_utils_price_math.PriceUtils.calcTotalPrice(underlyingPrice || require_sdk_constants_math.PRICE_DECIMALS, debt, underlyingDecimals);
-	const hfInPercent = borrowedMoney > 0n ? assetMoney * require_sdk_constants_math.PERCENTAGE_FACTOR / borrowedMoney : 0n;
-	return Number(hfInPercent);
+	const decimals = {};
+	for (const [token, meta] of Object.entries(tokensList)) decimals[token] = meta.decimals;
+	const lts = {};
+	for (const [token, lt] of Object.entries(liquidationThresholds)) lts[token] = Number(lt);
+	const activeQuotas = {};
+	for (const [token, info] of Object.entries(quotasInfo)) if (info?.isActive) activeQuotas[token] = true;
+	return require_sdk_positions_calcHealthFactor.calcHealthFactor({
+		snapshot: {
+			creditManager: underlyingToken,
+			assets,
+			quotas: Object.values(quotas),
+			totalDebt: debt,
+			totalValue: 0n
+		},
+		underlying: underlyingToken,
+		decimals,
+		prices,
+		liquidationThresholds: lts,
+		activeQuotas
+	});
 }
 //#endregion
 exports.calcHealthFactor = calcHealthFactor;

package/dist/cjs/common-utils/utils/creditAccount/calc-quota-borrow-rate.js

@@ -9,6 +9,8 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 *
 * @param props Quota balances and per-token quota rates.
 * @returns Sum of `balance * rate` terms in percentage-factor scale.
+*
+* @deprecated Use `calcBorrowRate` from `sdk/positions` instead.
 */
 function calcQuotaBorrowRate({ quotas, quotaRates }) {
 	return Object.values(quotas).reduce((acc, { token, balance }) => {

package/dist/cjs/common-utils/utils/creditAccount/get-time-to-liquidation.js

@@ -1,6 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_sdk_constants_math = require("../../../sdk/constants/math.js");
-require("../../../sdk/index.js");
+const require_sdk_positions_calcTimeToLiquidationMs = require("../../../sdk/positions/calcTimeToLiquidationMs.js");
 //#region src/common-utils/utils/creditAccount/get-time-to-liquidation.ts
 /**
 * Estimates time remaining until health factor reaches liquidation level.
@@ -9,13 +8,17 @@ require("../../../sdk/index.js");
 * and returns a millisecond duration until `healthFactor` decays to `1.0`
 * (`PERCENTAGE_FACTOR` in internal scale).
 *
-* @param props Current health factor and `totalBorrowRate * debt` term.
+* @param props Current health factor and `totalBorrowRate_debt`, both `Bps`
+* (`10000` = 100%) — not the legacy `PERCENTAGE_FACTOR_1KK` (`1_000_000` =
+* 100%) scale the pre-rewrite frontend fed this under the same name.
 * @returns Milliseconds to liquidation as `bigint`, or `null` when already at/under
 * liquidation threshold or when borrow-rate exposure is zero.
+*
+* @deprecated Use `calcTimeToLiquidationMs` from `sdk/positions` instead;
+* this wrapper only forwards to the new implementation.
 */
 function getTimeToLiquidation({ healthFactor, totalBorrowRate_debt }) {
-	if (healthFactor <= 10000n || totalBorrowRate_debt === 0n) return null;
-	return (BigInt(healthFactor) - require_sdk_constants_math.PERCENTAGE_FACTOR) * (BigInt(require_sdk_constants_math.SECONDS_PER_YEAR) * require_sdk_constants_math.PERCENTAGE_FACTOR * require_sdk_constants_math.PERCENTAGE_DECIMALS / totalBorrowRate_debt) * 1000n / require_sdk_constants_math.PERCENTAGE_FACTOR;
+	return require_sdk_positions_calcTimeToLiquidationMs.calcTimeToLiquidationMs(healthFactor, totalBorrowRate_debt);
 }
 //#endregion
 exports.getTimeToLiquidation = getTimeToLiquidation;

package/dist/cjs/common-utils/utils/creditAccount/liquidation-price.js

@@ -1,6 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_sdk_constants_math = require("../../../sdk/constants/math.js");
-require("../../../sdk/index.js");
+const require_sdk_positions_calcLiquidationPriceForTarget = require("../../../sdk/positions/calcLiquidationPriceForTarget.js");
 //#region src/common-utils/utils/creditAccount/liquidation-price.ts
 /**
 * Calculates target token liquidation price for a credit account.
@@ -13,17 +12,28 @@ require("../../../sdk/index.js");
 * @param props Debt context, assets, thresholds, and token metadata.
 * @returns Target token price in `PRICE_DECIMALS` precision that corresponds
 * to liquidation boundary; returns `0n` when target balance or LT is non-positive.
+*
+* @deprecated Use `calcLiquidationPriceForTarget` from `sdk/positions`
+* instead; this wrapper only maps the legacy props onto an `AccountSnapshot`.
 */
 function liquidationPrice({ liquidationThresholds, debt, underlyingToken, targetToken, assets, tokensList }) {
-	const underlyingDecimals = tokensList[underlyingToken]?.decimals || 18;
-	const { balance: underlyingBalance = 0n } = assets[underlyingToken] || {};
-	const effectiveDebt = (debt - underlyingBalance * (liquidationThresholds[underlyingToken] || 0n) / require_sdk_constants_math.PERCENTAGE_FACTOR) * require_sdk_constants_math.WAD / 10n ** BigInt(underlyingDecimals);
-	const targetDecimals = tokensList[targetToken]?.decimals || 18;
-	const { balance: targetBalance = 0n } = assets[targetToken] || {};
-	const effectiveTargetBalance = targetBalance * require_sdk_constants_math.WAD / 10n ** BigInt(targetDecimals);
-	const lpLT = liquidationThresholds[targetToken] || 0n;
-	if (targetBalance <= 0n || lpLT <= 0n) return 0n;
-	return effectiveDebt * require_sdk_constants_math.PRICE_DECIMALS * require_sdk_constants_math.PERCENTAGE_FACTOR / (effectiveTargetBalance * lpLT);
+	const decimals = {};
+	for (const [token, meta] of Object.entries(tokensList)) decimals[token] = meta.decimals;
+	const lts = {};
+	for (const [token, lt] of Object.entries(liquidationThresholds)) lts[token] = Number(lt);
+	return require_sdk_positions_calcLiquidationPriceForTarget.calcLiquidationPriceForTarget({
+		snapshot: {
+			creditManager: underlyingToken,
+			assets: Object.values(assets),
+			quotas: [],
+			totalDebt: debt,
+			totalValue: 0n
+		},
+		targetToken,
+		underlying: underlyingToken,
+		decimals,
+		liquidationThresholds: lts
+	});
 }
 //#endregion
 exports.liquidationPrice = liquidationPrice;

package/dist/cjs/common-utils/utils/index.js

@@ -1,5 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_sdk_utils_bigint_math = require("../../sdk/utils/bigint-math.js");
+const require_common_utils_utils_trace = require("./trace.js");
 const require_common_utils_utils_creditAccount_quota_utils = require("./creditAccount/quota-utils.js");
 const require_common_utils_utils_apy_bonus_apy_from_points = require("./apy/bonus-apy-from-points.js");
 const require_common_utils_utils_apy_calculate_borrow_rate_from_utilization = require("./apy/calculate-borrow-rate-from-utilization.js");
@@ -87,7 +88,6 @@ const require_common_utils_utils_strategies_strategy_info_get_strategy_info_core
 const require_common_utils_utils_strategies_strategy_info_get_strategy_info = require("./strategies/strategy-info/get-strategy-info.js");
 const require_common_utils_utils_strategies_strategy_info_get_strategy_you_can_earn = require("./strategies/strategy-info/get-strategy-you-can-earn.js");
 require("./strategies/index.js");
-const require_common_utils_utils_trace = require("./trace.js");
 require("./validation/index.js");
 exports.AssetUtils = require_common_utils_utils_assets_math.AssetUtils;
 exports.BONUS_APY_FROM_POINTS = require_common_utils_utils_apy_bonus_apy_from_points.BONUS_APY_FROM_POINTS;

package/dist/cjs/dev/AccountOpener.js

@@ -14,7 +14,6 @@ require("../sdk/index.js");
 const require_dev_abi = require("./abi.js");
 const require_dev_claimFromFaucet = require("./claimFromFaucet.js");
 const require_dev_createAnvilClient = require("./createAnvilClient.js");
-const require_dev_midasUtils = require("./midasUtils.js");
 const require_dev_mint_factory = require("./mint/factory.js");
 require("./mint/index.js");
 let viem = require("viem");
@@ -253,12 +252,6 @@ var AccountOpener = class extends require_sdk_base_SDKConstruct.SDKConstruct {
 			target
 		});
 		logger?.debug(strategy, "found open strategy");
-		const strategyCalls = await require_dev_midasUtils.prependMidasReceiveGreenlist({
-			cm,
-			client: this.#anvil,
-			calls: strategy.calls,
-			logger
-		});
 		const debt = minDebt * (leverage - require_sdk_constants_math.PERCENTAGE_FACTOR) / require_sdk_constants_math.PERCENTAGE_FACTOR;
 		const averageQuota = this.#getCollateralQuota(cm, target, strategy.amount, debt, logger);
 		const minQuota = this.#getCollateralQuota(cm, target, strategy.minAmount, debt, logger);
@@ -285,7 +278,7 @@ var AccountOpener = class extends require_sdk_base_SDKConstruct.SDKConstruct {
 				balance: minDebt
 			}],
 			debt,
-			calls: strategyCalls,
+			calls: strategy.calls,
 			ethAmount: 0n,
 			permits: {},
 			to: borrower.address,

package/dist/cjs/dev/index.js

@@ -2,8 +2,6 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_dev_abi = require("./abi.js");
 const require_dev_claimFromFaucet = require("./claimFromFaucet.js");
 const require_dev_createAnvilClient = require("./createAnvilClient.js");
-const require_dev_kycUtils = require("./kycUtils.js");
-const require_dev_midasUtils = require("./midasUtils.js");
 const require_dev_mint_factory = require("./mint/factory.js");
 require("./mint/index.js");
 const require_dev_AccountOpener = require("./AccountOpener.js");
@@ -16,8 +14,10 @@ const require_dev_detectChain = require("./detectChain.js");
 const require_dev_isOutOfSyncError = require("./isOutOfSyncError.js");
 const require_dev_isRateLimitError = require("./isRateLimitError.js");
 const require_dev_isTransientError = require("./isTransientError.js");
+const require_dev_kycUtils = require("./kycUtils.js");
 const require_dev_logSplitterTransport = require("./logSplitterTransport.js");
 const require_dev_ltUtils = require("./ltUtils.js");
+const require_dev_midasUtils = require("./midasUtils.js");
 const require_dev_migrateFaucet = require("./migrateFaucet.js");
 const require_dev_providers = require("./providers.js");
 const require_dev_replaceStorage = require("./replaceStorage.js");
@@ -72,7 +72,6 @@ exports.isTransientError = require_dev_isTransientError.isTransientError;
 exports.logSplitterTransport = require_dev_logSplitterTransport.logSplitterTransport;
 exports.makePendingWithdrawalsClaimable = require_dev_withdrawalUtils.makePendingWithdrawalsClaimable;
 exports.migrateFaucet = require_dev_migrateFaucet.migrateFaucet;
-exports.prependMidasReceiveGreenlist = require_dev_midasUtils.prependMidasReceiveGreenlist;
 exports.providerConfigSchema = require_dev_RevolverTransport.providerConfigSchema;
 exports.registerMidasInvestor = require_dev_kycUtils.registerMidasInvestor;
 exports.registerRWAInvestor = require_dev_kycUtils.registerRWAInvestor;

package/dist/cjs/dev/midasUtils.js

@@ -1,22 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_dev_withdrawalAbi = require("./withdrawalAbi.js");
 const require_dev_kycUtils = require("./kycUtils.js");
 let viem = require("viem");
 //#region src/dev/midasUtils.ts
-const ADAPTER_MIDAS_GATEWAY = "ADAPTER::MIDAS_GATEWAY";
-const ADAPTER_MIDAS_ISSUANCE_VAULT = "ADAPTER::MIDAS_ISSUANCE_VAULT";
-/**
-* Permissionless gateways have no greenlist and reject `receiveGreenlist`,
-* see MidasMode in integrations-v3
-*/
-const MIDAS_MODE_PERMISSIONLESS = 0;
-/**
-* Gateways and issuance vaults both expose their mToken, but only on-chain:
-* without the adapters plugin the SDK represents adapters as placeholders that
-* expose nothing but their target contract
-*/
-const iMidasMTokenAbi = (0, viem.parseAbi)(["function mToken() external view returns (address)"]);
-const iMidasGatewayAdapterExtAbi = (0, viem.parseAbi)(["function receiveGreenlist() external returns (bool)"]);
 /**
 * Midas vaults inherit their own `Pausable`, whose global pause is guarded by
 * `pauseAdminRole()` in the vault's access control instead of `Ownable`
@@ -29,76 +14,6 @@ const iMidasPausableVaultAbi = (0, viem.parseAbi)([
 	"function accessControl() external view returns (address)"
 ]);
 const iMidasAccessControlAbi = (0, viem.parseAbi)(["function hasRole(bytes32 role, address account) external view returns (bool)", "function grantRole(bytes32 role, address account) external"]);
-const receiveGreenlistCallData = (0, viem.encodeFunctionData)({
-	abi: iMidasGatewayAdapterExtAbi,
-	functionName: "receiveGreenlist"
-});
-/**
-* Prepends `MidasGatewayAdapter.receiveGreenlist()` to a credit facade
-* multicall that mints an mToken through a Midas issuance vault.
-*
-* Permissioned and restricted-interface mTokens can only be held by greenlisted
-* accounts, and a freshly opened credit account is never greenlisted, so the
-* mint reverts with `WMAC: hasnt role` unless the account asks the gateway for
-* the greenlist first. Greenlisting the borrower (see `registerMidasInvestor`)
-* is not enough — the role is checked on the token holder, which is the credit
-* account.
-*
-* Returns `calls` unchanged when nothing has to be greenlisted: no issuance
-* vault is called, its mToken has no gateway adapter on this credit manager,
-* the gateway is permissionless, or the call is already there.
-*/
-async function prependMidasReceiveGreenlist(props) {
-	const { cm, client, calls, logger } = props;
-	const gatewayAdapters = [];
-	const issuanceAdapters = [];
-	for (const adapter of cm.creditManager.adapters.values()) switch (adapter.contractType) {
-		case ADAPTER_MIDAS_GATEWAY:
-			gatewayAdapters.push(adapter);
-			break;
-		case ADAPTER_MIDAS_ISSUANCE_VAULT: issuanceAdapters.push(adapter);
-	}
-	if (gatewayAdapters.length === 0) return calls;
-	const calledIssuanceAdapters = issuanceAdapters.filter((adapter) => calls.some((call) => (0, viem.isAddressEqual)(call.target, adapter.address)));
-	if (calledIssuanceAdapters.length === 0) return calls;
-	const [gatewayMTokens, issuanceMTokens] = await Promise.all([readMTokens(client, gatewayAdapters), readMTokens(client, calledIssuanceAdapters)]);
-	const gateways = [];
-	for (const [i, mToken] of issuanceMTokens.entries()) {
-		const gateway = gatewayAdapters.find((_, j) => (0, viem.isAddressEqual)(gatewayMTokens[j], mToken));
-		if (!gateway) {
-			logger?.debug(`midas: no gateway adapter for mToken ${mToken} minted by ${calledIssuanceAdapters[i].address} on ${cm.name}, cannot greenlist the credit account`);
-			continue;
-		}
-		if (gateways.some((g) => (0, viem.isAddressEqual)(g.address, gateway.address))) continue;
-		if (calls.some((call) => (0, viem.isAddressEqual)(call.target, gateway.address) && call.callData === receiveGreenlistCallData)) {
-			logger?.debug(`midas: gateway adapter ${gateway.address} already receives the greenlist`);
-			continue;
-		}
-		gateways.push(gateway);
-	}
-	if (gateways.length === 0) return calls;
-	const modes = await client.multicall({
-		allowFailure: false,
-		contracts: gateways.map(({ targetContract }) => ({
-			address: targetContract,
-			abi: require_dev_withdrawalAbi.midasGatewayAbi,
-			functionName: "mode"
-		}))
-	});
-	const prepended = [];
-	for (const [i, gateway] of gateways.entries()) {
-		if (modes[i] === MIDAS_MODE_PERMISSIONLESS) {
-			logger?.debug(`midas: gateway ${gateway.targetContract} is permissionless, nothing to greenlist`);
-			continue;
-		}
-		logger?.debug(`midas: greenlisting the credit account via gateway adapter ${gateway.address}`);
-		prepended.push({
-			target: gateway.address,
-			callData: receiveGreenlistCallData
-		});
-	}
-	return prepended.length > 0 ? [...prepended, ...calls] : calls;
-}
 /**
 * Unpauses a globally paused Midas issuance vault on an anvil fork, so that
 * `depositInstant` stops reverting with `Pausable: paused`, and returns a
@@ -189,16 +104,5 @@ async function unpauseMidasIssuanceVault(props) {
 		}
 	};
 }
-async function readMTokens(client, adapters) {
-	return await client.multicall({
-		allowFailure: false,
-		contracts: adapters.map(({ targetContract }) => ({
-			address: targetContract,
-			abi: iMidasMTokenAbi,
-			functionName: "mToken"
-		}))
-	});
-}
 //#endregion
-exports.prependMidasReceiveGreenlist = prependMidasReceiveGreenlist;
 exports.unpauseMidasIssuanceVault = unpauseMidasIssuanceVault;

package/dist/cjs/dev/mode-parity/compareOpportunities.js

@@ -0,0 +1,105 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_model_opportunities = require("../../model/opportunities.js");
+const require_model_opportunities_schema = require("../../model/opportunities.schema.js");
+require("../../model/index.js");
+const require_dev_mode_parity_fieldDiff = require("./fieldDiff.js");
+const require_dev_mode_parity_compareRules = require("./compareRules.js");
+//#region src/dev/mode-parity/compareOpportunities.ts
+const tagDiff = require_dev_mode_parity_compareRules.makeTagDiff({
+	pool: require_dev_mode_parity_compareRules.compileCompareRules(require_model_opportunities_schema.poolOpportunitySchema),
+	strategy: require_dev_mode_parity_compareRules.compileCompareRules(require_model_opportunities_schema.strategyOpportunitySchema)
+});
+/**
+* Matches two opportunity listings by {@link opportunityId} and reports every
+* field the two sources disagree on.
+*
+* Nothing is filtered out. A field only the backend can fill, or a USD value
+* that drifted within snapshot-lag noise, is still reported — tagged
+* {@link FieldDiff.expected} so that {@link CompareCounts.clean} can ignore it
+* while {@link CompareCounts.identical} stays strict.
+**/
+function compareOpportunities(input) {
+	const onchainRows = indexById(input.onchain.data);
+	const offchainRows = indexById(input.offchain.data);
+	const onlyOnchain = [];
+	const onlyOffchain = [];
+	const matched = [];
+	for (const [id, row] of onchainRows) {
+		const counterpart = offchainRows.get(id);
+		if (!counterpart) {
+			onlyOnchain.push(toRef(row));
+			continue;
+		}
+		const diffs = diffOpportunity(row, counterpart);
+		matched.push({
+			id,
+			kind: row.kind,
+			chainId: row.chainId,
+			onchainName: row.name,
+			offchainName: counterpart.name,
+			identical: diffs.length === 0,
+			clean: diffs.every((diff) => diff.expected),
+			diffs
+		});
+	}
+	for (const [id, row] of offchainRows) if (!onchainRows.has(id)) onlyOffchain.push(toRef(row));
+	byId(onlyOnchain);
+	byId(onlyOffchain);
+	matched.sort((a, b) => a.id.localeCompare(b.id));
+	return {
+		generatedAt: input.generatedAt ?? (/* @__PURE__ */ new Date()).toISOString(),
+		backendUrl: input.backendUrl,
+		networks: [...input.networks],
+		onchainChains: input.onchain.meta.chains,
+		offchainChains: input.offchain.meta.chains,
+		summary: summarize(input.onchain.data, input.offchain.data, onlyOnchain, onlyOffchain, matched),
+		onlyOnchain,
+		onlyOffchain,
+		matched
+	};
+}
+function indexById(rows) {
+	return new Map(rows.map((row) => [require_model_opportunities.opportunityId(row), row]));
+}
+function byId(refs) {
+	refs.sort((a, b) => a.id.localeCompare(b.id));
+}
+function toRef(row) {
+	const base = {
+		id: require_model_opportunities.opportunityId(row),
+		kind: row.kind,
+		chainId: row.chainId,
+		name: row.name
+	};
+	return row.kind === "pool" ? {
+		...base,
+		pool: row.pool
+	} : {
+		...base,
+		creditManager: row.creditManager,
+		targetCollateral: row.targetCollateral.address
+	};
+}
+/**
+* Every field two versions of one opportunity disagree on.
+**/
+function diffOpportunity(onchain, offchain) {
+	return require_dev_mode_parity_fieldDiff.diffObjects(onchain, offchain).map((diff) => tagDiff(diff, onchain.kind));
+}
+function summarize(onchain, offchain, onlyOnchain, onlyOffchain, matched) {
+	const byChain = require_dev_mode_parity_fieldDiff.union(onchain.map((row) => String(row.chainId)), offchain.map((row) => String(row.chainId))).map((chainId) => ({
+		chainId: Number(chainId),
+		...require_dev_mode_parity_fieldDiff.toCompareCounts(onchain.filter((row) => String(row.chainId) === chainId).length, offchain.filter((row) => String(row.chainId) === chainId).length, onlyOnchain.filter((ref) => String(ref.chainId) === chainId).length, onlyOffchain.filter((ref) => String(ref.chainId) === chainId).length, matched.filter((match) => String(match.chainId) === chainId))
+	})).sort((a, b) => a.chainId - b.chainId);
+	return {
+		...require_dev_mode_parity_fieldDiff.toCompareCounts(onchain.length, offchain.length, onlyOnchain.length, onlyOffchain.length, matched),
+		byChain,
+		diffsByPath: require_dev_mode_parity_fieldDiff.countPaths(matched.flatMap((match) => match.diffs.map((diff) => ({
+			id: match.id,
+			diff
+		}))))
+	};
+}
+//#endregion
+exports.compareOpportunities = compareOpportunities;
+exports.diffOpportunity = diffOpportunity;

package/dist/cjs/dev/mode-parity/comparePositions.js

@@ -0,0 +1,160 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_model_liquidations_schema = require("../../model/liquidations.schema.js");
+const require_model_positions = require("../../model/positions.js");
+const require_model_positions_schema = require("../../model/positions.schema.js");
+require("../../model/index.js");
+const require_dev_mode_parity_fieldDiff = require("./fieldDiff.js");
+const require_dev_mode_parity_compareRules = require("./compareRules.js");
+//#region src/dev/mode-parity/comparePositions.ts
+const tagDiff = require_dev_mode_parity_compareRules.makeTagDiff({
+	pool: require_dev_mode_parity_compareRules.compileCompareRules(require_model_positions_schema.poolPositionSchema),
+	strategy: require_dev_mode_parity_compareRules.compileCompareRules(require_model_positions_schema.strategyPositionSchema),
+	liquidation: require_dev_mode_parity_compareRules.compileCompareRules(require_model_liquidations_schema.liquidationPositionSchema)
+});
+/**
+* Matches two position listings per wallet by {@link positionId} and reports
+* every field the two sources disagree on.
+*
+* Nothing is filtered out. A field only one mode can fill, or a USD value that
+* drifted within snapshot-lag noise, is still reported — tagged
+* {@link FieldDiff.expected} so that {@link CompareCounts.clean} can ignore it
+* while {@link CompareCounts.identical} stays strict.
+**/
+function comparePositions(input) {
+	const failures = input.failures ?? [];
+	const wallets = [...input.wallets.map(compareWallet), ...failures.map((failure) => ({
+		wallet: failure.wallet,
+		error: failure.error,
+		onlyOnchain: [],
+		onlyOffchain: [],
+		matched: []
+	}))];
+	wallets.sort((a, b) => a.wallet.localeCompare(b.wallet));
+	return {
+		generatedAt: input.generatedAt ?? (/* @__PURE__ */ new Date()).toISOString(),
+		backendUrl: input.backendUrl,
+		networks: [...input.networks],
+		onchainChains: collectChains(input.wallets, "onchain"),
+		offchainChains: collectChains(input.wallets, "offchain"),
+		summary: summarize(input.wallets, wallets, failures.length),
+		wallets
+	};
+}
+/**
+* Every field two versions of one position disagree on.
+**/
+function diffPosition(onchain, offchain) {
+	return require_dev_mode_parity_fieldDiff.diffObjects(onchain, offchain, { keyOf: keyOfPositionArray }).map((diff) => tagDiff(diff, onchain.kind));
+}
+function compareWallet(input) {
+	const onchainRows = indexById(input.onchain.data);
+	const offchainRows = indexById(input.offchain.data);
+	const onlyOnchain = [];
+	const onlyOffchain = [];
+	const matched = [];
+	for (const [id, row] of onchainRows) {
+		const counterpart = offchainRows.get(id);
+		if (!counterpart) {
+			onlyOnchain.push(toRef(row));
+			continue;
+		}
+		const diffs = diffPosition(row, counterpart);
+		matched.push({
+			id,
+			kind: row.kind,
+			chainId: row.chainId,
+			onchainName: row.name,
+			offchainName: counterpart.name,
+			identical: diffs.length === 0,
+			clean: diffs.every((diff) => diff.expected),
+			diffs
+		});
+	}
+	for (const [id, row] of offchainRows) if (!onchainRows.has(id)) onlyOffchain.push(toRef(row));
+	onlyOnchain.sort((a, b) => a.id.localeCompare(b.id));
+	onlyOffchain.sort((a, b) => a.id.localeCompare(b.id));
+	matched.sort((a, b) => a.id.localeCompare(b.id));
+	return {
+		wallet: input.wallet,
+		onlyOnchain,
+		onlyOffchain,
+		matched
+	};
+}
+function indexById(rows) {
+	return new Map(rows.map((row) => [require_model_positions.positionId(row), row]));
+}
+function toRef(row) {
+	const base = {
+		id: require_model_positions.positionId(row),
+		kind: row.kind,
+		chainId: row.chainId,
+		name: row.name
+	};
+	switch (row.kind) {
+		case "pool": return {
+			...base,
+			pool: row.pool
+		};
+		case "strategy": return {
+			...base,
+			creditAccount: row.creditAccount,
+			creditManager: row.creditManager
+		};
+		case "liquidation": return base;
+	}
+}
+/**
+* `collaterals[]` is keyed by the collateral token, not by a top-level
+* address. Rewards-points programs already identify themselves by `id`.
+**/
+function keyOfPositionArray(path, value) {
+	if (path !== "collaterals" || !require_dev_mode_parity_fieldDiff.isRecord(value) || !require_dev_mode_parity_fieldDiff.isRecord(value.collateral)) return;
+	const token = value.collateral.token;
+	return require_dev_mode_parity_fieldDiff.isRecord(token) && typeof token.address === "string" ? token.address : void 0;
+}
+function summarize(inputs, wallets, failed) {
+	const compared = wallets.filter((wallet) => !wallet.error);
+	const allOnchain = inputs.flatMap((input) => input.onchain.data);
+	const allOffchain = inputs.flatMap((input) => input.offchain.data);
+	const onlyOnchain = compared.flatMap((wallet) => wallet.onlyOnchain);
+	const onlyOffchain = compared.flatMap((wallet) => wallet.onlyOffchain);
+	const matched = compared.flatMap((wallet) => wallet.matched);
+	const byChain = require_dev_mode_parity_fieldDiff.union(allOnchain.map((row) => String(row.chainId)), allOffchain.map((row) => String(row.chainId))).map((chainId) => ({
+		chainId: Number(chainId),
+		...require_dev_mode_parity_fieldDiff.toCompareCounts(allOnchain.filter((row) => String(row.chainId) === chainId).length, allOffchain.filter((row) => String(row.chainId) === chainId).length, onlyOnchain.filter((ref) => String(ref.chainId) === chainId).length, onlyOffchain.filter((ref) => String(ref.chainId) === chainId).length, matched.filter((match) => String(match.chainId) === chainId))
+	})).sort((a, b) => a.chainId - b.chainId);
+	const byWallet = wallets.map((wallet) => ({
+		wallet: wallet.wallet,
+		...wallet.error ? { error: wallet.error } : {},
+		...require_dev_mode_parity_fieldDiff.toCompareCounts(wallet.matched.length + wallet.onlyOnchain.length, wallet.matched.length + wallet.onlyOffchain.length, wallet.onlyOnchain.length, wallet.onlyOffchain.length, wallet.matched)
+	}));
+	const walletsClean = compared.filter((wallet) => wallet.onlyOnchain.length === 0 && wallet.onlyOffchain.length === 0 && wallet.matched.every((match) => match.clean)).length;
+	return {
+		...require_dev_mode_parity_fieldDiff.toCompareCounts(allOnchain.length, allOffchain.length, onlyOnchain.length, onlyOffchain.length, matched),
+		wallets: wallets.length,
+		walletsClean,
+		walletsFailed: failed,
+		byChain,
+		byWallet,
+		diffsByPath: require_dev_mode_parity_fieldDiff.countPaths(matched.flatMap((match) => match.diffs.map((diff) => ({
+			id: match.id,
+			diff
+		}))))
+	};
+}
+/**
+* One metadata entry per chain, preferring a success so the report names the
+* block. Later wallets of the same chain are ignored.
+**/
+function collectChains(wallets, side) {
+	const byChain = /* @__PURE__ */ new Map();
+	for (const wallet of wallets) for (const chain of wallet[side].meta.chains) {
+		const existing = byChain.get(chain.chainId);
+		if (!existing || existing.status !== "success" && chain.status === "success") byChain.set(chain.chainId, chain);
+	}
+	return [...byChain.values()].sort((a, b) => a.chainId - b.chainId);
+}
+//#endregion
+exports.comparePositions = comparePositions;
+exports.diffPosition = diffPosition;