@gearbox-protocol/sdk 16.0.0-next.5 → 16.0.0-next.50

package/dist/esm/onchain/accounts/intents/utils/price-impact.js

@@ -0,0 +1,96 @@
+import { PERCENTAGE_FACTOR_1KK, PRICE_DECIMALS, WAD } from "../../../constants/math.js";
+//#region src/onchain/accounts/intents/utils/price-impact.ts
+/** `b1 = b0 / V0`: a dollar of the basket, the reference implementation's anchor. */
+const PROBE_UNIT_USD_WAD = WAD;
+/**
+* `V0 = Σ b0ᵢ·pᵢ`, then `b1 = b0 / V0`, proportions kept.
+*
+* Refuses only what the reference refuses — a basket worth nothing, or one that
+* rounds away entirely. Stricter guards here would report nothing where the old
+* client reported a number.
+*/
+function probeBasket(balances, oracle) {
+	if (balances.length === 0) return;
+	let basketWad = 0n;
+	for (const asset of balances) {
+		if (asset.balance <= 0n) continue;
+		const usd = oracle.safeConvertToUSD(asset.token, asset.balance);
+		if (usd !== null && usd > 0n) basketWad += usd * WAD / PRICE_DECIMALS;
+	}
+	if (basketWad <= 0n) return;
+	const probeWad = PROBE_UNIT_USD_WAD;
+	const scaled = balances.map((asset) => ({
+		token: asset.token,
+		balance: asset.balance * probeWad / basketWad
+	}));
+	if (!scaled.some((a) => a.balance > 0n)) return;
+	return {
+		balances: scaled,
+		basketWad,
+		probeWad
+	};
+}
+/** Fires the marginal-price quote for one leg; `undefined` if it cannot be measured. */
+function startProbe(args) {
+	const basket = probeBasket(args.basket, args.oracle);
+	if (!basket) return;
+	return {
+		tokenOut: args.tokenOut,
+		basketWad: basket.basketWad,
+		probeWad: basket.probeWad,
+		probe: args.route(basket.balances).catch(() => void 0)
+	};
+}
+/** `convert` answers `0` for a negative amount, so convert the magnitude and re-sign. */
+function toUnderlyingSigned(convert, token, amount) {
+	if (amount === 0n) return 0n;
+	const converted = convert(token, amount < 0n ? -amount : amount);
+	if (converted <= 0n) return;
+	return amount < 0n ? -converted : converted;
+}
+/**
+* In `PERCENTAGE_FACTOR_1KK` (1_000_000 = 100%), negative for a loss. A base
+* that is not positive falls back to the routed output.
+*/
+function lossRate(args) {
+	const { lossUnd, expectedUnd, totalValue, netValue } = args;
+	const against = (base) => -(PERCENTAGE_FACTOR_1KK * lossUnd / (base > 0n ? base : expectedUnd));
+	return {
+		pathPriceImpact: against(expectedUnd),
+		netValuePriceImpact: against(netValue),
+		totalValuePriceImpact: against(totalValue)
+	};
+}
+/**
+* Folds every leg into one rate, in the underlying — the unit its bases are in.
+*
+* All or nothing: a partial sum would understate the loss and draw a better
+* price than the route offers.
+*/
+async function collectPriceImpact(probes, ctx) {
+	if (probes.length === 0) return;
+	const quotes = await Promise.all(probes.map((leg) => leg.probe));
+	let expectedUnd = 0n;
+	let lossUnd = 0n;
+	for (const [index, leg] of probes.entries()) {
+		const unit = quotes[index];
+		if (unit === void 0 || unit <= 0n) return;
+		const expected = unit * leg.basketWad / leg.probeWad;
+		if (expected <= 0n) return;
+		const expectedInUnd = ctx.toUnderlying(leg.tokenOut, expected);
+		if (expectedInUnd <= 0n) return;
+		const loss = toUnderlyingSigned(ctx.toUnderlying, leg.tokenOut, expected - leg.realAmount);
+		if (loss === void 0) return;
+		expectedUnd += expectedInUnd;
+		lossUnd += loss;
+	}
+	if (expectedUnd <= 0n) return;
+	return lossRate({
+		lossUnd,
+		expectedUnd,
+		totalValue: ctx.totalValue,
+		netValue: ctx.netValue
+	});
+}
+//#endregion
+export { collectPriceImpact, lossRate, startProbe };

package/dist/esm/onchain/accounts/intents/utils/quotas-for-update.js

@@ -1,6 +1,6 @@
 import { MIN_INT96 } from "../../../constants/math.js";
 import { TypedObjectUtils } from "../../../utils/mappers.js";
-import { calcQuotaUpdate } from "../../../../common-utils/utils/creditAccount/quota-utils.js";
+import { calcQuotaUpdate } from "../../quota-utils.js";
 //#region src/onchain/accounts/intents/utils/quotas-for-update.ts
 function getQuotasForUpdate({ assetsBefore, assetsAfter, initialQuotas, quotaReserve = 0, liquidationThresholds: liquidationThresholdsMap, quotas: quotasMap, maxDebt, underlyingToken, convert }) {
 	const underlyingTokenLc = underlyingToken.toLowerCase();
@@ -123,7 +123,7 @@ function collectQuotaChange(assetsBefore, assetsAfter) {
 }
 /**
 * SDK `getSingleQuotaChange` requires `assetAfter` to emit quota decreases.
-* Simulation drops zero balances, so fully spent collaterals (e.g. claim
+* The ledger drops zero balances, so fully spent collaterals (e.g. claim
 * phantom) vanish — reinsert them with balance 0 when they still have
 * initial quota so `calcQuotaUpdate` can zero / remove that quota.
 */

package/dist/esm/onchain/accounts/intents/utils/router-path.js

@@ -1,5 +1,5 @@
 import { toRouterCaSlice } from "./common.js";
-import { convertAmount } from "./convert-amount.js";
+import { startProbe } from "./price-impact.js";
 //#region src/onchain/accounts/intents/utils/router-path.ts
 /**
 * The engine's only door to the pathfinder.
@@ -17,68 +17,124 @@ function createRouterPaths(args) {
 		collateralTokens: suite.creditManager.collateralTokens.map((t) => t.toLowerCase())
 	};
 	const router = sdk.routerFor({ creditFacade: suite.creditFacade.address });
+	const { priceOracle } = sdk.marketRegister.findByCreditManager(creditAccount.creditManager);
+	const quoteSwap = (input) => {
+		const spending = [{
+			token: input.tokenIn,
+			balance: input.amount + input.keep
+		}];
+		return input.keep > 0n ? router.findManyToOnePath({
+			creditAccount: toRouterCaSlice(creditAccount, spending),
+			creditManager: cmSlice,
+			expectedBalances: spending,
+			leftoverBalances: [{
+				token: input.tokenIn,
+				balance: input.keep
+			}],
+			target: input.tokenOut,
+			slippage
+		}) : router.findOneTokenPath({
+			creditAccount: toRouterCaSlice(creditAccount, spending),
+			creditManager: cmSlice,
+			tokenIn: input.tokenIn,
+			tokenOut: input.tokenOut,
+			amount: input.amount,
+			slippage
+		});
+	};
+	const quoteClose = (balances) => router.findBestClosePath({
+		creditAccount: toRouterCaSlice(creditAccount, balances),
+		creditManager: cmSlice,
+		balances: {
+			expectedBalances: balances,
+			leftoverBalances: [],
+			tokensToClaim: []
+		},
+		slippage
+	});
+	const quoteOpen = (expectedBalances, leftoverBalances, target) => router.findOpenStrategyPath({
+		creditManager: cmSlice,
+		expectedBalances,
+		leftoverBalances,
+		target,
+		slippage
+	});
 	return {
 		async swap({ tokenIn, tokenOut, amount, keep = 0n }) {
 			if (amount <= 0n) return {
 				amount: 0n,
 				minAmount: 0n,
-				calls: []
+				calls: [],
+				probe: void 0
 			};
 			if (keep < 0n) throw new Error(`swap: spending ${amount} of ${tokenIn} exceeds its balance`);
-			if (keep > 0n) {
-				const expectedBalances = [{
-					token: tokenIn,
-					balance: amount + keep
-				}];
-				return router.findManyToOnePath({
-					creditAccount: toRouterCaSlice(creditAccount, expectedBalances),
-					creditManager: cmSlice,
-					expectedBalances,
-					leftoverBalances: [{
-						token: tokenIn,
-						balance: keep
-					}],
-					target: tokenOut,
-					slippage
-				});
-			}
-			return router.findOneTokenPath({
-				creditAccount: toRouterCaSlice(creditAccount, [{
+			const probe = startProbe({
+				basket: [{
 					token: tokenIn,
 					balance: amount
-				}]),
-				creditManager: cmSlice,
+				}],
+				tokenOut,
+				oracle: priceOracle,
+				route: async ([only]) => {
+					if (!only) return 0n;
+					return (await quoteSwap({
+						tokenIn: only.token,
+						tokenOut,
+						amount: only.balance,
+						keep: 0n
+					})).amount;
+				}
+			});
+			const leg = await quoteSwap({
 				tokenIn,
 				tokenOut,
 				amount,
-				slippage
+				keep
 			});
+			return {
+				...leg,
+				probe: probe && {
+					...probe,
+					realAmount: leg.amount
+				}
+			};
 		},
 		async closeAll({ balances }) {
-			const { amount, minAmount, calls } = await router.findBestClosePath({
-				creditAccount: toRouterCaSlice(creditAccount, balances),
-				creditManager: cmSlice,
-				balances: {
-					expectedBalances: balances,
-					leftoverBalances: [],
-					tokensToClaim: []
-				},
-				slippage
+			const probe = startProbe({
+				basket: balances,
+				tokenOut: creditAccount.underlying,
+				oracle: priceOracle,
+				route: async (quoted) => (await quoteClose(quoted)).amount
 			});
-			return {
+			const { amount, minAmount, calls } = await quoteClose(balances);
+			const leg = {
 				amount,
 				minAmount,
 				calls: [...calls]
 			};
+			return {
+				...leg,
+				probe: probe && {
+					...probe,
+					realAmount: leg.amount
+				}
+			};
 		},
 		async openStrategy({ expectedBalances, leftoverBalances, target }) {
-			return router.findOpenStrategyPath({
-				creditManager: cmSlice,
-				expectedBalances,
-				leftoverBalances,
-				target,
-				slippage
+			const probe = startProbe({
+				basket: expectedBalances,
+				tokenOut: target,
+				oracle: priceOracle,
+				route: async (balances) => (await quoteOpen(balances, [], target)).amount
 			});
+			const leg = await quoteOpen(expectedBalances, leftoverBalances, target);
+			return {
+				...leg,
+				probe: probe && {
+					...probe,
+					realAmount: leg.amount
+				}
+			};
 		}
 	};
 }
@@ -94,11 +150,13 @@ function createRouterPaths(args) {
 */
 function createOraclePaths(args) {
 	const { sdk, creditAccount } = args;
-	const price = convertAmount(sdk, creditAccount.creditManager);
+	const oracle = sdk.marketRegister.findByCreditManager(creditAccount.creditManager).priceOracle;
+	const price = (from, to, amount) => oracle.safeConvert(from, to, amount) ?? 0n;
 	const estimate = (amount) => ({
 		amount,
 		minAmount: amount,
-		calls: []
+		calls: [],
+		probe: void 0
 	});
 	return {
 		async swap({ tokenIn, tokenOut, amount }) {

package/dist/esm/onchain/accounts/intents/view.js

@@ -1,25 +1,26 @@
 import { eq } from "./utils/common.js";
-import { convertAmount } from "./utils/convert-amount.js";
 import { pickFattestNonPhantomToken } from "./utils/pick-token.js";
 //#region src/onchain/accounts/intents/view.ts
 /**
 * The account as the planners see it: a handful of numbers in underlying units
 * plus balance / price lookups. Read once per preview.
 *
-* TVL uses the RWA-aware conversion so an `rwa.asset` balance without a direct
-* pool price still counts at its wrapped value instead of throwing.
+* TVL uses the market oracle: an unpriceable token contributes 0n rather
+* than throwing.
 */
 function accountView(creditAccount, sdk) {
 	const { underlying, creditManager } = creditAccount;
-	const price = convertAmount(sdk, creditManager);
+	const oracle = sdk.marketRegister.findByCreditManager(creditManager).priceOracle;
+	const price = (from, to, amount) => oracle.safeConvert(from, to, amount) ?? 0n;
 	const { creditFacade } = sdk.marketRegister.findCreditManager(creditManager);
 	let totalValue = 0n;
 	for (const t of creditAccount.tokens) totalValue += price(t.token, underlying, t.balance);
 	return {
 		underlying,
+		sdk,
 		rwaAsset: sdk.tokensMeta.rwaUnderlyings.get(underlying)?.asset,
-		debt: creditAccount.accountDebt,
-		collateral: totalValue - creditAccount.accountDebt,
+		debt: creditAccount.totalDebt,
+		collateral: totalValue - creditAccount.totalDebt,
 		band: {
 			minDebt: creditFacade.minDebt,
 			maxDebt: creditFacade.maxDebt

package/dist/esm/onchain/accounts/liquidations/LiquidationsService.js

@@ -20,6 +20,7 @@ import "../../market/rwa/securitize/index.js";
 import "../../market/index.js";
 import { LIQUIDATION_APPROVAL_BUFFER, LIQUIDATION_COMPRESSOR_V313_ADDRESS } from "./constants.js";
 import { iLiquidationCompressorV313Abi } from "../../../abi/ILiquidationCompressorV313.js";
+import { skipLiquidatableAccount } from "./skipLiquidatableAccount.js";
 //#region src/onchain/accounts/liquidations/LiquidationsService.ts
 /**
 * Service for discovering liquidatable credit accounts and previewing manual
@@ -29,7 +30,6 @@ var LiquidationsService = class extends SDKConstruct {
 	/**
 	* Returns all liquidatable credit accounts: accounts with health factor
 	* below 1 plus accounts of expired credit managers with outstanding debt.
-	* Accounts whose collateral computation failed are excluded.
 	**/
 	async getLiquidatableAccounts(props) {
 		const unhealthy = await this.sdk.accounts.getCreditAccounts({
@@ -40,8 +40,8 @@ var LiquidationsService = class extends SDKConstruct {
 		let expired = await this.#getExpiredCreditAccounts(props?.blockNumber);
 		expired = expired.filter((ca) => !seen.has(ca.creditAccount));
 		return [...unhealthy, ...expired].flatMap((ca) => {
-			if (!ca.success) {
-				this.logger?.warn(`cannot compute liquidation details for ${ca.creditAccount}: collateral computation failed`);
+			if (skipLiquidatableAccount(ca, (token) => this.sdk.tokensMeta.get(token)?.contractType)) {
+				this.logger?.warn(`skipping liquidatable account ${ca.creditAccount}`);
 				return [];
 			}
 			return [this.#buildAccount(ca)];
@@ -253,15 +253,15 @@ var LiquidationsService = class extends SDKConstruct {
 	#buildAccount(ca, suite = this.sdk.marketRegister.findCreditManager(ca.creditManager)) {
 		const market = suite.market;
 		const unwrappedUnderlying = this.sdk.tokensMeta.unwrapRWA(suite.underlying);
-		const liquidationDiscount = suite.isExpired ? suite.creditManager.liquidationDiscountExpired : suite.creditManager.liquidationDiscount;
+		const { liquidationDiscount } = suite.liquidationFees();
 		const repaymentAmount = ca.totalValue * BigInt(liquidationDiscount) / PERCENTAGE_FACTOR;
 		const estimatedProfit = ca.totalValue - repaymentAmount;
 		const token = this.sdk.tokensMeta.mustGetToken(unwrappedUnderlying);
 		const usd = (part) => ca.totalValue > 0n ? usdToNumber(ca.totalValueUSD * part / ca.totalValue) : 0;
 		return {
+			...suite.creditOperationMarket(),
 			chainId: this.sdk.chainId,
 			creditAccount: ca.creditAccount,
-			creditManager: ca.creditManager,
 			asset: this.sdk.tokensMeta.mustGetToken(this.#mainAsset(ca, market, unwrappedUnderlying)),
 			totalValue: {
 				token,

package/dist/esm/onchain/accounts/liquidations/skipLiquidatableAccount.js

@@ -0,0 +1,11 @@
+//#region src/onchain/accounts/liquidations/skipLiquidatableAccount.ts
+/**
+* Whether a credit account should be dropped from the liquidatable list:
+* collateral computation failed, or it holds a Mellow withdrawal phantom
+* token above dust (no liquidation subcompressor for that type).
+**/
+function skipLiquidatableAccount(account, getContractType) {
+	return !account.success || account.tokens.some((t) => getContractType(t.token) === "PHANTOM_TOKEN::MELLOW_WITHDRAWAL");
+}
+//#endregion
+export { skipLiquidatableAccount };

package/dist/esm/{common-utils/utils/creditAccount → onchain/accounts}/quota-utils.js

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

package/dist/esm/onchain/accounts/withdrawal-compressor/RedemptionLoggerV310Contract.js

@@ -1,8 +1,9 @@
 import { BaseContract } from "../../base/BaseContract.js";
 import "../../base/index.js";
+import { sdkErr, sdkOk } from "../../../model/result.js";
+import "../../../model/index.js";
 import { decodeDelayedIntent } from "./intent-codec.js";
 import { iRedemptionLoggerV310Abi } from "../../../abi/iRedemptionLoggerV310.js";
-import { InvalidDelayedIntentError } from "./errors.js";
 //#region src/onchain/accounts/withdrawal-compressor/RedemptionLoggerV310Contract.ts
 const abi = iRedemptionLoggerV310Abi;
 /**
@@ -32,18 +33,23 @@ var RedemptionLoggerV310Contract = class extends BaseContract {
 	*
 	* @param redeemer - Redeemer contract the withdrawal is claimed from.
 	* @param blockNumber - Optional block number to read the log at.
-	* @returns The decoded intent, or `undefined` when the log carries none
-	* (including when nothing was logged for the redeemer).
-	* @throws InvalidDelayedIntentError when the logged `extraData` is
+	* @returns The decoded intent behind `ok` (`undefined` when the log
+	* carries none, including when nothing was logged for the redeemer), or
+	* the `invalidDelayedIntent` refusal when the logged `extraData` is
 	* non-empty but cannot be decoded as a `DelayedIntent`.
 	**/
 	async getDelayedIntent(redeemer, blockNumber) {
 		const log = await this.getRedemptionLog(redeemer, blockNumber);
-		if (!log.extraData || log.extraData === "0x") return;
+		if (!log.extraData || log.extraData === "0x") return sdkOk(void 0);
 		try {
-			return decodeDelayedIntent(log.extraData);
+			return sdkOk(decodeDelayedIntent(log.extraData));
 		} catch (e) {
-			throw new InvalidDelayedIntentError(log.extraData, e);
+			return sdkErr({
+				code: "invalidDelayedIntent",
+				message: `cannot decode delayed intent from extraData ${log.extraData}`,
+				extraData: log.extraData,
+				cause: e instanceof Error ? e : new Error(String(e))
+			});
 		}
 	}
 };

package/dist/esm/onchain/accounts/withdrawal-compressor/errors.js

@@ -1,19 +1 @@
-//#region src/onchain/accounts/withdrawal-compressor/errors.ts
-/**
-* Thrown when a delayed-withdrawal request or redemption log carries
-* non-empty `extraData` that cannot be decoded as a `DelayedIntent`.
-* Requests produced by our stack always encode a valid intent, so garbage
-* here means a malformed/foreign transaction that must not be previewed as
-* if it were fine.
-*/
-var InvalidDelayedIntentError = class extends Error {
-	/** Raw `extraData` that failed to decode. */
-	extraData;
-	constructor(extraData, cause) {
-		super(`cannot decode delayed intent from extraData ${extraData}`, { cause });
-		this.name = "InvalidDelayedIntentError";
-		this.extraData = extraData;
-	}
-};
-//#endregion
-export { InvalidDelayedIntentError };
+export {};

package/dist/esm/onchain/accounts/withdrawal-compressor/index.js

@@ -1,7 +1,6 @@
 import { DELAYED_INTENT_TYPES, DELAYED_INTENT_VERSION, decodeDelayedIntent, encodeDelayedIntent } from "./intent-codec.js";
 import { AbstractWithdrawalCompressorContract, iCreditAccountAbi, toClaimableWithdrawal, toPendingWithdrawal, toRequestableWithdrawal } from "./AbstractWithdrawalCompressorContract.js";
 import { getWithdrawalCompressorAddress } from "./addresses.js";
-import { InvalidDelayedIntentError } from "./errors.js";
 import { RedemptionLoggerV310Contract } from "./RedemptionLoggerV310Contract.js";
 import { createRedemptionLogger } from "./createRedemptionLogger.js";
 import { WithdrawalCompressorV310Contract } from "./WithdrawalCompressorV310Contract.js";
@@ -9,4 +8,5 @@ import { WithdrawalCompressorV311Contract } from "./WithdrawalCompressorV311Cont
 import { toWithdrawalStatus } from "./types.js";
 import { WithdrawalCompressorV313Contract } from "./WithdrawalCompressorV313Contract.js";
 import { createWithdrawalCompressor } from "./createWithdrawalCompressor.js";
-export { AbstractWithdrawalCompressorContract, DELAYED_INTENT_TYPES, DELAYED_INTENT_VERSION, InvalidDelayedIntentError, RedemptionLoggerV310Contract, WithdrawalCompressorV310Contract, WithdrawalCompressorV311Contract, WithdrawalCompressorV313Contract, createRedemptionLogger, createWithdrawalCompressor, decodeDelayedIntent, encodeDelayedIntent, getWithdrawalCompressorAddress, iCreditAccountAbi, toClaimableWithdrawal, toPendingWithdrawal, toRequestableWithdrawal, toWithdrawalStatus };
+import "./errors.js";
+export { AbstractWithdrawalCompressorContract, DELAYED_INTENT_TYPES, DELAYED_INTENT_VERSION, RedemptionLoggerV310Contract, WithdrawalCompressorV310Contract, WithdrawalCompressorV311Contract, WithdrawalCompressorV313Contract, createRedemptionLogger, createWithdrawalCompressor, decodeDelayedIntent, encodeDelayedIntent, getWithdrawalCompressorAddress, iCreditAccountAbi, toClaimableWithdrawal, toPendingWithdrawal, toRequestableWithdrawal, toWithdrawalStatus };

package/dist/esm/onchain/base/TokensMeta.js

@@ -7,6 +7,7 @@ import "../utils/index.js";
 import { iExpirableAbi } from "../../abi/iExpirable.js";
 import { iStateSerializerAbi } from "../../abi/iStateSerializer.js";
 import { iVersionAbi } from "../../abi/iVersion.js";
+import { SdkRWADataNotLoadedError } from "../core/errors.js";
 import { executeMulticallBatches } from "../utils/viem/executeMulticallBatches.js";
 //#region src/onchain/base/TokensMeta.ts
 /**
@@ -143,6 +144,7 @@ var TokensMeta = class extends AddressMap {
 	unwrapRWA(token) {
 		const meta = this.get(token);
 		if (!meta || !this.isRWAUnderlying(meta)) return token;
+		if (!meta.asset) throw new SdkRWADataNotLoadedError(token, meta.symbol, meta.contractType);
 		if (!this.has(meta.asset)) {
 			this.#logger?.debug(`no token meta for ${meta.asset} wrapped by ${token}, reporting the wrapper instead`);
 			return token;
@@ -282,6 +284,7 @@ var TokensMeta = class extends AddressMap {
 			update.contractType = contractType;
 			update.serializedParams = serializeResp.status === "success" ? serializeResp.result : void 0;
 			this.#logger?.debug(`token ${meta.symbol} is ${contractType}`);
+			if (contractType.startsWith("RWA_UNDERLYING::") && !("asset" in update && update.asset)) this.#logger?.warn(`token ${meta.symbol} (${token}) is ${contractType} but RWA compressor data was not loaded — pass \`rwaFactories\` to attach options`);
 		}
 		if (isExpiredResp.status === "success") {
 			update.isExpired = isExpiredResp.result;

package/dist/esm/onchain/chain/detectNetwork.js

@@ -1,5 +1,5 @@
-import { chains } from "./chains.js";
 import { ierc20Abi } from "../../abi/iERC20.js";
+import { chains } from "./chains.js";
 //#region src/onchain/chain/detectNetwork.ts
 /**
 * Detects the network type from the given client.

package/dist/esm/onchain/constants/index.js

@@ -1,8 +1,8 @@
 import { ADDRESS_PROVIDER_V310, AP_ACCOUNT_FACTORY, AP_ACL, AP_BOT_LIST, AP_BYTECODE_REPOSITORY, AP_CONTRACTS_REGISTER, AP_CONTROLLER_TIMELOCK, AP_CREDIT_ACCOUNT_COMPRESSOR, AP_CREDIT_SUITE_COMPRESSOR, AP_DATA_COMPRESSOR, AP_DELEVERAGE_BOT_HV, AP_DELEVERAGE_BOT_LV, AP_DELEVERAGE_BOT_PEGGED, AP_GAUGE_COMPRESSOR, AP_GEAR_STAKING, AP_GEAR_TOKEN, AP_INFLATION_ATTACK_BLOCKER, AP_INSOLVENCY_CHECKER, AP_MARKET_COMPRESSOR, AP_MARKET_CONFIGURATOR, AP_PARTIAL_LIQUIDATION_BOT, AP_PERIPHERY_COMPRESSOR, AP_PRICE_FEED_COMPRESSOR, AP_PRICE_FEED_STORE, AP_PRICE_ORACLE, AP_REDEMPTION_LOGGER, AP_REWARDS_COMPRESSOR, AP_ROUTER, AP_RWA_COMPRESSOR, AP_TOKEN_COMPRESSOR, AP_TREASURY, AP_WETH_GATEWAY, AP_WETH_TOKEN, AP_ZAPPER_REGISTER, AP_ZERO_PRICE_FEED, NO_VERSION } from "./address-provider.js";
 import { ADDRESS_0X0, MULTICALL_ADDRESS, NATIVE_ADDRESS, NOT_DEPLOYED } from "./addresses.js";
 import { BotPermissions, botPermissionsToString } from "./bot-permissions.js";
-import { DUST_THRESHOLD, LEVERAGE_DECIMALS, MAX_INT, MAX_UINT16, MAX_UINT256, MIN_INT96, PERCENTAGE_DECIMALS, PERCENTAGE_FACTOR, PERCENTAGE_FACTOR_1KK, PRICE_DECIMALS, PRICE_DECIMALS_POW, RAY, RAY_DECIMALS_POW, SECONDS_PER_YEAR, SLIPPAGE_DECIMALS, WAD, WAD_DECIMALS_POW, halfRAY } from "./math.js";
+import { DUST_THRESHOLD, LEVERAGE_DECIMALS, MAX_INT, MAX_UINT16, MAX_UINT256, MIN_INT96, PERCENTAGE_DECIMALS, PERCENTAGE_FACTOR, PERCENTAGE_FACTOR_1KK, PRICE_DECIMALS, PRICE_DECIMALS_POW, RAY, RAY_DECIMALS_POW, SECONDS_PER_YEAR, SLIPPAGE_DECIMALS, WAD, WAD_DECIMALS_POW, halfRAY, isZeroBalance } from "./math.js";
 import { BLOCKS_PER_WEEK_BY_NETWORK, RAMP_DURATION_BY_NETWORK } from "./networks.js";
 import { PERIPHERY_CONTRACTS } from "./periphery.js";
 import { VERSION_RANGE_310, isV310, isVersionRange } from "./versions.js";
-export { ADDRESS_0X0, ADDRESS_PROVIDER_V310, AP_ACCOUNT_FACTORY, AP_ACL, AP_BOT_LIST, AP_BYTECODE_REPOSITORY, AP_CONTRACTS_REGISTER, AP_CONTROLLER_TIMELOCK, AP_CREDIT_ACCOUNT_COMPRESSOR, AP_CREDIT_SUITE_COMPRESSOR, AP_DATA_COMPRESSOR, AP_DELEVERAGE_BOT_HV, AP_DELEVERAGE_BOT_LV, AP_DELEVERAGE_BOT_PEGGED, AP_GAUGE_COMPRESSOR, AP_GEAR_STAKING, AP_GEAR_TOKEN, AP_INFLATION_ATTACK_BLOCKER, AP_INSOLVENCY_CHECKER, AP_MARKET_COMPRESSOR, AP_MARKET_CONFIGURATOR, AP_PARTIAL_LIQUIDATION_BOT, AP_PERIPHERY_COMPRESSOR, AP_PRICE_FEED_COMPRESSOR, AP_PRICE_FEED_STORE, AP_PRICE_ORACLE, AP_REDEMPTION_LOGGER, AP_REWARDS_COMPRESSOR, AP_ROUTER, AP_RWA_COMPRESSOR, AP_TOKEN_COMPRESSOR, AP_TREASURY, AP_WETH_GATEWAY, AP_WETH_TOKEN, AP_ZAPPER_REGISTER, AP_ZERO_PRICE_FEED, BLOCKS_PER_WEEK_BY_NETWORK, BotPermissions, DUST_THRESHOLD, LEVERAGE_DECIMALS, MAX_INT, MAX_UINT16, MAX_UINT256, MIN_INT96, MULTICALL_ADDRESS, NATIVE_ADDRESS, NOT_DEPLOYED, NO_VERSION, PERCENTAGE_DECIMALS, PERCENTAGE_FACTOR, PERCENTAGE_FACTOR_1KK, PERIPHERY_CONTRACTS, PRICE_DECIMALS, PRICE_DECIMALS_POW, RAMP_DURATION_BY_NETWORK, RAY, RAY_DECIMALS_POW, SECONDS_PER_YEAR, SLIPPAGE_DECIMALS, VERSION_RANGE_310, WAD, WAD_DECIMALS_POW, botPermissionsToString, halfRAY, isV310, isVersionRange };
+export { ADDRESS_0X0, ADDRESS_PROVIDER_V310, AP_ACCOUNT_FACTORY, AP_ACL, AP_BOT_LIST, AP_BYTECODE_REPOSITORY, AP_CONTRACTS_REGISTER, AP_CONTROLLER_TIMELOCK, AP_CREDIT_ACCOUNT_COMPRESSOR, AP_CREDIT_SUITE_COMPRESSOR, AP_DATA_COMPRESSOR, AP_DELEVERAGE_BOT_HV, AP_DELEVERAGE_BOT_LV, AP_DELEVERAGE_BOT_PEGGED, AP_GAUGE_COMPRESSOR, AP_GEAR_STAKING, AP_GEAR_TOKEN, AP_INFLATION_ATTACK_BLOCKER, AP_INSOLVENCY_CHECKER, AP_MARKET_COMPRESSOR, AP_MARKET_CONFIGURATOR, AP_PARTIAL_LIQUIDATION_BOT, AP_PERIPHERY_COMPRESSOR, AP_PRICE_FEED_COMPRESSOR, AP_PRICE_FEED_STORE, AP_PRICE_ORACLE, AP_REDEMPTION_LOGGER, AP_REWARDS_COMPRESSOR, AP_ROUTER, AP_RWA_COMPRESSOR, AP_TOKEN_COMPRESSOR, AP_TREASURY, AP_WETH_GATEWAY, AP_WETH_TOKEN, AP_ZAPPER_REGISTER, AP_ZERO_PRICE_FEED, BLOCKS_PER_WEEK_BY_NETWORK, BotPermissions, DUST_THRESHOLD, LEVERAGE_DECIMALS, MAX_INT, MAX_UINT16, MAX_UINT256, MIN_INT96, MULTICALL_ADDRESS, NATIVE_ADDRESS, NOT_DEPLOYED, NO_VERSION, PERCENTAGE_DECIMALS, PERCENTAGE_FACTOR, PERCENTAGE_FACTOR_1KK, PERIPHERY_CONTRACTS, PRICE_DECIMALS, PRICE_DECIMALS_POW, RAMP_DURATION_BY_NETWORK, RAY, RAY_DECIMALS_POW, SECONDS_PER_YEAR, SLIPPAGE_DECIMALS, VERSION_RANGE_310, WAD, WAD_DECIMALS_POW, botPermissionsToString, halfRAY, isV310, isVersionRange, isZeroBalance };

package/dist/esm/onchain/constants/math.js

@@ -20,5 +20,15 @@ const SLIPPAGE_DECIMALS = 100n;
 * Token balances at or below this threshold are treated as dust and ignored.
 **/
 const DUST_THRESHOLD = 10n;
+/**
+* Whether a balance is nothing worth acting on.
+*
+* The threshold is a dust floor, not a zero test: rounding leaves amounts that
+* are technically non-zero and worthless, and a form that offered to spend one
+* would build a transaction nobody wants.
+*/
+function isZeroBalance(balance) {
+	return (balance ?? 0n) <= DUST_THRESHOLD;
+}
 //#endregion
-export { DUST_THRESHOLD, LEVERAGE_DECIMALS, MAX_INT, MAX_UINT16, MAX_UINT256, MIN_INT96, PERCENTAGE_DECIMALS, PERCENTAGE_FACTOR, PERCENTAGE_FACTOR_1KK, PRICE_DECIMALS, PRICE_DECIMALS_POW, RAY, RAY_DECIMALS_POW, SECONDS_PER_YEAR, SLIPPAGE_DECIMALS, WAD, WAD_DECIMALS_POW, halfRAY };
+export { DUST_THRESHOLD, LEVERAGE_DECIMALS, MAX_INT, MAX_UINT16, MAX_UINT256, MIN_INT96, PERCENTAGE_DECIMALS, PERCENTAGE_FACTOR, PERCENTAGE_FACTOR_1KK, PRICE_DECIMALS, PRICE_DECIMALS_POW, RAY, RAY_DECIMALS_POW, SECONDS_PER_YEAR, SLIPPAGE_DECIMALS, WAD, WAD_DECIMALS_POW, halfRAY, isZeroBalance };

package/dist/esm/onchain/core/errors.js

@@ -75,5 +75,22 @@ var SdkSyncFailedError = class extends BaseError {
 		this.perChainErrors = perChainErrors;
 	}
 };
+/**
+* Thrown when a token is an RWA underlying (`RWA_UNDERLYING::*`) but compressor
+* fields such as `asset` / `rwaFactory` were never loaded. Typical cause:
+* attaching markets that include RWA pools without passing `rwaFactories`.
+*/
+var SdkRWADataNotLoadedError = class extends BaseError {
+	name = "SdkRWADataNotLoadedError";
+	token;
+	symbol;
+	contractType;
+	constructor(token, symbol, contractType) {
+		super(`token ${symbol} (${token}) has contract type ${contractType} but RWA compressor data was not loaded — pass \`rwaFactories\` to attach options`);
+		this.token = token;
+		this.symbol = symbol;
+		this.contractType = contractType;
+	}
+};
 //#endregion
-export { ChainNotConfiguredError, SdkAlreadyAttachedError, SdkChainMismatchError, SdkMissingChainStateError, SdkNotAttachedError, SdkStateVersionMismatchError, SdkSyncFailedError };
+export { ChainNotConfiguredError, SdkAlreadyAttachedError, SdkChainMismatchError, SdkMissingChainStateError, SdkNotAttachedError, SdkRWADataNotLoadedError, SdkStateVersionMismatchError, SdkSyncFailedError };

package/dist/esm/onchain/core/index.js

@@ -1,5 +1,5 @@
+import { ChainNotConfiguredError, SdkAlreadyAttachedError, SdkChainMismatchError, SdkMissingChainStateError, SdkNotAttachedError, SdkRWADataNotLoadedError, SdkStateVersionMismatchError, SdkSyncFailedError } from "./errors.js";
 import { AddressProviderV310Contract } from "./AddressProviderV310Contract.js";
 import { createAddressProvider, hydrateAddressProvider } from "./createAddressProvider.js";
-import { ChainNotConfiguredError, SdkAlreadyAttachedError, SdkChainMismatchError, SdkMissingChainStateError, SdkNotAttachedError, SdkStateVersionMismatchError, SdkSyncFailedError } from "./errors.js";
 import "./types.js";
-export { AddressProviderV310Contract, ChainNotConfiguredError, SdkAlreadyAttachedError, SdkChainMismatchError, SdkMissingChainStateError, SdkNotAttachedError, SdkStateVersionMismatchError, SdkSyncFailedError, createAddressProvider, hydrateAddressProvider };
+export { AddressProviderV310Contract, ChainNotConfiguredError, SdkAlreadyAttachedError, SdkChainMismatchError, SdkMissingChainStateError, SdkNotAttachedError, SdkRWADataNotLoadedError, SdkStateVersionMismatchError, SdkSyncFailedError, createAddressProvider, hydrateAddressProvider };