@gearbox-protocol/sdk 14.12.0-next.66 → 14.12.0-next.67

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

@@ -0,0 +1,12 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_sdk_market_math = require("../market/math.js");
+const require_sdk_opportunities_MultichainOpportunitiesService = require("./MultichainOpportunitiesService.js");
+const require_sdk_opportunities_OpportunitiesService = require("./OpportunitiesService.js");
+exports.MultichainOpportunitiesService = require_sdk_opportunities_MultichainOpportunitiesService.MultichainOpportunitiesService;
+exports.OpportunitiesService = require_sdk_opportunities_OpportunitiesService.OpportunitiesService;
+exports.additionalBorrowApyBps = require_sdk_market_math.additionalBorrowApyBps;
+exports.borrowApyBps = require_sdk_market_math.borrowApyBps;
+exports.maxLeverage = require_sdk_market_math.maxLeverage;
+exports.rayToBps = require_sdk_market_math.rayToBps;
+exports.usdToNumber = require_sdk_market_math.usdToNumber;
+exports.utilizationBps = require_sdk_market_math.utilizationBps;

package/dist/cjs/sdk/types/multichain.js

@@ -0,0 +1 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });

package/dist/cjs/{common-utils → sdk}/utils/bigint-math.js

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-//#region src/common-utils/utils/bigint-math.ts
+//#region src/sdk/utils/bigint-math.ts
 /**
 * Utility namespace for common `bigint` operations.
 *
@@ -17,20 +17,20 @@ var BigIntMath = class {
 	static abs = (x) => x < 0n ? -x : x;
 	/**
 	* Returns the greater of two bigint values.
-	*
-	* @param a First candidate value.
-	* @param b Second candidate value.
-	* @returns The larger value between `a` and `b`.
+	* @param values - The values to find the maximum of.
+	* @returns The maximum value.
 	*/
-	static max = (a, b) => a > b ? a : b;
+	static max = (...values) => {
+		return values.reduce((max, v) => v > max ? v : max);
+	};
 	/**
 	* Returns the smaller of two bigint values.
-	*
-	* @param a First candidate value.
-	* @param b Second candidate value.
-	* @returns The smaller value between `a` and `b`.
+	* @param values - The values to find the minimum of.
+	* @returns The minimum value.
 	*/
-	static min = (a, b) => a < b ? a : b;
+	static min = (...values) => {
+		return values.reduce((min, v) => v < min ? v : min);
+	};
 	/**
 	* Returns the negative form of a bigint if it is currently positive.
 	*

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

@@ -4,6 +4,7 @@ const require_sdk_utils_AddressSet = require("./AddressSet.js");
 const require_sdk_utils_AssetsMap = require("./AssetsMap.js");
 const require_sdk_utils_json = require("./json.js");
 const require_sdk_utils_abi_decode = require("./abi-decode.js");
+const require_sdk_utils_bigint_math = require("./bigint-math.js");
 const require_sdk_utils_bytes32ToString = require("./bytes32ToString.js");
 const require_sdk_utils_childLogger = require("./childLogger.js");
 const require_sdk_utils_createRawTx = require("./createRawTx.js");
@@ -20,8 +21,10 @@ const require_sdk_utils_zod = require("./zod.js");
 exports.AddressMap = require_sdk_utils_AddressMap.AddressMap;
 exports.AddressSet = require_sdk_utils_AddressSet.AddressSet;
 exports.AssetsMap = require_sdk_utils_AssetsMap.AssetsMap;
+exports.BigIntMath = require_sdk_utils_bigint_math.BigIntMath;
 exports.TypedObjectUtils = require_sdk_utils_mappers.TypedObjectUtils;
 exports.ZodAddress = require_sdk_utils_zod.ZodAddress;
+exports.ZodHex = require_sdk_utils_zod.ZodHex;
 exports.bytes32ToString = require_sdk_utils_bytes32ToString.bytes32ToString;
 exports.childLogger = require_sdk_utils_childLogger.childLogger;
 exports.createRawTx = require_sdk_utils_createRawTx.createRawTx;

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

@@ -13,5 +13,17 @@ const ZodAddress = () => zod_v4.z.string().transform((val, ctx) => {
 	});
 	return (0, viem.getAddress)(val);
 });
+/**
+* A `0x`-prefixed hex string, as viem's Hex.
+*/
+const ZodHex = () => zod_v4.z.string().transform((val, ctx) => {
+	if (!(0, viem.isHex)(val)) ctx.issues.push({
+		code: "custom",
+		message: `invalid hex string ${val}`,
+		input: ctx.value
+	});
+	return val;
+});
 //#endregion
 exports.ZodAddress = ZodAddress;
+exports.ZodHex = ZodHex;

package/dist/esm/common-utils/index.js

@@ -1,5 +1,6 @@
 import { AxiosCache } from "./axios-cache/AxiosCache.js";
 import "./axios-cache/index.js";
+import { BigIntMath } from "../sdk/utils/bigint-math.js";
 import { ChartsCreditManagerData } from "./charts/credit-manager.js";
 import { CREDIT_SESSION_ID_BY_STATUS, CREDIT_SESSION_STATUS_BY_ID, CreditSession, CreditSessionFiltered, UserCreditSessionsBuilder } from "./charts/credit-session.js";
 import { ChartsPoolData, UserPoolData } from "./charts/pool.js";
@@ -11,7 +12,6 @@ import { calculateBorrowRateFromUtilization } from "./utils/apy/calculate-borrow
 import { PriceUtils } from "./utils/price-math.js";
 import { calculateEarnings } from "./utils/apy/calculate-earnings.js";
 import { calculateEffectiveBorrowRate } from "./utils/apy/calculate-effective-borrow-rate.js";
-import { BigIntMath } from "./utils/bigint-math.js";
 import { calculateSafeBorrowRate } from "./utils/apy/calculate-safe-borrow-rate.js";
 import { getComplexAPYList } from "./utils/apy/get-complex-apy-list.js";
 import { getRateWithFee } from "./utils/apy/get-rate-with-fee.js";

package/dist/esm/common-utils/utils/apy/calculate-safe-borrow-rate.js

@@ -1,6 +1,6 @@
+import { BigIntMath } from "../../../sdk/utils/bigint-math.js";
 import { PERCENTAGE_DECIMALS, PERCENTAGE_FACTOR } from "../../../sdk/constants/math.js";
 import { calculateBorrowRateFromUtilization } from "./calculate-borrow-rate-from-utilization.js";
-import { BigIntMath } from "../bigint-math.js";
 //#region src/common-utils/utils/apy/calculate-safe-borrow-rate.ts
 /**
 * Returns borrow rate multiplied by feeInterest

package/dist/esm/common-utils/utils/assets-math.js

@@ -1,5 +1,5 @@
+import { BigIntMath } from "../../sdk/utils/bigint-math.js";
 import { PriceUtils } from "./price-math.js";
-import { BigIntMath } from "./bigint-math.js";
 import { sortBalances } from "./creditAccount/sort.js";
 //#region src/common-utils/utils/assets-math.ts
 /**

package/dist/esm/common-utils/utils/creditAccount/calc-health-factor.js

@@ -1,7 +1,7 @@
+import { BigIntMath } from "../../../sdk/utils/bigint-math.js";
 import { PERCENTAGE_FACTOR, PRICE_DECIMALS } from "../../../sdk/constants/math.js";
 import "../../../sdk/index.js";
 import { PriceUtils } from "../price-math.js";
-import { BigIntMath } from "../bigint-math.js";
 //#region src/common-utils/utils/creditAccount/calc-health-factor.ts
 const MAX_UINT16 = 65535;
 /**

package/dist/esm/common-utils/utils/creditAccount/debt.js

@@ -1,7 +1,7 @@
+import { BigIntMath } from "../../../sdk/utils/bigint-math.js";
 import { PERCENTAGE_FACTOR } from "../../../sdk/constants/math.js";
 import "../../../sdk/index.js";
 import { PriceUtils } from "../price-math.js";
-import { BigIntMath } from "../bigint-math.js";
 //#region src/common-utils/utils/creditAccount/debt.ts
 /**
 * Calculates additional debt that can be borrowed while targeting

package/dist/esm/common-utils/utils/creditAccount/quota-utils.js

@@ -1,6 +1,6 @@
+import { BigIntMath } from "../../../sdk/utils/bigint-math.js";
 import { MIN_INT96, PERCENTAGE_FACTOR } from "../../../sdk/constants/math.js";
 import "../../../sdk/index.js";
-import { BigIntMath } from "../bigint-math.js";
 //#region src/common-utils/utils/creditAccount/quota-utils.ts
 /**
 * Rounds quota deltas to protocol precision step (`PERCENTAGE_FACTOR`).

package/dist/esm/common-utils/utils/index.js

@@ -1,9 +1,9 @@
+import { BigIntMath } from "../../sdk/utils/bigint-math.js";
 import { BONUS_APY_FROM_POINTS } from "./apy/bonus-apy-from-points.js";
 import { calculateBorrowRateFromUtilization } from "./apy/calculate-borrow-rate-from-utilization.js";
 import { PriceUtils } from "./price-math.js";
 import { calculateEarnings } from "./apy/calculate-earnings.js";
 import { calculateEffectiveBorrowRate } from "./apy/calculate-effective-borrow-rate.js";
-import { BigIntMath } from "./bigint-math.js";
 import { calculateSafeBorrowRate } from "./apy/calculate-safe-borrow-rate.js";
 import { getComplexAPYList } from "./apy/get-complex-apy-list.js";
 import { getRateWithFee } from "./apy/get-rate-with-fee.js";

package/dist/esm/common-utils/utils/strategies/leverage/calculate-max-leverage-factor.js

@@ -1,6 +1,6 @@
+import { BigIntMath } from "../../../../sdk/utils/bigint-math.js";
 import { PERCENTAGE_FACTOR } from "../../../../sdk/constants/math.js";
 import "../../../../sdk/index.js";
-import { BigIntMath } from "../../bigint-math.js";
 import { calculateLossCoefficient } from "./calculate-loss-coefficient.js";
 import { maxLeverage } from "./max-leverage.js";
 //#region src/common-utils/utils/strategies/leverage/calculate-max-leverage-factor.ts

package/dist/esm/common-utils/utils/strategies/leverage/calculate-max-strategy-debt.js

@@ -1,5 +1,5 @@
+import { BigIntMath } from "../../../../sdk/utils/bigint-math.js";
 import { LEVERAGE_DECIMALS, PERCENTAGE_FACTOR } from "../../../../sdk/constants/math.js";
-import { BigIntMath } from "../../bigint-math.js";
 import { calculateLossCoefficient } from "./calculate-loss-coefficient.js";
 import { maxLeverage } from "./max-leverage.js";
 //#region src/common-utils/utils/strategies/leverage/calculate-max-strategy-debt.ts

package/dist/esm/common-utils/utils/strategies/strategy-info/calculate-total-points.js

@@ -1,6 +1,6 @@
+import { BigIntMath } from "../../../../sdk/utils/bigint-math.js";
 import { LEVERAGE_DECIMALS, PERCENTAGE_FACTOR, PRICE_DECIMALS } from "../../../../sdk/constants/math.js";
 import { PriceUtils } from "../../price-math.js";
-import { BigIntMath } from "../../bigint-math.js";
 import { getPointsRates } from "../points/get-points-rates.js";
 //#region src/common-utils/utils/strategies/strategy-info/calculate-total-points.ts
 const THRESHOLD_POINTS = 1e3;

package/dist/esm/common-utils/utils/strategies/strategy-info/get-cm-you-can-earn.js

@@ -1,9 +1,9 @@
+import { BigIntMath } from "../../../../sdk/utils/bigint-math.js";
 import { LEVERAGE_DECIMALS } from "../../../../sdk/constants/math.js";
 import { formatBN, toBN, toBigInt } from "../../../../sdk/utils/formatter.js";
 import { PriceUtils } from "../../price-math.js";
 import { calculateEarnings } from "../../apy/calculate-earnings.js";
 import { calculateEffectiveBorrowRate } from "../../apy/calculate-effective-borrow-rate.js";
-import { BigIntMath } from "../../bigint-math.js";
 import { getComplexAPYList } from "../../apy/get-complex-apy-list.js";
 import { getSafeBaseBorrowRate } from "../../apy/get-safe-base-borrow-rate.js";
 import { getCollateralByDebt } from "../leverage/get-collateral-by-debt.js";

package/dist/esm/common-utils/utils/validation/validate-open-account-pool-status.js

@@ -1,4 +1,4 @@
-import { BigIntMath } from "../bigint-math.js";
+import { BigIntMath } from "../../../sdk/utils/bigint-math.js";
 import { validateOpenAccountPoolQuotaStatus } from "./validate-open-account-pool-quota-status.js";
 //#region src/common-utils/utils/validation/validate-open-account-pool-status.ts
 function validateOpenAccountPoolStatus(props) {

package/dist/esm/model/history.js

@@ -0,0 +1,26 @@
+//#region src/model/history.ts
+/**
+* Every {@link PoolHistoryMetric}, for callers that enumerate them.
+**/
+const POOL_HISTORY_METRICS = [
+	"depositApy",
+	"borrowApy",
+	"dieselRate",
+	"supplied",
+	"borrowed",
+	"availableLiquidity"
+];
+/**
+* Every {@link StrategyHistoryMetric}, for callers that enumerate them.
+**/
+const STRATEGY_HISTORY_METRICS = [
+	"netApy",
+	"borrowApy",
+	"collateralApy",
+	"tvl",
+	"collateralPrice",
+	"collateralUsdPrice",
+	"underlyingUsdPrice"
+];
+//#endregion
+export { POOL_HISTORY_METRICS, STRATEGY_HISTORY_METRICS };

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

@@ -0,0 +1,76 @@
+import { timestampSchema } from "./primitives.schema.js";
+import { opportunityKeySchema } from "./opportunities.schema.js";
+import { z } from "zod/v4";
+//#region src/model/history.schema.ts
+/**
+* Runtime schemas for {@link ./history.js}, see the note in
+* `primitives.schema.ts` on why they are written by hand.
+**/
+/**
+* {@link HistoryRange}
+**/
+const historyRangeSchema = z.union([
+	z.literal("1d"),
+	z.literal("1w"),
+	z.literal("1m"),
+	z.literal("1y"),
+	z.literal("max")
+]);
+/**
+* {@link PoolHistoryMetric}
+**/
+const poolHistoryMetricSchema = z.union([
+	z.literal("depositApy"),
+	z.literal("borrowApy"),
+	z.literal("dieselRate"),
+	z.literal("supplied"),
+	z.literal("borrowed"),
+	z.literal("availableLiquidity")
+]);
+/**
+* {@link StrategyHistoryMetric}
+**/
+const strategyHistoryMetricSchema = z.union([
+	z.literal("netApy"),
+	z.literal("borrowApy"),
+	z.literal("collateralApy"),
+	z.literal("tvl"),
+	z.literal("collateralPrice"),
+	z.literal("collateralUsdPrice"),
+	z.literal("underlyingUsdPrice")
+]);
+/**
+* {@link HistoryMetric}
+**/
+const historyMetricSchema = z.union([poolHistoryMetricSchema, strategyHistoryMetricSchema]);
+/**
+* {@link HistoryPoint}
+**/
+const historyPointSchema = z.object({
+	timestamp: timestampSchema,
+	value: z.number()
+});
+/**
+* {@link HistoryChartMetadata}
+*
+* TODO: empty until the backend specifies the payload.
+**/
+const historyChartMetadataSchema = z.object({});
+/**
+* {@link HistorySeries}
+**/
+const historySeriesSchema = z.object({
+	metric: historyMetricSchema,
+	points: z.array(historyPointSchema),
+	metadata: historyChartMetadataSchema
+});
+/**
+* {@link OpportunityHistoryQuery}
+**/
+const opportunityHistoryQuerySchema = z.object({
+	opportunity: opportunityKeySchema,
+	range: historyRangeSchema,
+	metric: historyMetricSchema
+});
+//#endregion
+export { historyChartMetadataSchema, historyMetricSchema, historyPointSchema, historyRangeSchema, historySeriesSchema, opportunityHistoryQuerySchema, poolHistoryMetricSchema, strategyHistoryMetricSchema };

package/dist/esm/model/index.js

@@ -0,0 +1,9 @@
+import { POOL_HISTORY_METRICS, STRATEGY_HISTORY_METRICS } from "./history.js";
+import { amountSchema, assetTypeSchema, bpsSchema, chainIdSchema, curatorSchema, 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";
+import { historyChartMetadataSchema, historyMetricSchema, historyPointSchema, historyRangeSchema, historySeriesSchema, opportunityHistoryQuerySchema, poolHistoryMetricSchema, strategyHistoryMetricSchema } from "./history.schema.js";
+import { matchesLiquidatableAccountFilter } from "./liquidations.js";
+import { delayedReceivedAssetSchema, instantReceivedAssetSchema, liquidatableAccountFilterSchema, liquidatableAccountSchema, liquidationApprovalSchema, liquidationDetailsSchema, liquidationPositionSchema, receivedAssetSchema } from "./liquidations.schema.js";
+import { matchesOpportunityFilter, opportunityId, poolOpportunityId, strategyOpportunityId } from "./opportunities.js";
+import "./primitives.js";
+export { POOL_HISTORY_METRICS, STRATEGY_HISTORY_METRICS, amountSchema, apyBreakdownSchema, assetTypeSchema, bpsSchema, chainIdSchema, curatorSchema, delayedReceivedAssetSchema, historyChartMetadataSchema, historyMetricSchema, historyPointSchema, historyRangeSchema, historySeriesSchema, instantReceivedAssetSchema, leverageSchema, liquidatableAccountFilterSchema, liquidatableAccountSchema, liquidationApprovalSchema, liquidationDetailsSchema, liquidationPositionSchema, matchesLiquidatableAccountFilter, matchesOpportunityFilter, opportunityBaseSchema, opportunityDetailSchema, opportunityFilterSchema, opportunityHistoryQuerySchema, opportunityId, opportunityKeySchema, opportunityKindSchema, opportunitySchema, pointRewardsSchema, pointsProgramSchema, poolHistoryMetricSchema, poolOpportunityDetailSchema, poolOpportunityId, poolOpportunityKeySchema, poolOpportunitySchema, priceFeedDataSchema, priceFeedSummarySchema, quotaAssetSchema, rateCurvePointSchema, rateCurveSchema, receivedAssetSchema, rewardsSchema, strategyHistoryMetricSchema, strategyOpportunityDetailSchema, strategyOpportunityId, strategyOpportunityKeySchema, strategyOpportunitySchema, timestampSchema, tokenAmountSchema, tokenRewardsSchema, tokenSchema, txCallSchema };

package/dist/esm/model/liquidations.js

@@ -0,0 +1,22 @@
+//#region src/model/liquidations.ts
+/**
+* Whether a liquidatable account satisfies every criterion of a filter.
+*
+* This is the single definition of what each criterion 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.
+**/
+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;
+	return true;
+}
+//#endregion
+export { matchesLiquidatableAccountFilter };

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

@@ -0,0 +1,83 @@
+import { ZodAddress } from "../sdk/utils/zod.js";
+import { assetTypeSchema, chainIdSchema, timestampSchema, tokenAmountSchema, tokenSchema, txCallSchema } from "./primitives.schema.js";
+import { z } from "zod/v4";
+//#region src/model/liquidations.schema.ts
+/**
+* Runtime schemas for {@link ./liquidations.js}, see the note in
+* `primitives.schema.ts` on why they are written by hand.
+**/
+/**
+* {@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()
+});
+/**
+* {@link LiquidatableAccount}
+**/
+const liquidatableAccountSchema = z.object({
+	chainId: chainIdSchema,
+	creditAccount: ZodAddress(),
+	creditManager: ZodAddress(),
+	asset: tokenSchema,
+	totalValue: tokenAmountSchema,
+	repaymentAmount: tokenAmountSchema,
+	estimatedProfit: tokenAmountSchema,
+	isDelayed: z.boolean(),
+	paused: z.boolean(),
+	rwa: z.boolean()
+});
+/**
+* {@link InstantReceivedAsset}
+**/
+const instantReceivedAssetSchema = z.object({
+	...tokenAmountSchema.shape,
+	isDelayed: z.literal(false)
+});
+/**
+* {@link DelayedReceivedAsset}
+**/
+const delayedReceivedAssetSchema = z.object({
+	...tokenAmountSchema.shape,
+	isDelayed: z.literal(true),
+	redeemerAddress: ZodAddress().optional(),
+	claimableAt: timestampSchema.optional()
+});
+/**
+* {@link ReceivedAsset}
+**/
+const receivedAssetSchema = z.discriminatedUnion("isDelayed", [instantReceivedAssetSchema, delayedReceivedAssetSchema]);
+/**
+* {@link LiquidationApproval}
+**/
+const liquidationApprovalSchema = tokenAmountSchema.extend({ spender: ZodAddress() });
+/**
+* {@link LiquidationPosition}
+**/
+const liquidationPositionSchema = z.object({
+	chainId: chainIdSchema,
+	sourceToken: tokenSchema,
+	output: tokenAmountSchema,
+	claimableAt: timestampSchema.optional(),
+	claimTx: txCallSchema.optional(),
+	redeemer: ZodAddress().optional()
+});
+/**
+* {@link LiquidationDetails}
+**/
+const liquidationDetailsSchema = z.object({
+	...liquidatableAccountSchema.shape,
+	repaymentAmount: tokenAmountSchema,
+	receivedAssets: z.array(receivedAssetSchema),
+	isLiquidatorEligible: z.boolean(),
+	isCreditAccountFrozen: z.boolean(),
+	kycProtocol: z.string().optional(),
+	kycToken: tokenSchema.optional(),
+	approve: liquidationApprovalSchema.optional()
+});
+//#endregion
+export { delayedReceivedAssetSchema, instantReceivedAssetSchema, liquidatableAccountFilterSchema, liquidatableAccountSchema, liquidationApprovalSchema, liquidationDetailsSchema, liquidationPositionSchema, receivedAssetSchema };

package/dist/esm/model/opportunities.js

@@ -0,0 +1,51 @@
+//#region src/model/opportunities.ts
+/**
+* Builds the canonical id of a pool opportunity.
+*
+* @example
+* ```ts
+* poolOpportunityId(1, "0xda00...") // "1:0xda00..."
+* ```
+**/
+function poolOpportunityId(chainId, pool) {
+	return `${chainId}:${pool.toLowerCase()}`;
+}
+/**
+* Builds the canonical id of a strategy opportunity.
+*
+* @example
+* ```ts
+* strategyOpportunityId(1, "0x3eb9...", "0x7f39...") // "1:0x3eb9...:0x7f39..."
+* ```
+**/
+function strategyOpportunityId(chainId, creditManager, targetCollateral) {
+	return `${chainId}:${creditManager.toLowerCase()}:${targetCollateral.toLowerCase()}`;
+}
+/**
+* Canonical id of any opportunity, dispatching on {@link Opportunity.kind}.
+**/
+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.
+*
+* This is the single definition of what each criterion 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.
+**/
+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;
+	return true;
+}
+//#endregion
+export { matchesOpportunityFilter, opportunityId, poolOpportunityId, strategyOpportunityId };