@gearbox-protocol/sdk 18.1.0 → 18.2.0-next.10

package/dist/cjs/permissionless/api/oracles/PermissionlessOracles.js

@@ -1,19 +1,48 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_onchain_chain_chains = require("../../../onchain/chain/chains.js");
+const require_onchain_constants_address_provider = require("../../../onchain/constants/address-provider.js");
+const require_model_opportunities_schema = require("../../../model/opportunities.schema.js");
+const require_abi_compressors_priceFeedCompressor = require("../../../abi/compressors/priceFeedCompressor.js");
+require("../../../onchain/index.js");
 const require_offchain_AbstractOffchainNamespace = require("../../../offchain/AbstractOffchainNamespace.js");
+require("../../deployment/addresses.js");
+const require_permissionless_bindings_address_provider = require("../../bindings/address-provider.js");
 const require_permissionless_utils_price_update_get_prices = require("../../utils/price-update/get-prices.js");
+const require_permissionless_api_oracles_enrich = require("./enrich.js");
 const require_permissionless_api_oracles_schemas = require("./schemas.js");
+let viem = require("viem");
 //#region src/permissionless/api/oracles/PermissionlessOracles.ts
 const GET_PRICES_GAS_LIMIT_BY_CHAIN_ID = { 143: 100000000n };
 const GET_PRICES_CHUNK_SIZE = 200;
 /**
+* What a market slot is: an oracle, a token, and whether it is the reserve
+* one. Not the market — a market that has switched oracles has rows under
+* each, and the slots are the old oracle's and the new one's separately.
+*/
+function slotKey(oracle, token, reserve) {
+	return `${oracle.toLowerCase()}:${token.toLowerCase()}:${reserve}`;
+}
+/** An unknown thrown value, as something a log line can carry. */
+function describe(e) {
+	return e instanceof Error ? e.message : String(e);
+}
+/**
 * The price feeds of one chain: the PriceFeedStore as the backend has indexed
 * it, and the prices behind it.
 *
 * ```ts
 * const store = await permissionless.oracles.store({ chainId: 1 });
-* const { prices } = await permissionless.oracles.prices({ chainId: 1 });
+* const prices = await permissionless.oracles.getPrices(
+*   store.priceFeeds.map(({ address }) => ({ chainId: 1, address })),
+* );
 * ```
 *
+* The backend answers what it has indexed; anything that is only true at a
+* block — a price, a market cap, a quota in one currency, the period an
+* oracle holds for a slot — is read here, off the chain, and folded into what
+* it answered. That is why these reads mix a request with a multicall rather
+* than being either one.
+*
 * Read-only. What the store carries is decided on chain, so putting a feed
 * there is a batch the instance owner executes — see
 * {@link InstanceOwnerTransactions} — not a row a client writes here.
@@ -29,53 +58,440 @@ var PermissionlessOracles = class extends require_offchain_AbstractOffchainNames
 	}
 	/**
 	* The store with the assets and feeds of one chain.
+	*
+	* {@link stores} narrowed to one and unwrapped, which is the whole of it:
+	* there is one route either way, and a chain the backend does not serve has
+	* no store to answer with rather than an empty one.
+	*
+	* @throws When the backend serves no store for the chain.
 	**/
 	async store({ chainId }) {
+		const [store] = await this.stores({ chainId });
+		if (!store) throw new Error(`no PriceFeedStore served for chain ${chainId}`);
+		return store;
+	}
+	/**
+	* The same stores for every chain the backend serves.
+	*
+	* One request rather than {@link store} per chain, which is what a page
+	* showing all of them would otherwise do: the backend assembles them in the
+	* same few queries it assembles one in, so the chains cost little more than
+	* the largest of them.
+	*
+	* Each entry names its own chain, so a store is never attributed by
+	* position. `chainId` narrows it to one, for a caller that wants the list
+	* shape either way.
+	*
+	* ```ts
+	* const stores = await permissionless.oracles.stores();
+	* ```
+	**/
+	async stores({ chainId } = {}) {
 		return this.getData({
-			path: `/pfs/${chainId}`,
-			schema: require_permissionless_api_oracles_schemas.priceFeedStoreSchema
+			path: "/pfs/stores",
+			query: { chainId: chainId?.toString() },
+			schema: require_permissionless_api_oracles_schemas.priceFeedStoresSchema
+		});
+	}
+	/**
+	* One feed of the store: what it is, which assets it may price, and which
+	* market slots it currently fills.
+	*
+	* Singular where {@link store} is plural, and not a filter over it: the
+	* store answers what a list renders, while this answers what a feed is used
+	* for, which the store does not carry at all.
+	*
+	* ```ts
+	* const { priceFeed, markets } = await permissionless.oracles.feed({
+	*   chainId: 1,
+	*   address: feed,
+	* });
+	* ```
+	*
+	* Each market row also carries the staleness period that market's own
+	* oracle holds for the slot, read off the chain here — see
+	* {@link PermissionlessPriceFeedMarket.marketStalenessPeriod}.
+	*
+	* @throws When the store does not carry the feed. A private draft is not
+	* here — it lives in whichever app wrote it.
+	**/
+	async feed({ chainId, address }) {
+		const feed = address.toLowerCase();
+		const indexed = await this.getData({
+			path: `/pfs/${chainId}/price-feed/${address}`,
+			schema: require_permissionless_api_oracles_schemas.priceFeedDetailsSchema
 		});
+		const periods = await this.#stalenessPeriods(chainId, feed, indexed.markets);
+		return {
+			...indexed,
+			markets: indexed.markets.map((market) => ({
+				...market,
+				marketStalenessPeriod: periods.get(slotKey(market.priceOracle, market.token, market.reserve)) ?? null
+			}))
+		};
 	}
 	/**
-	* A price per feed, and a market cap per feed and asset. The feeds the
-	* indexer has not seen are read off the chain by the backend, so the store
-	* is priced whole.
+	* Staleness period each market's own oracle holds for the feed's slots,
+	* keyed by {@link slotKey}.
+	*
+	* One call per oracle rather than per slot: the compressor answers for a
+	* whole oracle at once, and a feed in a dozen markets of the same curator
+	* would otherwise pay a round trip per token. Scoped to the tokens actually
+	* asked about, since the unscoped overload returns the oracle's entire feed
+	* tree as well.
+	*
+	* Failures are warnings and not errors. A slot missing from the answer keeps
+	* its `null`, which the caller reports as "the oracle would not say" — the
+	* alternative is failing a read whose indexed half is perfectly good.
+	*/
+	async #stalenessPeriods(chainId, feed, rows) {
+		const periods = /* @__PURE__ */ new Map();
+		if (rows.length === 0) return periods;
+		const tokensByOracle = /* @__PURE__ */ new Map();
+		for (const row of rows) {
+			let tokens = tokensByOracle.get(row.priceOracle);
+			if (!tokens) {
+				tokens = /* @__PURE__ */ new Set();
+				tokensByOracle.set(row.priceOracle, tokens);
+			}
+			tokens.add(row.token);
+		}
+		let client;
+		let compressor;
+		try {
+			client = this.#chains.client(chainId);
+			compressor = await new require_permissionless_bindings_address_provider.AddressProviderContract("0xF7f0a609BfAb9a0A98786951ef10e5FE26cC1E38", client).getLatestVersionAddress(require_onchain_constants_address_provider.AP_PRICE_FEED_COMPRESSOR);
+		} catch (e) {
+			this.logger?.warn(`no PriceFeedCompressor for chain ${chainId}, reporting no market staleness periods: ${describe(e)}`);
+			return periods;
+		}
+		const oracles = [...tokensByOracle.keys()];
+		const results = await client.multicall({
+			contracts: oracles.map((oracle) => ({
+				address: compressor,
+				abi: require_abi_compressors_priceFeedCompressor.priceFeedCompressorAbi,
+				functionName: "getPriceOracleState",
+				args: [oracle, [...tokensByOracle.get(oracle) ?? []]]
+			})),
+			allowFailure: true
+		});
+		oracles.forEach((oracle, i) => {
+			const result = results[i];
+			if (result?.status !== "success") {
+				this.logger?.warn(`price oracle ${oracle} of chain ${chainId} would not report its feed map`);
+				return;
+			}
+			const { priceFeedMap } = result.result;
+			for (const entry of priceFeedMap) {
+				if (entry.priceFeed.toLowerCase() !== feed) continue;
+				periods.set(slotKey(oracle, entry.token, entry.reserve), Number(entry.stalenessPeriod));
+			}
+		});
+		return periods;
+	}
+	/**
+	* One asset of the store: the feeds allowed for it, and the markets that
+	* take it as collateral.
+	*
+	* The mirror of {@link feed}, and the call to reach for when the question is
+	* "what prices this token and what is it backing" rather than "where is this
+	* feed used". Both read the same market slots; which end they are indexed
+	* from is the difference.
+	*
+	* ```ts
+	* const { priceFeeds, markets, quotaUsedUsd } =
+	*   await permissionless.oracles.asset({ chainId: 1, address: token });
+	* ```
+	*
+	* The quota totals are worked out here, over the very market rows this
+	* answers with — see {@link PermissionlessQuotaTotals}.
+	*
+	* @throws When the chain has no metadata for the address. An asset nothing
+	* was indexed for has no symbol or decimals, so there is no row to answer.
 	**/
-	async prices({ chainId }) {
-		return this.getData({
-			path: `/pfs/${chainId}/prices`,
-			schema: require_permissionless_api_oracles_schemas.pricesSchema
+	async asset({ chainId, address }) {
+		const indexed = await this.getData({
+			path: `/pfs/${chainId}/asset/${address}`,
+			schema: require_permissionless_api_oracles_schemas.assetDetailsSchema
 		});
+		const priceOf = await this.#underlyingPrices(indexed.markets.map((market) => ({
+			chainId,
+			underlyingPriceFeed: market.underlyingPriceFeed
+		})));
+		return {
+			...indexed,
+			...require_permissionless_api_oracles_enrich.totalQuotas(indexed.markets, (feed) => priceOf(chainId, feed))
+		};
+	}
+	/**
+	* The price of every underlying the given quota rows name, looked up by
+	* chain and feed.
+	*
+	* Distinct feeds only, because an asset in a dozen markets of the same
+	* underlying names the same feed a dozen times, and a list of every chain's
+	* assets names a handful of feeds per chain between them all.
+	*/
+	async #underlyingPrices(rows) {
+		const refs = /* @__PURE__ */ new Map();
+		for (const { chainId, underlyingPriceFeed } of rows) {
+			if (underlyingPriceFeed === null) continue;
+			const address = underlyingPriceFeed.toLowerCase();
+			refs.set(require_permissionless_api_oracles_enrich.feedKey(chainId, address), {
+				chainId,
+				address
+			});
+		}
+		const prices = require_permissionless_api_oracles_enrich.pricesByFeed(await this.getPrices([...refs.values()]));
+		return (chainId, feed) => prices.get(require_permissionless_api_oracles_enrich.feedKey(chainId, feed));
 	}
 	/**
-	* The price each of the named feeds reports, read off the chain.
+	* Every asset the store carries, with what its markets make of it.
+	*
+	* Enough on its own to render a list of assets: the alternative is the
+	* store's whole read for the names plus a call per row for the quotas, and
+	* this is one request either way you scope it.
 	*
-	* Where {@link prices} answers for the store as a whole and at whatever
-	* moment the backend priced it, this prices exactly the feeds asked for, at
-	* the current block. A feed the store does not carry prices the same way,
-	* which is what makes this the call to reach for after a deploy, or while a
-	* form is still choosing between candidates.
+	* Ordered by how central each asset is — the markets it underlies first,
+	* then what is quoted against it, then what it is allowed — so a consumer
+	* renders the rows as they arrive. Omit `chainId` for every chain the
+	* backend serves, ordered the same way across all of them.
 	*
-	* Feeds needing a fresh answer before they can be read are updated inside
-	* the same simulation, so a push-based feed prices as readily as a
-	* pull-based one. `null` is a feed whose read reverted, not a zero.
+	* Each row also carries its quota totals and what this SDK's tables say the
+	* asset is, neither of which is served — see
+	* {@link PermissionlessAssetSummary}. The totals are what the last two terms
+	* of the order are over, so this waits for them rather than handing back a
+	* list that would reshuffle a moment later.
 	*
 	* ```ts
-	* const prices = await permissionless.oracles.getPrices({
+	* const assets = await permissionless.oracles.assets({ chainId: 1 });
+	* const everywhere = await permissionless.oracles.assets();
+	* ```
+	**/
+	async assets({ chainId } = {}) {
+		const indexed = await this.getData({
+			path: "/pfs/assets",
+			query: { chainId: chainId?.toString() },
+			schema: require_permissionless_api_oracles_schemas.assetSummariesSchema
+		});
+		const networks = /* @__PURE__ */ new Map();
+		for (const { chainId: id } of indexed) if (!networks.has(id)) networks.set(id, require_onchain_chain_chains.isSupportedNetwork(id) ? require_onchain_chain_chains.getNetworkType(id) : void 0);
+		const priceOf = await this.#underlyingPrices(indexed.flatMap((asset) => asset.marketQuotas.map((quota) => ({
+			chainId: asset.chainId,
+			underlyingPriceFeed: quota.underlyingPriceFeed
+		}))));
+		return indexed.map((asset) => {
+			const network = networks.get(asset.chainId);
+			return {
+				...asset,
+				...require_permissionless_api_oracles_enrich.totalQuotas(asset.marketQuotas, (feed) => priceOf(asset.chainId, feed)),
+				assetType: network === void 0 ? null : require_onchain_chain_chains.getAssetType(asset.address, network) ?? null,
+				isRwa: network === void 0 ? false : require_onchain_chain_chains.isRWAToken(asset.address, network)
+			};
+		}).sort(require_permissionless_api_oracles_enrich.byCentrality);
+	}
+	/**
+	* The feeds one feed reads from, recursively.
+	*
+	* Answers for any feed the chain has indexed, store member or not: a
+	* composite feed's children are rarely in the store themselves, and a tree
+	* that stopped at the first of them would not be one.
+	*
+	* ```ts
+	* const tree = await permissionless.oracles.dependencies({
 	*   chainId: 1,
-	*   priceFeeds: [feed],
+	*   address: feed,
 	* });
 	* ```
+	**/
+	async dependencies({ chainId, address }) {
+		return this.getData({
+			path: `/pfs/${chainId}/price-feed/${address}/graph`,
+			schema: require_model_opportunities_schema.priceFeedDataSchema
+		});
+	}
+	/**
+	* What the named feeds price, read off the chain.
+	*
+	* Prices exactly what is asked for, at the current block, across as many
+	* chains as the list names — one read per chain, so a screen listing every
+	* chain's feeds pays per chain and not per row. A feed the store does not
+	* carry prices the same way, which is what makes this the call to reach for
+	* after a deploy, or while a form is still choosing between candidates.
+	*
+	* Read in two passes. The first asks every feed what it reports as it
+	* stands, which is one multicall per chain; a feed that will not answer
+	* until it has been given a fresh one is then priced inside a simulation
+	* that updates it first, so a push-based feed prices as readily as a
+	* pull-based one. The second pass costs an `OnchainSDK` to attach, hence
+	* only the feeds that need it rather than all of them.
+	*
+	* `null` is a feed neither pass could read, and a chain with no client
+	* configured is every one of its feeds reading `null` rather than a failed
+	* call — the figures built on them are floors either way.
+	*
+	* ```ts
+	* const [{ price }] = await permissionless.oracles.getPrices([
+	*   { chainId: 1, address: feed },
+	* ]);
+	* ```
 	*
-	* @returns A price per feed, in the 8 decimals every Gearbox feed reports.
+	* @returns One entry per feed asked for, in the order asked, each price in
+	* the 8 decimals every Gearbox feed reports.
 	**/
-	async getPrices({ chainId, priceFeeds }) {
-		return require_permissionless_utils_price_update_get_prices.getPrices({
-			client: this.#chains.client(chainId),
-			priceFeeds,
-			chunkSize: 200,
-			gasLimit: GET_PRICES_GAS_LIMIT_BY_CHAIN_ID[chainId]
+	async getPrices(feeds) {
+		const byChain = /* @__PURE__ */ new Map();
+		for (const { chainId, address } of feeds) {
+			const addresses = byChain.get(chainId) ?? /* @__PURE__ */ new Set();
+			addresses.add(address.toLowerCase());
+			byChain.set(chainId, addresses);
+		}
+		const chainIds = [...byChain.keys()];
+		const results = await Promise.all(chainIds.map((chainId) => this.#pricesOf(chainId, [...byChain.get(chainId) ?? []])));
+		const prices = new Map(chainIds.map((id, i) => [id, results[i] ?? {}]));
+		return feeds.map(({ chainId, address }) => ({
+			chainId,
+			address,
+			price: prices.get(chainId)?.[address.toLowerCase()] ?? null
+		}));
+	}
+	/** One chain's half of {@link getPrices}: the cheap pass, then the rest. */
+	async #pricesOf(chainId, priceFeeds) {
+		let client;
+		try {
+			client = this.#chains.client(chainId);
+		} catch (e) {
+			this.logger?.warn(`chain ${chainId} has no client, reporting its ${priceFeeds.length} feed(s) unpriced: ${describe(e)}`);
+			return {};
+		}
+		let prices;
+		try {
+			prices = await require_permissionless_utils_price_update_get_prices.getLatestPrices({
+				client,
+				priceFeeds
+			});
+		} catch (e) {
+			this.logger?.warn(`chain ${chainId} would not answer for its ${priceFeeds.length} feed(s), trying each with an update: ${describe(e)}`);
+			prices = {};
+		}
+		const stale = priceFeeds.filter((feed) => (prices[feed] ?? null) === null);
+		if (stale.length === 0) return prices;
+		try {
+			return {
+				...prices,
+				...await require_permissionless_utils_price_update_get_prices.getPrices({
+					client,
+					priceFeeds: stale,
+					chunkSize: 200,
+					gasLimit: GET_PRICES_GAS_LIMIT_BY_CHAIN_ID[chainId]
+				})
+			};
+		} catch (e) {
+			this.logger?.warn(`chain ${chainId} would not price ${stale.length} of its feed(s) even with an update, reporting them unpriced: ${describe(e)}`);
+			return prices;
+		}
+	}
+	/**
+	* What one chain's feeds value one chain's assets at: `price × totalSupply`
+	* per pair.
+	*
+	* Asked from whichever side the caller is looking at — one asset through
+	* each of its feeds, or one feed over each of the assets it prices — because
+	* a screen shows one row per feed or one row per asset, never the full
+	* cross product. Both answer the same pairs in the same shape.
+	*
+	* Two reads per chain: the prices, and one multicall for the assets'
+	* supplies and decimals. Several scopes can be asked at once, which is how a
+	* table of every asset's feeds pays per chain rather than per row; the pairs
+	* come back in the order the scopes named them. A pair neither read could
+	* resolve has a `null` cap, which is not a zero.
+	*
+	* ```ts
+	* const caps = await permissionless.oracles.getMarketCap({
+	*   chainId: 1,
+	*   asset: token,
+	*   priceFeeds: [main, reserve],
+	* });
+	* ```
+	**/
+	async getMarketCap(scope) {
+		const pairs = (Array.isArray(scope) ? scope : [scope]).flatMap((one) => "asset" in one ? one.priceFeeds.map((priceFeed) => ({
+			chainId: one.chainId,
+			priceFeed: priceFeed.toLowerCase(),
+			asset: one.asset.toLowerCase()
+		})) : one.assets.map((asset) => ({
+			chainId: one.chainId,
+			priceFeed: one.priceFeed.toLowerCase(),
+			asset: asset.toLowerCase()
+		})));
+		if (pairs.length === 0) return [];
+		const feeds = /* @__PURE__ */ new Map();
+		const assetsByChain = /* @__PURE__ */ new Map();
+		for (const { chainId, priceFeed, asset } of pairs) {
+			feeds.set(require_permissionless_api_oracles_enrich.feedKey(chainId, priceFeed), {
+				chainId,
+				address: priceFeed
+			});
+			const assets = assetsByChain.get(chainId) ?? /* @__PURE__ */ new Set();
+			assets.add(asset);
+			assetsByChain.set(chainId, assets);
+		}
+		const chainIds = [...assetsByChain.keys()];
+		const [prices, perChain] = await Promise.all([this.getPrices([...feeds.values()]), Promise.all(chainIds.map((chainId) => this.#supplies(chainId, [...assetsByChain.get(chainId) ?? []])))]);
+		const priced = require_permissionless_api_oracles_enrich.pricesByFeed(prices);
+		const supplies = new Map(chainIds.map((id, i) => [id, perChain[i]]));
+		return pairs.map(({ chainId, priceFeed, asset }) => {
+			const supply = supplies.get(chainId)?.get(asset);
+			return {
+				chainId,
+				priceFeed,
+				asset,
+				cap: supply === void 0 ? null : require_permissionless_api_oracles_enrich.toCap(priced.get(require_permissionless_api_oracles_enrich.feedKey(chainId, priceFeed)), supply.totalSupply, supply.decimals)
+			};
+		});
+	}
+	/**
+	* Each asset's supply and the decimals it is counted in, which is what turns
+	* a supply into an amount.
+	*
+	* Both read rather than one of them taken from the index, so that a cap can
+	* be asked for an address nothing was indexed for at all — a token a form is
+	* still choosing, say. An asset missing from the answer is left out, and
+	* caps over it come back `null`.
+	*/
+	async #supplies(chainId, assets) {
+		const supplies = /* @__PURE__ */ new Map();
+		let client;
+		try {
+			client = this.#chains.client(chainId);
+		} catch (e) {
+			this.logger?.warn(`chain ${chainId} has no client, reporting no market caps: ${describe(e)}`);
+			return supplies;
+		}
+		const results = await client.multicall({
+			contracts: assets.flatMap((address) => [{
+				address,
+				abi: viem.erc20Abi,
+				functionName: "totalSupply"
+			}, {
+				address,
+				abi: viem.erc20Abi,
+				functionName: "decimals"
+			}]),
+			allowFailure: true
+		});
+		assets.forEach((address, i) => {
+			const supply = results[2 * i];
+			const decimals = results[2 * i + 1];
+			if (decimals?.status !== "success") {
+				this.logger?.warn(`asset ${address} of chain ${chainId} would not report its decimals, reporting no market cap for it`);
+				return;
+			}
+			supplies.set(address, {
+				totalSupply: supply?.status === "success" ? supply.result : null,
+				decimals: Number(decimals.result)
+			});
 		});
+		return supplies;
 	}
 };
 //#endregion

package/dist/cjs/permissionless/api/oracles/enrich.js

@@ -0,0 +1,99 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let viem = require("viem");
+//#region src/permissionless/api/oracles/enrich.ts
+/**
+* What the oracles namespace works out for itself once the backend has
+* answered.
+*
+* All of it used to be the backend's, and all of it needs the chain: a quota
+* is denominated in its market's own underlying and a market cap is a supply
+* times a price, so none of these can be indexed — they can only be read at
+* the block the reader is on. Keeping them here means one description of each
+* rule rather than one per service that wants it, and a backend that holds no
+* viem client at all.
+**/
+/** Identifies a feed across chains, since an address alone does not. */
+function feedKey(chainId, address) {
+	return `${chainId}:${address.toLowerCase()}`;
+}
+/** Prices looked up the way {@link totalQuotas} and the caps need them. */
+function pricesByFeed(prices) {
+	return new Map(prices.map(({ chainId, address, price }) => [feedKey(chainId, address), price]));
+}
+/**
+* The asset's quota across its markets, totalled in USD.
+*
+* Each market's figures are converted at the price that market's own oracle
+* holds for its underlying, which is the same number that market's accounting
+* uses.
+*
+* Limits count only the markets still running, because a shut down market's
+* limit is not borrowable; what is already quoted counts everywhere, because
+* debt outstanding is exposure either way. A market whose underlying could not
+* be priced is skipped, which makes both figures floors, and `null` is nothing
+* to total rather than a zero.
+*
+* @param priceOf - The price each underlying feed reports, in the 8 decimals
+* every Gearbox feed uses.
+*/
+function totalQuotas(quotas, priceOf) {
+	let limit = 0;
+	let used = 0;
+	let anyLimit = false;
+	let anyUsed = false;
+	for (const quota of quotas) {
+		const raw = quota.underlyingPriceFeed === null ? null : priceOf(quota.underlyingPriceFeed);
+		if (raw === null || raw === void 0) continue;
+		const price = Number((0, viem.formatUnits)(raw, 8));
+		if (quota.quotaUsed !== null) {
+			used += quota.quotaUsed * price;
+			anyUsed = true;
+		}
+		if (quota.quotaLimit !== null && !quota.isShutdown) {
+			limit += quota.quotaLimit * price;
+			anyLimit = true;
+		}
+	}
+	return {
+		quotaLimitUsd: anyLimit ? limit : null,
+		quotaUsedUsd: anyUsed ? used : null
+	};
+}
+/**
+* What one feed values one asset's supply at: `price × totalSupply`.
+*
+* Multiplied as integers and formatted once, rather than through two floats:
+* an 8-decimal price times an 18-decimal supply loses its small end to a JS
+* number long before it loses the large one, and the figure is a total rather
+* than an estimate.
+*
+* `null` if either side could not be read — an asset nobody could price is
+* not an asset worth nothing.
+*/
+function toCap(price, totalSupply, decimals) {
+	if (price === null || price === void 0 || totalSupply === null || totalSupply === void 0) return null;
+	return (0, viem.formatUnits)(price * totalSupply, 8 + decimals);
+}
+/** Larger first, with `null` after every figure including a real zero. */
+function descending(a, b) {
+	return (b ?? -1) - (a ?? -1);
+}
+/**
+* Assets ordered the way a reader scans them: what the protocol is built on
+* first, then what is actually borrowed against it, then what it is merely
+* allowed to be borrowed against.
+*
+* Applied here and not by the backend because the two middle terms are the
+* converted quotas, which only exist once the chain has been read. The
+* backend orders by the first term and the tie-breakers, so a caller reading
+* the route directly still gets a stable order; this refines it.
+*/
+function byCentrality(a, b) {
+	return b.underlyingMarketCount - a.underlyingMarketCount || descending(a.quotaUsedUsd, b.quotaUsedUsd) || descending(a.quotaLimitUsd, b.quotaLimitUsd) || a.symbol.localeCompare(b.symbol) || a.address.localeCompare(b.address) || a.chainId - b.chainId;
+}
+//#endregion
+exports.byCentrality = byCentrality;
+exports.feedKey = feedKey;
+exports.pricesByFeed = pricesByFeed;
+exports.toCap = toCap;
+exports.totalQuotas = totalQuotas;