@gearbox-protocol/sdk 15.1.0-next.1 → 15.1.0-next.11

package/dist/cjs/model/index.js

@@ -1,34 +1,50 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_model_charts = require("./charts.js");
+const require_model_primitives_schema = require("./primitives.schema.js");
+const require_model_charts_schema = require("./charts.schema.js");
 require("./curators.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_history = require("./history.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_positions_schema = require("./positions.schema.js");
-const require_model_history_schema = require("./history.schema.js");
 const require_model_liquidations = require("./liquidations.js");
+const require_model_liquidations_schema = require("./liquidations.schema.js");
+require("./notices.js");
+const require_model_notices_schema = require("./notices.schema.js");
 const require_model_opportunities = require("./opportunities.js");
+const require_model_opportunities_schema = require("./opportunities.schema.js");
 const require_model_positions = require("./positions.js");
+const require_model_positions_schema = require("./positions.schema.js");
 require("./primitives.js");
 require("./response.js");
 const require_model_response_schema = require("./response.schema.js");
+exports.CHART_METRIC_UNITS = require_model_charts.CHART_METRIC_UNITS;
+exports.CHART_RANGES = require_model_charts.CHART_RANGES;
+exports.CHART_UNAVAILABLE_CODES = require_model_charts.CHART_UNAVAILABLE_CODES;
 exports.FILTER_ALL = require_model_filters.FILTER_ALL;
-exports.POOL_HISTORY_METRICS = require_model_history.POOL_HISTORY_METRICS;
-exports.POOL_POSITION_HISTORY_METRICS = require_model_history.POOL_POSITION_HISTORY_METRICS;
-exports.STRATEGY_HISTORY_METRICS = require_model_history.STRATEGY_HISTORY_METRICS;
-exports.STRATEGY_POSITION_HISTORY_METRICS = require_model_history.STRATEGY_POSITION_HISTORY_METRICS;
+exports.POOL_OPPORTUNITY_CHART_METRICS = require_model_charts.POOL_OPPORTUNITY_CHART_METRICS;
+exports.POOL_POSITION_CHART_METRICS = require_model_charts.POOL_POSITION_CHART_METRICS;
+exports.STRATEGY_OPPORTUNITY_CHART_METRICS = require_model_charts.STRATEGY_OPPORTUNITY_CHART_METRICS;
+exports.STRATEGY_POSITION_CHART_METRICS = require_model_charts.STRATEGY_POSITION_CHART_METRICS;
 exports.amountSchema = require_model_primitives_schema.amountSchema;
 exports.apyBreakdownSchema = require_model_opportunities_schema.apyBreakdownSchema;
 exports.assetTypeSchema = require_model_primitives_schema.assetTypeSchema;
 exports.booleanParamSchema = require_model_filters_schema.booleanParamSchema;
+exports.borrowRateBreakdownSchema = require_model_positions_schema.borrowRateBreakdownSchema;
 exports.bpsSchema = require_model_primitives_schema.bpsSchema;
 exports.chainFailedSchema = require_model_response_schema.chainFailedSchema;
 exports.chainIdSchema = require_model_primitives_schema.chainIdSchema;
 exports.chainMetadataSchema = require_model_response_schema.chainMetadataSchema;
 exports.chainSucceededSchema = require_model_response_schema.chainSucceededSchema;
+exports.chartBundleSchemaFor = require_model_charts_schema.chartBundleSchemaFor;
+exports.chartDenominationSchema = require_model_charts_schema.chartDenominationSchema;
+exports.chartMetricSchema = require_model_charts_schema.chartMetricSchema;
+exports.chartQueryCodec = require_model_charts_schema.chartQueryCodec;
+exports.chartQueryParamsSchema = require_model_charts_schema.chartQueryParamsSchema;
+exports.chartQuerySchema = require_model_charts_schema.chartQuerySchema;
+exports.chartRangeSchema = require_model_charts_schema.chartRangeSchema;
+exports.chartSeriesSchema = require_model_charts_schema.chartSeriesSchema;
+exports.chartValueSchema = require_model_charts_schema.chartValueSchema;
+exports.chartWindowSchema = require_model_charts_schema.chartWindowSchema;
 exports.curatorNameSchema = require_model_curators_schema.curatorNameSchema;
 exports.curatorSchema = require_model_curators_schema.curatorSchema;
 exports.dataSourceSchema = require_model_response_schema.dataSourceSchema;
@@ -36,11 +52,6 @@ exports.delayedReceivedAssetSchema = require_model_liquidations_schema.delayedRe
 exports.encodeFlag = require_model_filters_schema.encodeFlag;
 exports.filterAllSchema = require_model_filters_schema.filterAllSchema;
 exports.filterable = require_model_filters_schema.filterable;
-exports.historyChartMetadataSchema = require_model_history_schema.historyChartMetadataSchema;
-exports.historyMetricSchema = require_model_history_schema.historyMetricSchema;
-exports.historyPointSchema = require_model_history_schema.historyPointSchema;
-exports.historyRangeSchema = require_model_history_schema.historyRangeSchema;
-exports.historySeriesSchema = require_model_history_schema.historySeriesSchema;
 exports.instantReceivedAssetSchema = require_model_liquidations_schema.instantReceivedAssetSchema;
 exports.isFilterSet = require_model_filters.isFilterSet;
 exports.leverageSchema = require_model_primitives_schema.leverageSchema;
@@ -53,12 +64,13 @@ exports.liquidationPositionSchema = require_model_liquidations_schema.liquidatio
 exports.matchesLiquidatableAccountFilter = require_model_liquidations.matchesLiquidatableAccountFilter;
 exports.matchesOpportunityFilter = require_model_opportunities.matchesOpportunityFilter;
 exports.matchesPositionFilter = require_model_positions.matchesPositionFilter;
+exports.noticeKindSchema = require_model_notices_schema.noticeKindSchema;
+exports.noticeSchema = require_model_notices_schema.noticeSchema;
 exports.opportunityBaseSchema = require_model_opportunities_schema.opportunityBaseSchema;
 exports.opportunityDetailSchema = require_model_opportunities_schema.opportunityDetailSchema;
 exports.opportunityFilterQueryParamsSchema = require_model_opportunities_schema.opportunityFilterQueryParamsSchema;
 exports.opportunityFilterQuerySchema = require_model_opportunities_schema.opportunityFilterQuerySchema;
 exports.opportunityFilterSchema = require_model_opportunities_schema.opportunityFilterSchema;
-exports.opportunityHistoryQuerySchema = require_model_history_schema.opportunityHistoryQuerySchema;
 exports.opportunityId = require_model_opportunities.opportunityId;
 exports.opportunityKeySchema = require_model_opportunities_schema.opportunityKeySchema;
 exports.opportunityKindSchema = require_model_opportunities_schema.opportunityKindSchema;
@@ -68,12 +80,12 @@ exports.pointRewardsSchema = require_model_opportunities_schema.pointRewardsSche
 exports.pointsProgramPnLSchema = require_model_positions_schema.pointsProgramPnLSchema;
 exports.pointsProgramSchema = require_model_opportunities_schema.pointsProgramSchema;
 exports.pointsRewardsPnLSchema = require_model_positions_schema.pointsRewardsPnLSchema;
-exports.poolHistoryMetricSchema = require_model_history_schema.poolHistoryMetricSchema;
+exports.poolOpportunityChartMetricSchema = require_model_charts_schema.poolOpportunityChartMetricSchema;
 exports.poolOpportunityDetailSchema = require_model_opportunities_schema.poolOpportunityDetailSchema;
 exports.poolOpportunityId = require_model_opportunities.poolOpportunityId;
 exports.poolOpportunityKeySchema = require_model_opportunities_schema.poolOpportunityKeySchema;
 exports.poolOpportunitySchema = require_model_opportunities_schema.poolOpportunitySchema;
-exports.poolPositionHistoryMetricSchema = require_model_history_schema.poolPositionHistoryMetricSchema;
+exports.poolPositionChartMetricSchema = require_model_charts_schema.poolPositionChartMetricSchema;
 exports.poolPositionId = require_model_positions.poolPositionId;
 exports.poolPositionKeySchema = require_model_positions_schema.poolPositionKeySchema;
 exports.poolPositionSchema = require_model_positions_schema.poolPositionSchema;
@@ -81,12 +93,13 @@ exports.positionCollateralSchema = require_model_positions_schema.positionCollat
 exports.positionFilterQueryParamsSchema = require_model_positions_schema.positionFilterQueryParamsSchema;
 exports.positionFilterQuerySchema = require_model_positions_schema.positionFilterQuerySchema;
 exports.positionFilterSchema = require_model_positions_schema.positionFilterSchema;
-exports.positionHistoryMetricSchema = require_model_history_schema.positionHistoryMetricSchema;
-exports.positionHistoryQuerySchema = require_model_history_schema.positionHistoryQuerySchema;
 exports.positionId = require_model_positions.positionId;
 exports.positionKeySchema = require_model_positions_schema.positionKeySchema;
 exports.positionKindSchema = require_model_positions_schema.positionKindSchema;
 exports.positionSchema = require_model_positions_schema.positionSchema;
+exports.positionTransactionKindSchema = require_model_positions_schema.positionTransactionKindSchema;
+exports.positionTransactionSchema = require_model_positions_schema.positionTransactionSchema;
+exports.positionsTotalsSchema = require_model_positions_schema.positionsTotalsSchema;
 exports.priceFeedDataSchema = require_model_opportunities_schema.priceFeedDataSchema;
 exports.priceFeedSummarySchema = require_model_opportunities_schema.priceFeedSummarySchema;
 exports.quotaAssetSchema = require_model_opportunities_schema.quotaAssetSchema;
@@ -97,12 +110,12 @@ exports.responseMetadataSchema = require_model_response_schema.responseMetadataS
 exports.responseSchema = require_model_response_schema.responseSchema;
 exports.rewardsPnLSchema = require_model_positions_schema.rewardsPnLSchema;
 exports.rewardsSchema = require_model_opportunities_schema.rewardsSchema;
-exports.strategyHistoryMetricSchema = require_model_history_schema.strategyHistoryMetricSchema;
+exports.strategyOpportunityChartMetricSchema = require_model_charts_schema.strategyOpportunityChartMetricSchema;
 exports.strategyOpportunityDetailSchema = require_model_opportunities_schema.strategyOpportunityDetailSchema;
 exports.strategyOpportunityId = require_model_opportunities.strategyOpportunityId;
 exports.strategyOpportunityKeySchema = require_model_opportunities_schema.strategyOpportunityKeySchema;
 exports.strategyOpportunitySchema = require_model_opportunities_schema.strategyOpportunitySchema;
-exports.strategyPositionHistoryMetricSchema = require_model_history_schema.strategyPositionHistoryMetricSchema;
+exports.strategyPositionChartMetricSchema = require_model_charts_schema.strategyPositionChartMetricSchema;
 exports.strategyPositionId = require_model_positions.strategyPositionId;
 exports.strategyPositionKeySchema = require_model_positions_schema.strategyPositionKeySchema;
 exports.strategyPositionSchema = require_model_positions_schema.strategyPositionSchema;

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

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_sdk_utils_zod = require("../sdk/utils/zod.js");
-const require_model_filters_schema = require("./filters.schema.js");
 const require_model_primitives_schema = require("./primitives.schema.js");
+const require_model_filters_schema = require("./filters.schema.js");
 let zod_v4 = require("zod/v4");
 //#region src/model/liquidations.schema.ts
 /**

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

@@ -0,0 +1,25 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_model_primitives_schema = require("./primitives.schema.js");
+let zod_v4 = require("zod/v4");
+//#region src/model/notices.schema.ts
+/**
+* {@link NoticeKind}
+**/
+const noticeKindSchema = zod_v4.z.union([
+	zod_v4.z.literal("expired"),
+	zod_v4.z.literal("externalRewards"),
+	zod_v4.z.literal("extraApy"),
+	zod_v4.z.literal("warning"),
+	zod_v4.z.literal("disclaimer")
+]);
+/**
+* {@link Notice}
+**/
+const noticeSchema = zod_v4.z.object({
+	kind: noticeKindSchema,
+	message: zod_v4.z.string(),
+	token: require_model_primitives_schema.tokenSchema.optional()
+});
+//#endregion
+exports.noticeKindSchema = noticeKindSchema;
+exports.noticeSchema = noticeSchema;

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

@@ -1,9 +1,9 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_sdk_utils_zod = require("../sdk/utils/zod.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
 /**

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

@@ -1,10 +1,10 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_sdk_utils_zod = require("../sdk/utils/zod.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
 /**
@@ -73,6 +73,15 @@ const poolPositionSchema = zod_v4.z.object({
 	pnl: pnlBreakdownSchema.optional()
 });
 /**
+* {@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.record(require_sdk_utils_zod.ZodAddress(), require_model_primitives_schema.bpsSchema)
+});
+/**
 * {@link StrategyPosition}
 **/
 const strategyPositionSchema = zod_v4.z.object({
@@ -88,6 +97,9 @@ const strategyPositionSchema = zod_v4.z.object({
 	totalDebt: require_model_primitives_schema.tokenAmountSchema,
 	totalValue: require_model_primitives_schema.tokenAmountSchema,
 	healthFactor: require_model_primitives_schema.bpsSchema,
+	borrowRate: borrowRateBreakdownSchema.optional(),
+	timeToLiquidation: require_sdk_utils_zod.ZodBigInt().nullable().optional(),
+	liquidationPrice: require_sdk_utils_zod.ZodBigInt().nullable().optional(),
 	pnl: pnlBreakdownSchema.optional(),
 	collaterals: zod_v4.z.array(positionCollateralSchema)
 });
@@ -162,7 +174,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,6 +218,9 @@ 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;

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

@@ -15,6 +15,11 @@ const require_new_sdk_positions_PositionsNamespace = require("./positions/Positi
 require("./positions/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.
@@ -54,12 +59,27 @@ var GearboxSDK = class {
 	#onchain;
 	#offchain;
 	#ownsOnchain = false;
+	#maxStateAgeSeconds;
+	#logger;
+	/**
+	* 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;
 	#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 +112,67 @@ 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);
+		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 +209,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,10 @@ 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_execute_ExecuteApi = require("./execute/ExecuteApi.js");
+require("./execute/index.js");
+const require_new_sdk_simulate_SimulateApi = require("./simulate/SimulateApi.js");
+require("./simulate/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");
@@ -20,11 +24,14 @@ 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.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.SimulateApi = require_new_sdk_simulate_SimulateApi.SimulateApi;
 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/opportunities/OpportunitiesNamespace.js

@@ -1,7 +1,13 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_model_opportunities = require("../../model/opportunities.js");
 require("../../model/index.js");
+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_execute_ExecuteApi = require("../execute/ExecuteApi.js");
+require("../execute/index.js");
+const require_new_sdk_simulate_SimulateApi = require("../simulate/SimulateApi.js");
+require("../simulate/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");
@@ -19,14 +25,33 @@ var OpportunitiesNamespace = class extends require_new_sdk_AbstractNamespace.Abs
 		pool: (onchain, offchain) => require_new_sdk_utils_mergeChains.mergeChainOne(onchain, offchain, this.maxOffchainLagSeconds),
 		strategy: (onchain, offchain) => require_new_sdk_utils_mergeChains.mergeChainOne(onchain, offchain, this.maxOffchainLagSeconds)
 	};
+	#simulate;
+	#execute;
 	constructor(onchain, offchain, options) {
 		super("Opportunities", onchain?.opportunities, offchain?.opportunities, options);
+		this.#simulate = onchain && new require_new_sdk_simulate_SimulateApi.SimulateApi(onchain, options.ensureFresh);
+		this.#execute = onchain && new require_new_sdk_execute_ExecuteApi.ExecuteApi((chainId) => onchain.chain(chainId));
+	}
+	/**
+	* {@inheritDoc OpportunitiesOnchainOnly.simulate}
+	**/
+	get simulate() {
+		if (!this.#simulate) throw new require_new_sdk_errors_SourceUnavailableError.SourceUnavailableError("Opportunities", "onchain");
+		return this.#simulate;
+	}
+	/**
+	* {@inheritDoc OpportunitiesOnchainOnly.execute}
+	**/
+	get execute() {
+		if (!this.#execute) throw new require_new_sdk_errors_SourceUnavailableError.SourceUnavailableError("Opportunities", "onchain");
+		return this.#execute;
 	}
 	/**
 	* {@inheritDoc OpportunitiesBase.list}
 	**/
 	async list(filter) {
 		return this.merged("list opportunities", {
+			chainIds: filter?.chainIds,
 			fromChain: (source) => source.list(filter),
 			fromBackend: (source) => source.list(filter),
 			merge: this.merge.list
@@ -37,6 +62,7 @@ var OpportunitiesNamespace = class extends require_new_sdk_AbstractNamespace.Abs
 	**/
 	async getPool(key) {
 		return this.merged("get pool opportunity", {
+			chainIds: [key.chainId],
 			fromChain: (source) => source.getPool(key),
 			fromBackend: (source) => source.getPool(key),
 			merge: this.merge.pool
@@ -47,6 +73,7 @@ var OpportunitiesNamespace = class extends require_new_sdk_AbstractNamespace.Abs
 	**/
 	async getStrategy(key) {
 		return this.merged("get strategy opportunity", {
+			chainIds: [key.chainId],
 			fromChain: (source) => source.getStrategy(key),
 			fromBackend: (source) => source.getStrategy(key),
 			merge: this.merge.strategy
@@ -58,12 +85,8 @@ var OpportunitiesNamespace = class extends require_new_sdk_AbstractNamespace.Abs
 	filter(response, filter) {
 		return require_new_sdk_utils_filterResponse.filterResponse(response, filter, require_model_opportunities.matchesOpportunityFilter);
 	}
-	history(key) {
-		return { chart: (metric, range) => this.offchain.getHistory({
-			opportunity: key,
-			range,
-			metric
-		}) };
+	async charts(key, metrics, range) {
+		return this.offchain.getCharts(key, metrics, range);
 	}
 };
 //#endregion