@gearbox-protocol/sdk 14.12.0-next.81 → 14.12.0-next.83

package/dist/cjs/sdk/MultichainSDK.js

@@ -1,10 +1,10 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_sdk_chain_chains = require("./chain/chains.js");
-const require_sdk_core_errors = require("./core/errors.js");
 const require_sdk_market_pricefeeds_updates_PriceUpdatesCache = require("./market/pricefeeds/updates/PriceUpdatesCache.js");
 require("./market/pricefeeds/updates/index.js");
 const require_sdk_accounts_liquidations_MultichainLiquidationsService = require("./accounts/liquidations/MultichainLiquidationsService.js");
 require("./accounts/index.js");
+const require_sdk_core_errors = require("./core/errors.js");
 require("./core/index.js");
 const require_sdk_opportunities_MultichainOpportunitiesService = require("./opportunities/MultichainOpportunitiesService.js");
 require("./opportunities/index.js");

package/dist/cjs/sdk/OnchainSDK.js

@@ -9,7 +9,6 @@ const require_sdk_utils_formatter = require("./utils/formatter.js");
 const require_sdk_utils_toAddress = require("./utils/toAddress.js");
 require("./utils/index.js");
 const require_sdk_base_ChainContractsRegister = require("./base/ChainContractsRegister.js");
-const require_sdk_core_errors = require("./core/errors.js");
 require("./base/index.js");
 const require_sdk_utils_viem_executeDelegatedMulticalls = require("./utils/viem/executeDelegatedMulticalls.js");
 require("./utils/viem/index.js");
@@ -24,6 +23,7 @@ const require_sdk_accounts_withdrawal_compressor_createRedemptionLogger = requir
 const require_sdk_accounts_withdrawal_compressor_createWithdrawalCompressor = require("./accounts/withdrawal-compressor/createWithdrawalCompressor.js");
 require("./accounts/index.js");
 const require_sdk_core_createAddressProvider = require("./core/createAddressProvider.js");
+const require_sdk_core_errors = require("./core/errors.js");
 require("./core/index.js");
 const require_sdk_opportunities_OpportunitiesService = require("./opportunities/OpportunitiesService.js");
 require("./opportunities/index.js");

package/dist/cjs/sdk/accounts/liquidations/MultichainLiquidationsService.js

@@ -3,13 +3,8 @@ const require_sdk_base_MultichainConstruct = require("../../base/MultichainConst
 require("../../base/index.js");
 //#region src/sdk/accounts/liquidations/MultichainLiquidationsService.ts
 /**
-* Cross-chain counterpart of {@link LiquidationsService}.
-*
-* Fans out over all chains configured in {@link MultichainSDK} (optionally
-* restricted via {@link MultichainNetworksProps.networks}). A failed chain is
-* logged as a warning and skipped, so one dead RPC does not empty the whole
-* list; its failure is reported in {@link MultichainResult.meta}. Networks that
-* are not configured in the SDK are reported there the same way.
+* Cross-chain counterpart of {@link LiquidationsService}. These reads are live,
+* so each chain is pinned to its own freshly fetched head.
 **/
 var MultichainLiquidationsService = class extends require_sdk_base_MultichainConstruct.MultichainConstruct {
 	/**
@@ -18,22 +13,44 @@ var MultichainLiquidationsService = class extends require_sdk_base_MultichainCon
 	**/
 	async getLiquidatableAccounts(props) {
 		return this.queryChains({
-			networks: props?.networks,
+			chainIds: props?.chainIds,
 			label: "get liquidatable accounts",
-			run: (sdk) => sdk.liquidations.getLiquidatableAccounts(props)
+			block: "latest",
+			run: (sdk, block) => sdk.liquidations.getLiquidatableAccounts({
+				...props,
+				blockNumber: block.blockNumber
+			})
 		});
 	}
 	/**
 	* {@inheritDoc LiquidationsService.getLiquidationDetails}
+	*
+	* Throws when the chain cannot answer.
 	**/
 	async getLiquidationDetails(props) {
-		return this.sdk.chain(props.network).liquidations.getLiquidationDetails(props);
+		return this.queryChain({
+			network: props.network,
+			block: props.blockNumber ?? "latest",
+			run: (sdk, block) => sdk.liquidations.getLiquidationDetails({
+				...props,
+				blockNumber: block.blockNumber
+			})
+		});
 	}
 	/**
 	* {@inheritDoc LiquidationsService.buildLiquidationTx}
+	*
+	* The reported block is the one the transaction was built against.
 	**/
 	async buildLiquidationTx(props) {
-		return this.sdk.chain(props.network).liquidations.buildLiquidationTx(props);
+		return this.queryChain({
+			network: props.network,
+			block: props.blockNumber ?? "latest",
+			run: (sdk, block) => sdk.liquidations.buildLiquidationTx({
+				...props,
+				blockNumber: block.blockNumber
+			})
+		});
 	}
 	/**
 	* Liquidation positions of all queried chains, see
@@ -41,18 +58,25 @@ var MultichainLiquidationsService = class extends require_sdk_base_MultichainCon
 	**/
 	async getLiquidationPositions(props) {
 		return this.queryChains({
-			networks: props.networks,
+			chainIds: props.chainIds,
 			label: "get liquidation positions",
-			run: (sdk) => sdk.liquidations.getLiquidationPositions(props)
+			block: "latest",
+			run: (sdk, block) => sdk.liquidations.getLiquidationPositions({
+				...props,
+				blockNumber: block.blockNumber
+			})
 		});
 	}
 	/**
 	* Loads the liquidators of all queried chains, see
 	* {@link LiquidationsService.loadRWALiquidators}.
+	*
+	* Nothing consumes the block of a cache warm-up, so this one is left on the
+	* loaded snapshot.
 	**/
 	async loadRWALiquidators(props) {
 		return this.runChains({
-			networks: props?.networks,
+			chainIds: props?.chainIds,
 			label: "load RWA liquidators",
 			run: (sdk) => sdk.liquidations.loadRWALiquidators()
 		});

package/dist/cjs/sdk/base/MultichainConstruct.js

@@ -1,15 +1,13 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_sdk_core_errors = require("../core/errors.js");
 //#region src/sdk/base/MultichainConstruct.ts
 /**
 * @internal
 * Base class for services that fan out over the chains of a
 * {@link MultichainSDK}, the cross-chain counterpart of {@link SDKConstruct}.
 *
-* Requests are soft-failing: a chain that rejects (including a chain that is
-* not configured in the SDK) is logged as a warning and contributes no payload,
-* while the remaining chains still return their results. Every queried chain is
-* reported in {@link MultichainResult.meta}.
+* A fan-out soft-fails: a chain that rejects is logged as a warning and
+* contributes no payload, while the remaining chains still return their rows.
+* A single-chain request throws instead.
 *
 * @typeParam Plugins - Map of attached plugin types.
 **/
@@ -23,58 +21,99 @@ var MultichainConstruct = class {
 	* chains that responded successfully.
 	**/
 	async queryChains(props) {
-		const { values, meta } = await this.#settle(props);
+		const { values, chains } = await this.#settle(props);
 		return {
-			result: values.flat(),
-			meta
+			data: values.flat(),
+			meta: { chains }
 		};
 	}
 	/**
 	* Fans out a request with no payload, reporting the outcome of every queried
-	* chain in {@link MultichainResult.meta}.
+	* chain in `meta.chains`.
 	**/
 	async runChains(props) {
-		const { meta } = await this.#settle(props);
+		const { chains } = await this.#settle(props);
 		return {
-			result: void 0,
-			meta
+			data: void 0,
+			meta: { chains }
 		};
 	}
 	/**
-	* Runs the request on all queried chains in parallel. Duplicate networks are
-	* queried once, and {@link SettledChains.meta} follows the requested order.
+	* Runs a request against one chain and reports the block it was read at.
+	* Throws when the chain is not configured, not attached, or rejects the read.
 	**/
-	async #settle({ networks, label, run }) {
-		const requested = networks ? [...new Set(networks)] : [...this.sdk.chains.keys()];
-		const settled = await Promise.allSettled(requested.map(async (network) => {
-			const chainSdk = this.sdk.chains.get(network);
-			if (!chainSdk) throw new require_sdk_core_errors.ChainNotConfiguredError(network);
-			return run(chainSdk);
+	async queryChain({ network, block = "state", run }) {
+		const sdk = this.sdk.chain(network);
+		const at = await this.#resolveBlock(sdk, block);
+		return {
+			data: await run(sdk, at),
+			meta: { chains: [succeeded(sdk.chainId, at)] }
+		};
+	}
+	/**
+	* Runs the request on every queried chain in parallel.
+	**/
+	async #settle({ chainIds, label, block = "state", run }) {
+		const wanted = chainIds && new Set(chainIds);
+		const requested = [];
+		for (const [network, sdk] of this.sdk.chains) if (!wanted || wanted.has(sdk.chainId)) requested.push([network, sdk]);
+		const settled = await Promise.allSettled(requested.map(async ([, sdk]) => {
+			const at = await this.#resolveBlock(sdk, block);
+			return {
+				data: await run(sdk, at),
+				at
+			};
 		}));
 		const values = [];
-		const meta = [];
-		settled.forEach((result, i) => {
-			const network = requested[i];
+		const chains = [];
+		for (let i = 0; i < settled.length; i++) {
+			const [network, sdk] = requested[i];
+			const result = settled[i];
 			if (result.status === "fulfilled") {
-				values.push(result.value);
-				meta.push({
-					network,
-					status: "success"
-				});
-				return;
+				values.push(result.value.data);
+				chains.push(succeeded(sdk.chainId, result.value.at));
+				continue;
 			}
-			(this.sdk.chains.get(network)?.logger ?? this.sdk.logger)?.warn(result.reason, `failed to ${label} on ${network}`);
-			meta.push({
-				network,
+			(sdk.logger ?? this.sdk.logger)?.warn(result.reason, `failed to ${label} on ${network}`);
+			chains.push({
+				chainId: sdk.chainId,
 				status: "error",
+				source: "onchain",
 				error: result.reason
 			});
-		});
+		}
 		return {
 			values,
-			meta
+			chains
+		};
+	}
+	/**
+	* Block a chain's read is pinned to and reported at.
+	**/
+	async #resolveBlock(sdk, source) {
+		if (source === "state") return {
+			blockNumber: sdk.currentBlock,
+			timestamp: sdk.timestamp
+		};
+		if (typeof source === "bigint") return {
+			blockNumber: source,
+			timestamp: (await sdk.client.getBlock({ blockNumber: source })).timestamp
+		};
+		const block = await sdk.client.getBlock({ blockTag: "latest" });
+		return {
+			blockNumber: block.number,
+			timestamp: block.timestamp
 		};
 	}
 };
+function succeeded(chainId, at) {
+	return {
+		chainId,
+		status: "success",
+		source: "onchain",
+		blockNumber: Number(at.blockNumber),
+		timestamp: Number(at.timestamp)
+	};
+}
 //#endregion
 exports.MultichainConstruct = MultichainConstruct;

package/dist/cjs/sdk/chain/chains.js

@@ -355,6 +355,16 @@ function getNetworkType(chainId) {
 	return network;
 }
 /**
+* Chain IDs of chains named as {@link NetworkType} labels or as IDs already,
+* e.g. `sdk.opportunities.list({ chainIds: toChainIds(["Mainnet"]) })`.
+*
+* @param scope - Chains as labels, or already as IDs.
+* @throws If any entry is not a supported network.
+**/
+function toChainIds(scope) {
+	return scope.map((entry) => getChain(entry).id);
+}
+/**
 * Type guard that checks whether a chain ID belongs to a supported Gearbox network.
 *
 * @param chainId - Numeric chain ID, or `undefined`.
@@ -465,3 +475,4 @@ exports.isRWAToken = isRWAToken;
 exports.isSunsetPool = isSunsetPool;
 exports.isSunsetStrategy = isSunsetStrategy;
 exports.isSupportedNetwork = isSupportedNetwork;
+exports.toChainIds = toChainIds;

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

@@ -15,3 +15,4 @@ exports.isRWAToken = require_sdk_chain_chains.isRWAToken;
 exports.isSunsetPool = require_sdk_chain_chains.isSunsetPool;
 exports.isSunsetStrategy = require_sdk_chain_chains.isSunsetStrategy;
 exports.isSupportedNetwork = require_sdk_chain_chains.isSupportedNetwork;
+exports.toChainIds = require_sdk_chain_chains.toChainIds;

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

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_sdk_core_errors = require("./errors.js");
 const require_sdk_core_AddressProviderV310Contract = require("./AddressProviderV310Contract.js");
 const require_sdk_core_createAddressProvider = require("./createAddressProvider.js");
+const require_sdk_core_errors = require("./errors.js");
 require("./types.js");
 exports.AddressProviderV310Contract = require_sdk_core_AddressProviderV310Contract.AddressProviderV310Contract;
 exports.ChainNotConfiguredError = require_sdk_core_errors.ChainNotConfiguredError;

package/dist/cjs/sdk/index.js

@@ -36,7 +36,6 @@ const require_sdk_base_ChainContractsRegister = require("./base/ChainContractsRe
 const require_sdk_base_Construct = require("./base/Construct.js");
 const require_sdk_base_BaseContract = require("./base/BaseContract.js");
 const require_sdk_base_errors = require("./base/errors.js");
-const require_sdk_core_errors = require("./core/errors.js");
 const require_sdk_base_MultichainConstruct = require("./base/MultichainConstruct.js");
 const require_sdk_base_PlaceholderContract = require("./base/PlaceholderContract.js");
 const require_sdk_base_SDKConstruct = require("./base/SDKConstruct.js");
@@ -129,6 +128,7 @@ const require_sdk_accounts_withdrawal_compressor_createWithdrawalCompressor = re
 require("./accounts/index.js");
 const require_sdk_core_AddressProviderV310Contract = require("./core/AddressProviderV310Contract.js");
 const require_sdk_core_createAddressProvider = require("./core/createAddressProvider.js");
+const require_sdk_core_errors = require("./core/errors.js");
 require("./core/index.js");
 const require_sdk_opportunities_MultichainOpportunitiesService = require("./opportunities/MultichainOpportunitiesService.js");
 const require_sdk_opportunities_OpportunitiesService = require("./opportunities/OpportunitiesService.js");
@@ -415,6 +415,7 @@ exports.simulateWithPriceUpdates = require_sdk_utils_viem_simulateWithPriceUpdat
 exports.toAddress = require_sdk_utils_toAddress.toAddress;
 exports.toBN = require_sdk_utils_formatter.toBN;
 exports.toBigInt = require_sdk_utils_formatter.toBigInt;
+exports.toChainIds = require_sdk_chain_chains.toChainIds;
 exports.toClaimableWithdrawal = require_sdk_accounts_withdrawal_compressor_AbstractWithdrawalCompressorContract.toClaimableWithdrawal;
 exports.toPendingWithdrawal = require_sdk_accounts_withdrawal_compressor_AbstractWithdrawalCompressorContract.toPendingWithdrawal;
 exports.toRequestableWithdrawal = require_sdk_accounts_withdrawal_compressor_AbstractWithdrawalCompressorContract.toRequestableWithdrawal;

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

@@ -1,62 +1,48 @@
 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}.
-*
-* Fans out over every chain configured in {@link MultichainSDK}. A chain that
-* fails is logged and skipped so one dead RPC does not empty the list; its
-* failure is reported in {@link MultichainResult.meta}.
-*
-* Detail reads need no fan-out: an opportunity key names its chain.
+* Cross-chain counterpart of {@link OpportunitiesService}. Every read walks
+* loaded market state, so the block it reports is the SDK's snapshot.
 *
 * @typeParam Plugins - Map of attached plugin types.
 **/
 var MultichainOpportunitiesService = class extends require_sdk_base_MultichainConstruct.MultichainConstruct {
 	/**
 	* Opportunities of all queried chains, see {@link OpportunitiesService.list}.
-	*
-	* A filter that names chains narrows the fan-out itself, so chains whose rows
-	* would be discarded are never queried and never appear in the meta.
+	* A filter that names chains narrows the fan-out itself, so a chain whose
+	* rows would be discarded is never queried and never appears in the meta.
 	**/
 	async list(filter) {
 		return this.queryChains({
-			networks: this.#networksOf(filter),
+			chainIds: filter?.chainIds,
 			label: "list opportunities",
 			run: (sdk) => sdk.opportunities.list(filter)
 		});
 	}
 	/**
 	* {@inheritDoc OpportunitiesService.getPool}
+	*
+	* The key names its chain, so there is no fan-out. Throws when that chain
+	* cannot answer.
 	**/
 	async getPool(key) {
-		return this.sdk.chain(key.chainId).opportunities.getPool(key);
+		return this.queryChain({
+			network: key.chainId,
+			run: (sdk) => sdk.opportunities.getPool(key)
+		});
 	}
 	/**
 	* {@inheritDoc OpportunitiesService.getStrategy}
+	*
+	* See {@link MultichainOpportunitiesService.getPool}.
 	**/
 	async getStrategy(key) {
-		return this.sdk.chain(key.chainId).opportunities.getStrategy(key);
-	}
-	/**
-	* Chains named by the filter, or `undefined` to query all of them. Chain ids
-	* the SDK does not support are dropped here rather than reported as failures:
-	* a filter naming them is a narrowing, not a request.
-	**/
-	#networksOf(filter) {
-		const chainIds = filter?.chainIds;
-		if (!require_model_filters.isFilterSet(chainIds)) return;
-		const networks = [];
-		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`);
-		}
-		return networks;
+		return this.queryChain({
+			network: key.chainId,
+			run: (sdk) => sdk.opportunities.getStrategy(key)
+		});
 	}
 };
 //#endregion

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

@@ -1,8 +1,6 @@
 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.
@@ -24,8 +22,7 @@ var OpportunitiesService = class extends require_sdk_base_SDKConstruct.SDKConstr
 	* @param filter - Optional narrowing, applied to the built rows.
 	**/
 	async list(filter) {
-		const chainIds = filter?.chainIds;
-		if (require_model_filters.isFilterSet(chainIds) && !chainIds.includes(this.chainId)) return [];
+		if (filter?.chainIds && !filter.chainIds.includes(this.chainId)) return [];
 		return this.sdk.marketRegister.markets.flatMap((market) => market.opportunities(filter));
 	}
 	/**

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

@@ -1,51 +1,28 @@
 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}.
 *
-* Fans out over every chain configured in {@link MultichainSDK}. A chain that
-* fails is logged and skipped so one dead RPC does not hide the positions a
-* wallet holds elsewhere; its failure is reported in
-* {@link MultichainResult.meta}.
-*
 * @typeParam Plugins - Map of attached plugin types.
 **/
 var MultichainPositionsService = class extends require_sdk_base_MultichainConstruct.MultichainConstruct {
 	/**
 	* Positions of a wallet on all queried chains, see
 	* {@link PositionsService.list}.
-	*
-	* A filter that names chains narrows the fan-out itself, so chains whose rows
-	* would be discarded are never queried and never appear in the meta.
 	**/
 	async list(props) {
 		return this.queryChains({
-			networks: this.#networksOf(props.filter),
+			chainIds: props.filter?.chainIds,
 			label: "list positions",
-			run: (sdk) => sdk.positions.list(props)
+			block: "latest",
+			run: (sdk, block) => sdk.positions.list({
+				...props,
+				blockNumber: block.blockNumber
+			})
 		});
 	}
-	/**
-	* Chains named by the filter, or `undefined` to query all of them. Chain ids
-	* the SDK does not support are dropped here rather than reported as failures:
-	* a filter naming them is a narrowing, not a request.
-	**/
-	#networksOf(filter) {
-		const chainIds = filter?.chainIds;
-		if (!require_model_filters.isFilterSet(chainIds)) return;
-		const networks = [];
-		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`);
-		}
-		return networks;
-	}
 };
 //#endregion
 exports.MultichainPositionsService = MultichainPositionsService;

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

@@ -19,8 +19,7 @@ var PositionsService = class extends require_sdk_base_SDKConstruct.SDKConstruct
 	**/
 	async list(props) {
 		const { wallet, filter, blockNumber } = props;
-		const chainIds = filter?.chainIds;
-		if (require_model_filters.isFilterSet(chainIds) && !chainIds.includes(this.chainId)) return [];
+		if (filter?.chainIds && !filter.chainIds.includes(this.chainId)) return [];
 		const wantedKind = filter?.kind;
 		const wanted = (kind) => !require_model_filters.isFilterSet(wantedKind) || wantedKind === kind;
 		const isZeroDebt = filter?.isZeroDebt;

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

@@ -1,9 +1,5 @@
 //#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";

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

@@ -1,4 +1,4 @@
-import "./filters.js";
+import { isFilterSet } from "./filters.js";
 import { z } from "zod/v4";
 //#region src/model/filters.schema.ts
 /**
@@ -16,5 +16,13 @@ function filterable(schema) {
 	return z.union([schema, filterAllSchema]);
 }
 const booleanParamSchema = z.enum(["true", "false"]);
+/**
+* A boolean condition as a URL can carry it: a condition that does not narrow
+* is absent rather than spelled out, see {@link booleanParamSchema}.
+**/
+function encodeFlag(condition) {
+	if (!isFilterSet(condition)) return;
+	return condition ? "true" : "false";
+}
 //#endregion
-export { booleanParamSchema, filterAllSchema, filterable };
+export { booleanParamSchema, encodeFlag, filterAllSchema, filterable };

package/dist/esm/model/index.js

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

package/dist/esm/model/liquidations.js

@@ -13,7 +13,7 @@ import { isFilterSet } from "./filters.js";
 **/
 function matchesLiquidatableAccountFilter(account, filter) {
 	if (!filter) return true;
-	if (isFilterSet(filter.chainIds) && !filter.chainIds.includes(account.chainId)) return false;
+	if (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;

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

@@ -11,7 +11,7 @@ import { z } from "zod/v4";
 * {@link LiquidatableAccountFilter}
 **/
 const liquidatableAccountFilterSchema = z.object({
-	chainIds: filterable(z.array(chainIdSchema)).optional(),
+	chainIds: z.array(chainIdSchema).optional(),
 	underlyingType: filterable(assetTypeSchema).optional(),
 	paused: filterable(z.boolean()).optional(),
 	rwa: filterable(z.boolean()).optional(),

package/dist/esm/model/opportunities.js

@@ -42,7 +42,7 @@ function opportunityId(opportunity) {
 function matchesOpportunityFilter(opportunity, filter) {
 	if (!filter) return true;
 	if (isFilterSet(filter.kind) && opportunity.kind !== filter.kind) return false;
-	if (isFilterSet(filter.chainIds) && !filter.chainIds.includes(opportunity.chainId)) return false;
+	if (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;