@gearbox-protocol/sdk 16.0.0-next.9 → 16.1.0

package/dist/esm/preview/validate/checkOperation.js

@@ -0,0 +1,183 @@
+import { checkBorrowLimit, checkCollateralised, checkCreditManagerPaused, checkDebtInBand, checkForbiddenToken, checkFunding, checkMarketExpired, checkPoolPaused, checkPoolPayout, checkPoolSunset, checkPreviewError, checkQuotaCount, checkQuotaLimit } from "../../onchain/validation/checks.js";
+import { toToken } from "../../onchain/validation/token.js";
+import { borrowable } from "../../onchain/accounts/intents/guards.js";
+import "../../onchain/index.js";
+import { isAddressEqual } from "viem";
+//#region src/preview/validate/checkOperation.ts
+/**
+* Whether a parsed operation may be signed at all — the protocol state that
+* `checkPrerequisites` leaves out, since that one covers only what the sender
+* can fix themselves.
+*
+* Synchronous: the preview carries the numbers and the market is attached.
+* Reports the most fundamental issue it finds and stops there, which is the one
+* a caller acts on.
+*/
+function checkOperation(input, options = {}) {
+	const { sdk, preview } = input;
+	const malformed = checkPreviewError("warning" in preview ? preview.warning : void 0);
+	if (malformed) return malformed;
+	switch (preview.operation) {
+		case "Deposit":
+		case "Mint": return poolIssues(sdk, preview, options, true);
+		case "Withdraw":
+		case "Redeem": return poolIssues(sdk, preview, options, false);
+		case "DelayedCreditAccountOperation": return checkOperation({
+			sdk,
+			preview: preview.instantPreview
+		}, options);
+		case "OpenCreditAccount":
+		case "RWAOpenCreditAccount":
+		case "AdjustCreditAccount": return creditIssues(sdk, preview, options);
+		case "CloseCreditAccount":
+		case "RepayCreditAccount": return marketIssues(sdk.marketRegister.findCreditManager(preview.creditManager));
+	}
+}
+function poolIssues(sdk, preview, options, isDeposit) {
+	const market = sdk.marketRegister.findByPool(preview.pool);
+	return checkPoolPaused({
+		isPaused: market.pool.pool.isPaused,
+		pool: preview.pool
+	}) || checkPoolSunset({
+		isSunset: market.sunset,
+		isDeposit,
+		pool: preview.pool
+	}) || (isDeposit ? null : checkPoolPayout({
+		requested: preview.tokenOut.value,
+		available: market.pool.pool.availableLiquidity,
+		underlying: preview.tokenOut.token
+	})) || fundingIssue(options, [preview.tokenIn]);
+}
+/** What the market itself refuses, whatever the operation does. */
+function marketIssues(suite) {
+	const creditManager = suite.creditManager.address;
+	return checkCreditManagerPaused({
+		isPaused: suite.isPaused,
+		creditManager
+	}) || checkMarketExpired({
+		isExpired: suite.isExpired,
+		creditManager,
+		expirationDate: suite.creditFacade.expirationDate
+	});
+}
+function creditIssues(sdk, preview, options) {
+	const suite = sdk.marketRegister.findCreditManager(preview.creditManager);
+	const market = suite.market;
+	const underlying = toToken(sdk, market.pool.underlying);
+	const isOpening = preview.operation === "OpenCreditAccount" || preview.operation === "RWAOpenCreditAccount";
+	return marketIssues(suite) || checkDebtInBand({
+		debt: preview.totalDebt.value,
+		minDebt: suite.creditFacade.minDebt,
+		maxDebt: suite.creditFacade.maxDebt,
+		underlying,
+		allowZero: !isOpening
+	}) || borrowIssue(suite, preview, underlying) || forbiddenIssue(suite, preview) || quotaCountIssue(suite, preview) || quotaIssue(market, preview, underlying) || collateralIssue({
+		totalDebt: preview.totalDebt,
+		healthFactor: preview.estHealthFactor,
+		safeHealthFactor: preview.estSafeHealthFactor
+	}, options) || fundingIssue(options, preview.collateralAdded);
+}
+/**
+* A bar that reads nothing but the projected account, so a parsed transaction
+* and a simulated one are held to it by the same code.
+*
+* These stay separate functions rather than one block because the order the
+* checks run in is the answer: `checkOperation` interleaves the checks that
+* need an operation's *delta* between them, and the caller acts on the first
+* issue reported.
+*/
+function quotaCountIssue(suite, account) {
+	return checkQuotaCount({
+		count: account.quotas.filter((q) => q.value > 0n).length,
+		max: suite.creditManager.maxEnabledTokens
+	});
+}
+/**
+* What the transaction draws, against what the market can lend right now.
+*
+* Only a draw is weighed: repaying, or leaving the debt alone, can never exceed
+* a ceiling. Opening borrows the whole debt; adjusting borrows
+* `totalDebtChange`.
+*
+* The engine holds every simulation to this already (`assertCanBorrow`), so
+* this is here for the transactions it never saw — a pasted calldata reaches
+* the confirm screen with nothing else standing between it and a revert.
+*/
+function borrowIssue(suite, preview, underlying) {
+	const drawn = preview.operation === "AdjustCreditAccount" ? preview.totalDebtChange.value : preview.totalDebt.value;
+	if (drawn <= 0n) return null;
+	const { limit, binding } = borrowable(suite);
+	return checkBorrowLimit({
+		requested: drawn,
+		available: limit,
+		binding,
+		underlying
+	});
+}
+/**
+* The account against whichever bars the caller holds it to.
+*
+* A loan-free account is nothing to weigh: the health factor reports its
+* zero-debt sentinel and no bar applies.
+*
+* {@inheritDoc quotaCountIssue}
+*/
+function collateralIssue(account, options) {
+	const { minHealthFactor, minSafeHealthFactor, currentHealthFactor } = options;
+	if (account.totalDebt.value === 0n) return null;
+	return (minHealthFactor === void 0 ? null : checkCollateralised({
+		healthFactor: account.healthFactor,
+		required: minHealthFactor,
+		safePrices: false,
+		improvesFrom: currentHealthFactor
+	})) || (minSafeHealthFactor === void 0 ? null : checkCollateralised({
+		healthFactor: account.safeHealthFactor,
+		required: minSafeHealthFactor,
+		safePrices: true
+	}));
+}
+/** The wallet's side of the operation, against the balances it was given. */
+function fundingIssue(options, puts) {
+	const { balances } = options;
+	if (!balances) return null;
+	for (const { token, value } of puts) {
+		const issue = checkFunding({
+			token,
+			required: value,
+			held: balances.get(token.address) ?? 0n
+		});
+		if (issue) return issue;
+	}
+	return null;
+}
+function forbiddenIssue(suite, preview) {
+	const obtained = preview.operation === "AdjustCreditAccount" ? preview.assetsChange : preview.estAssets;
+	const forbidden = suite.forbiddenTokens;
+	for (const asset of obtained) {
+		if (asset.value <= 0n) continue;
+		const issue = checkForbiddenToken({
+			token: asset.token,
+			isForbidden: forbidden.some((f) => isAddressEqual(f, asset.token.address))
+		});
+		if (issue) return issue;
+	}
+	return null;
+}
+function quotaIssue(market, preview, underlying) {
+	const increases = preview.operation === "AdjustCreditAccount" ? preview.quotasChange : preview.quotas;
+	const { pqk } = market.pool;
+	for (const q of increases) {
+		if (q.value <= 0n) continue;
+		const quota = pqk.hasActiveQuota(q.token.address) ? pqk.quotas.get(q.token.address) : void 0;
+		const issue = checkQuotaLimit({
+			token: q.token,
+			requested: quota ? q.value : void 0,
+			available: (quota?.limit ?? 0n) - (quota?.totalQuoted ?? 0n),
+			underlying
+		});
+		if (issue) return issue;
+	}
+	return null;
+}
+//#endregion
+export { checkOperation, collateralIssue, marketIssues, quotaCountIssue };

package/dist/esm/preview/validate/checkSimulation.js

@@ -0,0 +1,38 @@
+import { checkDebtInBand } from "../../onchain/validation/checks.js";
+import { toToken } from "../../onchain/validation/token.js";
+import "../../onchain/index.js";
+import { collateralIssue, marketIssues, quotaCountIssue } from "./checkOperation.js";
+//#region src/preview/validate/checkSimulation.ts
+/**
+* Whether a simulated operation clears the caller's own bars.
+*
+* The engine holds an account to the facade's `1.0`, because its guards answer
+* "would this revert". A form is wiser to ask for more, and the engine's own
+* note says so — a caller wanting the stricter bar applies it itself. This is
+* that second opinion, over the numbers the engine already reported.
+*
+* Three of the checks below the engine does not make at all: both health-factor
+* bars are its own `1.0`, and the quota count it never weighs. The other two run
+* against the same numbers the engine used, and are here so that a change in the
+* engine cannot pass silently.
+*
+* What is deliberately absent: the forbidden-token, quota-limit and funding
+* checks all need the *delta* an operation applies, and `OperationState` reports
+* only the state after it. Weighing them against absolutes would refuse a
+* forbidden token the account merely holds, or a quota the operation never
+* touched. The engine performed all three during the walk, so a simulation that
+* came back `ok` has already passed them.
+*/
+function checkSimulation(input, options = {}) {
+	const { sdk, state } = input;
+	const suite = sdk.marketRegister.findCreditManager(state.creditManager);
+	return marketIssues(suite) || checkDebtInBand({
+		debt: state.totalDebt.value,
+		minDebt: suite.creditFacade.minDebt,
+		maxDebt: suite.creditFacade.maxDebt,
+		underlying: toToken(sdk, suite.market.pool.underlying),
+		allowZero: true
+	}) || quotaCountIssue(suite, state) || collateralIssue(state, options);
+}
+//#endregion
+export { checkSimulation };

package/dist/esm/preview/validate/index.js

@@ -0,0 +1,3 @@
+import { checkOperation, collateralIssue, marketIssues, quotaCountIssue } from "./checkOperation.js";
+import { checkSimulation } from "./checkSimulation.js";
+export { checkOperation, checkSimulation, collateralIssue, marketIssues, quotaCountIssue };

package/dist/esm/rewards/errors.js

@@ -0,0 +1,26 @@
+import { BaseError } from "viem";
+//#region src/rewards/errors.ts
+/**
+* Thrown when none of Merkl's domains answered for a chain.
+*
+* Everything a reader needs is in the message: this error travels to consumers
+* inside a chain's {@link ChainFailed} metadata, where it is typed `unknown`
+* and may be serialised by something that turns an arbitrary object into `{}`.
+*/
+var MerklRequestFailedError = class extends BaseError {
+	name = "MerklRequestFailedError";
+	chainId;
+	constructor(chainId, path, attempts) {
+		super(`Merkl could not be reached for chain ${chainId}.`, {
+			cause: attempts.find(([, c]) => c instanceof Error)?.[1],
+			metaMessages: attempts.map(([domain, cause]) => `${domain}${path} — ${describe(cause)}`)
+		});
+		this.chainId = chainId;
+	}
+};
+function describe(cause) {
+	if (cause instanceof Error) return cause.name === "TimeoutError" ? "timed out" : cause.message;
+	return String(cause);
+}
+//#endregion
+export { MerklRequestFailedError };

package/dist/esm/rewards/index.js

@@ -1,5 +1,4 @@
-import "./apy/index.js";
-import { RewardAmountAPI } from "./rewards/api.js";
-import { PoolPointsAPI, getKeyForPoolPointsInfo } from "./rewards/extra-apy.js";
-import "./rewards/index.js";
-export { PoolPointsAPI, RewardAmountAPI, getKeyForPoolPointsInfo };
+import { MerklRequestFailedError } from "./errors.js";
+import { toMerklRewards } from "./toMerklRewards.js";
+import { getMerklRewardsMultichain } from "./multichain.js";
+export { MerklRequestFailedError, getMerklRewardsMultichain, toMerklRewards };

package/dist/esm/rewards/merkl-api.js

@@ -0,0 +1,42 @@
+import { MerklRequestFailedError } from "./errors.js";
+//#region src/rewards/merkl-api.ts
+/**
+* Merkl's own host and the Angle mirror, tried in this order.
+*/
+const MERKL_DOMAINS = ["https://api.merkl.xyz", "https://api-merkl.angle.money"];
+const MERKL_API_KEY_HEADER = "X-API-Key";
+/**
+* Per-attempt budget. Merkl has no timeout of its own, and a hung connection
+* would otherwise stall its leg of a fan-out for as long as the socket lives.
+*/
+const ATTEMPT_TIMEOUT = 1e4;
+/**
+* The wallet's raw Merkl rewards on one chain.
+*
+* Rejects with {@link MerklRequestFailedError} when neither domain answers, so
+* a caller can tell an unreachable Merkl from a wallet with nothing to claim.
+* A non-2xx counts as no answer and moves to the next domain: it carries no
+* rewards either way, and treating it as success would report emptiness that
+* was never established.
+*/
+async function fetchMerklUserRewards({ chainId, user, apiKey }) {
+	const path = `/v4/users/${user}/rewards?chainId=${chainId}`;
+	const headers = apiKey ? { [MERKL_API_KEY_HEADER]: apiKey } : void 0;
+	const attempts = [];
+	for (const domain of MERKL_DOMAINS) try {
+		const response = await fetch(`${domain}${path}`, {
+			headers,
+			signal: AbortSignal.timeout(ATTEMPT_TIMEOUT)
+		});
+		if (!response.ok) {
+			attempts.push([domain, /* @__PURE__ */ new Error(`answered ${response.status}`)]);
+			continue;
+		}
+		return await response.json();
+	} catch (error) {
+		attempts.push([domain, error]);
+	}
+	throw new MerklRequestFailedError(chainId, path, attempts);
+}
+//#endregion
+export { MERKL_API_KEY_HEADER, MERKL_DOMAINS, fetchMerklUserRewards };

package/dist/esm/rewards/multichain.js

@@ -0,0 +1,39 @@
+import { MultichainConstruct } from "../onchain/base/MultichainConstruct.js";
+import "../onchain/index.js";
+import { fetchMerklUserRewards } from "./merkl-api.js";
+import { toMerklRewards } from "./toMerklRewards.js";
+import { getAddress } from "viem";
+//#region src/rewards/multichain.ts
+/**
+* The fan-out itself. Private because rewards are not an SDK namespace yet:
+* the read is a free function, and this is only how it reaches `queryChains`.
+**/
+var MerklRewardsFanOut = class extends MultichainConstruct {
+	async list(wallet, chainIds, apiKey) {
+		const user = getAddress(wallet);
+		return this.queryChains({
+			chainIds,
+			label: "list rewards",
+			block: "state",
+			run: async (sdk) => toMerklRewards(sdk, await fetchMerklUserRewards({
+				chainId: sdk.chainId,
+				user,
+				apiKey
+			}))
+		});
+	}
+};
+/**
+* Every claimable Merkl reward a wallet holds, across the chains the handle
+* carries.
+*
+* Answers the read model's own envelope, so a chain that could not be reached
+* is `status: "error"` in `meta.chains` while a chain with nothing to claim is
+* a `"success"` that contributed no rows. That distinction is the point: the
+* single-chain read this replaces resolved empty either way.
+**/
+async function getMerklRewardsMultichain({ sdk, wallet, chainIds, apiKey }) {
+	return new MerklRewardsFanOut(sdk).list(wallet, chainIds, apiKey);
+}
+//#endregion
+export { getMerklRewardsMultichain };

package/dist/esm/rewards/toMerklRewards.js

@@ -0,0 +1,84 @@
+import { AddressMap } from "../onchain/utils/AddressMap.js";
+import { BigIntMath } from "../onchain/utils/bigint-math.js";
+import { toBigInt } from "../onchain/utils/formatter.js";
+import "../onchain/index.js";
+import { formatUnits, getAddress, isAddress } from "viem";
+//#region src/rewards/toMerklRewards.ts
+/**
+* Merkl's answer for one chain, turned into rows of the read model.
+*/
+function toMerklRewards(sdk, response) {
+	const poolByItsToken = AddressMap.fromMappedArray(sdk.marketRegister.pools.map(({ pool }) => pool.address), (address) => address);
+	const claimable = /* @__PURE__ */ new Map();
+	for (const chainRewards of response) for (const reward of chainRewards.rewards) {
+		if (!isAddress(reward.token.address, { strict: false })) continue;
+		const rewardTokenAddress = getAddress(reward.token.address);
+		for (const reason of reward.breakdowns) {
+			const poolTokenAddress = (reason.reason || "").split("_").find((part) => part.startsWith("0x")) ?? "";
+			if (!isAddress(poolTokenAddress, { strict: false })) continue;
+			const pool = poolByItsToken.get(poolTokenAddress);
+			if (!pool) continue;
+			const amounts = toAmounts(reason);
+			if (!amounts) continue;
+			const amount = BigIntMath.max(amounts.total - amounts.claimed, 0n);
+			if (amount === 0n) continue;
+			const key = `${pool}_${rewardTokenAddress}`;
+			const seen = claimable.get(key);
+			if (seen) {
+				seen.value += amount;
+				continue;
+			}
+			const poolToken = sdk.tokensMeta.getToken(pool);
+			if (!poolToken) continue;
+			claimable.set(key, {
+				chainId: sdk.chainId,
+				pool,
+				poolToken,
+				token: toRewardToken(sdk, rewardTokenAddress, reward.token),
+				value: amount,
+				price: reward.token.price
+			});
+		}
+	}
+	return [...claimable.values()].map(toReward);
+}
+/**
+* `toBigInt` throws on anything `BigInt()` cannot parse, and Merkl's amounts
+* are free-form strings.
+*/
+function toAmounts(reason) {
+	try {
+		return {
+			total: toBigInt(reason.amount || 0),
+			claimed: toBigInt(reason.claimed || 0)
+		};
+	} catch {
+		return;
+	}
+}
+function toReward({ price, token, value, ...rest }) {
+	return {
+		...rest,
+		amount: {
+			token,
+			value,
+			valueUsd: price === void 0 ? null : Number(formatUnits(value, token.decimals)) * price
+		}
+	};
+}
+/**
+* A campaign's incentive token is not protocol collateral, so the registry
+* usually has no entry for it — and Merkl always names it. The one place the
+* two sources are reconciled.
+*/
+function toRewardToken(sdk, address, merkl) {
+	return sdk.tokensMeta.getToken(address) ?? {
+		chainId: sdk.chainId,
+		address,
+		symbol: merkl.symbol,
+		name: merkl.symbol,
+		decimals: merkl.decimals || 18
+	};
+}
+//#endregion
+export { toMerklRewards };

package/dist/esm/sdk/GearboxSDK.js

@@ -6,6 +6,8 @@ import "../offchain/index.js";
 import { assertSameChains } from "./errors/assertSameChains.js";
 import { MissingSourceError } from "./errors/MissingSourceError.js";
 import "./errors/index.js";
+import { AnalyticsNamespace } from "./analytics/AnalyticsNamespace.js";
+import "./analytics/index.js";
 import { LiquidationsNamespace } from "./liquidations/LiquidationsNamespace.js";
 import "./liquidations/index.js";
 import "./utils/mergeChains.js";
@@ -50,6 +52,8 @@ var GearboxSDK = class {
 	* Chains this instance covers, which every read is scoped to.
 	**/
 	networks;
+	/** Protocol-wide analytics. Undefined in `onchain` mode. */
+	analytics;
 	/**
 	* Namespace for pool and strategy opportunities.
 	**/
@@ -130,6 +134,7 @@ var GearboxSDK = class {
 			ensureFresh: this.#onchain ? (chainIds) => this.#ensureFresh(chainIds) : void 0,
 			logger
 		};
+		this.analytics = this.#offchain ? new AnalyticsNamespace(this.#offchain) : void 0;
 		this.opportunities = new OpportunitiesNamespace(this.#onchain, this.#offchain, namespaceOptions);
 		this.positions = new PositionsNamespace(this.#onchain, this.#offchain, namespaceOptions);
 		this.liquidations = this.#onchain ? new LiquidationsNamespace(this.#onchain, namespaceOptions) : void 0;

package/dist/esm/sdk/analytics/AnalyticsNamespace.js

@@ -0,0 +1,16 @@
+//#region src/sdk/analytics/AnalyticsNamespace.ts
+/** Backend-only protocol analytics exposed by {@link GearboxSDK}. */
+var AnalyticsNamespace = class {
+	positions;
+	#backend;
+	constructor(backend) {
+		this.#backend = backend;
+		this.positions = backend.analytics.positions;
+	}
+	/** {@inheritDoc IAnalytics.charts} */
+	async charts(metrics, range, filter) {
+		return this.#backend.analytics.getCharts(metrics, range, filter);
+	}
+};
+//#endregion
+export { AnalyticsNamespace };

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

@@ -0,0 +1,3 @@
+import { AnalyticsNamespace } from "./AnalyticsNamespace.js";
+import "./types.js";
+export { AnalyticsNamespace };

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

@@ -1,6 +1,6 @@
 //#region src/sdk/execute/ExecuteApi.ts
 /**
-* {@inheritDoc OpportunitiesExecute}
+* {@inheritDoc IOpportunitiesExecute}
 **/
 var ExecuteApi = class {
 	#chainOf;
@@ -8,10 +8,10 @@ var ExecuteApi = class {
 		this.#chainOf = chainOf;
 	}
 	/**
-	* {@inheritDoc OpportunitiesExecute.buildTx}
+	* {@inheritDoc IOpportunitiesExecute.buildTx}
 	**/
 	async buildTx(request) {
-		if (!request.sim.ok) throw new Error(`cannot build a transaction from a failed ${request.kind} simulation`);
+		if (!request.sim.ok) throw new Error(`cannot build a transaction from a failed ${request.kind} preparation`);
 		const sdk = this.#chainOf(request.chainId);
 		switch (request.kind) {
 			case "pool": return poolTx(sdk, request);
@@ -22,23 +22,26 @@ var ExecuteApi = class {
 };
 function poolTx(sdk, request) {
 	const { pool, wallet, sim } = request;
-	const { tokenIn, tokenOut } = sim.preview;
+	const { tokenIn, tokenOut } = sim.data.state;
 	if (request.op === "deposit") {
-		const meta = sdk.pools.getDepositMetadata(pool, tokenIn.token, tokenOut.token);
+		const meta = sdk.pools.getDepositMetadata(pool, tokenIn.token.address, tokenOut.token.address);
 		const result = sdk.pools.addLiquidity({
 			pool,
 			wallet,
-			collateral: tokenIn,
+			collateral: {
+				token: tokenIn.token.address,
+				balance: tokenIn.value
+			},
 			meta
 		});
-		if (!result) throw new Error(`pool ${pool} takes no deposit transaction for ${tokenIn.token} (${meta.type})`);
+		if (!result) throw new Error(`pool ${pool} takes no deposit transaction for ${tokenIn.token.address} (${meta.type})`);
 		return result.tx;
 	}
-	const meta = sdk.pools.getWithdrawalMetadata(pool, tokenIn.token, tokenOut.token);
+	const meta = sdk.pools.getWithdrawalMetadata(pool, tokenIn.token.address, tokenOut.token.address);
 	return sdk.pools.removeLiquidity({
 		pool,
 		wallet,
-		amount: request.op === "withdraw" ? tokenOut.balance : tokenIn.balance,
+		amount: request.op === "withdraw" ? tokenOut.value : tokenIn.value,
 		permit: void 0,
 		meta,
 		mode: request.op === "withdraw" ? "withdraw" : "redeem"
@@ -46,16 +49,16 @@ function poolTx(sdk, request) {
 }
 async function openTx(sdk, request) {
 	const { creditManager, wallet, collateral, ethAmount, sim } = request;
-	const { preview } = sim;
+	const { state } = sim.data;
 	return sdk.accounts.openCA({
 		creditManager,
 		to: wallet,
 		collateral,
 		ethAmount,
-		debt: preview.debt,
-		calls: preview.calls,
-		averageQuota: preview.averageQuota,
-		minQuota: preview.minQuota,
+		debt: state.totalDebt.value,
+		calls: state.calls,
+		averageQuota: state.averageQuota,
+		minQuota: state.minQuota,
 		permits: {},
 		referralCode: 0n,
 		rwaOptions: await openRwaOptions(sdk, request)
@@ -79,13 +82,13 @@ async function openRwaOptions(sdk, request) {
 async function accountTx(sdk, request) {
 	const account = await sdk.accounts.getCreditAccountData(request.creditAccount);
 	if (!account) throw new Error(`credit account not found: ${request.creditAccount}`);
-	return sdk.accounts.executeCaUpdate(account, request.sim.calls, { ethAmount: nativeValue(request.sim.operations) });
+	return sdk.accounts.executeCaUpdate(account, request.sim.data.calls, { ethAmount: nativeValue(request.sim.data.operations) });
 }
 /**
-* The coin the simulation asked the wallet for, which the facade wraps out of
+* The coin the preparation asked the wallet for, which the facade wraps out of
 * `msg.value` before running the multicall. Taken off the collateral step that
 * recorded it rather than from the caller, so it cannot disagree with what was
-* simulated.
+* prepared.
 **/
 function nativeValue(operations) {
 	return operations.reduce((total, op) => total + (op.type === "addCollateral" ? op.value ?? 0n : 0n), 0n);

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

@@ -1,2 +1,3 @@
 import { ExecuteApi } from "./ExecuteApi.js";
+import "./types.js";
 export { ExecuteApi };

package/dist/esm/sdk/index.js

@@ -1,3 +1,4 @@
+import { IntentPreviewError, raise, refuse } from "../onchain/validation/refusal.js";
 import { AllSourcesFailedError } from "./errors/AllSourcesFailedError.js";
 import { SourceChainMismatchError } from "./errors/SourceChainMismatchError.js";
 import { assertSameChains } from "./errors/assertSameChains.js";
@@ -7,10 +8,13 @@ import { NoSourceServedError } from "./errors/NoSourceServedError.js";
 import { SourceUnavailableError } from "./errors/SourceUnavailableError.js";
 import "./errors/index.js";
 import { AbstractNamespace } from "./AbstractNamespace.js";
+import { AnalyticsNamespace } from "./analytics/AnalyticsNamespace.js";
+import "./analytics/index.js";
 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 { PrepareApi } from "./prepare/PrepareApi.js";
 import "./prepare/index.js";
 import { filterResponse } from "./utils/filterResponse.js";
@@ -24,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, DEFAULT_MAX_OFFCHAIN_LAG, DEFAULT_MAX_STATE_AGE, ExecuteApi, GearboxSDK, LiquidationsNamespace, MissingSourceError, NoSourceServedError, OpportunitiesNamespace, PositionsNamespace, PrepareApi, PreviewNamespace, SourceChainMismatchError, SourceUnavailableError, assertSameChains, everyChainFailed, filterResponse, mergeChainList, mergeChainOne };
+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 };

package/dist/esm/sdk/liquidations/LiquidationsNamespace.js

@@ -2,7 +2,7 @@ import { toChainIds } from "../../onchain/chain/chains.js";
 import "../../onchain/index.js";
 //#region src/sdk/liquidations/LiquidationsNamespace.ts
 /**
-* {@inheritDoc Liquidations}
+* {@inheritDoc ILiquidations}
 **/
 var LiquidationsNamespace = class {
 	#onchain;
@@ -12,28 +12,28 @@ var LiquidationsNamespace = class {
 		this.#ensureFresh = options.ensureFresh;
 	}
 	/**
-	* {@inheritDoc Liquidations.getLiquidatableAccounts}
+	* {@inheritDoc ILiquidations.getLiquidatableAccounts}
 	**/
 	async getLiquidatableAccounts(props) {
 		await this.#ensureFresh?.(props?.chainIds);
 		return this.#onchain.liquidations.getLiquidatableAccounts(props);
 	}
 	/**
-	* {@inheritDoc Liquidations.getLiquidationDetails}
+	* {@inheritDoc ILiquidations.getLiquidationDetails}
 	**/
 	async getLiquidationDetails(props) {
 		await this.#ensureFresh?.(toChainIds([props.network]));
 		return this.#onchain.liquidations.getLiquidationDetails(props);
 	}
 	/**
-	* {@inheritDoc Liquidations.buildLiquidationTx}
+	* {@inheritDoc ILiquidations.buildLiquidationTx}
 	**/
 	async buildLiquidationTx(props) {
 		await this.#ensureFresh?.(toChainIds([props.network]));
 		return this.#onchain.liquidations.buildLiquidationTx(props);
 	}
 	/**
-	* {@inheritDoc Liquidations.getLiquidationPositions}
+	* {@inheritDoc ILiquidations.getLiquidationPositions}
 	**/
 	async getLiquidationPositions(props) {
 		await this.#ensureFresh?.(props.chainIds);