@gearbox-protocol/sdk 17.1.0-next.1 → 17.1.0-next.3

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

@@ -50,48 +50,53 @@ var PrepareApi = class extends MultichainConstruct {
 	* {@inheritDoc IOpportunitiesPrepare.finalize}
 	**/
 	async finalize(position, params) {
+		const state = {};
 		try {
 			const sdk = await this.#chain(position.chainId);
 			const at = stateBlock(sdk);
 			const intent = resumable(params.intent ?? params.claimable.intent);
-			if (!intent) return sdkErr(noRecordedIntent());
+			if (!intent) return refused(noRecordedIntent(), state);
 			const creditAccount = await slice$1(sdk, position.creditAccount);
-			if (!creditAccount) return sdkErr(creditAccountNotFound(position.creditAccount));
+			if (!creditAccount) return refused(creditAccountNotFound(position.creditAccount), state);
 			return finalized(await service(sdk).finishIntent({
 				intent,
 				claimable: toClaimableWithdrawal(params.claimable),
 				creditAccount,
 				sdk,
 				slippage: params.slippage,
-				quotaReserve: params.quotaReserve
+				quotaReserve: params.quotaReserve,
+				draft: state
 			}), at);
 		} catch (e) {
-			return sdkErr(unexpectedFailure(e));
+			return refused(unexpectedFailure(e), state);
 		}
 	}
 	/**
 	* {@inheritDoc IOpportunitiesPrepare.deposit}
 	**/
 	async deposit(pool, params) {
+		const draft = {};
 		try {
 			const chain = await this.#chain(pool.chainId);
 			const { marketRegister, pools } = chain;
+			draft.curator = marketRegister.findByPool(pool.pool).curator;
 			const tokenIn = params.tokenIn ?? marketRegister.findByPool(pool.pool).pool.underlying;
 			const tokenOut = lpRoute(params.tokenOut, () => pools.getDepositTokensOut(pool.pool, tokenIn));
-			if (!tokenOut) return unroutable(chain, tokenIn, void 0);
+			if (!tokenOut) return unroutable(chain, tokenIn, void 0, draft);
 			const state = pools.simulateDeposit({
 				pool: pool.pool,
 				amount: params.amount,
 				tokenIn,
 				tokenOut
 			});
+			Object.assign(draft, state);
 			const [refusal] = checkPoolOperation({
 				sdk: chain,
 				pool: pool.pool,
 				isDeposit: true,
 				tokenOut: state.tokenOut
 			});
-			if (refusal) return sdkErr(refusal);
+			if (refusal) return refused(refusal, draft);
 			const call = pools.addLiquidity({
 				collateral: {
 					token: state.tokenIn.token.address,
@@ -101,7 +106,7 @@ var PrepareApi = class extends MultichainConstruct {
 				wallet: params.wallet,
 				meta: pools.getDepositMetadata(pool.pool, tokenIn, tokenOut)
 			});
-			if (!call) return unroutable(chain, tokenIn, tokenOut);
+			if (!call) return unroutable(chain, tokenIn, tokenOut, draft);
 			return sdkOk({
 				operations: [],
 				state: await lpState(chain, pool.pool, params.wallet, state, { mints: state.tokenOut.value }),
@@ -109,32 +114,35 @@ var PrepareApi = class extends MultichainConstruct {
 				...stateBlock(chain)
 			});
 		} catch (e) {
-			return sdkErr(unexpectedFailure(e));
+			return refused(unexpectedFailure(e), draft);
 		}
 	}
 	/**
 	* {@inheritDoc IOpportunitiesPrepare.withdraw}
 	**/
 	async withdraw(pool, params) {
+		const draft = {};
 		try {
 			const chain = await this.#chain(pool.chainId);
 			const { pools } = chain;
+			draft.curator = chain.marketRegister.findByPool(pool.pool).curator;
 			const tokenIn = params.tokenIn ?? pool.pool;
 			const tokenOut = lpRoute(params.tokenOut, () => pools.getWithdrawalTokensOut(pool.pool, tokenIn));
-			if (!tokenOut) return unroutable(chain, tokenIn, void 0);
+			if (!tokenOut) return unroutable(chain, tokenIn, void 0, draft);
 			const state = pools.simulateWithdraw({
 				pool: pool.pool,
 				amount: params.amount,
 				tokenIn,
 				tokenOut
 			});
+			Object.assign(draft, state);
 			const [refusal] = checkPoolOperation({
 				sdk: chain,
 				pool: pool.pool,
 				isDeposit: false,
 				tokenOut: state.tokenOut
 			});
-			if (refusal) return sdkErr(refusal);
+			if (refusal) return refused(refusal, draft);
 			const { calls } = pools.removeLiquidity({
 				pool: pool.pool,
 				amount: params.amount,
@@ -150,32 +158,35 @@ var PrepareApi = class extends MultichainConstruct {
 				...stateBlock(chain)
 			});
 		} catch (e) {
-			return sdkErr(unexpectedFailure(e));
+			return refused(unexpectedFailure(e), draft);
 		}
 	}
 	/**
 	* {@inheritDoc IOpportunitiesPrepare.redeem}
 	**/
 	async redeem(pool, params) {
+		const draft = {};
 		try {
 			const chain = await this.#chain(pool.chainId);
 			const { pools } = chain;
+			draft.curator = chain.marketRegister.findByPool(pool.pool).curator;
 			const tokenIn = params.tokenIn ?? pool.pool;
 			const tokenOut = lpRoute(params.tokenOut, () => pools.getWithdrawalTokensOut(pool.pool, tokenIn));
-			if (!tokenOut) return unroutable(chain, tokenIn, void 0);
+			if (!tokenOut) return unroutable(chain, tokenIn, void 0, draft);
 			const state = pools.simulateRedeem({
 				pool: pool.pool,
 				amount: params.amount,
 				tokenIn,
 				tokenOut
 			});
+			Object.assign(draft, state);
 			const [refusal] = checkPoolOperation({
 				sdk: chain,
 				pool: pool.pool,
 				isDeposit: false,
 				tokenOut: state.tokenOut
 			});
-			if (refusal) return sdkErr(refusal);
+			if (refusal) return refused(refusal, draft);
 			const { calls } = pools.removeLiquidity({
 				pool: pool.pool,
 				amount: params.amount,
@@ -191,7 +202,7 @@ var PrepareApi = class extends MultichainConstruct {
 				...stateBlock(chain)
 			});
 		} catch (e) {
-			return sdkErr(unexpectedFailure(e));
+			return refused(unexpectedFailure(e), draft);
 		}
 	}
 	/**
@@ -214,13 +225,15 @@ var PrepareApi = class extends MultichainConstruct {
 	* {@inheritDoc IOpportunitiesPrepare.openNewStrategy}
 	**/
 	async openNewStrategy(strategy, params) {
+		const state = {};
 		try {
 			const sdk = await this.#chain(strategy.chainId);
 			const at = stateBlock(sdk);
+			Object.assign(state, marketOf(sdk, strategy.creditManager));
 			const targetToken = params.targetToken ?? sdk.marketRegister.findCreditManager(strategy.creditManager).strategyTargetCollateral;
-			if (!targetToken) return sdkErr(noStrategyTargetCollateral(strategy.creditManager));
+			if (!targetToken) return refused(noStrategyTargetCollateral(strategy.creditManager), state);
 			const reused = await reusable(sdk, strategy, params.creditAccount);
-			if (reused && "error" in reused) return reused;
+			if (reused && "error" in reused) return refused(reused.error, state);
 			const creditAccount = reused?.account;
 			return opened(await service(sdk).openStrategyIntent({
 				sdk,
@@ -231,21 +244,24 @@ var PrepareApi = class extends MultichainConstruct {
 				leftoverBalances: params.leftoverBalances,
 				slippage: params.slippage,
 				quotaReserve: params.quotaReserve,
-				creditAccount
+				creditAccount,
+				draft: state
 			}), at);
 		} catch (e) {
-			return sdkErr(unexpectedFailure(e));
+			return refused(unexpectedFailure(e), state);
 		}
 	}
 	/**
 	* {@inheritDoc IOpportunitiesPrepare.borrow}
 	**/
 	async borrow(strategy, params) {
+		const state = {};
 		try {
 			const sdk = await this.#chain(strategy.chainId);
 			const at = stateBlock(sdk);
+			Object.assign(state, marketOf(sdk, strategy.creditManager));
 			const reused = await reusable(sdk, strategy, params.creditAccount);
-			if (reused && "error" in reused) return reused;
+			if (reused && "error" in reused) return refused(reused.error, state);
 			return borrowed(await service(sdk).borrowIntent({
 				sdk,
 				creditManager: strategy.creditManager,
@@ -255,10 +271,11 @@ var PrepareApi = class extends MultichainConstruct {
 				borrowAmount: params.borrowAmount,
 				slippage: params.slippage,
 				quotaReserve: params.quotaReserve,
-				creditAccount: reused?.account
+				creditAccount: reused?.account,
+				draft: state
 			}), at);
 		} catch (e) {
-			return sdkErr(unexpectedFailure(e));
+			return refused(unexpectedFailure(e), state);
 		}
 	}
 	/**
@@ -418,20 +435,22 @@ var PrepareApi = class extends MultichainConstruct {
 	* ones, per the engine trace its signature spells out.
 	**/
 	async #startRoutes(position, options, intent) {
+		const state = {};
 		try {
 			const sdk = await this.#chain(position.chainId);
 			const at = stateBlock(sdk);
 			const creditAccount = await slice$1(sdk, position.creditAccount);
-			if (!creditAccount) return neitherRoute(creditAccountNotFound(position.creditAccount));
+			if (!creditAccount) return neitherRoute(creditAccountNotFound(position.creditAccount), state);
 			return routed(await service(sdk).intentRoutes({
 				intent,
 				creditAccount,
 				sdk,
 				slippage: options.slippage,
-				quotaReserve: options.quotaReserve
+				quotaReserve: options.quotaReserve,
+				draft: state
 			}), at);
 		} catch (e) {
-			return neitherRoute(unexpectedFailure(e));
+			return neitherRoute(unexpectedFailure(e), state);
 		}
 	}
 	/**
@@ -444,20 +463,22 @@ var PrepareApi = class extends MultichainConstruct {
 	* ones, per the engine trace its signature spells out.
 	**/
 	async #startIntent(position, options, intent) {
+		const state = {};
 		try {
 			const sdk = await this.#chain(position.chainId);
 			const at = stateBlock(sdk);
 			const creditAccount = await slice$1(sdk, position.creditAccount);
-			if (!creditAccount) return sdkErr(creditAccountNotFound(position.creditAccount));
+			if (!creditAccount) return refused(creditAccountNotFound(position.creditAccount), state);
 			return planned(await service(sdk).startIntent({
 				intent,
 				creditAccount,
 				sdk,
 				slippage: options.slippage,
-				quotaReserve: options.quotaReserve
+				quotaReserve: options.quotaReserve,
+				draft: state
 			}), at);
 		} catch (e) {
-			return sdkErr(unexpectedFailure(e));
+			return refused(unexpectedFailure(e), state);
 		}
 	}
 };
@@ -545,14 +566,44 @@ function methodError(result) {
 	return result;
 }
 /**
+* An error the namespace decides on itself, carrying as much of the state as
+* it can say — nothing at all where it stopped before there was a market to
+* name, see {@link WithPartialState}.
+*
+* The engine attaches its own draft on the way out, so this is only for what
+* is raised on this side of it: a chain that would not resolve, an account the
+* markets do not hold, a pool pair with no route.
+**/
+function refused(error, state) {
+	return sdkErr({
+		...error,
+		state
+	});
+}
+/**
+* The market fields of a request that names its credit manager, for what is
+* turned down before the engine has been reached at all.
+*
+* Empty where the SDK holds no such manager, which is itself one of those
+* answers.
+**/
+function marketOf(sdk, creditManager) {
+	try {
+		return sdk.marketRegister.findCreditManager(creditManager).creditOperationMarket();
+	} catch {
+		return {};
+	}
+}
+/**
 * A flow with two routes, stopped before either could be quoted: the error is
 * the same one any other flow would report, with nothing to say about the
 * routes because neither was reached.
 **/
-function neitherRoute(error) {
+function neitherRoute(error, state) {
 	return sdkErr({
 		...error,
-		errors: {}
+		errors: {},
+		state
 	});
 }
 /**
@@ -671,11 +722,11 @@ async function lpState(sdk, pool, wallet, simulation, moved) {
 * is the usual way of it; both are present where a pair exists but nothing of
 * ours implements it.
 **/
-function unroutable(sdk, from, to) {
-	return sdkErr(unsupportedTokenPair({
+function unroutable(sdk, from, to, state) {
+	return refused(unsupportedTokenPair({
 		from: toToken(sdk, from),
 		to: to === void 0 ? void 0 : toToken(sdk, to)
-	}));
+	}), state);
 }
 /**
 * Picks the route the operation takes out of `tokenIn`, as a value rather than

package/dist/types/onchain/MultichainSDK.d.ts

@@ -1,8 +1,6 @@
 import { ILogger } from "./types/logger.js";
 import { NetworkType } from "./chain/chains.js";
 import { MultichainStateHuman } from "./types/state-human.js";
-import { RedstoneOptions } from "./market/pricefeeds/updates/RedstoneUpdater.js";
-import "./market/pricefeeds/updates/index.js";
 import { PluginFactoriesMap, PluginsMap } from "./plugins/types.js";
 import "./plugins/index.js";
 import { MultichainOpportunitiesService } from "./opportunities/MultichainOpportunitiesService.js";
@@ -59,10 +57,6 @@ interface MultichainAttachOptions {
    * Per-chain attach options.
    **/
   perChain?: Partial<Record<NetworkType, AttachOptions>>;
-  /**
-   * Options for Redstone price-feed updates (shared cache across chains).
-   **/
-  redstone?: RedstoneOptions;
 }
 /**
  * Options for {@link MultichainSDK.hydrate}.
@@ -72,10 +66,6 @@ interface MultichainHydrateOptions {
    * Per-chain hydrate options.
    **/
   perChain?: Partial<Record<NetworkType, HydrateOptions>>;
-  /**
-   * Options for Redstone price-feed updates (shared cache across chains).
-   **/
-  redstone?: RedstoneOptions;
   /**
    * When `true`, chains missing from the serialised state are silently skipped
    * instead of throwing {@link SdkMissingChainStateError}.

package/dist/types/onchain/OnchainSDK.d.ts

@@ -6,9 +6,7 @@ import { VersionRange } from "./constants/versions.js";
 import "./constants/index.js";
 import { RWARegistry } from "./market/rwa/RWARegistry.js";
 import { GearboxStateHuman } from "./types/state-human.js";
-import { RedstoneOptions } from "./market/pricefeeds/updates/RedstoneUpdater.js";
 import { UpdatablePriceFeedRegistry } from "./market/pricefeeds/updates/UpdatablePriceFeedRegistry.js";
-import "./market/pricefeeds/updates/index.js";
 import "./market/pricefeeds/index.js";
 import { IRouterContract } from "./router/types.js";
 import "./router/index.js";
@@ -128,10 +126,6 @@ interface AttachOptions {
    * Pool addresses whose markets should be skipped.
    **/
   ignoreMarkets?: Address[];
-  /**
-   * Options for Redstone price-feed updates.
-   **/
-  redstone?: RedstoneOptions;
 }
 /**
  * Options accepted by {@link OnchainSDK.hydrate}.
@@ -141,10 +135,6 @@ interface HydrateOptions {
    * Pool addresses whose markets should be skipped.
    **/
   ignoreMarkets?: Address[];
-  /**
-   * Options for Redstone price-feed updates.
-   **/
-  redstone?: RedstoneOptions;
 }
 /**
  * Options for {@link OnchainSDK.syncState}, controlling which block to

package/dist/types/onchain/accounts/index.d.ts

@@ -21,7 +21,7 @@ import "./bots/index.js";
 import { CreditAccountsServiceV310 } from "./CreditAccountsServiceV310.js";
 import { CalcDefaultQuotaProps, CalcQuotaUpdateProps, CalcRecommendedQuotaProps, calcDefaultQuota, calcQuotaUpdate, calcRecommendedQuota, roundUpQuota } from "./quota-utils.js";
 import { AccountCalculatorOperation } from "./intents/operations.js";
-import { AddCollateralIntent, AdjustLeverageIntent, ClaimRemainder, CreditAccountSlice, DelayableIntent, DelayedRoute, DelayedStart, DelayedStartResult, DepositStrategyIntent, ExecutionCost, FinishIntentProps, FinishIntentResult, InstantRoute, IntentPreviewResult, IntentRoutesResult, OperationState, PathLossRate, RepayStrategyIntent, ResumableIntent, RouteErrors, StartIntent, WithdrawAssetIntent, WithdrawCeilings, WithdrawStrategyIntent } from "./intents/types.js";
+import { AddCollateralIntent, AdjustLeverageIntent, ClaimRemainder, CreditAccountSlice, DelayableIntent, DelayedRoute, DelayedStart, DelayedStartResult, DepositStrategyIntent, ExecutionCost, FinishIntentProps, FinishIntentResult, InstantRoute, IntentPreviewResult, IntentRoutesResult, OperationState, PathLossRate, RefusedIntent, RepayStrategyIntent, ResumableIntent, RouteErrors, StartIntent, WithPartialState, WithdrawAssetIntent, WithdrawCeilings, WithdrawStrategyIntent } from "./intents/types.js";
 import { BorrowProps, BorrowState } from "./intents/borrow.js";
 import { LeverageBand } from "./intents/leverage-band.js";
 import { OpenStrategyProps, OpenStrategyState } from "./intents/open-strategy.js";
@@ -33,4 +33,4 @@ import { BuildLiquidationTxProps, BuildLiquidationTxPropsBase, GetLiquidatableAc
 import { LiquidationsService } from "./liquidations/LiquidationsService.js";
 import { MultichainLiquidationsService } from "./liquidations/MultichainLiquidationsService.js";
 import "./liquidations/index.js";
-export { AbstractWithdrawalCompressorContract, AccountBotsService, type AccountCalculatorOperation, AccountToCheck, type AddCollateralIntent, type AdjustLeverageIntent, AssembleCaOperationsProps, AssembleClaimDelayedCallsProps, AssembleCloseCreditAccountCallsProps, AssembleRepayCreditAccountCallsProps, AssembleStartDelayedWithdrawalCallsProps, BorrowPreviewResult, type BorrowProps, type BorrowState, BotStatusCall, BotsDirectResponse, BuildLiquidationTxProps, BuildLiquidationTxPropsBase, CMSlice, CalcDefaultQuotaProps, CalcQuotaUpdateProps, CalcRecommendedQuotaProps, ClaimFarmRewardsProps, type ClaimRemainder, ClaimableWithdrawal, CloseCreditAccountResult, ConnectedBotsCall, ConnectedBotsPerAccount, CreditAccountCompressor, CreditAccountCompressorV310Contract, CreditAccountDataCall, CreditAccountFilter, CreditAccountOperationResult, CreditAccountOperationsService, CreditAccountReadOptions, type CreditAccountSlice, CreditAccountsCall, CreditAccountsQuery, CreditAccountsReadOptions, CreditAccountsServiceV310, CreditAccountsTarget, CreditManagerFilter, CreditManagerOperationResult, CurrentWithdrawals, DELAYED_INTENT_TYPES, DELAYED_INTENT_VERSION, type DelayableIntent, DelayedIntentExtended, type DelayedRoute, type DelayedStart, type DelayedStartResult, type DepositStrategyIntent, EmptyAccountPreviewResult, EncodableCreditAccountOperation, type ExecutionCost, type FinishIntentProps, type FinishIntentResult, FullyLiquidateProps, FullyLiquidateResult, GetApprovalAddressProps, GetConnectedBotsResponse, GetConnectedBotsResult, GetConnectedMigrationBotsResult, GetCreditAccountsArgs, GetCreditAccountsOptions, GetExternalAccountCurrentWithdrawalsProps, GetLiquidatableAccountsProps, GetLiquidationDetailsProps, GetLiquidationDetailsPropsBase, GetLiquidationPositionsProps, GetLiquidationPositionsPropsBase, GetWithdrawalRequestResultProps, ICreditAccountsService, IRedemptionLoggerContract, IWithdrawalCompressorContract, type InstantRoute, type IntentPreviewResult, type IntentRoutesResult, LIQUIDATION_APPROVAL_BUFFER, LIQUIDATION_COMPRESSOR_V313_ADDRESS, type LeverageBand, LiquidationsService, LoadRWALiquidatorsProps, MulticallWithFailure, MultichainLiquidationsService, OnchainLiquidationCall, OnchainLiquidationData, OnchainLiquidationOutput, OnchainRequestableWithdrawal, OpenCAProps, OpenStrategyPreviewResult, type OpenStrategyProps, type OpenStrategyState, type OperationState, PartiallyLiquidateProps, type PathLossRate, PendingWithdrawal, PeripheryCompressorV310Contract, PreviewDelayedWithdrawalProps, RWALiquidatorInfo, RedemptionLog, RedemptionLoggerV310Contract, type RepayStrategyIntent, RequestableWithdrawal, type ResumableIntent, Rewards, type RouteErrors, SetBotProps, SetBotResult, type StartIntent, type WithdrawAssetIntent, type WithdrawCeilings, type WithdrawStrategyIntent, WithdrawableAsset, WithdrawalCompressorLocation, WithdrawalCompressorV310Contract, WithdrawalCompressorV311Contract, WithdrawalCompressorV313Contract, WithdrawalCompressorVersion, WithdrawalOutput, WithdrawalStatus, WithdrawalsState, calcDefaultQuota, calcQuotaUpdate, calcRecommendedQuota, createRedemptionLogger, createWithdrawalCompressor, decodeDelayedIntent, encodeDelayedIntent, fetchCreditAccountSlice, getWithdrawalCompressorAddress, iCreditAccountAbi, isPhantomToken, roundUpQuota, toClaimableWithdrawal, toCreditAccountSlice, toPendingWithdrawal, toRequestableWithdrawal, toWithdrawalStatus };
+export { AbstractWithdrawalCompressorContract, AccountBotsService, type AccountCalculatorOperation, AccountToCheck, type AddCollateralIntent, type AdjustLeverageIntent, AssembleCaOperationsProps, AssembleClaimDelayedCallsProps, AssembleCloseCreditAccountCallsProps, AssembleRepayCreditAccountCallsProps, AssembleStartDelayedWithdrawalCallsProps, BorrowPreviewResult, type BorrowProps, type BorrowState, BotStatusCall, BotsDirectResponse, BuildLiquidationTxProps, BuildLiquidationTxPropsBase, CMSlice, CalcDefaultQuotaProps, CalcQuotaUpdateProps, CalcRecommendedQuotaProps, ClaimFarmRewardsProps, type ClaimRemainder, ClaimableWithdrawal, CloseCreditAccountResult, ConnectedBotsCall, ConnectedBotsPerAccount, CreditAccountCompressor, CreditAccountCompressorV310Contract, CreditAccountDataCall, CreditAccountFilter, CreditAccountOperationResult, CreditAccountOperationsService, CreditAccountReadOptions, type CreditAccountSlice, CreditAccountsCall, CreditAccountsQuery, CreditAccountsReadOptions, CreditAccountsServiceV310, CreditAccountsTarget, CreditManagerFilter, CreditManagerOperationResult, CurrentWithdrawals, DELAYED_INTENT_TYPES, DELAYED_INTENT_VERSION, type DelayableIntent, DelayedIntentExtended, type DelayedRoute, type DelayedStart, type DelayedStartResult, type DepositStrategyIntent, EmptyAccountPreviewResult, EncodableCreditAccountOperation, type ExecutionCost, type FinishIntentProps, type FinishIntentResult, FullyLiquidateProps, FullyLiquidateResult, GetApprovalAddressProps, GetConnectedBotsResponse, GetConnectedBotsResult, GetConnectedMigrationBotsResult, GetCreditAccountsArgs, GetCreditAccountsOptions, GetExternalAccountCurrentWithdrawalsProps, GetLiquidatableAccountsProps, GetLiquidationDetailsProps, GetLiquidationDetailsPropsBase, GetLiquidationPositionsProps, GetLiquidationPositionsPropsBase, GetWithdrawalRequestResultProps, ICreditAccountsService, IRedemptionLoggerContract, IWithdrawalCompressorContract, type InstantRoute, type IntentPreviewResult, type IntentRoutesResult, LIQUIDATION_APPROVAL_BUFFER, LIQUIDATION_COMPRESSOR_V313_ADDRESS, type LeverageBand, LiquidationsService, LoadRWALiquidatorsProps, MulticallWithFailure, MultichainLiquidationsService, OnchainLiquidationCall, OnchainLiquidationData, OnchainLiquidationOutput, OnchainRequestableWithdrawal, OpenCAProps, OpenStrategyPreviewResult, type OpenStrategyProps, type OpenStrategyState, type OperationState, PartiallyLiquidateProps, type PathLossRate, PendingWithdrawal, PeripheryCompressorV310Contract, PreviewDelayedWithdrawalProps, RWALiquidatorInfo, RedemptionLog, RedemptionLoggerV310Contract, type RefusedIntent, type RepayStrategyIntent, RequestableWithdrawal, type ResumableIntent, Rewards, type RouteErrors, SetBotProps, SetBotResult, type StartIntent, type WithPartialState, type WithdrawAssetIntent, type WithdrawCeilings, type WithdrawStrategyIntent, WithdrawableAsset, WithdrawalCompressorLocation, WithdrawalCompressorV310Contract, WithdrawalCompressorV311Contract, WithdrawalCompressorV313Contract, WithdrawalCompressorVersion, WithdrawalOutput, WithdrawalStatus, WithdrawalsState, calcDefaultQuota, calcQuotaUpdate, calcRecommendedQuota, createRedemptionLogger, createWithdrawalCompressor, decodeDelayedIntent, encodeDelayedIntent, fetchCreditAccountSlice, getWithdrawalCompressorAddress, iCreditAccountAbi, isPhantomToken, roundUpQuota, toClaimableWithdrawal, toCreditAccountSlice, toPendingWithdrawal, toRequestableWithdrawal, toWithdrawalStatus };

package/dist/types/onchain/accounts/intents/borrow.d.ts

@@ -45,6 +45,11 @@ interface BorrowProps {
    * an account that already owes is what the `ADJUST_LEVERAGE` intent is for.
    **/
   creditAccount?: CreditAccountSlice;
+  /**
+   * Where the walk writes the state as it reaches it, see
+   * {@link StartIntentProps.draft}. Omitted by a walk nobody reports.
+   **/
+  draft?: Partial<BorrowState>;
 }
 /**
  * Where a borrow leaves the wallet and the account it opens.

package/dist/types/onchain/accounts/intents/guards.d.ts

@@ -7,7 +7,8 @@ import { OnchainSDK } from "../../OnchainSDK.js";
 import "../../index.js";
 //#region src/onchain/accounts/intents/guards.d.ts
 /**
- * What the market itself refuses, checked before anything is quoted.
+ * What the market itself refuses, read from its loaded state rather than
+ * learned from a revert.
  *
  * The planners answer for the arithmetic of an intent and the ledger for the
  * balances it moves, but neither can see that the facade is paused or that the
@@ -16,9 +17,10 @@ import "../../index.js";
  * loaded market and reported as refusals instead.
  *
  * Every guard here refuses something the market decides rather than something
- * the arithmetic cannot do, which is why all six of their reasons are
- * `blocking`: the walk that hit one still reached an end state, and a caller
- * gets that state alongside the refusal.
+ * the arithmetic cannot do, so where the account would have landed stays a
+ * question the walk can answer. The three that judge that end state — growth,
+ * quota limits, collateral — therefore run only once the projection exists,
+ * which is what lets them hand it back as `state` when they refuse.
  */
 /**
  * The facade takes no multicall while it is paused or past its expiration, so

package/dist/types/onchain/accounts/intents/index.d.ts

@@ -3,7 +3,7 @@ import "../../../model/index.js";
 import { SDKConstruct } from "../../base/SDKConstruct.js";
 import { IntentValidationError } from "../../validation/raise.js";
 import { AccountCalculatorOperation } from "./operations.js";
-import { AddCollateralIntent, AdjustLeverageIntent, ClaimRemainder, CreditAccountSlice, DelayableIntent, DelayedRoute, DelayedStart, DelayedStartResult, DepositStrategyIntent, ExecutionCost, FinishIntentProps, FinishIntentResult, InstantRoute, IntentPreviewResult, IntentRoutesResult, OperationState, PathLossRate, RepayStrategyIntent, ResumableIntent, RouteErrors, StartIntent, StartIntentProps, WithdrawAssetIntent, WithdrawCeilings, WithdrawStrategyIntent } from "./types.js";
+import { AddCollateralIntent, AdjustLeverageIntent, ClaimRemainder, CreditAccountSlice, DelayableIntent, DelayedRoute, DelayedStart, DelayedStartResult, DepositStrategyIntent, ExecutionCost, FinishIntentProps, FinishIntentResult, InstantRoute, IntentPreviewResult, IntentRoutesResult, OperationState, PathLossRate, RefusedIntent, RepayStrategyIntent, ResumableIntent, RouteErrors, StartIntent, StartIntentProps, WithPartialState, WithdrawAssetIntent, WithdrawCeilings, WithdrawStrategyIntent } from "./types.js";
 import { BorrowProps, BorrowState } from "./borrow.js";
 import { LeverageBand, LeverageBandProps } from "./leverage-band.js";
 import { MaxBorrowProps } from "./maxBorrow.js";
@@ -22,7 +22,7 @@ import { Address } from "viem";
 type OpenStrategyPreviewResult = {
   ok: true;
   state: OpenStrategyState;
-} | SDKError<IntentValidationError>;
+} | SDKError<RefusedIntent<OpenStrategyState>>;
 /**
  * Borrow preview outcome, shaped like {@link OpenStrategyPreviewResult}: both
  * open an account, so neither has an operation chain to report.
@@ -30,7 +30,7 @@ type OpenStrategyPreviewResult = {
 type BorrowPreviewResult = {
   ok: true;
   state: BorrowState;
-} | SDKError<IntentValidationError>;
+} | SDKError<RefusedIntent<BorrowState>>;
 /**
  * Empty-account preview outcome: the thinnest of the three, since an account
  * that holds nothing has no state to project — only the market's own refusal
@@ -280,4 +280,4 @@ declare class CreditAccountOperationsService extends SDKConstruct {
   borrowIntent(props: BorrowProps): Promise<BorrowPreviewResult>;
 }
 //#endregion
-export { type AccountCalculatorOperation, type AddCollateralIntent, type AdjustLeverageIntent, BorrowPreviewResult, type BorrowProps, type BorrowState, type ClaimRemainder, CreditAccountOperationsService, type CreditAccountSlice, type DelayableIntent, type DelayedRoute, type DelayedStart, type DelayedStartResult, type DepositStrategyIntent, EmptyAccountPreviewResult, type ExecutionCost, type FinishIntentProps, type FinishIntentResult, type InstantRoute, type IntentPreviewResult, type IntentRoutesResult, type LeverageBand, OpenStrategyPreviewResult, type OpenStrategyProps, type OpenStrategyState, type OperationState, type PathLossRate, type RepayStrategyIntent, type ResumableIntent, type RouteErrors, type StartIntent, type WithdrawAssetIntent, type WithdrawCeilings, type WithdrawStrategyIntent, fetchCreditAccountSlice, isPhantomToken, toCreditAccountSlice };
+export { type AccountCalculatorOperation, type AddCollateralIntent, type AdjustLeverageIntent, BorrowPreviewResult, type BorrowProps, type BorrowState, type ClaimRemainder, CreditAccountOperationsService, type CreditAccountSlice, type DelayableIntent, type DelayedRoute, type DelayedStart, type DelayedStartResult, type DepositStrategyIntent, EmptyAccountPreviewResult, type ExecutionCost, type FinishIntentProps, type FinishIntentResult, type InstantRoute, type IntentPreviewResult, type IntentRoutesResult, type LeverageBand, OpenStrategyPreviewResult, type OpenStrategyProps, type OpenStrategyState, type OperationState, type PathLossRate, type RefusedIntent, type RepayStrategyIntent, type ResumableIntent, type RouteErrors, type StartIntent, type WithPartialState, type WithdrawAssetIntent, type WithdrawCeilings, type WithdrawStrategyIntent, fetchCreditAccountSlice, isPhantomToken, toCreditAccountSlice };

package/dist/types/onchain/accounts/intents/math.d.ts

@@ -28,17 +28,10 @@ declare function debtForLeverage(collateral: bigint, leverage: bigint): bigint;
  * it, so no rounding is introduced on the way.
  */
 declare function proportionalDebt(position: Position, collateralDelta: bigint): bigint;
-/**
- * Headroom on top of the debt read, in `PERCENTAGE_FACTOR`: enough interest for
- * the transaction to sit in the mempool for hours at any sane borrow rate,
- * small enough not to matter to the wallet that fronts it.
- */
-declare const SETTLE_MARGIN = 10n;
 /**
  * Largest withdrawal (in underlying) that {@link proportionalDebt} can still
  * pay for: the repayment it implies leaves debt at or above `minDebt` plus
- * {@link SETTLE_MARGIN} of the debt, so the figure survives the interest of the
- * blocks before it is sent, and
+ * {@link WITHDRAW_DEBT_MARGIN} of the debt, and
  * strictly less than the collateral goes — the last unit closes the account
  * rather than shrinks it. `0n` when the debt already sits below `minDebt`.
  *
@@ -53,4 +46,4 @@ declare function assertLeverageAtLeastOne(leverage: bigint): void;
  */
 declare function assertDebtLimits(sdk: OnchainSDK, debt: bigint, debtLimits: DebtLimits, underlying: Address): void;
 //#endregion
-export { DebtLimits, Position, SETTLE_MARGIN, assertDebtLimits, assertLeverageAtLeastOne, debtForLeverage, maxProportionalWithdrawal, proportionalDebt };
+export { DebtLimits, Position, assertDebtLimits, assertLeverageAtLeastOne, debtForLeverage, maxProportionalWithdrawal, proportionalDebt };

package/dist/types/onchain/accounts/intents/open-strategy.d.ts

@@ -32,6 +32,11 @@ interface OpenStrategyProps {
    * is what the `DEPOSIT` intent is for.
    **/
   creditAccount?: CreditAccountSlice;
+  /**
+   * Where the walk writes the state as it reaches it, see
+   * {@link StartIntentProps.draft}. Omitted by a walk nobody reports.
+   **/
+  draft?: Partial<OpenStrategyState>;
 }
 /**
  * Projected result of opening a brand-new leveraged position.

package/dist/types/onchain/accounts/intents/realize.d.ts

@@ -19,6 +19,11 @@ interface RealizeProps {
    * `createOraclePaths` instead.
    */
   paths?: RouterPaths;
+  /**
+   * Where the walk writes the state as it reaches it, see
+   * {@link StartIntentProps.draft}. Omitted by a walk nobody reports.
+   */
+  draft?: Partial<OperationState>;
 }
 interface Realized {
   operations: AccountCalculatorOperation[];

package/dist/types/onchain/accounts/intents/types.d.ts

@@ -86,16 +86,47 @@ interface OperationState extends AccountProjection, SimulationPrices {
    */
   executionCost: ExecutionCost | undefined;
 }
+/**
+ * What a refused request carries beside its own code: as much of the state
+ * the walk was building as it had reached when it was stopped.
+ *
+ * The same field under the same name as on the answer beside it, so a screen
+ * reads one shape whichever half it got — only here a field it could not
+ * arrive at is absent rather than present. What is there depends on how far
+ * the walk got: the market from the moment it is resolved, the totals from
+ * the moment the oracle has sized the margin and the debt, the whole
+ * projection from the moment the balances are settled, and `priceImpact` only
+ * from a walk that finished, since measuring depth is a quote of its own and
+ * is not paid for by a plan that was turned down.
+ *
+ * The totals are worth their own step because the flows that open an account
+ * weigh the debt before they route anything: a loan refused for its size is
+ * refused on arithmetic, and the arithmetic is reportable even though the
+ * position it would have bought is not.
+ *
+ * Absent is not zero and not "unchanged": a walk stopped mid-way says nothing
+ * about where the account would have landed, and a caller shows a blank rather
+ * than the account as it stands.
+ */
+interface WithPartialState<S> {
+  state: Partial<S>;
+}
+/**
+ * A flow that projects `S`, turned down by the engine: the code and its own
+ * numbers, with {@link WithPartialState.state} beside them.
+ */
+type RefusedIntent<S> = IntentValidationError & WithPartialState<S>;
 /**
  * What planning an intent yields: the operation chain, the state it projects,
- * and the calldata that realises it — or the error that stopped the plan.
+ * and the calldata that realises it — or the error that stopped the plan,
+ * carrying the part of that state the plan did reach.
  */
 type IntentPreviewResult = {
   ok: true;
   operations: AccountCalculatorOperation[];
   state: OperationState;
   calls: MultiCall[];
-} | SDKError<IntentValidationError>;
+} | SDKError<RefusedIntent<OperationState>>;
 /**
  * What a claim did not bring, when the venue served part of a matured
  * withdrawal and left the rest of it queued.
@@ -133,7 +164,7 @@ type FinishIntentResult = (Extract<IntentPreviewResult, {
    * {@link ClaimRemainder}.
    */
   remainder: ClaimRemainder | undefined;
-}) | SDKError<IntentValidationError>;
+}) | SDKError<RefusedIntent<OperationState>>;
 /** What the request recorded, and when the tail can be run. */
 interface DelayedStart {
   /**
@@ -196,7 +227,7 @@ type DelayedStartResult = {
   state: OperationState;
   calls: MultiCall[];
   delayed: DelayedStart;
-} | SDKError<IntentValidationError>;
+} | SDKError<RefusedIntent<OperationState>>;
 /** An intent previewed through the router: one transaction, settled now. */
 type InstantRoute = Extract<IntentPreviewResult, {
   ok: true;
@@ -234,7 +265,7 @@ type IntentRoutesResult = {
   instant: InstantRoute | undefined;
   delayed: DelayedRoute | undefined;
   errors: RouteErrors;
-} | (SDKError<IntentValidationError> & {
+} | (SDKError<RefusedIntent<OperationState>> & {
   /** {@inheritDoc IntentRoutesResult.errors} */
   errors: RouteErrors;
 });
@@ -264,6 +295,18 @@ type StartIntentProps = {
   quotaReserve: number | undefined;
   /** Router slippage in PERCENTAGE_FORMAT (100% = 10_000). */
   slippage: number | undefined;
+  /**
+   * Where the walk writes the state as it reaches it, so a caller stopped
+   * part-way is still told what was true up to that point, see
+   * {@link WithPartialState}.
+   *
+   * Filled in place rather than returned, because the two ways a walk ends
+   * badly leave by different doors: being refused is the error the engine
+   * answers with, a crash is the exception it lets through, and the caller holding
+   * this object reads the same draft either way. Omit it and the walk keeps
+   * no draft at all.
+   */
+  draft?: Partial<OperationState>;
 };
 /**
  * Intent 5 — put the position token straight onto the account.
@@ -515,4 +558,4 @@ type FinishIntentProps = StartIntentProps & {
   claimable: ClaimableWithdrawal;
 };
 //#endregion
-export { AddCollateralIntent, AdjustLeverageIntent, ClaimRemainder, CreditAccountSlice, DelayableIntent, DelayedRoute, DelayedStart, DelayedStartResult, DepositStrategyIntent, ExecutionCost, FinishIntentProps, FinishIntentResult, InstantRoute, IntentPreviewResult, IntentRoutesResult, OperationState, PathLossRate, RepayStrategyIntent, ResumableIntent, RouteErrors, SimulationPrices, StartIntent, StartIntentProps, WithdrawAssetIntent, WithdrawCeilings, WithdrawStrategyIntent };
+export { AddCollateralIntent, AdjustLeverageIntent, ClaimRemainder, CreditAccountSlice, DelayableIntent, DelayedRoute, DelayedStart, DelayedStartResult, DepositStrategyIntent, ExecutionCost, FinishIntentProps, FinishIntentResult, InstantRoute, IntentPreviewResult, IntentRoutesResult, OperationState, PathLossRate, RefusedIntent, RepayStrategyIntent, ResumableIntent, RouteErrors, SimulationPrices, StartIntent, StartIntentProps, WithPartialState, WithdrawAssetIntent, WithdrawCeilings, WithdrawStrategyIntent };