@gearbox-protocol/sdk 15.1.0-next.10 → 15.1.0-next.12

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

@@ -0,0 +1,131 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_dev_providers = require("../providers.js");
+let pino = require("pino");
+//#region src/dev/mode-parity/scriptUtils.ts
+const NETWORKS = [
+	"Mainnet",
+	"Monad",
+	"Plasma",
+	"Somnia",
+	"Etherlink"
+];
+const BACKEND_URL = process.env.BACKEND_URL ?? "https://api.gear-dev.dev";
+const TIMEOUT = 48e4;
+function requireEnv(name) {
+	const value = process.env[name];
+	if (!value) throw new Error(`${name} is required to reach the chains this script reads`);
+	return value;
+}
+function rpcUrls() {
+	const alchemyKey = requireEnv("ALCHEMY_KEY");
+	const alchemy = (network) => {
+		const url = require_dev_providers.getAlchemyUrl(network, alchemyKey);
+		if (!url) throw new Error(`Alchemy serves no URL for ${network}`);
+		return url;
+	};
+	return {
+		Mainnet: alchemy("Mainnet"),
+		Monad: alchemy("Monad"),
+		Plasma: alchemy("Plasma"),
+		Somnia: requireEnv("SOMNIA_PROVIDER"),
+		Etherlink: requireEnv("ETHERLINK_PROVIDER")
+	};
+}
+function createLogger() {
+	return (0, pino.pino)({
+		level: process.env.LOG_LEVEL ?? "info",
+		formatters: {
+			bindings: () => ({}),
+			level: (label) => ({ level: label })
+		}
+	});
+}
+function errorMessage(error) {
+	return error instanceof Error ? error.message : String(error);
+}
+/**
+* Runs `fn` over `items` with at most `concurrency` in flight.
+**/
+async function mapPool(items, concurrency, fn) {
+	let next = 0;
+	const workers = Array.from({ length: Math.min(concurrency, items.length) }, async () => {
+		while (true) {
+			const index = next;
+			next += 1;
+			if (index >= items.length) return;
+			await fn(items[index]);
+		}
+	});
+	await Promise.all(workers);
+}
+/**
+* Formats a relative difference in bps as a percent, e.g. 12.5 → `"0.125%"`.
+**/
+function formatBpsAsPercent(bps) {
+	if (!Number.isFinite(bps)) return "";
+	const percent = bps / 100;
+	if (percent === 0) return "0%";
+	return `${Math.abs(percent) >= 1 ? trimTrailingZeros(percent.toFixed(3)) : trimTrailingZeros(percent.toPrecision(4))}%`;
+}
+function trimTrailingZeros(value) {
+	return value.includes(".") ? value.replace(/\.?0+$/, "") : value;
+}
+function worstColumns(worst) {
+	return {
+		"max diff": worst ? formatBpsAsPercent(worst.bps) : "",
+		"worst entity": worst?.id ?? ""
+	};
+}
+/**
+* Prints the shared membership table, the fields that differed most often,
+* and any chain that failed to answer.
+**/
+function printCompareSummary(noun, report, extraLines = []) {
+	const { summary } = report;
+	console.log(`\n${noun} from ${report.backendUrl} vs the chain`);
+	console.table(summary.byChain.map((chain) => ({
+		chain: chain.chainId,
+		onchain: chain.onchainRows,
+		offchain: chain.offchainRows,
+		matched: chain.matched,
+		identical: chain.identical,
+		clean: chain.clean,
+		differing: chain.differing,
+		"only onchain": chain.onlyOnchain,
+		"only offchain": chain.onlyOffchain
+	})));
+	for (const line of extraLines) console.log(line);
+	const unexpected = summary.diffsByPath.filter((entry) => entry.unexpected > 0);
+	const expected = summary.diffsByPath.filter((entry) => entry.unexpected === 0 && entry.expected > 0);
+	if (unexpected.length) {
+		console.log("\nunexpected fields that differed most often:");
+		console.table(unexpected.slice(0, 25).map((entry) => ({
+			field: entry.path,
+			unexpected: entry.unexpected,
+			expected: entry.expected,
+			kinds: entry.kinds.join(", "),
+			...worstColumns(entry.worstUnexpected)
+		})));
+	}
+	if (expected.length) {
+		console.log("\nexpected fields (mode-scoped or within tolerance):");
+		console.table(expected.slice(0, 25).map((entry) => ({
+			field: entry.path,
+			rows: entry.expected,
+			kinds: entry.kinds.join(", "),
+			...worstColumns(entry.worstExpected)
+		})));
+	}
+	for (const chain of [...report.onchainChains, ...report.offchainChains]) if (chain.status === "error") console.log(`chain ${chain.chainId} failed on ${chain.source}:`, chain.error);
+}
+//#endregion
+exports.BACKEND_URL = BACKEND_URL;
+exports.NETWORKS = NETWORKS;
+exports.TIMEOUT = TIMEOUT;
+exports.createLogger = createLogger;
+exports.errorMessage = errorMessage;
+exports.formatBpsAsPercent = formatBpsAsPercent;
+exports.mapPool = mapPool;
+exports.printCompareSummary = printCompareSummary;
+exports.requireEnv = requireEnv;
+exports.rpcUrls = rpcUrls;

package/dist/cjs/model/compare.schema.js

@@ -0,0 +1,33 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/model/compare.schema.ts
+/**
+* Marks a field that only the backend fills.
+**/
+function offchainOnly(schema) {
+	return schema.meta({ compare: "offchainOnly" });
+}
+/**
+* Marks a field that only the chain fills.
+**/
+function onchainOnly(schema) {
+	return schema.meta({ compare: "onchainOnly" });
+}
+/**
+* Marks a numeric field whose two sources may drift within {@link kind}.
+**/
+function tolerance(schema, kind) {
+	return schema.meta({ compare: { tolerance: kind } });
+}
+/**
+* The compare tag registered on a schema, if any.
+**/
+function compareTagOf(schema) {
+	const meta = schema.meta();
+	if (!meta || !("compare" in meta)) return;
+	return meta.compare;
+}
+//#endregion
+exports.compareTagOf = compareTagOf;
+exports.offchainOnly = offchainOnly;
+exports.onchainOnly = onchainOnly;
+exports.tolerance = tolerance;

package/dist/cjs/model/curators.schema.js

@@ -1,5 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_sdk_utils_zod = require("../sdk/utils/zod.js");
+const require_model_compare_schema = require("./compare.schema.js");
 let zod_v4 = require("zod/v4");
 //#region src/model/curators.schema.ts
 /**
@@ -31,7 +32,7 @@ const curatorNameSchema = zod_v4.z.enum([
 const curatorSchema = zod_v4.z.object({
 	address: require_sdk_utils_zod.ZodAddress(),
 	name: curatorNameSchema.optional(),
-	url: zod_v4.z.string().nullable()
+	url: require_model_compare_schema.offchainOnly(zod_v4.z.string().nullable())
 });
 //#endregion
 exports.curatorNameSchema = curatorNameSchema;

package/dist/cjs/model/index.js

@@ -1,5 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_model_charts = require("./charts.js");
+const require_model_compare_schema = require("./compare.schema.js");
 const require_model_primitives_schema = require("./primitives.schema.js");
 const require_model_charts_schema = require("./charts.schema.js");
 require("./curators.js");
@@ -45,6 +46,7 @@ exports.chartRangeSchema = require_model_charts_schema.chartRangeSchema;
 exports.chartSeriesSchema = require_model_charts_schema.chartSeriesSchema;
 exports.chartValueSchema = require_model_charts_schema.chartValueSchema;
 exports.chartWindowSchema = require_model_charts_schema.chartWindowSchema;
+exports.compareTagOf = require_model_compare_schema.compareTagOf;
 exports.curatorNameSchema = require_model_curators_schema.curatorNameSchema;
 exports.curatorSchema = require_model_curators_schema.curatorSchema;
 exports.dataSourceSchema = require_model_response_schema.dataSourceSchema;
@@ -66,6 +68,8 @@ exports.matchesOpportunityFilter = require_model_opportunities.matchesOpportunit
 exports.matchesPositionFilter = require_model_positions.matchesPositionFilter;
 exports.noticeKindSchema = require_model_notices_schema.noticeKindSchema;
 exports.noticeSchema = require_model_notices_schema.noticeSchema;
+exports.offchainOnly = require_model_compare_schema.offchainOnly;
+exports.onchainOnly = require_model_compare_schema.onchainOnly;
 exports.opportunityBaseSchema = require_model_opportunities_schema.opportunityBaseSchema;
 exports.opportunityDetailSchema = require_model_opportunities_schema.opportunityDetailSchema;
 exports.opportunityFilterQueryParamsSchema = require_model_opportunities_schema.opportunityFilterQueryParamsSchema;
@@ -124,4 +128,5 @@ exports.tokenAmountSchema = require_model_primitives_schema.tokenAmountSchema;
 exports.tokenRewardsPnLSchema = require_model_positions_schema.tokenRewardsPnLSchema;
 exports.tokenRewardsSchema = require_model_opportunities_schema.tokenRewardsSchema;
 exports.tokenSchema = require_model_primitives_schema.tokenSchema;
+exports.tolerance = require_model_compare_schema.tolerance;
 exports.txCallSchema = require_model_primitives_schema.txCallSchema;

package/dist/cjs/model/opportunities.schema.js

@@ -1,5 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_sdk_utils_zod = require("../sdk/utils/zod.js");
+const require_model_compare_schema = require("./compare.schema.js");
 const require_model_primitives_schema = require("./primitives.schema.js");
 const require_model_curators_schema = require("./curators.schema.js");
 const require_model_filters = require("./filters.js");
@@ -46,9 +47,9 @@ const rewardsSchema = zod_v4.z.discriminatedUnion("kind", [tokenRewardsSchema, p
 * {@link ApyBreakdown}
 **/
 const apyBreakdownSchema = zod_v4.z.object({
-	totalApy: require_model_primitives_schema.bpsSchema.optional(),
-	organicApy: require_model_primitives_schema.bpsSchema,
-	rewards: zod_v4.z.array(rewardsSchema).optional()
+	totalApy: require_model_compare_schema.offchainOnly(require_model_primitives_schema.bpsSchema).optional(),
+	organicApy: require_model_compare_schema.tolerance(require_model_primitives_schema.bpsSchema, "bps"),
+	rewards: require_model_compare_schema.offchainOnly(zod_v4.z.array(rewardsSchema)).optional()
 });
 /**
 * {@link OpportunityBase}
@@ -71,9 +72,9 @@ const poolOpportunitySchema = zod_v4.z.object({
 	...opportunityBaseSchema.shape,
 	kind: zod_v4.z.literal("pool"),
 	pool: require_sdk_utils_zod.ZodAddress(),
-	totalSupply: require_model_primitives_schema.amountSchema,
-	availableLiquidity: require_model_primitives_schema.amountSchema,
-	utilization: require_model_primitives_schema.bpsSchema,
+	totalSupply: require_model_compare_schema.tolerance(require_model_primitives_schema.amountSchema, "amount"),
+	availableLiquidity: require_model_compare_schema.tolerance(require_model_primitives_schema.amountSchema, "amount"),
+	utilization: require_model_compare_schema.tolerance(require_model_primitives_schema.bpsSchema, "bps"),
 	supplyApy: apyBreakdownSchema
 });
 /**
@@ -88,12 +89,12 @@ const strategyOpportunitySchema = zod_v4.z.object({
 	liquidationPremium: require_model_primitives_schema.bpsSchema,
 	liquidationFee: require_model_primitives_schema.bpsSchema,
 	expirationDate: require_model_primitives_schema.timestampSchema.nullable(),
-	collateralApy: apyBreakdownSchema.optional(),
-	maxLeverageApy: apyBreakdownSchema.optional(),
-	borrowApy: require_model_primitives_schema.bpsSchema.optional(),
-	additionalBorrowApy: require_model_primitives_schema.bpsSchema.optional(),
-	totalValue: require_model_primitives_schema.amountSchema.optional(),
-	utilization: require_model_primitives_schema.bpsSchema.optional(),
+	collateralApy: require_model_compare_schema.offchainOnly(apyBreakdownSchema).optional(),
+	maxLeverageApy: require_model_compare_schema.offchainOnly(apyBreakdownSchema).optional(),
+	borrowApy: require_model_compare_schema.tolerance(require_model_primitives_schema.bpsSchema, "bps").optional(),
+	additionalBorrowApy: require_model_compare_schema.tolerance(require_model_primitives_schema.bpsSchema, "bps").optional(),
+	totalValue: require_model_compare_schema.offchainOnly(require_model_primitives_schema.amountSchema).optional(),
+	utilization: require_model_compare_schema.offchainOnly(require_model_primitives_schema.bpsSchema).optional(),
 	maxBorrowAmount: require_model_primitives_schema.amountSchema,
 	maxLeverage: require_model_primitives_schema.leverageSchema
 });

package/dist/cjs/model/positions.schema.js

@@ -1,5 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_sdk_utils_zod = require("../sdk/utils/zod.js");
+const require_model_compare_schema = require("./compare.schema.js");
 const require_model_primitives_schema = require("./primitives.schema.js");
 const require_model_filters = require("./filters.js");
 const require_model_filters_schema = require("./filters.schema.js");
@@ -56,8 +57,8 @@ const pnlBreakdownSchema = zod_v4.z.object({
 * {@link PositionCollateral}
 **/
 const positionCollateralSchema = zod_v4.z.object({
-	collateral: require_model_primitives_schema.tokenAmountSchema,
-	quota: require_model_primitives_schema.tokenAmountSchema,
+	collateral: require_model_compare_schema.tolerance(require_model_primitives_schema.tokenAmountSchema, "amount"),
+	quota: require_model_compare_schema.tolerance(require_model_primitives_schema.tokenAmountSchema, "amount"),
 	withdrawals: zod_v4.z.array(require_model_liquidations_schema.delayedReceivedAssetSchema)
 });
 /**
@@ -68,9 +69,9 @@ const poolPositionSchema = zod_v4.z.object({
 	name: zod_v4.z.string(),
 	chainId: require_model_primitives_schema.chainIdSchema,
 	pool: require_sdk_utils_zod.ZodAddress(),
-	netValue: require_model_primitives_schema.tokenAmountSchema,
+	netValue: require_model_compare_schema.tolerance(require_model_primitives_schema.tokenAmountSchema, "amount"),
 	apy: require_model_opportunities_schema.apyBreakdownSchema,
-	pnl: pnlBreakdownSchema.optional()
+	pnl: require_model_compare_schema.offchainOnly(pnlBreakdownSchema).optional()
 });
 /**
 * {@link BorrowRateBreakdown}
@@ -91,16 +92,16 @@ const strategyPositionSchema = zod_v4.z.object({
 	creditManager: require_sdk_utils_zod.ZodAddress(),
 	creditAccount: require_sdk_utils_zod.ZodAddress(),
 	targetCollateral: require_model_primitives_schema.tokenSchema.nullable(),
-	leverage: require_model_primitives_schema.leverageSchema,
-	borrowApy: require_model_primitives_schema.bpsSchema,
-	netApy: require_model_opportunities_schema.apyBreakdownSchema.optional(),
-	totalDebt: require_model_primitives_schema.tokenAmountSchema,
-	totalValue: require_model_primitives_schema.tokenAmountSchema,
-	healthFactor: require_model_primitives_schema.bpsSchema,
-	borrowRate: borrowRateBreakdownSchema.optional(),
-	timeToLiquidation: require_sdk_utils_zod.ZodBigInt().nullable().optional(),
-	liquidationPrice: require_sdk_utils_zod.ZodBigInt().nullable().optional(),
-	pnl: pnlBreakdownSchema.optional(),
+	leverage: require_model_compare_schema.tolerance(require_model_primitives_schema.leverageSchema, "float"),
+	borrowApy: require_model_compare_schema.tolerance(require_model_primitives_schema.bpsSchema, "bps"),
+	netApy: require_model_compare_schema.offchainOnly(require_model_opportunities_schema.apyBreakdownSchema).optional(),
+	totalDebt: require_model_compare_schema.tolerance(require_model_primitives_schema.tokenAmountSchema, "amount"),
+	totalValue: require_model_compare_schema.tolerance(require_model_primitives_schema.tokenAmountSchema, "amount"),
+	healthFactor: require_model_compare_schema.tolerance(require_model_primitives_schema.bpsSchema, "bps"),
+	borrowRate: require_model_compare_schema.onchainOnly(borrowRateBreakdownSchema).optional(),
+	timeToLiquidation: require_model_compare_schema.onchainOnly(require_sdk_utils_zod.ZodBigInt().nullable()).optional(),
+	liquidationPrice: require_model_compare_schema.onchainOnly(require_sdk_utils_zod.ZodBigInt().nullable()).optional(),
+	pnl: require_model_compare_schema.offchainOnly(pnlBreakdownSchema).optional(),
 	collaterals: zod_v4.z.array(positionCollateralSchema)
 });
 /**

package/dist/cjs/model/primitives.schema.js

@@ -1,5 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_sdk_utils_zod = require("../sdk/utils/zod.js");
+const require_model_compare_schema = require("./compare.schema.js");
 let zod_v4 = require("zod/v4");
 //#region src/model/primitives.schema.ts
 /**
@@ -40,7 +41,7 @@ const leverageSchema = zod_v4.z.number().nonnegative();
 **/
 const amountSchema = zod_v4.z.object({
 	value: require_sdk_utils_zod.ZodBigInt(),
-	valueUsd: zod_v4.z.number().nullable()
+	valueUsd: require_model_compare_schema.tolerance(zod_v4.z.number().nullable(), "usd")
 });
 /**
 * {@link Token}

package/dist/cjs/sdk/market/math.js

@@ -24,8 +24,15 @@ function rayToBps(ray) {
 	return Number(ray * require_sdk_constants_math.PERCENTAGE_FACTOR / require_sdk_constants_math.RAY);
 }
 /**
+* Raw 8-decimal USD values below this are compressor leftover dust (typically
+* 1-wei balances on empty accounts) and report as `0`.
+**/
+const USD_DUST_THRESHOLD = 1000n;
+/**
 * Converts a USD value in the oracle's 8-decimal fixed point to a float.
 *
+* Values below {@link USD_DUST_THRESHOLD} report as `0`.
+*
 * @example
 * ```ts
 * // usd: $1500.50 in 8-decimal fixed point
@@ -33,7 +40,7 @@ function rayToBps(ray) {
 * ```
 **/
 function usdToNumber(usd) {
-	return Number(usd) / Number(require_sdk_constants_math.PRICE_DECIMALS);
+	return usd < USD_DUST_THRESHOLD ? 0 : Number(usd) / Number(require_sdk_constants_math.PRICE_DECIMALS);
 }
 /**
 * Share of capital currently borrowed, in basis points. Returns `0` when there

package/dist/cjs/sdk/pools/PoolService.js

@@ -415,7 +415,7 @@ var PoolService = class extends require_sdk_base_SDKConstruct.SDKConstruct {
 		const { pool } = market.pool;
 		return {
 			kind: "pool",
-			name: market.poolName,
+			name: this.sdk.tokensMeta.mustGetToken(pool.address).name,
 			chainId: this.chainId,
 			pool: pool.address,
 			netValue: {

package/dist/cjs/sdk/positions/PositionsService.js

@@ -2,6 +2,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_sdk_utils_AddressMap = require("../utils/AddressMap.js");
 require("../constants/math.js");
 require("../constants/index.js");
+const require_sdk_utils_hex = require("../utils/hex.js");
 require("../utils/index.js");
 const require_sdk_base_SDKConstruct = require("../base/SDKConstruct.js");
 require("../base/index.js");
@@ -147,7 +148,11 @@ var PositionsService = class extends require_sdk_base_SDKConstruct.SDKConstruct
 		const { pool } = market.pool;
 		const token = this.sdk.tokensMeta.mustGetToken(market.unwrappedUnderlying);
 		const totalDebtValue = ca.debt + ca.accruedInterest + ca.accruedFees;
-		const collateral = require_sdk_market_credit_dominantCollateral.dominantCollateral(ca, market);
+		let collateral = require_sdk_market_credit_dominantCollateral.dominantCollateral(ca, market);
+		if (collateral) {
+			const source = this.sdk.withdrawalCompressor?.getWithdrawalSourceToken(collateral);
+			if (source) collateral = require_sdk_utils_hex.hexEq(source, market.underlying) ? void 0 : source;
+		}
 		const snapshot = require_sdk_positions_types.accountSnapshotFromCreditAccountData(ca);
 		const borrowRate = this.borrowRate(snapshot);
 		const timeToLiquidation = this.timeToLiquidation(snapshot);

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

@@ -1,7 +1,8 @@
-import { AxiosCache } from "./axios-cache/AxiosCache.js";
-import "./axios-cache/index.js";
 import { BigIntMath } from "../sdk/utils/bigint-math.js";
 import { calcDefaultQuota, calcQuotaUpdate, calcRecommendedQuota, roundUpQuota } from "./utils/creditAccount/quota-utils.js";
+import { EXECUTE_BYTES_SELECTOR, collectTraces, findCallTo, findCallWithInput, findExecuteBytes, resolveProtocolCall } from "./utils/trace.js";
+import { AxiosCache } from "./axios-cache/AxiosCache.js";
+import "./axios-cache/index.js";
 import { ChartsCreditManagerData } from "./charts/credit-manager.js";
 import { CREDIT_SESSION_ID_BY_STATUS, CREDIT_SESSION_STATUS_BY_ID, CreditSession, CreditSessionFiltered, UserCreditSessionsBuilder } from "./charts/credit-session.js";
 import { ChartsPoolData, UserPoolData } from "./charts/pool.js";
@@ -91,6 +92,5 @@ import { getCMYouCanEarn } from "./utils/strategies/strategy-info/get-cm-you-can
 import { getStrategyInfoCore } from "./utils/strategies/strategy-info/get-strategy-info-core.js";
 import { getStrategyInfo } from "./utils/strategies/strategy-info/get-strategy-info.js";
 import { getStrategyYouCanEarn } from "./utils/strategies/strategy-info/get-strategy-you-can-earn.js";
-import { EXECUTE_BYTES_SELECTOR, collectTraces, findCallTo, findCallWithInput, findExecuteBytes, resolveProtocolCall } from "./utils/trace.js";
 import "./utils/index.js";
 export { AssetUtils, AxiosCache, BONUS_APY_FROM_POINTS, BigIntMath, CREDIT_SESSION_ID_BY_STATUS, CREDIT_SESSION_STATUS_BY_ID, ChartsCreditManagerData, ChartsPoolData, CreditSession, CreditSessionFiltered, EMPTY_ADDRESS, EMPTY_ARRAY, EMPTY_OBJECT, EXECUTE_BYTES_SELECTOR, MIN_HF_LIMITED, PriceUtils, RST_ETH_ADDRESS, TokenData, UserCreditSessionsBuilder, UserPoolData, addAmountInTarget, amountAbcComparator, assetComparator, calcDefaultQuota, calcHealthFactor, calcMaxDebtIncrease, calcMaxLendingDebt, calcOverallAPY, calcQuotaBorrowRate, calcQuotaUpdate, calcRecommendedQuota, calcRelativeBaseBorrowRate, calculateBorrowRateFromUtilization, calculateEarnings, calculateEffectiveBorrowRate, calculateLossCoefficient, calculateMaxLeverageFactor, calculateMaxStrategyDebt, calculateSafeBorrowRate, calculateTotalAPY, calculateTotalPoints, checkBoolean, checkDegenNFT, cmAvailabilityCondition, collectTraces, createLegacyStrategyDataSource, findCallTo, findCallWithInput, findExecuteBytes, getAvailableAndDisabledStrategies, getCMAllowedCollaterals, getCMYouCanEarn, getChainPhantomTokens, getCollateralByDebt, getComplexAPYList, getComplexPointsList, getDefaultAsset, getFactorFromLeverage, getLeverageFromFactor, getListWithAmountInTarget, getNativeTokenAddress, getPointsInfo, getPointsRates, getRateWithFee, getRecommendedDebt, getRecommendedLeverageFactor, getReleasedStrategiesList, getReleasedStrategiesListCore, getSafeBaseBorrowRate, getSingleQuotaBorrowRate, getStrategyCreditManagers, getStrategyCreditManagersList, getStrategyCreditManagersListCore, getStrategyInfo, getStrategyInfoCore, getStrategyMaxAPY, getStrategyPoints, getStrategyYouCanEarn, getTimeToLiquidation, getWalletBalancesAllowedOnCM, isActivatedToken, isApyWithPointsException, isCollateralToken, isCreditManagerUsable, isForbiddenToken, isObtainableToken, isStrategyCMDisabled, isStrategyDisabled, isStrategyEligible, isStrategyReleased, isUsableToken, isValidExtraCollateralToken, isZeroBalance, liquidationPrice, maxAPYFormula, maxLeverage, maxLeverageThreshold, resolveProtocolCall, roundUpQuota, sortAssets, sortBalances, sortStrategyCMsByAvailability, tokensAbcComparator, validateBalance, validateBalances, validateCreditManager, validateHF, validateOpenAccount, validateOpenAccountPoolQuotaStatus, validateOpenAccountPoolStatus, validateQuota, validateTokenToObtain, wrapTokenAddress };

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

@@ -1,5 +1,6 @@
 import { BigIntMath } from "../../sdk/utils/bigint-math.js";
 import { calcDefaultQuota, calcQuotaUpdate, calcRecommendedQuota, roundUpQuota } from "./creditAccount/quota-utils.js";
+import { EXECUTE_BYTES_SELECTOR, collectTraces, findCallTo, findCallWithInput, findExecuteBytes, resolveProtocolCall } from "./trace.js";
 import { BONUS_APY_FROM_POINTS } from "./apy/bonus-apy-from-points.js";
 import { calculateBorrowRateFromUtilization } from "./apy/calculate-borrow-rate-from-utilization.js";
 import { PriceUtils } from "./price-math.js";
@@ -86,6 +87,5 @@ import { getStrategyInfoCore } from "./strategies/strategy-info/get-strategy-inf
 import { getStrategyInfo } from "./strategies/strategy-info/get-strategy-info.js";
 import { getStrategyYouCanEarn } from "./strategies/strategy-info/get-strategy-you-can-earn.js";
 import "./strategies/index.js";
-import { EXECUTE_BYTES_SELECTOR, collectTraces, findCallTo, findCallWithInput, findExecuteBytes, resolveProtocolCall } from "./trace.js";
 import "./validation/index.js";
 export { AssetUtils, BONUS_APY_FROM_POINTS, BigIntMath, EMPTY_ADDRESS, EMPTY_ARRAY, EMPTY_OBJECT, EXECUTE_BYTES_SELECTOR, MIN_HF_LIMITED, PriceUtils, RST_ETH_ADDRESS, addAmountInTarget, amountAbcComparator, assetComparator, calcDefaultQuota, calcHealthFactor, calcMaxDebtIncrease, calcMaxLendingDebt, calcOverallAPY, calcQuotaBorrowRate, calcQuotaUpdate, calcRecommendedQuota, calcRelativeBaseBorrowRate, calculateBorrowRateFromUtilization, calculateEarnings, calculateEffectiveBorrowRate, calculateLossCoefficient, calculateMaxLeverageFactor, calculateMaxStrategyDebt, calculateSafeBorrowRate, calculateTotalAPY, calculateTotalPoints, checkBoolean, checkDegenNFT, cmAvailabilityCondition, collectTraces, createLegacyStrategyDataSource, findCallTo, findCallWithInput, findExecuteBytes, getAvailableAndDisabledStrategies, getCMAllowedCollaterals, getCMYouCanEarn, getChainPhantomTokens, getCollateralByDebt, getComplexAPYList, getComplexPointsList, getDefaultAsset, getFactorFromLeverage, getLeverageFromFactor, getListWithAmountInTarget, getNativeTokenAddress, getPointsInfo, getPointsRates, getRateWithFee, getRecommendedDebt, getRecommendedLeverageFactor, getReleasedStrategiesList, getReleasedStrategiesListCore, getSafeBaseBorrowRate, getSingleQuotaBorrowRate, getStrategyCreditManagers, getStrategyCreditManagersList, getStrategyCreditManagersListCore, getStrategyInfo, getStrategyInfoCore, getStrategyMaxAPY, getStrategyPoints, getStrategyYouCanEarn, getTimeToLiquidation, getWalletBalancesAllowedOnCM, isActivatedToken, isApyWithPointsException, isCollateralToken, isCreditManagerUsable, isForbiddenToken, isObtainableToken, isStrategyCMDisabled, isStrategyDisabled, isStrategyEligible, isStrategyReleased, isUsableToken, isValidExtraCollateralToken, isZeroBalance, liquidationPrice, maxAPYFormula, maxLeverage, maxLeverageThreshold, resolveProtocolCall, roundUpQuota, sortAssets, sortBalances, sortStrategyCMsByAvailability, tokensAbcComparator, validateBalance, validateBalances, validateCreditManager, validateHF, validateOpenAccount, validateOpenAccountPoolQuotaStatus, validateOpenAccountPoolStatus, validateQuota, validateTokenToObtain, wrapTokenAddress };

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

@@ -0,0 +1,103 @@
+import { opportunityId } from "../../model/opportunities.js";
+import { poolOpportunitySchema, strategyOpportunitySchema } from "../../model/opportunities.schema.js";
+import "../../model/index.js";
+import { countPaths, diffObjects, toCompareCounts, union } from "./fieldDiff.js";
+import { compileCompareRules, makeTagDiff } from "./compareRules.js";
+//#region src/dev/mode-parity/compareOpportunities.ts
+const tagDiff = makeTagDiff({
+	pool: compileCompareRules(poolOpportunitySchema),
+	strategy: compileCompareRules(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) => [opportunityId(row), row]));
+}
+function byId(refs) {
+	refs.sort((a, b) => a.id.localeCompare(b.id));
+}
+function toRef(row) {
+	const base = {
+		id: 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 diffObjects(onchain, offchain).map((diff) => tagDiff(diff, onchain.kind));
+}
+function summarize(onchain, offchain, onlyOnchain, onlyOffchain, matched) {
+	const byChain = union(onchain.map((row) => String(row.chainId)), offchain.map((row) => String(row.chainId))).map((chainId) => ({
+		chainId: Number(chainId),
+		...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 {
+		...toCompareCounts(onchain.length, offchain.length, onlyOnchain.length, onlyOffchain.length, matched),
+		byChain,
+		diffsByPath: countPaths(matched.flatMap((match) => match.diffs.map((diff) => ({
+			id: match.id,
+			diff
+		}))))
+	};
+}
+//#endregion
+export { compareOpportunities, diffOpportunity };