@gearbox-protocol/sdk 16.0.0-next.56 → 16.0.0-next.58

package/dist/esm/dev/withdrawalUtils.js

@@ -1,6 +1,6 @@
+import { iWithdrawalCompressorV313Abi } from "../abi/IWithdrawalCompressorV313.js";
 import { getNetworkType } from "../onchain/chain/chains.js";
 import { getWithdrawalCompressorAddress } from "../onchain/accounts/withdrawal-compressor/addresses.js";
-import { iWithdrawalCompressorV313Abi } from "../abi/IWithdrawalCompressorV313.js";
 import "../onchain/index.js";
 import { iMidasDataFeedAbi, iMidasRedemptionVaultAbi, midasGatewayAbi, midasRedeemerAbi, midasRedemptionVaultPhantomTokenAbi, securitizeRedeemerAbi, securitizeRedemptionGatewayAbi, securitizeRedemptionPhantomTokenAbi } from "./withdrawalAbi.js";
 import { erc20Abi, hexToString, parseAbi, parseEther } from "viem";

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";
@@ -204,7 +204,7 @@ var CreditAccountsServiceV310 = class extends 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, MAX_UINT256, to)] : [],
@@ -216,7 +216,7 @@ var CreditAccountsServiceV310 = class extends 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/esm/onchain/accounts/intents/open-strategy.js

@@ -6,7 +6,10 @@ import { getQuotasForUpdate } from "./utils/quotas-for-update.js";
 import { createRouterPaths } from "./utils/router-path.js";
 import "./utils/index.js";
 //#region src/onchain/accounts/intents/open-strategy.ts
-/** Stand-in account address: nothing exists on chain until the tx lands. */
+/**
+* Stand-in account address, used when the opening creates its own account:
+* nothing exists on chain until the tx lands.
+*/
 const NO_ACCOUNT = "0x0000000000000000000000000000000000000000";
 /**
 * Builds the state opening a leveraged position out of wallet collateral would
@@ -21,7 +24,8 @@ const NO_ACCOUNT = "0x0000000000000000000000000000000000000000";
 * `sdk.accounts.openCA`.
 */
 async function buildOpenStrategyState(props) {
-	const { sdk, creditManager, collateral, targetToken, leverage, slippage = 0, quotaReserve, leftoverBalances = [] } = props;
+	if (props.empty) return emptyOpenState(props);
+	const { sdk, creditManager, collateral, targetToken, leverage, slippage = 0, quotaReserve, leftoverBalances = [], creditAccount: existing } = props;
 	assertLeverageAtLeastOne(leverage);
 	const suite = sdk.marketRegister.findCreditManager(creditManager);
 	const market = sdk.marketRegister.findByCreditManager(creditManager);
@@ -31,7 +35,7 @@ async function buildOpenStrategyState(props) {
 	const margin = collateral.reduce((acc, a) => acc + convert(a.token, underlying, a.balance), 0n);
 	if (margin <= 0n) throw new IntentPreviewError("insufficientSourceBalance", void 0, "openStrategy: collateral is worth nothing in underlying");
 	const debt = debtForLeverage(margin, leverage);
-	const account = {
+	const account = existing ?? {
 		creditAccount: NO_ACCOUNT,
 		creditManager: creditManager.toLowerCase(),
 		creditFacade: suite.creditFacade.address.toLowerCase(),
@@ -100,7 +104,37 @@ async function buildOpenStrategyState(props) {
 		minAssets: minAssets.map(priced),
 		averageQuota,
 		minQuota,
-		calls: [...leg.calls]
+		calls: [...leg.calls],
+		creditAccount: existing?.creditAccount
+	};
+}
+/**
+* The opening that holds an account and nothing else.
+*
+* Taken before the walk rather than threaded through it: the router has no
+* guard for an empty basket and would still make its `eth_call`, and every
+* assertion below reads amounts that are not there.
+*/
+async function emptyOpenState(props) {
+	const { sdk, creditManager } = props;
+	assertMarketOperable(sdk.marketRegister.findCreditManager(creditManager));
+	const snapshot = {
+		creditManager,
+		assets: [],
+		quotas: [],
+		totalDebt: 0n,
+		totalValue: 0n
+	};
+	const { assets: _assets, quotas: _quotas, ...projection } = sdk.positions.projection(snapshot, { availableLiquidityChange: 0n });
+	return {
+		...projection,
+		currentPrice: sdk.positions.currentPrice(snapshot),
+		priceImpact: void 0,
+		averageAssets: [],
+		minAssets: [],
+		averageQuota: [],
+		minQuota: [],
+		calls: []
 	};
 }
 /** Collateral plus the borrowed underlying, folded into one balance per token. */

package/dist/esm/onchain/accounts/liquidations/LiquidationsService.js

@@ -1,3 +1,4 @@
+import { iLiquidationCompressorV313Abi } from "../../../abi/ILiquidationCompressorV313.js";
 import { AddressSet } from "../../utils/AddressSet.js";
 import { bytes32ToString } from "../../utils/bytes32ToString.js";
 import { ADDRESS_0X0 } from "../../constants/addresses.js";
@@ -19,7 +20,6 @@ import { SecuritizeLiquidatorContract } from "../../market/rwa/securitize/Securi
 import "../../market/rwa/securitize/index.js";
 import "../../market/index.js";
 import { LIQUIDATION_APPROVAL_BUFFER, LIQUIDATION_COMPRESSOR_V313_ADDRESS } from "./constants.js";
-import { iLiquidationCompressorV313Abi } from "../../../abi/ILiquidationCompressorV313.js";
 import { skipLiquidatableAccount } from "./skipLiquidatableAccount.js";
 //#region src/onchain/accounts/liquidations/LiquidationsService.ts
 /**

package/dist/esm/onchain/accounts/withdrawal-compressor/RedemptionLoggerV310Contract.js

@@ -1,9 +1,9 @@
+import { iRedemptionLoggerV310Abi } from "../../../abi/iRedemptionLoggerV310.js";
 import { BaseContract } from "../../base/BaseContract.js";
 import "../../base/index.js";
 import { sdkErr, sdkOk } from "../../../model/result.js";
 import "../../../model/index.js";
 import { decodeDelayedIntent } from "./intent-codec.js";
-import { iRedemptionLoggerV310Abi } from "../../../abi/iRedemptionLoggerV310.js";
 //#region src/onchain/accounts/withdrawal-compressor/RedemptionLoggerV310Contract.ts
 const abi = iRedemptionLoggerV310Abi;
 /**

package/dist/esm/onchain/accounts/withdrawal-compressor/WithdrawalCompressorV310Contract.js

@@ -1,5 +1,5 @@
-import { AbstractWithdrawalCompressorContract } from "./AbstractWithdrawalCompressorContract.js";
 import { iWithdrawalCompressorV310Abi } from "../../../abi/IWithdrawalCompressorV310.js";
+import { AbstractWithdrawalCompressorContract } from "./AbstractWithdrawalCompressorContract.js";
 //#region src/onchain/accounts/withdrawal-compressor/WithdrawalCompressorV310Contract.ts
 const abi = iWithdrawalCompressorV310Abi;
 /**

package/dist/esm/onchain/accounts/withdrawal-compressor/WithdrawalCompressorV311Contract.js

@@ -1,5 +1,5 @@
-import { AbstractWithdrawalCompressorContract } from "./AbstractWithdrawalCompressorContract.js";
 import { iWithdrawalCompressorV311Abi } from "../../../abi/IWithdrawalCompressorV311.js";
+import { AbstractWithdrawalCompressorContract } from "./AbstractWithdrawalCompressorContract.js";
 //#region src/onchain/accounts/withdrawal-compressor/WithdrawalCompressorV311Contract.ts
 const abi = iWithdrawalCompressorV311Abi;
 /**

package/dist/esm/onchain/accounts/withdrawal-compressor/WithdrawalCompressorV313Contract.js

@@ -1,6 +1,6 @@
+import { iWithdrawalCompressorV313Abi } from "../../../abi/IWithdrawalCompressorV313.js";
 import { encodeDelayedIntent } from "./intent-codec.js";
 import { AbstractWithdrawalCompressorContract, iCreditAccountAbi, toClaimableWithdrawal, toPendingWithdrawal, toRequestableWithdrawal } from "./AbstractWithdrawalCompressorContract.js";
-import { iWithdrawalCompressorV313Abi } from "../../../abi/IWithdrawalCompressorV313.js";
 import { toWithdrawalStatus } from "./types.js";
 //#region src/onchain/accounts/withdrawal-compressor/WithdrawalCompressorV313Contract.ts
 const abi = iWithdrawalCompressorV313Abi;

package/dist/esm/onchain/base/TokensMeta.js

@@ -1,12 +1,12 @@
+import { iExpirableAbi } from "../../abi/iExpirable.js";
+import { iStateSerializerAbi } from "../../abi/iStateSerializer.js";
+import { iVersionAbi } from "../../abi/iVersion.js";
 import { AddressMap } from "../utils/AddressMap.js";
 import { AddressSet } from "../utils/AddressSet.js";
 import { bytes32ToString } from "../utils/bytes32ToString.js";
 import { getAssetType } from "../chain/chains.js";
 import { formatBN } from "../utils/formatter.js";
 import "../utils/index.js";
-import { iExpirableAbi } from "../../abi/iExpirable.js";
-import { iStateSerializerAbi } from "../../abi/iStateSerializer.js";
-import { iVersionAbi } from "../../abi/iVersion.js";
 import { SdkRWADataNotLoadedError } from "../core/errors.js";
 import { executeMulticallBatches } from "../utils/viem/executeMulticallBatches.js";
 //#region src/onchain/base/TokensMeta.ts
@@ -54,7 +54,7 @@ var TokensMeta = class extends AddressMap {
 	* Returns the display symbol for a token.
 	*
 	* This is not always the on-chain ERC-20 `symbol()`: curated pretty names
-	* and redemption phantom tokens (`"source -> target"`) replace it.
+	* and redemption phantom tokens (`"target redemption from source"`) replace it.
 	*
 	* @param token - Token address.
 	* @throws If the token is not in the registry.
@@ -153,7 +153,7 @@ var TokensMeta = class extends AddressMap {
 	}
 	/**
 	* Rewrites display symbols of redemption phantom tokens to
-	* `"${source} -> ${target}"`.
+	* `"${target} redemption from ${source}"`.
 	*
 	* @param renames - Phantom / source / target address triples.
 	**/
@@ -163,7 +163,7 @@ var TokensMeta = class extends AddressMap {
 			if (!meta || !this.has(source) || !this.has(target)) continue;
 			this.upsert(phantom, {
 				...meta,
-				symbol: `${this.symbol(source)} -> ${this.symbol(target)}`
+				symbol: `${this.symbol(target)} redemption from ${this.symbol(source)}`
 			});
 		}
 	}

package/dist/esm/onchain/chain/chains.js

@@ -125,6 +125,13 @@ const chains = {
 			symbol: "USDC"
 		},
 		tokenPrettyNames: AddressMap.fromRecord({
+			"0xab7d50fc2486a1ac06516e2ece9dadc95ba8cd20": "wstETH redemption from cp0xLRT",
+			"0x6252467c2fefb61cb55180282943139baeea36c5": "wstETH redemption from rstETH",
+			"0xd412ca00d177eba2843348f9c50dd17bfce32c40": "wstETH redemption from pzETH",
+			"0x26c98674e623647f11909791593fa3b6e9406c67": "wstETH redemption from steak7LRT",
+			"0x9fb930eacadad079683a4758424a53b9b3692775": "wstETH redemption from Re7LRT",
+			"0xd7f1a4e3aba92a9d20987c752bd4a6cc759d7738": "rsETH redemption from hgETH",
+			"0xc71219dca5a671aa6268ab8fb35e570bd72f372b": "iUSD redemption from liUSD-1w",
 			"0x924d24c238db7ecae2aa3a19430239ed684bde4a": "Beefy WBTC/cbBTC/hemiBTC",
 			"0x403cc0d2694ec2639101f32b146b90d766461ce9": "Beefy wstETH/tETH",
 			"0x02a4cceed3c400b5ba9fd22ad6ec18d8f7a3d48e": "Beefy ETH+/WETH",

package/dist/esm/onchain/core/createAddressProvider.js

@@ -1,8 +1,8 @@
+import { iVersionAbi } from "../../abi/iVersion.js";
 import { AP_MARKET_COMPRESSOR, AP_PRICE_FEED_COMPRESSOR } from "../constants/address-provider.js";
 import { isV310 } from "../constants/versions.js";
 import "../constants/index.js";
 import { hexEq } from "../utils/hex.js";
-import { iVersionAbi } from "../../abi/iVersion.js";
 import { AddressProviderV310Contract } from "./AddressProviderV310Contract.js";
 //#region src/onchain/core/createAddressProvider.ts
 const OVERRIDE_ADDRESSES = { Mainnet: {

package/dist/esm/onchain/market/adapters/contracts/AccountMigratorAdapterContract.js

@@ -1,5 +1,5 @@
-import { AbstractAdapterContract } from "./AbstractAdapter.js";
 import { accountMigratorAbi } from "../../../../abi/AccountMigrator.js";
+import { AbstractAdapterContract } from "./AbstractAdapter.js";
 //#region src/onchain/market/adapters/contracts/AccountMigratorAdapterContract.ts
 const abi = accountMigratorAbi;
 const protocolAbi = accountMigratorAbi;

package/dist/esm/onchain/market/adapters/contracts/ERC4626AdapterContract.js

@@ -1,6 +1,6 @@
+import { ierc4626AdapterAbi } from "../../../../abi/ierc4626Adapter.js";
 import { MissingSerializedParamsError } from "../../../base/errors.js";
 import "../../../base/index.js";
-import { ierc4626AdapterAbi } from "../../../../abi/ierc4626Adapter.js";
 import { iERC4626Abi } from "../abi/targetContractAbi.js";
 import { fnSigToName, swapFromTransfers } from "../transferHelpers.js";
 import { AbstractAdapterContract } from "./AbstractAdapter.js";

package/dist/esm/onchain/market/credit/CreditFacadeV310BaseContract.js

@@ -1,7 +1,7 @@
+import { iPausableAbi } from "../../../abi/iPausable.js";
 import { iCreditFacadeMulticallV310Abi, iCreditFacadeV310Abi } from "../../../abi/310/generated.js";
 import { BaseContract } from "../../base/BaseContract.js";
 import "../../base/index.js";
-import { iPausableAbi } from "../../../abi/iPausable.js";
 //#region src/onchain/market/credit/CreditFacadeV310BaseContract.ts
 const abi = [
 	...iCreditFacadeV310Abi,

package/dist/esm/onchain/market/pool/PoolV310Contract.js

@@ -1,3 +1,4 @@
+import { iPausableAbi } from "../../../abi/iPausable.js";
 import { iPoolV310Abi } from "../../../abi/310/generated.js";
 import { AddressMap } from "../../utils/AddressMap.js";
 import { RAY } from "../../constants/math.js";
@@ -7,7 +8,6 @@ import "../../utils/index.js";
 import { SdkRWADataNotLoadedError } from "../../core/errors.js";
 import { BaseContract } from "../../base/BaseContract.js";
 import "../../base/index.js";
-import { iPausableAbi } from "../../../abi/iPausable.js";
 //#region src/onchain/market/pool/PoolV310Contract.ts
 const abi = [...iPoolV310Abi, ...iPausableAbi];
 var PoolV310Contract = class extends BaseContract {

package/dist/esm/onchain/market/strategyName.js

@@ -4,7 +4,7 @@
 * borrowed underlying, e.g. `"wstETH / WETH"`.
 *
 * Uses each token's display {@link Token.symbol}, which may already be a
-* curated pretty name or a `"source -> target"` redemption rewrite.
+* curated pretty name or a `"target redemption from source"` redemption rewrite.
 *
 * @param target - Collateral the position is built around.
 * @param underlying - Token the position borrows.

package/dist/esm/onchain/market/zapper/IETHZapperContract.js

@@ -1,5 +1,5 @@
-import { ZapperContract } from "./ZapperContract.js";
 import { iethZapperAbi } from "../../../abi/iETHZapper.js";
+import { ZapperContract } from "./ZapperContract.js";
 //#region src/onchain/market/zapper/IETHZapperContract.ts
 const abi = iethZapperAbi;
 var IETHZapperContract = class extends ZapperContract {

package/dist/esm/onchain/market/zapper/ZapperContract.js

@@ -1,8 +1,8 @@
+import { iZapperAbi } from "../../../abi/iZapper.js";
 import { BaseContract } from "../../base/BaseContract.js";
 import "../../base/index.js";
 import { sdkErr, sdkOk } from "../../../model/result.js";
 import "../../../model/index.js";
-import { iZapperAbi } from "../../../abi/iZapper.js";
 //#region src/onchain/market/zapper/ZapperContract.ts
 /**
 * Base contract for every Gearbox zapper. Specialized zappers (e.g.

package/dist/esm/onchain/utils/viem/simulateWithPriceUpdates.js

@@ -1,6 +1,6 @@
 import { errorAbis } from "../../../abi/errors.js";
-import { generateCastTraceCall } from "./cast.js";
 import { iUpdatablePriceFeedAbi } from "../../../abi/iUpdatablePriceFeed.js";
+import { generateCastTraceCall } from "./cast.js";
 import { simulateMulticall } from "./simulateMulticall.js";
 import { BaseError, CallExecutionError, ContractFunctionRevertedError, decodeFunctionData, decodeFunctionResult, encodeFunctionData, parseAbi } from "viem";
 import { getAction, parseAccount } from "viem/utils";

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

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

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

@@ -1,5 +1,5 @@
-import { iCreditFacadeV310Abi } from "../../abi/310/generated.js";
 import { ierc20Abi } from "../../abi/iERC20.js";
+import { iCreditFacadeV310Abi } from "../../abi/310/generated.js";
 import { AddressMap } from "../../onchain/utils/AddressMap.js";
 import "../../onchain/index.js";
 import { UnexpectedFacadeEventOrderError } from "./errors.js";

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

@@ -59,6 +59,7 @@ async function openTx(sdk, request) {
 		calls: state.calls,
 		averageQuota: state.averageQuota,
 		minQuota: state.minQuota,
+		reopenCreditAccount: state.creditAccount,
 		permits: {},
 		referralCode: 0n,
 		rwaOptions: await openRwaOptions(sdk, request)

package/dist/esm/sdk/index.js

@@ -14,7 +14,7 @@ import { LiquidationsNamespace } from "./liquidations/LiquidationsNamespace.js";
 import "./liquidations/index.js";
 import { ExecuteApi } from "./execute/ExecuteApi.js";
 import "./execute/index.js";
-import { creditAccountNotFound, noStrategyTargetCollateral, toRefusalError, unexpectedFailure } from "./prepare/errors.js";
+import { creditAccountNotEmpty, creditAccountNotFound, emptyOpenTakesNothing, noStrategyTargetCollateral, toRefusalError, unexpectedFailure } from "./prepare/errors.js";
 import { PrepareApi } from "./prepare/PrepareApi.js";
 import "./prepare/index.js";
 import { filterResponse } from "./utils/filterResponse.js";
@@ -28,4 +28,4 @@ import { PreviewNamespace } from "./preview/PreviewNamespace.js";
 import "./preview/index.js";
 import { DEFAULT_MAX_STATE_AGE, GearboxSDK } from "./GearboxSDK.js";
 import "./types.js";
-export { AbstractNamespace, AllSourcesFailedError, AnalyticsNamespace, DEFAULT_MAX_OFFCHAIN_LAG, DEFAULT_MAX_STATE_AGE, ExecuteApi, GearboxSDK, IntentPreviewError, LiquidationsNamespace, MissingSourceError, NoSourceServedError, OpportunitiesNamespace, PositionsNamespace, PrepareApi, PreviewNamespace, SourceChainMismatchError, SourceUnavailableError, assertSameChains, creditAccountNotFound, everyChainFailed, filterResponse, mergeChainList, mergeChainOne, noStrategyTargetCollateral, raise, refuse, toRefusalError, unexpectedFailure };
+export { AbstractNamespace, AllSourcesFailedError, AnalyticsNamespace, DEFAULT_MAX_OFFCHAIN_LAG, DEFAULT_MAX_STATE_AGE, ExecuteApi, GearboxSDK, IntentPreviewError, LiquidationsNamespace, MissingSourceError, NoSourceServedError, OpportunitiesNamespace, PositionsNamespace, PrepareApi, PreviewNamespace, SourceChainMismatchError, SourceUnavailableError, assertSameChains, creditAccountNotEmpty, creditAccountNotFound, emptyOpenTakesNothing, everyChainFailed, filterResponse, mergeChainList, mergeChainOne, noStrategyTargetCollateral, raise, refuse, toRefusalError, unexpectedFailure };

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

@@ -6,8 +6,9 @@ import { toToken } from "../../onchain/validation/token.js";
 import { toCreditAccountSlice } from "../../onchain/accounts/intents/utils/credit-account-slice.js";
 import { CreditAccountOperationsService } from "../../onchain/accounts/intents/index.js";
 import "../../onchain/index.js";
-import { creditAccountNotFound, noStrategyTargetCollateral, toRefusalError, unexpectedFailure } from "./errors.js";
+import { creditAccountNotEmpty, creditAccountNotFound, emptyOpenTakesNothing, noStrategyTargetCollateral, toRefusalError, unexpectedFailure } from "./errors.js";
 import { withdrawableCollaterals } from "./withdrawable-collaterals.js";
+import { isAddressEqual } from "viem";
 //#region src/sdk/prepare/PrepareApi.ts
 /**
 * {@inheritDoc IOpportunitiesPrepare}
@@ -181,8 +182,23 @@ var PrepareApi = class extends MultichainConstruct {
 		try {
 			const sdk = await this.#chain(strategy.chainId);
 			const at = stateBlock(sdk);
+			if (params.empty) {
+				if (params.collateral.length > 0 || params.creditAccount || params.leverage !== 0n) return sdkErr(emptyOpenTakesNothing());
+				return opened(await service(sdk).openStrategyIntent({
+					sdk,
+					creditManager: strategy.creditManager,
+					empty: true
+				}), at);
+			}
 			const targetToken = params.targetToken ?? sdk.marketRegister.findCreditManager(strategy.creditManager).strategyTargetCollateral;
 			if (!targetToken) return sdkErr(noStrategyTargetCollateral(strategy.creditManager));
+			let creditAccount;
+			if (params.creditAccount) {
+				const reused = await slice(sdk, params.creditAccount);
+				if (!reused || !isAddressEqual(reused.creditManager, strategy.creditManager)) return sdkErr(creditAccountNotFound(params.creditAccount));
+				if (reused.totalDebt > 0n || reused.tokens.some((t) => t.quota > 0n)) return sdkErr(creditAccountNotEmpty(params.creditAccount));
+				creditAccount = reused;
+			}
 			return opened(await service(sdk).openStrategyIntent({
 				sdk,
 				creditManager: strategy.creditManager,
@@ -191,7 +207,8 @@ var PrepareApi = class extends MultichainConstruct {
 				leverage: params.leverage,
 				leftoverBalances: params.leftoverBalances,
 				slippage: params.slippage,
-				quotaReserve: params.quotaReserve
+				quotaReserve: params.quotaReserve,
+				creditAccount
 			}), at);
 		} catch (e) {
 			return sdkErr(unexpectedFailure(e));

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

@@ -62,6 +62,16 @@ function noStrategyTargetCollateral(creditManager) {
 	};
 }
 /**
+* {@inheritDoc CreditAccountNotEmptyError}
+**/
+function creditAccountNotEmpty(creditAccount) {
+	return {
+		code: "creditAccountNotEmpty",
+		message: `Credit account ${creditAccount} carries debt or quotas.`,
+		creditAccount
+	};
+}
+/**
 * {@inheritDoc CreditAccountNotFoundError}
 **/
 function creditAccountNotFound(creditAccount) {
@@ -72,6 +82,15 @@ function creditAccountNotFound(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
@@ -86,4 +105,4 @@ function unexpectedFailure(thrown) {
 	};
 }
 //#endregion
-export { creditAccountNotFound, noStrategyTargetCollateral, toRefusalError, unexpectedFailure };
+export { creditAccountNotEmpty, creditAccountNotFound, emptyOpenTakesNothing, noStrategyTargetCollateral, toRefusalError, unexpectedFailure };

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

@@ -1,5 +1,5 @@
 import { IntentPreviewError, raise, refuse } from "../../onchain/validation/refusal.js";
-import { creditAccountNotFound, noStrategyTargetCollateral, toRefusalError, unexpectedFailure } from "./errors.js";
+import { creditAccountNotEmpty, creditAccountNotFound, emptyOpenTakesNothing, noStrategyTargetCollateral, toRefusalError, unexpectedFailure } from "./errors.js";
 import { PrepareApi } from "./PrepareApi.js";
 import "./types.js";
-export { IntentPreviewError, PrepareApi, creditAccountNotFound, noStrategyTargetCollateral, raise, refuse, toRefusalError, unexpectedFailure };
+export { IntentPreviewError, PrepareApi, creditAccountNotEmpty, creditAccountNotFound, emptyOpenTakesNothing, noStrategyTargetCollateral, raise, refuse, toRefusalError, unexpectedFailure };

package/dist/types/dev/abi.d.ts

@@ -38,11 +38,11 @@ declare const iDegenNftv2Abi: readonly [{
   }];
   readonly outputs: readonly [];
 }];
-declare const faucetAbi: readonly [{
+declare const iFaucetAbi: readonly [{
   readonly type: "function";
   readonly name: "assets";
   readonly inputs: readonly [{
-    readonly name: "";
+    readonly name: "index";
     readonly type: "uint256";
     readonly internalType: "uint256";
   }];
@@ -87,6 +87,92 @@ declare const faucetAbi: readonly [{
   }];
   readonly outputs: readonly [];
   readonly stateMutability: "nonpayable";
+}, {
+  readonly type: "function";
+  readonly name: "claimOnBehalfOf";
+  readonly inputs: readonly [{
+    readonly name: "receiver";
+    readonly type: "address";
+    readonly internalType: "address";
+  }, {
+    readonly name: "claims";
+    readonly type: "tuple[]";
+    readonly internalType: "struct TokenClaim[]";
+    readonly components: readonly [{
+      readonly name: "token";
+      readonly type: "address";
+      readonly internalType: "address";
+    }, {
+      readonly name: "amount";
+      readonly type: "uint256";
+      readonly internalType: "uint256";
+    }];
+  }];
+  readonly outputs: readonly [{
+    readonly name: "";
+    readonly type: "bool";
+    readonly internalType: "bool";
+  }];
+  readonly stateMutability: "nonpayable";
+}, {
+  readonly type: "function";
+  readonly name: "claimOnBehalfOf";
+  readonly inputs: readonly [{
+    readonly name: "receiver";
+    readonly type: "address";
+    readonly internalType: "address";
+  }, {
+    readonly name: "amountUSD";
+    readonly type: "uint256";
+    readonly internalType: "uint256";
+  }];
+  readonly outputs: readonly [{
+    readonly name: "";
+    readonly type: "bool";
+    readonly internalType: "bool";
+  }];
+  readonly stateMutability: "nonpayable";
+}, {
+  readonly type: "function";
+  readonly name: "claimOnBehalfOf";
+  readonly inputs: readonly [{
+    readonly name: "receiver";
+    readonly type: "address";
+    readonly internalType: "address";
+  }];
+  readonly outputs: readonly [{
+    readonly name: "";
+    readonly type: "bool";
+    readonly internalType: "bool";
+  }];
+  readonly stateMutability: "nonpayable";
+}, {
+  readonly type: "function";
+  readonly name: "configure";
+  readonly inputs: readonly [{
+    readonly name: "minAmountUSD";
+    readonly type: "uint256";
+    readonly internalType: "uint256";
+  }, {
+    readonly name: "tokens";
+    readonly type: "tuple[]";
+    readonly internalType: "struct FaucetToken[]";
+    readonly components: readonly [{
+      readonly name: "token";
+      readonly type: "address";
+      readonly internalType: "address";
+    }, {
+      readonly name: "price";
+      readonly type: "uint256";
+      readonly internalType: "uint256";
+    }, {
+      readonly name: "decimals";
+      readonly type: "uint8";
+      readonly internalType: "uint8";
+    }];
+  }];
+  readonly outputs: readonly [];
+  readonly stateMutability: "nonpayable";
 }, {
   readonly type: "function";
   readonly name: "getAssets";
@@ -121,21 +207,11 @@ declare const faucetAbi: readonly [{
     readonly internalType: "uint256";
   }];
   readonly stateMutability: "view";
-}, {
-  readonly type: "function";
-  readonly name: "owner";
-  readonly inputs: readonly [];
-  readonly outputs: readonly [{
-    readonly name: "";
-    readonly type: "address";
-    readonly internalType: "address";
-  }];
-  readonly stateMutability: "view";
 }, {
   readonly type: "function";
   readonly name: "prices";
   readonly inputs: readonly [{
-    readonly name: "";
+    readonly name: "token";
     readonly type: "address";
     readonly internalType: "address";
   }];
@@ -149,7 +225,7 @@ declare const faucetAbi: readonly [{
   readonly type: "function";
   readonly name: "scales";
   readonly inputs: readonly [{
-    readonly name: "";
+    readonly name: "token";
     readonly type: "address";
     readonly internalType: "address";
   }];
@@ -218,4 +294,4 @@ declare const iOnchainExecutionIdAbi: readonly [{
   readonly stateMutability: "view";
 }];
 //#endregion
-export { faucetAbi, iDegenNftv2Abi, iOnchainExecutionIdAbi, iOwnableAbi, iaclTraitAbi };
+export { iDegenNftv2Abi, iFaucetAbi, iOnchainExecutionIdAbi, iOwnableAbi, iaclTraitAbi };

package/dist/types/dev/index.d.ts

@@ -2,7 +2,7 @@ import { AccountOpener, AccountOpenerOptions, OpenAccountHumanizedPreview, OpenA
 import { RpcErrorResult, RpcResponse, RpcSuccessResult } from "./types.js";
 import { CheckMulticallFn, DetectedCall, EthCallMethod, EthCallRequest, EthCallSpy } from "./EthCallSpy.js";
 import { NoAvailableTransportsError, ProviderConfig, ProviderStatus, RevolverTransport, RevolverTransportConfig, RevolverTransportValue, SelectionStrategy, providerConfigSchema, revolverTransportConfigBaseSchema, revolverTransportConfigSchema } from "./RevolverTransport.js";
-import { faucetAbi, iDegenNftv2Abi, iOnchainExecutionIdAbi, iOwnableAbi, iaclTraitAbi } from "./abi.js";
+import { iDegenNftv2Abi, iFaucetAbi, iOnchainExecutionIdAbi, iOwnableAbi, iaclTraitAbi } from "./abi.js";
 import { calcLiquidatableLTs } from "./calcLiquidatableLTs.js";
 import { claimFromFaucet } from "./claimFromFaucet.js";
 import { Create2Deployer, Create2Parameters, DEFAULT_CREATE2_SALT, EnsureExistsUsingPublicCreate2ReturnType, GetCreate2AddressParameters, PUBLIC_CREATE2_FACTORY, deployUsingPublicCreate2, getPublicCreate2Address, isDeployedUsingPublicCreate2 } from "./create2.js";
@@ -26,4 +26,4 @@ import { EnableDSTokenBackDatingProps, RestoreDSTokenBackDating, claimDSToken, c
 import { httpTransportOptionsSchema } from "./transports.js";
 import { ONCHAIN_EXECUTION_ID_ADDRESS, VerifyTestnetParams, verifyTestnet } from "./verifyTestnet.js";
 import { MakePendingWithdrawalsClaimableOptions, makePendingWithdrawalsClaimable } from "./withdrawalUtils.js";
-export { AccountOpener, AccountOpenerOptions, AnvilActions, AnvilClient, AnvilClientConfig, AnvilDealParameters, AnvilNodeInfo, AnvilRPCSchema, CheckMulticallFn, Create2Deployer, Create2Parameters, DEFAULT_CREATE2_SALT, DetectedCall, EnableDSTokenBackDatingProps, EnsureExistsUsingPublicCreate2ReturnType, EthCallMethod, EthCallRequest, EthCallSpy, GetCreate2AddressParameters, GreenlistMidasGatewayProps, IMinter, type LogSplitterTransportOptions, MakePendingWithdrawalsClaimableOptions, NoAvailableTransportsError, ONCHAIN_EXECUTION_ID_ADDRESS, OpenAccountHumanizedPreview, OpenAccountResult, OpenAccountsResult, OpenTxRevertedError, PUBLIC_CREATE2_FACTORY, PoolDepositResult, ProviderConfig, ProviderStatus, RWAKycFailure, RegisterMidasInvestorProps, RegisterRWAInvestorProps, RegisterRWAInvestorResult, RegisterSecuritizeInvestorProps, ReplaceStorageParams, ResilientTransportOptions, RestoreDSTokenBackDating, RestoreMidasIssuanceVaultPause, RevolverTransport, RevolverTransportConfig, RevolverTransportValue, RpcErrorResult, RpcProvider, RpcResponse, RpcSuccessResult, SUPPORTED_RPC_PROVIDERS, SelectionStrategy, TargetAccount, UnpauseMidasIssuanceVaultProps, VerifyTestnetParams, anvilNodeInfo, calcLiquidatableLTs, claimDSToken, claimDSTokens, claimFromFaucet, createAnvilClient, createMinter, deployUsingPublicCreate2, detectChain, enableDSTokenBackDating, evmMineDetailed, extendAnvilClient, faucetAbi, getAlchemyUrl, getAnkrUrl, getDrpcUrl, getErpcKey, getPublicCreate2Address, getRpcProviderUrl, getThirdWebUrl, greenlistMidasGateway, httpTransportOptionsSchema, iDegenNftv2Abi, iOnchainExecutionIdAbi, iOwnableAbi, iaclTraitAbi, isAnvil, isDeployedUsingPublicCreate2, isOutOfSyncError, isRangeError, isRateLimitError, isTransientError, logSplitterTransport, makePendingWithdrawalsClaimable, migrateFaucet, providerConfigSchema, registerMidasInvestor, registerRWAInvestor, registerSecuritizeInvestor, replaceStorage, resilientTransport, resilientTransportOptionsSchema, revolverTransportConfigBaseSchema, revolverTransportConfigSchema, rpcProvidersSchema, setLTZero, setLTs, unpauseMidasIssuanceVault, verifyTestnet, writeAndWait };
+export { AccountOpener, AccountOpenerOptions, AnvilActions, AnvilClient, AnvilClientConfig, AnvilDealParameters, AnvilNodeInfo, AnvilRPCSchema, CheckMulticallFn, Create2Deployer, Create2Parameters, DEFAULT_CREATE2_SALT, DetectedCall, EnableDSTokenBackDatingProps, EnsureExistsUsingPublicCreate2ReturnType, EthCallMethod, EthCallRequest, EthCallSpy, GetCreate2AddressParameters, GreenlistMidasGatewayProps, IMinter, type LogSplitterTransportOptions, MakePendingWithdrawalsClaimableOptions, NoAvailableTransportsError, ONCHAIN_EXECUTION_ID_ADDRESS, OpenAccountHumanizedPreview, OpenAccountResult, OpenAccountsResult, OpenTxRevertedError, PUBLIC_CREATE2_FACTORY, PoolDepositResult, ProviderConfig, ProviderStatus, RWAKycFailure, RegisterMidasInvestorProps, RegisterRWAInvestorProps, RegisterRWAInvestorResult, RegisterSecuritizeInvestorProps, ReplaceStorageParams, ResilientTransportOptions, RestoreDSTokenBackDating, RestoreMidasIssuanceVaultPause, RevolverTransport, RevolverTransportConfig, RevolverTransportValue, RpcErrorResult, RpcProvider, RpcResponse, RpcSuccessResult, SUPPORTED_RPC_PROVIDERS, SelectionStrategy, TargetAccount, UnpauseMidasIssuanceVaultProps, VerifyTestnetParams, anvilNodeInfo, calcLiquidatableLTs, claimDSToken, claimDSTokens, claimFromFaucet, createAnvilClient, createMinter, deployUsingPublicCreate2, detectChain, enableDSTokenBackDating, evmMineDetailed, extendAnvilClient, getAlchemyUrl, getAnkrUrl, getDrpcUrl, getErpcKey, getPublicCreate2Address, getRpcProviderUrl, getThirdWebUrl, greenlistMidasGateway, httpTransportOptionsSchema, iDegenNftv2Abi, iFaucetAbi, iOnchainExecutionIdAbi, iOwnableAbi, iaclTraitAbi, isAnvil, isDeployedUsingPublicCreate2, isOutOfSyncError, isRangeError, isRateLimitError, isTransientError, logSplitterTransport, makePendingWithdrawalsClaimable, migrateFaucet, providerConfigSchema, registerMidasInvestor, registerRWAInvestor, registerSecuritizeInvestor, replaceStorage, resilientTransport, resilientTransportOptionsSchema, revolverTransportConfigBaseSchema, revolverTransportConfigSchema, rpcProvidersSchema, setLTZero, setLTs, unpauseMidasIssuanceVault, verifyTestnet, writeAndWait };

package/dist/types/model/primitives.d.ts

@@ -129,7 +129,7 @@ interface Token {
    * Ticker symbol.
    *
    * Display ticker, not necessarily the on-chain ERC-20 `symbol()`. The SDK
-   * may rewrite it (curated pretty names, `"source -> target"` for redemption
+   * may rewrite it (curated pretty names, `"target redemption from source"` for redemption
    * phantom tokens).
    *
    * @example `"USDC"`