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

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

@@ -1,4 +1,5 @@
 import { ZodAddress } from "../sdk/utils/zod.js";
+import { offchainOnly, tolerance } from "./compare.schema.js";
 import { amountSchema, assetTypeSchema, bpsSchema, chainIdSchema, leverageSchema, timestampSchema, tokenSchema } from "./primitives.schema.js";
 import { curatorSchema } from "./curators.schema.js";
 import { isFilterSet } from "./filters.js";
@@ -45,9 +46,9 @@ const rewardsSchema = z.discriminatedUnion("kind", [tokenRewardsSchema, pointRew
 * {@link ApyBreakdown}
 **/
 const apyBreakdownSchema = z.object({
-	totalApy: bpsSchema.optional(),
-	organicApy: bpsSchema,
-	rewards: z.array(rewardsSchema).optional()
+	totalApy: offchainOnly(bpsSchema).optional(),
+	organicApy: tolerance(bpsSchema, "bps"),
+	rewards: offchainOnly(z.array(rewardsSchema)).optional()
 });
 /**
 * {@link OpportunityBase}
@@ -70,9 +71,9 @@ const poolOpportunitySchema = z.object({
 	...opportunityBaseSchema.shape,
 	kind: z.literal("pool"),
 	pool: ZodAddress(),
-	totalSupply: amountSchema,
-	availableLiquidity: amountSchema,
-	utilization: bpsSchema,
+	totalSupply: tolerance(amountSchema, "amount"),
+	availableLiquidity: tolerance(amountSchema, "amount"),
+	utilization: tolerance(bpsSchema, "bps"),
 	supplyApy: apyBreakdownSchema
 });
 /**
@@ -87,12 +88,12 @@ const strategyOpportunitySchema = z.object({
 	liquidationPremium: bpsSchema,
 	liquidationFee: bpsSchema,
 	expirationDate: timestampSchema.nullable(),
-	collateralApy: apyBreakdownSchema.optional(),
-	maxLeverageApy: apyBreakdownSchema.optional(),
-	borrowApy: bpsSchema.optional(),
-	additionalBorrowApy: bpsSchema.optional(),
-	totalValue: amountSchema.optional(),
-	utilization: bpsSchema.optional(),
+	collateralApy: offchainOnly(apyBreakdownSchema).optional(),
+	maxLeverageApy: offchainOnly(apyBreakdownSchema).optional(),
+	borrowApy: tolerance(bpsSchema, "bps").optional(),
+	additionalBorrowApy: tolerance(bpsSchema, "bps").optional(),
+	totalValue: offchainOnly(amountSchema).optional(),
+	utilization: offchainOnly(bpsSchema).optional(),
 	maxBorrowAmount: amountSchema,
 	maxLeverage: leverageSchema
 });

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

@@ -1,4 +1,5 @@
 import { ZodAddress, ZodBigInt, ZodHex } from "../sdk/utils/zod.js";
+import { offchainOnly, onchainOnly, tolerance } from "./compare.schema.js";
 import { assetTypeSchema, bpsSchema, chainIdSchema, leverageSchema, timestampSchema, tokenAmountSchema, tokenSchema } from "./primitives.schema.js";
 import { isFilterSet } from "./filters.js";
 import { booleanParamSchema, encodeFlag, filterable } from "./filters.schema.js";
@@ -55,8 +56,8 @@ const pnlBreakdownSchema = z.object({
 * {@link PositionCollateral}
 **/
 const positionCollateralSchema = z.object({
-	collateral: tokenAmountSchema,
-	quota: tokenAmountSchema,
+	collateral: tolerance(tokenAmountSchema, "amount"),
+	quota: tolerance(tokenAmountSchema, "amount"),
 	withdrawals: z.array(delayedReceivedAssetSchema)
 });
 /**
@@ -67,9 +68,9 @@ const poolPositionSchema = z.object({
 	name: z.string(),
 	chainId: chainIdSchema,
 	pool: ZodAddress(),
-	netValue: tokenAmountSchema,
+	netValue: tolerance(tokenAmountSchema, "amount"),
 	apy: apyBreakdownSchema,
-	pnl: pnlBreakdownSchema.optional()
+	pnl: offchainOnly(pnlBreakdownSchema).optional()
 });
 /**
 * {@link BorrowRateBreakdown}
@@ -90,16 +91,16 @@ const strategyPositionSchema = z.object({
 	creditManager: ZodAddress(),
 	creditAccount: ZodAddress(),
 	targetCollateral: tokenSchema.nullable(),
-	leverage: leverageSchema,
-	borrowApy: bpsSchema,
-	netApy: apyBreakdownSchema.optional(),
-	totalDebt: tokenAmountSchema,
-	totalValue: tokenAmountSchema,
-	healthFactor: bpsSchema,
-	borrowRate: borrowRateBreakdownSchema.optional(),
-	timeToLiquidation: ZodBigInt().nullable().optional(),
-	liquidationPrice: ZodBigInt().nullable().optional(),
-	pnl: pnlBreakdownSchema.optional(),
+	leverage: tolerance(leverageSchema, "float"),
+	borrowApy: tolerance(bpsSchema, "bps"),
+	netApy: offchainOnly(apyBreakdownSchema).optional(),
+	totalDebt: tolerance(tokenAmountSchema, "amount"),
+	totalValue: tolerance(tokenAmountSchema, "amount"),
+	healthFactor: tolerance(bpsSchema, "bps"),
+	borrowRate: onchainOnly(borrowRateBreakdownSchema).optional(),
+	timeToLiquidation: onchainOnly(ZodBigInt().nullable()).optional(),
+	liquidationPrice: onchainOnly(ZodBigInt().nullable()).optional(),
+	pnl: offchainOnly(pnlBreakdownSchema).optional(),
 	collaterals: z.array(positionCollateralSchema)
 });
 /**

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

@@ -1,4 +1,5 @@
 import { ZodAddress, ZodBigInt, ZodHex } from "../sdk/utils/zod.js";
+import { tolerance } from "./compare.schema.js";
 import { z } from "zod/v4";
 //#region src/model/primitives.schema.ts
 /**
@@ -39,7 +40,7 @@ const leverageSchema = z.number().nonnegative();
 **/
 const amountSchema = z.object({
 	value: ZodBigInt(),
-	valueUsd: z.number().nullable()
+	valueUsd: tolerance(z.number().nullable(), "usd")
 });
 /**
 * {@link Token}

package/dist/esm/plugins/adapters/contracts/ERC4626AdapterContract.js

@@ -1,5 +1,5 @@
-import { MissingSerializedParamsError } from "../../../sdk/base/errors.js";
 import { ierc4626AdapterAbi } from "../../../abi/ierc4626Adapter.js";
+import { MissingSerializedParamsError } from "../../../sdk/base/errors.js";
 import "../../../sdk/index.js";
 import { fnSigToName, swapFromTransfers } from "../transferHelpers.js";
 import { AbstractAdapterContract } from "./AbstractAdapter.js";

package/dist/esm/plugins/apy/ApyPlugin.js

@@ -1,5 +1,3 @@
-import { AxiosCache } from "../../common-utils/axios-cache/AxiosCache.js";
-import "../../common-utils/axios-cache/index.js";
 import { AddressMap } from "../../sdk/utils/AddressMap.js";
 import { AP_MARKET_COMPRESSOR } from "../../sdk/constants/address-provider.js";
 import { PERCENTAGE_DECIMALS } from "../../sdk/constants/math.js";
@@ -10,6 +8,8 @@ import { hexEq } from "../../sdk/utils/hex.js";
 import { marketCompressorAbi } from "../../abi/compressors/marketCompressor.js";
 import { BasePlugin } from "../../sdk/plugins/BasePlugin.js";
 import "../../sdk/index.js";
+import { AxiosCache } from "../../common-utils/axios-cache/AxiosCache.js";
+import "../../common-utils/axios-cache/index.js";
 import { getStrategyCreditManagersListCore } from "../../common-utils/utils/strategies/credit-managers/get-strategy-credit-managers-list-core.js";
 import { getAvailableAndDisabledStrategies } from "../../common-utils/utils/strategies/lists/get-available-and-disabled-strategies.js";
 import { getReleasedStrategiesListCore } from "../../common-utils/utils/strategies/lists/get-released-strategies-list-core.js";

package/dist/esm/preview/simulate/simulatePoolOperation.js

@@ -1,5 +1,5 @@
-import { iPoolV310Abi } from "../../abi/310/generated.js";
 import { iZapperAbi } from "../../abi/iZapper.js";
+import { iPoolV310Abi } from "../../abi/310/generated.js";
 import { asPreviewSimulationError } from "./errors.js";
 //#region src/preview/simulate/simulatePoolOperation.ts
 function previewRead(operation) {

package/dist/esm/preview/trace/extractTransfers.js

@@ -1,6 +1,6 @@
+import { ierc20Abi } from "../../abi/iERC20.js";
 import { iCreditFacadeV310Abi } from "../../abi/310/generated.js";
 import { AddressMap } from "../../sdk/utils/AddressMap.js";
-import { ierc20Abi } from "../../abi/iERC20.js";
 import "../../sdk/index.js";
 import { UnexpectedFacadeEventOrderError } from "./errors.js";
 import { getAddress, isAddressEqual, parseEventLogs } from "viem";

package/dist/esm/sdk/accounts/CreditAccountsServiceV310.js

@@ -1,3 +1,5 @@
+import { iBaseRewardPoolAbi } from "../../abi/iBaseRewardPool.js";
+import { ierc4626AdapterAbi } from "../../abi/ierc4626Adapter.js";
 import { AP_REWARDS_COMPRESSOR } from "../constants/address-provider.js";
 import { ADDRESS_0X0 } from "../constants/addresses.js";
 import { MAX_UINT256 } from "../constants/math.js";
@@ -8,8 +10,6 @@ import "../base/index.js";
 import { AccountBotsService } from "./bots/AccountBotsService.js";
 import "./bots/index.js";
 import { rewardsCompressorAbi } from "../../abi/compressors/rewardsCompressor.js";
-import { iBaseRewardPoolAbi } from "../../abi/iBaseRewardPool.js";
-import { ierc4626AdapterAbi } from "../../abi/ierc4626Adapter.js";
 import { expectedBalanceDeltas } from "../market/credit/expectedBalanceDeltas.js";
 import "../market/index.js";
 import { CreditAccountCompressor } from "./credit-account-compressor/CreditAccountCompressor.js";

package/dist/esm/sdk/accounts/liquidations/LiquidationsService.js

@@ -1,3 +1,4 @@
+import { iLiquidationCompressorV313Abi } from "../../../abi/ILiquidationCompressorV313.js";
 import { AddressSet } from "../../utils/AddressSet.js";
 import { bytes32ToString } from "../../utils/bytes32ToString.js";
 import { ADDRESS_0X0 } from "../../constants/addresses.js";
@@ -19,7 +20,6 @@ import { SecuritizeLiquidatorContract } from "../../market/rwa/securitize/Securi
 import "../../market/rwa/securitize/index.js";
 import "../../market/index.js";
 import { LIQUIDATION_APPROVAL_BUFFER, LIQUIDATION_COMPRESSOR_V313_ADDRESS } from "./constants.js";
-import { iLiquidationCompressorV313Abi } from "../../../abi/ILiquidationCompressorV313.js";
 //#region src/sdk/accounts/liquidations/LiquidationsService.ts
 /**
 * Service for discovering liquidatable credit accounts and previewing manual

package/dist/esm/sdk/accounts/withdrawal-compressor/RedemptionLoggerV310Contract.js

@@ -1,7 +1,7 @@
+import { iRedemptionLoggerV310Abi } from "../../../abi/iRedemptionLoggerV310.js";
 import { BaseContract } from "../../base/BaseContract.js";
 import "../../base/index.js";
 import { decodeDelayedIntent } from "./intent-codec.js";
-import { iRedemptionLoggerV310Abi } from "../../../abi/iRedemptionLoggerV310.js";
 import { InvalidDelayedIntentError } from "./errors.js";
 //#region src/sdk/accounts/withdrawal-compressor/RedemptionLoggerV310Contract.ts
 const abi = iRedemptionLoggerV310Abi;

package/dist/esm/sdk/accounts/withdrawal-compressor/WithdrawalCompressorV310Contract.js

@@ -1,5 +1,5 @@
-import { AbstractWithdrawalCompressorContract } from "./AbstractWithdrawalCompressorContract.js";
 import { iWithdrawalCompressorV310Abi } from "../../../abi/IWithdrawalCompressorV310.js";
+import { AbstractWithdrawalCompressorContract } from "./AbstractWithdrawalCompressorContract.js";
 //#region src/sdk/accounts/withdrawal-compressor/WithdrawalCompressorV310Contract.ts
 const abi = iWithdrawalCompressorV310Abi;
 /**

package/dist/esm/sdk/accounts/withdrawal-compressor/WithdrawalCompressorV311Contract.js

@@ -1,5 +1,5 @@
-import { AbstractWithdrawalCompressorContract } from "./AbstractWithdrawalCompressorContract.js";
 import { iWithdrawalCompressorV311Abi } from "../../../abi/IWithdrawalCompressorV311.js";
+import { AbstractWithdrawalCompressorContract } from "./AbstractWithdrawalCompressorContract.js";
 //#region src/sdk/accounts/withdrawal-compressor/WithdrawalCompressorV311Contract.ts
 const abi = iWithdrawalCompressorV311Abi;
 /**

package/dist/esm/sdk/accounts/withdrawal-compressor/WithdrawalCompressorV313Contract.js

@@ -1,6 +1,6 @@
+import { iWithdrawalCompressorV313Abi } from "../../../abi/IWithdrawalCompressorV313.js";
 import { encodeDelayedIntent } from "./intent-codec.js";
 import { AbstractWithdrawalCompressorContract, iCreditAccountAbi, toClaimableWithdrawal, toPendingWithdrawal, toRequestableWithdrawal } from "./AbstractWithdrawalCompressorContract.js";
-import { iWithdrawalCompressorV313Abi } from "../../../abi/IWithdrawalCompressorV313.js";
 import { toWithdrawalStatus } from "./types.js";
 //#region src/sdk/accounts/withdrawal-compressor/WithdrawalCompressorV313Contract.ts
 const abi = iWithdrawalCompressorV313Abi;

package/dist/esm/sdk/base/TokensMeta.js

@@ -1,12 +1,12 @@
+import { iExpirableAbi } from "../../abi/iExpirable.js";
+import { iStateSerializerAbi } from "../../abi/iStateSerializer.js";
+import { iVersionAbi } from "../../abi/iVersion.js";
 import { AddressMap } from "../utils/AddressMap.js";
 import { AddressSet } from "../utils/AddressSet.js";
 import { bytes32ToString } from "../utils/bytes32ToString.js";
 import { getAssetType } from "../chain/chains.js";
 import { formatBN } from "../utils/formatter.js";
 import "../utils/index.js";
-import { iExpirableAbi } from "../../abi/iExpirable.js";
-import { iStateSerializerAbi } from "../../abi/iStateSerializer.js";
-import { iVersionAbi } from "../../abi/iVersion.js";
 import { executeMulticallBatches } from "../utils/viem/executeMulticallBatches.js";
 //#region src/sdk/base/TokensMeta.ts
 /**

package/dist/esm/sdk/chain/detectNetwork.js

@@ -1,5 +1,5 @@
-import { chains } from "./chains.js";
 import { ierc20Abi } from "../../abi/iERC20.js";
+import { chains } from "./chains.js";
 //#region src/sdk/chain/detectNetwork.ts
 /**
 * Detects the network type from the given client.

package/dist/esm/sdk/core/createAddressProvider.js

@@ -1,8 +1,8 @@
+import { iVersionAbi } from "../../abi/iVersion.js";
 import { AP_MARKET_COMPRESSOR, AP_PRICE_FEED_COMPRESSOR } from "../constants/address-provider.js";
 import { isV310 } from "../constants/versions.js";
 import "../constants/index.js";
 import { hexEq } from "../utils/hex.js";
-import { iVersionAbi } from "../../abi/iVersion.js";
 import { AddressProviderV310Contract } from "./AddressProviderV310Contract.js";
 //#region src/sdk/core/createAddressProvider.ts
 const OVERRIDE_ADDRESSES = { Mainnet: {

package/dist/esm/sdk/market/credit/CreditFacadeV310BaseContract.js

@@ -1,7 +1,7 @@
+import { iPausableAbi } from "../../../abi/iPausable.js";
 import { iCreditFacadeMulticallV310Abi, iCreditFacadeV310Abi } from "../../../abi/310/generated.js";
 import { BaseContract } from "../../base/BaseContract.js";
 import "../../base/index.js";
-import { iPausableAbi } from "../../../abi/iPausable.js";
 //#region src/sdk/market/credit/CreditFacadeV310BaseContract.ts
 const abi = [
 	...iCreditFacadeV310Abi,

package/dist/esm/sdk/market/pool/PoolV310Contract.js

@@ -1,3 +1,4 @@
+import { iPausableAbi } from "../../../abi/iPausable.js";
 import { iPoolV310Abi } from "../../../abi/310/generated.js";
 import { AddressMap } from "../../utils/AddressMap.js";
 import { RAY } from "../../constants/math.js";
@@ -6,7 +7,6 @@ import { formatBN, formatBNvalue, percentFmt } from "../../utils/formatter.js";
 import "../../utils/index.js";
 import { BaseContract } from "../../base/BaseContract.js";
 import "../../base/index.js";
-import { iPausableAbi } from "../../../abi/iPausable.js";
 import { calcUtilization } from "../math.js";
 //#region src/sdk/market/pool/PoolV310Contract.ts
 const abi = [...iPoolV310Abi, ...iPausableAbi];

package/dist/esm/sdk/market/zapper/IETHZapperContract.js

@@ -1,5 +1,5 @@
-import { ZapperContract } from "./ZapperContract.js";
 import { iethZapperAbi } from "../../../abi/iETHZapper.js";
+import { ZapperContract } from "./ZapperContract.js";
 //#region src/sdk/market/zapper/IETHZapperContract.ts
 const abi = iethZapperAbi;
 var IETHZapperContract = class extends ZapperContract {

package/dist/esm/sdk/market/zapper/ZapperContract.js

@@ -1,6 +1,6 @@
+import { iZapperAbi } from "../../../abi/iZapper.js";
 import { BaseContract } from "../../base/BaseContract.js";
 import "../../base/index.js";
-import { iZapperAbi } from "../../../abi/iZapper.js";
 import { UnsupportedZapperFunctionError } from "./errors.js";
 //#region src/sdk/market/zapper/ZapperContract.ts
 /**

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

@@ -1,5 +1,5 @@
-import { AddressSet } from "../utils/AddressSet.js";
 import { ierc20Abi } from "../../abi/iERC20.js";
+import { AddressSet } from "../utils/AddressSet.js";
 import "../constants/addresses.js";
 import { PERCENTAGE_FACTOR, RAY } from "../constants/math.js";
 import "../constants/index.js";

package/dist/esm/sdk/utils/viem/simulateWithPriceUpdates.js

@@ -1,6 +1,6 @@
 import { errorAbis } from "../../../abi/errors.js";
-import { generateCastTraceCall } from "./cast.js";
 import { iUpdatablePriceFeedAbi } from "../../../abi/iUpdatablePriceFeed.js";
+import { generateCastTraceCall } from "./cast.js";
 import { simulateMulticall } from "./simulateMulticall.js";
 import { BaseError, CallExecutionError, ContractFunctionRevertedError, decodeFunctionData, decodeFunctionResult, encodeFunctionData, parseAbi } from "viem";
 import { getAction, parseAccount } from "viem/utils";

package/dist/types/dev/{compareOpportunities.d.ts → mode-parity/compareOpportunities.d.ts}

@@ -1,10 +1,10 @@
-import { ChainId } from "../model/primitives.js";
-import { Opportunity, OpportunityId, OpportunityKind } from "../model/opportunities.js";
-import { ChainMetadata, DataResponse } from "../model/response.js";
-import "../model/index.js";
+import { ChainId } from "../../model/primitives.js";
+import { Opportunity, OpportunityId, OpportunityKind } from "../../model/opportunities.js";
+import { ChainMetadata, DataResponse } from "../../model/response.js";
+import "../../model/index.js";
 import { ChainCompareCounts, CompareCounts, DiffKind, DiffPathCount, ExpectedDiffReason, FieldDiff } from "./fieldDiff.js";
 import { Address } from "viem";
-//#region src/dev/compareOpportunities.d.ts
+//#region src/dev/mode-parity/compareOpportunities.d.ts
 /**
  * Enough of an opportunity to identify it in a report without carrying the
  * whole row.

package/dist/types/dev/{comparePositions.d.ts → mode-parity/comparePositions.d.ts}

@@ -1,10 +1,10 @@
-import { ChainId } from "../model/primitives.js";
-import { Position, PositionId, PositionKind } from "../model/positions.js";
-import { ChainMetadata, DataResponse } from "../model/response.js";
-import "../model/index.js";
+import { ChainId } from "../../model/primitives.js";
+import { Position, PositionId, PositionKind } from "../../model/positions.js";
+import { ChainMetadata, DataResponse } from "../../model/response.js";
+import "../../model/index.js";
 import { ChainCompareCounts, CompareCounts, DiffPathCount, FieldDiff } from "./fieldDiff.js";
 import { Address } from "viem";
-//#region src/dev/comparePositions.d.ts
+//#region src/dev/mode-parity/comparePositions.d.ts
 /**
  * Enough of a position to identify it in a report without carrying the whole
  * row.

package/dist/types/dev/mode-parity/compareRules.d.ts

@@ -0,0 +1,33 @@
+import { CompareTag } from "../../model/compare.schema.js";
+import { FieldDiff } from "./fieldDiff.js";
+import { z } from "zod/v4";
+//#region src/dev/mode-parity/compareRules.d.ts
+/**
+ * Collapsed-path → tag map compiled from a zod schema, e.g.
+ * `apy.totalApy` → `"offchainOnly"`, `totalDebt.value` → `{ tolerance: amount }`.
+ **/
+type CompareRuleMap = Map<string, CompareTag>;
+/**
+ * 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.
+ **/
+declare function compileCompareRules(schema: z.ZodType): CompareRuleMap;
+/**
+ * Rules compiled for each row kind, e.g. `"pool"` vs `"strategy"`.
+ **/
+type CompareRulesByKind = Record<string, CompareRuleMap>;
+/**
+ * Tags one field diff using the rules compiled for its row kind.
+ **/
+type TagDiff = (diff: FieldDiff, kind: string) => FieldDiff;
+/**
+ * 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}.
+ **/
+declare function makeTagDiff(rulesByKind: CompareRulesByKind): TagDiff;
+//#endregion
+export { CompareRuleMap, CompareRulesByKind, TagDiff, compileCompareRules, makeTagDiff };

package/dist/types/dev/{fieldDiff.d.ts → mode-parity/fieldDiff.d.ts}

@@ -1,6 +1,6 @@
-import { ChainId } from "../model/primitives.js";
-import "../model/index.js";
-//#region src/dev/fieldDiff.d.ts
+import { ChainId } from "../../model/primitives.js";
+import "../../model/index.js";
+//#region src/dev/mode-parity/fieldDiff.d.ts
 /**
  * What kind of disagreement a {@link FieldDiff} describes, so that a reader can
  * bucket the report without re-deriving it from the values.
@@ -45,6 +45,33 @@ interface FieldDiff {
   expected?: true;
   reason?: ExpectedDiffReason;
 }
+/**
+ * The largest numeric disagreement seen for one collapsed field path, on
+ * either the unexpected or the expected side.
+ **/
+interface WorstDiff {
+  /**
+   * Entity id (position/opportunity id) with the biggest relative difference.
+   **/
+  id: string;
+  /**
+   * Uncollapsed path, so the exact array element is named.
+   **/
+  path: string;
+  /**
+   * Relative difference in bps.
+   **/
+  bps: number;
+  onchain: unknown;
+  offchain: unknown;
+}
+/**
+ * One field disagreement together with the matched row it belongs to.
+ **/
+interface EntityFieldDiff {
+  id: string;
+  diff: FieldDiff;
+}
 /**
  * How often one field disagreed across all matched rows, with array keys
  * collapsed, e.g. `collateralTokens[].symbol`.
@@ -55,6 +82,15 @@ interface DiffPathCount {
   count: number;
   expected: number;
   unexpected: number;
+  /**
+   * Largest unexpected numeric disagreement, when any unexpected diff of this
+   * path yields a relative bps value.
+   **/
+  worstUnexpected?: WorstDiff;
+  /**
+   * Largest expected numeric disagreement, see {@link worstUnexpected}.
+   **/
+  worstExpected?: WorstDiff;
 }
 /**
  * Counts of one chain, one wallet, or of the whole report when those ids are
@@ -127,7 +163,7 @@ declare function withExpected(diff: FieldDiff, reason: ExpectedDiffReason): Fiel
  * field of a hundred collateral tokens counts as one path. Sorted so the
  * unexpected disagreements come first.
  **/
-declare function countPaths(diffs: Iterable<FieldDiff>): DiffPathCount[];
+declare function countPaths(diffs: Iterable<EntityFieldDiff>): DiffPathCount[];
 /**
  * Collapse `collateralTokens[0xa0b8...].symbol` to `collateralTokens[].symbol`.
  **/
@@ -161,7 +197,13 @@ declare function withinRelative(onchain: number | undefined, offchain: number |
  **/
 declare function withinRelativeBigint(onchain: bigint, offchain: bigint, epsilon: number): boolean;
 declare function asFiniteNumber(value: unknown): number | undefined;
+/**
+ * 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.
+ **/
+declare function relativeDiffBps(onchain: unknown, offchain: unknown): number | undefined;
 declare function union(left: string[], right: string[]): string[];
 declare function isRecord(value: unknown): value is Record<string, unknown>;
 //#endregion
-export { AMOUNT_RELATIVE_EPSILON, ArrayElementKey, BPS_ABSOLUTE_EPSILON, ChainCompareCounts, CompareCounts, DiffKind, DiffOptions, DiffPathCount, ExpectedDiffReason, FieldDiff, USD_RELATIVE_EPSILON, asFiniteNumber, collapseArrayKeys, countPaths, diffObjects, diffValue, isAmountWithinTolerance, isBpsWithinTolerance, isRecord, isUsdWithinTolerance, toCompareCounts, union, withExpected, withinRelative, withinRelativeBigint };
+export { AMOUNT_RELATIVE_EPSILON, ArrayElementKey, BPS_ABSOLUTE_EPSILON, ChainCompareCounts, CompareCounts, DiffKind, DiffOptions, DiffPathCount, EntityFieldDiff, ExpectedDiffReason, FieldDiff, USD_RELATIVE_EPSILON, WorstDiff, asFiniteNumber, collapseArrayKeys, countPaths, diffObjects, diffValue, isAmountWithinTolerance, isBpsWithinTolerance, isRecord, isUsdWithinTolerance, relativeDiffBps, toCompareCounts, union, withExpected, withinRelative, withinRelativeBigint };

package/dist/types/dev/mode-parity/scriptUtils.d.ts

@@ -0,0 +1,47 @@
+import { ChainMetadata } from "../../model/response.js";
+import "../../model/index.js";
+import { ChainCompareCounts, CompareCounts, DiffPathCount } from "./fieldDiff.js";
+import { Logger } from "pino";
+//#region src/dev/mode-parity/scriptUtils.d.ts
+/**
+ * Chains the compare scripts attach to.
+ **/
+type ComparedNetwork = "Mainnet" | "Monad" | "Plasma" | "Somnia" | "Etherlink";
+declare const NETWORKS: ComparedNetwork[];
+declare const BACKEND_URL: string;
+declare const TIMEOUT = 480000;
+/**
+ * Totals both compare reports print.
+ **/
+interface PrintableCompareSummary extends CompareCounts {
+  byChain: ChainCompareCounts[];
+  diffsByPath: DiffPathCount[];
+}
+/**
+ * Per-source chain metadata both compare reports carry.
+ **/
+interface PrintableCompareReport {
+  backendUrl: string;
+  summary: PrintableCompareSummary;
+  onchainChains: ChainMetadata[];
+  offchainChains: ChainMetadata[];
+}
+declare function requireEnv(name: string): string;
+declare function rpcUrls(): Record<ComparedNetwork, string>;
+declare function createLogger(): Logger;
+declare function errorMessage(error: unknown): string;
+/**
+ * Runs `fn` over `items` with at most `concurrency` in flight.
+ **/
+declare function mapPool<T>(items: readonly T[], concurrency: number, fn: (item: T) => Promise<void>): Promise<void>;
+/**
+ * Formats a relative difference in bps as a percent, e.g. 12.5 → `"0.125%"`.
+ **/
+declare function formatBpsAsPercent(bps: number): string;
+/**
+ * Prints the shared membership table, the fields that differed most often,
+ * and any chain that failed to answer.
+ **/
+declare function printCompareSummary(noun: string, report: PrintableCompareReport, extraLines?: string[]): void;
+//#endregion
+export { BACKEND_URL, ComparedNetwork, NETWORKS, PrintableCompareReport, PrintableCompareSummary, TIMEOUT, createLogger, errorMessage, formatBpsAsPercent, mapPool, printCompareSummary, requireEnv, rpcUrls };

package/dist/types/model/compare.schema.d.ts

@@ -0,0 +1,47 @@
+import { z } from "zod/v4";
+//#region src/model/compare.schema.d.ts
+/**
+ * How close two numeric values may be before a disagreement counts as real.
+ *
+ * The compare scripts pick a formula from this union; the schemas only name
+ * which formula a field uses.
+ *
+ * - `"amount"` — accrual lag on an {@link Amount.value} / {@link TokenAmount.value}.
+ * - `"bps"` — truncation vs rounding on a basis-point rate, ±1.
+ * - `"float"` — relative float drift within 0.1% (leverage).
+ * - `"usd"` — price-derived {@link Amount.valueUsd} / {@link TokenAmount.valueUsd}.
+ **/
+type CompareTolerance = "amount" | "bps" | "float" | "usd";
+/**
+ * A numeric field whose two sources may drift within {@link tolerance}.
+ **/
+interface ToleranceCompareTag {
+  tolerance: CompareTolerance;
+}
+/**
+ * Compare metadata a schema field may carry.
+ *
+ * - `"offchainOnly"` / `"onchainOnly"` — the other source typically leaves
+ *   the field empty, so a disagreement is expected.
+ * - {@link ToleranceCompareTag} — a numeric disagreement within the named
+ *   formula is expected snapshot noise.
+ **/
+type CompareTag = "offchainOnly" | "onchainOnly" | ToleranceCompareTag;
+/**
+ * Marks a field that only the backend fills.
+ **/
+declare function offchainOnly<S extends z.ZodType>(schema: S): S;
+/**
+ * Marks a field that only the chain fills.
+ **/
+declare function onchainOnly<S extends z.ZodType>(schema: S): S;
+/**
+ * Marks a numeric field whose two sources may drift within {@link kind}.
+ **/
+declare function tolerance<S extends z.ZodType>(schema: S, kind: CompareTolerance): S;
+/**
+ * The compare tag registered on a schema, if any.
+ **/
+declare function compareTagOf(schema: z.ZodType): CompareTag | undefined;
+//#endregion
+export { CompareTag, CompareTolerance, ToleranceCompareTag, compareTagOf, offchainOnly, onchainOnly, tolerance };

package/dist/types/model/index.d.ts

@@ -2,6 +2,7 @@ import { Amount, AssetType, Bps, ChainId, Leverage, Timestamp, Token, TokenAmoun
 import { Curator, CuratorName } from "./curators.js";
 import { CHART_METRIC_UNITS, CHART_RANGES, CHART_UNAVAILABLE_CODES, ChartBundle, ChartDenomination, ChartMetric, ChartQuery, ChartRange, ChartSeries, ChartSeriesOk, ChartSeriesUnavailable, ChartUnavailableCode, ChartUnit, ChartValue, ChartWindow, GridSampling, OpportunityChartMetric, POOL_OPPORTUNITY_CHART_METRICS, POOL_POSITION_CHART_METRICS, PoolOpportunityChartMetric, PoolPositionChartMetric, PositionChartMetric, STRATEGY_OPPORTUNITY_CHART_METRICS, STRATEGY_POSITION_CHART_METRICS, StrategyOpportunityChartMetric, StrategyPositionChartMetric } from "./charts.js";
 import { chartBundleSchemaFor, chartDenominationSchema, chartMetricSchema, chartQueryCodec, chartQueryParamsSchema, chartQuerySchema, chartRangeSchema, chartSeriesSchema, chartValueSchema, chartWindowSchema, poolOpportunityChartMetricSchema, poolPositionChartMetricSchema, strategyOpportunityChartMetricSchema, strategyPositionChartMetricSchema } from "./charts.schema.js";
+import { CompareTag, CompareTolerance, ToleranceCompareTag, compareTagOf, offchainOnly, onchainOnly, tolerance } from "./compare.schema.js";
 import { curatorNameSchema, curatorSchema } from "./curators.schema.js";
 import { ChainScopedFilter, FILTER_ALL, FilterAll, Filterable, isFilterSet } from "./filters.js";
 import { booleanParamSchema, encodeFlag, filterAllSchema, filterable } from "./filters.schema.js";
@@ -16,4 +17,4 @@ import { borrowRateBreakdownSchema, pnlBreakdownSchema, pointsProgramPnLSchema,
 import { amountSchema, assetTypeSchema, bpsSchema, chainIdSchema, leverageSchema, timestampSchema, tokenAmountSchema, tokenSchema, txCallSchema } from "./primitives.schema.js";
 import { ChainFailed, ChainMetadata, ChainScoped, ChainSucceeded, DataResponse, DataSource, ResponseMetadata } from "./response.js";
 import { chainFailedSchema, chainMetadataSchema, chainSucceededSchema, dataSourceSchema, responseMetadataSchema, responseSchema } from "./response.schema.js";
-export { Amount, ApyBreakdown, AssetType, BorrowRateBreakdown, Bps, CHART_METRIC_UNITS, CHART_RANGES, CHART_UNAVAILABLE_CODES, ChainFailed, ChainId, ChainMetadata, ChainScoped, ChainScopedFilter, ChainSucceeded, ChartBundle, ChartDenomination, ChartMetric, ChartQuery, ChartRange, ChartSeries, ChartSeriesOk, ChartSeriesUnavailable, ChartUnavailableCode, ChartUnit, ChartValue, ChartWindow, Curator, CuratorName, DataResponse, DataSource, DelayedReceivedAsset, FILTER_ALL, FilterAll, Filterable, GridSampling, InstantReceivedAsset, Leverage, LiquidatableAccount, LiquidatableAccountFilter, LiquidationApproval, LiquidationDetails, LiquidationPosition, Notice, NoticeKind, NoticeSubject, Opportunity, OpportunityBase, OpportunityChartMetric, OpportunityDetail, OpportunityFilter, OpportunityId, OpportunityKey, OpportunityKind, POOL_OPPORTUNITY_CHART_METRICS, POOL_POSITION_CHART_METRICS, PnlBreakdown, PointRewards, PointsProgram, PointsProgramPnL, PointsRewardsPnL, PoolOpportunity, PoolOpportunityChartMetric, PoolOpportunityDetail, PoolOpportunityKey, PoolOpportunityRef, PoolPosition, PoolPositionChartMetric, PoolPositionKey, PoolPositionRef, Position, PositionChartMetric, PositionCollateral, PositionFilter, PositionId, PositionKey, PositionKind, PositionMetrics, PositionTransaction, PositionTransactionKind, PositionsTotals, PriceFeedData, PriceFeedSummary, QuotaAsset, RateCurve, RateCurvePoint, ReceivedAsset, ResponseMetadata, Rewards, RewardsPnL, STRATEGY_OPPORTUNITY_CHART_METRICS, STRATEGY_POSITION_CHART_METRICS, StrategyOpportunity, StrategyOpportunityChartMetric, StrategyOpportunityDetail, StrategyOpportunityKey, StrategyOpportunityRef, StrategyPosition, StrategyPositionChartMetric, StrategyPositionKey, StrategyPositionRef, Timestamp, Token, TokenAmount, TokenRewards, TokenRewardsPnL, TxCall, 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 { Amount, ApyBreakdown, AssetType, BorrowRateBreakdown, Bps, CHART_METRIC_UNITS, CHART_RANGES, CHART_UNAVAILABLE_CODES, ChainFailed, ChainId, ChainMetadata, ChainScoped, ChainScopedFilter, ChainSucceeded, ChartBundle, ChartDenomination, ChartMetric, ChartQuery, ChartRange, ChartSeries, ChartSeriesOk, ChartSeriesUnavailable, ChartUnavailableCode, ChartUnit, ChartValue, ChartWindow, CompareTag, CompareTolerance, Curator, CuratorName, DataResponse, DataSource, DelayedReceivedAsset, FILTER_ALL, FilterAll, Filterable, GridSampling, InstantReceivedAsset, Leverage, LiquidatableAccount, LiquidatableAccountFilter, LiquidationApproval, LiquidationDetails, LiquidationPosition, Notice, NoticeKind, NoticeSubject, Opportunity, OpportunityBase, OpportunityChartMetric, OpportunityDetail, OpportunityFilter, OpportunityId, OpportunityKey, OpportunityKind, POOL_OPPORTUNITY_CHART_METRICS, POOL_POSITION_CHART_METRICS, PnlBreakdown, PointRewards, PointsProgram, PointsProgramPnL, PointsRewardsPnL, PoolOpportunity, PoolOpportunityChartMetric, PoolOpportunityDetail, PoolOpportunityKey, PoolOpportunityRef, PoolPosition, PoolPositionChartMetric, PoolPositionKey, PoolPositionRef, Position, PositionChartMetric, PositionCollateral, PositionFilter, PositionId, PositionKey, PositionKind, PositionMetrics, PositionTransaction, PositionTransactionKind, PositionsTotals, PriceFeedData, PriceFeedSummary, QuotaAsset, RateCurve, RateCurvePoint, ReceivedAsset, ResponseMetadata, Rewards, RewardsPnL, STRATEGY_OPPORTUNITY_CHART_METRICS, STRATEGY_POSITION_CHART_METRICS, StrategyOpportunity, StrategyOpportunityChartMetric, StrategyOpportunityDetail, StrategyOpportunityKey, StrategyOpportunityRef, StrategyPosition, StrategyPositionChartMetric, StrategyPositionKey, StrategyPositionRef, Timestamp, Token, TokenAmount, TokenRewards, TokenRewardsPnL, ToleranceCompareTag, TxCall, 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 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gearbox-protocol/sdk",
-  "version": "15.1.0-next.11",
+  "version": "15.1.0-next.12",
   "description": "Gearbox SDK",
   "license": "MIT",
   "repository": {