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

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,5 +1,3 @@
-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";
@@ -10,6 +8,8 @@ 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,4 +1,3 @@
-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";
@@ -20,6 +19,7 @@ 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 { iWithdrawalCompressorV310Abi } from "../../../abi/IWithdrawalCompressorV310.js";
 import { AbstractWithdrawalCompressorContract } from "./AbstractWithdrawalCompressorContract.js";
+import { iWithdrawalCompressorV310Abi } from "../../../abi/IWithdrawalCompressorV310.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 { iWithdrawalCompressorV311Abi } from "../../../abi/IWithdrawalCompressorV311.js";
 import { AbstractWithdrawalCompressorContract } from "./AbstractWithdrawalCompressorContract.js";
+import { iWithdrawalCompressorV311Abi } from "../../../abi/IWithdrawalCompressorV311.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 { ierc20Abi } from "../../abi/iERC20.js";
 import { chains } from "./chains.js";
+import { ierc20Abi } from "../../abi/iERC20.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/math.js

@@ -23,8 +23,15 @@ function rayToBps(ray) {
 	return Number(ray * PERCENTAGE_FACTOR / 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
@@ -32,7 +39,7 @@ function rayToBps(ray) {
 * ```
 **/
 function usdToNumber(usd) {
-	return Number(usd) / Number(PRICE_DECIMALS);
+	return usd < USD_DUST_THRESHOLD ? 0 : Number(usd) / Number(PRICE_DECIMALS);
 }
 /**
 * Share of capital currently borrowed, in basis points. Returns `0` when there

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

@@ -1,4 +1,3 @@
-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";
@@ -7,6 +6,7 @@ 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 { iethZapperAbi } from "../../../abi/iETHZapper.js";
 import { ZapperContract } from "./ZapperContract.js";
+import { iethZapperAbi } from "../../../abi/iETHZapper.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 { ierc20Abi } from "../../abi/iERC20.js";
 import { AddressSet } from "../utils/AddressSet.js";
+import { ierc20Abi } from "../../abi/iERC20.js";
 import "../constants/addresses.js";
 import { PERCENTAGE_FACTOR, RAY } from "../constants/math.js";
 import "../constants/index.js";
@@ -414,7 +414,7 @@ var PoolService = class extends 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/esm/sdk/positions/PositionsService.js

@@ -1,6 +1,7 @@
 import { AddressMap } from "../utils/AddressMap.js";
 import "../constants/math.js";
 import "../constants/index.js";
+import { hexEq } from "../utils/hex.js";
 import "../utils/index.js";
 import { SDKConstruct } from "../base/SDKConstruct.js";
 import "../base/index.js";
@@ -146,7 +147,11 @@ var PositionsService = class extends SDKConstruct {
 		const { pool } = market.pool;
 		const token = this.sdk.tokensMeta.mustGetToken(market.unwrappedUnderlying);
 		const totalDebtValue = ca.debt + ca.accruedInterest + ca.accruedFees;
-		const collateral = dominantCollateral(ca, market);
+		let collateral = dominantCollateral(ca, market);
+		if (collateral) {
+			const source = this.sdk.withdrawalCompressor?.getWithdrawalSourceToken(collateral);
+			if (source) collateral = hexEq(source, market.underlying) ? void 0 : source;
+		}
 		const snapshot = accountSnapshotFromCreditAccountData(ca);
 		const borrowRate = this.borrowRate(snapshot);
 		const timeToLiquidation = this.timeToLiquidation(snapshot);

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

@@ -1,6 +1,6 @@
 import { errorAbis } from "../../../abi/errors.js";
-import { iUpdatablePriceFeedAbi } from "../../../abi/iUpdatablePriceFeed.js";
 import { generateCastTraceCall } from "./cast.js";
+import { iUpdatablePriceFeedAbi } from "../../../abi/iUpdatablePriceFeed.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

@@ -2,37 +2,9 @@ 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
-/**
- * What kind of disagreement a {@link FieldDiff} describes, so that a reader can
- * bucket the report without re-deriving it from the values.
- *
- * - `"presence"` — one side has no value at all (`undefined` or `null`).
- * - `"usd"` — an {@link Amount.valueUsd}, i.e. a price-derived float.
- * - `"numeric"` — any other number or bigint.
- * - `"other"` — everything else: strings, booleans, array shapes.
- **/
-type DiffKind = "presence" | "usd" | "numeric" | "other";
-/**
- * One field of one opportunity where the two sources disagree.
- **/
-interface FieldDiff {
-  /**
-   * Dotted path into the row, with array elements keyed by their own identity
-   * rather than by index, e.g. `collateralTokens[0xa0b8...].symbol`.
-   **/
-  path: string;
-  /**
-   * Value the chain reported, `undefined` when it has no such field.
-   **/
-  onchain: unknown;
-  /**
-   * Value the backend reported, see {@link onchain}.
-   **/
-  offchain: unknown;
-  kind: DiffKind;
-}
 /**
  * Enough of an opportunity to identify it in a report without carrying the
  * whole row.
@@ -64,36 +36,16 @@ interface OpportunityMatch {
    **/
   onchainName: string;
   offchainName: string;
+  /**
+   * No diffs at all, including the documented offchain-only ones.
+   **/
   identical: boolean;
+  /**
+   * No unexpected diffs: every disagreement is mode-scoped or within tolerance.
+   **/
+  clean: boolean;
   diffs: FieldDiff[];
 }
-/**
- * How often one field disagreed across all matched rows, with array keys
- * collapsed, e.g. `collateralTokens[].symbol`.
- **/
-interface DiffPathCount {
-  path: string;
-  kinds: DiffKind[];
-  count: number;
-}
-/**
- * Counts of one chain, or of the whole report when `chainId` is absent.
- **/
-interface CompareCounts {
-  onchainRows: number;
-  offchainRows: number;
-  matched: number;
-  identical: number;
-  differing: number;
-  onlyOnchain: number;
-  onlyOffchain: number;
-}
-/**
- * Counts of one chain.
- **/
-interface ChainCompareCounts extends CompareCounts {
-  chainId: ChainId;
-}
 /**
  * Totals of the comparison plus the fields that differed most often.
  **/
@@ -139,10 +91,10 @@ interface CompareOpportunitiesInput {
  * Matches two opportunity listings by {@link opportunityId} and reports every
  * field the two sources disagree on.
  *
- * Nothing is filtered out: a diff that is expected — a field only the backend
- * can fill, a formula the two sides define differently, a USD value smoothed on
- * one side — is reported like any other, tagged by {@link DiffKind} so that a
- * reader can bucket it afterwards.
+ * 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.
  **/
 declare function compareOpportunities(input: CompareOpportunitiesInput): OpportunityCompareReport;
 /**
@@ -150,4 +102,4 @@ declare function compareOpportunities(input: CompareOpportunitiesInput): Opportu
  **/
 declare function diffOpportunity(onchain: Opportunity, offchain: Opportunity): FieldDiff[];
 //#endregion
-export { ChainCompareCounts, CompareCounts, CompareOpportunitiesInput, CompareSummary, DiffKind, DiffPathCount, FieldDiff, OpportunityCompareReport, OpportunityMatch, OpportunityRef, compareOpportunities, diffOpportunity };
+export { type ChainCompareCounts, type CompareCounts, CompareOpportunitiesInput, CompareSummary, type DiffKind, type DiffPathCount, type ExpectedDiffReason, type FieldDiff, OpportunityCompareReport, OpportunityMatch, OpportunityRef, compareOpportunities, diffOpportunity };

package/dist/types/dev/comparePositions.d.ts

@@ -0,0 +1,149 @@
+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
+/**
+ * Enough of a position to identify it in a report without carrying the whole
+ * row.
+ **/
+interface PositionRef {
+  id: PositionId;
+  kind: PositionKind;
+  chainId: ChainId;
+  name: string;
+  /**
+   * Set on a pool position.
+   **/
+  pool?: Address;
+  /**
+   * Set on a strategy position.
+   **/
+  creditAccount?: Address;
+  creditManager?: Address;
+}
+/**
+ * One position both sources listed for a wallet, and everything they disagree
+ * on.
+ **/
+interface PositionMatch {
+  id: PositionId;
+  kind: PositionKind;
+  chainId: ChainId;
+  onchainName: string;
+  offchainName: string;
+  /**
+   * No diffs at all, including the documented mode-scoped ones.
+   **/
+  identical: boolean;
+  /**
+   * No unexpected diffs: every disagreement is mode-scoped or within tolerance.
+   **/
+  clean: boolean;
+  diffs: FieldDiff[];
+}
+/**
+ * One wallet's comparison, or the error that stopped it.
+ **/
+interface WalletComparison {
+  wallet: Address;
+  /**
+   * Why both listings of this wallet could not be read. When set, the rest of
+   * the fields are empty.
+   **/
+  error?: string;
+  onlyOnchain: PositionRef[];
+  onlyOffchain: PositionRef[];
+  matched: PositionMatch[];
+}
+/**
+ * Counts of one wallet.
+ **/
+interface WalletCompareCounts extends CompareCounts {
+  wallet: Address;
+  /**
+   * Present when the wallet's listings could not be read.
+   **/
+  error?: string;
+}
+/**
+ * Totals of the comparison plus the fields that differed most often.
+ **/
+interface PositionsCompareSummary extends CompareCounts {
+  wallets: number;
+  /**
+   * Wallets whose listings were read and that have no membership gaps and no
+   * unexpected field diffs.
+   **/
+  walletsClean: number;
+  walletsFailed: number;
+  byChain: ChainCompareCounts[];
+  byWallet: WalletCompareCounts[];
+  diffsByPath: DiffPathCount[];
+}
+/**
+ * Everything one comparison run produced, ready to be written out as JSON.
+ **/
+interface PositionsCompareReport {
+  generatedAt: string;
+  backendUrl: string;
+  networks: string[];
+  /**
+   * Per-chain metadata collected from the on-chain reads, which says which
+   * block each chain answered from. Taken from the first successful wallet
+   * listing of each chain.
+   **/
+  onchainChains: ChainMetadata[];
+  /**
+   * Per-chain metadata of the backend reads, see {@link onchainChains}.
+   **/
+  offchainChains: ChainMetadata[];
+  summary: PositionsCompareSummary;
+  wallets: WalletComparison[];
+}
+/**
+ * Both listings of one wallet.
+ **/
+interface WalletPositions {
+  wallet: Address;
+  onchain: DataResponse<Position[]>;
+  offchain: DataResponse<Position[]>;
+}
+/**
+ * A wallet whose listings could not be read from one or both sources.
+ **/
+interface WalletPositionsFailure {
+  wallet: Address;
+  error: string;
+}
+/**
+ * The per-wallet listings to compare, plus what the run was pointed at.
+ **/
+interface ComparePositionsInput {
+  wallets: WalletPositions[];
+  failures?: WalletPositionsFailure[];
+  backendUrl: string;
+  networks: string[];
+  /**
+   * ISO timestamp stamped onto the report, defaulting to now. Pinned by tests.
+   **/
+  generatedAt?: string;
+}
+/**
+ * Matches two position listings per wallet by {@link positionId} and reports
+ * every field the two sources disagree on.
+ *
+ * Nothing is filtered out. A field only one mode can fill, or a USD value that
+ * drifted within snapshot-lag noise, is still reported — tagged
+ * {@link FieldDiff.expected} so that {@link CompareCounts.clean} can ignore it
+ * while {@link CompareCounts.identical} stays strict.
+ **/
+declare function comparePositions(input: ComparePositionsInput): PositionsCompareReport;
+/**
+ * Every field two versions of one position disagree on.
+ **/
+declare function diffPosition(onchain: Position, offchain: Position): FieldDiff[];
+//#endregion
+export { ComparePositionsInput, PositionMatch, PositionRef, PositionsCompareReport, PositionsCompareSummary, WalletCompareCounts, WalletComparison, WalletPositions, WalletPositionsFailure, comparePositions, diffPosition };

package/dist/types/dev/fieldDiff.d.ts

@@ -0,0 +1,167 @@
+import { ChainId } from "../model/primitives.js";
+import "../model/index.js";
+//#region src/dev/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.
+ *
+ * - `"presence"` — one side has no value at all (`undefined` or `null`).
+ * - `"usd"` — an {@link Amount.valueUsd}, i.e. a price-derived float.
+ * - `"numeric"` — any other number or bigint.
+ * - `"other"` — everything else: strings, booleans, array shapes.
+ **/
+type DiffKind = "presence" | "usd" | "numeric" | "other";
+/**
+ * Why a {@link FieldDiff} is expected rather than a real disagreement.
+ *
+ * - `"mode-scoped"` — a field documented `@mode offchain` or `@mode onchain`,
+ *   so the other source has nothing to put there.
+ * - `"tolerance"` — snapshot lag or float-path noise within the thresholds
+ *   below, not a formula or membership mismatch.
+ **/
+type ExpectedDiffReason = "mode-scoped" | "tolerance";
+/**
+ * One field of one row where the two sources disagree.
+ **/
+interface FieldDiff {
+  /**
+   * Dotted path into the row, with array elements keyed by their own identity
+   * rather than by index, e.g. `collateralTokens[0xa0b8...].symbol`.
+   **/
+  path: string;
+  /**
+   * Value the chain reported, `undefined` when it has no such field.
+   **/
+  onchain: unknown;
+  /**
+   * Value the backend reported, see {@link onchain}.
+   **/
+  offchain: unknown;
+  kind: DiffKind;
+  /**
+   * Present when this disagreement is documented or within snapshot-lag noise,
+   * so it does not keep the row from being counted as clean.
+   **/
+  expected?: true;
+  reason?: ExpectedDiffReason;
+}
+/**
+ * How often one field disagreed across all matched rows, with array keys
+ * collapsed, e.g. `collateralTokens[].symbol`.
+ **/
+interface DiffPathCount {
+  path: string;
+  kinds: DiffKind[];
+  count: number;
+  expected: number;
+  unexpected: number;
+}
+/**
+ * Counts of one chain, one wallet, or of the whole report when those ids are
+ * absent.
+ **/
+interface CompareCounts {
+  onchainRows: number;
+  offchainRows: number;
+  matched: number;
+  identical: number;
+  /**
+   * Matched rows with no unexpected diffs, including the identical ones.
+   **/
+  clean: number;
+  differing: number;
+  onlyOnchain: number;
+  onlyOffchain: number;
+}
+/**
+ * Counts of one chain.
+ **/
+interface ChainCompareCounts extends CompareCounts {
+  chainId: ChainId;
+}
+/**
+ * Identity of an array element, used so a token present on one side only is
+ * reported as such rather than shifting every later element into a diff.
+ *
+ * Return a string to key the element; `undefined` falls back to the default
+ * (`address`, `id`, `token`, or nested `token.address`).
+ **/
+type ArrayElementKey = (path: string, value: unknown) => string | undefined;
+/**
+ * How to walk two values. Callers that need identity-bearing arrays whose
+ * key is not one of the defaults pass {@link DiffOptions.keyOf}.
+ **/
+interface DiffOptions {
+  keyOf?: ArrayElementKey;
+}
+/**
+ * Relative drift allowed on {@link Amount.valueUsd} before a USD float is a
+ * real disagreement: 0.1%.
+ **/
+declare const USD_RELATIVE_EPSILON = 0.001;
+/**
+ * Relative drift allowed on lag-bounded bigint amounts: 0.05%.
+ **/
+declare const AMOUNT_RELATIVE_EPSILON = 0.0005;
+/**
+ * Absolute drift allowed on bps rates before rounding and a one-block lag are
+ * no longer enough to explain it.
+ **/
+declare const BPS_ABSOLUTE_EPSILON = 1;
+/**
+ * Every field two versions of one value disagree on. Nothing is filtered or
+ * tagged: the caller marks expected diffs afterwards.
+ **/
+declare function diffValue(path: string, onchain: unknown, offchain: unknown, out: FieldDiff[], options?: DiffOptions): void;
+/**
+ * Deep-diff two values and return the disagreements, in path order of
+ * discovery.
+ **/
+declare function diffObjects(onchain: unknown, offchain: unknown, options?: DiffOptions): FieldDiff[];
+/**
+ * Mark a diff expected, so a later `clean` count can ignore it.
+ **/
+declare function withExpected(diff: FieldDiff, reason: ExpectedDiffReason): FieldDiff;
+/**
+ * How often each field differed, with array keys collapsed so that the same
+ * field of a hundred collateral tokens counts as one path. Sorted so the
+ * unexpected disagreements come first.
+ **/
+declare function countPaths(diffs: Iterable<FieldDiff>): DiffPathCount[];
+/**
+ * Collapse `collateralTokens[0xa0b8...].symbol` to `collateralTokens[].symbol`.
+ **/
+declare function collapseArrayKeys(path: string): string;
+/**
+ * Membership and match totals of one comparison, from already-built lists.
+ **/
+declare function toCompareCounts(onchainRows: number, offchainRows: number, onlyOnchain: number, onlyOffchain: number, matched: ReadonlyArray<{
+  identical: boolean;
+  clean: boolean;
+}>): CompareCounts;
+/**
+ * USD floats within {@link USD_RELATIVE_EPSILON}.
+ **/
+declare function isUsdWithinTolerance(onchain: unknown, offchain: unknown): boolean;
+/**
+ * Bps rates that differ by at most {@link BPS_ABSOLUTE_EPSILON}.
+ **/
+declare function isBpsWithinTolerance(onchain: unknown, offchain: unknown): boolean;
+/**
+ * Bigint amounts within {@link AMOUNT_RELATIVE_EPSILON}.
+ **/
+declare function isAmountWithinTolerance(onchain: unknown, offchain: unknown): boolean;
+/**
+ * Finite numbers within a relative epsilon of each other.
+ **/
+declare function withinRelative(onchain: number | undefined, offchain: number | undefined, epsilon: number): boolean;
+/**
+ * `diff / max(|a|, |b|) <= epsilon`, computed in integer arithmetic so a
+ * 1e18-scale amount does not round through `Number`.
+ **/
+declare function withinRelativeBigint(onchain: bigint, offchain: bigint, epsilon: number): boolean;
+declare function asFiniteNumber(value: 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 };

package/dist/types/sdk/market/math.d.ts

@@ -15,6 +15,8 @@ declare function rayToBps(ray: bigint): Bps;
 /**
  * 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

package/package.json

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