@gearbox-protocol/sdk 15.1.0-next.9 → 16.0.0-next.2

package/dist/esm/model/index.js

@@ -1,17 +1,22 @@
 import { CHART_METRIC_UNITS, CHART_RANGES, CHART_UNAVAILABLE_CODES, POOL_OPPORTUNITY_CHART_METRICS, POOL_POSITION_CHART_METRICS, STRATEGY_OPPORTUNITY_CHART_METRICS, STRATEGY_POSITION_CHART_METRICS } from "./charts.js";
+import { compareTagOf, offchainOnly, onchainOnly, tolerance } from "./compare.schema.js";
 import { amountSchema, assetTypeSchema, bpsSchema, chainIdSchema, leverageSchema, timestampSchema, tokenAmountSchema, tokenSchema, txCallSchema } from "./primitives.schema.js";
 import { chartBundleSchemaFor, chartDenominationSchema, chartMetricSchema, chartQueryCodec, chartQueryParamsSchema, chartQuerySchema, chartRangeSchema, chartSeriesSchema, chartValueSchema, chartWindowSchema, poolOpportunityChartMetricSchema, poolPositionChartMetricSchema, strategyOpportunityChartMetricSchema, strategyPositionChartMetricSchema } from "./charts.schema.js";
 import "./curators.js";
 import { curatorNameSchema, curatorSchema } from "./curators.schema.js";
+import "./delayed-intents.js";
 import { FILTER_ALL, isFilterSet } from "./filters.js";
 import { booleanParamSchema, encodeFlag, filterAllSchema, filterable } from "./filters.schema.js";
 import { matchesLiquidatableAccountFilter } from "./liquidations.js";
 import { delayedReceivedAssetSchema, instantReceivedAssetSchema, liquidatableAccountFilterSchema, liquidatableAccountSchema, liquidationApprovalSchema, liquidationDetailsSchema, liquidationPositionSchema, receivedAssetSchema } from "./liquidations.schema.js";
+import "./notices.js";
+import { noticeKindSchema, noticeSchema } from "./notices.schema.js";
 import { matchesOpportunityFilter, opportunityId, poolOpportunityId, strategyOpportunityId } from "./opportunities.js";
 import { apyBreakdownSchema, opportunityBaseSchema, opportunityDetailSchema, opportunityFilterQueryParamsSchema, opportunityFilterQuerySchema, opportunityFilterSchema, opportunityKeySchema, opportunityKindSchema, opportunitySchema, pointRewardsSchema, pointsProgramSchema, poolOpportunityDetailSchema, poolOpportunityKeySchema, poolOpportunitySchema, priceFeedDataSchema, priceFeedSummarySchema, quotaAssetSchema, rateCurvePointSchema, rateCurveSchema, rewardsSchema, strategyOpportunityDetailSchema, strategyOpportunityKeySchema, strategyOpportunitySchema, tokenRewardsSchema } from "./opportunities.schema.js";
 import { liquidationPositionId, matchesPositionFilter, poolPositionId, positionId, strategyPositionId } from "./positions.js";
-import { borrowRateBreakdownSchema, pnlBreakdownSchema, pointsProgramPnLSchema, pointsRewardsPnLSchema, poolPositionKeySchema, poolPositionSchema, positionCollateralSchema, positionFilterQueryParamsSchema, positionFilterQuerySchema, positionFilterSchema, positionKeySchema, positionKindSchema, positionSchema, rewardsPnLSchema, strategyPositionKeySchema, strategyPositionSchema, tokenRewardsPnLSchema } from "./positions.schema.js";
+import { borrowRateBreakdownSchema, pnlBreakdownSchema, pointsProgramPnLSchema, pointsRewardsPnLSchema, poolPositionKeySchema, poolPositionSchema, positionCollateralSchema, positionFilterQueryParamsSchema, positionFilterQuerySchema, positionFilterSchema, positionKeySchema, positionKindSchema, positionSchema, positionTransactionKindSchema, positionTransactionSchema, positionsTotalsSchema, rewardsPnLSchema, strategyPositionKeySchema, strategyPositionSchema, tokenQuotaRateSchema, tokenRewardsPnLSchema } from "./positions.schema.js";
+import { ERROR_ADAPTER_CALL_OUTSIDE_BRACKET, ERROR_INVALID_TRANSACTION_VALUE, ERROR_MALFORMED_BRACKET, ERROR_NON_ADAPTER_CALL_IN_BRACKET, ERROR_UNPREVIEWABLE_ADAPTER_CALL, ERROR_UNPREVIEWABLE_RWA_WRAP_UNWRAP, ERROR_UNPRICEABLE_TOKEN } from "./previews.js";
 import "./primitives.js";
 import "./response.js";
 import { chainFailedSchema, chainMetadataSchema, chainSucceededSchema, dataSourceSchema, responseMetadataSchema, responseSchema } from "./response.schema.js";
-export { CHART_METRIC_UNITS, CHART_RANGES, CHART_UNAVAILABLE_CODES, FILTER_ALL, POOL_OPPORTUNITY_CHART_METRICS, POOL_POSITION_CHART_METRICS, STRATEGY_OPPORTUNITY_CHART_METRICS, STRATEGY_POSITION_CHART_METRICS, amountSchema, apyBreakdownSchema, assetTypeSchema, booleanParamSchema, borrowRateBreakdownSchema, bpsSchema, chainFailedSchema, chainIdSchema, chainMetadataSchema, chainSucceededSchema, chartBundleSchemaFor, chartDenominationSchema, chartMetricSchema, chartQueryCodec, chartQueryParamsSchema, chartQuerySchema, chartRangeSchema, chartSeriesSchema, chartValueSchema, chartWindowSchema, curatorNameSchema, curatorSchema, dataSourceSchema, delayedReceivedAssetSchema, encodeFlag, filterAllSchema, filterable, instantReceivedAssetSchema, isFilterSet, leverageSchema, liquidatableAccountFilterSchema, liquidatableAccountSchema, liquidationApprovalSchema, liquidationDetailsSchema, liquidationPositionId, liquidationPositionSchema, matchesLiquidatableAccountFilter, matchesOpportunityFilter, matchesPositionFilter, opportunityBaseSchema, opportunityDetailSchema, opportunityFilterQueryParamsSchema, opportunityFilterQuerySchema, opportunityFilterSchema, opportunityId, opportunityKeySchema, opportunityKindSchema, opportunitySchema, pnlBreakdownSchema, pointRewardsSchema, pointsProgramPnLSchema, pointsProgramSchema, pointsRewardsPnLSchema, poolOpportunityChartMetricSchema, poolOpportunityDetailSchema, poolOpportunityId, poolOpportunityKeySchema, poolOpportunitySchema, poolPositionChartMetricSchema, poolPositionId, poolPositionKeySchema, poolPositionSchema, positionCollateralSchema, positionFilterQueryParamsSchema, positionFilterQuerySchema, positionFilterSchema, positionId, positionKeySchema, positionKindSchema, positionSchema, priceFeedDataSchema, priceFeedSummarySchema, quotaAssetSchema, rateCurvePointSchema, rateCurveSchema, receivedAssetSchema, responseMetadataSchema, responseSchema, rewardsPnLSchema, rewardsSchema, strategyOpportunityChartMetricSchema, strategyOpportunityDetailSchema, strategyOpportunityId, strategyOpportunityKeySchema, strategyOpportunitySchema, strategyPositionChartMetricSchema, strategyPositionId, strategyPositionKeySchema, strategyPositionSchema, timestampSchema, tokenAmountSchema, tokenRewardsPnLSchema, tokenRewardsSchema, tokenSchema, txCallSchema };
+export { CHART_METRIC_UNITS, CHART_RANGES, CHART_UNAVAILABLE_CODES, ERROR_ADAPTER_CALL_OUTSIDE_BRACKET, ERROR_INVALID_TRANSACTION_VALUE, ERROR_MALFORMED_BRACKET, ERROR_NON_ADAPTER_CALL_IN_BRACKET, ERROR_UNPREVIEWABLE_ADAPTER_CALL, ERROR_UNPREVIEWABLE_RWA_WRAP_UNWRAP, ERROR_UNPRICEABLE_TOKEN, FILTER_ALL, POOL_OPPORTUNITY_CHART_METRICS, POOL_POSITION_CHART_METRICS, STRATEGY_OPPORTUNITY_CHART_METRICS, STRATEGY_POSITION_CHART_METRICS, amountSchema, apyBreakdownSchema, assetTypeSchema, booleanParamSchema, borrowRateBreakdownSchema, bpsSchema, chainFailedSchema, chainIdSchema, chainMetadataSchema, chainSucceededSchema, chartBundleSchemaFor, chartDenominationSchema, chartMetricSchema, chartQueryCodec, chartQueryParamsSchema, chartQuerySchema, chartRangeSchema, chartSeriesSchema, chartValueSchema, chartWindowSchema, compareTagOf, curatorNameSchema, curatorSchema, dataSourceSchema, delayedReceivedAssetSchema, encodeFlag, filterAllSchema, filterable, instantReceivedAssetSchema, isFilterSet, leverageSchema, liquidatableAccountFilterSchema, liquidatableAccountSchema, liquidationApprovalSchema, liquidationDetailsSchema, liquidationPositionId, liquidationPositionSchema, matchesLiquidatableAccountFilter, matchesOpportunityFilter, matchesPositionFilter, noticeKindSchema, noticeSchema, offchainOnly, onchainOnly, opportunityBaseSchema, opportunityDetailSchema, opportunityFilterQueryParamsSchema, opportunityFilterQuerySchema, opportunityFilterSchema, opportunityId, opportunityKeySchema, opportunityKindSchema, opportunitySchema, pnlBreakdownSchema, pointRewardsSchema, pointsProgramPnLSchema, pointsProgramSchema, pointsRewardsPnLSchema, poolOpportunityChartMetricSchema, poolOpportunityDetailSchema, poolOpportunityId, poolOpportunityKeySchema, poolOpportunitySchema, poolPositionChartMetricSchema, poolPositionId, poolPositionKeySchema, poolPositionSchema, positionCollateralSchema, positionFilterQueryParamsSchema, positionFilterQuerySchema, positionFilterSchema, positionId, positionKeySchema, positionKindSchema, positionSchema, positionTransactionKindSchema, positionTransactionSchema, positionsTotalsSchema, priceFeedDataSchema, priceFeedSummarySchema, quotaAssetSchema, rateCurvePointSchema, rateCurveSchema, receivedAssetSchema, responseMetadataSchema, responseSchema, rewardsPnLSchema, rewardsSchema, strategyOpportunityChartMetricSchema, strategyOpportunityDetailSchema, strategyOpportunityId, strategyOpportunityKeySchema, strategyOpportunitySchema, strategyPositionChartMetricSchema, strategyPositionId, strategyPositionKeySchema, strategyPositionSchema, timestampSchema, tokenAmountSchema, tokenQuotaRateSchema, tokenRewardsPnLSchema, tokenRewardsSchema, tokenSchema, tolerance, txCallSchema };

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

@@ -0,0 +1,23 @@
+import { tokenSchema } from "./primitives.schema.js";
+import { z } from "zod/v4";
+//#region src/model/notices.schema.ts
+/**
+* {@link NoticeKind}
+**/
+const noticeKindSchema = z.union([
+	z.literal("expired"),
+	z.literal("externalRewards"),
+	z.literal("extraApy"),
+	z.literal("warning"),
+	z.literal("disclaimer")
+]);
+/**
+* {@link Notice}
+**/
+const noticeSchema = z.object({
+	kind: noticeKindSchema,
+	message: z.string(),
+	token: tokenSchema.optional()
+});
+//#endregion
+export { noticeKindSchema, noticeSchema };

package/dist/esm/model/opportunities.js

@@ -16,17 +16,17 @@ function poolOpportunityId(chainId, pool) {
 *
 * @example
 * ```ts
-* strategyOpportunityId(1, "0x3eb9...", "0x7f39...") // "1:0x3eb9...:0x7f39..."
+* strategyOpportunityId(1, "0x3eb9...") // "1:0x3eb9..."
 * ```
 **/
-function strategyOpportunityId(chainId, creditManager, targetCollateral) {
-	return `${chainId}:${creditManager.toLowerCase()}:${targetCollateral.toLowerCase()}`;
+function strategyOpportunityId(chainId, creditManager) {
+	return `${chainId}:${creditManager.toLowerCase()}`;
 }
 /**
 * Canonical id of any opportunity, dispatching on {@link Opportunity.kind}.
 **/
 function opportunityId(opportunity) {
-	return opportunity.kind === "pool" ? poolOpportunityId(opportunity.chainId, opportunity.pool) : strategyOpportunityId(opportunity.chainId, opportunity.creditManager, opportunity.targetCollateral.address);
+	return opportunity.kind === "pool" ? poolOpportunityId(opportunity.chainId, opportunity.pool) : strategyOpportunityId(opportunity.chainId, opportunity.creditManager);
 }
 /**
 * Whether an opportunity satisfies every condition of a filter.

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

@@ -1,4 +1,5 @@
 import { ZodAddress } from "../sdk/utils/zod.js";
+import { offchainOnly, tolerance } from "./compare.schema.js";
 import { amountSchema, assetTypeSchema, bpsSchema, chainIdSchema, leverageSchema, timestampSchema, tokenSchema } from "./primitives.schema.js";
 import { curatorSchema } from "./curators.schema.js";
 import { isFilterSet } from "./filters.js";
@@ -45,9 +46,9 @@ const rewardsSchema = z.discriminatedUnion("kind", [tokenRewardsSchema, pointRew
 * {@link ApyBreakdown}
 **/
 const apyBreakdownSchema = z.object({
-	totalApy: bpsSchema.optional(),
-	organicApy: bpsSchema,
-	rewards: z.array(rewardsSchema).optional()
+	totalApy: offchainOnly(bpsSchema).optional(),
+	organicApy: tolerance(bpsSchema, "bps"),
+	rewards: offchainOnly(z.array(rewardsSchema)).optional()
 });
 /**
 * {@link OpportunityBase}
@@ -64,16 +65,29 @@ const opportunityBaseSchema = z.object({
 	sunset: z.boolean()
 });
 /**
+* {@link QuotaAsset}
+**/
+const quotaAssetSchema = z.object({
+	token: tokenSchema,
+	quotaRate: tolerance(bpsSchema, "bps"),
+	limit: amountSchema,
+	used: tolerance(amountSchema, "amount"),
+	allocationShare: tolerance(bpsSchema, "bps"),
+	allocatedDebt: tolerance(amountSchema, "amount")
+});
+/**
 * {@link PoolOpportunity}
 **/
 const poolOpportunitySchema = z.object({
 	...opportunityBaseSchema.shape,
 	kind: z.literal("pool"),
 	pool: ZodAddress(),
-	totalSupply: amountSchema,
-	availableLiquidity: amountSchema,
-	utilization: bpsSchema,
-	supplyApy: apyBreakdownSchema
+	totalSupply: tolerance(amountSchema, "amount"),
+	availableLiquidity: tolerance(amountSchema, "amount"),
+	utilization: tolerance(bpsSchema, "bps"),
+	supplyApy: apyBreakdownSchema,
+	supplyApyAvg7D: offchainOnly(apyBreakdownSchema).optional(),
+	quotaAssets: z.array(quotaAssetSchema)
 });
 /**
 * {@link StrategyOpportunity}
@@ -87,13 +101,18 @@ const strategyOpportunitySchema = z.object({
 	liquidationPremium: bpsSchema,
 	liquidationFee: bpsSchema,
 	expirationDate: timestampSchema.nullable(),
-	collateralApy: apyBreakdownSchema.optional(),
-	maxLeverageApy: apyBreakdownSchema.optional(),
-	borrowApy: bpsSchema.optional(),
-	additionalBorrowApy: bpsSchema.optional(),
-	totalValue: amountSchema.optional(),
-	utilization: bpsSchema.optional(),
-	maxBorrowAmount: amountSchema,
+	collateralApy: offchainOnly(apyBreakdownSchema).optional(),
+	collateralApyAvg7D: offchainOnly(apyBreakdownSchema).optional(),
+	borrowApy: tolerance(bpsSchema, "bps"),
+	borrowApyAvg7D: offchainOnly(bpsSchema).optional(),
+	quotaRate: tolerance(bpsSchema, "bps"),
+	quotaRateAvg7D: offchainOnly(bpsSchema).optional(),
+	totalValue: offchainOnly(amountSchema).optional(),
+	utilization: offchainOnly(bpsSchema).optional(),
+	availableLiquidity: tolerance(amountSchema, "amount"),
+	minDebt: amountSchema,
+	totalDebtLimit: amountSchema,
+	maxBorrowAmount: tolerance(amountSchema, "amount"),
 	maxLeverage: leverageSchema
 });
 /**
@@ -162,15 +181,6 @@ const rateCurveSchema = z.object({
 	borrowingLimitUtilization: bpsSchema.nullable()
 });
 /**
-* {@link QuotaAsset}
-**/
-const quotaAssetSchema = z.object({
-	token: tokenSchema,
-	quotaRate: bpsSchema,
-	limit: amountSchema,
-	used: amountSchema
-});
-/**
 * {@link PriceFeedData}. Recursive: a composite feed lists the feeds it reads.
 **/
 const priceFeedDataSchema = z.object({
@@ -196,8 +206,7 @@ const priceFeedSummarySchema = z.object({
 **/
 const poolOpportunityDetailSchema = z.object({
 	...poolOpportunitySchema.shape,
-	rateCurve: rateCurveSchema,
-	quotaAssets: z.array(quotaAssetSchema)
+	rateCurve: rateCurveSchema
 });
 /**
 * {@link StrategyOpportunityDetail}
@@ -223,8 +232,7 @@ const poolOpportunityKeySchema = z.object({
 **/
 const strategyOpportunityKeySchema = z.object({
 	chainId: chainIdSchema,
-	creditManager: ZodAddress(),
-	targetCollateral: ZodAddress()
+	creditManager: ZodAddress()
 });
 /**
 * {@link OpportunityKey}

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

@@ -1,5 +1,6 @@
-import { ZodAddress, ZodBigInt } from "../sdk/utils/zod.js";
-import { assetTypeSchema, bpsSchema, chainIdSchema, leverageSchema, tokenAmountSchema, tokenSchema } from "./primitives.schema.js";
+import { ZodAddress, ZodBigInt, ZodHex } from "../sdk/utils/zod.js";
+import { offchainOnly, onchainOnly, tolerance } from "./compare.schema.js";
+import { assetTypeSchema, bpsSchema, chainIdSchema, leverageSchema, timestampSchema, tokenAmountSchema, tokenSchema } from "./primitives.schema.js";
 import { isFilterSet } from "./filters.js";
 import { booleanParamSchema, encodeFlag, filterable } from "./filters.schema.js";
 import { delayedReceivedAssetSchema, liquidationPositionSchema } from "./liquidations.schema.js";
@@ -55,8 +56,8 @@ const pnlBreakdownSchema = z.object({
 * {@link PositionCollateral}
 **/
 const positionCollateralSchema = z.object({
-	collateral: tokenAmountSchema,
-	quota: tokenAmountSchema,
+	collateral: tolerance(tokenAmountSchema, "amount"),
+	quota: tolerance(tokenAmountSchema, "amount"),
 	withdrawals: z.array(delayedReceivedAssetSchema)
 });
 /**
@@ -67,9 +68,17 @@ const poolPositionSchema = z.object({
 	name: z.string(),
 	chainId: chainIdSchema,
 	pool: ZodAddress(),
-	netValue: tokenAmountSchema,
+	netValue: tolerance(tokenAmountSchema, "amount"),
 	apy: apyBreakdownSchema,
-	pnl: pnlBreakdownSchema.optional()
+	apyAvg7D: offchainOnly(apyBreakdownSchema).optional(),
+	pnl: offchainOnly(pnlBreakdownSchema).optional()
+});
+/**
+* {@link TokenQuotaRate}
+**/
+const tokenQuotaRateSchema = z.object({
+	token: tokenSchema,
+	rate: bpsSchema
 });
 /**
 * {@link BorrowRateBreakdown}
@@ -78,7 +87,7 @@ const borrowRateBreakdownSchema = z.object({
 	total: bpsSchema,
 	totalOnDebt: bpsSchema,
 	base: bpsSchema,
-	quotas: z.record(ZodAddress(), bpsSchema)
+	quotas: z.array(tokenQuotaRateSchema)
 });
 /**
 * {@link StrategyPosition}
@@ -90,16 +99,19 @@ const strategyPositionSchema = z.object({
 	creditManager: ZodAddress(),
 	creditAccount: ZodAddress(),
 	targetCollateral: tokenSchema.nullable(),
-	leverage: leverageSchema,
-	borrowApy: bpsSchema,
-	netApy: apyBreakdownSchema.optional(),
-	totalDebt: tokenAmountSchema,
-	totalValue: tokenAmountSchema,
-	healthFactor: bpsSchema,
-	borrowRate: borrowRateBreakdownSchema.optional(),
-	timeToLiquidation: ZodBigInt().nullable().optional(),
-	liquidationPrice: ZodBigInt().nullable().optional(),
-	pnl: pnlBreakdownSchema.optional(),
+	leverage: tolerance(leverageSchema, "float"),
+	borrowApy: tolerance(bpsSchema, "bps"),
+	borrowApyAvg7D: offchainOnly(bpsSchema).optional(),
+	netApy: offchainOnly(apyBreakdownSchema).optional(),
+	netApyAvg7D: offchainOnly(apyBreakdownSchema).optional(),
+	totalDebt: tolerance(tokenAmountSchema, "amount"),
+	totalValue: tolerance(tokenAmountSchema, "amount"),
+	healthFactor: tolerance(bpsSchema, "bps"),
+	borrowRate: onchainOnly(borrowRateBreakdownSchema).optional(),
+	borrowRateAvg7D: offchainOnly(borrowRateBreakdownSchema).optional(),
+	timeToLiquidation: onchainOnly(ZodBigInt().nullable()).optional(),
+	liquidationPrice: onchainOnly(ZodBigInt().nullable()).optional(),
+	pnl: offchainOnly(pnlBreakdownSchema).optional(),
 	collaterals: z.array(positionCollateralSchema)
 });
 /**
@@ -173,5 +185,35 @@ const positionKeySchema = z.discriminatedUnion("kind", [z.object({
 	kind: z.literal("strategy"),
 	...strategyPositionKeySchema.shape
 })]);
+/**
+* {@link PositionsTotals}
+**/
+const positionsTotalsSchema = z.object({
+	currentYield: apyBreakdownSchema.nullable(),
+	pnl: pnlBreakdownSchema.nullable(),
+	netValueUsd: z.number().nullable(),
+	claimableUsd: z.number().nullable()
+});
+/**
+* {@link PositionTransactionKind}
+**/
+const positionTransactionKindSchema = z.union([
+	z.literal("open"),
+	z.literal("deposit"),
+	z.literal("withdraw"),
+	z.literal("adjustLeverage"),
+	z.literal("addCollateral"),
+	z.literal("withdrawCollateral"),
+	z.literal("liquidation")
+]);
+/**
+* {@link PositionTransaction}
+**/
+const positionTransactionSchema = z.object({
+	txHash: ZodHex(),
+	timestamp: timestampSchema,
+	kind: positionTransactionKindSchema,
+	assets: z.array(tokenAmountSchema)
+});
 //#endregion
-export { borrowRateBreakdownSchema, pnlBreakdownSchema, pointsProgramPnLSchema, pointsRewardsPnLSchema, poolPositionKeySchema, poolPositionSchema, positionCollateralSchema, positionFilterQueryParamsSchema, positionFilterQuerySchema, positionFilterSchema, positionKeySchema, positionKindSchema, positionSchema, rewardsPnLSchema, strategyPositionKeySchema, strategyPositionSchema, tokenRewardsPnLSchema };
+export { borrowRateBreakdownSchema, pnlBreakdownSchema, pointsProgramPnLSchema, pointsRewardsPnLSchema, poolPositionKeySchema, poolPositionSchema, positionCollateralSchema, positionFilterQueryParamsSchema, positionFilterQuerySchema, positionFilterSchema, positionKeySchema, positionKindSchema, positionSchema, positionTransactionKindSchema, positionTransactionSchema, positionsTotalsSchema, rewardsPnLSchema, strategyPositionKeySchema, strategyPositionSchema, tokenQuotaRateSchema, tokenRewardsPnLSchema };

package/dist/esm/model/previews.js

@@ -0,0 +1,35 @@
+//#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
+export { ERROR_ADAPTER_CALL_OUTSIDE_BRACKET, ERROR_INVALID_TRANSACTION_VALUE, ERROR_MALFORMED_BRACKET, ERROR_NON_ADAPTER_CALL_IN_BRACKET, ERROR_UNPREVIEWABLE_ADAPTER_CALL, ERROR_UNPREVIEWABLE_RWA_WRAP_UNWRAP, ERROR_UNPRICEABLE_TOKEN };

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

@@ -1,4 +1,5 @@
 import { ZodAddress, ZodBigInt, ZodHex } from "../sdk/utils/zod.js";
+import { tolerance } from "./compare.schema.js";
 import { z } from "zod/v4";
 //#region src/model/primitives.schema.ts
 /**
@@ -39,7 +40,7 @@ const leverageSchema = z.number().nonnegative();
 **/
 const amountSchema = z.object({
 	value: ZodBigInt(),
-	valueUsd: z.number().nullable()
+	valueUsd: tolerance(z.number().nullable(), "usd")
 });
 /**
 * {@link Token}

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

@@ -17,23 +17,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 SourceUnavailableError(this.#name, "onchain");
-		return this.#onchain;
+		if (!this.#onchainView) throw new SourceUnavailableError(this.#name, "onchain");
+		return this.#onchainView;
 	}
 	/**
 	* The backend source namespace on its own. Throws
@@ -50,7 +61,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 && !everyChainFailed(merged.meta)) return merged;
 		const sole = onchain && offchain ? void 0 : fromChain.error ?? fromBackend.error;
@@ -71,5 +85,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
 export { AbstractNamespace };

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

@@ -6,14 +6,23 @@ import { MissingSourceError } from "./errors/MissingSourceError.js";
 import "./errors/index.js";
 import { GearboxAPI } from "../offchain/GearboxAPI.js";
 import "../offchain/index.js";
+import { LiquidationsNamespace } from "./liquidations/LiquidationsNamespace.js";
+import "./liquidations/index.js";
 import "./utils/mergeChains.js";
 import "./utils/index.js";
 import { OpportunitiesNamespace } from "./opportunities/OpportunitiesNamespace.js";
 import "./opportunities/index.js";
 import { PositionsNamespace } from "./positions/PositionsNamespace.js";
 import "./positions/index.js";
+import { PreviewNamespace } from "./preview/PreviewNamespace.js";
+import "./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.
@@ -49,16 +58,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 MissingSourceError(mode, "onchain");
@@ -91,19 +127,69 @@ var GearboxSDK = class {
 		this.#attached = !this.#ownsOnchain;
 		const namespaceOptions = {
 			maxOffchainLagSeconds,
+			ensureFresh: this.#onchain ? (chainIds) => this.#ensureFresh(chainIds) : void 0,
 			logger
 		};
 		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;
+		this.preview = this.#onchain ? new 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
@@ -140,4 +226,4 @@ function chainsOf(configured, networks) {
 	return chains;
 }
 //#endregion
-export { GearboxSDK };
+export { DEFAULT_MAX_STATE_AGE, GearboxSDK };