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

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/plugins/adapters/contracts/ERC4626AdapterContract.js

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

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

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

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

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

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

@@ -1,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,11 +1,11 @@
-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 { iStateSerializerAbi } from "../../abi/iStateSerializer.js";
+import { iVersionAbi } from "../../abi/iVersion.js";
 //#region src/sdk/base/TokensMeta.ts
 /**
 * Registry of token metadata (symbol, decimals, phantom type) keyed by address.

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

@@ -7,6 +7,7 @@ import { rayToBps } from "./math.js";
 import { CreditSuite } from "./credit/CreditSuite.js";
 import "./credit/index.js";
 import { MarketConfiguratorContract } from "./MarketConfiguratorContract.js";
+import { isFilterSet } from "../../model/filters.js";
 import { matchesOpportunityFilter } from "../../model/opportunities.js";
 import "../../model/index.js";
 import { createLossPolicy } from "./loss-policy/createLossPolicy.js";
@@ -199,12 +200,13 @@ var MarketSuite = class extends 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 (!isFilterSet(kind) || kind === "pool") rows.push(this.poolOpportunity());
+		if (!isFilterSet(kind) || kind === "strategy") for (const { suite, collateral } of this.strategies) rows.push(suite.strategyOpportunity(collateral));
 		return rows.filter((row) => matchesOpportunityFilter(row, filter));
 	}
 	/**

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

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

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

@@ -1,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 { utilizationBps } 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/opportunities/MultichainOpportunitiesService.js

@@ -1,6 +1,8 @@
 import { getNetworkType } from "../chain/chains.js";
 import { MultichainConstruct } from "../base/MultichainConstruct.js";
 import "../base/index.js";
+import { isFilterSet } from "../../model/filters.js";
+import "../../model/index.js";
 //#region src/sdk/opportunities/MultichainOpportunitiesService.ts
 /**
 * Cross-chain counterpart of {@link OpportunitiesService}.
@@ -45,9 +47,10 @@ var MultichainOpportunitiesService = class extends MultichainConstruct {
 	* a filter naming them is a narrowing, not a request.
 	**/
 	#networksOf(filter) {
-		if (!filter?.chainIds) return;
+		const chainIds = filter?.chainIds;
+		if (!isFilterSet(chainIds)) return;
 		const networks = [];
-		for (const chainId of filter.chainIds) try {
+		for (const chainId of chainIds) try {
 			networks.push(getNetworkType(chainId));
 		} catch {
 			this.sdk.logger?.debug(`ignoring unsupported chain ${chainId} in opportunities filter`);

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

@@ -1,5 +1,7 @@
 import { SDKConstruct } from "../base/SDKConstruct.js";
 import "../base/index.js";
+import { isFilterSet } from "../../model/filters.js";
+import "../../model/index.js";
 //#region src/sdk/opportunities/OpportunitiesService.ts
 /**
 * Builds the `opportunities` read model from the chain.
@@ -21,7 +23,8 @@ var OpportunitiesService = class extends SDKConstruct {
 	* @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 (isFilterSet(chainIds) && !chainIds.includes(this.chainId)) return [];
 		return this.sdk.marketRegister.markets.flatMap((market) => market.opportunities(filter));
 	}
 	/**

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 { RAY } from "../constants/math.js";
 import "../constants/index.js";

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

@@ -1,6 +1,8 @@
 import { getNetworkType } from "../chain/chains.js";
 import { MultichainConstruct } from "../base/MultichainConstruct.js";
 import "../base/index.js";
+import { isFilterSet } from "../../model/filters.js";
+import "../../model/index.js";
 //#region src/sdk/positions/MultichainPositionsService.ts
 /**
 * Cross-chain counterpart of {@link PositionsService}.
@@ -33,9 +35,10 @@ var MultichainPositionsService = class extends MultichainConstruct {
 	* a filter naming them is a narrowing, not a request.
 	**/
 	#networksOf(filter) {
-		if (!filter?.chainIds) return;
+		const chainIds = filter?.chainIds;
+		if (!isFilterSet(chainIds)) return;
 		const networks = [];
-		for (const chainId of filter.chainIds) try {
+		for (const chainId of chainIds) try {
 			networks.push(getNetworkType(chainId));
 		} catch {
 			this.sdk.logger?.debug(`ignoring unsupported chain ${chainId} in positions filter`);

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

@@ -1,5 +1,6 @@
 import { SDKConstruct } from "../base/SDKConstruct.js";
 import "../base/index.js";
+import { isFilterSet } from "../../model/filters.js";
 import { matchesPositionFilter } from "../../model/positions.js";
 import "../../model/index.js";
 //#region src/sdk/positions/PositionsService.ts
@@ -12,18 +13,21 @@ var PositionsService = class extends 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 (isFilterSet(chainIds) && !chainIds.includes(this.chainId)) return [];
+		const wantedKind = filter?.kind;
+		const wanted = (kind) => !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: !isFilterSet(isZeroDebt) || isZeroDebt
 			}) : Promise.resolve([]),
 			wanted("liquidation") ? this.sdk.liquidations.getLiquidationPositions({ liquidator: wallet }) : Promise.resolve([])
 		]);

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/model/filters.d.ts

@@ -0,0 +1,30 @@
+//#region src/model/filters.d.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.
+ **/
+declare const FILTER_ALL = "all";
+/**
+ * Type of {@link FILTER_ALL}.
+ **/
+type FilterAll = typeof FILTER_ALL;
+/**
+ * A filter condition: a value, the {@link FILTER_ALL} sentinel, or omitted.
+ *
+ * @example
+ * ```ts
+ * const kind: Filterable<OpportunityKind> = "pool"; // only pools
+ * const anyKind: Filterable<OpportunityKind> = "all"; // pools and strategies
+ * ```
+ **/
+type Filterable<T> = T | FilterAll;
+/**
+ * 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.
+ **/
+declare function isFilterSet<T>(condition: Filterable<T> | undefined): condition is T;
+//#endregion
+export { FILTER_ALL, FilterAll, Filterable, isFilterSet };

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

@@ -0,0 +1,16 @@
+import { z } from "zod/v4";
+//#region src/model/filters.schema.d.ts
+/**
+ * Runtime schemas for {@link ./filters.js}, see the note in
+ * `primitives.schema.ts` on why they are written by hand.
+ **/
+/**
+ * {@link FilterAll}
+ **/
+declare const filterAllSchema: z.ZodLiteral<"all">;
+/**
+ * {@link Filterable}
+ **/
+declare function filterable<T extends z.ZodType>(schema: T): z.ZodUnion<[T, typeof filterAllSchema]>;
+//#endregion
+export { filterAllSchema, filterable };

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

@@ -1,6 +1,8 @@
 import { Curator, CuratorName } from "./curators.js";
 import { Amount, AssetType, Bps, ChainId, Leverage, Timestamp, Token, TokenAmount, TxCall } from "./primitives.js";
 import { curatorNameSchema, curatorSchema } from "./curators.schema.js";
+import { FILTER_ALL, FilterAll, Filterable, isFilterSet } from "./filters.js";
+import { filterAllSchema, filterable } from "./filters.schema.js";
 import { ApyBreakdown, Opportunity, OpportunityBase, OpportunityDetail, OpportunityFilter, OpportunityId, OpportunityKey, OpportunityKind, PointRewards, PointsProgram, PoolOpportunity, PoolOpportunityDetail, PoolOpportunityKey, PoolOpportunityRef, PriceFeedData, PriceFeedSummary, QuotaAsset, RateCurve, RateCurvePoint, Rewards, StrategyOpportunity, StrategyOpportunityDetail, StrategyOpportunityKey, StrategyOpportunityRef, TokenRewards, matchesOpportunityFilter, opportunityId, poolOpportunityId, strategyOpportunityId } from "./opportunities.js";
 import { DelayedReceivedAsset, InstantReceivedAsset, LiquidatableAccount, LiquidatableAccountFilter, LiquidationApproval, LiquidationDetails, LiquidationPosition, ReceivedAsset, matchesLiquidatableAccountFilter } from "./liquidations.js";
 import { PnlBreakdown, PointsProgramPnL, PointsRewardsPnL, PoolPosition, PoolPositionKey, PoolPositionRef, Position, PositionCollateral, PositionFilter, PositionId, PositionKey, PositionKind, RewardsPnL, StrategyPosition, StrategyPositionKey, StrategyPositionRef, TokenRewardsPnL, liquidationPositionId, matchesPositionFilter, poolPositionId, positionId, strategyPositionId } from "./positions.js";
@@ -10,4 +12,4 @@ import { delayedReceivedAssetSchema, instantReceivedAssetSchema, liquidatableAcc
 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";
 import { pnlBreakdownSchema, pointsProgramPnLSchema, pointsRewardsPnLSchema, poolPositionKeySchema, poolPositionSchema, positionCollateralSchema, positionFilterSchema, positionKeySchema, positionKindSchema, positionSchema, rewardsPnLSchema, strategyPositionKeySchema, strategyPositionSchema, tokenRewardsPnLSchema } from "./positions.schema.js";
 import { amountSchema, assetTypeSchema, bpsSchema, chainIdSchema, leverageSchema, timestampSchema, tokenAmountSchema, tokenSchema, txCallSchema } from "./primitives.schema.js";
-export { Amount, ApyBreakdown, AssetType, Bps, ChainId, Curator, CuratorName, DelayedReceivedAsset, HistoryChartMetadata, HistoryMetric, HistoryPoint, HistoryRange, HistorySeries, InstantReceivedAsset, Leverage, LiquidatableAccount, LiquidatableAccountFilter, LiquidationApproval, LiquidationDetails, LiquidationPosition, Opportunity, OpportunityBase, OpportunityDetail, OpportunityFilter, OpportunityHistoryQuery, OpportunityId, OpportunityKey, OpportunityKind, POOL_HISTORY_METRICS, POOL_POSITION_HISTORY_METRICS, PnlBreakdown, PointRewards, PointsProgram, PointsProgramPnL, PointsRewardsPnL, PoolHistoryMetric, PoolOpportunity, PoolOpportunityDetail, PoolOpportunityKey, PoolOpportunityRef, PoolPosition, PoolPositionHistoryMetric, PoolPositionKey, PoolPositionRef, Position, PositionCollateral, PositionFilter, PositionHistoryMetric, PositionHistoryQuery, PositionId, PositionKey, PositionKind, PriceFeedData, PriceFeedSummary, QuotaAsset, RateCurve, RateCurvePoint, ReceivedAsset, Rewards, RewardsPnL, STRATEGY_HISTORY_METRICS, STRATEGY_POSITION_HISTORY_METRICS, StrategyHistoryMetric, StrategyOpportunity, StrategyOpportunityDetail, StrategyOpportunityKey, StrategyOpportunityRef, StrategyPosition, StrategyPositionHistoryMetric, StrategyPositionKey, StrategyPositionRef, Timestamp, Token, TokenAmount, TokenRewards, TokenRewardsPnL, TxCall, 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 { Amount, ApyBreakdown, AssetType, Bps, ChainId, Curator, CuratorName, DelayedReceivedAsset, FILTER_ALL, FilterAll, Filterable, HistoryChartMetadata, HistoryMetric, HistoryPoint, HistoryRange, HistorySeries, InstantReceivedAsset, Leverage, LiquidatableAccount, LiquidatableAccountFilter, LiquidationApproval, LiquidationDetails, LiquidationPosition, Opportunity, OpportunityBase, OpportunityDetail, OpportunityFilter, OpportunityHistoryQuery, OpportunityId, OpportunityKey, OpportunityKind, POOL_HISTORY_METRICS, POOL_POSITION_HISTORY_METRICS, PnlBreakdown, PointRewards, PointsProgram, PointsProgramPnL, PointsRewardsPnL, PoolHistoryMetric, PoolOpportunity, PoolOpportunityDetail, PoolOpportunityKey, PoolOpportunityRef, PoolPosition, PoolPositionHistoryMetric, PoolPositionKey, PoolPositionRef, Position, PositionCollateral, PositionFilter, PositionHistoryMetric, PositionHistoryQuery, PositionId, PositionKey, PositionKind, PriceFeedData, PriceFeedSummary, QuotaAsset, RateCurve, RateCurvePoint, ReceivedAsset, Rewards, RewardsPnL, STRATEGY_HISTORY_METRICS, STRATEGY_POSITION_HISTORY_METRICS, StrategyHistoryMetric, StrategyOpportunity, StrategyOpportunityDetail, StrategyOpportunityKey, StrategyOpportunityRef, StrategyPosition, StrategyPositionHistoryMetric, StrategyPositionKey, StrategyPositionRef, Timestamp, Token, TokenAmount, TokenRewards, TokenRewardsPnL, TxCall, 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/types/model/liquidations.d.ts

@@ -1,36 +1,39 @@
 import { AssetType, ChainId, Timestamp, Token, TokenAmount, TxCall } from "./primitives.js";
+import { Filterable } from "./filters.js";
 import { Address } from "viem";
 //#region src/model/liquidations.d.ts
 /**
  * Optional narrowing of a liquidatable accounts list.
  *
- * Every criterion is optional and an omitted one matches any value, so an empty
- * filter is the same as no filter at all. Criteria combine with AND.
+ * Every condition is optional and an omitted one matches any value, so an
+ * empty filter is the same as no filter at all. A condition can also be set to
+ * `"all"` to say the same thing explicitly, which is what a UI whose state has
+ * an "any" option holds, see {@link Filterable}. Conditions combine with AND.
  **/
 interface LiquidatableAccountFilter {
   /**
    * Keep only accounts on these chains.
    **/
-  chainIds?: ChainId[];
+  chainIds?: Filterable<ChainId[]>;
   /**
    * Keep only accounts whose underlying — the token of
    * {@link LiquidatableAccount.totalValue} — is of this class.
    **/
-  underlyingType?: AssetType;
+  underlyingType?: Filterable<AssetType>;
   /**
    * Keep only accounts of paused credit facades, or only of unpaused ones.
    **/
-  paused?: boolean;
+  paused?: Filterable<boolean>;
   /**
    * Keep only accounts in markets that accept RWA collateral, or only the ones
    * outside them.
    **/
-  rwa?: boolean;
+  rwa?: Filterable<boolean>;
   /**
    * Keep only accounts with (`true`) or without (`false`) delayed
    * (phantom-token) withdrawals.
    **/
-  delayed?: boolean;
+  delayed?: Filterable<boolean>;
 }
 /**
  * A credit account that can be liquidated, with amounts precomputed for
@@ -90,14 +93,15 @@ interface LiquidatableAccount {
   rwa: boolean;
 }
 /**
- * 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.
  **/
 declare function matchesLiquidatableAccountFilter(account: LiquidatableAccount, filter?: LiquidatableAccountFilter): boolean;
 /**

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

@@ -8,11 +8,11 @@ import { z } from "zod/v4";
  * {@link LiquidatableAccountFilter}
  **/
 declare const liquidatableAccountFilterSchema: z.ZodObject<{
-  chainIds: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
-  underlyingType: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"Stable">, z.ZodLiteral<"ETH">, z.ZodLiteral<"BTC">]>>;
-  paused: z.ZodOptional<z.ZodBoolean>;
-  rwa: z.ZodOptional<z.ZodBoolean>;
-  delayed: z.ZodOptional<z.ZodBoolean>;
+  chainIds: z.ZodOptional<z.ZodUnion<[z.ZodArray<z.ZodNumber>, z.ZodLiteral<"all">]>>;
+  underlyingType: z.ZodOptional<z.ZodUnion<[z.ZodUnion<readonly [z.ZodLiteral<"Stable">, z.ZodLiteral<"ETH">, z.ZodLiteral<"BTC">]>, z.ZodLiteral<"all">]>>;
+  paused: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodLiteral<"all">]>>;
+  rwa: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodLiteral<"all">]>>;
+  delayed: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodLiteral<"all">]>>;
 }, z.core.$strip>;
 /**
  * {@link LiquidatableAccount}

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

@@ -1,5 +1,6 @@
 import { Curator } from "./curators.js";
 import { Amount, AssetType, Bps, ChainId, Leverage, Timestamp, Token } from "./primitives.js";
+import { Filterable } from "./filters.js";
 import { Address } from "viem";
 //#region src/model/opportunities.d.ts
 /**
@@ -350,48 +351,51 @@ declare function opportunityId(opportunity: Opportunity): OpportunityId;
  * The list is filtered in memory over final values, so there is no paging and
  * no sorting: a screen sorts what it got.
  *
- * Every criterion is optional and an omitted one matches any value, so an empty
- * filter is the same as no filter at all. Criteria combine with AND.
+ * Every condition is optional and an omitted one matches any value, so an
+ * empty filter is the same as no filter at all. A condition can also be set to
+ * `"all"` to say the same thing explicitly, which is what a UI whose state has
+ * an "any" option holds, see {@link Filterable}. Conditions combine with AND.
  **/
 interface OpportunityFilter {
   /**
    * Keep only pools or only strategies.
    **/
-  kind?: OpportunityKind;
+  kind?: Filterable<OpportunityKind>;
   /**
    * Keep only opportunities on these chains.
    **/
-  chainIds?: ChainId[];
+  chainIds?: Filterable<ChainId[]>;
   /**
    * Keep only opportunities whose {@link OpportunityBase.underlyingToken} is of
    * this class, which for an RWA market means the class of the token its
    * wrapper holds. An underlying that is not in the hardcoded table never
    * matches, so a set filter also drops unclassified rows.
    **/
-  underlyingType?: AssetType;
+  underlyingType?: Filterable<AssetType>;
   /**
    * Keep only paused opportunities, or only unpaused ones.
    **/
-  paused?: boolean;
+  paused?: Filterable<boolean>;
   /**
    * Keep only opportunities being wound down, or only the ones that are not.
    **/
-  sunset?: boolean;
+  sunset?: Filterable<boolean>;
   /**
    * Keep only opportunities that accept RWA collateral, or only the ones that
    * do not.
    **/
-  rwa?: boolean;
+  rwa?: Filterable<boolean>;
 }
 /**
- * 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.
  **/
 declare function matchesOpportunityFilter(opportunity: Opportunity, filter?: OpportunityFilter): boolean;
 /**