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

package/dist/cjs/new-sdk/errors/NoSourceServedError.js

@@ -0,0 +1,20 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/new-sdk/errors/NoSourceServedError.ts
+/**
+* The failure of a chain no source served. It is reported in that chain's
+* metadata entry rather than thrown: the other chains of the same read may
+* still have been served.
+**/
+var NoSourceServedError = class extends AggregateError {
+	/**
+	* Chain no source served.
+	**/
+	chainId;
+	constructor(chainId, reasons) {
+		super(reasons, `no source could serve chain ${chainId}`);
+		this.name = "NoSourceServedError";
+		this.chainId = chainId;
+	}
+};
+//#endregion
+exports.NoSourceServedError = NoSourceServedError;

package/dist/cjs/new-sdk/errors/SourceChainMismatchError.js

@@ -0,0 +1,34 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let viem = require("viem");
+//#region src/new-sdk/errors/SourceChainMismatchError.ts
+/**
+* Thrown at construction when a source covers anything other than exactly the
+* chains a {@link GearboxSDK} was built for, see
+* {@link GearboxSDKOptions.networks}.
+**/
+var SourceChainMismatchError = class extends viem.BaseError {
+	name = "SourceChainMismatchError";
+	/**
+	* Source whose coverage does not match.
+	**/
+	source;
+	/**
+	* Chains the SDK covers.
+	**/
+	expected;
+	/**
+	* Chains the source covers.
+	**/
+	covered;
+	constructor(source, expected, covered) {
+		super(`The ${source} source does not cover the chains this GearboxSDK was built for.`, { metaMessages: [`Expected: ${named(expected)}`, `Covered: ${named(covered)}`] });
+		this.source = source;
+		this.expected = [...expected];
+		this.covered = [...covered];
+	}
+};
+function named(chains) {
+	return chains.join(", ") || "no chain";
+}
+//#endregion
+exports.SourceChainMismatchError = SourceChainMismatchError;

package/dist/cjs/new-sdk/errors/SourceUnavailableError.js

@@ -0,0 +1,25 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let viem = require("viem");
+//#region src/new-sdk/errors/SourceUnavailableError.ts
+/**
+* Thrown when a source branch of a namespace is read in a mode that has no such
+* source, e.g. `sdk.opportunities.onchain` in `offchain` mode.
+**/
+var SourceUnavailableError = class extends viem.BaseError {
+	name = "SourceUnavailableError";
+	/**
+	* Namespace whose branch was read.
+	**/
+	namespace;
+	/**
+	* Source this mode does not read.
+	**/
+	source;
+	constructor(namespace, source) {
+		super(`The ${namespace} namespace has no ${source} source in this mode.`);
+		this.namespace = namespace;
+		this.source = source;
+	}
+};
+//#endregion
+exports.SourceUnavailableError = SourceUnavailableError;

package/dist/cjs/new-sdk/errors/assertSameChains.js

@@ -0,0 +1,12 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_new_sdk_errors_SourceChainMismatchError = require("./SourceChainMismatchError.js");
+//#region src/new-sdk/errors/assertSameChains.ts
+/**
+* Rejects a source covering anything other than exactly the chains the SDK was
+* built for. A source is not narrowed to them: it has to name them.
+**/
+function assertSameChains(source, expected, covered) {
+	if (covered.length !== expected.length || covered.some((chain) => !expected.includes(chain))) throw new require_new_sdk_errors_SourceChainMismatchError.SourceChainMismatchError(source, expected, covered);
+}
+//#endregion
+exports.assertSameChains = assertSameChains;

package/dist/cjs/new-sdk/errors/everyChainFailed.js

@@ -0,0 +1,11 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/new-sdk/errors/everyChainFailed.ts
+/**
+* Whether a merged envelope covered chains and lost every one of them, which is
+* what makes a read a failure rather than a partial result.
+**/
+function everyChainFailed(meta) {
+	return meta.chains.length > 0 && meta.chains.every((chain) => chain.status === "error");
+}
+//#endregion
+exports.everyChainFailed = everyChainFailed;

package/dist/cjs/new-sdk/errors/index.js

@@ -0,0 +1,15 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_new_sdk_errors_AllSourcesFailedError = require("./AllSourcesFailedError.js");
+const require_new_sdk_errors_SourceChainMismatchError = require("./SourceChainMismatchError.js");
+const require_new_sdk_errors_assertSameChains = require("./assertSameChains.js");
+const require_new_sdk_errors_everyChainFailed = require("./everyChainFailed.js");
+const require_new_sdk_errors_MissingSourceError = require("./MissingSourceError.js");
+const require_new_sdk_errors_NoSourceServedError = require("./NoSourceServedError.js");
+const require_new_sdk_errors_SourceUnavailableError = require("./SourceUnavailableError.js");
+exports.AllSourcesFailedError = require_new_sdk_errors_AllSourcesFailedError.AllSourcesFailedError;
+exports.MissingSourceError = require_new_sdk_errors_MissingSourceError.MissingSourceError;
+exports.NoSourceServedError = require_new_sdk_errors_NoSourceServedError.NoSourceServedError;
+exports.SourceChainMismatchError = require_new_sdk_errors_SourceChainMismatchError.SourceChainMismatchError;
+exports.SourceUnavailableError = require_new_sdk_errors_SourceUnavailableError.SourceUnavailableError;
+exports.assertSameChains = require_new_sdk_errors_assertSameChains.assertSameChains;
+exports.everyChainFailed = require_new_sdk_errors_everyChainFailed.everyChainFailed;

package/dist/cjs/new-sdk/index.js

@@ -1,14 +1,34 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_new_sdk_types = require("./types.js");
+const require_new_sdk_errors_AllSourcesFailedError = require("./errors/AllSourcesFailedError.js");
+const require_new_sdk_errors_SourceChainMismatchError = require("./errors/SourceChainMismatchError.js");
+const require_new_sdk_errors_assertSameChains = require("./errors/assertSameChains.js");
+const require_new_sdk_errors_everyChainFailed = require("./errors/everyChainFailed.js");
+const require_new_sdk_errors_MissingSourceError = require("./errors/MissingSourceError.js");
+const require_new_sdk_errors_NoSourceServedError = require("./errors/NoSourceServedError.js");
+const require_new_sdk_errors_SourceUnavailableError = require("./errors/SourceUnavailableError.js");
+require("./errors/index.js");
 const require_new_sdk_AbstractNamespace = require("./AbstractNamespace.js");
+const require_new_sdk_utils_filterResponse = require("./utils/filterResponse.js");
+const require_new_sdk_utils_mergeChains = require("./utils/mergeChains.js");
+require("./utils/index.js");
 const require_new_sdk_opportunities_OpportunitiesNamespace = require("./opportunities/OpportunitiesNamespace.js");
 require("./opportunities/index.js");
 const require_new_sdk_positions_PositionsNamespace = require("./positions/PositionsNamespace.js");
 require("./positions/index.js");
 const require_new_sdk_GearboxSDK = require("./GearboxSDK.js");
-require("./utils/index.js");
+require("./types.js");
 exports.AbstractNamespace = require_new_sdk_AbstractNamespace.AbstractNamespace;
-exports.AllSourcesFailedError = require_new_sdk_types.AllSourcesFailedError;
+exports.AllSourcesFailedError = require_new_sdk_errors_AllSourcesFailedError.AllSourcesFailedError;
+exports.DEFAULT_MAX_OFFCHAIN_LAG = require_new_sdk_utils_mergeChains.DEFAULT_MAX_OFFCHAIN_LAG;
 exports.GearboxSDK = require_new_sdk_GearboxSDK.GearboxSDK;
+exports.MissingSourceError = require_new_sdk_errors_MissingSourceError.MissingSourceError;
+exports.NoSourceServedError = require_new_sdk_errors_NoSourceServedError.NoSourceServedError;
 exports.OpportunitiesNamespace = require_new_sdk_opportunities_OpportunitiesNamespace.OpportunitiesNamespace;
 exports.PositionsNamespace = require_new_sdk_positions_PositionsNamespace.PositionsNamespace;
+exports.SourceChainMismatchError = require_new_sdk_errors_SourceChainMismatchError.SourceChainMismatchError;
+exports.SourceUnavailableError = require_new_sdk_errors_SourceUnavailableError.SourceUnavailableError;
+exports.assertSameChains = require_new_sdk_errors_assertSameChains.assertSameChains;
+exports.everyChainFailed = require_new_sdk_errors_everyChainFailed.everyChainFailed;
+exports.filterResponse = require_new_sdk_utils_filterResponse.filterResponse;
+exports.mergeChainList = require_new_sdk_utils_mergeChains.mergeChainList;
+exports.mergeChainOne = require_new_sdk_utils_mergeChains.mergeChainOne;

package/dist/cjs/new-sdk/opportunities/OpportunitiesNamespace.js

@@ -2,120 +2,68 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_model_opportunities = require("../../model/opportunities.js");
 require("../../model/index.js");
 const require_new_sdk_AbstractNamespace = require("../AbstractNamespace.js");
+const require_new_sdk_utils_filterResponse = require("../utils/filterResponse.js");
+const require_new_sdk_utils_mergeChains = require("../utils/mergeChains.js");
+require("../utils/index.js");
 //#region src/new-sdk/opportunities/OpportunitiesNamespace.ts
 /**
-* Fields the backend owns even when the chain also fills them.
-*
-* Empty of on-chain conflicts today — every yield group here is off-chain only,
-* so onchain-first would already yield the backend's value. It is written out
-* anyway so that adding an on-chain estimate of one of them is a deliberate
-* change to this list rather than a silent regression.
-**/
-const OFFCHAIN_OWNED_FIELDS = /* @__PURE__ */ new Set(["supplyApy", "collateralApy"]);
-/**
-* The `opportunities` namespace of the combined SDK.
-*
-* A stateless router over the two sources, see {@link AbstractNamespace} for
-* the routing itself. What is specific to opportunities is the reads below and
-* the merge policy at the bottom of the class.
-*
-* The class implements the methods of every mode; {@link GearboxSDK} exposes it
-* as its mode's slice of {@link OpportunitiesByMode}, so calling a method the
-* mode does not have is a compile error rather than a runtime one.
+* The `opportunities` namespace of a {@link GearboxSDK}, see
+* {@link OpportunitiesByMode} for what each mode offers.
 **/
 var OpportunitiesNamespace = class extends require_new_sdk_AbstractNamespace.AbstractNamespace {
-	constructor(onchain, offchain, logger) {
-		super("Opportunities", onchain, offchain, logger);
+	/**
+	* {@inheritDoc OpportunitiesBase.merge}
+	**/
+	merge = {
+		list: (onchain, offchain) => require_new_sdk_utils_mergeChains.mergeChainList(onchain, offchain, this.maxOffchainLagSeconds),
+		pool: (onchain, offchain) => require_new_sdk_utils_mergeChains.mergeChainOne(onchain, offchain, this.maxOffchainLagSeconds),
+		strategy: (onchain, offchain) => require_new_sdk_utils_mergeChains.mergeChainOne(onchain, offchain, this.maxOffchainLagSeconds)
+	};
+	constructor(onchain, offchain, options) {
+		super("Opportunities", onchain?.opportunities, offchain?.opportunities, options);
 	}
 	/**
 	* {@inheritDoc OpportunitiesBase.list}
 	**/
 	async list(filter) {
-		return this.readList("list opportunities", async (sdk) => {
-			const { result, meta } = await sdk.opportunities.list(filter);
-			return {
-				value: result,
-				chains: meta
-			};
-		}, (api) => api.opportunities.list(filter));
+		return this.merged("list opportunities", {
+			fromChain: (source) => source.list(filter),
+			fromBackend: (source) => source.list(filter),
+			merge: this.merge.list
+		});
 	}
 	/**
 	* {@inheritDoc OpportunitiesBase.getPool}
 	**/
 	async getPool(key) {
-		return this.readOne("get pool opportunity", key.chainId, (sdk) => sdk.opportunities.getPool(key), (api) => api.opportunities.getPool(key));
+		return this.merged("get pool opportunity", {
+			fromChain: (source) => source.getPool(key),
+			fromBackend: (source) => source.getPool(key),
+			merge: this.merge.pool
+		});
 	}
 	/**
 	* {@inheritDoc OpportunitiesBase.getStrategy}
 	**/
 	async getStrategy(key) {
-		return this.readOne("get strategy opportunity", key.chainId, (sdk) => sdk.opportunities.getStrategy(key), (api) => api.opportunities.getStrategy(key));
-	}
-	history(key) {
-		return { chart: (metric, range) => this.#chart(key, metric, range) };
+		return this.merged("get strategy opportunity", {
+			fromChain: (source) => source.getStrategy(key),
+			fromBackend: (source) => source.getStrategy(key),
+			merge: this.merge.strategy
+		});
 	}
 	/**
-	* Reads one chart of one opportunity from the backend.
-	*
-	* The metric a caller may name is gated by the reader's type, so the kind of
-	* the key is not re-checked here.
+	* {@inheritDoc OpportunitiesBase.filter}
 	**/
-	async #chart(key, metric, range) {
-		const { result, meta } = await this.readOffchain(`get ${metric} history`, (api) => api.opportunities.getHistory({
+	filter(response, filter) {
+		return require_new_sdk_utils_filterResponse.filterResponse(response, filter, require_model_opportunities.matchesOpportunityFilter);
+	}
+	history(key) {
+		return { chart: (metric, range) => this.offchain.getHistory({
 			opportunity: key,
 			range,
 			metric
-		}), {
-			metric,
-			points: [],
-			metadata: {}
-		});
-		return {
-			data: result.points,
-			metadata: {
-				...result.metadata,
-				source: meta
-			}
-		};
-	}
-	/**
-	* Merges the two versions of one opportunity.
-	*
-	* The chain wins every field it fills; the backend fills the rest and owns
-	* {@link OFFCHAIN_OWNED_FIELDS}.
-	*
-	* The rule is onchain-first, field-wise, and never deeper than one level: a
-	* group like `totalSupply` or `supplyApy` is taken whole from one source, so
-	* a row never mixes an on-chain token amount with a backend dollar value
-	* derived from a different block.
-	**/
-	mergeOne(onchain, offchain) {
-		const merged = { ...onchain };
-		for (const [field, value] of Object.entries(offchain)) {
-			if (value === void 0) continue;
-			if (OFFCHAIN_OWNED_FIELDS.has(field) || merged[field] === void 0) merged[field] = value;
-		}
-		return merged;
-	}
-	/**
-	* Unions the two lists by canonical opportunity id.
-	*
-	* Rows present in both are merged by {@link OpportunitiesNamespace.mergeOne}.
-	* Rows only the backend knows are appended: a chain the SDK does not cover,
-	* or a market it has not loaded, is a reason to show more rather than fewer
-	* opportunities.
-	**/
-	mergeList(onchain, offchain) {
-		const byId = /* @__PURE__ */ new Map();
-		for (const row of onchain) byId.set(require_model_opportunities.opportunityId(row), row);
-		const extra = [];
-		for (const row of offchain) {
-			const id = require_model_opportunities.opportunityId(row);
-			const existing = byId.get(id);
-			if (existing) byId.set(id, this.mergeOne(existing, row));
-			else extra.push(row);
-		}
-		return [...byId.values(), ...extra];
+		}) };
 	}
 };
 //#endregion

package/dist/cjs/new-sdk/positions/PositionsNamespace.js

@@ -2,117 +2,50 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_model_positions = require("../../model/positions.js");
 require("../../model/index.js");
 const require_new_sdk_AbstractNamespace = require("../AbstractNamespace.js");
+const require_new_sdk_utils_filterResponse = require("../utils/filterResponse.js");
+const require_new_sdk_utils_mergeChains = require("../utils/mergeChains.js");
+require("../utils/index.js");
 //#region src/new-sdk/positions/PositionsNamespace.ts
 /**
-* Fields the backend owns even when the chain also fills them.
-*
-* The yield and PnL groups are derived from a position's history and from
-* incentive programs, neither of which the chain has. `targetCollateral` is
-* there for a subtler reason: the read model defines it as the collateral the
-* position was opened into, which only the backend can know, while the chain
-* approximates it with the dominant collateral held right now.
-**/
-const OFFCHAIN_OWNED_FIELDS = /* @__PURE__ */ new Set([
-	"apy",
-	"netApy",
-	"pnl",
-	"targetCollateral"
-]);
-/**
-* The `positions` namespace of the combined SDK.
-*
-* A stateless router over the two sources, see {@link AbstractNamespace} for the
-* routing itself. What is specific to positions is the reads below and the merge
-* policy at the bottom of the class.
-*
-* The class implements the methods of every mode; {@link GearboxSDK} exposes it
-* as its mode's slice of {@link PositionsByMode}, so calling a method the mode
-* does not have is a compile error rather than a runtime one.
+* The `positions` namespace of a {@link GearboxSDK}, see
+* {@link PositionsByMode} for what each mode offers.
 **/
 var PositionsNamespace = class extends require_new_sdk_AbstractNamespace.AbstractNamespace {
-	constructor(onchain, offchain, logger) {
-		super("Positions", onchain, offchain, logger);
+	/**
+	* {@inheritDoc PositionsBase.merge}
+	**/
+	merge = { list: (onchain, offchain) => require_new_sdk_utils_mergeChains.mergeChainList(onchain, offchain, this.maxOffchainLagSeconds) };
+	constructor(onchain, offchain, options) {
+		super("Positions", onchain?.positions, offchain?.positions, options);
 	}
 	/**
 	* {@inheritDoc PositionsBase.list}
 	**/
 	async list(wallet, filter) {
-		return this.readList("list positions", async (sdk) => {
-			const { result, meta } = await sdk.positions.list({
+		return this.merged("list positions", {
+			fromChain: (source) => source.list({
 				wallet,
 				filter
-			});
-			return {
-				value: result,
-				chains: meta
-			};
-		}, (api) => api.positions.list(wallet, filter));
-	}
-	history(key) {
-		return { chart: (metric, range) => this.#chart(key, metric, range) };
+			}),
+			fromBackend: (source) => source.list({
+				wallet,
+				filter
+			}),
+			merge: this.merge.list
+		});
 	}
 	/**
-	* Reads one chart of one position from the backend.
-	*
-	* The metric a caller may name is gated by the reader's type, so the kind of
-	* the key is not re-checked here.
+	* {@inheritDoc PositionsBase.filter}
 	**/
-	async #chart(key, metric, range) {
-		const { result, meta } = await this.readOffchain(`get ${metric} history`, (api) => api.positions.getHistory({
+	filter(response, filter) {
+		return require_new_sdk_utils_filterResponse.filterResponse(response, filter, require_model_positions.matchesPositionFilter);
+	}
+	history(key) {
+		return { chart: (metric, range) => this.offchain.getHistory({
 			position: key,
 			range,
 			metric
-		}), {
-			metric,
-			points: [],
-			metadata: {}
-		});
-		return {
-			data: result.points,
-			metadata: {
-				...result.metadata,
-				source: meta
-			}
-		};
-	}
-	/**
-	* Merges the two versions of one position.
-	*
-	* The chain wins every field it fills; the backend fills the rest and owns
-	* {@link OFFCHAIN_OWNED_FIELDS}.
-	*
-	* The rule is onchain-first, field-wise, and never deeper than one level: a
-	* group like `totalValue` or `apy` is taken whole from one source, so a row
-	* never mixes an on-chain token amount with a backend dollar value derived
-	* from a different block.
-	**/
-	mergeOne(onchain, offchain) {
-		const merged = { ...onchain };
-		for (const [field, value] of Object.entries(offchain)) {
-			if (value === void 0) continue;
-			if (OFFCHAIN_OWNED_FIELDS.has(field) || merged[field] === void 0) merged[field] = value;
-		}
-		return merged;
-	}
-	/**
-	* Unions the two lists by canonical position id.
-	*
-	* Rows present in both are merged by {@link PositionsNamespace.mergeOne}.
-	* Rows only the backend knows are appended: a chain the SDK does not cover,
-	* or a market it has not loaded, must not hide a position the wallet actually
-	* holds.
-	**/
-	mergeList(onchain, offchain) {
-		const byId = /* @__PURE__ */ new Map();
-		for (const row of onchain) byId.set(require_model_positions.positionId(row), row);
-		const extra = [];
-		for (const row of offchain) {
-			const id = require_model_positions.positionId(row);
-			const existing = byId.get(id);
-			if (existing) byId.set(id, this.mergeOne(existing, row));
-			else extra.push(row);
-		}
-		return [...byId.values(), ...extra];
+		}) };
 	}
 };
 //#endregion

package/dist/cjs/new-sdk/types.js

@@ -1,22 +1 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-//#region src/new-sdk/types.ts
-/**
-* Thrown when a read had sources to ask and none of them answered.
-*
-* A read that partially succeeded never throws: it returns what it has and
-* reports the rest in {@link SourceMeta}.
-**/
-var AllSourcesFailedError = class extends Error {
-	/**
-	* Outcome of every source the failed read asked.
-	**/
-	meta;
-	constructor(action, meta) {
-		const reasons = [...meta.chains.filter((c) => c.status === "error").map((c) => `${c.network}: ${c.error}`), ...meta.offchain?.status === "error" ? [`offchain: ${meta.offchain.error}`] : []];
-		super(`cannot ${action}, every source failed (${reasons.join("; ")})`);
-		this.name = "AllSourcesFailedError";
-		this.meta = meta;
-	}
-};
-//#endregion
-exports.AllSourcesFailedError = AllSourcesFailedError;

package/dist/cjs/new-sdk/utils/filterResponse.js

@@ -0,0 +1,21 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/new-sdk/utils/filterResponse.ts
+/**
+* Narrows an already-read list, rows and metadata alike. `undefined` passes
+* through, so a read still in flight stays that way.
+*
+* @typeParam T - Row type.
+* @typeParam F - Filter type.
+* @param matches - Whether one row satisfies the filter, e.g.
+*   `matchesOpportunityFilter`.
+**/
+function filterResponse(response, filter, matches) {
+	if (!response) return;
+	const chainIds = filter?.chainIds;
+	return {
+		data: response.data.filter((row) => matches(row, filter)),
+		meta: { chains: chainIds ? response.meta.chains.filter((chain) => chainIds.includes(chain.chainId)) : response.meta.chains }
+	};
+}
+//#endregion
+exports.filterResponse = filterResponse;

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

@@ -1,2 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_new_sdk_utils_filterResponse = require("./filterResponse.js");
 require("./history.js");
+const require_new_sdk_utils_mergeChains = require("./mergeChains.js");
+exports.DEFAULT_MAX_OFFCHAIN_LAG = require_new_sdk_utils_mergeChains.DEFAULT_MAX_OFFCHAIN_LAG;
+exports.filterResponse = require_new_sdk_utils_filterResponse.filterResponse;
+exports.mergeChainList = require_new_sdk_utils_mergeChains.mergeChainList;
+exports.mergeChainOne = require_new_sdk_utils_mergeChains.mergeChainOne;

package/dist/cjs/new-sdk/utils/mergeChains.js

@@ -0,0 +1,81 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_new_sdk_errors_NoSourceServedError = require("../errors/NoSourceServedError.js");
+require("../errors/index.js");
+//#region src/new-sdk/utils/mergeChains.ts
+/**
+* How many seconds the backend may lag the chain and still be used.
+**/
+const DEFAULT_MAX_OFFCHAIN_LAG = 120;
+/**
+* Merges two lists chain by chain: a chain is served by the backend when it is
+* within `maxLagSeconds` of the chain, by the chain otherwise, and reported as
+* an error when neither source succeeded.
+**/
+function mergeChainList(onchain, offchain, maxLagSeconds = 120) {
+	if (!onchain && !offchain) return;
+	const fromOnchain = /* @__PURE__ */ new Map();
+	for (const chain of onchain?.meta.chains ?? []) fromOnchain.set(chain.chainId, chain);
+	const fromOffchain = /* @__PURE__ */ new Map();
+	for (const chain of offchain?.meta.chains ?? []) fromOffchain.set(chain.chainId, chain);
+	const data = [];
+	const chains = [];
+	for (const chainId of /* @__PURE__ */ new Set([...fromOnchain.keys(), ...fromOffchain.keys()])) {
+		const onchainMeta = fromOnchain.get(chainId);
+		const offchainMeta = fromOffchain.get(chainId);
+		const winner = pickSource(onchainMeta, offchainMeta, maxLagSeconds);
+		if (winner === "onchain" && onchain && onchainMeta) {
+			data.push(...onchain.data.filter((row) => row.chainId === chainId));
+			chains.push(onchainMeta);
+		} else if (winner === "offchain" && offchain && offchainMeta) {
+			data.push(...offchain.data.filter((row) => row.chainId === chainId));
+			chains.push(offchainMeta);
+		} else chains.push(failedChain(chainId, onchainMeta, offchainMeta));
+	}
+	return {
+		data,
+		meta: { chains }
+	};
+}
+/**
+* Merges two versions of one entity under the same freshness rule as
+* {@link mergeChainList}, returning the winning response whole.
+**/
+function mergeChainOne(onchain, offchain, maxLagSeconds = 120) {
+	switch (pickSource(onchain?.meta.chains[0], offchain?.meta.chains[0], maxLagSeconds)) {
+		case "onchain": return onchain;
+		case "offchain": return offchain;
+		default: return;
+	}
+}
+/**
+* Which side serves one chain, or `undefined` when neither can.
+**/
+function pickSource(onchain, offchain, maxLagSeconds) {
+	const onchainOk = onchain?.status === "success" ? onchain : void 0;
+	const offchainOk = offchain?.status === "success" ? offchain : void 0;
+	if (onchainOk && offchainOk) return isFresh(onchainOk, offchainOk, maxLagSeconds) ? "offchain" : "onchain";
+	if (onchainOk) return "onchain";
+	if (offchainOk) return "offchain";
+}
+/**
+* Whether the backend is close enough behind the chain to be preferred.
+**/
+function isFresh(onchain, offchain, maxLagSeconds) {
+	return offchain.timestamp >= onchain.timestamp - maxLagSeconds;
+}
+/**
+* Metadata for a chain neither source served.
+**/
+function failedChain(chainId, onchain, offchain) {
+	if (!onchain || !offchain) return onchain ?? offchain;
+	const reasons = [onchain, offchain].map((chain) => chain.status === "error" ? chain.error : void 0).filter((reason) => !!reason);
+	return {
+		chainId,
+		status: "error",
+		error: reasons.length === 1 ? reasons[0] : new require_new_sdk_errors_NoSourceServedError.NoSourceServedError(chainId, reasons)
+	};
+}
+//#endregion
+exports.DEFAULT_MAX_OFFCHAIN_LAG = DEFAULT_MAX_OFFCHAIN_LAG;
+exports.mergeChainList = mergeChainList;
+exports.mergeChainOne = mergeChainOne;

package/dist/cjs/new-sdk/utils/types.js

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