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

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/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/AccountOpener.js

@@ -1,9 +1,9 @@
+import { ierc20Abi } from "../abi/iERC20.js";
 import { iCreditFacadeV310Abi } from "../abi/310/generated.js";
 import { AddressMap } from "../sdk/utils/AddressMap.js";
 import { AddressSet } from "../sdk/utils/AddressSet.js";
 import { AssetsMap } from "../sdk/utils/AssetsMap.js";
 import { childLogger } from "../sdk/utils/childLogger.js";
-import { ierc20Abi } from "../abi/iERC20.js";
 import "../sdk/constants/addresses.js";
 import { MAX_UINT256, PERCENTAGE_FACTOR } from "../sdk/constants/math.js";
 import { SDKConstruct } from "../sdk/base/SDKConstruct.js";

package/dist/esm/dev/{compareOpportunities.js → mode-parity/compareOpportunities.js}

@@ -1,7 +1,13 @@
-import { opportunityId } from "../model/opportunities.js";
-import "../model/index.js";
-import { countPaths, diffObjects, isAmountWithinTolerance, isBpsWithinTolerance, isUsdWithinTolerance, toCompareCounts, union, withExpected } from "./fieldDiff.js";
-//#region src/dev/compareOpportunities.ts
+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.
@@ -79,47 +85,6 @@ function toRef(row) {
 function diffOpportunity(onchain, offchain) {
 	return diffObjects(onchain, offchain).map((diff) => tagDiff(diff, onchain.kind));
 }
-/**
-* Paths whose values are basis-point rates that routinely differ by ±1 from
-* truncation vs rounding, plus pool `utilization` for the same reason.
-**/
-const BPS_RATE_PATHS = /* @__PURE__ */ new Set([
-	"borrowApy",
-	"supplyApy.organicApy",
-	"additionalBorrowApy",
-	"utilization"
-]);
-/**
-* Amount fields whose bigint `value` moves with expected-liquidity accrual
-* between the backend's last sync and the current block. Strategy
-* `totalBorrow.value` and `maxBorrowAmount.value` are not in this set: those
-* disagreements are formula bugs, not lag.
-**/
-const LAG_AMOUNT_PATHS = /* @__PURE__ */ new Set(["totalSupply.value", "availableLiquidity.value"]);
-/**
-* Fields documented `@mode offchain` in the model: the chain has nothing to
-* put there, so a presence (or nested) mismatch is expected. Strategy
-* `utilization` is in this set; pool `utilization` is not.
-**/
-function isModeScoped(path, kind) {
-	if (path === "curator.url") return true;
-	if (path === "totalApy" || path.endsWith(".totalApy")) return true;
-	if (path === "rewards" || path.startsWith("rewards[") || path.includes(".rewards[") || path.endsWith(".rewards")) return true;
-	if (kind !== "strategy") return false;
-	return path === "utilization" || path === "collateralApy" || path.startsWith("collateralApy.") || path === "maxLeverageApy" || path.startsWith("maxLeverageApy.") || path === "totalValue" || path.startsWith("totalValue.");
-}
-function tagDiff(diff, kind) {
-	if (isModeScoped(diff.path, kind)) return withExpected(diff, "mode-scoped");
-	if (withinTolerance(diff)) return withExpected(diff, "tolerance");
-	return diff;
-}
-function withinTolerance(diff) {
-	if (diff.kind === "usd") return isUsdWithinTolerance(diff.onchain, diff.offchain);
-	if (diff.kind !== "numeric") return false;
-	if (BPS_RATE_PATHS.has(diff.path)) return isBpsWithinTolerance(diff.onchain, diff.offchain);
-	if (LAG_AMOUNT_PATHS.has(diff.path)) return isAmountWithinTolerance(diff.onchain, diff.offchain);
-	return false;
-}
 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),
@@ -128,7 +93,10 @@ function summarize(onchain, offchain, onlyOnchain, onlyOffchain, matched) {
 	return {
 		...toCompareCounts(onchain.length, offchain.length, onlyOnchain.length, onlyOffchain.length, matched),
 		byChain,
-		diffsByPath: countPaths(matched.flatMap((match) => match.diffs))
+		diffsByPath: countPaths(matched.flatMap((match) => match.diffs.map((diff) => ({
+			id: match.id,
+			diff
+		}))))
 	};
 }
 //#endregion

package/dist/esm/dev/{comparePositions.js → mode-parity/comparePositions.js}

@@ -1,7 +1,15 @@
-import { positionId } from "../model/positions.js";
-import "../model/index.js";
-import { USD_RELATIVE_EPSILON, asFiniteNumber, countPaths, diffObjects, isAmountWithinTolerance, isBpsWithinTolerance, isRecord, isUsdWithinTolerance, toCompareCounts, union, withExpected, withinRelative } from "./fieldDiff.js";
-//#region src/dev/comparePositions.ts
+import { liquidationPositionSchema } from "../../model/liquidations.schema.js";
+import { positionId } from "../../model/positions.js";
+import { poolPositionSchema, strategyPositionSchema } from "../../model/positions.schema.js";
+import "../../model/index.js";
+import { countPaths, diffObjects, isRecord, toCompareCounts, union } from "./fieldDiff.js";
+import { compileCompareRules, makeTagDiff } from "./compareRules.js";
+//#region src/dev/mode-parity/comparePositions.ts
+const tagDiff = makeTagDiff({
+	pool: compileCompareRules(poolPositionSchema),
+	strategy: compileCompareRules(strategyPositionSchema),
+	liquidation: compileCompareRules(liquidationPositionSchema)
+});
 /**
 * Matches two position listings per wallet by {@link positionId} and reports
 * every field the two sources disagree on.
@@ -104,40 +112,6 @@ function keyOfPositionArray(path, value) {
 	const token = value.collateral.token;
 	return isRecord(token) && typeof token.address === "string" ? token.address : void 0;
 }
-const BPS_RATE_PATHS = /* @__PURE__ */ new Set([
-	"borrowApy",
-	"apy.organicApy",
-	"healthFactor"
-]);
-/**
-* Amount fields whose bigint `value` moves with interest accrual between the
-* backend's last sync and the current block.
-**/
-function isLagAmountPath(path) {
-	return path === "totalDebt.value" || path === "totalValue.value" || path === "netValue.value" || path.endsWith(".collateral.value") || path.endsWith(".quota.value");
-}
-/**
-* Fields documented `@mode offchain` or `@mode onchain` in the model.
-**/
-function isModeScoped(path, kind) {
-	if (path === "pnl" || path.startsWith("pnl.")) return true;
-	if (kind === "pool") return path === "apy.totalApy" || path.startsWith("apy.rewards");
-	if (kind === "strategy") return path === "netApy" || path.startsWith("netApy.") || path === "borrowRate" || path.startsWith("borrowRate.") || path === "timeToLiquidation" || path === "liquidationPrice";
-	return false;
-}
-function tagDiff(diff, kind) {
-	if (isModeScoped(diff.path, kind)) return withExpected(diff, "mode-scoped");
-	if (withinTolerance(diff)) return withExpected(diff, "tolerance");
-	return diff;
-}
-function withinTolerance(diff) {
-	if (diff.kind === "usd") return isUsdWithinTolerance(diff.onchain, diff.offchain);
-	if (diff.kind !== "numeric") return false;
-	if (diff.path === "leverage") return withinRelative(asFiniteNumber(diff.onchain), asFiniteNumber(diff.offchain), USD_RELATIVE_EPSILON);
-	if (BPS_RATE_PATHS.has(diff.path)) return isBpsWithinTolerance(diff.onchain, diff.offchain);
-	if (isLagAmountPath(diff.path)) return isAmountWithinTolerance(diff.onchain, diff.offchain);
-	return false;
-}
 function summarize(inputs, wallets, failed) {
 	const compared = wallets.filter((wallet) => !wallet.error);
 	const allOnchain = inputs.flatMap((input) => input.onchain.data);
@@ -162,7 +136,10 @@ function summarize(inputs, wallets, failed) {
 		walletsFailed: failed,
 		byChain,
 		byWallet,
-		diffsByPath: countPaths(matched.flatMap((match) => match.diffs))
+		diffsByPath: countPaths(matched.flatMap((match) => match.diffs.map((diff) => ({
+			id: match.id,
+			diff
+		}))))
 	};
 }
 /**

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

@@ -0,0 +1,91 @@
+import { compareTagOf } from "../../model/compare.schema.js";
+import { USD_RELATIVE_EPSILON, asFiniteNumber, collapseArrayKeys, isAmountWithinTolerance, isBpsWithinTolerance, isUsdWithinTolerance, withExpected, withinRelative } from "./fieldDiff.js";
+//#region src/dev/mode-parity/compareRules.ts
+/**
+* Walks a schema and records every field that carries compare metadata.
+*
+* `"amount"` on an object (an Amount / TokenAmount) is stored
+* at `<path>.value`; every other tag is stored at the field's own path.
+**/
+function compileCompareRules(schema) {
+	const rules = /* @__PURE__ */ new Map();
+	walk(schema, "", /* @__PURE__ */ new Set(), rules);
+	return rules;
+}
+/**
+* Tags diffs using the rules compiled for each row kind.
+*
+* Mode tags match the path or anything nested under it. Tolerance tags match
+* the path exactly and dispatch on {@link CompareTolerance}.
+**/
+function makeTagDiff(rulesByKind) {
+	return (diff, kind) => {
+		const rules = rulesByKind[kind];
+		if (!rules) return diff;
+		const path = collapseArrayKeys(diff.path);
+		if (isModeScoped(path, rules)) return withExpected(diff, "mode-scoped");
+		const tag = rules.get(path);
+		if (tag && typeof tag === "object" && withinTolerance(tag.tolerance, diff)) return withExpected(diff, "tolerance");
+		return diff;
+	};
+}
+function isModeScoped(path, rules) {
+	for (const [rulePath, tag] of rules) {
+		if (tag !== "offchainOnly" && tag !== "onchainOnly") continue;
+		if (path === rulePath || path.startsWith(`${rulePath}.`) || path.startsWith(`${rulePath}[`)) return true;
+	}
+	return false;
+}
+function withinTolerance(kind, diff) {
+	switch (kind) {
+		case "usd": return isUsdWithinTolerance(diff.onchain, diff.offchain);
+		case "bps": return isBpsWithinTolerance(diff.onchain, diff.offchain);
+		case "amount": return isAmountWithinTolerance(diff.onchain, diff.offchain);
+		case "float": return withinRelative(asFiniteNumber(diff.onchain), asFiniteNumber(diff.offchain), USD_RELATIVE_EPSILON);
+	}
+}
+function walk(schema, path, seen, rules) {
+	if (seen.has(schema)) return;
+	const nextSeen = new Set(seen);
+	nextSeen.add(schema);
+	const tag = compareTagOf(schema);
+	if (tag) record(path, tag, schema, rules);
+	const def = schema.def;
+	switch (def.type) {
+		case "optional":
+		case "nullable":
+		case "default":
+		case "prefault":
+		case "readonly":
+			if (def.innerType) walk(def.innerType, path, nextSeen, rules);
+			return;
+		case "array":
+			if (def.element) walk(def.element, `${path}[]`, nextSeen, rules);
+			return;
+		case "object":
+			if (def.shape) for (const [key, field] of Object.entries(def.shape)) walk(field, join(path, key), nextSeen, rules);
+			return;
+		case "union":
+			for (const option of def.options ?? []) walk(option, path, nextSeen, rules);
+			return;
+		case "pipe":
+			if (def.out) walk(def.out, path, nextSeen, rules);
+			return;
+		case "lazy":
+			if (def.getter) walk(def.getter(), path, nextSeen, rules);
+			return;
+		default: return;
+	}
+}
+function record(path, tag, schema, rules) {
+	if (typeof tag === "object" && tag.tolerance === "amount" && schema.def.type === "object") {
+		rules.set(join(path, "value"), tag);
+		return;
+	}
+	rules.set(path, tag);
+}
+function join(path, key) {
+	return path ? `${path}.${key}` : key;
+}
+//#endregion
+export { compileCompareRules, makeTagDiff };

package/dist/esm/dev/{fieldDiff.js → mode-parity/fieldDiff.js}

@@ -1,4 +1,4 @@
-//#region src/dev/fieldDiff.ts
+//#region src/dev/mode-parity/fieldDiff.ts
 /**
 * Relative drift allowed on {@link Amount.valueUsd} before a USD float is a
 * real disagreement: 0.1%.
@@ -69,7 +69,7 @@ function withExpected(diff, reason) {
 **/
 function countPaths(diffs) {
 	const counts = /* @__PURE__ */ new Map();
-	for (const diff of diffs) {
+	for (const { id, diff } of diffs) {
 		const path = collapseArrayKeys(diff.path);
 		const entry = counts.get(path) ?? {
 			path,
@@ -82,10 +82,31 @@ function countPaths(diffs) {
 		if (diff.expected) entry.expected += 1;
 		else entry.unexpected += 1;
 		if (!entry.kinds.includes(diff.kind)) entry.kinds.push(diff.kind);
+		recordWorst(entry, id, diff);
 		counts.set(path, entry);
 	}
 	return [...counts.values()].sort((a, b) => b.unexpected - a.unexpected || b.count - a.count || a.path.localeCompare(b.path));
 }
+function recordWorst(entry, id, diff) {
+	const bps = relativeDiffBps(diff.onchain, diff.offchain);
+	if (bps === void 0) return;
+	const worst = {
+		id,
+		path: diff.path,
+		bps,
+		onchain: diff.onchain,
+		offchain: diff.offchain
+	};
+	if (diff.expected) {
+		if (isWorse(worst, entry.worstExpected)) entry.worstExpected = worst;
+		return;
+	}
+	if (isWorse(worst, entry.worstUnexpected)) entry.worstUnexpected = worst;
+}
+function isWorse(candidate, current) {
+	if (!current) return true;
+	return candidate.bps > current.bps || candidate.bps === current.bps && candidate.id.localeCompare(current.id) < 0;
+}
 /**
 * Collapse `collateralTokens[0xa0b8...].symbol` to `collateralTokens[].symbol`.
 **/
@@ -151,6 +172,31 @@ function withinRelativeBigint(onchain, offchain, epsilon) {
 function asFiniteNumber(value) {
 	return typeof value === "number" && Number.isFinite(value) ? value : void 0;
 }
+/**
+* Relative difference of two numbers or bigints, in bps:
+* `|a − b| / max(|a|, |b|) * 10_000`. `undefined` when the values are not
+* a comparable pair of finite numbers or of bigints.
+**/
+function relativeDiffBps(onchain, offchain) {
+	if (typeof onchain === "bigint" && typeof offchain === "bigint") return relativeDiffBpsBigint(onchain, offchain);
+	const left = asFiniteNumber(onchain);
+	const right = asFiniteNumber(offchain);
+	if (left === void 0 || right === void 0) return;
+	const scale = Math.max(Math.abs(left), Math.abs(right));
+	return scale === 0 ? 0 : Math.abs(left - right) / scale * 1e4;
+}
+/**
+* Same formula as {@link relativeDiffBps} for bigints, computed in integer
+* arithmetic to milli-bps so a 1e18-scale amount does not round through
+* `Number`.
+**/
+function relativeDiffBpsBigint(onchain, offchain) {
+	if (onchain === offchain) return 0;
+	const diff = onchain > offchain ? onchain - offchain : offchain - onchain;
+	const scale = abs(onchain) > abs(offchain) ? abs(onchain) : abs(offchain);
+	if (scale === 0n) return 0;
+	return Number(diff * 10000n * 1000n / scale) / 1e3;
+}
 function union(left, right) {
 	return [.../* @__PURE__ */ new Set([...left, ...right])];
 }
@@ -221,4 +267,4 @@ function abs(value) {
 	return value < 0n ? -value : value;
 }
 //#endregion
-export { AMOUNT_RELATIVE_EPSILON, BPS_ABSOLUTE_EPSILON, USD_RELATIVE_EPSILON, asFiniteNumber, collapseArrayKeys, countPaths, diffObjects, diffValue, isAmountWithinTolerance, isBpsWithinTolerance, isRecord, isUsdWithinTolerance, toCompareCounts, union, withExpected, withinRelative, withinRelativeBigint };
+export { AMOUNT_RELATIVE_EPSILON, BPS_ABSOLUTE_EPSILON, USD_RELATIVE_EPSILON, asFiniteNumber, collapseArrayKeys, countPaths, diffObjects, diffValue, isAmountWithinTolerance, isBpsWithinTolerance, isRecord, isUsdWithinTolerance, relativeDiffBps, toCompareCounts, union, withExpected, withinRelative, withinRelativeBigint };

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

@@ -0,0 +1,121 @@
+import { getAlchemyUrl } from "../providers.js";
+import { pino } from "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 = 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 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
+export { BACKEND_URL, NETWORKS, TIMEOUT, createLogger, errorMessage, formatBpsAsPercent, mapPool, printCompareSummary, requireEnv, rpcUrls };

package/dist/esm/dev/withdrawalUtils.js

@@ -1,6 +1,6 @@
+import { iWithdrawalCompressorV313Abi } from "../abi/IWithdrawalCompressorV313.js";
 import { getNetworkType } from "../sdk/chain/chains.js";
 import { getWithdrawalCompressorAddress } from "../sdk/accounts/withdrawal-compressor/addresses.js";
-import { iWithdrawalCompressorV313Abi } from "../abi/IWithdrawalCompressorV313.js";
 import "../sdk/index.js";
 import { iMidasDataFeedAbi, iMidasRedemptionVaultAbi, midasGatewayAbi, midasRedeemerAbi, midasRedemptionVaultPhantomTokenAbi, securitizeRedeemerAbi, securitizeRedemptionGatewayAbi, securitizeRedemptionPhantomTokenAbi } from "./withdrawalAbi.js";
 import { erc20Abi, hexToString, parseAbi, parseEther } from "viem";

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

@@ -0,0 +1,29 @@
+//#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
+export { compareTagOf, offchainOnly, onchainOnly, tolerance };

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

@@ -1,4 +1,5 @@
 import { ZodAddress } from "../sdk/utils/zod.js";
+import { offchainOnly } from "./compare.schema.js";
 import { z } from "zod/v4";
 //#region src/model/curators.schema.ts
 /**
@@ -30,7 +31,7 @@ const curatorNameSchema = z.enum([
 const curatorSchema = z.object({
 	address: ZodAddress(),
 	name: curatorNameSchema.optional(),
-	url: z.string().nullable()
+	url: offchainOnly(z.string().nullable())
 });
 //#endregion
 export { curatorNameSchema, curatorSchema };

package/dist/esm/model/index.js

@@ -1,4 +1,5 @@
 import { CHART_METRIC_UNITS, CHART_RANGES, CHART_UNAVAILABLE_CODES, POOL_OPPORTUNITY_CHART_METRICS, POOL_POSITION_CHART_METRICS, STRATEGY_OPPORTUNITY_CHART_METRICS, STRATEGY_POSITION_CHART_METRICS } from "./charts.js";
+import { compareTagOf, offchainOnly, onchainOnly, tolerance } from "./compare.schema.js";
 import { amountSchema, assetTypeSchema, bpsSchema, chainIdSchema, leverageSchema, timestampSchema, tokenAmountSchema, tokenSchema, txCallSchema } from "./primitives.schema.js";
 import { chartBundleSchemaFor, chartDenominationSchema, chartMetricSchema, chartQueryCodec, chartQueryParamsSchema, chartQuerySchema, chartRangeSchema, chartSeriesSchema, chartValueSchema, chartWindowSchema, poolOpportunityChartMetricSchema, poolPositionChartMetricSchema, strategyOpportunityChartMetricSchema, strategyPositionChartMetricSchema } from "./charts.schema.js";
 import "./curators.js";
@@ -16,4 +17,4 @@ import { borrowRateBreakdownSchema, pnlBreakdownSchema, pointsProgramPnLSchema,
 import "./primitives.js";
 import "./response.js";
 import { chainFailedSchema, chainMetadataSchema, chainSucceededSchema, dataSourceSchema, responseMetadataSchema, responseSchema } from "./response.schema.js";
-export { CHART_METRIC_UNITS, CHART_RANGES, CHART_UNAVAILABLE_CODES, FILTER_ALL, POOL_OPPORTUNITY_CHART_METRICS, POOL_POSITION_CHART_METRICS, STRATEGY_OPPORTUNITY_CHART_METRICS, STRATEGY_POSITION_CHART_METRICS, amountSchema, apyBreakdownSchema, assetTypeSchema, booleanParamSchema, borrowRateBreakdownSchema, bpsSchema, chainFailedSchema, chainIdSchema, chainMetadataSchema, chainSucceededSchema, chartBundleSchemaFor, chartDenominationSchema, chartMetricSchema, chartQueryCodec, chartQueryParamsSchema, chartQuerySchema, chartRangeSchema, chartSeriesSchema, chartValueSchema, chartWindowSchema, curatorNameSchema, curatorSchema, dataSourceSchema, delayedReceivedAssetSchema, encodeFlag, filterAllSchema, filterable, instantReceivedAssetSchema, isFilterSet, leverageSchema, liquidatableAccountFilterSchema, liquidatableAccountSchema, liquidationApprovalSchema, liquidationDetailsSchema, liquidationPositionId, liquidationPositionSchema, matchesLiquidatableAccountFilter, matchesOpportunityFilter, matchesPositionFilter, noticeKindSchema, noticeSchema, opportunityBaseSchema, opportunityDetailSchema, opportunityFilterQueryParamsSchema, opportunityFilterQuerySchema, opportunityFilterSchema, opportunityId, opportunityKeySchema, opportunityKindSchema, opportunitySchema, pnlBreakdownSchema, pointRewardsSchema, pointsProgramPnLSchema, pointsProgramSchema, pointsRewardsPnLSchema, poolOpportunityChartMetricSchema, poolOpportunityDetailSchema, poolOpportunityId, poolOpportunityKeySchema, poolOpportunitySchema, poolPositionChartMetricSchema, poolPositionId, poolPositionKeySchema, poolPositionSchema, positionCollateralSchema, positionFilterQueryParamsSchema, positionFilterQuerySchema, positionFilterSchema, positionId, positionKeySchema, positionKindSchema, positionSchema, positionTransactionKindSchema, positionTransactionSchema, positionsTotalsSchema, priceFeedDataSchema, priceFeedSummarySchema, quotaAssetSchema, rateCurvePointSchema, rateCurveSchema, receivedAssetSchema, responseMetadataSchema, responseSchema, rewardsPnLSchema, rewardsSchema, strategyOpportunityChartMetricSchema, strategyOpportunityDetailSchema, strategyOpportunityId, strategyOpportunityKeySchema, strategyOpportunitySchema, strategyPositionChartMetricSchema, strategyPositionId, strategyPositionKeySchema, strategyPositionSchema, timestampSchema, tokenAmountSchema, tokenRewardsPnLSchema, tokenRewardsSchema, tokenSchema, txCallSchema };
+export { CHART_METRIC_UNITS, CHART_RANGES, CHART_UNAVAILABLE_CODES, FILTER_ALL, POOL_OPPORTUNITY_CHART_METRICS, POOL_POSITION_CHART_METRICS, STRATEGY_OPPORTUNITY_CHART_METRICS, STRATEGY_POSITION_CHART_METRICS, amountSchema, apyBreakdownSchema, assetTypeSchema, booleanParamSchema, borrowRateBreakdownSchema, bpsSchema, chainFailedSchema, chainIdSchema, chainMetadataSchema, chainSucceededSchema, chartBundleSchemaFor, chartDenominationSchema, chartMetricSchema, chartQueryCodec, chartQueryParamsSchema, chartQuerySchema, chartRangeSchema, chartSeriesSchema, chartValueSchema, chartWindowSchema, compareTagOf, curatorNameSchema, curatorSchema, dataSourceSchema, delayedReceivedAssetSchema, encodeFlag, filterAllSchema, filterable, instantReceivedAssetSchema, isFilterSet, leverageSchema, liquidatableAccountFilterSchema, liquidatableAccountSchema, liquidationApprovalSchema, liquidationDetailsSchema, liquidationPositionId, liquidationPositionSchema, matchesLiquidatableAccountFilter, matchesOpportunityFilter, matchesPositionFilter, noticeKindSchema, noticeSchema, offchainOnly, onchainOnly, opportunityBaseSchema, opportunityDetailSchema, opportunityFilterQueryParamsSchema, opportunityFilterQuerySchema, opportunityFilterSchema, opportunityId, opportunityKeySchema, opportunityKindSchema, opportunitySchema, pnlBreakdownSchema, pointRewardsSchema, pointsProgramPnLSchema, pointsProgramSchema, pointsRewardsPnLSchema, poolOpportunityChartMetricSchema, poolOpportunityDetailSchema, poolOpportunityId, poolOpportunityKeySchema, poolOpportunitySchema, poolPositionChartMetricSchema, poolPositionId, poolPositionKeySchema, poolPositionSchema, positionCollateralSchema, positionFilterQueryParamsSchema, positionFilterQuerySchema, positionFilterSchema, positionId, positionKeySchema, positionKindSchema, positionSchema, positionTransactionKindSchema, positionTransactionSchema, positionsTotalsSchema, priceFeedDataSchema, priceFeedSummarySchema, quotaAssetSchema, rateCurvePointSchema, rateCurveSchema, receivedAssetSchema, responseMetadataSchema, responseSchema, rewardsPnLSchema, rewardsSchema, strategyOpportunityChartMetricSchema, strategyOpportunityDetailSchema, strategyOpportunityId, strategyOpportunityKeySchema, strategyOpportunitySchema, strategyPositionChartMetricSchema, strategyPositionId, strategyPositionKeySchema, strategyPositionSchema, timestampSchema, tokenAmountSchema, tokenRewardsPnLSchema, tokenRewardsSchema, tokenSchema, tolerance, txCallSchema };