@gearbox-protocol/sdk 14.12.0-next.77 → 14.12.0-next.79

package/dist/cjs/sdk/opportunities/OpportunitiesService.js

@@ -1,6 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_sdk_base_SDKConstruct = require("../base/SDKConstruct.js");
 require("../base/index.js");
+const require_model_filters = require("../../model/filters.js");
+require("../../model/index.js");
 //#region src/sdk/opportunities/OpportunitiesService.ts
 /**
 * Builds the `opportunities` read model from the chain.
@@ -22,7 +24,8 @@ var OpportunitiesService = class extends require_sdk_base_SDKConstruct.SDKConstr
 	* @param filter - Optional narrowing, applied to the built rows.
 	**/
 	async list(filter) {
-		if (filter?.chainIds && !filter.chainIds.includes(this.chainId)) return [];
+		const chainIds = filter?.chainIds;
+		if (require_model_filters.isFilterSet(chainIds) && !chainIds.includes(this.chainId)) return [];
 		return this.sdk.marketRegister.markets.flatMap((market) => market.opportunities(filter));
 	}
 	/**

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

@@ -2,6 +2,8 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_sdk_chain_chains = require("../chain/chains.js");
 const require_sdk_base_MultichainConstruct = require("../base/MultichainConstruct.js");
 require("../base/index.js");
+const require_model_filters = require("../../model/filters.js");
+require("../../model/index.js");
 //#region src/sdk/positions/MultichainPositionsService.ts
 /**
 * Cross-chain counterpart of {@link PositionsService}.
@@ -34,9 +36,10 @@ var MultichainPositionsService = class extends require_sdk_base_MultichainConstr
 	* a filter naming them is a narrowing, not a request.
 	**/
 	#networksOf(filter) {
-		if (!filter?.chainIds) return;
+		const chainIds = filter?.chainIds;
+		if (!require_model_filters.isFilterSet(chainIds)) return;
 		const networks = [];
-		for (const chainId of filter.chainIds) try {
+		for (const chainId of chainIds) try {
 			networks.push(require_sdk_chain_chains.getNetworkType(chainId));
 		} catch {
 			this.sdk.logger?.debug(`ignoring unsupported chain ${chainId} in positions filter`);

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

@@ -1,6 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_sdk_base_SDKConstruct = require("../base/SDKConstruct.js");
 require("../base/index.js");
+const require_model_filters = require("../../model/filters.js");
 const require_model_positions = require("../../model/positions.js");
 require("../../model/index.js");
 //#region src/sdk/positions/PositionsService.ts
@@ -13,18 +14,21 @@ var PositionsService = class extends require_sdk_base_SDKConstruct.SDKConstruct
 	/**
 	* Every position of a wallet on this chain, optionally narrowed by
 	* {@link PositionFilter} (see {@link matchesPositionFilter} for what each
-	* criterion selects). Reads live chain state, so rows reflect the moment of
+	* condition selects). Reads live chain state, so rows reflect the moment of
 	* the call rather than the SDK's loaded snapshot.
 	**/
 	async list(props) {
 		const { wallet, filter } = props;
-		if (filter?.chainIds && !filter.chainIds.includes(this.chainId)) return [];
-		const wanted = (kind) => !filter?.kind || filter.kind === kind;
+		const chainIds = filter?.chainIds;
+		if (require_model_filters.isFilterSet(chainIds) && !chainIds.includes(this.chainId)) return [];
+		const wantedKind = filter?.kind;
+		const wanted = (kind) => !require_model_filters.isFilterSet(wantedKind) || wantedKind === kind;
+		const isZeroDebt = filter?.isZeroDebt;
 		const [pool, strategy, liquidation] = await Promise.all([
 			wanted("pool") ? this.sdk.pools.listPositions({ wallet }) : Promise.resolve([]),
 			wanted("strategy") ? this.sdk.accounts.listPositions({
 				owner: wallet,
-				includeZeroDebt: filter?.isZeroDebt !== false
+				includeZeroDebt: !require_model_filters.isFilterSet(isZeroDebt) || isZeroDebt
 			}) : Promise.resolve([]),
 			wanted("liquidation") ? this.sdk.liquidations.getLiquidationPositions({ liquidator: wallet }) : Promise.resolve([])
 		]);

package/dist/cjs/sdk/utils/index.js

@@ -24,6 +24,7 @@ exports.AssetsMap = require_sdk_utils_AssetsMap.AssetsMap;
 exports.BigIntMath = require_sdk_utils_bigint_math.BigIntMath;
 exports.TypedObjectUtils = require_sdk_utils_mappers.TypedObjectUtils;
 exports.ZodAddress = require_sdk_utils_zod.ZodAddress;
+exports.ZodBigInt = require_sdk_utils_zod.ZodBigInt;
 exports.ZodHex = require_sdk_utils_zod.ZodHex;
 exports.bytes32ToString = require_sdk_utils_bytes32ToString.bytes32ToString;
 exports.childLogger = require_sdk_utils_childLogger.childLogger;

package/dist/cjs/sdk/utils/zod.js

@@ -3,27 +3,49 @@ let viem = require("viem");
 let zod_v4 = require("zod/v4");
 //#region src/sdk/utils/zod.ts
 /**
+* A `bigint` codec that serializes into string, deserializes into bigint.
+*/
+const ZodBigInt = () => zod_v4.z.codec(zod_v4.z.union([zod_v4.z.string().regex(zod_v4.z.regexes.integer), zod_v4.z.bigint()]), zod_v4.z.bigint(), {
+	decode: (value) => typeof value === "bigint" ? value : BigInt(value),
+	encode: (value) => value.toString()
+});
+const addressOut = zod_v4.z.custom((val) => typeof val === "string" && (0, viem.isAddress)(val, { strict: false }));
+/**
 * Like Address from abitype/zod, but converts an address into an address that is checksum encoded.
 */
-const ZodAddress = () => zod_v4.z.string().transform((val, ctx) => {
-	if (!(0, viem.isAddress)(val)) ctx.issues.push({
-		code: "custom",
-		message: `invalid address ${val}`,
-		input: ctx.value
-	});
-	return (0, viem.getAddress)(val);
+const ZodAddress = () => zod_v4.z.codec(zod_v4.z.string(), addressOut, {
+	decode: (val, ctx) => {
+		if (!(0, viem.isAddress)(val, { strict: false })) {
+			ctx.issues.push({
+				code: "custom",
+				message: `invalid address ${val}`,
+				input: val
+			});
+			return zod_v4.z.NEVER;
+		}
+		return (0, viem.getAddress)(val);
+	},
+	encode: (address) => address
 });
+const hexOut = zod_v4.z.custom((val) => typeof val === "string" && (0, viem.isHex)(val));
 /**
 * A `0x`-prefixed hex string, as viem's Hex.
 */
-const ZodHex = () => zod_v4.z.string().transform((val, ctx) => {
-	if (!(0, viem.isHex)(val)) ctx.issues.push({
-		code: "custom",
-		message: `invalid hex string ${val}`,
-		input: ctx.value
-	});
-	return val;
+const ZodHex = () => zod_v4.z.codec(zod_v4.z.string(), hexOut, {
+	decode: (val, ctx) => {
+		if (!(0, viem.isHex)(val)) {
+			ctx.issues.push({
+				code: "custom",
+				message: `invalid hex string ${val}`,
+				input: val
+			});
+			return zod_v4.z.NEVER;
+		}
+		return val;
+	},
+	encode: (hex) => hex
 });
 //#endregion
 exports.ZodAddress = ZodAddress;
+exports.ZodBigInt = ZodBigInt;
 exports.ZodHex = ZodHex;

package/dist/esm/model/filters.js

@@ -0,0 +1,18 @@
+//#region src/model/filters.ts
+/**
+* The vocabulary every read-model filter is written in: how a single condition
+* says "do not narrow", and how a predicate asks whether it narrows at all.
+**/
+/**
+* Sentinel a filter condition can be set to instead of being omitted.
+**/
+const FILTER_ALL = "all";
+/**
+* Whether a condition narrows anything. An omitted condition and one set to
+* {@link FILTER_ALL} both do not, so this is the only check a predicate needs.
+**/
+function isFilterSet(condition) {
+	return condition !== void 0 && condition !== "all";
+}
+//#endregion
+export { FILTER_ALL, isFilterSet };

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

@@ -0,0 +1,19 @@
+import "./filters.js";
+import { z } from "zod/v4";
+//#region src/model/filters.schema.ts
+/**
+* Runtime schemas for {@link ./filters.js}, see the note in
+* `primitives.schema.ts` on why they are written by hand.
+**/
+/**
+* {@link FilterAll}
+**/
+const filterAllSchema = z.literal("all");
+/**
+* {@link Filterable}
+**/
+function filterable(schema) {
+	return z.union([schema, filterAllSchema]);
+}
+//#endregion
+export { filterAllSchema, filterable };

package/dist/esm/model/index.js

@@ -1,5 +1,7 @@
 import "./curators.js";
 import { curatorNameSchema, curatorSchema } from "./curators.schema.js";
+import { FILTER_ALL, isFilterSet } from "./filters.js";
+import { filterAllSchema, filterable } from "./filters.schema.js";
 import { POOL_HISTORY_METRICS, POOL_POSITION_HISTORY_METRICS, STRATEGY_HISTORY_METRICS, STRATEGY_POSITION_HISTORY_METRICS } from "./history.js";
 import { amountSchema, assetTypeSchema, bpsSchema, chainIdSchema, leverageSchema, timestampSchema, tokenAmountSchema, tokenSchema, txCallSchema } from "./primitives.schema.js";
 import { apyBreakdownSchema, opportunityBaseSchema, opportunityDetailSchema, opportunityFilterSchema, opportunityKeySchema, opportunityKindSchema, opportunitySchema, pointRewardsSchema, pointsProgramSchema, poolOpportunityDetailSchema, poolOpportunityKeySchema, poolOpportunitySchema, priceFeedDataSchema, priceFeedSummarySchema, quotaAssetSchema, rateCurvePointSchema, rateCurveSchema, rewardsSchema, strategyOpportunityDetailSchema, strategyOpportunityKeySchema, strategyOpportunitySchema, tokenRewardsSchema } from "./opportunities.schema.js";
@@ -10,4 +12,4 @@ import { matchesLiquidatableAccountFilter } from "./liquidations.js";
 import { matchesOpportunityFilter, opportunityId, poolOpportunityId, strategyOpportunityId } from "./opportunities.js";
 import { liquidationPositionId, matchesPositionFilter, poolPositionId, positionId, strategyPositionId } from "./positions.js";
 import "./primitives.js";
-export { POOL_HISTORY_METRICS, POOL_POSITION_HISTORY_METRICS, STRATEGY_HISTORY_METRICS, STRATEGY_POSITION_HISTORY_METRICS, amountSchema, apyBreakdownSchema, assetTypeSchema, bpsSchema, chainIdSchema, curatorNameSchema, curatorSchema, delayedReceivedAssetSchema, historyChartMetadataSchema, historyMetricSchema, historyPointSchema, historyRangeSchema, historySeriesSchema, instantReceivedAssetSchema, leverageSchema, liquidatableAccountFilterSchema, liquidatableAccountSchema, liquidationApprovalSchema, liquidationDetailsSchema, liquidationPositionId, liquidationPositionSchema, matchesLiquidatableAccountFilter, matchesOpportunityFilter, matchesPositionFilter, opportunityBaseSchema, opportunityDetailSchema, opportunityFilterSchema, opportunityHistoryQuerySchema, opportunityId, opportunityKeySchema, opportunityKindSchema, opportunitySchema, pnlBreakdownSchema, pointRewardsSchema, pointsProgramPnLSchema, pointsProgramSchema, pointsRewardsPnLSchema, poolHistoryMetricSchema, poolOpportunityDetailSchema, poolOpportunityId, poolOpportunityKeySchema, poolOpportunitySchema, poolPositionHistoryMetricSchema, poolPositionId, poolPositionKeySchema, poolPositionSchema, positionCollateralSchema, positionFilterSchema, positionHistoryMetricSchema, positionHistoryQuerySchema, positionId, positionKeySchema, positionKindSchema, positionSchema, priceFeedDataSchema, priceFeedSummarySchema, quotaAssetSchema, rateCurvePointSchema, rateCurveSchema, receivedAssetSchema, rewardsPnLSchema, rewardsSchema, strategyHistoryMetricSchema, strategyOpportunityDetailSchema, strategyOpportunityId, strategyOpportunityKeySchema, strategyOpportunitySchema, strategyPositionHistoryMetricSchema, strategyPositionId, strategyPositionKeySchema, strategyPositionSchema, timestampSchema, tokenAmountSchema, tokenRewardsPnLSchema, tokenRewardsSchema, tokenSchema, txCallSchema };
+export { FILTER_ALL, POOL_HISTORY_METRICS, POOL_POSITION_HISTORY_METRICS, STRATEGY_HISTORY_METRICS, STRATEGY_POSITION_HISTORY_METRICS, amountSchema, apyBreakdownSchema, assetTypeSchema, bpsSchema, chainIdSchema, curatorNameSchema, curatorSchema, delayedReceivedAssetSchema, filterAllSchema, filterable, historyChartMetadataSchema, historyMetricSchema, historyPointSchema, historyRangeSchema, historySeriesSchema, instantReceivedAssetSchema, isFilterSet, leverageSchema, liquidatableAccountFilterSchema, liquidatableAccountSchema, liquidationApprovalSchema, liquidationDetailsSchema, liquidationPositionId, liquidationPositionSchema, matchesLiquidatableAccountFilter, matchesOpportunityFilter, matchesPositionFilter, opportunityBaseSchema, opportunityDetailSchema, opportunityFilterSchema, opportunityHistoryQuerySchema, opportunityId, opportunityKeySchema, opportunityKindSchema, opportunitySchema, pnlBreakdownSchema, pointRewardsSchema, pointsProgramPnLSchema, pointsProgramSchema, pointsRewardsPnLSchema, poolHistoryMetricSchema, poolOpportunityDetailSchema, poolOpportunityId, poolOpportunityKeySchema, poolOpportunitySchema, poolPositionHistoryMetricSchema, poolPositionId, poolPositionKeySchema, poolPositionSchema, positionCollateralSchema, positionFilterSchema, positionHistoryMetricSchema, positionHistoryQuerySchema, positionId, positionKeySchema, positionKindSchema, positionSchema, priceFeedDataSchema, priceFeedSummarySchema, quotaAssetSchema, rateCurvePointSchema, rateCurveSchema, receivedAssetSchema, rewardsPnLSchema, rewardsSchema, strategyHistoryMetricSchema, strategyOpportunityDetailSchema, strategyOpportunityId, strategyOpportunityKeySchema, strategyOpportunitySchema, strategyPositionHistoryMetricSchema, strategyPositionId, strategyPositionKeySchema, strategyPositionSchema, timestampSchema, tokenAmountSchema, tokenRewardsPnLSchema, tokenRewardsSchema, tokenSchema, txCallSchema };

package/dist/esm/model/liquidations.js

@@ -1,21 +1,23 @@
+import { isFilterSet } from "./filters.js";
 //#region src/model/liquidations.ts
 /**
-* Whether a liquidatable account satisfies every criterion of a filter.
+* Whether a liquidatable account satisfies every condition of a filter.
 *
-* This is the single definition of what each criterion means: every source
+* This is the single definition of what each condition means: every source
 * builds its rows first and runs them through here, so the chain and the
 * backend cannot disagree on what a filter selects.
 *
 * @param account - Row to test.
-* @param filter - Criteria to test against. An absent filter matches anything.
+* @param filter - Conditions to test against. An absent filter matches
+* anything.
 **/
 function matchesLiquidatableAccountFilter(account, filter) {
 	if (!filter) return true;
-	if (filter.chainIds && !filter.chainIds.includes(account.chainId)) return false;
-	if (filter.underlyingType && account.totalValue.token.assetType !== filter.underlyingType) return false;
-	if (filter.paused !== void 0 && account.paused !== filter.paused) return false;
-	if (filter.rwa !== void 0 && account.rwa !== filter.rwa) return false;
-	if (filter.delayed !== void 0 && account.isDelayed !== filter.delayed) return false;
+	if (isFilterSet(filter.chainIds) && !filter.chainIds.includes(account.chainId)) return false;
+	if (isFilterSet(filter.underlyingType) && account.totalValue.token.assetType !== filter.underlyingType) return false;
+	if (isFilterSet(filter.paused) && account.paused !== filter.paused) return false;
+	if (isFilterSet(filter.rwa) && account.rwa !== filter.rwa) return false;
+	if (isFilterSet(filter.delayed) && account.isDelayed !== filter.delayed) return false;
 	return true;
 }
 //#endregion

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

@@ -1,4 +1,5 @@
 import { ZodAddress } from "../sdk/utils/zod.js";
+import { filterable } from "./filters.schema.js";
 import { assetTypeSchema, chainIdSchema, timestampSchema, tokenAmountSchema, tokenSchema, txCallSchema } from "./primitives.schema.js";
 import { z } from "zod/v4";
 //#region src/model/liquidations.schema.ts
@@ -10,11 +11,11 @@ import { z } from "zod/v4";
 * {@link LiquidatableAccountFilter}
 **/
 const liquidatableAccountFilterSchema = z.object({
-	chainIds: z.array(chainIdSchema).optional(),
-	underlyingType: assetTypeSchema.optional(),
-	paused: z.boolean().optional(),
-	rwa: z.boolean().optional(),
-	delayed: z.boolean().optional()
+	chainIds: filterable(z.array(chainIdSchema)).optional(),
+	underlyingType: filterable(assetTypeSchema).optional(),
+	paused: filterable(z.boolean()).optional(),
+	rwa: filterable(z.boolean()).optional(),
+	delayed: filterable(z.boolean()).optional()
 });
 /**
 * {@link LiquidatableAccount}

package/dist/esm/model/opportunities.js

@@ -1,3 +1,4 @@
+import { isFilterSet } from "./filters.js";
 //#region src/model/opportunities.ts
 /**
 * Builds the canonical id of a pool opportunity.
@@ -28,23 +29,24 @@ function opportunityId(opportunity) {
 	return opportunity.kind === "pool" ? poolOpportunityId(opportunity.chainId, opportunity.pool) : strategyOpportunityId(opportunity.chainId, opportunity.creditManager, opportunity.targetCollateral.address);
 }
 /**
-* Whether an opportunity satisfies every criterion of a filter.
+* Whether an opportunity satisfies every condition of a filter.
 *
-* This is the single definition of what each criterion means: every source
+* This is the single definition of what each condition means: every source
 * builds its rows first and runs them through here, so the chain and the
 * backend cannot disagree on what a filter selects.
 *
 * @param opportunity - Row to test.
-* @param filter - Criteria to test against. An absent filter matches anything.
+* @param filter - Conditions to test against. An absent filter matches
+* anything.
 **/
 function matchesOpportunityFilter(opportunity, filter) {
 	if (!filter) return true;
-	if (filter.kind && opportunity.kind !== filter.kind) return false;
-	if (filter.chainIds && !filter.chainIds.includes(opportunity.chainId)) return false;
-	if (filter.underlyingType && opportunity.underlyingToken.assetType !== filter.underlyingType) return false;
-	if (filter.paused !== void 0 && opportunity.paused !== filter.paused) return false;
-	if (filter.sunset !== void 0 && opportunity.sunset !== filter.sunset) return false;
-	if (filter.rwa !== void 0 && opportunity.rwa !== filter.rwa) return false;
+	if (isFilterSet(filter.kind) && opportunity.kind !== filter.kind) return false;
+	if (isFilterSet(filter.chainIds) && !filter.chainIds.includes(opportunity.chainId)) return false;
+	if (isFilterSet(filter.underlyingType) && opportunity.underlyingToken.assetType !== filter.underlyingType) return false;
+	if (isFilterSet(filter.paused) && opportunity.paused !== filter.paused) return false;
+	if (isFilterSet(filter.sunset) && opportunity.sunset !== filter.sunset) return false;
+	if (isFilterSet(filter.rwa) && opportunity.rwa !== filter.rwa) return false;
 	return true;
 }
 //#endregion

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

@@ -1,5 +1,6 @@
 import { ZodAddress } from "../sdk/utils/zod.js";
 import { curatorSchema } from "./curators.schema.js";
+import { filterable } from "./filters.schema.js";
 import { amountSchema, assetTypeSchema, bpsSchema, chainIdSchema, leverageSchema, timestampSchema, tokenSchema } from "./primitives.schema.js";
 import { z } from "zod/v4";
 //#region src/model/opportunities.schema.ts
@@ -102,12 +103,12 @@ const opportunitySchema = z.discriminatedUnion("kind", [poolOpportunitySchema, s
 * {@link OpportunityFilter}
 **/
 const opportunityFilterSchema = z.object({
-	kind: opportunityKindSchema.optional(),
-	chainIds: z.array(chainIdSchema).optional(),
-	underlyingType: assetTypeSchema.optional(),
-	paused: z.boolean().optional(),
-	sunset: z.boolean().optional(),
-	rwa: z.boolean().optional()
+	kind: filterable(opportunityKindSchema).optional(),
+	chainIds: filterable(z.array(chainIdSchema)).optional(),
+	underlyingType: filterable(assetTypeSchema).optional(),
+	paused: filterable(z.boolean()).optional(),
+	sunset: filterable(z.boolean()).optional(),
+	rwa: filterable(z.boolean()).optional()
 });
 /**
 * {@link RateCurvePoint}

package/dist/esm/model/positions.js

@@ -1,3 +1,4 @@
+import { isFilterSet } from "./filters.js";
 //#region src/model/positions.ts
 /**
 * Builds the canonical id of a pool position.
@@ -45,26 +46,27 @@ function positionId(position) {
 	}
 }
 /**
-* Whether a position satisfies every criterion of a filter.
+* Whether a position satisfies every condition of a filter.
 *
-* This is the single definition of what each criterion means: every source
+* This is the single definition of what each condition means: every source
 * builds its rows first and runs them through here, so the chain and the
 * backend cannot disagree on what a filter selects.
 *
-* A criterion that does not apply to a position's kind keeps the row rather
+* A condition that does not apply to a position's kind keeps the row rather
 * than dropping it: `isZeroDebt` says nothing about a pool position, and
 * `underlyingType` says nothing about a liquidation position, which is
 * denominated in whatever its withdrawal pays out.
 *
 * @param position - Row to test.
-* @param filter - Criteria to test against. An absent filter matches anything.
+* @param filter - Conditions to test against. An absent filter matches
+* anything.
 **/
 function matchesPositionFilter(position, filter) {
 	if (!filter) return true;
-	if (filter.kind && position.kind !== filter.kind) return false;
-	if (filter.chainIds && !filter.chainIds.includes(position.chainId)) return false;
-	if (filter.isZeroDebt !== void 0 && position.kind === "strategy" && position.totalDebt.value === 0n !== filter.isZeroDebt) return false;
-	if (filter.underlyingType) {
+	if (isFilterSet(filter.kind) && position.kind !== filter.kind) return false;
+	if (isFilterSet(filter.chainIds) && !filter.chainIds.includes(position.chainId)) return false;
+	if (isFilterSet(filter.isZeroDebt) && position.kind === "strategy" && position.totalDebt.value === 0n !== filter.isZeroDebt) return false;
+	if (isFilterSet(filter.underlyingType)) {
 		const underlying = positionUnderlying(position);
 		if (underlying && underlying.assetType !== filter.underlyingType) return false;
 	}

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

@@ -1,4 +1,5 @@
 import { ZodAddress } from "../sdk/utils/zod.js";
+import { filterable } from "./filters.schema.js";
 import { assetTypeSchema, bpsSchema, chainIdSchema, leverageSchema, tokenAmountSchema, tokenSchema } from "./primitives.schema.js";
 import { apyBreakdownSchema, pointsProgramSchema } from "./opportunities.schema.js";
 import { delayedReceivedAssetSchema, liquidationPositionSchema } from "./liquidations.schema.js";
@@ -100,10 +101,10 @@ const positionSchema = z.discriminatedUnion("kind", [
 * {@link PositionFilter}
 **/
 const positionFilterSchema = z.object({
-	kind: positionKindSchema.optional(),
-	isZeroDebt: z.boolean().optional(),
-	chainIds: z.array(chainIdSchema).optional(),
-	underlyingType: assetTypeSchema.optional()
+	kind: filterable(positionKindSchema).optional(),
+	isZeroDebt: filterable(z.boolean()).optional(),
+	chainIds: filterable(z.array(chainIdSchema)).optional(),
+	underlyingType: filterable(assetTypeSchema).optional()
 });
 /**
 * {@link PoolPositionKey}

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

@@ -1,4 +1,4 @@
-import { ZodAddress, ZodHex } from "../sdk/utils/zod.js";
+import { ZodAddress, ZodBigInt, ZodHex } from "../sdk/utils/zod.js";
 import { z } from "zod/v4";
 //#region src/model/primitives.schema.ts
 /**
@@ -30,14 +30,15 @@ const assetTypeSchema = z.union([
 	z.literal("BTC")
 ]);
 /**
-* {@link Leverage}
+* {@link Leverage}. Nonnegative rather than positive: `0` is the backend's
+* encoding of "leverage unavailable".
 **/
-const leverageSchema = z.number().positive();
+const leverageSchema = z.number().nonnegative();
 /**
 * {@link Amount}
 **/
 const amountSchema = z.object({
-	value: z.bigint(),
+	value: ZodBigInt(),
 	valueUsd: z.number().nullable()
 });
 /**
@@ -61,7 +62,7 @@ const tokenAmountSchema = amountSchema.extend({ token: tokenSchema });
 const txCallSchema = z.object({
 	to: ZodAddress(),
 	callData: ZodHex(),
-	value: z.bigint().optional()
+	value: ZodBigInt().optional()
 });
 //#endregion
 export { amountSchema, assetTypeSchema, bpsSchema, chainIdSchema, leverageSchema, timestampSchema, tokenAmountSchema, tokenSchema, txCallSchema };

package/dist/esm/preview/index.js

@@ -18,7 +18,7 @@ import { BalancePrerequisite } from "./prerequisites/BalancePrerequisite.js";
 import { RWAOpenRequirementsPrerequisite } from "./prerequisites/RWAOpenRequirementsPrerequisite.js";
 import { checkPrerequisites } from "./prerequisites/checkPrerequisites.js";
 import "./prerequisites/index.js";
-import { ERROR_ADAPTER_CALL_OUTSIDE_BRACKET, ERROR_INVALID_TRANSACTION_VALUE, ERROR_MALFORMED_BRACKET, ERROR_NON_ADAPTER_CALL_IN_BRACKET, ERROR_UNPREVIEWABLE_ADAPTER_CALL, ERROR_UNPREVIEWABLE_RWA_WRAP_UNWRAP, ERROR_UNPRICEABLE_TOKEN, PREVIEW_DUST } from "./preview/types.js";
+import { ERROR_ADAPTER_CALL_OUTSIDE_BRACKET, ERROR_INVALID_TRANSACTION_VALUE, ERROR_MALFORMED_BRACKET, ERROR_NON_ADAPTER_CALL_IN_BRACKET, ERROR_UNPREVIEWABLE_ADAPTER_CALL, ERROR_UNPREVIEWABLE_RWA_WRAP_UNWRAP, ERROR_UNPRICEABLE_TOKEN } from "./preview/types.js";
 import { buildDelayedPreview } from "./preview/buildDelayedPreview.js";
 import { CreditAccountState } from "./preview/CreditAccountState.js";
 import { classifyCloseOrRepay, isCloseOrRepay } from "./preview/detectCloseOrRepay.js";
@@ -32,4 +32,4 @@ import { previewCloseOrRepayCreditAccount } from "./preview/previewCloseOrRepayC
 import { previewOperation } from "./preview/previewOperation.js";
 import "./preview/index.js";
 import "./types.js";
-export { AllowancePrerequisite, BalancePrerequisite, CreditAccountState, ERROR_ADAPTER_CALL_OUTSIDE_BRACKET, ERROR_INVALID_TRANSACTION_VALUE, ERROR_MALFORMED_BRACKET, ERROR_NON_ADAPTER_CALL_IN_BRACKET, ERROR_UNPREVIEWABLE_ADAPTER_CALL, ERROR_UNPREVIEWABLE_RWA_WRAP_UNWRAP, ERROR_UNPRICEABLE_TOKEN, PREVIEW_DUST, Prerequisite, RWAOpenRequirementsPrerequisite, TransferAlignmentError, UnexpectedFacadeEventOrderError, UnknownAdapterError, UnknownFacadeCallError, UnsupportedOperationError, UnsupportedPoolFunctionError, UnsupportedTargetError, UnsupportedZapperFunctionError, WithdrawCollateralAlignmentError, buildDelayedPreview, checkPrerequisites, classifyCloseOrRepay, classifyInnerOperations, detectDelayedClaim, detectDelayedOperation, extractAdapterCallTraces, extractTransfers, findFacadeCalls, isCloseOrRepay, isPoolOperation, isRWAOperation, makeReplayState, parseFacadeOperationCalldata, parseOperationCalldata, parsePoolOperationCalldata, parseRWAFactoryOperationCalldata, previewAdjustCreditAccount, previewCloseOrRepayCreditAccount, previewOperation, replayInnerOperations, replayMulticall, resolveDelayedClaimIntent };
+export { AllowancePrerequisite, BalancePrerequisite, CreditAccountState, ERROR_ADAPTER_CALL_OUTSIDE_BRACKET, ERROR_INVALID_TRANSACTION_VALUE, ERROR_MALFORMED_BRACKET, ERROR_NON_ADAPTER_CALL_IN_BRACKET, ERROR_UNPREVIEWABLE_ADAPTER_CALL, ERROR_UNPREVIEWABLE_RWA_WRAP_UNWRAP, ERROR_UNPRICEABLE_TOKEN, Prerequisite, RWAOpenRequirementsPrerequisite, TransferAlignmentError, UnexpectedFacadeEventOrderError, UnknownAdapterError, UnknownFacadeCallError, UnsupportedOperationError, UnsupportedPoolFunctionError, UnsupportedTargetError, UnsupportedZapperFunctionError, WithdrawCollateralAlignmentError, buildDelayedPreview, checkPrerequisites, classifyCloseOrRepay, classifyInnerOperations, detectDelayedClaim, detectDelayedOperation, extractAdapterCallTraces, extractTransfers, findFacadeCalls, isCloseOrRepay, isPoolOperation, isRWAOperation, makeReplayState, parseFacadeOperationCalldata, parseOperationCalldata, parsePoolOperationCalldata, parseRWAFactoryOperationCalldata, previewAdjustCreditAccount, previewCloseOrRepayCreditAccount, previewOperation, replayInnerOperations, replayMulticall, resolveDelayedClaimIntent };

package/dist/esm/preview/preview/buildDelayedPreview.js

@@ -1,8 +1,9 @@
 import { AssetsMap } from "../../sdk/utils/AssetsMap.js";
 import { BigIntMath } from "../../sdk/utils/bigint-math.js";
+import { DUST_THRESHOLD } from "../../sdk/constants/math.js";
 import "../../sdk/index.js";
 import "../../common-utils/index.js";
-import { ERROR_UNPRICEABLE_TOKEN, PREVIEW_DUST } from "./types.js";
+import { ERROR_UNPRICEABLE_TOKEN } from "./types.js";
 import { isAddressEqual } from "viem";
 //#region src/preview/preview/buildDelayedPreview.ts
 /**
@@ -171,7 +172,7 @@ function buildClosePreview(post, converter, receivedToken) {
 	};
 }
 function buildAdjustPreview(post, before, collateralWithdrawn, converter) {
-	const totalValue = totalValueInUnderlying(post, converter.convert, PREVIEW_DUST);
+	const totalValue = totalValueInUnderlying(post, converter.convert, DUST_THRESHOLD);
 	return {
 		operation: "AdjustCreditAccount",
 		creditManager: post.creditManager,
@@ -183,8 +184,8 @@ function buildAdjustPreview(post, before, collateralWithdrawn, converter) {
 		debtChange: post.debt - before.debt,
 		quotas: post.quotas.toAssets(0n),
 		quotasChange: post.quotas.difference(before.quotas).toAssets(),
-		assets: post.balances.toAssets(PREVIEW_DUST),
-		assetsChange: post.balances.difference(before.balances).toAssets(PREVIEW_DUST),
+		assets: post.balances.toAssets(DUST_THRESHOLD),
+		assetsChange: post.balances.difference(before.balances).toAssets(DUST_THRESHOLD),
 		error: converter.error
 	};
 }

package/dist/esm/preview/preview/index.js

@@ -1,4 +1,4 @@
-import { ERROR_ADAPTER_CALL_OUTSIDE_BRACKET, ERROR_INVALID_TRANSACTION_VALUE, ERROR_MALFORMED_BRACKET, ERROR_NON_ADAPTER_CALL_IN_BRACKET, ERROR_UNPREVIEWABLE_ADAPTER_CALL, ERROR_UNPREVIEWABLE_RWA_WRAP_UNWRAP, ERROR_UNPRICEABLE_TOKEN, PREVIEW_DUST } from "./types.js";
+import { ERROR_ADAPTER_CALL_OUTSIDE_BRACKET, ERROR_INVALID_TRANSACTION_VALUE, ERROR_MALFORMED_BRACKET, ERROR_NON_ADAPTER_CALL_IN_BRACKET, ERROR_UNPREVIEWABLE_ADAPTER_CALL, ERROR_UNPREVIEWABLE_RWA_WRAP_UNWRAP, ERROR_UNPRICEABLE_TOKEN } from "./types.js";
 import { buildDelayedPreview } from "./buildDelayedPreview.js";
 import { CreditAccountState } from "./CreditAccountState.js";
 import { classifyCloseOrRepay, isCloseOrRepay } from "./detectCloseOrRepay.js";
@@ -10,4 +10,4 @@ import { replayMulticall } from "./replayMulticall.js";
 import { previewAdjustCreditAccount } from "./previewAdjustCreditAccount.js";
 import { previewCloseOrRepayCreditAccount } from "./previewCloseOrRepayCreditAccount.js";
 import { previewOperation } from "./previewOperation.js";
-export { CreditAccountState, ERROR_ADAPTER_CALL_OUTSIDE_BRACKET, ERROR_INVALID_TRANSACTION_VALUE, ERROR_MALFORMED_BRACKET, ERROR_NON_ADAPTER_CALL_IN_BRACKET, ERROR_UNPREVIEWABLE_ADAPTER_CALL, ERROR_UNPREVIEWABLE_RWA_WRAP_UNWRAP, ERROR_UNPRICEABLE_TOKEN, PREVIEW_DUST, UnsupportedOperationError, buildDelayedPreview, classifyCloseOrRepay, detectDelayedClaim, detectDelayedOperation, isCloseOrRepay, makeReplayState, previewAdjustCreditAccount, previewCloseOrRepayCreditAccount, previewOperation, replayInnerOperations, replayMulticall, resolveDelayedClaimIntent };
+export { CreditAccountState, ERROR_ADAPTER_CALL_OUTSIDE_BRACKET, ERROR_INVALID_TRANSACTION_VALUE, ERROR_MALFORMED_BRACKET, ERROR_NON_ADAPTER_CALL_IN_BRACKET, ERROR_UNPREVIEWABLE_ADAPTER_CALL, ERROR_UNPREVIEWABLE_RWA_WRAP_UNWRAP, ERROR_UNPRICEABLE_TOKEN, UnsupportedOperationError, buildDelayedPreview, classifyCloseOrRepay, detectDelayedClaim, detectDelayedOperation, isCloseOrRepay, makeReplayState, previewAdjustCreditAccount, previewCloseOrRepayCreditAccount, previewOperation, replayInnerOperations, replayMulticall, resolveDelayedClaimIntent };

package/dist/esm/preview/preview/previewAdjustCreditAccount.js

@@ -1,6 +1,7 @@
 import { AP_WETH_TOKEN } from "../../sdk/constants/address-provider.js";
+import { DUST_THRESHOLD } from "../../sdk/constants/math.js";
 import "../../sdk/index.js";
-import { ERROR_UNPRICEABLE_TOKEN, PREVIEW_DUST } from "./types.js";
+import { ERROR_UNPRICEABLE_TOKEN } from "./types.js";
 import { replayMulticall } from "./replayMulticall.js";
 import { unwrapNativeCollateral } from "./unwrapNativeCollateral.js";
 //#region src/preview/preview/previewAdjustCreditAccount.ts
@@ -19,8 +20,8 @@ async function previewAdjustCreditAccount(input, operation, options) {
 	let error = replayError;
 	const { assets: collateralAdded, error: unwrapError } = unwrapNativeCollateral(after.collateralAdded.toAssets(), value, sdk.addressProvider.getAddress(AP_WETH_TOKEN, 0));
 	error ??= unwrapError;
-	const assets = account.balances.toAssets(PREVIEW_DUST);
-	const assetsChange = account.balances.difference(before.balances).toAssets(PREVIEW_DUST);
+	const assets = account.balances.toAssets(DUST_THRESHOLD);
+	const assetsChange = account.balances.difference(before.balances).toAssets(DUST_THRESHOLD);
 	const totalValue = assets.reduce((acc, { token, balance }) => {
 		try {
 			return acc + market.priceOracle.convert(token, market.underlying, balance);

package/dist/esm/preview/preview/types.js

@@ -31,20 +31,5 @@ const ERROR_UNPREVIEWABLE_RWA_WRAP_UNWRAP = 1005;
 const ERROR_INVALID_TRANSACTION_VALUE = 1006;
 /** A token in the preview could not be priced by the oracle */
 const ERROR_UNPRICEABLE_TOKEN = 2001;
-/**
-* Dust threshold for replayed preview balances and balance changes.
-*
-* Multicalls assembled by `CreditAccountsServiceV310` subtract a 10-unit
-* safety buffer from every expected output token in their
-* `storeExpectedBalances` deltas (`amount - 10n` in
-* `assembleStartDelayedWithdrawalCalls`/`assembleClaimDelayedCalls`), while
-* subsequent calls in the same multicall spend exact on-chain amounts. A
-* replay that credits only the min-guarantee can therefore be off by up to
-* 10 units per token, including small negative residues that are impossible
-* on-chain. Amounts within this threshold (in absolute value) are filtered
-* from preview outputs; anything beyond it is a genuine discrepancy and is
-* reported.
-*/
-const PREVIEW_DUST = 10n;
 //#endregion
-export { ERROR_ADAPTER_CALL_OUTSIDE_BRACKET, ERROR_INVALID_TRANSACTION_VALUE, ERROR_MALFORMED_BRACKET, ERROR_NON_ADAPTER_CALL_IN_BRACKET, ERROR_UNPREVIEWABLE_ADAPTER_CALL, ERROR_UNPREVIEWABLE_RWA_WRAP_UNWRAP, ERROR_UNPRICEABLE_TOKEN, PREVIEW_DUST };
+export { ERROR_ADAPTER_CALL_OUTSIDE_BRACKET, ERROR_INVALID_TRANSACTION_VALUE, ERROR_MALFORMED_BRACKET, ERROR_NON_ADAPTER_CALL_IN_BRACKET, ERROR_UNPREVIEWABLE_ADAPTER_CALL, ERROR_UNPREVIEWABLE_RWA_WRAP_UNWRAP, ERROR_UNPRICEABLE_TOKEN };

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

@@ -10,6 +10,8 @@ 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";
 import "./credit-account-compressor/index.js";
 import { extractPriceUpdates, extractQuotaTokens, mergePriceUpdates } from "./multicall-utils.js";
@@ -173,49 +175,21 @@ var CreditAccountsServiceV310 = class extends SDKConstruct {
 	* {@inheritDoc ICreditAccountsService.assembleStartDelayedWithdrawalCalls}
 	**/
 	assembleStartDelayedWithdrawalCalls({ creditFacade, preview }) {
-		const record = preview.outputs.reduce((acc, o) => {
-			const token = o.token.toLowerCase();
-			acc[token] = (acc[token] || 0n) + o.amount;
-			return acc;
-		}, {});
-		const deltas = Object.entries(record).filter(([, a]) => a > 10n).map(([token, amount]) => ({
-			token,
-			amount: amount > 10n ? amount - 10n : 0n
-		}));
-		if (preview.amountIn > 0n) deltas.push({
-			token: preview.token,
-			amount: -preview.amountIn
-		});
-		const facade = this.sdk.marketRegister.findCreditFacade(creditFacade);
-		return [
-			facade.prepareStoreExpectedBalances(deltas),
-			...preview.requestCalls,
-			facade.prepareCompareBalances()
-		];
+		return this.sdk.marketRegister.findCreditFacade(creditFacade).prepareWithBalanceCheck(expectedBalanceDeltas({
+			outputs: preview.outputs,
+			spentToken: preview.token,
+			spentAmount: preview.amountIn
+		}), preview.requestCalls);
 	}
 	/**
 	* {@inheritDoc ICreditAccountsService.assembleClaimDelayedCalls}
 	**/
 	assembleClaimDelayedCalls({ creditFacade, claimableNow }) {
-		const record = claimableNow.outputs.reduce((acc, o) => {
-			const token = o.token.toLowerCase();
-			acc[token] = (acc[token] || 0n) + o.amount;
-			return acc;
-		}, {});
-		const deltas = Object.entries(record).filter(([, a]) => a > 10n).map(([token, amount]) => ({
-			token,
-			amount: amount > 10n ? amount - 10n : 0n
-		}));
-		if (claimableNow.withdrawalTokenSpent > 0n) deltas.push({
-			token: claimableNow.withdrawalPhantomToken,
-			amount: -claimableNow.withdrawalTokenSpent
-		});
-		const facade = this.sdk.marketRegister.findCreditFacade(creditFacade);
-		return [
-			facade.prepareStoreExpectedBalances(deltas),
-			...claimableNow.claimCalls,
-			facade.prepareCompareBalances()
-		];
+		return this.sdk.marketRegister.findCreditFacade(creditFacade).prepareWithBalanceCheck(expectedBalanceDeltas({
+			outputs: claimableNow.outputs,
+			spentToken: claimableNow.withdrawalPhantomToken,
+			spentAmount: claimableNow.withdrawalTokenSpent
+		}), claimableNow.claimCalls);
 	}
 	/**
 	* {@inheritDoc ICreditAccountsService.getApprovalAddress}

package/dist/esm/sdk/accounts/credit-account-compressor/CreditAccountCompressor.js

@@ -9,12 +9,12 @@ import { hexEq } from "../../utils/hex.js";
 import "../../utils/index.js";
 import { SDKConstruct } from "../../base/SDKConstruct.js";
 import "../../base/index.js";
-import { iRWAFactoryAbi } from "../../../abi/rwa/iRWAFactory.js";
 import { borrowApyBps, healthFactorBps, positionLeverage, usdToNumber } from "../../market/math.js";
 import { dominantCollateral } from "../../market/credit/dominantCollateral.js";
 import { simulateWithPriceUpdates } from "../../utils/viem/simulateWithPriceUpdates.js";
 import "../../utils/viem/index.js";
 import "../../market/index.js";
+import { iRWAFactoryAbi } from "../../../abi/rwa/iRWAFactory.js";
 import { CreditAccountCompressorV310Contract } from "./CreditAccountCompressorV310Contract.js";
 //#region src/sdk/accounts/credit-account-compressor/CreditAccountCompressor.ts
 /**