@gearbox-protocol/sdk 16.4.0-next.4 → 16.4.0-next.6

package/dist/cjs/onchain/accounts/intents/utils/common.js

@@ -3,6 +3,24 @@ const require_onchain_utils_AddressMap = require("../../../utils/AddressMap.js")
 //#region src/onchain/accounts/intents/utils/common.ts
 /** Case-insensitive address equality. */
 const eq = (a, b) => a.toLowerCase() === b.toLowerCase();
+/**
+* The suite and market behind a credit manager, or nothing where the register
+* has no entry for it.
+*
+* For the reads a form calls on every keystroke, including before the SDK has
+* finished attaching: a question the register cannot answer yet is not an
+* error. Everything that prepares a transaction wants the throw instead.
+*/
+function resolveCreditManager(sdk, creditManager) {
+	try {
+		return {
+			suite: sdk.marketRegister.findCreditManager(creditManager),
+			market: sdk.marketRegister.findByCreditManager(creditManager)
+		};
+	} catch {
+		return;
+	}
+}
 function toTargetDecimals(fromAmount, fromToken, toToken, sdk) {
 	const fromDecimals = sdk.tokensMeta.get(fromToken)?.decimals ?? 18;
 	const toDecimals = sdk.tokensMeta.get(toToken)?.decimals ?? 18;
@@ -39,5 +57,6 @@ function toRouterCaSlice(creditAccount, expectedBalances = []) {
 }
 //#endregion
 exports.eq = eq;
+exports.resolveCreditManager = resolveCreditManager;
 exports.toRouterCaSlice = toRouterCaSlice;
 exports.toTargetDecimals = toTargetDecimals;

package/dist/cjs/onchain/accounts/intents/utils/credit-account-slice.js

@@ -27,6 +27,26 @@ function toCreditAccountSlice(ca) {
 	};
 }
 /**
+* The slice a flow that has no account yet quotes against.
+*
+* Nothing of it exists on chain until the transaction lands, and nothing has
+* to: the pathfinder is asked about the credit manager, and every balance the
+* flow reasons about is one the transaction itself puts there. The zero
+* address stands in for the account so the shape is complete.
+*/
+function unopenedAccountSlice(args) {
+	return {
+		creditAccount: "0x0000000000000000000000000000000000000000",
+		creditManager: args.creditManager.toLowerCase(),
+		creditFacade: args.creditFacade.toLowerCase(),
+		underlying: args.underlying.toLowerCase(),
+		enabledTokensMask: 0n,
+		totalDebtUSD: 0n,
+		totalDebt: 0n,
+		tokens: []
+	};
+}
+/**
 * Reads an account by address and narrows it to {@link CreditAccountSlice}.
 *
 * The shared read model's `StrategyPosition` carries neither `tokens` nor
@@ -43,3 +63,4 @@ async function fetchCreditAccountSlice(sdk, creditAccount) {
 //#endregion
 exports.fetchCreditAccountSlice = fetchCreditAccountSlice;
 exports.toCreditAccountSlice = toCreditAccountSlice;
+exports.unopenedAccountSlice = unopenedAccountSlice;

package/dist/cjs/onchain/accounts/intents/utils/index.js

@@ -26,7 +26,9 @@ exports.lossRate = require_onchain_accounts_intents_utils_price_impact.lossRate;
 exports.pickFattestNonPhantomToken = require_onchain_accounts_intents_utils_pick_token.pickFattestNonPhantomToken;
 exports.quotasAfterUpdate = require_onchain_accounts_intents_utils_quotas_for_update.quotasAfterUpdate;
 exports.rankAccountTokens = require_onchain_accounts_intents_utils_pick_token.rankAccountTokens;
+exports.resolveCreditManager = require_onchain_accounts_intents_utils_common.resolveCreditManager;
 exports.startProbe = require_onchain_accounts_intents_utils_price_impact.startProbe;
 exports.toCreditAccountSlice = require_onchain_accounts_intents_utils_credit_account_slice.toCreditAccountSlice;
 exports.toRouterCaSlice = require_onchain_accounts_intents_utils_common.toRouterCaSlice;
 exports.toTargetDecimals = require_onchain_accounts_intents_utils_common.toTargetDecimals;
+exports.unopenedAccountSlice = require_onchain_accounts_intents_utils_credit_account_slice.unopenedAccountSlice;

package/dist/cjs/onchain/accounts/intents/withdraw-limits.js

@@ -4,8 +4,8 @@ require("../../utils/index.js");
 const require_onchain_validation_helpers_health_factor_limits = require("../../validation/helpers/health-factor-limits.js");
 require("../../validation/index.js");
 const require_onchain_accounts_intents_utils_common = require("./utils/common.js");
-const require_onchain_accounts_intents_collateral_money = require("./collateral-money.js");
 const require_onchain_accounts_intents_math = require("./math.js");
+const require_onchain_accounts_intents_collateral_valuation = require("./collateral-valuation.js");
 const require_onchain_accounts_intents_view = require("./view.js");
 //#region src/onchain/accounts/intents/withdraw-limits.ts
 /**
@@ -39,7 +39,7 @@ function withdrawLimits(props) {
 * in underlying units.
 *
 * A withdrawal hands funds over, so the facade weighs the account it leaves
-* behind at safe prices rather than main ones — see {@link collateralMoney}.
+* behind at safe prices rather than main ones — see {@link collateralValuation}.
 * That is a second limit on top of the facade's `debtLimits`, and the two are
 * independent: a caller wanting the amount a form may actually offer takes the
 * lesser of this and `maxProportionalWithdrawal`.
@@ -72,20 +72,20 @@ function maxSafeWithdrawal(props) {
 	const view = require_onchain_accounts_intents_view.accountView(creditAccount, sdk);
 	if (view.collateral <= 0n) return 0n;
 	if (view.debt === 0n) return view.collateral;
-	const money = require_onchain_accounts_intents_collateral_money.collateralMoney(creditAccount, sdk);
+	const valuation = require_onchain_accounts_intents_collateral_valuation.collateralValuation(creditAccount, sdk);
 	const source = props.sourceToken ?? view.fattest();
 	const holding = source === void 0 ? void 0 : creditAccount.tokens.find((t) => require_onchain_accounts_intents_utils_common.eq(t.token, source));
 	if (!holding) return view.collateral;
 	let total = 0n;
-	for (const t of creditAccount.tokens) if (money.counts(t)) total += money.weigh(t);
-	const debtUsd = money.mainUsd(money.underlying, view.debt);
+	for (const t of creditAccount.tokens) if (valuation.counts(t)) total += valuation.weigh(t);
+	const debtUsd = valuation.mainUsd(valuation.underlying, view.debt);
 	if (debtUsd === void 0 || debtUsd <= 0n) return view.collateral;
 	const slack = total - debtUsd * targetHF;
 	if (slack < 0n) return 0n;
-	const sourceMainUsd = money.mainUsd(holding.token, holding.balance);
+	const sourceMainUsd = valuation.mainUsd(holding.token, holding.balance);
 	if (sourceMainUsd === void 0 || sourceMainUsd <= 0n) return view.collateral;
-	const sourceRate = money.lt(holding.token) * money.checkedUsd(holding);
-	const tvlUsd = money.mainUsd(money.underlying, view.collateral + view.debt);
+	const sourceRate = valuation.lt(holding.token) * valuation.checkedUsd(holding);
+	const tvlUsd = valuation.mainUsd(valuation.underlying, view.collateral + view.debt);
 	if (tvlUsd === void 0) return view.collateral;
 	const drain = sourceRate * tvlUsd - targetHF * debtUsd * sourceMainUsd;
 	if (drain <= 0n) return view.collateral;

package/dist/cjs/onchain/positions/calcHealthFactor.js

@@ -36,7 +36,7 @@ function calcHealthFactor(props) {
 		const scale = 10n ** BigInt(decimalsByToken.get(token) ?? 18);
 		return amount * price / scale;
 	};
-	const assetMoney = snapshot.assets.reduce((acc, { token, balance }) => {
+	const assetValue = snapshot.assets.reduce((acc, { token, balance }) => {
 		if (balance <= 10n) return acc;
 		const lt = BigInt(lts.get(token) ?? 0);
 		const tokenLtWeighted = (convertToUSD(token, balance, true) ?? 0n) * lt;
@@ -45,8 +45,8 @@ function calcHealthFactor(props) {
 		const quotaWeighted = (convertToUSD(underlying, quotaBalance) ?? 0n) * require_onchain_constants_math.PERCENTAGE_FACTOR;
 		return acc + (quota ? require_onchain_utils_bigint_math.BigIntMath.min(quotaWeighted, tokenLtWeighted) : tokenLtWeighted);
 	}, 0n);
-	const borrowedMoney = convertToUSD(underlying, snapshot.totalDebt) ?? 0n;
-	const hf = borrowedMoney > 0n ? assetMoney / borrowedMoney : 0n;
+	const borrowedValue = convertToUSD(underlying, snapshot.totalDebt) ?? 0n;
+	const hf = borrowedValue > 0n ? assetValue / borrowedValue : 0n;
 	return Number(hf);
 }
 //#endregion

package/dist/cjs/onchain/preview/preview/previewOpenStrategyPosition.js

@@ -18,7 +18,7 @@ function previewOpenStrategyPosition(sdk, input, operation, replay) {
 		warning ??= priced.error;
 		return priced.value;
 	};
-	const netValue = before.balances.sum(price) + after.collateralAdded.sum(price);
+	const netValue = before.balances.sum(price) + after.collateralAdded.sum(price) - after.collateralWithdrawn.sum(price);
 	const unwrapped = require_onchain_preview_preview_unwrapNativeCollateral.unwrapNativeCollateral(after.collateralAdded.toAssets(), value, sdk.addressProvider.getAddress(require_onchain_constants_address_provider.AP_WETH_TOKEN, 0));
 	if (!unwrapped.ok) return unwrapped;
 	const collateral = unwrapped.data;
@@ -28,6 +28,7 @@ function previewOpenStrategyPosition(sdk, input, operation, replay) {
 		...require_model_previews.asEstimated(sdk.positions.projection(snap, { availableLiquidityChange: -account.totalDebt })),
 		targetCollateral: targetAsset ? oracle.toTokenAmount(targetAsset.token, targetAsset.balance) : void 0,
 		collateralAdded: collateral.map((a) => oracle.toTokenAmount(a.token, a.balance)),
+		collateralWithdrawn: after.collateralWithdrawn.toAssets().map((a) => oracle.toTokenAmount(a.token, a.balance)),
 		warning
 	};
 	return require_model_result.sdkOk({

package/dist/cjs/sdk/execute/ExecuteApi.js

@@ -17,6 +17,8 @@ var ExecuteApi = class {
 		switch (request.kind) {
 			case "pool": return poolTx(sdk, request);
 			case "open": return openTx(sdk, request);
+			case "openEmpty": return openEmptyTx(sdk, request);
+			case "borrow": return borrowTx(sdk, request);
 			case "account": return accountTx(sdk, request);
 		}
 	}
@@ -63,17 +65,75 @@ async function openTx(sdk, request) {
 		reopenCreditAccount: state.creditAccount,
 		permits: {},
 		referralCode: 0n,
-		rwaOptions: await openRwaOptions(sdk, request)
+		rwaOptions: await openRwaOptions(sdk, request, request.targetToken)
+	});
+}
+/**
+* The opening with nothing in it: no debt to draw, no collateral to take, no
+* path to run and no quota to buy, so `openCA` is left with the price updates
+* the market demands and the facade's own `openCreditAccount`.
+*
+* Nothing is read off the preparation because there is nothing on it. The
+* account holds no token, so an RWA market has none to gate on either.
+**/
+function openEmptyTx(sdk, request) {
+	return sdk.accounts.openCA({
+		creditManager: request.creditManager,
+		to: request.wallet,
+		collateral: [],
+		ethAmount: 0n,
+		debt: 0n,
+		calls: [],
+		averageQuota: [],
+		minQuota: [],
+		permits: {},
+		referralCode: 0n
+	});
+}
+/**
+* A loan is an opening whose debt leaves again, so it is the same `openCA`
+* with `withdrawToken` set: the facade draws the debt, takes the collateral,
+* runs whatever path buys the payout, and sweeps that payout to the wallet.
+*
+* Both quota branches are the one the state carries. An opening has two
+* because the balances it lands on are a router quote; here the account is
+* left holding the collateral the caller named, and a named amount has no
+* floor to differ from.
+**/
+async function borrowTx(sdk, request) {
+	const { creditManager, wallet, ethAmount, sim } = request;
+	const { state } = sim.data;
+	const collateral = {
+		token: state.collateral.token.address,
+		balance: state.collateral.value
+	};
+	return sdk.accounts.openCA({
+		creditManager,
+		to: wallet,
+		collateral: [collateral],
+		ethAmount,
+		debt: state.totalDebt.value,
+		calls: state.calls,
+		withdrawToken: state.borrowed.token.address,
+		averageQuota: state.quotaIncrease,
+		minQuota: state.quotaIncrease,
+		reopenCreditAccount: state.creditAccount,
+		permits: {},
+		referralCode: 0n,
+		rwaOptions: await openRwaOptions(sdk, request, collateral.token)
 	});
 }
 /**
 * The documented `openCA` contract: ask the market for its open requirements
 * and hand them back as operation args, with the caller's cached signatures
-* attached. `undefined` on non-RWA markets and when no target token is named.
+* attached. `undefined` on non-RWA markets and when no token is named.
+*
+* `token` is the one the account ends up holding, which is what an RWA market
+* gates on: the opening's target, and the borrow's collateral.
 **/
-async function openRwaOptions(sdk, request) {
-	if (!request.targetToken) return;
-	const requirements = await sdk.accounts.getOpenAccountRequirements(request.wallet, request.creditManager, { tokenOutAddress: request.targetToken });
+async function openRwaOptions(sdk, request, token) {
+	if (!token) return;
+	const requirements = await sdk.accounts.getOpenAccountRequirements(request.wallet, request.creditManager, { tokenOutAddress: token });
 	if (requirements?.protocol !== "securitize") return;
 	return {
 		protocol: "securitize",

package/dist/cjs/sdk/prepare/PrepareApi.js

@@ -196,26 +196,33 @@ var PrepareApi = class extends require_onchain_base_MultichainConstruct.Multicha
 		}
 	}
 	/**
+	* {@inheritDoc IOpportunitiesPrepare.openEmptyCreditAccount}
+	**/
+	async openEmptyCreditAccount(strategy) {
+		try {
+			const sdk = await this.#chain(strategy.chainId);
+			const at = stateBlock(sdk);
+			const result = await service(sdk).openEmptyAccountIntent({
+				sdk,
+				creditManager: strategy.creditManager
+			});
+			return result.ok ? require_model_result.sdkOk(at) : methodError(result);
+		} catch (e) {
+			return require_model_result.sdkErr(require_model_errors_prepare_errors.unexpectedFailure(e));
+		}
+	}
+	/**
 	* {@inheritDoc IOpportunitiesPrepare.openNewStrategy}
 	**/
 	async openNewStrategy(strategy, params) {
 		try {
 			const sdk = await this.#chain(strategy.chainId);
 			const at = stateBlock(sdk);
-			if (params.empty) return opened(await service(sdk).openStrategyIntent({
-				sdk,
-				creditManager: strategy.creditManager,
-				empty: true
-			}), at);
 			const targetToken = params.targetToken ?? sdk.marketRegister.findCreditManager(strategy.creditManager).strategyTargetCollateral;
 			if (!targetToken) return require_model_result.sdkErr(require_model_errors_prepare_errors.noStrategyTargetCollateral(strategy.creditManager));
-			let creditAccount;
-			if (params.creditAccount) {
-				const reused = await slice(sdk, params.creditAccount);
-				if (!reused || !(0, viem.isAddressEqual)(reused.creditManager, strategy.creditManager)) return require_model_result.sdkErr(require_model_errors_prepare_errors.creditAccountNotFound(params.creditAccount));
-				if (reused.totalDebt > 0n || reused.tokens.some((t) => t.quota > 0n)) return require_model_result.sdkErr(require_model_errors_prepare_errors.creditAccountNotEmpty(params.creditAccount));
-				creditAccount = reused;
-			}
+			const reused = await reusable(sdk, strategy, params.creditAccount);
+			if (reused && "error" in reused) return reused;
+			const creditAccount = reused?.account;
 			return opened(await service(sdk).openStrategyIntent({
 				sdk,
 				creditManager: strategy.creditManager,
@@ -232,6 +239,30 @@ var PrepareApi = class extends require_onchain_base_MultichainConstruct.Multicha
 		}
 	}
 	/**
+	* {@inheritDoc IOpportunitiesPrepare.borrow}
+	**/
+	async borrow(strategy, params) {
+		try {
+			const sdk = await this.#chain(strategy.chainId);
+			const at = stateBlock(sdk);
+			const reused = await reusable(sdk, strategy, params.creditAccount);
+			if (reused && "error" in reused) return reused;
+			return borrowed(await service(sdk).borrowIntent({
+				sdk,
+				creditManager: strategy.creditManager,
+				collateralToken: params.collateralToken,
+				collateralAmount: params.collateralAmount,
+				borrowToken: params.borrowToken,
+				borrowAmount: params.borrowAmount,
+				slippage: params.slippage,
+				quotaReserve: params.quotaReserve,
+				creditAccount: reused?.account
+			}), at);
+		} catch (e) {
+			return require_model_result.sdkErr(require_model_errors_prepare_errors.unexpectedFailure(e));
+		}
+	}
+	/**
 	* {@inheritDoc IOpportunitiesPrepare.depositStrategy}
 	**/
 	async depositStrategy(position, params) {
@@ -354,6 +385,21 @@ var PrepareApi = class extends require_onchain_base_MultichainConstruct.Multicha
 		});
 	}
 	/**
+	* {@inheritDoc IOpportunitiesPrepare.maxBorrow}
+	**/
+	maxBorrow(strategy, params) {
+		const sdk = this.sdk.chain(strategy.chainId);
+		return service(sdk).maxBorrow({
+			sdk,
+			creditManager: strategy.creditManager,
+			collateralToken: params.collateralToken,
+			collateralAmount: params.collateralAmount,
+			borrowToken: params.borrowToken,
+			targetHF: params.targetHF,
+			quotaReserve: params.quotaReserve
+		});
+	}
+	/**
 	* The account a bare `max*` read weighs. These reads answer a number, not
 	* an envelope, so an account the markets do not hold is thrown rather than
 	* described, see {@link IOpportunitiesPrepare.maxWithdraw}.
@@ -439,6 +485,25 @@ async function slice(sdk, creditAccount) {
 	return data && require_onchain_accounts_intents_utils_credit_account_slice.toCreditAccountSlice(data);
 }
 /**
+* The pre-opened account a request asks to be run on, held to what "pre-opened"
+* means: this manager's, owing nothing and holding no quota.
+*
+* Shared by the two flows that put something on a fresh account — an opening
+* and a borrow — so both hold a reused one to the same terms. Whatever
+* balances sit on it are left to the flow: an opening routes them, a borrow
+* leaves them where they are.
+*
+* @returns Nothing when the request named no account, the refusal to answer
+* with when it named one that does not qualify, and the slice otherwise
+**/
+async function reusable(sdk, strategy, creditAccount) {
+	if (!creditAccount) return;
+	const account = await slice(sdk, creditAccount);
+	if (!account || !(0, viem.isAddressEqual)(account.creditManager, strategy.creditManager)) return require_model_result.sdkErr(require_model_errors_prepare_errors.creditAccountNotFound(creditAccount));
+	if (account.totalDebt > 0n || account.tokens.some((t) => t.quota > 0n)) return require_model_result.sdkErr(require_model_errors_prepare_errors.creditAccountNotEmpty(creditAccount));
+	return { account };
+}
+/**
 * The operation a claim resumes, or `undefined` when there is none to resume:
 * a withdrawal requested without an intent, or one read through a compressor
 * too old to report it. Every intent the engine records can be finished,
@@ -538,6 +603,15 @@ function opened(result, at) {
 }
 /**
 * {@inheritDoc planned}
+**/
+function borrowed(result, at) {
+	return result.ok ? require_model_result.sdkOk({
+		state: result.state,
+		...at
+	}) : methodError(result);
+}
+/**
+* {@inheritDoc planned}
 *
 * Both routes are payload, error and all: `errors` says why a missing one is
 * missing, and it stays on the error when neither route answered, since that is

package/dist/esm/dev/midasUtils.js

@@ -1,5 +1,5 @@
 import { writeAndWait } from "./kycUtils.js";
-import { parseAbi, parseEther } from "viem";
+import { parseAbi, parseEther, toFunctionSelector } from "viem";
 //#region src/dev/midasUtils.ts
 /**
 * Midas vaults inherit their own `Pausable`, whose global pause is guarded by
@@ -9,14 +9,24 @@ const iMidasPausableVaultAbi = parseAbi([
 	"function paused() external view returns (bool)",
 	"function pause() external",
 	"function unpause() external",
+	"function fnPaused(bytes4 fn) external view returns (bool)",
+	"function pauseFn(bytes4 fn) external",
+	"function unpauseFn(bytes4 fn) external",
 	"function pauseAdminRole() external view returns (bytes32)",
 	"function accessControl() external view returns (address)"
 ]);
 const iMidasAccessControlAbi = parseAbi(["function hasRole(bytes32 role, address account) external view returns (bool)", "function grantRole(bytes32 role, address account) external"]);
 /**
-* Unpauses a globally paused Midas issuance vault on an anvil fork, so that
-* `depositInstant` stops reverting with `Pausable: paused`, and returns a
-* callback that restores the original pause state.
+* Selector for `DepositVault.depositInstant(address,uint256,uint256,bytes32)`,
+* the 4-arg mint Gearbox adapters encode. Distinct from the custom-recipient
+* overload.
+*/
+const DEPOSIT_INSTANT_SELECTOR = toFunctionSelector("depositInstant(address,uint256,uint256,bytes32)");
+/**
+* Unpauses a Midas issuance vault on an anvil fork so that `depositInstant`
+* stops reverting with `Pausable: paused` (global) or `Pausable: fn paused`
+* (per-selector), and returns a callback that restores the original pause
+* state of each layer that was cleared.
 *
 * Impersonates `admin` and grants it `pauseAdminRole()` when missing, same as
 * `greenlistMidasGateway` does with the greenlist roles. The grant is not
@@ -24,11 +34,20 @@ const iMidasAccessControlAbi = parseAbi(["function hasRole(bytes32 role, address
 */
 async function unpauseMidasIssuanceVault(props) {
 	const { anvil, vault, admin, logger } = props;
-	if (!await anvil.readContract({
-		address: vault,
-		abi: iMidasPausableVaultAbi,
-		functionName: "paused"
-	})) {
+	const [paused, depositInstantPaused] = await anvil.multicall({
+		allowFailure: false,
+		contracts: [{
+			address: vault,
+			abi: iMidasPausableVaultAbi,
+			functionName: "paused"
+		}, {
+			address: vault,
+			abi: iMidasPausableVaultAbi,
+			functionName: "fnPaused",
+			args: [DEPOSIT_INSTANT_SELECTOR]
+		}]
+	});
+	if (!paused && !depositInstantPaused) {
 		logger?.debug(`midas: issuance vault ${vault} is not paused`);
 		return async () => {};
 	}
@@ -50,7 +69,7 @@ async function unpauseMidasIssuanceVault(props) {
 		functionName: "hasRole",
 		args: [pauseAdminRole, admin]
 	});
-	logger?.debug(`midas: unpausing issuance vault ${vault} as ${admin}, access control ${accessControl}, pause admin role ${pauseAdminRole}`);
+	logger?.debug(`midas: unpausing issuance vault ${vault} as ${admin}, access control ${accessControl}, pause admin role ${pauseAdminRole}` + (paused ? ", global" : "") + (depositInstantPaused ? ", depositInstant" : ""));
 	await anvil.impersonateAccount({ address: admin });
 	try {
 		await anvil.setBalance({
@@ -68,13 +87,21 @@ async function unpauseMidasIssuanceVault(props) {
 			});
 			logger?.debug(`midas: granted pause admin role to ${admin}`);
 		}
-		await writeAndWait(anvil, {
+		if (paused) await writeAndWait(anvil, {
 			account: admin,
 			chain: anvil.chain,
 			address: vault,
 			abi: iMidasPausableVaultAbi,
 			functionName: "unpause"
 		});
+		if (depositInstantPaused) await writeAndWait(anvil, {
+			account: admin,
+			chain: anvil.chain,
+			address: vault,
+			abi: iMidasPausableVaultAbi,
+			functionName: "unpauseFn",
+			args: [DEPOSIT_INSTANT_SELECTOR]
+		});
 	} finally {
 		await anvil.stopImpersonatingAccount({ address: admin });
 	}
@@ -89,13 +116,21 @@ async function unpauseMidasIssuanceVault(props) {
 				address: admin,
 				value: parseEther("100")
 			});
-			await writeAndWait(anvil, {
+			if (paused) await writeAndWait(anvil, {
 				account: admin,
 				chain: anvil.chain,
 				address: vault,
 				abi: iMidasPausableVaultAbi,
 				functionName: "pause"
 			});
+			if (depositInstantPaused) await writeAndWait(anvil, {
+				account: admin,
+				chain: anvil.chain,
+				address: vault,
+				abi: iMidasPausableVaultAbi,
+				functionName: "pauseFn",
+				args: [DEPOSIT_INSTANT_SELECTOR]
+			});
 		} catch (e) {
 			logger?.warn(`midas: failed to pause issuance vault ${vault} back: ${e}`);
 		} finally {

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

@@ -0,0 +1,137 @@
+import { insufficientBalance } from "../../../model/errors/operation-errors.js";
+import { unsupportedCollateralToken } from "../../../model/errors/prepare-errors.js";
+import "../../../model/index.js";
+import { toToken } from "../../validation/helpers/token.js";
+import { IntentPreviewError } from "../../validation/raise.js";
+import "../../validation/index.js";
+import { eq, toTargetDecimals } from "./utils/common.js";
+import { assertCanBorrow, assertCollateralised, assertGrowthAllowed, assertMarketOperable, assertQuotaAvailable } from "./guards.js";
+import { assertDebtLimits } from "./math.js";
+import { unopenedAccountSlice } from "./utils/credit-account-slice.js";
+import { collectPriceImpact } from "./utils/price-impact.js";
+import { getQuotasForUpdate } from "./utils/quotas-for-update.js";
+import { createRouterPaths } from "./utils/router-path.js";
+import "./utils/index.js";
+//#region src/onchain/accounts/intents/borrow.ts
+/**
+* Builds the state a borrow would leave behind.
+*
+* The debt is named rather than derived: a borrow asks for an amount, where an
+* opening asks for a leverage and lets the collateral decide. Everything the
+* loan pays out leaves the account, so the collateral alone backs it — which
+* is what makes the health factor here a straight function of the two amounts.
+*
+* Produces no operation list, as opening never does: the caller hands the
+* numbers and the calls to `sdk.accounts.openCA`, with `withdrawToken` set to
+* the payout.
+*/
+async function buildBorrowState(props) {
+	const { sdk, creditManager, collateralAmount, borrowAmount, slippage = 0, quotaReserve, creditAccount: existing } = props;
+	const suite = sdk.marketRegister.findCreditManager(creditManager);
+	const market = sdk.marketRegister.findByCreditManager(creditManager);
+	assertMarketOperable(suite);
+	const underlying = market.pool.underlying.toLowerCase();
+	const collateralToken = props.collateralToken.toLowerCase();
+	const borrowToken = props.borrowToken.toLowerCase();
+	const convert = (from, to, amount) => market.priceOracle.safeConvert(from, to, amount).value;
+	if (eq(collateralToken, borrowToken)) throw new IntentPreviewError(unsupportedCollateralToken(toToken(sdk, collateralToken)), "borrow: the payout token cannot also be the collateral");
+	const rwaAsset = sdk.tokensMeta.rwaUnderlyings.get(underlying)?.asset?.toLowerCase();
+	const unwrapsPayout = !!rwaAsset && eq(borrowToken, rwaAsset);
+	if (rwaAsset && eq(borrowToken, underlying)) throw new IntentPreviewError(unsupportedCollateralToken(toToken(sdk, borrowToken)), `borrow: ${underlying} cannot leave the account, ask for the payout in ${rwaAsset}`);
+	if (collateralAmount <= 0n) throw new IntentPreviewError(insufficientBalance(), "borrow: no collateral supplied");
+	if (borrowAmount <= 0n) throw new IntentPreviewError(insufficientBalance(), "borrow: nothing to borrow");
+	const margin = convert(collateralToken, underlying, collateralAmount);
+	if (margin <= 0n) throw new IntentPreviewError(insufficientBalance(), "borrow: collateral is worth nothing in underlying");
+	const debt = eq(borrowToken, underlying) ? borrowAmount : unwrapsPayout ? toTargetDecimals(borrowAmount, borrowToken, underlying, sdk) : convert(borrowToken, underlying, borrowAmount);
+	assertDebtLimits(sdk, debt, suite.creditFacade, underlying);
+	assertCanBorrow(sdk, suite, debt);
+	const account = existing ?? unopenedAccountSlice({
+		creditManager,
+		creditFacade: suite.creditFacade.address,
+		underlying
+	});
+	const leg = eq(borrowToken, underlying) || unwrapsPayout ? void 0 : await createRouterPaths({
+		sdk,
+		creditAccount: account,
+		slippage
+	}).swap({
+		tokenIn: underlying,
+		tokenOut: borrowToken,
+		amount: debt,
+		keep: eq(collateralToken, underlying) ? collateralAmount : 0n
+	});
+	const unwrap = unwrapsPayout ? await sdk.accounts.assembleRWAUnwrapCalls(debt, creditManager) : void 0;
+	if (unwrapsPayout && !unwrap) throw new Error(`borrow: no unwrap calls found for ${borrowToken}`);
+	const assets = [{
+		token: collateralToken,
+		balance: collateralAmount
+	}];
+	const quotaIncrease = borrowCollateralQuota({
+		sdk,
+		creditManager,
+		assets,
+		quotaReserve
+	});
+	assertGrowthAllowed({
+		sdk,
+		suite,
+		market,
+		before: [],
+		after: assets
+	});
+	assertQuotaAvailable(sdk, market, quotaIncrease);
+	const snapshot = {
+		creditManager,
+		assets,
+		quotas: quotaIncrease,
+		totalDebt: debt,
+		totalValue: margin
+	};
+	const projection = sdk.positions.projection(snapshot, { availableLiquidityChange: -debt });
+	assertCollateralised(projection.safeHealthFactor, true);
+	const priced = (token, balance) => market.priceOracle.toTokenAmount(token, balance);
+	const payout = unwrapsPayout ? toTargetDecimals(debt, underlying, borrowToken, sdk) : leg ? leg.amount : debt;
+	return {
+		...projection,
+		currentPrice: sdk.positions.currentPrice(snapshot),
+		executionCost: void 0,
+		priceImpact: await collectPriceImpact(leg?.probe ? [leg.probe] : [], {
+			totalValue: margin,
+			netValue: margin - debt,
+			toUnderlying: (from, amount) => convert(from, underlying, amount)
+		}),
+		collateral: priced(collateralToken, collateralAmount),
+		borrowed: priced(borrowToken, payout),
+		minBorrowed: priced(borrowToken, leg ? leg.minAmount : payout),
+		slippage,
+		quotaIncrease,
+		calls: leg ? [...leg.calls] : unwrap ?? [],
+		creditAccount: existing?.creditAccount
+	};
+}
+/**
+* Quota a borrow buys for its collateral on an account that holds none yet.
+*
+* Shared with `maxBorrow`, because a quota short of the collateral's weighted
+* value is what caps the loan: the two have to read the same number or the
+* ceiling one offers is one the other refuses.
+*
+* @param props - {@link BorrowCollateralQuotaProps}
+**/
+function borrowCollateralQuota({ sdk, creditManager, assets, quotaReserve }) {
+	const suite = sdk.marketRegister.findCreditManager(creditManager);
+	const market = sdk.marketRegister.findByCreditManager(creditManager);
+	return getQuotasForUpdate({
+		assetsBefore: [],
+		assetsAfter: assets,
+		initialQuotas: [],
+		quotaReserve,
+		underlyingToken: market.pool.underlying,
+		liquidationThresholds: suite.creditManager.liquidationThresholds,
+		quotas: market.pool.pqk.quotas,
+		maxDebt: suite.creditFacade.maxDebt,
+		convert: (from, to, amount) => market.priceOracle.safeConvert(from, to, amount).value
+	}).quotaIncrease;
+}
+//#endregion
+export { borrowCollateralQuota, buildBorrowState };