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

package/dist/cjs/abi/iExpirable.js

@@ -0,0 +1,15 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/abi/iExpirable.ts
+const iExpirableAbi = [{
+	type: "function",
+	inputs: [],
+	name: "isExpired",
+	outputs: [{
+		name: "",
+		internalType: "bool",
+		type: "bool"
+	}],
+	stateMutability: "view"
+}];
+//#endregion
+exports.iExpirableAbi = iExpirableAbi;

package/dist/cjs/common-utils/utils/apy/get-single-quota-borrow-rate.js

@@ -5,6 +5,8 @@ const require_common_utils_utils_creditAccount_calc_quota_borrow_rate = require(
 /**
 * Under the hood sums up rates for all given quotas and then multiplies them by 1+feeInterest,
 * but it is expected that the ONLY quota will be passed
+*
+* @deprecated Use `calcBorrowRate` from `sdk/positions` instead.
 */
 function getSingleQuotaBorrowRate(props) {
 	const qr = require_common_utils_utils_creditAccount_calc_quota_borrow_rate.calcQuotaBorrowRate(props);

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

@@ -1,10 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_sdk_utils_bigint_math = require("../../../sdk/utils/bigint-math.js");
-const require_sdk_constants_math = require("../../../sdk/constants/math.js");
-require("../../../sdk/index.js");
-const require_common_utils_utils_price_math = require("../price-math.js");
+const require_sdk_positions_calcHealthFactor = require("../../../sdk/positions/calcHealthFactor.js");
 //#region src/common-utils/utils/creditAccount/calc-health-factor.ts
-const MAX_UINT16 = 65535;
 /**
 * Computes account health factor in percentage-factor units.
 *
@@ -15,25 +11,31 @@ const MAX_UINT16 = 65535;
 * @param props Credit account balances, quotas, prices, thresholds, and debt context.
 * @returns Health factor as a number in `PERCENTAGE_FACTOR` scale,
 * or `65535` when debt is zero.
+*
+* @deprecated Use `calcHealthFactor` from `sdk/positions` instead; this
+* wrapper only maps the legacy props onto an `AccountSnapshot`.
 */
 function calcHealthFactor({ assets, quotas, quotasInfo, liquidationThresholds, underlyingToken, debt, prices, tokensList }) {
-	if (debt === 0n) return MAX_UINT16;
-	const underlyingDecimals = tokensList[underlyingToken]?.decimals || 18;
-	const underlyingPrice = prices[underlyingToken] || 0n;
-	const assetMoney = assets.reduce((acc, { token: tokenAddress, balance: amount }) => {
-		const tokenDecimals = tokensList[tokenAddress]?.decimals || 18;
-		const lt = liquidationThresholds[tokenAddress] || 0n;
-		const price = prices[tokenAddress] || 0n;
-		const tokenLtMoney = require_common_utils_utils_price_math.PriceUtils.calcTotalPrice(price, amount, tokenDecimals) * lt / require_sdk_constants_math.PERCENTAGE_FACTOR;
-		const { isActive = false } = quotasInfo?.[tokenAddress] || {};
-		const quota = quotas[tokenAddress];
-		const quotaBalance = isActive ? quota?.balance || 0n : 0n;
-		const quotaMoney = require_common_utils_utils_price_math.PriceUtils.calcTotalPrice(underlyingPrice, quotaBalance, underlyingDecimals);
-		return acc + (quota ? require_sdk_utils_bigint_math.BigIntMath.min(quotaMoney, tokenLtMoney) : tokenLtMoney);
-	}, 0n);
-	const borrowedMoney = require_common_utils_utils_price_math.PriceUtils.calcTotalPrice(underlyingPrice || require_sdk_constants_math.PRICE_DECIMALS, debt, underlyingDecimals);
-	const hfInPercent = borrowedMoney > 0n ? assetMoney * require_sdk_constants_math.PERCENTAGE_FACTOR / borrowedMoney : 0n;
-	return Number(hfInPercent);
+	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);
+	const activeQuotas = {};
+	for (const [token, info] of Object.entries(quotasInfo)) if (info?.isActive) activeQuotas[token] = true;
+	return require_sdk_positions_calcHealthFactor.calcHealthFactor({
+		snapshot: {
+			creditManager: underlyingToken,
+			assets,
+			quotas: Object.values(quotas),
+			totalDebt: debt,
+			totalValue: 0n
+		},
+		underlying: underlyingToken,
+		decimals,
+		prices,
+		liquidationThresholds: lts,
+		activeQuotas
+	});
 }
 //#endregion
 exports.calcHealthFactor = calcHealthFactor;

package/dist/cjs/common-utils/utils/creditAccount/calc-quota-borrow-rate.js

@@ -9,6 +9,8 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 *
 * @param props Quota balances and per-token quota rates.
 * @returns Sum of `balance * rate` terms in percentage-factor scale.
+*
+* @deprecated Use `calcBorrowRate` from `sdk/positions` instead.
 */
 function calcQuotaBorrowRate({ quotas, quotaRates }) {
 	return Object.values(quotas).reduce((acc, { token, balance }) => {

package/dist/cjs/common-utils/utils/creditAccount/get-time-to-liquidation.js

@@ -1,6 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_sdk_constants_math = require("../../../sdk/constants/math.js");
-require("../../../sdk/index.js");
+const require_sdk_positions_calcTimeToLiquidationMs = require("../../../sdk/positions/calcTimeToLiquidationMs.js");
 //#region src/common-utils/utils/creditAccount/get-time-to-liquidation.ts
 /**
 * Estimates time remaining until health factor reaches liquidation level.
@@ -9,13 +8,17 @@ require("../../../sdk/index.js");
 * and returns a millisecond duration until `healthFactor` decays to `1.0`
 * (`PERCENTAGE_FACTOR` in internal scale).
 *
-* @param props Current health factor and `totalBorrowRate * debt` term.
+* @param props Current health factor and `totalBorrowRate_debt`, both `Bps`
+* (`10000` = 100%) — not the legacy `PERCENTAGE_FACTOR_1KK` (`1_000_000` =
+* 100%) scale the pre-rewrite frontend fed this under the same name.
 * @returns Milliseconds to liquidation as `bigint`, or `null` when already at/under
 * liquidation threshold or when borrow-rate exposure is zero.
+*
+* @deprecated Use `calcTimeToLiquidationMs` from `sdk/positions` instead;
+* this wrapper only forwards to the new implementation.
 */
 function getTimeToLiquidation({ healthFactor, totalBorrowRate_debt }) {
-	if (healthFactor <= 10000n || totalBorrowRate_debt === 0n) return null;
-	return (BigInt(healthFactor) - require_sdk_constants_math.PERCENTAGE_FACTOR) * (BigInt(require_sdk_constants_math.SECONDS_PER_YEAR) * require_sdk_constants_math.PERCENTAGE_FACTOR * require_sdk_constants_math.PERCENTAGE_DECIMALS / totalBorrowRate_debt) * 1000n / require_sdk_constants_math.PERCENTAGE_FACTOR;
+	return require_sdk_positions_calcTimeToLiquidationMs.calcTimeToLiquidationMs(healthFactor, totalBorrowRate_debt);
 }
 //#endregion
 exports.getTimeToLiquidation = getTimeToLiquidation;

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

@@ -1,6 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_sdk_constants_math = require("../../../sdk/constants/math.js");
-require("../../../sdk/index.js");
+const require_sdk_positions_calcLiquidationPriceForTarget = require("../../../sdk/positions/calcLiquidationPriceForTarget.js");
 //#region src/common-utils/utils/creditAccount/liquidation-price.ts
 /**
 * Calculates target token liquidation price for a credit account.
@@ -13,17 +12,28 @@ require("../../../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) / require_sdk_constants_math.PERCENTAGE_FACTOR) * require_sdk_constants_math.WAD / 10n ** BigInt(underlyingDecimals);
-	const targetDecimals = tokensList[targetToken]?.decimals || 18;
-	const { balance: targetBalance = 0n } = assets[targetToken] || {};
-	const effectiveTargetBalance = targetBalance * require_sdk_constants_math.WAD / 10n ** BigInt(targetDecimals);
-	const lpLT = liquidationThresholds[targetToken] || 0n;
-	if (targetBalance <= 0n || lpLT <= 0n) return 0n;
-	return effectiveDebt * require_sdk_constants_math.PRICE_DECIMALS * require_sdk_constants_math.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 require_sdk_positions_calcLiquidationPriceForTarget.calcLiquidationPriceForTarget({
+		snapshot: {
+			creditManager: underlyingToken,
+			assets: Object.values(assets),
+			quotas: [],
+			totalDebt: debt,
+			totalValue: 0n
+		},
+		targetToken,
+		underlying: underlyingToken,
+		decimals,
+		liquidationThresholds: lts
+	});
 }
 //#endregion
 exports.liquidationPrice = liquidationPrice;

package/dist/cjs/dev/AccountOpener.js

@@ -87,7 +87,6 @@ var AccountOpener = class extends require_sdk_base_SDKConstruct.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/cjs/dev/compareOpportunities.js

@@ -0,0 +1,218 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_model_opportunities = require("../model/opportunities.js");
+require("../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) => [require_model_opportunities.opportunityId(row), row]));
+}
+function byId(refs) {
+	refs.sort((a, b) => a.id.localeCompare(b.id));
+}
+function toRef(row) {
+	const base = {
+		id: require_model_opportunities.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
+exports.compareOpportunities = compareOpportunities;
+exports.diffOpportunity = diffOpportunity;

package/dist/cjs/model/charts.js

@@ -0,0 +1,147 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#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
+exports.CHART_METRIC_UNITS = CHART_METRIC_UNITS;
+exports.CHART_RANGES = CHART_RANGES;
+exports.CHART_UNAVAILABLE_CODES = CHART_UNAVAILABLE_CODES;
+exports.POOL_OPPORTUNITY_CHART_METRICS = POOL_OPPORTUNITY_CHART_METRICS;
+exports.POOL_POSITION_CHART_METRICS = POOL_POSITION_CHART_METRICS;
+exports.STRATEGY_OPPORTUNITY_CHART_METRICS = STRATEGY_OPPORTUNITY_CHART_METRICS;
+exports.STRATEGY_POSITION_CHART_METRICS = STRATEGY_POSITION_CHART_METRICS;