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

package/dist/esm/preview/preview/previewOperation.js

@@ -69,7 +69,7 @@ async function previewMulticallOperation(input, operation, options) {
 		creditManager: operation.creditManager,
 		intent: delayed.intent,
 		instantPreview,
-		delayedPreview: buildDelayedPreview(after.account, before, delayed, convert, receivedToken)
+		delayedPreview: buildDelayedPreview(after.account, before, delayed, convert, receivedToken, sdk)
 	};
 }
 //#endregion

package/dist/esm/preview/simulate/simulatePoolOperation.js

@@ -1,5 +1,5 @@
-import { iPoolV310Abi } from "../../abi/310/generated.js";
 import { iZapperAbi } from "../../abi/iZapper.js";
+import { iPoolV310Abi } from "../../abi/310/generated.js";
 import { asPreviewSimulationError } from "./errors.js";
 //#region src/preview/simulate/simulatePoolOperation.ts
 function previewRead(operation) {

package/dist/esm/preview/trace/extractTransfers.js

@@ -1,6 +1,6 @@
+import { ierc20Abi } from "../../abi/iERC20.js";
 import { iCreditFacadeV310Abi } from "../../abi/310/generated.js";
 import { AddressMap } from "../../sdk/utils/AddressMap.js";
-import { ierc20Abi } from "../../abi/iERC20.js";
 import "../../sdk/index.js";
 import { UnexpectedFacadeEventOrderError } from "./errors.js";
 import { getAddress, isAddressEqual, parseEventLogs } from "viem";

package/dist/esm/sdk/MultichainSDK.js

@@ -68,7 +68,6 @@ var MultichainSDK = class {
 			const perChainOpts = options?.perChain?.[network] ?? {};
 			return sdk.attach({
 				...perChainOpts,
-				loadZappers: perChainOpts.loadZappers ?? options?.loadZappers,
 				redstone: {
 					...options?.redstone,
 					cache: this.#redstoneCache,
@@ -88,7 +87,7 @@ var MultichainSDK = class {
 	*   state and `allowMissingChains` is not set.
 	*/
 	hydrate(state, options) {
-		if (state.version !== 1) throw new SdkStateVersionMismatchError(1, state.version);
+		if (state.version !== 2) throw new SdkStateVersionMismatchError(2, state.version);
 		if (options?.redstone) this.#redstoneCache = new PriceUpdatesCache({
 			ttl: options.redstone.cacheTTL ?? 225e3,
 			historical: !!options.redstone.historicTimestamp
@@ -168,7 +167,7 @@ var MultichainSDK = class {
 	**/
 	get state() {
 		return {
-			version: 1,
+			version: 2,
 			chains: [...this.#chains.values()].map((sdk) => sdk.state)
 		};
 	}
@@ -178,7 +177,7 @@ var MultichainSDK = class {
 	*/
 	stateHuman(raw) {
 		return {
-			version: 1,
+			version: 2,
 			chains: [...this.#chains.values()].map((sdk) => sdk.stateHuman(raw))
 		};
 	}

package/dist/esm/sdk/OnchainSDK.js

@@ -7,6 +7,7 @@ import "./constants/index.js";
 import { formatTimestamp } from "./utils/formatter.js";
 import { toAddress } from "./utils/toAddress.js";
 import "./utils/index.js";
+import { executeMulticallBatches } from "./utils/viem/executeMulticallBatches.js";
 import { ChainContractsRegister } from "./base/ChainContractsRegister.js";
 import "./base/index.js";
 import { executeDelegatedMulticalls } from "./utils/viem/executeDelegatedMulticalls.js";
@@ -40,7 +41,7 @@ import { createPublicClient, fallback, http, parseEventLogs } from "viem";
 * Serialised state format version, checked during hydration to detect
 * incompatible snapshots.
 **/
-const STATE_VERSION = 1;
+const STATE_VERSION = 2;
 /**
 * @internal
 * Creates a viem `PublicClient` from the given connection options.
@@ -150,7 +151,7 @@ var OnchainSDK = class extends ChainContractsRegister {
 	*/
 	async attach(options) {
 		if (this.#attached) throw new SdkAlreadyAttachedError();
-		const { addressProvider = ADDRESS_PROVIDER_V310, blockNumber, ignoreUpdateablePrices, ignoreMarkets, marketConfigurators: mcs, redstone, loadZappers } = options ?? {};
+		const { addressProvider = ADDRESS_PROVIDER_V310, blockNumber, ignoreUpdateablePrices, ignoreMarkets, marketConfigurators: mcs, redstone } = options ?? {};
 		const marketConfigurators = mcs ?? TypedObjectUtils.keys(this.client.chain.defaultMarketConfigurators);
 		const rwaFactories = options?.rwaFactories ?? this.client.chain.rwaFactories;
 		this.logger?.info({
@@ -174,19 +175,15 @@ var OnchainSDK = class extends ChainContractsRegister {
 		this.#marketRegister = new MarketRegister(this, ignoreMarkets);
 		if (!marketConfigurators.length) this.logger?.warn("no market configurators provided, skipping market loading");
 		else {
+			const priceUpdates = await this.#getPriceUpdateTxs(marketConfigurators, ignoreUpdateablePrices);
+			this.logger?.debug({ configurators: marketConfigurators }, `calling getMarkets with ${priceUpdates.length} price updates in block ${this.currentBlock}`);
 			const delegated = [...this.#marketRegister.getLoadMulticalls(marketConfigurators), ...this.#rwa.getLoadMulticalls(marketConfigurators, rwaFactories)];
-			let txs = [];
-			if (!ignoreUpdateablePrices) {
-				const updatables = await this.#priceFeeds.getPartialUpdatablePriceFeeds(marketConfigurators);
-				txs = (await this.#priceFeeds.generatePriceFeedsUpdateTxs(updatables)).txs;
-			}
-			this.logger?.debug({ configurators: marketConfigurators }, `calling getMarkets with ${txs.length} price updates in block ${this.currentBlock}`);
 			await executeDelegatedMulticalls(this.client, delegated, {
-				priceUpdates: txs,
+				priceUpdates,
 				blockNumber: this.currentBlock,
 				gas: this.gasLimit
 			});
-			if (loadZappers) await this.#marketRegister.loadZappers();
+			await this.#warmup();
 		}
 		const pluginsList = TypedObjectUtils.entries(this.plugins);
 		(await Promise.allSettled(pluginsList.map(([name, plugin]) => {
@@ -203,6 +200,36 @@ var OnchainSDK = class extends ChainContractsRegister {
 		this.#attached = true;
 	}
 	/**
+	* @internal
+	* Pass 0 of attach: resolves the price updates that the market reads of
+	* pass 1 are simulated with.
+	*
+	* @param configurators - Market configurators whose feeds are considered.
+	* @param ignoreUpdateablePrices - When `true`, no updates are fetched.
+	**/
+	async #getPriceUpdateTxs(configurators, ignoreUpdateablePrices) {
+		if (ignoreUpdateablePrices) return [];
+		const updatables = await this.priceFeeds.getPartialUpdatablePriceFeeds(configurators);
+		const { txs } = await this.priceFeeds.generatePriceFeedsUpdateTxs(updatables);
+		return txs;
+	}
+	/**
+	* @internal
+	* Pass 2 of attach: loads the data that is read synchronously afterwards
+	* (zappers, withdrawable assets, extended token data) in a single multicall.
+	*
+	* Also re-run after a sync that reloaded the markets these caches derive from.
+	*
+	* @param force - Reload caches that are already populated.
+	**/
+	async #warmup(force = false) {
+		await executeMulticallBatches(this.client, [
+			this.marketRegister.getLoadZappersMulticall(force),
+			...this.#withdrawalCompressor ? [this.#withdrawalCompressor.getLoadWithdrawableAssetsMulticall(force)] : [],
+			this.tokensMeta.getLoadTokenDataMulticall()
+		], { blockNumber: this.currentBlock });
+	}
+	/**
 	* Restores SDK state from a previously serialised {@link GearboxState}
 	* snapshot, without making any on-chain calls.
 	*
@@ -214,7 +241,7 @@ var OnchainSDK = class extends ChainContractsRegister {
 	*/
 	hydrate(state, options) {
 		if (this.#attached) throw new SdkAlreadyAttachedError();
-		if (state.version !== 1) throw new SdkStateVersionMismatchError(1, state.version);
+		if (state.version !== 2) throw new SdkStateVersionMismatchError(2, state.version);
 		if (state.network !== this.networkType) throw new SdkChainMismatchError(this.networkType, state.network);
 		const { ignoreMarkets, redstone } = options ?? {};
 		this.logger?.info({ networkType: this.networkType }, "hydrating sdk state");
@@ -228,6 +255,7 @@ var OnchainSDK = class extends ChainContractsRegister {
 		this.#rwa = new RWARegistry(this);
 		this.#rwa.setState(state.rwa);
 		if (state.withdrawals) this.#withdrawalCompressor?.hydrate(state.withdrawals);
+		if (state.tokens) this.tokensMeta.hydrate(state.tokens);
 		for (const [name, plugin] of TypedObjectUtils.entries(this.plugins)) {
 			const pluginState = state.plugins[name];
 			if (plugin.hydrate && pluginState) {
@@ -273,13 +301,14 @@ var OnchainSDK = class extends ChainContractsRegister {
 	/** Serialisable snapshot of the current SDK state. */
 	get state() {
 		return {
-			version: 1,
+			version: 2,
 			network: this.networkType,
 			chainId: this.chainId,
 			currentBlock: this.currentBlock,
 			timestamp: this.timestamp,
 			addressProvider: this.addressProvider.state,
 			...this.marketRegister.state,
+			tokens: this.tokensMeta.state,
 			rwa: this.#rwa.state,
 			withdrawals: this.#withdrawalCompressor?.state,
 			plugins: Object.fromEntries(TypedObjectUtils.entries(this.plugins).map(([name, plugin]) => [name, plugin.loaded ? {
@@ -338,7 +367,7 @@ var OnchainSDK = class extends ChainContractsRegister {
 			}
 			this.#currentBlock = blockNumber;
 			this.#timestamp = timestamp;
-			await this.marketRegister.syncState(ignoreUpdateablePrices);
+			if (await this.marketRegister.syncState(ignoreUpdateablePrices, this.#rwa.getSyncMulticalls())) await this.#warmup(true);
 			const pluginsList = TypedObjectUtils.entries(this.plugins);
 			(await Promise.allSettled(pluginsList.map(([name, plugin]) => {
 				if (plugin.syncState) {

package/dist/esm/sdk/accounts/CreditAccountsServiceV310.js

@@ -1,3 +1,5 @@
+import { iBaseRewardPoolAbi } from "../../abi/iBaseRewardPool.js";
+import { ierc4626AdapterAbi } from "../../abi/ierc4626Adapter.js";
 import { AP_REWARDS_COMPRESSOR } from "../constants/address-provider.js";
 import { ADDRESS_0X0 } from "../constants/addresses.js";
 import { MAX_UINT256 } from "../constants/math.js";
@@ -8,8 +10,6 @@ import "../base/index.js";
 import { AccountBotsService } from "./bots/AccountBotsService.js";
 import "./bots/index.js";
 import { rewardsCompressorAbi } from "../../abi/compressors/rewardsCompressor.js";
-import { iBaseRewardPoolAbi } from "../../abi/iBaseRewardPool.js";
-import { ierc4626AdapterAbi } from "../../abi/ierc4626Adapter.js";
 import { expectedBalanceDeltas } from "../market/credit/expectedBalanceDeltas.js";
 import "../market/index.js";
 import { CreditAccountCompressor } from "./credit-account-compressor/CreditAccountCompressor.js";
@@ -56,12 +56,6 @@ var CreditAccountsServiceV310 = class extends SDKConstruct {
 		return this.#compressor.getBorrowerCreditAccounts(borrower, options, blockNumber);
 	}
 	/**
-	* {@inheritDoc ICreditAccountsService.listPositions}
-	**/
-	async listPositions(props) {
-		return this.#compressor.listPositions(props);
-	}
-	/**
 	* {@inheritDoc ICreditAccountsService.getRewards}
 	**/
 	async getRewards(creditAccount) {
@@ -382,7 +376,7 @@ var CreditAccountsServiceV310 = class extends SDKConstruct {
 				calls.push(facade.prepareIncreaseDebt(op.amount));
 				break;
 			case "decreaseDebt":
-				calls.push(facade.prepareChangeDebt(op.amount, true));
+				calls.push(op.full ? facade.prepareDecreaseDebtFull() : facade.prepareChangeDebt(op.amount, true));
 				break;
 			case "addCollateral":
 				calls.push(...facade.prepareAddCollateral([{
@@ -391,7 +385,7 @@ var CreditAccountsServiceV310 = class extends SDKConstruct {
 				}], {}));
 				break;
 			case "withdrawCollateral":
-				calls.push(facade.prepareWithdrawCollateral(op.token, op.amount, op.to));
+				calls.push(facade.prepareWithdrawCollateral(op.token, op.all ? MAX_UINT256 : op.amount, op.to));
 				break;
 			case "swap":
 			case "wrapRwaCollateral":

package/dist/esm/sdk/accounts/credit-account-compressor/CreditAccountCompressor.js

@@ -1,4 +1,3 @@
-import { AddressMap } from "../../utils/AddressMap.js";
 import { AddressSet } from "../../utils/AddressSet.js";
 import { AP_CREDIT_ACCOUNT_COMPRESSOR } from "../../constants/address-provider.js";
 import { ADDRESS_0X0 } from "../../constants/addresses.js";
@@ -9,11 +8,8 @@ import { hexEq } from "../../utils/hex.js";
 import "../../utils/index.js";
 import { SDKConstruct } from "../../base/SDKConstruct.js";
 import "../../base/index.js";
-import { borrowApyBps, healthFactorBps, positionLeverage, usdToNumber } from "../../market/math.js";
-import { dominantCollateral } from "../../market/credit/dominantCollateral.js";
 import { simulateWithPriceUpdates } from "../../utils/viem/simulateWithPriceUpdates.js";
 import "../../utils/viem/index.js";
-import "../../market/index.js";
 import { iRWAFactoryAbi } from "../../../abi/rwa/iRWAFactory.js";
 import { CreditAccountCompressorV310Contract } from "./CreditAccountCompressorV310Contract.js";
 //#region src/sdk/accounts/credit-account-compressor/CreditAccountCompressor.ts
@@ -21,9 +17,8 @@ import { CreditAccountCompressorV310Contract } from "./CreditAccountCompressorV3
 * Reads credit accounts of the current chain.
 *
 * Stitches the credit account compressor together with the RWA factories (for
-* accounts owned via an investor EOA) and with the withdrawal compressor (for
-* assets that are on their way out of an account), and describes the result
-* either as raw account data or as {@link StrategyPosition}s.
+* accounts owned via an investor EOA), and describes the result as raw
+* account data.
 *
 * TODO: create and deploy new compressor contract onchain to avoid all this stitching
 **/
@@ -173,89 +168,6 @@ var CreditAccountCompressor = class extends SDKConstruct {
 		return filtered.sort((a, b) => Number(a.healthFactor - b.healthFactor));
 	}
 	/**
-	* Describes all credit accounts of a wallet as strategy positions.
-	*
-	* @param props - {@link ListStrategyPositionsProps}
-	**/
-	async listPositions(props) {
-		const { owner, includeZeroDebt, blockNumber } = props;
-		const [accounts] = await Promise.all([this.getBorrowerCreditAccounts(owner, { includeZeroDebt }, blockNumber), this.sdk.withdrawalCompressor?.loadWithdrawableAssets(void 0, blockNumber)]);
-		const describable = accounts.filter((ca) => {
-			if (!ca.success) this.logger?.warn(`cannot describe position of ${this.labelAddress(ca.creditAccount)}: collateral computation failed`);
-			return ca.success;
-		});
-		const withdrawals = await Promise.all(describable.map((ca) => this.#accountWithdrawals(ca, blockNumber)));
-		return describable.map((ca, i) => this.#toStrategyPosition(ca, withdrawals[i] ?? new AddressMap()));
-	}
-	/**
-	* Builds one strategy position from an account snapshot.
-	*
-	* @param withdrawals - Delayed withdrawals of the account, keyed by the
-	* phantom token that represents them on it.
-	**/
-	#toStrategyPosition(ca, withdrawals) {
-		const suite = this.sdk.marketRegister.findCreditManager(ca.creditManager);
-		const { market } = suite;
-		const { priceOracle } = market;
-		const { pool } = market.pool;
-		const token = this.sdk.tokensMeta.mustGetToken(market.unwrappedUnderlying);
-		const totalDebtValue = ca.debt + ca.accruedInterest + ca.accruedFees;
-		const collateral = dominantCollateral(ca, market);
-		return {
-			kind: "strategy",
-			chainId: this.sdk.chainId,
-			creditManager: ca.creditManager,
-			creditAccount: ca.creditAccount,
-			name: collateral ? suite.strategyName(collateral) : token.symbol,
-			targetCollateral: collateral ? this.sdk.tokensMeta.mustGetToken(collateral) : null,
-			leverage: positionLeverage(totalDebtValue, ca.totalValue),
-			borrowApy: borrowApyBps(pool.baseInterestRate, suite.creditManager.feeInterest),
-			totalDebt: {
-				token,
-				value: totalDebtValue,
-				valueUsd: usdToNumber(ca.totalDebtUSD)
-			},
-			totalValue: {
-				token,
-				value: ca.totalValue,
-				valueUsd: usdToNumber(ca.totalValueUSD)
-			},
-			healthFactor: healthFactorBps(ca.healthFactor),
-			collaterals: ca.tokens.flatMap((t) => {
-				if ((t.mask & ca.enabledTokensMask) === 0n || t.balance <= 10n) return [];
-				return [{
-					collateral: priceOracle.toTokenAmount(t.token, t.balance),
-					quota: priceOracle.toTokenAmount(market.underlying, t.quota),
-					withdrawals: withdrawals.get(t.token) ?? []
-				}];
-			})
-		};
-	}
-	/**
-	* Delayed withdrawals of one account, keyed by the phantom token that
-	* represents them on it, so that each collateral row can pick up its own.
-	**/
-	async #accountWithdrawals(ca, blockNumber) {
-		const compressor = this.sdk.withdrawalCompressor;
-		const byPhantomToken = new AddressMap(void 0, "accountWithdrawals");
-		const holdsPhantomToken = ca.tokens.some((t) => t.balance > 10n && compressor?.getWithdrawalSourceToken(t.token) !== void 0);
-		if (!compressor || !holdsPhantomToken) return byPhantomToken;
-		const { priceOracle } = this.sdk.marketRegister.findByCreditManager(ca.creditManager);
-		const { claimable, pending } = await compressor.getCurrentWithdrawals(ca.creditAccount, blockNumber);
-		const add = (w, outputs, claimableAt) => {
-			const assets = outputs.map((o) => ({
-				isDelayed: true,
-				...priceOracle.toTokenAmount(o.token, o.amount),
-				redeemer: w.redeemer,
-				claimableAt: claimableAt === void 0 ? void 0 : Number(claimableAt)
-			}));
-			byPhantomToken.upsert(w.withdrawalPhantomToken, [...byPhantomToken.get(w.withdrawalPhantomToken) ?? [], ...assets]);
-		};
-		for (const w of claimable) add(w, w.outputs);
-		for (const w of pending) add(w, w.expectedOutputs, w.claimableAt);
-		return byPhantomToken;
-	}
-	/**
 	* Credit account compressor contract of the current chain.
 	*
 	* Resolved on every access, because the address provider is only populated

package/dist/esm/sdk/accounts/index.js

@@ -5,7 +5,8 @@ import { CreditAccountCompressorV310Contract } from "./credit-account-compressor
 import { CreditAccountCompressor } from "./credit-account-compressor/CreditAccountCompressor.js";
 import "./credit-account-compressor/index.js";
 import { CreditAccountsServiceV310 } from "./CreditAccountsServiceV310.js";
-import { primaryInstantOutput } from "./intents/operations/claim-delayed/index.js";
+import { IntentPreviewError } from "./intents/types.js";
+import { fetchCreditAccountSlice, toCreditAccountSlice } from "./intents/utils/credit-account-slice.js";
 import { CreditAccountOperationsService } from "./intents/index.js";
 import { LIQUIDATION_APPROVAL_BUFFER, LIQUIDATION_COMPRESSOR_V313_ADDRESS } from "./liquidations/constants.js";
 import { LiquidationsService } from "./liquidations/LiquidationsService.js";
@@ -24,4 +25,4 @@ import { toWithdrawalStatus } from "./withdrawal-compressor/types.js";
 import { WithdrawalCompressorV313Contract } from "./withdrawal-compressor/WithdrawalCompressorV313Contract.js";
 import { createWithdrawalCompressor } from "./withdrawal-compressor/createWithdrawalCompressor.js";
 import "./withdrawal-compressor/index.js";
-export { AbstractWithdrawalCompressorContract, AccountBotsService, CreditAccountCompressor, CreditAccountCompressorV310Contract, CreditAccountOperationsService, CreditAccountsServiceV310, DELAYED_INTENT_TYPES, DELAYED_INTENT_VERSION, InvalidDelayedIntentError, LIQUIDATION_APPROVAL_BUFFER, LIQUIDATION_COMPRESSOR_V313_ADDRESS, LiquidationsService, MultichainLiquidationsService, PeripheryCompressorV310Contract, RedemptionLoggerV310Contract, WithdrawalCompressorV310Contract, WithdrawalCompressorV311Contract, WithdrawalCompressorV313Contract, createRedemptionLogger, createWithdrawalCompressor, decodeDelayedIntent, encodeDelayedIntent, getWithdrawalCompressorAddress, iCreditAccountAbi, primaryInstantOutput, toClaimableWithdrawal, toPendingWithdrawal, toRequestableWithdrawal, toWithdrawalStatus };
+export { AbstractWithdrawalCompressorContract, AccountBotsService, CreditAccountCompressor, CreditAccountCompressorV310Contract, CreditAccountOperationsService, CreditAccountsServiceV310, DELAYED_INTENT_TYPES, DELAYED_INTENT_VERSION, IntentPreviewError, InvalidDelayedIntentError, LIQUIDATION_APPROVAL_BUFFER, LIQUIDATION_COMPRESSOR_V313_ADDRESS, LiquidationsService, MultichainLiquidationsService, PeripheryCompressorV310Contract, RedemptionLoggerV310Contract, WithdrawalCompressorV310Contract, WithdrawalCompressorV311Contract, WithdrawalCompressorV313Contract, createRedemptionLogger, createWithdrawalCompressor, decodeDelayedIntent, encodeDelayedIntent, fetchCreditAccountSlice, getWithdrawalCompressorAddress, iCreditAccountAbi, toClaimableWithdrawal, toCreditAccountSlice, toPendingWithdrawal, toRequestableWithdrawal, toWithdrawalStatus };

package/dist/esm/sdk/accounts/intents/guards.js

@@ -0,0 +1,108 @@
+import "../../constants/math.js";
+import "../../constants/index.js";
+import { IntentPreviewError } from "./types.js";
+import { eq } from "./utils/common.js";
+import { isPhantomToken } from "./utils/pick-token.js";
+//#region src/sdk/accounts/intents/guards.ts
+/**
+* What the market itself refuses, checked before anything is quoted.
+*
+* The planners answer for the arithmetic of an intent and the ledger for the
+* balances it moves, but neither can see that the facade is paused or that the
+* pool has run out of what it lends. On-chain those come back as a reverted
+* multicall with a selector no form can explain, so they are read from the
+* loaded market and reported as refusals instead.
+*/
+/**
+* The facade takes no multicall while it is paused or past its expiration, so
+* every intent the engine previews would revert on arrival.
+*/
+function assertMarketOperable(suite) {
+	if (suite.isPaused) throw new IntentPreviewError("marketPaused", `${suite.creditManager.address} is paused`);
+	if (suite.isExpired) throw new IntentPreviewError("marketExpired", `${suite.creditManager.address} expired at ${suite.creditFacade.expirationDate}`);
+}
+/**
+* What the pool will hand this manager in one transaction: the tightest of its
+* free liquidity, the manager's remaining debt limit and the per-block cap the
+* facade puts on a single borrow. A zero multiplier switches borrowing off
+* outright, which reads here as nothing being available.
+*/
+function borrowable(suite) {
+	const { pool } = suite.market.pool;
+	const { maxDebtPerBlockMultiplier, maxDebt } = suite.creditFacade;
+	if (maxDebtPerBlockMultiplier === 0) return 0n;
+	const available = pool.creditManagerDebtParams.get(suite.creditManager.address)?.available;
+	return [
+		pool.availableLiquidity,
+		maxDebt * BigInt(maxDebtPerBlockMultiplier),
+		...available === void 0 ? [] : [available]
+	].reduce((a, b) => a < b ? a : b);
+}
+/** The pool has to be able to lend what the plan means to draw. */
+function assertCanBorrow(suite, amount) {
+	const limit = borrowable(suite);
+	if (amount > limit) throw new IntentPreviewError("insufficientPoolLiquidity", `borrow: ${amount} exceeds what the pool can lend now (${limit})`);
+}
+/**
+* What the account is allowed to end up holding more of than it started with.
+*
+* A forbidden token may be sold and may leave, but its balance must not grow —
+* the facade checks exactly that at the end of the multicall. A token the
+* market takes no quota for is not forbidden, only worthless as collateral:
+* buying one builds a position the collateral check cannot count, so the plan
+* is refused before it is signed rather than after it reverts.
+*
+* The underlying answers to neither rule, and a phantom token is a redemption
+* in flight rather than a holding.
+*/
+function assertGrowthAllowed(args) {
+	const { sdk, suite, market, before, after } = args;
+	const forbidden = forbiddenTokens(suite);
+	const underlying = market.pool.underlying;
+	for (const { token, balance } of after) {
+		if (balance <= (before.find((a) => eq(a.token, token))?.balance ?? 0n)) continue;
+		if (forbidden.some((f) => eq(f, token))) throw new IntentPreviewError("forbiddenToken", `${token} is forbidden in this market and the plan buys more of it`);
+		if (eq(token, underlying) || isPhantomToken(sdk, token)) continue;
+		if (!market.pool.pqk.hasActiveQuota(token)) throw new IntentPreviewError("quotaLimitReached", `${token} takes no quota in this market, so it counts as no collateral`);
+	}
+}
+/** Tokens the facade's mask flags, which is indexed by collateral position. */
+function forbiddenTokens(suite) {
+	const mask = suite.creditFacade.forbiddenTokensMask;
+	if (mask === 0n) return [];
+	return suite.creditManager.collateralTokens.filter((_, i) => (mask & 1n << BigInt(i)) !== 0n);
+}
+/**
+* The facade weighs the account against its debt at the end of every multicall
+* and reverts if the collateral does not cover it, so a plan that lands the
+* account below water is refused here.
+*
+* The bar is the health factor of the state the plan projects: collateral under
+* liquidation thresholds, capped by quota, against the debt. Note that a
+* position already underwater cannot be nursed back one step at a time — the
+* check is on where the transaction ends, not on whether it improved things.
+*
+* @remarks
+* The caller decides the pricing the factor was computed at: main prices, or
+* the safe ones the facade switches to when the call hands funds over. A token
+* whose reserve feed the SDK cannot read keeps its main price, so a plan can
+* still be refused on-chain after passing here.
+*/
+function assertCollateralised(healthFactorBps) {
+	if (healthFactorBps < Number(10000n)) throw new IntentPreviewError("insufficientCollateral", `the account would end at a health factor of ${healthFactorBps}, below 1.0`);
+}
+/**
+* A quota can only be raised as far as the market still has room for: past the
+* token's limit the keeper takes nothing more, whoever is asking.
+*/
+function assertQuotaHeadroom(market, increases) {
+	for (const { token, balance } of increases) {
+		if (balance <= 0n) continue;
+		const quota = market.pool.pqk.quotas.get(token);
+		if (!quota) continue;
+		const left = quota.limit - quota.totalQuoted;
+		if (balance > left) throw new IntentPreviewError("quotaLimitReached", `${token} has ${left} of quota left, the plan needs ${balance}`);
+	}
+}
+//#endregion
+export { assertCanBorrow, assertCollateralised, assertGrowthAllowed, assertMarketOperable, assertQuotaHeadroom, borrowable };