@gearbox-protocol/sdk 15.1.0-next.1 → 15.1.0-next.10

package/dist/esm/common-utils/utils/creditAccount/liquidation-price.js

@@ -1,5 +1,4 @@
-import { PERCENTAGE_FACTOR, PRICE_DECIMALS, WAD } from "../../../sdk/constants/math.js";
-import "../../../sdk/index.js";
+import { calcLiquidationPriceForTarget } from "../../../sdk/positions/calcLiquidationPriceForTarget.js";
 //#region src/common-utils/utils/creditAccount/liquidation-price.ts
 /**
 * Calculates target token liquidation price for a credit account.
@@ -12,17 +11,28 @@ import "../../../sdk/index.js";
 * @param props Debt context, assets, thresholds, and token metadata.
 * @returns Target token price in `PRICE_DECIMALS` precision that corresponds
 * to liquidation boundary; returns `0n` when target balance or LT is non-positive.
+*
+* @deprecated Use `calcLiquidationPriceForTarget` from `sdk/positions`
+* instead; this wrapper only maps the legacy props onto an `AccountSnapshot`.
 */
 function liquidationPrice({ liquidationThresholds, debt, underlyingToken, targetToken, assets, tokensList }) {
-	const underlyingDecimals = tokensList[underlyingToken]?.decimals || 18;
-	const { balance: underlyingBalance = 0n } = assets[underlyingToken] || {};
-	const effectiveDebt = (debt - underlyingBalance * (liquidationThresholds[underlyingToken] || 0n) / PERCENTAGE_FACTOR) * WAD / 10n ** BigInt(underlyingDecimals);
-	const targetDecimals = tokensList[targetToken]?.decimals || 18;
-	const { balance: targetBalance = 0n } = assets[targetToken] || {};
-	const effectiveTargetBalance = targetBalance * WAD / 10n ** BigInt(targetDecimals);
-	const lpLT = liquidationThresholds[targetToken] || 0n;
-	if (targetBalance <= 0n || lpLT <= 0n) return 0n;
-	return effectiveDebt * PRICE_DECIMALS * PERCENTAGE_FACTOR / (effectiveTargetBalance * lpLT);
+	const decimals = {};
+	for (const [token, meta] of Object.entries(tokensList)) decimals[token] = meta.decimals;
+	const lts = {};
+	for (const [token, lt] of Object.entries(liquidationThresholds)) lts[token] = Number(lt);
+	return calcLiquidationPriceForTarget({
+		snapshot: {
+			creditManager: underlyingToken,
+			assets: Object.values(assets),
+			quotas: [],
+			totalDebt: debt,
+			totalValue: 0n
+		},
+		targetToken,
+		underlying: underlyingToken,
+		decimals,
+		liquidationThresholds: lts
+	});
 }
 //#endregion
 export { liquidationPrice };

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";
@@ -86,7 +86,6 @@ var AccountOpener = class extends SDKConstruct {
 			depositIntoPools,
 			claimFromFaucet
 		}, "opening credit accounts");
-		await Promise.all([this.sdk.tokensMeta.loadTokenData(), this.sdk.marketRegister.loadZappers()]);
 		let deposits = [];
 		if (depositIntoPools) try {
 			deposits = await this.#depositIntoPools(targets);

package/dist/esm/dev/compareOpportunities.js

@@ -0,0 +1,216 @@
+import { opportunityId } from "../model/opportunities.js";
+import "../model/index.js";
+//#region src/dev/compareOpportunities.ts
+/**
+* Matches two opportunity listings by {@link opportunityId} and reports every
+* field the two sources disagree on.
+*
+* Nothing is filtered out: a diff that is expected — a field only the backend
+* can fill, a formula the two sides define differently, a USD value smoothed on
+* one side — is reported like any other, tagged by {@link DiffKind} so that a
+* reader can bucket it afterwards.
+**/
+function compareOpportunities(input) {
+	const onchainRows = indexById(input.onchain.data);
+	const offchainRows = indexById(input.offchain.data);
+	const onlyOnchain = [];
+	const onlyOffchain = [];
+	const matched = [];
+	for (const [id, row] of onchainRows) {
+		const counterpart = offchainRows.get(id);
+		if (!counterpart) {
+			onlyOnchain.push(toRef(row));
+			continue;
+		}
+		const diffs = diffOpportunity(row, counterpart);
+		matched.push({
+			id,
+			kind: row.kind,
+			chainId: row.chainId,
+			onchainName: row.name,
+			offchainName: counterpart.name,
+			identical: diffs.length === 0,
+			diffs
+		});
+	}
+	for (const [id, row] of offchainRows) if (!onchainRows.has(id)) onlyOffchain.push(toRef(row));
+	byId(onlyOnchain);
+	byId(onlyOffchain);
+	matched.sort((a, b) => a.id.localeCompare(b.id));
+	return {
+		generatedAt: input.generatedAt ?? (/* @__PURE__ */ new Date()).toISOString(),
+		backendUrl: input.backendUrl,
+		networks: [...input.networks],
+		onchainChains: input.onchain.meta.chains,
+		offchainChains: input.offchain.meta.chains,
+		summary: summarize(input.onchain.data, input.offchain.data, onlyOnchain, onlyOffchain, matched),
+		onlyOnchain,
+		onlyOffchain,
+		matched
+	};
+}
+function indexById(rows) {
+	return new Map(rows.map((row) => [opportunityId(row), row]));
+}
+function byId(refs) {
+	refs.sort((a, b) => a.id.localeCompare(b.id));
+}
+function toRef(row) {
+	const base = {
+		id: opportunityId(row),
+		kind: row.kind,
+		chainId: row.chainId,
+		name: row.name
+	};
+	return row.kind === "pool" ? {
+		...base,
+		pool: row.pool
+	} : {
+		...base,
+		creditManager: row.creditManager,
+		targetCollateral: row.targetCollateral.address
+	};
+}
+/**
+* Every field two versions of one opportunity disagree on.
+**/
+function diffOpportunity(onchain, offchain) {
+	const diffs = [];
+	diffValue("", onchain, offchain, diffs);
+	return diffs;
+}
+function diffValue(path, onchain, offchain, out) {
+	if (isAbsent(onchain) && isAbsent(offchain)) return;
+	if (isAbsent(onchain) || isAbsent(offchain)) {
+		out.push({
+			path,
+			onchain,
+			offchain,
+			kind: "presence"
+		});
+		return;
+	}
+	if (Array.isArray(onchain) && Array.isArray(offchain)) {
+		diffArray(path, onchain, offchain, out);
+		return;
+	}
+	if (isRecord(onchain) && isRecord(offchain)) {
+		for (const key of union(Object.keys(onchain), Object.keys(offchain))) diffValue(join(path, key), onchain[key], offchain[key], out);
+		return;
+	}
+	if (!sameScalar(onchain, offchain)) out.push({
+		path,
+		onchain,
+		offchain,
+		kind: scalarKind(path, onchain)
+	});
+}
+/**
+* Arrays whose elements identify themselves — collateral tokens, points
+* programs — are matched by that identity, so a token present on one side only
+* is reported as such rather than shifting every later element into a diff.
+**/
+function diffArray(path, onchain, offchain, out) {
+	const onchainKeyed = keyElements(onchain);
+	const offchainKeyed = keyElements(offchain);
+	if (!onchainKeyed || !offchainKeyed) {
+		if (onchain.length !== offchain.length) {
+			out.push({
+				path,
+				onchain,
+				offchain,
+				kind: "other"
+			});
+			return;
+		}
+		onchain.forEach((element, index) => {
+			diffValue(`${path}[${index}]`, element, offchain[index], out);
+		});
+		return;
+	}
+	for (const key of union([...onchainKeyed.keys()], [...offchainKeyed.keys()])) diffValue(`${path}[${key}]`, onchainKeyed.get(key), offchainKeyed.get(key), out);
+}
+/**
+* The array indexed by each element's own identity, or `undefined` when its
+* elements have none and order is all there is to go by.
+**/
+function keyElements(values) {
+	const keyed = /* @__PURE__ */ new Map();
+	for (const value of values) {
+		if (!isRecord(value)) return;
+		const identity = value.address ?? value.id ?? value.token;
+		if (typeof identity !== "string") return;
+		keyed.set(identity.toLowerCase(), value);
+	}
+	return keyed.size === values.length ? keyed : void 0;
+}
+const ADDRESS = /^0x[0-9a-f]{40}$/i;
+/**
+* Only addresses are compared case-insensitively: the backend lowercases them
+* while the chain hands out checksummed ones, which is not a disagreement. A
+* symbol or a name spelled differently is.
+**/
+function sameScalar(onchain, offchain) {
+	if (typeof onchain === "string" && typeof offchain === "string" && ADDRESS.test(onchain) && ADDRESS.test(offchain)) return onchain.toLowerCase() === offchain.toLowerCase();
+	return onchain === offchain;
+}
+function scalarKind(path, onchain) {
+	if (path.endsWith("valueUsd")) return "usd";
+	return typeof onchain === "number" || typeof onchain === "bigint" ? "numeric" : "other";
+}
+function summarize(onchain, offchain, onlyOnchain, onlyOffchain, matched) {
+	const byChain = union(onchain.map((row) => String(row.chainId)), offchain.map((row) => String(row.chainId))).map((chainId) => ({
+		chainId: Number(chainId),
+		...count(onchain.filter((row) => String(row.chainId) === chainId), offchain.filter((row) => String(row.chainId) === chainId), onlyOnchain.filter((ref) => String(ref.chainId) === chainId), onlyOffchain.filter((ref) => String(ref.chainId) === chainId), matched.filter((match) => String(match.chainId) === chainId))
+	})).sort((a, b) => a.chainId - b.chainId);
+	return {
+		...count(onchain, offchain, onlyOnchain, onlyOffchain, matched),
+		byChain,
+		diffsByPath: countPaths(matched)
+	};
+}
+function count(onchain, offchain, onlyOnchain, onlyOffchain, matched) {
+	const identical = matched.filter((match) => match.identical).length;
+	return {
+		onchainRows: onchain.length,
+		offchainRows: offchain.length,
+		matched: matched.length,
+		identical,
+		differing: matched.length - identical,
+		onlyOnchain: onlyOnchain.length,
+		onlyOffchain: onlyOffchain.length
+	};
+}
+/**
+* How often each field differed, with array keys collapsed so that the same
+* field of a hundred collateral tokens counts as one path.
+**/
+function countPaths(matched) {
+	const counts = /* @__PURE__ */ new Map();
+	for (const match of matched) for (const diff of match.diffs) {
+		const path = diff.path.replace(/\[[^\]]*\]/g, "[]");
+		const entry = counts.get(path) ?? {
+			path,
+			kinds: [],
+			count: 0
+		};
+		entry.count += 1;
+		if (!entry.kinds.includes(diff.kind)) entry.kinds.push(diff.kind);
+		counts.set(path, entry);
+	}
+	return [...counts.values()].sort((a, b) => b.count - a.count || a.path.localeCompare(b.path));
+}
+function isAbsent(value) {
+	return value === void 0 || value === null;
+}
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function union(left, right) {
+	return [.../* @__PURE__ */ new Set([...left, ...right])];
+}
+function join(path, key) {
+	return path ? `${path}.${key}` : key;
+}
+//#endregion
+export { compareOpportunities, diffOpportunity };

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

@@ -0,0 +1,140 @@
+//#region src/model/charts.ts
+/**
+* Historical charts of an opportunity or a position.
+*
+* Charts are backend-only by construction: the chain serves the present, and
+* reconstructing a series from it would mean archive-node reads per point.
+*
+* A chart is read as a {@link ChartBundle}: one shared x-axis plus one
+* {@link ChartSeries} per metric, each holding values only. Alignment is
+* therefore structural — series `i` and series `j` describe the same instant at
+* the same index — rather than a property the backend promises and every
+* consumer re-checks.
+**/
+/**
+* Time window a chart covers, ending at the present.
+*
+* `"max"` is the full history the backend retains for the subject.
+**/
+const CHART_RANGES = [
+	"1d",
+	"1w",
+	"1m",
+	"1y",
+	"max"
+];
+/**
+* Every metric a pool opportunity can chart.
+**/
+const POOL_OPPORTUNITY_CHART_METRICS = [
+	"depositApy",
+	"borrowApy",
+	"dieselRate",
+	"supplied",
+	"borrowed",
+	"availableLiquidity"
+];
+/**
+* Every metric a strategy opportunity can chart.
+*
+* `collateralPrice` is the collateral/underlying series a liquidation-price
+* chart draws; the two USD series are the same prices quoted in dollars.
+**/
+const STRATEGY_OPPORTUNITY_CHART_METRICS = [
+	"netApy",
+	"borrowApy",
+	"collateralApy",
+	"tvl",
+	"collateralPrice",
+	"collateralUsdPrice",
+	"underlyingUsdPrice"
+];
+/**
+* Every metric a pool position can chart.
+*
+* Nothing to do with {@link POOL_OPPORTUNITY_CHART_METRICS}: an opportunity charts what the
+* pool did, a position charts what one wallet's deposit did in it. `mwr` and
+* `twr` are cumulative returns since the position opened — money-weighted, so
+* sensitive to when deposits and withdrawals landed, and time-weighted, which
+* strips that timing out. Both are anchored at inception, so a narrow `range`
+* only zooms the visible slice and its first point is rarely zero.
+**/
+const POOL_POSITION_CHART_METRICS = [
+	"value",
+	"apy",
+	"pnl",
+	"mwr",
+	"twr",
+	"underlyingPrice"
+];
+/**
+* Every metric a strategy position can chart.
+*
+* `twrApy` annualizes `twr` over the position's whole life; the two trailing
+* APYs annualize it over a fixed window instead, so they track the current pace
+* rather than the lifetime rate and are comparable across positions of
+* different ages.
+**/
+const STRATEGY_POSITION_CHART_METRICS = [
+	"totalValueUsd",
+	"totalValueUnderlying",
+	"debt",
+	"healthFactor",
+	"leverage",
+	"borrowApy",
+	"underlyingPrice",
+	"pnl",
+	"mwr",
+	"twr",
+	"twrApy",
+	"trailingApy7d",
+	"trailingApy30d"
+];
+/**
+* Unit of every metric, the one place either side decides it.
+*
+* A metric added to a union above fails to compile here until its unit is
+* named, and the wire schema rejects a series whose `unit` disagrees with this
+* table, so the backend cannot drift from it silently.
+**/
+const CHART_METRIC_UNITS = {
+	depositApy: "bps",
+	borrowApy: "bps",
+	netApy: "bps",
+	collateralApy: "bps",
+	supplied: "token",
+	borrowed: "token",
+	availableLiquidity: "token",
+	tvl: "token",
+	dieselRate: "ratio",
+	collateralPrice: "ratio",
+	collateralUsdPrice: "usd",
+	underlyingUsdPrice: "usd",
+	value: "token",
+	apy: "bps",
+	pnl: "token",
+	mwr: "bps",
+	twr: "bps",
+	underlyingPrice: "usd",
+	totalValueUsd: "usd",
+	totalValueUnderlying: "token",
+	debt: "token",
+	healthFactor: "bps",
+	leverage: "scalar",
+	twrApy: "bps",
+	trailingApy7d: "bps",
+	trailingApy30d: "bps"
+};
+/**
+* Reason a series could not be produced at all, which is not the same as a
+* series that has no points in the window.
+**/
+const CHART_UNAVAILABLE_CODES = [
+	"unknown_subject",
+	"unsupported_metric",
+	"no_price_feed",
+	"not_indexed",
+	"internal"
+];
+//#endregion
+export { CHART_METRIC_UNITS, CHART_RANGES, CHART_UNAVAILABLE_CODES, POOL_OPPORTUNITY_CHART_METRICS, POOL_POSITION_CHART_METRICS, STRATEGY_OPPORTUNITY_CHART_METRICS, STRATEGY_POSITION_CHART_METRICS };

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

@@ -0,0 +1,226 @@
+import { CHART_METRIC_UNITS, CHART_RANGES, CHART_UNAVAILABLE_CODES, POOL_OPPORTUNITY_CHART_METRICS, POOL_POSITION_CHART_METRICS, STRATEGY_OPPORTUNITY_CHART_METRICS, STRATEGY_POSITION_CHART_METRICS } from "./charts.js";
+import { timestampSchema, tokenSchema } from "./primitives.schema.js";
+import { z } from "zod/v4";
+//#region src/model/charts.schema.ts
+/**
+* Runtime schemas for {@link ./charts.js}, see the note in
+* `primitives.schema.ts` on why they are written by hand.
+*
+* Metric schemas are shared with the backend, while
+* {@link chartBundleSchemaFor} builds the response schema for one concrete
+* request. Component schemas remain available for consumers that validate
+* model fragments.
+**/
+/**
+* {@link ChartRange}
+**/
+const chartRangeSchema = z.enum(CHART_RANGES);
+/**
+* {@link PoolOpportunityChartMetric}
+**/
+const poolOpportunityChartMetricSchema = z.enum(POOL_OPPORTUNITY_CHART_METRICS);
+/**
+* {@link StrategyOpportunityChartMetric}
+**/
+const strategyOpportunityChartMetricSchema = z.enum(STRATEGY_OPPORTUNITY_CHART_METRICS);
+/**
+* {@link PoolPositionChartMetric}
+**/
+const poolPositionChartMetricSchema = z.enum(POOL_POSITION_CHART_METRICS);
+/**
+* {@link StrategyPositionChartMetric}
+**/
+const strategyPositionChartMetricSchema = z.enum(STRATEGY_POSITION_CHART_METRICS);
+/**
+* {@link ChartMetric}, every metric either kind of subject can chart.
+**/
+const chartMetricSchema = z.union([
+	poolOpportunityChartMetricSchema,
+	strategyOpportunityChartMetricSchema,
+	poolPositionChartMetricSchema,
+	strategyPositionChartMetricSchema
+]);
+/**
+* {@link ChartQuery}
+**/
+const chartQuerySchema = z.object({
+	metrics: z.array(chartMetricSchema).readonly().refine((metrics) => metrics.length > 0, { error: "a chart read needs at least one metric" }).refine((metrics) => new Set(metrics).size === metrics.length, { error: "a chart read needs distinct metrics" }),
+	range: chartRangeSchema
+});
+/**
+* {@link ChartQuery} as a URL can carry it: the metrics comma-joined, since
+* repeated `?metrics=` entries would order differently between clients and give
+* one request two cache keys.
+**/
+const chartQueryParamsSchema = z.object({
+	metrics: z.string().regex(/^\w+(,\w+)*$/),
+	range: chartRangeSchema
+});
+/**
+* Codec for {@link ChartQuery} to encode/decode to/from url query parameters.
+*
+* The one place the wire form of a chart request is decided. The SDK encodes
+* with it, the backend decodes with it, and the checks that a read names at
+* least one metric and names none of them twice ride along in both directions —
+* so a bad request fails before it is issued, not after a round trip.
+**/
+const chartQueryCodec = z.codec(chartQueryParamsSchema, chartQuerySchema, {
+	decode: (params) => ({
+		metrics: params.metrics.split(","),
+		range: params.range
+	}),
+	encode: (query) => ({
+		metrics: query.metrics.join(","),
+		range: query.range
+	})
+});
+/**
+* {@link ChartDenomination}
+**/
+const chartDenominationSchema = z.discriminatedUnion("unit", [
+	z.object({ unit: z.literal("bps") }),
+	z.object({ unit: z.literal("usd") }),
+	z.object({ unit: z.literal("scalar") }),
+	z.object({
+		unit: z.literal("token"),
+		base: tokenSchema
+	}),
+	z.object({
+		unit: z.literal("ratio"),
+		base: tokenSchema,
+		quote: tokenSchema
+	})
+]);
+/**
+* {@link ChartValue}. `null` is a gap, never a zero.
+**/
+const chartValueSchema = z.number().nullable();
+/**
+* {@link ChartSeries}
+**/
+const chartSeriesSchema = z.union([z.intersection(z.object({
+	status: z.literal("ok"),
+	values: z.array(chartValueSchema)
+}), chartDenominationSchema), z.object({
+	status: z.literal("unavailable"),
+	reason: z.object({
+		code: z.enum(CHART_UNAVAILABLE_CODES),
+		message: z.string().optional()
+	})
+})]);
+/**
+* {@link ChartWindow}
+**/
+const chartWindowSchema = z.object({
+	range: chartRangeSchema,
+	from: timestampSchema,
+	to: timestampSchema
+});
+const gridSamplingSchema = z.object({
+	kind: z.literal("grid"),
+	intervalSeconds: z.number().int().positive()
+});
+/**
+* A bundle whose series are keyed by `keys`.
+*
+* `z.record` over a literal union is what enforces the metric set: a key that
+* was not asked for is rejected, and one that was but is missing fails as an
+* absent value. Exactly-once therefore needs no counting — an object cannot
+* hold the same key twice.
+**/
+function chartBundleSchemaWith(keys, expectedRange) {
+	return z.object({
+		window: chartWindowSchema,
+		sampling: gridSamplingSchema,
+		timestamps: z.array(timestampSchema),
+		series: z.record(keys, chartSeriesSchema)
+	}).superRefine((bundle, ctx) => checkChartBundle(bundle, ctx, expectedRange));
+}
+/**
+* The invariants a bundle upholds beyond its shape, checked on every read so a
+* backend that breaks one is rejected rather than plotted:
+*
+* - each available series holds exactly one value per timestamp, which is what
+*   makes two series of a bundle comparable at an index;
+* - a series' unit is the one {@link CHART_METRIC_UNITS} gives the metric it is
+*   keyed by, so a consumer can format from either without them disagreeing;
+* - the window's bounds are the axis' own, so a chart drawn from `window` and a
+*   chart drawn from `timestamps` cover the same span;
+* - timestamps lie on the declared grid and are exactly one interval apart;
+* - when validating a read, the response names the range that was requested.
+**/
+function checkChartBundle(bundle, ctx, expectedRange) {
+	const { sampling, timestamps, window, series } = bundle;
+	const entries = Object.entries(series);
+	for (const [metric, chart] of entries) {
+		if (chart.status !== "ok") continue;
+		if (chart.values.length !== timestamps.length) ctx.addIssue({
+			code: "custom",
+			path: [
+				"series",
+				metric,
+				"values"
+			],
+			message: `series "${metric}" holds ${chart.values.length} values for ${timestamps.length} timestamps`
+		});
+		if (CHART_METRIC_UNITS[metric] !== chart.unit) ctx.addIssue({
+			code: "custom",
+			path: [
+				"series",
+				metric,
+				"unit"
+			],
+			message: `metric "${metric}" is ${CHART_METRIC_UNITS[metric]}, not ${chart.unit}`
+		});
+	}
+	const first = timestamps.at(0);
+	const last = timestamps.at(-1);
+	if (first !== void 0 && first !== window.from) ctx.addIssue({
+		code: "custom",
+		path: ["window", "from"],
+		message: `window starts at ${window.from} but the axis starts at ${first}`
+	});
+	if (last !== void 0 && last !== window.to) ctx.addIssue({
+		code: "custom",
+		path: ["window", "to"],
+		message: `window ends at ${window.to} but the axis ends at ${last}`
+	});
+	if (expectedRange !== void 0 && window.range !== expectedRange) ctx.addIssue({
+		code: "custom",
+		path: ["window", "range"],
+		message: `requested range ${expectedRange}, received ${window.range}`
+	});
+	for (let i = 0; i < timestamps.length; i += 1) {
+		const timestamp = timestamps[i];
+		if (timestamp % sampling.intervalSeconds !== 0) ctx.addIssue({
+			code: "custom",
+			path: ["timestamps", i],
+			message: `timestamp ${timestamp} is not on the ${sampling.intervalSeconds}-second grid`
+		});
+		const previous = timestamps[i - 1];
+		if (previous !== void 0 && timestamp - previous !== sampling.intervalSeconds) ctx.addIssue({
+			code: "custom",
+			path: ["timestamps", i],
+			message: `timestamps are not ${sampling.intervalSeconds} seconds apart`
+		});
+	}
+}
+/**
+* The schema one chart read is decoded with: a {@link ChartBundle} keyed by the
+* requested distinct metrics, all of them and nothing else, for the requested
+* range.
+*
+* Pinning the metrics is what upholds the `ChartBundle<Metrics>` a caller gets
+* back — a response that answers a different question fails validation rather
+* than being cast into the requested shape. The declared return type is the one
+* the key schema actually enforces, which the compiler cannot see through a
+* schema built from a runtime list.
+**/
+function chartBundleSchemaFor(metrics, range) {
+	if (metrics.length === 0) throw new RangeError("a chart read needs at least one metric");
+	if (new Set(metrics).size !== metrics.length) throw new RangeError("a chart read needs distinct metrics");
+	const literals = metrics.map((metric) => z.literal(metric));
+	return chartBundleSchemaWith(z.union(literals), range);
+}
+//#endregion
+export { chartBundleSchemaFor, chartDenominationSchema, chartMetricSchema, chartQueryCodec, chartQueryParamsSchema, chartQuerySchema, chartRangeSchema, chartSeriesSchema, chartValueSchema, chartWindowSchema, poolOpportunityChartMetricSchema, poolPositionChartMetricSchema, strategyOpportunityChartMetricSchema, strategyPositionChartMetricSchema };