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

package/dist/esm/model/errors/prepare-errors.js

@@ -0,0 +1,97 @@
+//#region src/model/errors/prepare-errors.ts
+/** {@inheritDoc UnsupportedCollateralTokenError} */
+function unsupportedCollateralToken(token) {
+	return {
+		code: "unsupportedCollateralToken",
+		message: `This flow does not accept ${token.symbol}.`,
+		token
+	};
+}
+/** {@inheritDoc UnsupportedTokenPairError} */
+function unsupportedTokenPair(args = {}) {
+	const { from, to } = args;
+	return {
+		code: "unsupportedTokenPair",
+		message: from === void 0 ? "No route exists between these two tokens." : to === void 0 ? `No route exists out of ${from.symbol}.` : `No route exists from ${from.symbol} to ${to.symbol}.`,
+		...args
+	};
+}
+/** {@inheritDoc NoDelayedRouteError} */
+function noDelayedRoute(token) {
+	return {
+		code: "noDelayedRoute",
+		message: token === void 0 ? "This request cannot be served as a delayed redemption." : `${token.symbol} cannot be served as a delayed redemption.`,
+		...token === void 0 ? {} : { token }
+	};
+}
+/** {@inheritDoc MultipleDelayedWithdrawalsError} */
+function multipleDelayedWithdrawals(token, venues) {
+	return {
+		code: "multipleDelayedWithdrawals",
+		message: `${token.symbol} has ${venues} redemption venues and none was named.`,
+		token,
+		venues
+	};
+}
+/** {@inheritDoc WithdrawalInProgressError} */
+function withdrawalInProgress(inFlight) {
+	return {
+		code: "withdrawalInProgress",
+		message: `A redemption of ${inFlight.token.symbol} is already in flight on the account.`,
+		inFlight
+	};
+}
+/** {@inheritDoc NoRecordedIntentError} */
+function noRecordedIntent() {
+	return {
+		code: "noRecordedIntent",
+		message: "The claim names no operation to resume."
+	};
+}
+/** {@inheritDoc NoStrategyTargetCollateralError} */
+function noStrategyTargetCollateral(creditManager) {
+	return {
+		code: "noStrategyTargetCollateral",
+		message: `Credit manager ${creditManager} has no strategy target collateral, and none was named.`,
+		creditManager
+	};
+}
+/** {@inheritDoc CreditAccountNotFoundError} */
+function creditAccountNotFound(creditAccount) {
+	return {
+		code: "creditAccountNotFound",
+		message: `Credit account not found: ${creditAccount}.`,
+		creditAccount
+	};
+}
+/** {@inheritDoc CreditAccountNotEmptyError} */
+function creditAccountNotEmpty(creditAccount) {
+	return {
+		code: "creditAccountNotEmpty",
+		message: `Credit account ${creditAccount} carries debt or quotas.`,
+		creditAccount
+	};
+}
+/** {@inheritDoc EmptyOpenTakesNothingError} */
+function emptyOpenTakesNothing() {
+	return {
+		code: "emptyOpenTakesNothing",
+		message: "An empty opening takes no collateral, no account to reuse and no leverage."
+	};
+}
+/**
+* {@inheritDoc UnexpectedFailureError}
+*
+* Takes what was thrown, whatever that is: a `throw` is not obliged to raise an
+* `Error`, and `cause` promises one.
+**/
+function unexpectedFailure(thrown, action = "prepare this operation") {
+	const cause = thrown instanceof Error ? thrown : new Error(String(thrown));
+	return {
+		code: "unexpectedFailure",
+		message: `The SDK could not ${action}: ${cause.message}`,
+		cause
+	};
+}
+//#endregion
+export { creditAccountNotEmpty, creditAccountNotFound, emptyOpenTakesNothing, multipleDelayedWithdrawals, noDelayedRoute, noRecordedIntent, noStrategyTargetCollateral, unexpectedFailure, unsupportedCollateralToken, unsupportedTokenPair, withdrawalInProgress };

package/dist/esm/model/errors/preview-errors.js

@@ -0,0 +1,11 @@
+//#region src/model/errors/preview-errors.ts
+/** {@inheritDoc MalformedTransactionError} */
+function malformedTransaction(detail, cause) {
+	return {
+		code: "malformedTransaction",
+		message: `The transaction could not be replayed: ${detail}`,
+		...cause ? { cause } : {}
+	};
+}
+//#endregion
+export { malformedTransaction };

package/dist/esm/model/index.js

@@ -12,7 +12,12 @@ import { borrowRateBreakdownSchema, pnlBreakdownSchema, pointsProgramPnLSchema,
 import { ANALYTICS_POSITIONS_DEFAULT_LIMIT, ANALYTICS_POSITIONS_MAX_LIMIT, analyticsChartQueryOptionsSchema, analyticsChartQueryParamsSchema, analyticsChartQuerySchema, analyticsPositionListOptionsSchema, analyticsPositionListQueryParamsSchema, analyticsPositionListQuerySchema, analyticsPositionPageSchema, analyticsPositionSchema, analyticsPositionSortFieldSchema, analyticsSortDirectionSchema } from "./analytics.schema.js";
 import "./curators.js";
 import "./delayed-intents.js";
-import "./errors.js";
+import { creditAccountFrozen, liquidatorNotEligible, notEmergencyLiquidator } from "./errors/liquidation-errors.js";
+import { creditManagerPaused, debtOutOfRange, forbiddenToken, insufficientAllowance, insufficientBalance, insufficientCollateral, insufficientPoolLiquidity, leverageOutOfRange, marketExpired, poolPaused, poolSunset, quotaCountExceeded, quotaLimitReached, rwaOpenRequirementsNotMet } from "./errors/operation-errors.js";
+import { unpriceableTokenError } from "./errors/oracle-errors.js";
+import { creditAccountNotEmpty, creditAccountNotFound, emptyOpenTakesNothing, multipleDelayedWithdrawals, noDelayedRoute, noRecordedIntent, noStrategyTargetCollateral, unexpectedFailure, unsupportedCollateralToken, unsupportedTokenPair, withdrawalInProgress } from "./errors/prepare-errors.js";
+import { malformedTransaction } from "./errors/preview-errors.js";
+import "./errors/index.js";
 import { matchesLiquidatableAccountFilter } from "./liquidations.js";
 import "./notices.js";
 import { noticeKindSchema, noticeSchema } from "./notices.schema.js";
@@ -22,7 +27,8 @@ import { asEstimated } from "./previews.js";
 import "./primitives.js";
 import "./response.js";
 import { chainFailedSchema, chainMetadataSchema, chainSucceededSchema, dataSourceSchema, responseMetadataSchema, responseSchema } from "./response.schema.js";
-import { isSDKError, safeValue, sdkErr, sdkOk } from "./result.js";
+import { safeValue, sdkErr, sdkOk } from "./result.js";
+import { RWA_FACTORY_SECURITIZE, RWA_FACTORY_TYPES, SECURITIZE_REGISTER_VAULT_TYPES } from "./rwa.js";
 import "./withdrawals.js";
 import { positionClaimableWithdrawalSchema, positionPendingWithdrawalSchema, positionWithdrawalsSchema, withdrawalOutputAmountSchema } from "./withdrawals.schema.js";
-export { ANALYTICS_POSITIONS_DEFAULT_LIMIT, ANALYTICS_POSITIONS_MAX_LIMIT, CHART_METRIC_UNITS, CHART_RANGES, CHART_UNAVAILABLE_CODES, FILTER_ALL, POOL_OPPORTUNITY_CHART_METRICS, POOL_POSITION_CHART_METRICS, PROTOCOL_CHART_METRICS, STRATEGY_OPPORTUNITY_CHART_METRICS, STRATEGY_POSITION_CHART_METRICS, STRATEGY_POSITION_COLLATERAL_ERROR, amountSchema, analyticsChartQueryOptionsSchema, analyticsChartQueryParamsSchema, analyticsChartQuerySchema, analyticsPositionListOptionsSchema, analyticsPositionListQueryParamsSchema, analyticsPositionListQuerySchema, analyticsPositionPageSchema, analyticsPositionSchema, analyticsPositionSortFieldSchema, analyticsSortDirectionSchema, apyBreakdownSchema, asEstimated, assetTypeSchema, backendPreferred, booleanParamSchema, borrowRateBreakdownSchema, bpsSchema, chainFailedSchema, chainIdSchema, chainMetadataSchema, chainSucceededSchema, chartBundleSchemaFor, chartDenominationSchema, chartMetricSchema, chartQueryCodec, chartQueryParamsSchema, chartQuerySchema, chartRangeSchema, chartSeriesSchema, chartValueSchema, chartWindowSchema, compareTagOf, curatorNameSchema, curatorSchema, dataSourceSchema, delayedReceivedAssetSchema, encodeFlag, filterAllSchema, filterable, instantReceivedAssetSchema, isFilterSet, isSDKError, leverageSchema, liquidatableAccountFilterSchema, liquidatableAccountSchema, liquidationApprovalSchema, liquidationDetailsSchema, liquidationPositionId, liquidationPositionSchema, matchesLiquidatableAccountFilter, matchesOpportunityFilter, matchesPositionFilter, noticeKindSchema, noticeSchema, offchainOnly, onchainOnly, opportunityBaseSchema, opportunityDetailSchema, opportunityFilterQueryParamsSchema, opportunityFilterQuerySchema, opportunityFilterSchema, opportunityId, opportunityKeySchema, opportunityKindSchema, opportunitySchema, opportunityTotalsSchema, pnlBreakdownSchema, pointRewardsSchema, pointsProgramPnLSchema, pointsProgramSchema, pointsRewardsPnLSchema, poolOpportunityChartMetricSchema, poolOpportunityDetailSchema, poolOpportunityId, poolOpportunityKeySchema, poolOpportunitySchema, poolPositionChartMetricSchema, poolPositionId, poolPositionKeySchema, poolPositionSchema, positionClaimableWithdrawalSchema, positionCollateralSchema, positionFilterQueryParamsSchema, positionFilterQuerySchema, positionFilterSchema, positionId, positionKeySchema, positionKindSchema, positionPendingWithdrawalSchema, positionSchema, positionTransactionKindSchema, positionTransactionSchema, positionWithdrawalsSchema, positionsTotalsSchema, priceFeedDataSchema, priceFeedSummarySchema, protocolChartMetricSchema, quotaAssetSchema, rateCurvePointSchema, rateCurveSchema, receivedAssetSchema, responseMetadataSchema, responseSchema, rewardsPnLSchema, rewardsSchema, safeValue, sdkErr, sdkOk, strategyOpportunityChartMetricSchema, strategyOpportunityDetailSchema, strategyOpportunityId, strategyOpportunityKeySchema, strategyOpportunitySchema, strategyPositionChartMetricSchema, strategyPositionId, strategyPositionKeySchema, strategyPositionSchema, timestampSchema, tokenAmountSchema, tokenQuotaRateSchema, tokenRewardsPnLSchema, tokenRewardsSchema, tokenSchema, tolerance, txCallSchema, underlyingTokenSchema, withdrawalOutputAmountSchema };
+export { ANALYTICS_POSITIONS_DEFAULT_LIMIT, ANALYTICS_POSITIONS_MAX_LIMIT, CHART_METRIC_UNITS, CHART_RANGES, CHART_UNAVAILABLE_CODES, FILTER_ALL, POOL_OPPORTUNITY_CHART_METRICS, POOL_POSITION_CHART_METRICS, PROTOCOL_CHART_METRICS, RWA_FACTORY_SECURITIZE, RWA_FACTORY_TYPES, SECURITIZE_REGISTER_VAULT_TYPES, STRATEGY_OPPORTUNITY_CHART_METRICS, STRATEGY_POSITION_CHART_METRICS, STRATEGY_POSITION_COLLATERAL_ERROR, amountSchema, analyticsChartQueryOptionsSchema, analyticsChartQueryParamsSchema, analyticsChartQuerySchema, analyticsPositionListOptionsSchema, analyticsPositionListQueryParamsSchema, analyticsPositionListQuerySchema, analyticsPositionPageSchema, analyticsPositionSchema, analyticsPositionSortFieldSchema, analyticsSortDirectionSchema, apyBreakdownSchema, asEstimated, assetTypeSchema, backendPreferred, booleanParamSchema, borrowRateBreakdownSchema, bpsSchema, chainFailedSchema, chainIdSchema, chainMetadataSchema, chainSucceededSchema, chartBundleSchemaFor, chartDenominationSchema, chartMetricSchema, chartQueryCodec, chartQueryParamsSchema, chartQuerySchema, chartRangeSchema, chartSeriesSchema, chartValueSchema, chartWindowSchema, compareTagOf, creditAccountFrozen, creditAccountNotEmpty, creditAccountNotFound, creditManagerPaused, curatorNameSchema, curatorSchema, dataSourceSchema, debtOutOfRange, delayedReceivedAssetSchema, emptyOpenTakesNothing, encodeFlag, filterAllSchema, filterable, forbiddenToken, instantReceivedAssetSchema, insufficientAllowance, insufficientBalance, insufficientCollateral, insufficientPoolLiquidity, isFilterSet, leverageOutOfRange, leverageSchema, liquidatableAccountFilterSchema, liquidatableAccountSchema, liquidationApprovalSchema, liquidationDetailsSchema, liquidationPositionId, liquidationPositionSchema, liquidatorNotEligible, malformedTransaction, marketExpired, matchesLiquidatableAccountFilter, matchesOpportunityFilter, matchesPositionFilter, multipleDelayedWithdrawals, noDelayedRoute, noRecordedIntent, noStrategyTargetCollateral, notEmergencyLiquidator, noticeKindSchema, noticeSchema, offchainOnly, onchainOnly, opportunityBaseSchema, opportunityDetailSchema, opportunityFilterQueryParamsSchema, opportunityFilterQuerySchema, opportunityFilterSchema, opportunityId, opportunityKeySchema, opportunityKindSchema, opportunitySchema, opportunityTotalsSchema, pnlBreakdownSchema, pointRewardsSchema, pointsProgramPnLSchema, pointsProgramSchema, pointsRewardsPnLSchema, poolOpportunityChartMetricSchema, poolOpportunityDetailSchema, poolOpportunityId, poolOpportunityKeySchema, poolOpportunitySchema, poolPaused, poolPositionChartMetricSchema, poolPositionId, poolPositionKeySchema, poolPositionSchema, poolSunset, positionClaimableWithdrawalSchema, positionCollateralSchema, positionFilterQueryParamsSchema, positionFilterQuerySchema, positionFilterSchema, positionId, positionKeySchema, positionKindSchema, positionPendingWithdrawalSchema, positionSchema, positionTransactionKindSchema, positionTransactionSchema, positionWithdrawalsSchema, positionsTotalsSchema, priceFeedDataSchema, priceFeedSummarySchema, protocolChartMetricSchema, quotaAssetSchema, quotaCountExceeded, quotaLimitReached, rateCurvePointSchema, rateCurveSchema, receivedAssetSchema, responseMetadataSchema, responseSchema, rewardsPnLSchema, rewardsSchema, rwaOpenRequirementsNotMet, safeValue, sdkErr, sdkOk, strategyOpportunityChartMetricSchema, strategyOpportunityDetailSchema, strategyOpportunityId, strategyOpportunityKeySchema, strategyOpportunitySchema, strategyPositionChartMetricSchema, strategyPositionId, strategyPositionKeySchema, strategyPositionSchema, timestampSchema, tokenAmountSchema, tokenQuotaRateSchema, tokenRewardsPnLSchema, tokenRewardsSchema, tokenSchema, tolerance, txCallSchema, underlyingTokenSchema, unexpectedFailure, unpriceableTokenError, unsupportedCollateralToken, unsupportedTokenPair, withdrawalInProgress, withdrawalOutputAmountSchema };

package/dist/esm/model/positions.js

@@ -60,7 +60,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/esm/model/result.js

@@ -22,12 +22,5 @@ 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
-export { isSDKError, safeValue, sdkErr, sdkOk };
+export { safeValue, sdkErr, sdkOk };

package/dist/esm/model/rwa.js

@@ -0,0 +1,37 @@
+//#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
+export { RWA_FACTORY_SECURITIZE, RWA_FACTORY_TYPES, SECURITIZE_REGISTER_VAULT_TYPES };

package/dist/esm/onchain/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";

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

@@ -6,7 +6,6 @@ import { CreditAccountCompressor } from "./credit-account-compressor/CreditAccou
 import "./credit-account-compressor/index.js";
 import { CreditAccountsServiceV310 } from "./CreditAccountsServiceV310.js";
 import { isPhantomToken } from "./intents/utils/pick-token.js";
-import { borrowable } from "./intents/guards.js";
 import { fetchCreditAccountSlice, toCreditAccountSlice } from "./intents/utils/credit-account-slice.js";
 import { calcDefaultQuota, calcQuotaUpdate, calcRecommendedQuota, roundUpQuota } from "./quota-utils.js";
 import { CreditAccountOperationsService } from "./intents/index.js";
@@ -26,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, LIQUIDATION_APPROVAL_BUFFER, LIQUIDATION_COMPRESSOR_V313_ADDRESS, LiquidationsService, MultichainLiquidationsService, PeripheryCompressorV310Contract, RedemptionLoggerV310Contract, WithdrawalCompressorV310Contract, WithdrawalCompressorV311Contract, WithdrawalCompressorV313Contract, borrowable, calcDefaultQuota, calcQuotaUpdate, calcRecommendedQuota, createRedemptionLogger, createWithdrawalCompressor, decodeDelayedIntent, encodeDelayedIntent, fetchCreditAccountSlice, getWithdrawalCompressorAddress, iCreditAccountAbi, isPhantomToken, roundUpQuota, toClaimableWithdrawal, toCreditAccountSlice, toPendingWithdrawal, toRequestableWithdrawal, toWithdrawalStatus };
+export { AbstractWithdrawalCompressorContract, AccountBotsService, CreditAccountCompressor, CreditAccountCompressorV310Contract, CreditAccountOperationsService, CreditAccountsServiceV310, DELAYED_INTENT_TYPES, DELAYED_INTENT_VERSION, LIQUIDATION_APPROVAL_BUFFER, LIQUIDATION_COMPRESSOR_V313_ADDRESS, LiquidationsService, MultichainLiquidationsService, PeripheryCompressorV310Contract, RedemptionLoggerV310Contract, WithdrawalCompressorV310Contract, WithdrawalCompressorV311Contract, WithdrawalCompressorV313Contract, calcDefaultQuota, calcQuotaUpdate, calcRecommendedQuota, createRedemptionLogger, createWithdrawalCompressor, decodeDelayedIntent, encodeDelayedIntent, fetchCreditAccountSlice, getWithdrawalCompressorAddress, iCreditAccountAbi, isPhantomToken, roundUpQuota, toClaimableWithdrawal, toCreditAccountSlice, toPendingWithdrawal, toRequestableWithdrawal, toWithdrawalStatus };

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

@@ -1,6 +1,13 @@
-import { MIN_HEALTH_FACTOR_FACADE, checkBorrowLimit, checkCollateralised, checkCreditManagerPaused, checkForbiddenToken, checkMarketExpired, checkQuotaLimit } from "../../validation/checks.js";
-import { raise } from "../../validation/refusal.js";
-import { toToken } from "../../validation/token.js";
+import { MIN_HEALTH_FACTOR_FACADE } from "../../validation/helpers/health-factor-limits.js";
+import { toToken } from "../../validation/helpers/token.js";
+import { checkBorrowLimit } from "../../validation/checks/checkBorrowLimit.js";
+import { checkCollateralised } from "../../validation/checks/checkCollateralised.js";
+import { checkCreditManagerPaused } from "../../validation/checks/checkCreditManagerPaused.js";
+import { checkForbiddenToken } from "../../validation/checks/checkForbiddenToken.js";
+import { checkMarketExpired } from "../../validation/checks/checkMarketExpired.js";
+import { checkQuotaLimit } from "../../validation/checks/checkQuotaLimit.js";
+import { raise } from "../../validation/raise.js";
+import "../../validation/index.js";
 import { eq } from "./utils/common.js";
 import { isPhantomToken } from "./utils/pick-token.js";
 //#region src/onchain/accounts/intents/guards.ts
@@ -34,44 +41,15 @@ function assertMarketOperable(suite) {
 		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);
+	const { value, limit } = suite.maxBorrowAmount();
 	raise(checkBorrowLimit({
 		requested: amount,
-		available: limit,
-		binding,
+		available: value,
+		limit,
 		underlying: toToken(sdk, suite.market.pool.underlying)
-	}), `borrow: ${amount} exceeds what the pool can lend now (${limit})`);
+	}), `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.
@@ -87,13 +65,12 @@ 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) => eq(a.token, token))?.balance ?? 0n)) continue;
 		raise(checkForbiddenToken({
 			token: toToken(sdk, token),
-			isForbidden: forbidden.some((f) => eq(f, token))
+			isForbidden: suite.isForbidden(token)
 		}), `${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)) raise(checkQuotaLimit({
@@ -109,19 +86,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
@@ -134,24 +112,23 @@ function assertGrowthAllowed(args) {
 * still be refused on-chain after passing here.
 */
 function assertCollateralised(healthFactorBps, safePrices) {
-	const required = MIN_HEALTH_FACTOR_FACADE;
+	const healthFactorThreshold = MIN_HEALTH_FACTOR_FACADE;
 	raise(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;
+		if (balance <= 0n || !pqk.quotas.has(token)) continue;
+		const left = pqk.quotaAvailable(token);
 		raise(checkQuotaLimit({
 			token: toToken(sdk, token),
 			requested: balance,
@@ -161,4 +138,4 @@ function assertQuotaHeadroom(sdk, market, increases) {
 	}
 }
 //#endregion
-export { assertCanBorrow, assertCollateralised, assertGrowthAllowed, assertMarketOperable, assertQuotaHeadroom, borrowable };
+export { assertCanBorrow, assertCollateralised, assertGrowthAllowed, assertMarketOperable, assertQuotaAvailable };

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

@@ -1,8 +1,12 @@
 import { SDKConstruct } from "../../base/SDKConstruct.js";
-import { MIN_HF_LIMITED } from "../../validation/checks.js";
-import { IntentPreviewError, refuse } from "../../validation/refusal.js";
+import { unsupportedTokenPair } from "../../../model/errors/prepare-errors.js";
+import { sdkErr } from "../../../model/result.js";
+import "../../../model/index.js";
+import { MIN_HF_LIMITED } from "../../validation/helpers/health-factor-limits.js";
+import { IntentPreviewError } from "../../validation/raise.js";
+import "../../validation/index.js";
 import { isPhantomToken } from "./utils/pick-token.js";
-import { assertMarketOperable, borrowable } from "./guards.js";
+import { assertMarketOperable } from "./guards.js";
 import { calcLeverageBand } from "./leverage-band.js";
 import { maxProportionalWithdrawal } from "./math.js";
 import { maxWithdrawCollateral } from "./maxWithdrawCollateral.js";
@@ -25,7 +29,7 @@ var CreditAccountOperationsService = class extends SDKConstruct {
 	* 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)
 	*/
@@ -46,8 +50,8 @@ var CreditAccountOperationsService = class extends SDKConstruct {
 	}
 	/**
 	* 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.
@@ -63,7 +67,7 @@ var CreditAccountOperationsService = class extends SDKConstruct {
 	maxWithdraw(props) {
 		const view = accountView(props.creditAccount, props.sdk);
 		return {
-			partial: maxProportionalWithdrawal(view, view.band),
+			partial: maxProportionalWithdrawal(view, view.debtLimits),
 			exit: view.collateral > 0n ? view.collateral : 0n
 		};
 	}
@@ -88,8 +92,8 @@ var CreditAccountOperationsService = class extends SDKConstruct {
 	*
 	* 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
@@ -108,9 +112,9 @@ var CreditAccountOperationsService = class extends SDKConstruct {
 	* 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
@@ -130,8 +134,8 @@ var CreditAccountOperationsService = class extends SDKConstruct {
 	*
 	* 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.
 	*
@@ -143,7 +147,7 @@ var CreditAccountOperationsService = class extends SDKConstruct {
 	*
 	* @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) {
@@ -179,7 +183,7 @@ var CreditAccountOperationsService = class extends SDKConstruct {
 				delayed
 			};
 		} catch (e) {
-			return asFailure(e);
+			return asSDKError(e);
 		}
 	}
 	/**
@@ -189,7 +193,7 @@ var CreditAccountOperationsService = class extends SDKConstruct {
 	* 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
@@ -199,31 +203,31 @@ var CreditAccountOperationsService = class extends SDKConstruct {
 	*
 	* @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
+			...sdkErr(chosen),
+			errors
 		};
 	}
 	/**
@@ -236,7 +240,7 @@ var CreditAccountOperationsService = class extends SDKConstruct {
 	* 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.
 	*
@@ -275,7 +279,7 @@ var CreditAccountOperationsService = class extends SDKConstruct {
 	*
 	* @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) {
@@ -285,7 +289,7 @@ var CreditAccountOperationsService = class extends SDKConstruct {
 				state: await buildOpenStrategyState(props)
 			};
 		} catch (e) {
-			return asFailure(e);
+			return asSDKError(e);
 		}
 	}
 	/** Plan → realise → wrap. Unviable requests become `{ ok: false }`. */
@@ -306,7 +310,7 @@ var CreditAccountOperationsService = class extends SDKConstruct {
 				delayed
 			};
 		} catch (e) {
-			return asFailure(e);
+			return asSDKError(e);
 		}
 	}
 };
@@ -322,16 +326,16 @@ function plain(result) {
 	};
 }
 /** Unviable requests are values; anything else is a genuine failure. */
-function asFailure(e) {
-	if (e instanceof IntentPreviewError) return refuse(e.reason, e.detail);
-	if (isUnroutable(e)) return refuse("unsupportedTokenPair", void 0);
+function asSDKError(e) {
+	if (e instanceof IntentPreviewError) return sdkErr(e.error);
+	if (isUnroutable(e)) return sdkErr(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.
 */
@@ -340,4 +344,4 @@ function isUnroutable(e) {
 	return false;
 }
 //#endregion
-export { CreditAccountOperationsService, borrowable, fetchCreditAccountSlice, isPhantomToken, toCreditAccountSlice };
+export { CreditAccountOperationsService, fetchCreditAccountSlice, isPhantomToken, toCreditAccountSlice };

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

@@ -7,7 +7,7 @@ import { LEVERAGE_DECIMALS } from "../../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