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

package/dist/cjs/model/filters.js

@@ -0,0 +1,20 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#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
+exports.FILTER_ALL = FILTER_ALL;
+exports.isFilterSet = isFilterSet;

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

@@ -0,0 +1,21 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("./filters.js");
+let zod_v4 = require("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 = zod_v4.z.literal("all");
+/**
+* {@link Filterable}
+**/
+function filterable(schema) {
+	return zod_v4.z.union([schema, filterAllSchema]);
+}
+//#endregion
+exports.filterAllSchema = filterAllSchema;
+exports.filterable = filterable;

package/dist/cjs/model/index.js

@@ -1,6 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("./curators.js");
 const require_model_curators_schema = require("./curators.schema.js");
+const require_model_filters = require("./filters.js");
+const require_model_filters_schema = require("./filters.schema.js");
 const require_model_history = require("./history.js");
 const require_model_primitives_schema = require("./primitives.schema.js");
 const require_model_opportunities_schema = require("./opportunities.schema.js");
@@ -11,6 +13,7 @@ const require_model_liquidations = require("./liquidations.js");
 const require_model_opportunities = require("./opportunities.js");
 const require_model_positions = require("./positions.js");
 require("./primitives.js");
+exports.FILTER_ALL = require_model_filters.FILTER_ALL;
 exports.POOL_HISTORY_METRICS = require_model_history.POOL_HISTORY_METRICS;
 exports.POOL_POSITION_HISTORY_METRICS = require_model_history.POOL_POSITION_HISTORY_METRICS;
 exports.STRATEGY_HISTORY_METRICS = require_model_history.STRATEGY_HISTORY_METRICS;
@@ -23,12 +26,15 @@ exports.chainIdSchema = require_model_primitives_schema.chainIdSchema;
 exports.curatorNameSchema = require_model_curators_schema.curatorNameSchema;
 exports.curatorSchema = require_model_curators_schema.curatorSchema;
 exports.delayedReceivedAssetSchema = require_model_liquidations_schema.delayedReceivedAssetSchema;
+exports.filterAllSchema = require_model_filters_schema.filterAllSchema;
+exports.filterable = require_model_filters_schema.filterable;
 exports.historyChartMetadataSchema = require_model_history_schema.historyChartMetadataSchema;
 exports.historyMetricSchema = require_model_history_schema.historyMetricSchema;
 exports.historyPointSchema = require_model_history_schema.historyPointSchema;
 exports.historyRangeSchema = require_model_history_schema.historyRangeSchema;
 exports.historySeriesSchema = require_model_history_schema.historySeriesSchema;
 exports.instantReceivedAssetSchema = require_model_liquidations_schema.instantReceivedAssetSchema;
+exports.isFilterSet = require_model_filters.isFilterSet;
 exports.leverageSchema = require_model_primitives_schema.leverageSchema;
 exports.liquidatableAccountFilterSchema = require_model_liquidations_schema.liquidatableAccountFilterSchema;
 exports.liquidatableAccountSchema = require_model_liquidations_schema.liquidatableAccountSchema;

package/dist/cjs/model/liquidations.js

@@ -1,22 +1,24 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_model_filters = require("./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 (require_model_filters.isFilterSet(filter.chainIds) && !filter.chainIds.includes(account.chainId)) return false;
+	if (require_model_filters.isFilterSet(filter.underlyingType) && account.totalValue.token.assetType !== filter.underlyingType) return false;
+	if (require_model_filters.isFilterSet(filter.paused) && account.paused !== filter.paused) return false;
+	if (require_model_filters.isFilterSet(filter.rwa) && account.rwa !== filter.rwa) return false;
+	if (require_model_filters.isFilterSet(filter.delayed) && account.isDelayed !== filter.delayed) return false;
 	return true;
 }
 //#endregion

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

@@ -1,5 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_sdk_utils_zod = require("../sdk/utils/zod.js");
+const require_model_filters_schema = require("./filters.schema.js");
 const require_model_primitives_schema = require("./primitives.schema.js");
 let zod_v4 = require("zod/v4");
 //#region src/model/liquidations.schema.ts
@@ -11,11 +12,11 @@ let zod_v4 = require("zod/v4");
 * {@link LiquidatableAccountFilter}
 **/
 const liquidatableAccountFilterSchema = zod_v4.z.object({
-	chainIds: zod_v4.z.array(require_model_primitives_schema.chainIdSchema).optional(),
-	underlyingType: require_model_primitives_schema.assetTypeSchema.optional(),
-	paused: zod_v4.z.boolean().optional(),
-	rwa: zod_v4.z.boolean().optional(),
-	delayed: zod_v4.z.boolean().optional()
+	chainIds: require_model_filters_schema.filterable(zod_v4.z.array(require_model_primitives_schema.chainIdSchema)).optional(),
+	underlyingType: require_model_filters_schema.filterable(require_model_primitives_schema.assetTypeSchema).optional(),
+	paused: require_model_filters_schema.filterable(zod_v4.z.boolean()).optional(),
+	rwa: require_model_filters_schema.filterable(zod_v4.z.boolean()).optional(),
+	delayed: require_model_filters_schema.filterable(zod_v4.z.boolean()).optional()
 });
 /**
 * {@link LiquidatableAccount}

package/dist/cjs/model/opportunities.js

@@ -1,4 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_model_filters = require("./filters.js");
 //#region src/model/opportunities.ts
 /**
 * Builds the canonical id of a pool opportunity.
@@ -29,23 +30,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 (require_model_filters.isFilterSet(filter.kind) && opportunity.kind !== filter.kind) return false;
+	if (require_model_filters.isFilterSet(filter.chainIds) && !filter.chainIds.includes(opportunity.chainId)) return false;
+	if (require_model_filters.isFilterSet(filter.underlyingType) && opportunity.underlyingToken.assetType !== filter.underlyingType) return false;
+	if (require_model_filters.isFilterSet(filter.paused) && opportunity.paused !== filter.paused) return false;
+	if (require_model_filters.isFilterSet(filter.sunset) && opportunity.sunset !== filter.sunset) return false;
+	if (require_model_filters.isFilterSet(filter.rwa) && opportunity.rwa !== filter.rwa) return false;
 	return true;
 }
 //#endregion

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

@@ -1,6 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_sdk_utils_zod = require("../sdk/utils/zod.js");
 const require_model_curators_schema = require("./curators.schema.js");
+const require_model_filters_schema = require("./filters.schema.js");
 const require_model_primitives_schema = require("./primitives.schema.js");
 let zod_v4 = require("zod/v4");
 //#region src/model/opportunities.schema.ts
@@ -103,12 +104,12 @@ const opportunitySchema = zod_v4.z.discriminatedUnion("kind", [poolOpportunitySc
 * {@link OpportunityFilter}
 **/
 const opportunityFilterSchema = zod_v4.z.object({
-	kind: opportunityKindSchema.optional(),
-	chainIds: zod_v4.z.array(require_model_primitives_schema.chainIdSchema).optional(),
-	underlyingType: require_model_primitives_schema.assetTypeSchema.optional(),
-	paused: zod_v4.z.boolean().optional(),
-	sunset: zod_v4.z.boolean().optional(),
-	rwa: zod_v4.z.boolean().optional()
+	kind: require_model_filters_schema.filterable(opportunityKindSchema).optional(),
+	chainIds: require_model_filters_schema.filterable(zod_v4.z.array(require_model_primitives_schema.chainIdSchema)).optional(),
+	underlyingType: require_model_filters_schema.filterable(require_model_primitives_schema.assetTypeSchema).optional(),
+	paused: require_model_filters_schema.filterable(zod_v4.z.boolean()).optional(),
+	sunset: require_model_filters_schema.filterable(zod_v4.z.boolean()).optional(),
+	rwa: require_model_filters_schema.filterable(zod_v4.z.boolean()).optional()
 });
 /**
 * {@link RateCurvePoint}

package/dist/cjs/model/positions.js

@@ -1,4 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_model_filters = require("./filters.js");
 //#region src/model/positions.ts
 /**
 * Builds the canonical id of a pool position.
@@ -46,26 +47,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 (require_model_filters.isFilterSet(filter.kind) && position.kind !== filter.kind) return false;
+	if (require_model_filters.isFilterSet(filter.chainIds) && !filter.chainIds.includes(position.chainId)) return false;
+	if (require_model_filters.isFilterSet(filter.isZeroDebt) && position.kind === "strategy" && position.totalDebt.value === 0n !== filter.isZeroDebt) return false;
+	if (require_model_filters.isFilterSet(filter.underlyingType)) {
 		const underlying = positionUnderlying(position);
 		if (underlying && underlying.assetType !== filter.underlyingType) return false;
 	}

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

@@ -1,5 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_sdk_utils_zod = require("../sdk/utils/zod.js");
+const require_model_filters_schema = require("./filters.schema.js");
 const require_model_primitives_schema = require("./primitives.schema.js");
 const require_model_opportunities_schema = require("./opportunities.schema.js");
 const require_model_liquidations_schema = require("./liquidations.schema.js");
@@ -101,10 +102,10 @@ const positionSchema = zod_v4.z.discriminatedUnion("kind", [
 * {@link PositionFilter}
 **/
 const positionFilterSchema = zod_v4.z.object({
-	kind: positionKindSchema.optional(),
-	isZeroDebt: zod_v4.z.boolean().optional(),
-	chainIds: zod_v4.z.array(require_model_primitives_schema.chainIdSchema).optional(),
-	underlyingType: require_model_primitives_schema.assetTypeSchema.optional()
+	kind: require_model_filters_schema.filterable(positionKindSchema).optional(),
+	isZeroDebt: require_model_filters_schema.filterable(zod_v4.z.boolean()).optional(),
+	chainIds: require_model_filters_schema.filterable(zod_v4.z.array(require_model_primitives_schema.chainIdSchema)).optional(),
+	underlyingType: require_model_filters_schema.filterable(require_model_primitives_schema.assetTypeSchema).optional()
 });
 /**
 * {@link PoolPositionKey}

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

@@ -8,6 +8,7 @@ const require_sdk_market_math = require("./math.js");
 const require_sdk_market_credit_CreditSuite = require("./credit/CreditSuite.js");
 require("./credit/index.js");
 const require_sdk_market_MarketConfiguratorContract = require("./MarketConfiguratorContract.js");
+const require_model_filters = require("../../model/filters.js");
 const require_model_opportunities = require("../../model/opportunities.js");
 require("../../model/index.js");
 const require_sdk_market_loss_policy_createLossPolicy = require("./loss-policy/createLossPolicy.js");
@@ -200,12 +201,13 @@ var MarketSuite = class extends require_sdk_base_SDKConstruct.SDKConstruct {
 	* @param filter - Optional narrowing. A filter naming a kind skips building
 	* the other kind entirely; every built row is then checked in full by
 	* {@link matchesOpportunityFilter}, so there is one definition of what each
-	* criterion means.
+	* condition means.
 	*/
 	opportunities(filter) {
 		const rows = [];
-		if (filter?.kind !== "strategy") rows.push(this.poolOpportunity());
-		if (filter?.kind !== "pool") for (const { suite, collateral } of this.strategies) rows.push(suite.strategyOpportunity(collateral));
+		const kind = filter?.kind;
+		if (!require_model_filters.isFilterSet(kind) || kind === "pool") rows.push(this.poolOpportunity());
+		if (!require_model_filters.isFilterSet(kind) || kind === "strategy") for (const { suite, collateral } of this.strategies) rows.push(suite.strategyOpportunity(collateral));
 		return rows.filter((row) => require_model_opportunities.matchesOpportunityFilter(row, filter));
 	}
 	/**

package/dist/cjs/sdk/opportunities/MultichainOpportunitiesService.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/opportunities/MultichainOpportunitiesService.ts
 /**
 * Cross-chain counterpart of {@link OpportunitiesService}.
@@ -46,9 +48,10 @@ var MultichainOpportunitiesService = class extends require_sdk_base_MultichainCo
 	* 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 opportunities filter`);

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

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

package/dist/esm/dev/withdrawalUtils.js

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

package/dist/esm/model/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}