@gearbox-protocol/sdk 15.1.0-next.2 → 15.1.0-next.21

package/dist/cjs/model/opportunities.schema.js

@@ -1,9 +1,10 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_sdk_utils_zod = require("../sdk/utils/zod.js");
+const require_model_compare_schema = require("./compare.schema.js");
+const require_model_primitives_schema = require("./primitives.schema.js");
 const require_model_curators_schema = require("./curators.schema.js");
 const require_model_filters = require("./filters.js");
 const require_model_filters_schema = require("./filters.schema.js");
-const require_model_primitives_schema = require("./primitives.schema.js");
 let zod_v4 = require("zod/v4");
 //#region src/model/opportunities.schema.ts
 /**
@@ -46,9 +47,9 @@ const rewardsSchema = zod_v4.z.discriminatedUnion("kind", [tokenRewardsSchema, p
 * {@link ApyBreakdown}
 **/
 const apyBreakdownSchema = zod_v4.z.object({
-	totalApy: require_model_primitives_schema.bpsSchema.optional(),
-	organicApy: require_model_primitives_schema.bpsSchema,
-	rewards: zod_v4.z.array(rewardsSchema).optional()
+	totalApy: require_model_compare_schema.offchainOnly(require_model_primitives_schema.bpsSchema).optional(),
+	organicApy: require_model_compare_schema.tolerance(require_model_primitives_schema.bpsSchema, "bps"),
+	rewards: require_model_compare_schema.offchainOnly(zod_v4.z.array(rewardsSchema)).optional()
 });
 /**
 * {@link OpportunityBase}
@@ -71,10 +72,11 @@ const poolOpportunitySchema = zod_v4.z.object({
 	...opportunityBaseSchema.shape,
 	kind: zod_v4.z.literal("pool"),
 	pool: require_sdk_utils_zod.ZodAddress(),
-	totalSupply: require_model_primitives_schema.amountSchema,
-	availableLiquidity: require_model_primitives_schema.amountSchema,
-	utilization: require_model_primitives_schema.bpsSchema,
-	supplyApy: apyBreakdownSchema
+	totalSupply: require_model_compare_schema.tolerance(require_model_primitives_schema.amountSchema, "amount"),
+	availableLiquidity: require_model_compare_schema.tolerance(require_model_primitives_schema.amountSchema, "amount"),
+	utilization: require_model_compare_schema.tolerance(require_model_primitives_schema.bpsSchema, "bps"),
+	supplyApy: apyBreakdownSchema,
+	supplyApyAvg7D: require_model_compare_schema.offchainOnly(apyBreakdownSchema).optional()
 });
 /**
 * {@link StrategyOpportunity}
@@ -88,12 +90,19 @@ const strategyOpportunitySchema = zod_v4.z.object({
 	liquidationPremium: require_model_primitives_schema.bpsSchema,
 	liquidationFee: require_model_primitives_schema.bpsSchema,
 	expirationDate: require_model_primitives_schema.timestampSchema.nullable(),
-	collateralApy: apyBreakdownSchema.optional(),
-	maxLeverageApy: apyBreakdownSchema.optional(),
-	borrowApy: require_model_primitives_schema.bpsSchema.optional(),
-	additionalBorrowApy: require_model_primitives_schema.bpsSchema.optional(),
-	totalValue: require_model_primitives_schema.amountSchema.optional(),
-	utilization: require_model_primitives_schema.bpsSchema.optional(),
+	collateralApy: require_model_compare_schema.offchainOnly(apyBreakdownSchema).optional(),
+	collateralApyAvg7D: require_model_compare_schema.offchainOnly(apyBreakdownSchema).optional(),
+	maxLeverageApy: require_model_compare_schema.offchainOnly(apyBreakdownSchema).optional(),
+	maxLeverageApyAvg7D: require_model_compare_schema.offchainOnly(apyBreakdownSchema).optional(),
+	borrowApy: require_model_compare_schema.tolerance(require_model_primitives_schema.bpsSchema, "bps").optional(),
+	borrowApyAvg7D: require_model_compare_schema.offchainOnly(require_model_primitives_schema.bpsSchema).optional(),
+	additionalBorrowApy: require_model_compare_schema.tolerance(require_model_primitives_schema.bpsSchema, "bps").optional(),
+	additionalBorrowApyAvg7D: require_model_compare_schema.offchainOnly(require_model_primitives_schema.bpsSchema).optional(),
+	totalValue: require_model_compare_schema.offchainOnly(require_model_primitives_schema.amountSchema).optional(),
+	utilization: require_model_compare_schema.offchainOnly(require_model_primitives_schema.bpsSchema).optional(),
+	availableLiquidity: require_model_compare_schema.tolerance(require_model_primitives_schema.amountSchema, "amount"),
+	minDebt: require_model_primitives_schema.amountSchema,
+	totalDebtLimit: require_model_primitives_schema.amountSchema,
 	maxBorrowAmount: require_model_primitives_schema.amountSchema,
 	maxLeverage: require_model_primitives_schema.leverageSchema
 });
@@ -224,8 +233,7 @@ const poolOpportunityKeySchema = zod_v4.z.object({
 **/
 const strategyOpportunityKeySchema = zod_v4.z.object({
 	chainId: require_model_primitives_schema.chainIdSchema,
-	creditManager: require_sdk_utils_zod.ZodAddress(),
-	targetCollateral: require_sdk_utils_zod.ZodAddress()
+	creditManager: require_sdk_utils_zod.ZodAddress()
 });
 /**
 * {@link OpportunityKey}

package/dist/cjs/model/positions.schema.js

@@ -1,10 +1,11 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_sdk_utils_zod = require("../sdk/utils/zod.js");
+const require_model_compare_schema = require("./compare.schema.js");
+const require_model_primitives_schema = require("./primitives.schema.js");
 const require_model_filters = require("./filters.js");
 const require_model_filters_schema = require("./filters.schema.js");
-const require_model_primitives_schema = require("./primitives.schema.js");
-const require_model_opportunities_schema = require("./opportunities.schema.js");
 const require_model_liquidations_schema = require("./liquidations.schema.js");
+const require_model_opportunities_schema = require("./opportunities.schema.js");
 let zod_v4 = require("zod/v4");
 //#region src/model/positions.schema.ts
 /**
@@ -56,8 +57,8 @@ const pnlBreakdownSchema = zod_v4.z.object({
 * {@link PositionCollateral}
 **/
 const positionCollateralSchema = zod_v4.z.object({
-	collateral: require_model_primitives_schema.tokenAmountSchema,
-	quota: require_model_primitives_schema.tokenAmountSchema,
+	collateral: require_model_compare_schema.tolerance(require_model_primitives_schema.tokenAmountSchema, "amount"),
+	quota: require_model_compare_schema.tolerance(require_model_primitives_schema.tokenAmountSchema, "amount"),
 	withdrawals: zod_v4.z.array(require_model_liquidations_schema.delayedReceivedAssetSchema)
 });
 /**
@@ -68,9 +69,26 @@ const poolPositionSchema = zod_v4.z.object({
 	name: zod_v4.z.string(),
 	chainId: require_model_primitives_schema.chainIdSchema,
 	pool: require_sdk_utils_zod.ZodAddress(),
-	netValue: require_model_primitives_schema.tokenAmountSchema,
+	netValue: require_model_compare_schema.tolerance(require_model_primitives_schema.tokenAmountSchema, "amount"),
 	apy: require_model_opportunities_schema.apyBreakdownSchema,
-	pnl: pnlBreakdownSchema.optional()
+	apyAvg7D: require_model_compare_schema.offchainOnly(require_model_opportunities_schema.apyBreakdownSchema).optional(),
+	pnl: require_model_compare_schema.offchainOnly(pnlBreakdownSchema).optional()
+});
+/**
+* {@link TokenQuotaRate}
+**/
+const tokenQuotaRateSchema = zod_v4.z.object({
+	token: require_model_primitives_schema.tokenSchema,
+	rate: require_model_primitives_schema.bpsSchema
+});
+/**
+* {@link BorrowRateBreakdown}
+**/
+const borrowRateBreakdownSchema = zod_v4.z.object({
+	total: require_model_primitives_schema.bpsSchema,
+	totalOnDebt: require_model_primitives_schema.bpsSchema,
+	base: require_model_primitives_schema.bpsSchema,
+	quotas: zod_v4.z.array(tokenQuotaRateSchema)
 });
 /**
 * {@link StrategyPosition}
@@ -82,13 +100,19 @@ const strategyPositionSchema = zod_v4.z.object({
 	creditManager: require_sdk_utils_zod.ZodAddress(),
 	creditAccount: require_sdk_utils_zod.ZodAddress(),
 	targetCollateral: require_model_primitives_schema.tokenSchema.nullable(),
-	leverage: require_model_primitives_schema.leverageSchema,
-	borrowApy: require_model_primitives_schema.bpsSchema,
-	netApy: require_model_opportunities_schema.apyBreakdownSchema.optional(),
-	totalDebt: require_model_primitives_schema.tokenAmountSchema,
-	totalValue: require_model_primitives_schema.tokenAmountSchema,
-	healthFactor: require_model_primitives_schema.bpsSchema,
-	pnl: pnlBreakdownSchema.optional(),
+	leverage: require_model_compare_schema.tolerance(require_model_primitives_schema.leverageSchema, "float"),
+	borrowApy: require_model_compare_schema.tolerance(require_model_primitives_schema.bpsSchema, "bps"),
+	borrowApyAvg7D: require_model_compare_schema.offchainOnly(require_model_primitives_schema.bpsSchema).optional(),
+	netApy: require_model_compare_schema.offchainOnly(require_model_opportunities_schema.apyBreakdownSchema).optional(),
+	netApyAvg7D: require_model_compare_schema.offchainOnly(require_model_opportunities_schema.apyBreakdownSchema).optional(),
+	totalDebt: require_model_compare_schema.tolerance(require_model_primitives_schema.tokenAmountSchema, "amount"),
+	totalValue: require_model_compare_schema.tolerance(require_model_primitives_schema.tokenAmountSchema, "amount"),
+	healthFactor: require_model_compare_schema.tolerance(require_model_primitives_schema.bpsSchema, "bps"),
+	borrowRate: require_model_compare_schema.onchainOnly(borrowRateBreakdownSchema).optional(),
+	borrowRateAvg7D: require_model_compare_schema.offchainOnly(borrowRateBreakdownSchema).optional(),
+	timeToLiquidation: require_model_compare_schema.onchainOnly(require_sdk_utils_zod.ZodBigInt().nullable()).optional(),
+	liquidationPrice: require_model_compare_schema.onchainOnly(require_sdk_utils_zod.ZodBigInt().nullable()).optional(),
+	pnl: require_model_compare_schema.offchainOnly(pnlBreakdownSchema).optional(),
 	collaterals: zod_v4.z.array(positionCollateralSchema)
 });
 /**
@@ -162,7 +186,38 @@ const positionKeySchema = zod_v4.z.discriminatedUnion("kind", [zod_v4.z.object({
 	kind: zod_v4.z.literal("strategy"),
 	...strategyPositionKeySchema.shape
 })]);
+/**
+* {@link PositionsTotals}
+**/
+const positionsTotalsSchema = zod_v4.z.object({
+	currentYield: require_model_opportunities_schema.apyBreakdownSchema.nullable(),
+	pnl: pnlBreakdownSchema.nullable(),
+	netValueUsd: zod_v4.z.number().nullable(),
+	claimableUsd: zod_v4.z.number().nullable()
+});
+/**
+* {@link PositionTransactionKind}
+**/
+const positionTransactionKindSchema = zod_v4.z.union([
+	zod_v4.z.literal("open"),
+	zod_v4.z.literal("deposit"),
+	zod_v4.z.literal("withdraw"),
+	zod_v4.z.literal("adjustLeverage"),
+	zod_v4.z.literal("addCollateral"),
+	zod_v4.z.literal("withdrawCollateral"),
+	zod_v4.z.literal("liquidation")
+]);
+/**
+* {@link PositionTransaction}
+**/
+const positionTransactionSchema = zod_v4.z.object({
+	txHash: require_sdk_utils_zod.ZodHex(),
+	timestamp: require_model_primitives_schema.timestampSchema,
+	kind: positionTransactionKindSchema,
+	assets: zod_v4.z.array(require_model_primitives_schema.tokenAmountSchema)
+});
 //#endregion
+exports.borrowRateBreakdownSchema = borrowRateBreakdownSchema;
 exports.pnlBreakdownSchema = pnlBreakdownSchema;
 exports.pointsProgramPnLSchema = pointsProgramPnLSchema;
 exports.pointsRewardsPnLSchema = pointsRewardsPnLSchema;
@@ -175,7 +230,11 @@ exports.positionFilterSchema = positionFilterSchema;
 exports.positionKeySchema = positionKeySchema;
 exports.positionKindSchema = positionKindSchema;
 exports.positionSchema = positionSchema;
+exports.positionTransactionKindSchema = positionTransactionKindSchema;
+exports.positionTransactionSchema = positionTransactionSchema;
+exports.positionsTotalsSchema = positionsTotalsSchema;
 exports.rewardsPnLSchema = rewardsPnLSchema;
 exports.strategyPositionKeySchema = strategyPositionKeySchema;
 exports.strategyPositionSchema = strategyPositionSchema;
+exports.tokenQuotaRateSchema = tokenQuotaRateSchema;
 exports.tokenRewardsPnLSchema = tokenRewardsPnLSchema;

package/dist/cjs/model/previews.js

@@ -0,0 +1,42 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/model/previews.ts
+/**
+* Broken `storeExpectedBalances`/`compareBalances` bracket structure:
+* `storeExpectedBalances` without a matching `compareBalances`, nested
+* brackets, or `compareBalances` without a preceding `storeExpectedBalances`.
+* We expect transactions that were generated by our frontend using router/withdrawal compressor
+**/
+const ERROR_MALFORMED_BRACKET = 1001;
+/**
+* Adapter call outside a `storeExpectedBalances`/`compareBalances` bracket
+* We expect transactions that were generated by our frontend using router/withdrawal compressor,
+**/
+const ERROR_ADAPTER_CALL_OUTSIDE_BRACKET = 1002;
+/**
+* Bracketed call whose target is not an adapter (or adapter that is not known to the SDK)
+**/
+const ERROR_NON_ADAPTER_CALL_IN_BRACKET = 1003;
+/**
+* Bracketed adapter call cannot be replayed (undecodable/unsupported calldata)
+**/
+const ERROR_UNPREVIEWABLE_ADAPTER_CALL = 1004;
+/**
+* Out-of-bracket RWA wrap/unwrap calldata cannot be decoded
+**/
+const ERROR_UNPREVIEWABLE_RWA_WRAP_UNWRAP = 1005;
+/**
+* `msg.value` does not fit into the declared WETH collateral
+* Transactions can have arbitrary value, but the ones that we create
+* using our frontend should have a value that fits into the declared WETH collateral.
+**/
+const ERROR_INVALID_TRANSACTION_VALUE = 1006;
+/** A token in the preview could not be priced by the oracle */
+const ERROR_UNPRICEABLE_TOKEN = 2001;
+//#endregion
+exports.ERROR_ADAPTER_CALL_OUTSIDE_BRACKET = ERROR_ADAPTER_CALL_OUTSIDE_BRACKET;
+exports.ERROR_INVALID_TRANSACTION_VALUE = ERROR_INVALID_TRANSACTION_VALUE;
+exports.ERROR_MALFORMED_BRACKET = ERROR_MALFORMED_BRACKET;
+exports.ERROR_NON_ADAPTER_CALL_IN_BRACKET = ERROR_NON_ADAPTER_CALL_IN_BRACKET;
+exports.ERROR_UNPREVIEWABLE_ADAPTER_CALL = ERROR_UNPREVIEWABLE_ADAPTER_CALL;
+exports.ERROR_UNPREVIEWABLE_RWA_WRAP_UNWRAP = ERROR_UNPREVIEWABLE_RWA_WRAP_UNWRAP;
+exports.ERROR_UNPRICEABLE_TOKEN = ERROR_UNPRICEABLE_TOKEN;

package/dist/cjs/model/primitives.schema.js

@@ -1,5 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_sdk_utils_zod = require("../sdk/utils/zod.js");
+const require_model_compare_schema = require("./compare.schema.js");
 let zod_v4 = require("zod/v4");
 //#region src/model/primitives.schema.ts
 /**
@@ -40,7 +41,7 @@ const leverageSchema = zod_v4.z.number().nonnegative();
 **/
 const amountSchema = zod_v4.z.object({
 	value: require_sdk_utils_zod.ZodBigInt(),
-	valueUsd: zod_v4.z.number().nullable()
+	valueUsd: require_model_compare_schema.tolerance(zod_v4.z.number().nullable(), "usd")
 });
 /**
 * {@link Token}

package/dist/cjs/new-sdk/AbstractNamespace.js

@@ -18,23 +18,34 @@ var AbstractNamespace = class {
 	**/
 	maxOffchainLagSeconds;
 	logger;
+	/**
+	* The SDK's loading policy, awaited before every on-chain leg: attached, and
+	* the touched chains no older than the SDK allows.
+	**/
+	ensureFresh;
 	#name;
 	#onchain;
 	#offchain;
+	/** {@link onchain}, built once: the source's methods behind the loading policy. */
+	#onchainView;
 	constructor(name, onchain, offchain, options) {
 		this.#name = name;
 		this.#onchain = onchain;
 		this.#offchain = offchain;
 		this.maxOffchainLagSeconds = options.maxOffchainLagSeconds;
+		this.ensureFresh = options.ensureFresh;
 		this.logger = options.logger?.child?.({ name }) ?? options.logger;
+		this.#onchainView = onchain && options.ensureFresh ? behindLoadingPolicy(onchain, options.ensureFresh) : onchain;
 	}
 	/**
-	* The on-chain source namespace on its own. Throws
+	* The on-chain source namespace on its own — every read of it attaches and
+	* revalidates like a merged read does, so a consumer showing the two sources
+	* separately still gets the SDK's loading policy. Throws
 	* {@link SourceUnavailableError} in `offchain` mode.
 	**/
 	get onchain() {
-		if (!this.#onchain) throw new require_new_sdk_errors_SourceUnavailableError.SourceUnavailableError(this.#name, "onchain");
-		return this.#onchain;
+		if (!this.#onchainView) throw new require_new_sdk_errors_SourceUnavailableError.SourceUnavailableError(this.#name, "onchain");
+		return this.#onchainView;
 	}
 	/**
 	* The backend source namespace on its own. Throws
@@ -51,7 +62,10 @@ var AbstractNamespace = class {
 	async merged(action, query) {
 		const onchain = this.#onchain;
 		const offchain = this.#offchain;
-		const [fromChain, fromBackend] = await Promise.all([this.#ask(action, "onchain", onchain, query.fromChain), this.#ask(action, "offchain", offchain, query.fromBackend)]);
+		const [fromChain, fromBackend] = await Promise.all([this.#ask(action, "onchain", onchain, async (source) => {
+			await this.ensureFresh?.(query.chainIds);
+			return query.fromChain(source);
+		}), this.#ask(action, "offchain", offchain, query.fromBackend)]);
 		const merged = query.merge(fromChain.response, fromBackend.response);
 		if (merged && !require_new_sdk_errors_everyChainFailed.everyChainFailed(merged.meta)) return merged;
 		const sole = onchain && offchain ? void 0 : fromChain.error ?? fromBackend.error;
@@ -72,5 +86,21 @@ var AbstractNamespace = class {
 		}
 	}
 };
+/**
+* The source's every method, awaiting the loading policy first. The policy is
+* asked for every chain — an escape hatch does not tell which chains a call
+* touches (the merged reads do, and scope it); the object identity differs
+* from the source's, its type does not.
+**/
+function behindLoadingPolicy(source, ensureFresh) {
+	return new Proxy(source, { get(target, property, receiver) {
+		const value = Reflect.get(target, property, receiver);
+		if (typeof value !== "function") return value;
+		return async (...args) => {
+			await ensureFresh();
+			return Reflect.apply(value, target, args);
+		};
+	} });
+}
 //#endregion
 exports.AbstractNamespace = AbstractNamespace;

package/dist/cjs/new-sdk/GearboxSDK.js

@@ -7,14 +7,23 @@ const require_new_sdk_errors_MissingSourceError = require("./errors/MissingSourc
 require("./errors/index.js");
 const require_offchain_GearboxAPI = require("../offchain/GearboxAPI.js");
 require("../offchain/index.js");
+const require_new_sdk_liquidations_LiquidationsNamespace = require("./liquidations/LiquidationsNamespace.js");
+require("./liquidations/index.js");
 require("./utils/mergeChains.js");
 require("./utils/index.js");
 const require_new_sdk_opportunities_OpportunitiesNamespace = require("./opportunities/OpportunitiesNamespace.js");
 require("./opportunities/index.js");
 const require_new_sdk_positions_PositionsNamespace = require("./positions/PositionsNamespace.js");
 require("./positions/index.js");
+const require_new_sdk_preview_PreviewNamespace = require("./preview/PreviewNamespace.js");
+require("./preview/index.js");
 //#region src/new-sdk/GearboxSDK.ts
 /**
+* Default {@link GearboxSDKOptions.maxStateAgeSeconds}: the fastest poll an
+* app runs, so a 30 s tick sees state no older than itself.
+**/
+const DEFAULT_MAX_STATE_AGE = 30;
+/**
 * Entry point over both sources of Gearbox data: the chain and the Gearbox
 * backend. The {@link Mode} is fixed at construction and decides which methods
 * exist.
@@ -50,16 +59,43 @@ var GearboxSDK = class {
 	* Namespace for the positions a wallet holds.
 	**/
 	positions;
+	/**
+	* Namespace for liquidatable credit accounts and delayed-withdrawal
+	* positions a liquidator holds. Onchain-only, hence gated by mode like
+	* every other chain read: absent in `offchain` mode.
+	**/
+	liquidations;
+	/**
+	* Namespace for on-chain previews of raw operation calldata. Onchain-only,
+	* hence gated by mode like every other chain read: absent in `offchain`
+	* mode.
+	**/
+	preview;
+	/**
+	* The banners the backend attaches to a pool opportunity or a strategy
+	* position, see {@link Notice}. Top-level because the subject is either
+	* kind of entity, so neither namespace owns it. Backend-only, hence gated
+	* by mode like every other backend read: absent in `onchain` mode.
+	**/
+	notices;
 	#attachOptions;
 	#onchain;
 	#offchain;
 	#ownsOnchain = false;
+	#maxStateAgeSeconds;
+	#logger;
 	#attached;
+	/** The one attach in flight, shared by {@link attach} and every first read. */
+	#attaching;
+	/** One sync in flight per chain: concurrent stale reads join it. */
+	#syncing = /* @__PURE__ */ new Map();
 	constructor(options) {
-		const { mode, networks, onchain, offchain, attach, logger, maxOffchainLagSeconds = 120 } = options;
+		const { mode, networks, onchain, offchain, attach, logger, maxOffchainLagSeconds = 120, maxStateAgeSeconds = 30 } = options;
 		this.mode = mode;
 		this.networks = [...networks];
 		this.#attachOptions = attach;
+		this.#maxStateAgeSeconds = maxStateAgeSeconds;
+		this.#logger = logger;
 		const needsOnchain = mode === "onchain" || mode === "both";
 		const needsOffchain = mode === "offchain" || mode === "both";
 		if (needsOnchain && !onchain) throw new require_new_sdk_errors_MissingSourceError.MissingSourceError(mode, "onchain");
@@ -92,19 +128,69 @@ var GearboxSDK = class {
 		this.#attached = !this.#ownsOnchain;
 		const namespaceOptions = {
 			maxOffchainLagSeconds,
+			ensureFresh: this.#onchain ? (chainIds) => this.#ensureFresh(chainIds) : void 0,
 			logger
 		};
 		this.opportunities = new require_new_sdk_opportunities_OpportunitiesNamespace.OpportunitiesNamespace(this.#onchain, this.#offchain, namespaceOptions);
 		this.positions = new require_new_sdk_positions_PositionsNamespace.PositionsNamespace(this.#onchain, this.#offchain, namespaceOptions);
+		this.liquidations = this.#onchain ? new require_new_sdk_liquidations_LiquidationsNamespace.LiquidationsNamespace(this.#onchain, namespaceOptions) : void 0;
+		this.preview = this.#onchain ? new require_new_sdk_preview_PreviewNamespace.PreviewNamespace(this.#onchain, namespaceOptions) : void 0;
+		const backend = this.#offchain;
+		this.notices = backend ? (subject) => backend.notices.list(subject) : void 0;
 	}
 	/**
 	* Attaches the on-chain SDK when this instance owns one; a no-op in `offchain`
 	* mode and when an already-attached SDK was injected.
 	**/
 	async attach() {
+		return this.#ensureAttached();
+	}
+	/**
+	* The attach every async read awaits: the first caller starts it, later
+	* ones join the same promise; a rejected attach is not cached, so the next
+	* read retries.
+	**/
+	async #ensureAttached() {
 		if (this.#attached || !this.#ownsOnchain || !this.#onchain) return;
-		await this.#onchain.attach(this.#attachOptions);
-		this.#attached = true;
+		if (!this.#attaching) {
+			const onchain = this.#onchain;
+			this.#attaching = onchain.attach(this.#attachOptions).then(() => {
+				this.#attached = true;
+			}).finally(() => {
+				this.#attaching = void 0;
+			});
+		}
+		return this.#attaching;
+	}
+	/**
+	* What every on-chain leg of an async read awaits: the source attached, and
+	* the chains the read touches (all of them when unnamed) synced when their
+	* loaded state is older than `maxStateAgeSeconds`. A sync that fails leaves
+	* the previous state to be served — its age tells the consumer it is stale.
+	**/
+	async #ensureFresh(chainIds) {
+		await this.#ensureAttached();
+		const onchain = this.#onchain;
+		if (!onchain) return;
+		const wanted = chainIds && new Set(chainIds);
+		const stale = [];
+		const now = Math.floor(Date.now() / 1e3);
+		for (const chain of onchain.chains.values()) {
+			if (wanted && !wanted.has(chain.chainId)) continue;
+			if (now - Number(chain.timestamp) > this.#maxStateAgeSeconds) stale.push(chain);
+		}
+		await Promise.all(stale.map((chain) => this.#sync(chain)));
+	}
+	#sync(chain) {
+		const inFlight = this.#syncing.get(chain.chainId);
+		if (inFlight) return inFlight;
+		const sync = chain.syncState().then(() => void 0).catch((error) => {
+			this.#logger?.warn(error, `failed to sync chain ${chain.chainId}; serving state of block ${chain.currentBlock}`);
+		}).finally(() => {
+			this.#syncing.delete(chain.chainId);
+		});
+		this.#syncing.set(chain.chainId, sync);
+		return sync;
 	}
 	/**
 	* Whether the on-chain source is ready to be read from. Always `true` in
@@ -141,4 +227,5 @@ function chainsOf(configured, networks) {
 	return chains;
 }
 //#endregion
+exports.DEFAULT_MAX_STATE_AGE = DEFAULT_MAX_STATE_AGE;
 exports.GearboxSDK = GearboxSDK;

package/dist/cjs/new-sdk/execute/ExecuteApi.js

@@ -0,0 +1,95 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/new-sdk/execute/ExecuteApi.ts
+/**
+* {@inheritDoc OpportunitiesExecute}
+**/
+var ExecuteApi = class {
+	#chainOf;
+	constructor(chainOf) {
+		this.#chainOf = chainOf;
+	}
+	/**
+	* {@inheritDoc OpportunitiesExecute.buildTx}
+	**/
+	async buildTx(request) {
+		if (!request.sim.ok) throw new Error(`cannot build a transaction from a failed ${request.kind} simulation`);
+		const sdk = this.#chainOf(request.chainId);
+		switch (request.kind) {
+			case "pool": return poolTx(sdk, request);
+			case "open": return openTx(sdk, request);
+			case "account": return accountTx(sdk, request);
+		}
+	}
+};
+function poolTx(sdk, request) {
+	const { pool, wallet, sim } = request;
+	const { tokenIn, tokenOut } = sim.preview;
+	if (request.op === "deposit") {
+		const meta = sdk.pools.getDepositMetadata(pool, tokenIn.token, tokenOut.token);
+		const result = sdk.pools.addLiquidity({
+			pool,
+			wallet,
+			collateral: tokenIn,
+			meta
+		});
+		if (!result) throw new Error(`pool ${pool} takes no deposit transaction for ${tokenIn.token} (${meta.type})`);
+		return result.tx;
+	}
+	const meta = sdk.pools.getWithdrawalMetadata(pool, tokenIn.token, tokenOut.token);
+	return sdk.pools.removeLiquidity({
+		pool,
+		wallet,
+		amount: request.op === "withdraw" ? tokenOut.balance : tokenIn.balance,
+		permit: void 0,
+		meta,
+		mode: request.op === "withdraw" ? "withdraw" : "redeem"
+	}).tx;
+}
+async function openTx(sdk, request) {
+	const { creditManager, wallet, collateral, ethAmount, sim } = request;
+	const { preview } = sim;
+	return sdk.accounts.openCA({
+		creditManager,
+		to: wallet,
+		collateral,
+		ethAmount,
+		debt: preview.debt,
+		calls: preview.calls,
+		averageQuota: preview.averageQuota,
+		minQuota: preview.minQuota,
+		permits: {},
+		referralCode: 0n,
+		rwaOptions: await openRwaOptions(sdk, request)
+	});
+}
+/**
+* The documented `openCA` contract: ask the market for its open requirements
+* and hand them back as operation args, with the caller's cached signatures
+* attached. `undefined` on non-RWA markets and when no target token is named.
+**/
+async function openRwaOptions(sdk, request) {
+	if (!request.targetToken) return;
+	const requirements = await sdk.accounts.getOpenAccountRequirements(request.wallet, request.creditManager, { tokenOutAddress: request.targetToken });
+	if (!requirements) return;
+	return {
+		type: requirements.type,
+		tokensToRegister: requirements.tokensToRegister,
+		signaturesToCache: request.signaturesToCache ?? []
+	};
+}
+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) });
+}
+/**
+* The coin the simulation 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.
+**/
+function nativeValue(operations) {
+	return operations.reduce((total, op) => total + (op.type === "addCollateral" ? op.value ?? 0n : 0n), 0n);
+}
+//#endregion
+exports.ExecuteApi = ExecuteApi;

package/dist/cjs/new-sdk/execute/index.js

@@ -0,0 +1,3 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_new_sdk_execute_ExecuteApi = require("./ExecuteApi.js");
+exports.ExecuteApi = require_new_sdk_execute_ExecuteApi.ExecuteApi;

package/dist/cjs/new-sdk/index.js

@@ -8,6 +8,12 @@ const require_new_sdk_errors_NoSourceServedError = require("./errors/NoSourceSer
 const require_new_sdk_errors_SourceUnavailableError = require("./errors/SourceUnavailableError.js");
 require("./errors/index.js");
 const require_new_sdk_AbstractNamespace = require("./AbstractNamespace.js");
+const require_new_sdk_liquidations_LiquidationsNamespace = require("./liquidations/LiquidationsNamespace.js");
+require("./liquidations/index.js");
+const require_new_sdk_execute_ExecuteApi = require("./execute/ExecuteApi.js");
+require("./execute/index.js");
+const require_new_sdk_prepare_PrepareApi = require("./prepare/PrepareApi.js");
+require("./prepare/index.js");
 const require_new_sdk_utils_filterResponse = require("./utils/filterResponse.js");
 const require_new_sdk_utils_mergeChains = require("./utils/mergeChains.js");
 require("./utils/index.js");
@@ -15,16 +21,23 @@ const require_new_sdk_opportunities_OpportunitiesNamespace = require("./opportun
 require("./opportunities/index.js");
 const require_new_sdk_positions_PositionsNamespace = require("./positions/PositionsNamespace.js");
 require("./positions/index.js");
+const require_new_sdk_preview_PreviewNamespace = require("./preview/PreviewNamespace.js");
+require("./preview/index.js");
 const require_new_sdk_GearboxSDK = require("./GearboxSDK.js");
 require("./types.js");
 exports.AbstractNamespace = require_new_sdk_AbstractNamespace.AbstractNamespace;
 exports.AllSourcesFailedError = require_new_sdk_errors_AllSourcesFailedError.AllSourcesFailedError;
 exports.DEFAULT_MAX_OFFCHAIN_LAG = require_new_sdk_utils_mergeChains.DEFAULT_MAX_OFFCHAIN_LAG;
+exports.DEFAULT_MAX_STATE_AGE = require_new_sdk_GearboxSDK.DEFAULT_MAX_STATE_AGE;
+exports.ExecuteApi = require_new_sdk_execute_ExecuteApi.ExecuteApi;
 exports.GearboxSDK = require_new_sdk_GearboxSDK.GearboxSDK;
+exports.LiquidationsNamespace = require_new_sdk_liquidations_LiquidationsNamespace.LiquidationsNamespace;
 exports.MissingSourceError = require_new_sdk_errors_MissingSourceError.MissingSourceError;
 exports.NoSourceServedError = require_new_sdk_errors_NoSourceServedError.NoSourceServedError;
 exports.OpportunitiesNamespace = require_new_sdk_opportunities_OpportunitiesNamespace.OpportunitiesNamespace;
 exports.PositionsNamespace = require_new_sdk_positions_PositionsNamespace.PositionsNamespace;
+exports.PrepareApi = require_new_sdk_prepare_PrepareApi.PrepareApi;
+exports.PreviewNamespace = require_new_sdk_preview_PreviewNamespace.PreviewNamespace;
 exports.SourceChainMismatchError = require_new_sdk_errors_SourceChainMismatchError.SourceChainMismatchError;
 exports.SourceUnavailableError = require_new_sdk_errors_SourceUnavailableError.SourceUnavailableError;
 exports.assertSameChains = require_new_sdk_errors_assertSameChains.assertSameChains;

package/dist/cjs/new-sdk/liquidations/LiquidationsNamespace.js

@@ -0,0 +1,45 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_sdk_chain_chains = require("../../sdk/chain/chains.js");
+require("../../sdk/index.js");
+//#region src/new-sdk/liquidations/LiquidationsNamespace.ts
+/**
+* {@inheritDoc Liquidations}
+**/
+var LiquidationsNamespace = class {
+	#onchain;
+	#ensureFresh;
+	constructor(onchain, options) {
+		this.#onchain = onchain;
+		this.#ensureFresh = options.ensureFresh;
+	}
+	/**
+	* {@inheritDoc Liquidations.getLiquidatableAccounts}
+	**/
+	async getLiquidatableAccounts(props) {
+		await this.#ensureFresh?.(props?.chainIds);
+		return this.#onchain.liquidations.getLiquidatableAccounts(props);
+	}
+	/**
+	* {@inheritDoc Liquidations.getLiquidationDetails}
+	**/
+	async getLiquidationDetails(props) {
+		await this.#ensureFresh?.(require_sdk_chain_chains.toChainIds([props.network]));
+		return this.#onchain.liquidations.getLiquidationDetails(props);
+	}
+	/**
+	* {@inheritDoc Liquidations.buildLiquidationTx}
+	**/
+	async buildLiquidationTx(props) {
+		await this.#ensureFresh?.(require_sdk_chain_chains.toChainIds([props.network]));
+		return this.#onchain.liquidations.buildLiquidationTx(props);
+	}
+	/**
+	* {@inheritDoc Liquidations.getLiquidationPositions}
+	**/
+	async getLiquidationPositions(props) {
+		await this.#ensureFresh?.(props.chainIds);
+		return this.#onchain.liquidations.getLiquidationPositions(props);
+	}
+};
+//#endregion
+exports.LiquidationsNamespace = LiquidationsNamespace;