@gearbox-protocol/sdk 16.1.2 → 16.3.0-next.1

package/dist/cjs/model/positions.js

@@ -61,7 +61,7 @@ function positionId(position) {
 * A condition that does not apply to a position's kind keeps the row rather
 * than dropping it: `isZeroDebt` says nothing about a pool position, and
 * `underlyingType` says nothing about a liquidation position, which is
-* denominated in whatever its withdrawal pays out.
+* denominated in whatever its withdrawal settles in.
 *
 * @param position - Row to test.
 * @param filter - Conditions to test against. An absent filter matches

package/dist/cjs/model/result.js

@@ -23,15 +23,7 @@ function sdkErr(error) {
 		error
 	};
 }
-/**
-* Narrows a {@link SDKReturn} to its failure half. Trivial over `ok`, but it
-* names the intent at call sites that would otherwise read `!r.ok`.
-**/
-function isSDKError(answer) {
-	return !answer.ok;
-}
 //#endregion
-exports.isSDKError = isSDKError;
 exports.safeValue = safeValue;
 exports.sdkErr = sdkErr;
 exports.sdkOk = sdkOk;

package/dist/cjs/model/rwa.js

@@ -0,0 +1,40 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/model/rwa.ts
+/**
+* Discriminant of the Securitize RWA factory contract type.
+**/
+const RWA_FACTORY_SECURITIZE = "RWA_FACTORY::SECURITIZE";
+/**
+* Discriminated union of all known RWA factory contract type strings.
+**/
+const RWA_FACTORY_TYPES = [RWA_FACTORY_SECURITIZE];
+/**
+* EIP-712 type schema for the `RegisterVault` message expected by Securitize's
+* VaultRegistrar. Matches the contract's `RegisterVault` typehash field order.
+**/
+const SECURITIZE_REGISTER_VAULT_TYPES = { RegisterVault: [
+	{
+		name: "investor",
+		type: "address"
+	},
+	{
+		name: "operator",
+		type: "address"
+	},
+	{
+		name: "token",
+		type: "address"
+	},
+	{
+		name: "nonce",
+		type: "uint256"
+	},
+	{
+		name: "deadline",
+		type: "uint256"
+	}
+] };
+//#endregion
+exports.RWA_FACTORY_SECURITIZE = RWA_FACTORY_SECURITIZE;
+exports.RWA_FACTORY_TYPES = RWA_FACTORY_TYPES;
+exports.SECURITIZE_REGISTER_VAULT_TYPES = SECURITIZE_REGISTER_VAULT_TYPES;

package/dist/cjs/onchain/accounts/CreditAccountsServiceV310.js

@@ -205,7 +205,7 @@ var CreditAccountsServiceV310 = class extends require_onchain_base_SDKConstruct.
 		else if (typeof withdrawToken === "string") tokenToWithdraw = withdrawToken;
 		const { creditFacade } = cmSuite;
 		let calls = [
-			creditFacade.prepareIncreaseDebt(debt),
+			...debt > 0n ? [creditFacade.prepareIncreaseDebt(debt)] : [],
 			...creditFacade.prepareAddCollateral(collateral, permits),
 			...openPathCalls,
 			...tokenToWithdraw ? [creditFacade.prepareWithdrawCollateral(tokenToWithdraw, require_onchain_constants_math.MAX_UINT256, to)] : [],
@@ -217,7 +217,7 @@ var CreditAccountsServiceV310 = class extends require_onchain_base_SDKConstruct.
 		];
 		calls = await this.#prependMidasReceiveGreenlist(cm.address, calls);
 		calls = await this.prependPriceUpdates(cm.address, calls);
-		const tx = reopenCreditAccount ? cmSuite.multicallTx(reopenCreditAccount, calls) : cmSuite.openCreditAccountTx(to, calls, referralCode, rwaOptions);
+		const tx = reopenCreditAccount ? cmSuite.multicallTx(reopenCreditAccount, calls, rwaOptions) : cmSuite.openCreditAccountTx(to, calls, referralCode, rwaOptions);
 		tx.value = ethAmount.toString(10);
 		return tx;
 	}

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

@@ -7,7 +7,6 @@ const require_onchain_accounts_credit_account_compressor_CreditAccountCompressor
 require("./credit-account-compressor/index.js");
 const require_onchain_accounts_CreditAccountsServiceV310 = require("./CreditAccountsServiceV310.js");
 const require_onchain_accounts_intents_utils_pick_token = require("./intents/utils/pick-token.js");
-const require_onchain_accounts_intents_guards = require("./intents/guards.js");
 const require_onchain_accounts_intents_utils_credit_account_slice = require("./intents/utils/credit-account-slice.js");
 const require_onchain_accounts_quota_utils = require("./quota-utils.js");
 const require_onchain_accounts_intents_index = require("./intents/index.js");
@@ -44,7 +43,6 @@ exports.RedemptionLoggerV310Contract = require_onchain_accounts_withdrawal_compr
 exports.WithdrawalCompressorV310Contract = require_onchain_accounts_withdrawal_compressor_WithdrawalCompressorV310Contract.WithdrawalCompressorV310Contract;
 exports.WithdrawalCompressorV311Contract = require_onchain_accounts_withdrawal_compressor_WithdrawalCompressorV311Contract.WithdrawalCompressorV311Contract;
 exports.WithdrawalCompressorV313Contract = require_onchain_accounts_withdrawal_compressor_WithdrawalCompressorV313Contract.WithdrawalCompressorV313Contract;
-exports.borrowable = require_onchain_accounts_intents_guards.borrowable;
 exports.calcDefaultQuota = require_onchain_accounts_quota_utils.calcDefaultQuota;
 exports.calcQuotaUpdate = require_onchain_accounts_quota_utils.calcQuotaUpdate;
 exports.calcRecommendedQuota = require_onchain_accounts_quota_utils.calcRecommendedQuota;

package/dist/cjs/onchain/accounts/intents/guards.js

@@ -1,7 +1,14 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_onchain_validation_checks = require("../../validation/checks.js");
-const require_onchain_validation_refusal = require("../../validation/refusal.js");
-const require_onchain_validation_token = require("../../validation/token.js");
+const require_onchain_validation_helpers_health_factor_limits = require("../../validation/helpers/health-factor-limits.js");
+const require_onchain_validation_helpers_token = require("../../validation/helpers/token.js");
+const require_onchain_validation_checks_checkBorrowLimit = require("../../validation/checks/checkBorrowLimit.js");
+const require_onchain_validation_checks_checkCollateralised = require("../../validation/checks/checkCollateralised.js");
+const require_onchain_validation_checks_checkCreditManagerPaused = require("../../validation/checks/checkCreditManagerPaused.js");
+const require_onchain_validation_checks_checkForbiddenToken = require("../../validation/checks/checkForbiddenToken.js");
+const require_onchain_validation_checks_checkMarketExpired = require("../../validation/checks/checkMarketExpired.js");
+const require_onchain_validation_checks_checkQuotaLimit = require("../../validation/checks/checkQuotaLimit.js");
+const require_onchain_validation_raise = require("../../validation/raise.js");
+require("../../validation/index.js");
 const require_onchain_accounts_intents_utils_common = require("./utils/common.js");
 const require_onchain_accounts_intents_utils_pick_token = require("./utils/pick-token.js");
 //#region src/onchain/accounts/intents/guards.ts
@@ -25,54 +32,25 @@ const require_onchain_accounts_intents_utils_pick_token = require("./utils/pick-
 */
 function assertMarketOperable(suite) {
 	const creditManager = suite.creditManager.address;
-	require_onchain_validation_refusal.raise(require_onchain_validation_checks.checkCreditManagerPaused({
+	require_onchain_validation_raise.raise(require_onchain_validation_checks_checkCreditManagerPaused.checkCreditManagerPaused({
 		isPaused: suite.isPaused,
 		creditManager
 	}), `${creditManager} is paused`);
-	require_onchain_validation_refusal.raise(require_onchain_validation_checks.checkMarketExpired({
+	require_onchain_validation_raise.raise(require_onchain_validation_checks_checkMarketExpired.checkMarketExpired({
 		isExpired: suite.isExpired,
 		creditManager,
 		expirationDate: suite.creditFacade.expirationDate
 	}), `${creditManager} 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 {
-		limit: 0n,
-		binding: "facadePerBlockCap"
-	};
-	const available = pool.creditManagerDebtParams.get(suite.creditManager.address)?.available;
-	return [
-		{
-			limit: pool.availableLiquidity,
-			binding: "poolAvailableLiquidity"
-		},
-		{
-			limit: maxDebt * BigInt(maxDebtPerBlockMultiplier),
-			binding: "facadePerBlockCap"
-		},
-		...available === void 0 ? [] : [{
-			limit: available,
-			binding: "managerDebtAvailable"
-		}]
-	].reduce((a, b) => b.limit < a.limit ? b : a);
-}
 /** The pool has to be able to lend what the plan means to draw. */
 function assertCanBorrow(sdk, suite, amount) {
-	const { limit, binding } = borrowable(suite);
-	require_onchain_validation_refusal.raise(require_onchain_validation_checks.checkBorrowLimit({
+	const { value, limit } = suite.maxBorrowAmount();
+	require_onchain_validation_raise.raise(require_onchain_validation_checks_checkBorrowLimit.checkBorrowLimit({
 		requested: amount,
-		available: limit,
-		binding,
-		underlying: require_onchain_validation_token.toToken(sdk, suite.market.pool.underlying)
-	}), `borrow: ${amount} exceeds what the pool can lend now (${limit})`);
+		available: value,
+		limit,
+		underlying: require_onchain_validation_helpers_token.toToken(sdk, suite.market.pool.underlying)
+	}), `borrow: ${amount} exceeds what the pool can lend now (${value})`);
 }
 /**
 * What the account is allowed to end up holding more of than it started with.
@@ -88,20 +66,19 @@ function assertCanBorrow(sdk, suite, amount) {
 */
 function assertGrowthAllowed(args) {
 	const { sdk, suite, market, before, after } = args;
-	const forbidden = suite.forbiddenTokens;
 	const underlying = market.pool.underlying;
 	for (const { token, balance } of after) {
 		if (balance <= (before.find((a) => require_onchain_accounts_intents_utils_common.eq(a.token, token))?.balance ?? 0n)) continue;
-		require_onchain_validation_refusal.raise(require_onchain_validation_checks.checkForbiddenToken({
-			token: require_onchain_validation_token.toToken(sdk, token),
-			isForbidden: forbidden.some((f) => require_onchain_accounts_intents_utils_common.eq(f, token))
+		require_onchain_validation_raise.raise(require_onchain_validation_checks_checkForbiddenToken.checkForbiddenToken({
+			token: require_onchain_validation_helpers_token.toToken(sdk, token),
+			isForbidden: suite.isForbidden(token)
 		}), `${token} is forbidden in this market and the plan buys more of it`);
 		if (require_onchain_accounts_intents_utils_common.eq(token, underlying) || require_onchain_accounts_intents_utils_pick_token.isPhantomToken(sdk, token)) continue;
-		if (!market.pool.pqk.hasActiveQuota(token)) require_onchain_validation_refusal.raise(require_onchain_validation_checks.checkQuotaLimit({
-			token: require_onchain_validation_token.toToken(sdk, token),
+		if (!market.pool.pqk.hasActiveQuota(token)) require_onchain_validation_raise.raise(require_onchain_validation_checks_checkQuotaLimit.checkQuotaLimit({
+			token: require_onchain_validation_helpers_token.toToken(sdk, token),
 			requested: void 0,
 			available: 0n,
-			underlying: require_onchain_validation_token.toToken(sdk, underlying)
+			underlying: require_onchain_validation_helpers_token.toToken(sdk, underlying)
 		}), `${token} takes no quota in this market, so it counts as no collateral`);
 	}
 }
@@ -110,19 +87,20 @@ function assertGrowthAllowed(args) {
 * 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 facade's own `1.0`, because this guard answers one question:
-* would the transaction revert. It is deliberately not `MIN_HF_LIMITED`, and
-* the three bars in this codebase are three different jobs:
+* The threshold is the facade's own `1.0`, because this guard answers one
+* question: would the transaction revert. It is deliberately not
+* `MIN_HF_LIMITED`, and the three thresholds in this codebase are three
+* different jobs:
 *
 * - here, `1.0` — what the facade enforces, so what a plan must clear to land;
 * - `maxWithdrawCollateral` sizes at `MIN_HF_LIMITED + 2` — a *sizing* helper
-*   leaving headroom, which is not the same as a validity check;
+*   leaving a margin, which is not the same as a validity check;
 * - a form refuses at or below `MIN_HF_LIMITED` (`MIN_HEALTH_FACTOR_FORM`).
 *
 * Raising this one to `MIN_HF_LIMITED` was tried and reverted: it made
 * `maxWithdraw` hand back a ceiling this guard then refused, and it blocked
 * small top-ups of an account sitting in `[1.0, 1.01)` — the very operations
-* that rescue it. A form wanting the stricter bar has `validateHF`.
+* that rescue it. A form wanting the stricter threshold has `validateHF`.
 *
 * 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
@@ -135,29 +113,28 @@ function assertGrowthAllowed(args) {
 * still be refused on-chain after passing here.
 */
 function assertCollateralised(healthFactorBps, safePrices) {
-	const required = require_onchain_validation_checks.MIN_HEALTH_FACTOR_FACADE;
-	require_onchain_validation_refusal.raise(require_onchain_validation_checks.checkCollateralised({
+	const healthFactorThreshold = require_onchain_validation_helpers_health_factor_limits.MIN_HEALTH_FACTOR_FACADE;
+	require_onchain_validation_raise.raise(require_onchain_validation_checks_checkCollateralised.checkCollateralised({
 		healthFactor: healthFactorBps,
-		required,
+		healthFactorThreshold,
 		safePrices
-	}), `the account would end at a health factor of ${healthFactorBps}, below ${required}`);
+	}), `the account would end at a health factor of ${healthFactorBps}, below ${healthFactorThreshold}`);
 }
 /**
 * 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(sdk, market, increases) {
+function assertQuotaAvailable(sdk, market, increases) {
 	const underlying = market.pool.underlying;
+	const { pqk } = market.pool;
 	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;
-		require_onchain_validation_refusal.raise(require_onchain_validation_checks.checkQuotaLimit({
-			token: require_onchain_validation_token.toToken(sdk, token),
+		if (balance <= 0n || !pqk.quotas.has(token)) continue;
+		const left = pqk.quotaAvailable(token);
+		require_onchain_validation_raise.raise(require_onchain_validation_checks_checkQuotaLimit.checkQuotaLimit({
+			token: require_onchain_validation_helpers_token.toToken(sdk, token),
 			requested: balance,
 			available: left,
-			underlying: require_onchain_validation_token.toToken(sdk, underlying)
+			underlying: require_onchain_validation_helpers_token.toToken(sdk, underlying)
 		}), `${token} has ${left} of quota left, the plan needs ${balance}`);
 	}
 }
@@ -166,5 +143,4 @@ exports.assertCanBorrow = assertCanBorrow;
 exports.assertCollateralised = assertCollateralised;
 exports.assertGrowthAllowed = assertGrowthAllowed;
 exports.assertMarketOperable = assertMarketOperable;
-exports.assertQuotaHeadroom = assertQuotaHeadroom;
-exports.borrowable = borrowable;
+exports.assertQuotaAvailable = assertQuotaAvailable;

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

@@ -1,7 +1,11 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_onchain_base_SDKConstruct = require("../../base/SDKConstruct.js");
-const require_onchain_validation_checks = require("../../validation/checks.js");
-const require_onchain_validation_refusal = require("../../validation/refusal.js");
+const require_model_errors_prepare_errors = require("../../../model/errors/prepare-errors.js");
+const require_model_result = require("../../../model/result.js");
+require("../../../model/index.js");
+const require_onchain_validation_helpers_health_factor_limits = require("../../validation/helpers/health-factor-limits.js");
+const require_onchain_validation_raise = require("../../validation/raise.js");
+require("../../validation/index.js");
 const require_onchain_accounts_intents_utils_pick_token = require("./utils/pick-token.js");
 const require_onchain_accounts_intents_guards = require("./guards.js");
 const require_onchain_accounts_intents_leverage_band = require("./leverage-band.js");
@@ -26,7 +30,7 @@ var CreditAccountOperationsService = class extends require_onchain_base_SDKConst
 	* Previews an operation on an existing account.
 	*
 	* @param props - Intent plus account slice, quota reserve and slippage
-	* @returns Operations, projected state and calldata, or `{ ok: false, reason }`
+	* @returns Operations, projected state and calldata, or `{ ok: false, error }`
 	* when the intent cannot be satisfied (e.g. the account lacks the source
 	* balance)
 	*/
@@ -47,8 +51,8 @@ var CreditAccountOperationsService = class extends require_onchain_base_SDKConst
 	}
 	/**
 	* Both ends of what a `WITHDRAW` can take out, in underlying: the largest
-	* partial withdrawal that keeps leverage and stays inside the facade's debt
-	* band, and the net value an exit hands over. They are reported together
+	* partial withdrawal that keeps leverage and stays inside the facade's
+	* `debtLimits`, and the net value an exit hands over. They are reported together
 	* because a withdraw form needs both — the range it may offer, and the one
 	* amount past it that is allowed — and because the distance between them is
 	* the account's own, not a constant a caller could assume.
@@ -64,7 +68,7 @@ var CreditAccountOperationsService = class extends require_onchain_base_SDKConst
 	maxWithdraw(props) {
 		const view = require_onchain_accounts_intents_view.accountView(props.creditAccount, props.sdk);
 		return {
-			partial: require_onchain_accounts_intents_math.maxProportionalWithdrawal(view, view.band),
+			partial: require_onchain_accounts_intents_math.maxProportionalWithdrawal(view, view.debtLimits),
 			exit: view.collateral > 0n ? view.collateral : 0n
 		};
 	}
@@ -89,8 +93,8 @@ var CreditAccountOperationsService = class extends require_onchain_base_SDKConst
 	*
 	* A credit manager's `maxLeverage` follows from the liquidation threshold
 	* alone, so it is the same for a hundred dollars and for a million. What a
-	* given deposit reaches is decided by the debt it implies and by the band
-	* the market puts that debt in — the range a leverage slider should offer.
+	* given deposit reaches is decided by the debt it implies and by the
+	* `debtLimits` the market puts that debt in — the range a leverage slider should offer.
 	*
 	* Unlike the other ceilings here this one reads no account: opening has none
 	* yet, and adjusting measures against the net value the caller already
@@ -109,9 +113,9 @@ var CreditAccountOperationsService = class extends require_onchain_base_SDKConst
 	* while its health factor stays at `targetHF` — the ceiling a
 	* withdraw-collateral form should offer. Thresholds, prices and quota
 	* activity come from the account's market, valued the way the facade values
-	* a call that pays out; zero debt frees the whole balance.
+	* a call that withdraws collateral; zero debt frees the whole balance.
 	*
-	* The default is {@link MIN_HF_LIMITED}, the bar a form holds an
+	* The default is {@link MIN_HF_LIMITED}, the threshold a form holds an
 	* account to.
 	*
 	* @param props - Account slice, the SDK holding its market, the collateral
@@ -119,7 +123,7 @@ var CreditAccountOperationsService = class extends require_onchain_base_SDKConst
 	* @returns Amount in the token's units; `0n` when nothing can leave
 	*/
 	maxWithdrawCollateral(props) {
-		const { targetHF = require_onchain_validation_checks.MIN_HF_LIMITED, ...rest } = props;
+		const { targetHF = require_onchain_validation_helpers_health_factor_limits.MIN_HF_LIMITED, ...rest } = props;
 		return require_onchain_accounts_intents_maxWithdrawCollateral.maxWithdrawCollateral({
 			...rest,
 			targetHF: targetHF + 2n
@@ -131,8 +135,8 @@ var CreditAccountOperationsService = class extends require_onchain_base_SDKConst
 	*
 	* Sits apart from {@link startIntent} because it is a different trade route,
 	* not a different intent: the request goes to the issuer instead of the
-	* router, and the proceeds — hence the repayment and the payout — arrive days
-	* later. Both routes of one intent are quoted together by
+	* router, and what it sells for — hence the repayment and the withdrawal —
+	* arrives days later. Both routes of one intent are quoted together by
 	* {@link intentRoutes}; this is the one to call when the delayed route is the
 	* only one of interest.
 	*
@@ -144,7 +148,7 @@ var CreditAccountOperationsService = class extends require_onchain_base_SDKConst
 	*
 	* @param props - Intent plus account slice, quota reserve and slippage
 	* @returns The request transaction, the state it ends in and what it recorded
-	* for the tail, or `{ ok: false, reason }` — `noDelayedRoute` when this route
+	* for the tail, or `{ ok: false, error }` — `noDelayedRoute` when this route
 	* does not exist for the account at all
 	*/
 	async startDelayedIntent(props) {
@@ -180,7 +184,7 @@ var CreditAccountOperationsService = class extends require_onchain_base_SDKConst
 				delayed
 			};
 		} catch (e) {
-			return asFailure(e);
+			return asSDKError(e);
 		}
 	}
 	/**
@@ -190,7 +194,7 @@ var CreditAccountOperationsService = class extends require_onchain_base_SDKConst
 	* Which routes an account has depends on the intent and the token it sells,
 	* and a form has to know before it can offer a choice — so both are quoted
 	* from the same request and each is reported on its own. A route the account
-	* cannot take comes back `undefined` with its refusal in `refused`; only when
+	* cannot take comes back `undefined` with its error in `errors`; only when
 	* neither answers is the whole result `{ ok: false }`.
 	*
 	* A route that could not be quoted at all — a pathfinder with no path out of
@@ -200,31 +204,31 @@ var CreditAccountOperationsService = class extends require_onchain_base_SDKConst
 	*
 	* @param props - A withdraw or adjust-leverage intent plus account slice,
 	* quota reserve and slippage
-	* @returns Whichever routes are viable, or `{ ok: false, reason }` when none is
+	* @returns Whichever routes are viable, or `{ ok: false, error }` when none is
 	*/
 	async intentRoutes(props) {
 		const [instant, delayed] = await Promise.allSettled([this.startIntent(props), this.startDelayedIntent(props)]);
 		const instantRoute = instant.status === "fulfilled" && instant.value.ok ? instant.value : void 0;
 		const delayedRoute = delayed.status === "fulfilled" && delayed.value.ok ? delayed.value : void 0;
-		const instantRefusal = instant.status === "fulfilled" && !instant.value.ok ? instant.value : void 0;
-		const delayedRefusal = delayed.status === "fulfilled" && !delayed.value.ok ? delayed.value : void 0;
-		const refused = {
-			instant: instantRefusal?.reason,
-			delayed: delayedRefusal?.reason
+		const instantError = instant.status === "fulfilled" && !instant.value.ok ? instant.value.error : void 0;
+		const delayedError = delayed.status === "fulfilled" && !delayed.value.ok ? delayed.value.error : void 0;
+		const errors = {
+			...instantError === void 0 ? {} : { instant: instantError },
+			...delayedError === void 0 ? {} : { delayed: delayedError }
 		};
 		if (instantRoute || delayedRoute) return {
 			ok: true,
 			instant: instantRoute,
 			delayed: delayedRoute,
-			refused
+			errors
 		};
 		const failed = [instant, delayed].find((s) => s.status === "rejected");
 		if (failed?.status === "rejected") throw failed.reason;
-		const chosen = instantRefusal ?? delayedRefusal;
+		const chosen = instantError ?? delayedError;
 		if (chosen === void 0) throw new Error("intentRoutes: a route neither answered nor refused");
 		return {
-			...chosen,
-			refused
+			...require_model_result.sdkErr(chosen),
+			errors
 		};
 	}
 	/**
@@ -237,7 +241,7 @@ var CreditAccountOperationsService = class extends require_onchain_base_SDKConst
 	* catch up.
 	*
 	* A claim that brought only part of what the request queued — a legacy Mellow
-	* multivault, which pays out what it holds liquid and re-queues the rest — is
+	* multivault, which hands over what it holds liquid and re-queues the rest — is
 	* served in proportion, and what it did not settle comes back as `remainder`:
 	* the withdrawal still in flight and the intent to finish it with.
 	*
@@ -276,7 +280,7 @@ var CreditAccountOperationsService = class extends require_onchain_base_SDKConst
 	*
 	* @param props - Credit manager, wallet collateral, target token and leverage
 	* @returns Debt, position size, projected balances and quotas for both the
-	* expected and the floor branch, or `{ ok: false, reason }` when the requested
+	* expected and the floor branch, or `{ ok: false, error }` when the requested
 	* leverage or the resulting debt is not viable
 	*/
 	async openStrategyIntent(props) {
@@ -286,7 +290,7 @@ var CreditAccountOperationsService = class extends require_onchain_base_SDKConst
 				state: await require_onchain_accounts_intents_open_strategy.buildOpenStrategyState(props)
 			};
 		} catch (e) {
-			return asFailure(e);
+			return asSDKError(e);
 		}
 	}
 	/** Plan → realise → wrap. Unviable requests become `{ ok: false }`. */
@@ -307,7 +311,7 @@ var CreditAccountOperationsService = class extends require_onchain_base_SDKConst
 				delayed
 			};
 		} catch (e) {
-			return asFailure(e);
+			return asSDKError(e);
 		}
 	}
 };
@@ -323,16 +327,16 @@ function plain(result) {
 	};
 }
 /** Unviable requests are values; anything else is a genuine failure. */
-function asFailure(e) {
-	if (e instanceof require_onchain_validation_refusal.IntentPreviewError) return require_onchain_validation_refusal.refuse(e.reason, e.detail);
-	if (isUnroutable(e)) return require_onchain_validation_refusal.refuse("unsupportedTokenPair", void 0);
+function asSDKError(e) {
+	if (e instanceof require_onchain_validation_raise.IntentPreviewError) return require_model_result.sdkErr(e.error);
+	if (isUnroutable(e)) return require_model_result.sdkErr(require_model_errors_prepare_errors.unsupportedTokenPair());
 	throw e;
 }
 /**
 * How the pathfinder says there is no route: it reverts instead of answering
 * with an empty path, so viem raises a contract error where the rest of the
 * engine raises an {@link IntentPreviewError}. Nothing is wrong — the trade
-* asked for cannot be made, which is a refusal the caller can act on, and one
+* asked for cannot be made, which is an error the caller can act on, and one
 * `intentRoutes` in particular must keep as a value so the other route can
 * still be offered.
 */
@@ -342,7 +346,6 @@ function isUnroutable(e) {
 }
 //#endregion
 exports.CreditAccountOperationsService = CreditAccountOperationsService;
-exports.borrowable = require_onchain_accounts_intents_guards.borrowable;
 exports.fetchCreditAccountSlice = require_onchain_accounts_intents_utils_credit_account_slice.fetchCreditAccountSlice;
 exports.isPhantomToken = require_onchain_accounts_intents_utils_pick_token.isPhantomToken;
 exports.toCreditAccountSlice = require_onchain_accounts_intents_utils_credit_account_slice.toCreditAccountSlice;

package/dist/cjs/onchain/accounts/intents/leverage-band.js

@@ -8,7 +8,7 @@ const require_onchain_constants_math = require("../../constants/math.js");
 * A credit manager's `maxLeverage` follows from the liquidation threshold
 * alone, so it is the same for a hundred dollars and for a million. What a
 * given deposit reaches is decided by the debt it implies —
-* `debt = netValue × (leverage − 1)` — and by the band the market puts that
+* `debt = netValue × (leverage − 1)` — and by the `debtLimits` the market puts that
 * debt in. This inverts that relation.
 *
 * Rounding is asymmetric because the forward direction truncates: the floor

package/dist/cjs/onchain/accounts/intents/math.js

@@ -1,9 +1,13 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_onchain_utils_bigint_math = require("../../utils/bigint-math.js");
 const require_onchain_constants_math = require("../../constants/math.js");
-const require_onchain_validation_checks = require("../../validation/checks.js");
-const require_onchain_validation_refusal = require("../../validation/refusal.js");
-const require_onchain_validation_token = require("../../validation/token.js");
+const require_model_errors_operation_errors = require("../../../model/errors/operation-errors.js");
+require("../../../model/index.js");
+const require_onchain_validation_helpers_token = require("../../validation/helpers/token.js");
+const require_onchain_validation_checks_checkDebtLimits = require("../../validation/checks/checkDebtLimits.js");
+const require_onchain_validation_checks_checkLeverage = require("../../validation/checks/checkLeverage.js");
+const require_onchain_validation_raise = require("../../validation/raise.js");
+require("../../validation/index.js");
 //#region src/onchain/accounts/intents/math.ts
 /** Debt that realises `leverage` on `collateral`: `D = C · (L − 1)`. */
 function debtForLeverage(collateral, leverage) {
@@ -17,30 +21,30 @@ function debtForLeverage(collateral, leverage) {
 * it, so no rounding is introduced on the way.
 */
 function proportionalDebt(position, collateralDelta) {
-	if (position.collateral <= 0n) throw new require_onchain_validation_refusal.IntentPreviewError("insufficientSourceBalance", void 0, "cannot preserve leverage on an account with no collateral");
+	if (position.collateral <= 0n) throw new require_onchain_validation_raise.IntentPreviewError(require_model_errors_operation_errors.insufficientBalance(), "cannot preserve leverage on an account with no collateral");
 	return position.debt * collateralDelta / position.collateral;
 }
 /**
 * Largest withdrawal (in underlying) that {@link proportionalDebt} can still
 * pay for: the repayment it implies leaves debt at or above `minDebt`, and
 * strictly less than the collateral goes — the last unit closes the account
-* rather than shrinks it. `0n` when the debt already sits below the band.
+* rather than shrinks it. `0n` when the debt already sits below `minDebt`.
 *
 * Solves `floor(D0 · W / C0) ≤ D0 − minDebt` for `W`.
 */
-function maxProportionalWithdrawal(position, band) {
+function maxProportionalWithdrawal(position, debtLimits) {
 	const { debt, collateral } = position;
 	if (collateral <= 0n) return 0n;
 	const allButLast = collateral - 1n;
 	if (debt === 0n) return allButLast;
-	const repayable = debt - band.minDebt;
+	const repayable = debt - debtLimits.minDebt;
 	if (repayable < 0n) return 0n;
 	const bound = require_onchain_utils_bigint_math.BigIntMath.ceilDiv(collateral * (repayable + 1n), debt) - 1n;
 	return bound < allButLast ? bound : allButLast;
 }
 /** Total leverage cannot drop below 1x — that would be negative debt. */
 function assertLeverageAtLeastOne(leverage) {
-	require_onchain_validation_refusal.raise(require_onchain_validation_checks.checkLeverageAtLeastOne({
+	require_onchain_validation_raise.raise(require_onchain_validation_checks_checkLeverage.checkLeverage({
 		leverage,
 		min: require_onchain_constants_math.LEVERAGE_DECIMALS
 	}), `target leverage ${leverage} is below 1x`);
@@ -49,17 +53,17 @@ function assertLeverageAtLeastOne(leverage) {
 * Rejects a debt the facade would revert on: zero is always fine (no loan at
 * all), anything else has to sit inside `[minDebt, maxDebt]`.
 */
-function assertDebtInBand(sdk, debt, band, underlying) {
-	require_onchain_validation_refusal.raise(require_onchain_validation_checks.checkDebtInBand({
+function assertDebtLimits(sdk, debt, debtLimits, underlying) {
+	require_onchain_validation_raise.raise(require_onchain_validation_checks_checkDebtLimits.checkDebtLimits({
 		debt,
-		minDebt: band.minDebt,
-		maxDebt: band.maxDebt,
-		underlying: require_onchain_validation_token.toToken(sdk, underlying),
+		minDebt: debtLimits.minDebt,
+		maxDebt: debtLimits.maxDebt,
+		underlying: require_onchain_validation_helpers_token.toToken(sdk, underlying),
 		allowZero: true
-	}), debt > band.maxDebt ? `debt ${debt} exceeds maxDebt ${band.maxDebt}` : `debt ${debt} is below minDebt ${band.minDebt}`);
+	}), debt > debtLimits.maxDebt ? `debt ${debt} exceeds maxDebt ${debtLimits.maxDebt}` : `debt ${debt} is below minDebt ${debtLimits.minDebt}`);
 }
 //#endregion
-exports.assertDebtInBand = assertDebtInBand;
+exports.assertDebtLimits = assertDebtLimits;
 exports.assertLeverageAtLeastOne = assertLeverageAtLeastOne;
 exports.debtForLeverage = debtForLeverage;
 exports.maxProportionalWithdrawal = maxProportionalWithdrawal;