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

package/dist/cjs/sdk/market/math.js

@@ -0,0 +1,104 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_sdk_constants_math = require("../constants/math.js");
+//#region src/sdk/market/math.ts
+/**
+* Conversions between the units the protocol stores and the basis points the
+* read model exposes.
+*
+* These live here rather than inside the service so that the on-chain adapter,
+* the merger and any future consumer of the read model share one definition of
+* every derived value.
+**/
+const FULL = Number(require_sdk_constants_math.PERCENTAGE_FACTOR);
+/**
+* Converts a ray-scaled rate (`10 ** 27` = 100%) to basis points, truncating
+* towards zero.
+*
+* @example
+* ```ts
+* rayToBps(50_000_000_000_000_000_000_000_000n) // 500, i.e. 5%
+* ```
+**/
+function rayToBps(ray) {
+	return Number(ray * require_sdk_constants_math.PERCENTAGE_FACTOR / require_sdk_constants_math.RAY);
+}
+/**
+* Converts a USD value in the oracle's 8-decimal fixed point to a float.
+*
+* @example
+* ```ts
+* usdToNumber(150_050_000_000n) // 1500.5
+* ```
+**/
+function usdToNumber(usd) {
+	return Number(usd) / Number(require_sdk_constants_math.PRICE_DECIMALS);
+}
+/**
+* Share of capital currently borrowed, in basis points. Returns `0` when there
+* is nothing to borrow from, and never exceeds 100%.
+*
+* @example
+* ```ts
+* utilizationBps(750n, 1000n) // 7500, i.e. 75%
+* ```
+**/
+function utilizationBps(borrowed, total) {
+	if (total <= 0n || borrowed <= 0n) return 0;
+	const utilization = Number(borrowed * require_sdk_constants_math.PERCENTAGE_FACTOR / total);
+	return Math.min(utilization, FULL);
+}
+/**
+* Annual cost of debt for a credit manager, in basis points: the pool's base
+* rate plus the protocol's cut of the accrued interest.
+*
+* @param baseInterestRate - Pool base rate in ray.
+* @param feeInterest - Credit manager interest fee in basis points.
+*
+* @example
+* ```ts
+* // 5% base rate, 50% interest fee
+* borrowApyBps(50_000_000_000_000_000_000_000_000n, 5000) // 750, i.e. 7.5%
+* ```
+**/
+function borrowApyBps(baseInterestRate, feeInterest) {
+	return rayToBps(baseInterestRate * (require_sdk_constants_math.PERCENTAGE_FACTOR + BigInt(feeInterest)) / require_sdk_constants_math.PERCENTAGE_FACTOR);
+}
+/**
+* Highest leverage a liquidation threshold allows: `1 / (1 - lt)`.
+*
+* A threshold of 100% or more would allow unbounded leverage; such tokens are
+* not strategies and are filtered out before this is called, so the guard here
+* only exists to keep the function total.
+*
+* @example
+* ```ts
+* maxLeverage(9000) // 10
+* maxLeverage(8000) // 5
+* ```
+**/
+function maxLeverage(liquidationThreshold) {
+	const equity = FULL - liquidationThreshold;
+	return equity > 0 ? FULL / equity : Number.POSITIVE_INFINITY;
+}
+/**
+* Annual quota cost scaled to the debt a maximally leveraged position carries,
+* in basis points. Every unit of own capital carries `maxLeverage - 1` units of
+* debt, and the quota is paid on the whole quoted position.
+*
+* @example
+* ```ts
+* // 2.5% quota rate at 5x leverage
+* additionalBorrowApyBps(250, 5) // 1000, i.e. 10%
+* ```
+**/
+function additionalBorrowApyBps(quotaRate, leverage) {
+	if (!Number.isFinite(leverage)) return 0;
+	return Math.round(quotaRate * Math.max(leverage - 1, 0));
+}
+//#endregion
+exports.additionalBorrowApyBps = additionalBorrowApyBps;
+exports.borrowApyBps = borrowApyBps;
+exports.maxLeverage = maxLeverage;
+exports.rayToBps = rayToBps;
+exports.usdToNumber = usdToNumber;
+exports.utilizationBps = utilizationBps;

package/dist/cjs/sdk/market/oracle/PriceOracleBaseContract.js

@@ -7,6 +7,7 @@ const require_sdk_utils_formatter = require("../../utils/formatter.js");
 require("../../utils/index.js");
 const require_sdk_base_BaseContract = require("../../base/BaseContract.js");
 require("../../base/index.js");
+const require_sdk_market_math = require("../math.js");
 const require_sdk_market_pricefeeds_PriceFeedRef = require("../pricefeeds/PriceFeedRef.js");
 const require_abi_compressors_priceFeedCompressor = require("../../../abi/compressors/priceFeedCompressor.js");
 require("../pricefeeds/index.js");
@@ -104,6 +105,57 @@ var PriceOracleBaseContract = class extends require_sdk_base_BaseContract.BaseCo
 		return amount * 10n ** BigInt(this.tokensMeta.decimals(to)) / price;
 	}
 	/**
+	* {@inheritDoc IPriceOracleContract.safeUsdValue}
+	**/
+	safeUsdValue(token, amount) {
+		try {
+			return require_sdk_market_math.usdToNumber(this.convertToUSD(token, amount));
+		} catch (e) {
+			this.logger?.debug(`cannot price ${this.labelAddress(token)}: ${e}`);
+			return null;
+		}
+	}
+	/**
+	* {@inheritDoc IPriceOracleContract.toAmount}
+	**/
+	toAmount = (token, value) => {
+		return {
+			value,
+			valueUsd: this.safeUsdValue(token, value)
+		};
+	};
+	/**
+	* {@inheritDoc IPriceOracleContract.toTokenAmount}
+	**/
+	toTokenAmount = (token, value) => {
+		return {
+			token: this.tokensMeta.mustGetToken(token),
+			...this.toAmount(token, value)
+		};
+	};
+	/**
+	* {@inheritDoc IPriceOracleContract.priceFeedData}
+	**/
+	priceFeedData(token) {
+		const ref = this.mainPriceFeeds.get(token);
+		if (!ref) throw new Error(`no main price feed for ${this.labelAddress(token)} in oracle ${this.labelAddress(this.address)}`);
+		return ref.priceFeed.describe();
+	}
+	/**
+	* {@inheritDoc IPriceOracleContract.priceFeedSummary}
+	**/
+	priceFeedSummary(underlying, collateral) {
+		const collateralUnit = 10n ** BigInt(this.tokensMeta.decimals(collateral));
+		const underlyingUnit = 10n ** BigInt(this.tokensMeta.decimals(underlying));
+		return {
+			underlyingPriceInUsd: require_sdk_market_math.usdToNumber(this.mainPrice(underlying)),
+			collateralPriceInUsd: require_sdk_market_math.usdToNumber(this.mainPrice(collateral)),
+			collateralPriceInUnderlying: Number(this.convert(collateral, underlying, collateralUnit)) / Number(underlyingUnit),
+			underlyingFeed: this.priceFeedData(underlying),
+			collateralFeed: this.priceFeedData(collateral)
+		};
+	}
+	/**
 	* {@inheritDoc IPriceOracleContract.priceFeeds}
 	**/
 	get priceFeeds() {

package/dist/cjs/sdk/market/pool/LinearInterestRateModelContract.js

@@ -4,6 +4,7 @@ require("../../utils/index.js");
 const require_sdk_base_BaseContract = require("../../base/BaseContract.js");
 require("../../base/index.js");
 const require_abi_310_iLinearInterestRateModelV310 = require("../../../abi/310/iLinearInterestRateModelV310.js");
+const require_sdk_market_pool_math = require("./math.js");
 let viem = require("viem");
 //#region src/sdk/market/pool/LinearInterestRateModelContract.ts
 const abi = require_abi_310_iLinearInterestRateModelV310.iLinearInterestRateModelV310Abi;
@@ -59,6 +60,35 @@ var LinearInterestRateModelContract = class extends require_sdk_base_BaseContrac
 		this.Rslope3 = Rslope3;
 		this.isBorrowingMoreU2Forbidden = isBorrowingMoreU2Forbidden;
 	}
+	/**
+	* The model's own parameters, gathered for the rate math.
+	*/
+	get params() {
+		return {
+			U1: this.U1,
+			U2: this.U2,
+			Rbase: this.Rbase,
+			Rslope1: this.Rslope1,
+			Rslope2: this.Rslope2,
+			Rslope3: this.Rslope3,
+			isBorrowingMoreU2Forbidden: this.isBorrowingMoreU2Forbidden
+		};
+	}
+	/**
+	* The model evaluated into chart-ready points, so that no consumer has to
+	* reimplement it.
+	*/
+	rateCurve() {
+		const { params } = this;
+		return {
+			points: require_sdk_market_pool_math.rateCurveUtilizations(params).map((utilization) => ({
+				utilization,
+				supplyApy: require_sdk_market_pool_math.supplyRateAtUtilization(utilization, params),
+				borrowApy: require_sdk_market_pool_math.borrowRateAtUtilization(utilization, params)
+			})),
+			borrowingLimitUtilization: params.isBorrowingMoreU2Forbidden ? params.U2 : null
+		};
+	}
 	stateHuman(raw) {
 		return {
 			...super.stateHuman(raw),

package/dist/cjs/sdk/market/pool/PoolQuotaKeeperV310Contract.js

@@ -21,6 +21,32 @@ var PoolQuotaKeeperV310Contract = class extends require_sdk_base_BaseContract.Ba
 			return [q.token, q];
 		}), "quotas");
 	}
+	/**
+	* Whether the market still accepts quota for a token: a token whose quota is
+	* inactive or whose limit is exhausted can no longer back a new position.
+	*
+	* @param token - Token address.
+	*/
+	hasActiveQuota(token) {
+		const quota = this.quotas.get(token);
+		return !!quota?.isActive && quota.limit > 0n;
+	}
+	/**
+	* Every token the market still accepts quota for, see
+	* {@link hasActiveQuota}.
+	*/
+	get activeQuotaTokens() {
+		return this.quotas.keys().filter((token) => this.hasActiveQuota(token));
+	}
+	/**
+	* Annual quota rate paid on a quoted token, in basis points, or `0` when the
+	* market does not quote it.
+	*
+	* @param token - Quoted token address.
+	*/
+	quotaRate(token) {
+		return this.quotas.get(token)?.rate ?? 0;
+	}
 	stateHuman(raw = true) {
 		return {
 			...super.stateHuman(raw),

package/dist/cjs/sdk/market/pool/PoolSuite.js

@@ -100,6 +100,34 @@ var PoolSuite = class extends require_sdk_base_SDKConstruct.SDKConstruct {
 		return this.pool.underlying;
 	}
 	/**
+	* {@inheritDoc IPoolContract.unwrappedUnderlying}
+	*/
+	get unwrappedUnderlying() {
+		return this.pool.unwrappedUnderlying;
+	}
+	/**
+	* {@inheritDoc IPoolContract.utilization}
+	*/
+	get utilization() {
+		return this.pool.utilization;
+	}
+	/**
+	* Whether the pool is paused, which blocks borrowing across every connected
+	* credit suite.
+	*/
+	get isPaused() {
+		return this.pool.isPaused;
+	}
+	/**
+	* Interest rate curve of the pool's rate model.
+	*
+	* @throws If the market uses an interest-rate model that is not linear, and
+	* therefore has no curve the SDK can evaluate.
+	*/
+	get rateCurve() {
+		return this.linearModel.rateCurve();
+	}
+	/**
 	* RWA factory associated with the pool's underlying, undefined for non-RWA markets.
 	*/
 	get rwaFactory() {

package/dist/cjs/sdk/market/pool/PoolV310Contract.js

@@ -2,10 +2,13 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_abi_iPausable = require("../../../abi/iPausable.js");
 const require_abi_310_generated = require("../../../abi/310/generated.js");
 const require_sdk_utils_AddressMap = require("../../utils/AddressMap.js");
+const require_sdk_constants_math = require("../../constants/math.js");
+require("../../constants/index.js");
 const require_sdk_utils_formatter = require("../../utils/formatter.js");
 require("../../utils/index.js");
 const require_sdk_base_BaseContract = require("../../base/BaseContract.js");
 require("../../base/index.js");
+const require_sdk_market_math = require("../math.js");
 //#region src/sdk/market/pool/PoolV310Contract.ts
 const abi = [...require_abi_310_generated.iPoolV310Abi, ...require_abi_iPausable.iPausableAbi];
 var PoolV310Contract = class extends require_sdk_base_BaseContract.BaseContract {
@@ -32,6 +35,30 @@ var PoolV310Contract = class extends require_sdk_base_BaseContract.BaseContract
 		const meta = this.#sdk.tokensMeta.mustGet(this.underlying);
 		if (this.#sdk.tokensMeta.isRWAUnderlying(meta)) return this.#sdk.mustGetContract(meta.rwaFactory);
 	}
+	/**
+	* {@inheritDoc IPoolContract.borrowed}
+	*/
+	get borrowed() {
+		return this.expectedLiquidity > this.availableLiquidity ? this.expectedLiquidity - this.availableLiquidity : 0n;
+	}
+	/**
+	* {@inheritDoc IPoolContract.totalAssets}
+	*/
+	get totalAssets() {
+		return this.totalSupply * this.dieselRate / require_sdk_constants_math.RAY;
+	}
+	/**
+	* {@inheritDoc IPoolContract.utilization}
+	*/
+	get utilization() {
+		return require_sdk_market_math.utilizationBps(this.borrowed, this.expectedLiquidity);
+	}
+	/**
+	* {@inheritDoc IPoolContract.unwrappedUnderlying}
+	*/
+	get unwrappedUnderlying() {
+		return this.tokensMeta.unwrapRWA(this.underlying);
+	}
 	stateHuman(raw = true) {
 		return {
 			...super.stateHuman(raw),

package/dist/cjs/sdk/market/pool/math.js

@@ -0,0 +1,44 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_sdk_constants_math = require("../../constants/math.js");
+//#region src/sdk/market/pool/math.ts
+const FULL = Number(require_sdk_constants_math.PERCENTAGE_FACTOR);
+/**
+* Base rate borrowers pay at a given utilization, in basis points, following
+* the linear interest rate model's three segments.
+*
+* The result excludes the per-credit-manager interest fee: the model belongs to
+* the pool, and every credit manager of a market can charge a different one.
+**/
+function borrowRateAtUtilization(utilization, params) {
+	const { U1, U2, Rbase, Rslope1, Rslope2, Rslope3 } = params;
+	const u = Math.min(Math.max(utilization, 0), FULL);
+	if (u <= 0) return Rbase;
+	if (u <= U1) return Math.round(Rbase + Rslope1 * u / U1);
+	if (u <= U2) return Math.round(Rbase + Rslope1 + Rslope2 * (u - U1) / Math.max(U2 - U1, 1));
+	return Math.round(Rbase + Rslope1 + Rslope2 + Rslope3 * (u - U2) / Math.max(FULL - U2, 1));
+}
+/**
+* Rate depositors earn at a given utilization, in basis points: the interest
+* borrowers pay, spread over the pool's whole liquidity.
+**/
+function supplyRateAtUtilization(utilization, params) {
+	const u = Math.min(Math.max(utilization, 0), FULL);
+	return Math.round(borrowRateAtUtilization(u, params) * u / FULL);
+}
+/**
+* Utilizations the rate curve is sampled at: a fixed grid plus both kinks of
+* the model, so the borrow leg is exact and the supply leg — which is
+* quadratic between kinks — is smooth.
+**/
+function rateCurveUtilizations(params) {
+	const step = FULL / 20;
+	const grid = /* @__PURE__ */ new Set();
+	for (let u = 0; u <= FULL; u += step) grid.add(u);
+	grid.add(params.U1);
+	grid.add(params.U2);
+	return [...grid].filter((u) => u >= 0 && u <= FULL).sort((a, b) => a - b);
+}
+//#endregion
+exports.borrowRateAtUtilization = borrowRateAtUtilization;
+exports.rateCurveUtilizations = rateCurveUtilizations;
+exports.supplyRateAtUtilization = supplyRateAtUtilization;

package/dist/cjs/sdk/market/pricefeeds/AbstractPriceFeed.js

@@ -89,6 +89,23 @@ var AbstractPriceFeedContract = class extends require_sdk_base_BaseContract.Base
 		const underlying = this.underlyingPriceFeeds.flatMap((f) => f.priceFeed.updatableDependencies());
 		return require_sdk_market_pricefeeds_isUpdatablePriceFeed.isUpdatablePriceFeed(this) ? [this, ...underlying] : underlying;
 	}
+	/**
+	* {@inheritDoc IPriceFeedContract.describe}
+	*/
+	describe() {
+		let dependencies = [];
+		try {
+			dependencies = this.underlyingPriceFeeds.map((ref) => ref.priceFeed.describe());
+		} catch {
+			dependencies = [];
+		}
+		return {
+			name: this.name,
+			type: this.contractType,
+			feedAddress: this.address,
+			dependencies
+		};
+	}
 };
 //#endregion
 exports.AbstractPriceFeedContract = AbstractPriceFeedContract;

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

@@ -0,0 +1,60 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_sdk_chain_chains = require("../chain/chains.js");
+const require_sdk_base_MultichainConstruct = require("../base/MultichainConstruct.js");
+require("../base/index.js");
+//#region src/sdk/opportunities/MultichainOpportunitiesService.ts
+/**
+* Cross-chain counterpart of {@link OpportunitiesService}.
+*
+* Fans out over every chain configured in {@link MultichainSDK}. A chain that
+* fails is logged and skipped so one dead RPC does not empty the list; its
+* failure is reported in {@link MultichainResult.meta}.
+*
+* Detail reads need no fan-out: an opportunity key names its chain.
+*
+* @typeParam Plugins - Map of attached plugin types.
+**/
+var MultichainOpportunitiesService = class extends require_sdk_base_MultichainConstruct.MultichainConstruct {
+	/**
+	* Opportunities of all queried chains, see {@link OpportunitiesService.list}.
+	*
+	* A filter that names chains narrows the fan-out itself, so chains whose rows
+	* would be discarded are never queried and never appear in the meta.
+	**/
+	async list(filter) {
+		return this.queryChains({
+			networks: this.#networksOf(filter),
+			label: "list opportunities",
+			run: (sdk) => sdk.opportunities.list(filter)
+		});
+	}
+	/**
+	* {@inheritDoc OpportunitiesService.getPool}
+	**/
+	async getPool(key) {
+		return this.sdk.chain(key.chainId).opportunities.getPool(key);
+	}
+	/**
+	* {@inheritDoc OpportunitiesService.getStrategy}
+	**/
+	async getStrategy(key) {
+		return this.sdk.chain(key.chainId).opportunities.getStrategy(key);
+	}
+	/**
+	* Chains named by the filter, or `undefined` to query all of them. Chain ids
+	* the SDK does not support are dropped here rather than reported as failures:
+	* a filter naming them is a narrowing, not a request.
+	**/
+	#networksOf(filter) {
+		if (!filter?.chainIds) return;
+		const networks = [];
+		for (const chainId of filter.chainIds) try {
+			networks.push(require_sdk_chain_chains.getNetworkType(chainId));
+		} catch {
+			this.sdk.logger?.debug(`ignoring unsupported chain ${chainId} in opportunities filter`);
+		}
+		return networks;
+	}
+};
+//#endregion
+exports.MultichainOpportunitiesService = MultichainOpportunitiesService;

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

@@ -0,0 +1,48 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_sdk_base_SDKConstruct = require("../base/SDKConstruct.js");
+require("../base/index.js");
+//#region src/sdk/opportunities/OpportunitiesService.ts
+/**
+* Builds the `opportunities` read model from the chain.
+*
+* Every value in a row is market state the SDK already holds, so a list costs
+* no RPC round-trip at all. Yield figures that fold in incentives, points or
+* history are deliberately absent: they are the backend's job, and this service
+* never guesses them. So is the size of a strategy — summing it takes a sweep
+* over every credit account of the chain, which is too expensive for a list.
+*
+* The rows themselves are assembled by the market wrappers — see
+* {@link MarketSuite.opportunities} — because every value in them is market
+* state. This service only picks the markets and applies the filter.
+**/
+var OpportunitiesService = class extends require_sdk_base_SDKConstruct.SDKConstruct {
+	/**
+	* Every pool and strategy of every loaded market on this chain.
+	*
+	* @param filter - Optional narrowing, applied to the built rows.
+	**/
+	async list(filter) {
+		if (filter?.chainIds && !filter.chainIds.includes(this.chainId)) return [];
+		return this.sdk.marketRegister.markets.flatMap((market) => market.opportunities(filter));
+	}
+	/**
+	* A single pool opportunity plus its interest rate curve and quotas.
+	*
+	* @throws If no loaded market has this pool.
+	**/
+	async getPool(key) {
+		return this.sdk.marketRegister.findByPool(key.pool).poolOpportunityDetail();
+	}
+	/**
+	* A single strategy opportunity plus the rate curve of the pool it borrows
+	* from and the price feeds its liquidation price depends on.
+	*
+	* @throws If the credit manager is unknown, or does not accept the requested
+	* collateral as a strategy.
+	**/
+	async getStrategy(key) {
+		return this.sdk.marketRegister.findByCreditManager(key.creditManager).strategyOpportunityDetail(key.creditManager, key.targetCollateral);
+	}
+};
+//#endregion
+exports.OpportunitiesService = OpportunitiesService;

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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