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

package/dist/esm/dev/mode-parity/scriptUtils.js

@@ -0,0 +1,121 @@
+import { getAlchemyUrl } from "../providers.js";
+import { pino } from "pino";
+//#region src/dev/mode-parity/scriptUtils.ts
+const NETWORKS = [
+	"Mainnet",
+	"Monad",
+	"Plasma",
+	"Somnia",
+	"Etherlink"
+];
+const BACKEND_URL = process.env.BACKEND_URL ?? "https://api.gear-dev.dev";
+const TIMEOUT = 48e4;
+function requireEnv(name) {
+	const value = process.env[name];
+	if (!value) throw new Error(`${name} is required to reach the chains this script reads`);
+	return value;
+}
+function rpcUrls() {
+	const alchemyKey = requireEnv("ALCHEMY_KEY");
+	const alchemy = (network) => {
+		const url = getAlchemyUrl(network, alchemyKey);
+		if (!url) throw new Error(`Alchemy serves no URL for ${network}`);
+		return url;
+	};
+	return {
+		Mainnet: alchemy("Mainnet"),
+		Monad: alchemy("Monad"),
+		Plasma: alchemy("Plasma"),
+		Somnia: requireEnv("SOMNIA_PROVIDER"),
+		Etherlink: requireEnv("ETHERLINK_PROVIDER")
+	};
+}
+function createLogger() {
+	return pino({
+		level: process.env.LOG_LEVEL ?? "info",
+		formatters: {
+			bindings: () => ({}),
+			level: (label) => ({ level: label })
+		}
+	});
+}
+function errorMessage(error) {
+	return error instanceof Error ? error.message : String(error);
+}
+/**
+* Runs `fn` over `items` with at most `concurrency` in flight.
+**/
+async function mapPool(items, concurrency, fn) {
+	let next = 0;
+	const workers = Array.from({ length: Math.min(concurrency, items.length) }, async () => {
+		while (true) {
+			const index = next;
+			next += 1;
+			if (index >= items.length) return;
+			await fn(items[index]);
+		}
+	});
+	await Promise.all(workers);
+}
+/**
+* Formats a relative difference in bps as a percent, e.g. 12.5 → `"0.125%"`.
+**/
+function formatBpsAsPercent(bps) {
+	if (!Number.isFinite(bps)) return "";
+	const percent = bps / 100;
+	if (percent === 0) return "0%";
+	return `${Math.abs(percent) >= 1 ? trimTrailingZeros(percent.toFixed(3)) : trimTrailingZeros(percent.toPrecision(4))}%`;
+}
+function trimTrailingZeros(value) {
+	return value.includes(".") ? value.replace(/\.?0+$/, "") : value;
+}
+function worstColumns(worst) {
+	return {
+		"max diff": worst ? formatBpsAsPercent(worst.bps) : "",
+		"worst entity": worst?.id ?? ""
+	};
+}
+/**
+* Prints the shared membership table, the fields that differed most often,
+* and any chain that failed to answer.
+**/
+function printCompareSummary(noun, report, extraLines = []) {
+	const { summary } = report;
+	console.log(`\n${noun} from ${report.backendUrl} vs the chain`);
+	console.table(summary.byChain.map((chain) => ({
+		chain: chain.chainId,
+		onchain: chain.onchainRows,
+		offchain: chain.offchainRows,
+		matched: chain.matched,
+		identical: chain.identical,
+		clean: chain.clean,
+		differing: chain.differing,
+		"only onchain": chain.onlyOnchain,
+		"only offchain": chain.onlyOffchain
+	})));
+	for (const line of extraLines) console.log(line);
+	const unexpected = summary.diffsByPath.filter((entry) => entry.unexpected > 0);
+	const expected = summary.diffsByPath.filter((entry) => entry.unexpected === 0 && entry.expected > 0);
+	if (unexpected.length) {
+		console.log("\nunexpected fields that differed most often:");
+		console.table(unexpected.slice(0, 25).map((entry) => ({
+			field: entry.path,
+			unexpected: entry.unexpected,
+			expected: entry.expected,
+			kinds: entry.kinds.join(", "),
+			...worstColumns(entry.worstUnexpected)
+		})));
+	}
+	if (expected.length) {
+		console.log("\nexpected fields (mode-scoped or within tolerance):");
+		console.table(expected.slice(0, 25).map((entry) => ({
+			field: entry.path,
+			rows: entry.expected,
+			kinds: entry.kinds.join(", "),
+			...worstColumns(entry.worstExpected)
+		})));
+	}
+	for (const chain of [...report.onchainChains, ...report.offchainChains]) if (chain.status === "error") console.log(`chain ${chain.chainId} failed on ${chain.source}:`, chain.error);
+}
+//#endregion
+export { BACKEND_URL, NETWORKS, TIMEOUT, createLogger, errorMessage, formatBpsAsPercent, mapPool, printCompareSummary, requireEnv, rpcUrls };

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

@@ -0,0 +1,29 @@
+//#region src/model/compare.schema.ts
+/**
+* Marks a field that only the backend fills.
+**/
+function offchainOnly(schema) {
+	return schema.meta({ compare: "offchainOnly" });
+}
+/**
+* Marks a field that only the chain fills.
+**/
+function onchainOnly(schema) {
+	return schema.meta({ compare: "onchainOnly" });
+}
+/**
+* Marks a numeric field whose two sources may drift within {@link kind}.
+**/
+function tolerance(schema, kind) {
+	return schema.meta({ compare: { tolerance: kind } });
+}
+/**
+* The compare tag registered on a schema, if any.
+**/
+function compareTagOf(schema) {
+	const meta = schema.meta();
+	if (!meta || !("compare" in meta)) return;
+	return meta.compare;
+}
+//#endregion
+export { compareTagOf, offchainOnly, onchainOnly, tolerance };

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

@@ -1,4 +1,5 @@
 import { ZodAddress } from "../sdk/utils/zod.js";
+import { offchainOnly } from "./compare.schema.js";
 import { z } from "zod/v4";
 //#region src/model/curators.schema.ts
 /**
@@ -30,7 +31,7 @@ const curatorNameSchema = z.enum([
 const curatorSchema = z.object({
 	address: ZodAddress(),
 	name: curatorNameSchema.optional(),
-	url: z.string().nullable()
+	url: offchainOnly(z.string().nullable())
 });
 //#endregion
 export { curatorNameSchema, curatorSchema };

package/dist/esm/model/index.js

@@ -1,4 +1,5 @@
 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";
@@ -16,4 +17,4 @@ import { borrowRateBreakdownSchema, pnlBreakdownSchema, pointsProgramPnLSchema,
 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, noticeKindSchema, noticeSchema, 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, tokenRewardsPnLSchema, tokenRewardsSchema, tokenSchema, txCallSchema };
+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, 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, tokenRewardsPnLSchema, tokenRewardsSchema, tokenSchema, tolerance, txCallSchema };

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}
@@ -70,9 +71,9 @@ const poolOpportunitySchema = z.object({
 	...opportunityBaseSchema.shape,
 	kind: z.literal("pool"),
 	pool: ZodAddress(),
-	totalSupply: amountSchema,
-	availableLiquidity: amountSchema,
-	utilization: bpsSchema,
+	totalSupply: tolerance(amountSchema, "amount"),
+	availableLiquidity: tolerance(amountSchema, "amount"),
+	utilization: tolerance(bpsSchema, "bps"),
 	supplyApy: apyBreakdownSchema
 });
 /**
@@ -87,12 +88,12 @@ 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(),
+	collateralApy: offchainOnly(apyBreakdownSchema).optional(),
+	maxLeverageApy: offchainOnly(apyBreakdownSchema).optional(),
+	borrowApy: tolerance(bpsSchema, "bps").optional(),
+	additionalBorrowApy: tolerance(bpsSchema, "bps").optional(),
+	totalValue: offchainOnly(amountSchema).optional(),
+	utilization: offchainOnly(bpsSchema).optional(),
 	maxBorrowAmount: amountSchema,
 	maxLeverage: leverageSchema
 });

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

@@ -1,4 +1,5 @@
 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";
@@ -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,9 @@ const poolPositionSchema = z.object({
 	name: z.string(),
 	chainId: chainIdSchema,
 	pool: ZodAddress(),
-	netValue: tokenAmountSchema,
+	netValue: tolerance(tokenAmountSchema, "amount"),
 	apy: apyBreakdownSchema,
-	pnl: pnlBreakdownSchema.optional()
+	pnl: offchainOnly(pnlBreakdownSchema).optional()
 });
 /**
 * {@link BorrowRateBreakdown}
@@ -90,16 +91,16 @@ 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"),
+	netApy: offchainOnly(apyBreakdownSchema).optional(),
+	totalDebt: tolerance(tokenAmountSchema, "amount"),
+	totalValue: tolerance(tokenAmountSchema, "amount"),
+	healthFactor: tolerance(bpsSchema, "bps"),
+	borrowRate: onchainOnly(borrowRateBreakdownSchema).optional(),
+	timeToLiquidation: onchainOnly(ZodBigInt().nullable()).optional(),
+	liquidationPrice: onchainOnly(ZodBigInt().nullable()).optional(),
+	pnl: offchainOnly(pnlBreakdownSchema).optional(),
 	collaterals: z.array(positionCollateralSchema)
 });
 /**

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/index.js

@@ -9,8 +9,8 @@ import "./errors/index.js";
 import { AbstractNamespace } from "./AbstractNamespace.js";
 import { ExecuteApi } from "./execute/ExecuteApi.js";
 import "./execute/index.js";
-import { SimulateApi } from "./simulate/SimulateApi.js";
-import "./simulate/index.js";
+import { PrepareApi } from "./prepare/PrepareApi.js";
+import "./prepare/index.js";
 import { filterResponse } from "./utils/filterResponse.js";
 import { DEFAULT_MAX_OFFCHAIN_LAG, mergeChainList, mergeChainOne } from "./utils/mergeChains.js";
 import "./utils/index.js";
@@ -20,4 +20,4 @@ import { PositionsNamespace } from "./positions/PositionsNamespace.js";
 import "./positions/index.js";
 import { DEFAULT_MAX_STATE_AGE, GearboxSDK } from "./GearboxSDK.js";
 import "./types.js";
-export { AbstractNamespace, AllSourcesFailedError, DEFAULT_MAX_OFFCHAIN_LAG, DEFAULT_MAX_STATE_AGE, ExecuteApi, GearboxSDK, MissingSourceError, NoSourceServedError, OpportunitiesNamespace, PositionsNamespace, SimulateApi, SourceChainMismatchError, SourceUnavailableError, assertSameChains, everyChainFailed, filterResponse, mergeChainList, mergeChainOne };
+export { AbstractNamespace, AllSourcesFailedError, DEFAULT_MAX_OFFCHAIN_LAG, DEFAULT_MAX_STATE_AGE, ExecuteApi, GearboxSDK, MissingSourceError, NoSourceServedError, OpportunitiesNamespace, PositionsNamespace, PrepareApi, SourceChainMismatchError, SourceUnavailableError, assertSameChains, everyChainFailed, filterResponse, mergeChainList, mergeChainOne };

package/dist/esm/new-sdk/opportunities/OpportunitiesNamespace.js

@@ -5,8 +5,8 @@ import "../errors/index.js";
 import { AbstractNamespace } from "../AbstractNamespace.js";
 import { ExecuteApi } from "../execute/ExecuteApi.js";
 import "../execute/index.js";
-import { SimulateApi } from "../simulate/SimulateApi.js";
-import "../simulate/index.js";
+import { PrepareApi } from "../prepare/PrepareApi.js";
+import "../prepare/index.js";
 import { filterResponse } from "../utils/filterResponse.js";
 import { mergeChainList, mergeChainOne } from "../utils/mergeChains.js";
 import "../utils/index.js";
@@ -24,19 +24,19 @@ var OpportunitiesNamespace = class extends AbstractNamespace {
 		pool: (onchain, offchain) => mergeChainOne(onchain, offchain, this.maxOffchainLagSeconds),
 		strategy: (onchain, offchain) => mergeChainOne(onchain, offchain, this.maxOffchainLagSeconds)
 	};
-	#simulate;
+	#prepare;
 	#execute;
 	constructor(onchain, offchain, options) {
 		super("Opportunities", onchain?.opportunities, offchain?.opportunities, options);
-		this.#simulate = onchain && new SimulateApi(onchain, options.ensureFresh);
+		this.#prepare = onchain && new PrepareApi(onchain, options.ensureFresh);
 		this.#execute = onchain && new ExecuteApi((chainId) => onchain.chain(chainId));
 	}
 	/**
-	* {@inheritDoc OpportunitiesOnchainOnly.simulate}
+	* {@inheritDoc OpportunitiesOnchainOnly.prepare}
 	**/
-	get simulate() {
-		if (!this.#simulate) throw new SourceUnavailableError("Opportunities", "onchain");
-		return this.#simulate;
+	get prepare() {
+		if (!this.#prepare) throw new SourceUnavailableError("Opportunities", "onchain");
+		return this.#prepare;
 	}
 	/**
 	* {@inheritDoc OpportunitiesOnchainOnly.execute}

package/dist/esm/new-sdk/{simulate/SimulateApi.js → prepare/PrepareApi.js}

@@ -3,9 +3,9 @@ import { MultichainConstruct } from "../../sdk/base/MultichainConstruct.js";
 import { fetchCreditAccountSlice } from "../../sdk/accounts/intents/utils/credit-account-slice.js";
 import { CreditAccountOperationsService } from "../../sdk/accounts/intents/index.js";
 import "../../sdk/index.js";
-//#region src/new-sdk/simulate/SimulateApi.ts
+//#region src/new-sdk/prepare/PrepareApi.ts
 /**
-* {@inheritDoc OpportunitiesSimulate}
+* {@inheritDoc OpportunitiesPrepare}
 *
 * Holds no state of its own: it owns the mapping from the public,
 * read-model-shaped request to the engine's intent, and nothing else. All
@@ -17,7 +17,7 @@ import "../../sdk/index.js";
 * to, hence a chain the SDK does not cover, or one that fails the read, throws
 * rather than answering with empty metadata.
 **/
-var SimulateApi = class extends MultichainConstruct {
+var PrepareApi = class extends MultichainConstruct {
 	#ensureFresh;
 	constructor(sdk, ensureFresh) {
 		super(sdk);
@@ -28,22 +28,10 @@ var SimulateApi = class extends MultichainConstruct {
 		return super.queryChain(props);
 	}
 	/**
-	* {@inheritDoc OpportunitiesSimulate.delayed}
+	* {@inheritDoc OpportunitiesPrepare.finalize}
 	**/
-	delayed = {
-		withdrawStrategy: (position, params) => this.#startDelayedIntent(position, params, {
-			type: "WITHDRAW",
-			amount: params.amount,
-			to: params.to,
-			tokenOut: params.tokenOut,
-			sourceToken: params.sourceToken
-		}),
-		adjustLeverage: (position, params) => this.#startDelayedIntent(position, params, {
-			type: "ADJUST_LEVERAGE",
-			targetLeverage: params.targetLeverage,
-			token: params.token
-		}),
-		finish: (position, params) => this.queryChain({
+	async finalize(position, params) {
+		return this.queryChain({
 			network: position.chainId,
 			run: async (sdk) => {
 				const intent = resumable(params.intent ?? params.claimable.intent);
@@ -60,10 +48,10 @@ var SimulateApi = class extends MultichainConstruct {
 					quotaReserve: params.quotaReserve
 				});
 			}
-		})
-	};
+		});
+	}
 	/**
-	* {@inheritDoc OpportunitiesSimulate.deposit}
+	* {@inheritDoc OpportunitiesPrepare.deposit}
 	**/
 	deposit(pool, params) {
 		const { marketRegister, pools } = this.sdk.chain(pool.chainId);
@@ -97,7 +85,7 @@ var SimulateApi = class extends MultichainConstruct {
 		};
 	}
 	/**
-	* {@inheritDoc OpportunitiesSimulate.withdraw}
+	* {@inheritDoc OpportunitiesPrepare.withdraw}
 	**/
 	withdraw(pool, params) {
 		const { pools } = this.sdk.chain(pool.chainId);
@@ -129,7 +117,7 @@ var SimulateApi = class extends MultichainConstruct {
 		};
 	}
 	/**
-	* {@inheritDoc OpportunitiesSimulate.redeem}
+	* {@inheritDoc OpportunitiesPrepare.redeem}
 	**/
 	redeem(pool, params) {
 		const { pools } = this.sdk.chain(pool.chainId);
@@ -161,7 +149,7 @@ var SimulateApi = class extends MultichainConstruct {
 		};
 	}
 	/**
-	* {@inheritDoc OpportunitiesSimulate.openNewStrategy}
+	* {@inheritDoc OpportunitiesPrepare.openNewStrategy}
 	**/
 	async openNewStrategy(strategy, params) {
 		return this.queryChain({
@@ -179,7 +167,7 @@ var SimulateApi = class extends MultichainConstruct {
 		});
 	}
 	/**
-	* {@inheritDoc OpportunitiesSimulate.depositStrategy}
+	* {@inheritDoc OpportunitiesPrepare.depositStrategy}
 	**/
 	async depositStrategy(position, params) {
 		return this.#startIntent(position, params, {
@@ -192,7 +180,7 @@ var SimulateApi = class extends MultichainConstruct {
 		});
 	}
 	/**
-	* {@inheritDoc OpportunitiesSimulate.withdrawStrategy}
+	* {@inheritDoc OpportunitiesPrepare.withdrawStrategy}
 	**/
 	async withdrawStrategy(position, params) {
 		return this.#startRoutes(position, params, {
@@ -204,7 +192,7 @@ var SimulateApi = class extends MultichainConstruct {
 		});
 	}
 	/**
-	* {@inheritDoc OpportunitiesSimulate.maxWithdraw}
+	* {@inheritDoc OpportunitiesPrepare.maxWithdraw}
 	**/
 	async maxWithdraw(position) {
 		return this.queryChain({
@@ -216,7 +204,7 @@ var SimulateApi = class extends MultichainConstruct {
 		});
 	}
 	/**
-	* {@inheritDoc OpportunitiesSimulate.repayStrategy}
+	* {@inheritDoc OpportunitiesPrepare.repayStrategy}
 	**/
 	async repayStrategy(position, params) {
 		return this.#startIntent(position, params, {
@@ -227,7 +215,7 @@ var SimulateApi = class extends MultichainConstruct {
 		});
 	}
 	/**
-	* {@inheritDoc OpportunitiesSimulate.maxRepay}
+	* {@inheritDoc OpportunitiesPrepare.maxRepay}
 	**/
 	async maxRepay(position) {
 		return this.queryChain({
@@ -239,7 +227,7 @@ var SimulateApi = class extends MultichainConstruct {
 		});
 	}
 	/**
-	* {@inheritDoc OpportunitiesSimulate.adjustLeverage}
+	* {@inheritDoc OpportunitiesPrepare.adjustLeverage}
 	**/
 	async adjustLeverage(position, params) {
 		return this.#startRoutes(position, params, {
@@ -249,7 +237,7 @@ var SimulateApi = class extends MultichainConstruct {
 		});
 	}
 	/**
-	* {@inheritDoc OpportunitiesSimulate.addCollateral}
+	* {@inheritDoc OpportunitiesPrepare.addCollateral}
 	**/
 	async addCollateral(position, params) {
 		return this.#startIntent(position, params, {
@@ -260,7 +248,7 @@ var SimulateApi = class extends MultichainConstruct {
 		});
 	}
 	/**
-	* {@inheritDoc OpportunitiesSimulate.withdrawCollateral}
+	* {@inheritDoc OpportunitiesPrepare.withdrawCollateral}
 	**/
 	async withdrawCollateral(position, params) {
 		return this.#startIntent(position, params, {
@@ -287,22 +275,6 @@ var SimulateApi = class extends MultichainConstruct {
 		});
 	}
 	/**
-	* Shared path of the same two flows when only the delayed route is asked for:
-	* a planner that requests a redemption instead of swapping.
-	**/
-	async #startDelayedIntent(position, options, intent) {
-		return this.queryChain({
-			network: position.chainId,
-			run: async (sdk) => service(sdk).startDelayedIntent({
-				intent,
-				creditAccount: await slice(sdk, position.creditAccount),
-				sdk,
-				slippage: options.slippage,
-				quotaReserve: options.quotaReserve
-			})
-		});
-	}
-	/**
 	* Shared path of the five flows that act on an existing account: read the
 	* account, then run the intent through the engine.
 	**/
@@ -357,4 +329,4 @@ function lpRoute(requested, routes) {
 	return options.length === 1 ? options[0] : void 0;
 }
 //#endregion
-export { SimulateApi };
+export { PrepareApi };

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

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

package/dist/types/dev/{compareOpportunities.d.ts → mode-parity/compareOpportunities.d.ts}

@@ -1,10 +1,10 @@
-import { ChainId } from "../model/primitives.js";
-import { Opportunity, OpportunityId, OpportunityKind } from "../model/opportunities.js";
-import { ChainMetadata, DataResponse } from "../model/response.js";
-import "../model/index.js";
+import { ChainId } from "../../model/primitives.js";
+import { Opportunity, OpportunityId, OpportunityKind } from "../../model/opportunities.js";
+import { ChainMetadata, DataResponse } from "../../model/response.js";
+import "../../model/index.js";
 import { ChainCompareCounts, CompareCounts, DiffKind, DiffPathCount, ExpectedDiffReason, FieldDiff } from "./fieldDiff.js";
 import { Address } from "viem";
-//#region src/dev/compareOpportunities.d.ts
+//#region src/dev/mode-parity/compareOpportunities.d.ts
 /**
  * Enough of an opportunity to identify it in a report without carrying the
  * whole row.

package/dist/types/dev/{comparePositions.d.ts → mode-parity/comparePositions.d.ts}

@@ -1,10 +1,10 @@
-import { ChainId } from "../model/primitives.js";
-import { Position, PositionId, PositionKind } from "../model/positions.js";
-import { ChainMetadata, DataResponse } from "../model/response.js";
-import "../model/index.js";
+import { ChainId } from "../../model/primitives.js";
+import { Position, PositionId, PositionKind } from "../../model/positions.js";
+import { ChainMetadata, DataResponse } from "../../model/response.js";
+import "../../model/index.js";
 import { ChainCompareCounts, CompareCounts, DiffPathCount, FieldDiff } from "./fieldDiff.js";
 import { Address } from "viem";
-//#region src/dev/comparePositions.d.ts
+//#region src/dev/mode-parity/comparePositions.d.ts
 /**
  * Enough of a position to identify it in a report without carrying the whole
  * row.

package/dist/types/dev/mode-parity/compareRules.d.ts

@@ -0,0 +1,33 @@
+import { CompareTag } from "../../model/compare.schema.js";
+import { FieldDiff } from "./fieldDiff.js";
+import { z } from "zod/v4";
+//#region src/dev/mode-parity/compareRules.d.ts
+/**
+ * Collapsed-path → tag map compiled from a zod schema, e.g.
+ * `apy.totalApy` → `"offchainOnly"`, `totalDebt.value` → `{ tolerance: amount }`.
+ **/
+type CompareRuleMap = Map<string, CompareTag>;
+/**
+ * Walks a schema and records every field that carries compare metadata.
+ *
+ * `"amount"` on an object (an Amount / TokenAmount) is stored
+ * at `<path>.value`; every other tag is stored at the field's own path.
+ **/
+declare function compileCompareRules(schema: z.ZodType): CompareRuleMap;
+/**
+ * Rules compiled for each row kind, e.g. `"pool"` vs `"strategy"`.
+ **/
+type CompareRulesByKind = Record<string, CompareRuleMap>;
+/**
+ * Tags one field diff using the rules compiled for its row kind.
+ **/
+type TagDiff = (diff: FieldDiff, kind: string) => FieldDiff;
+/**
+ * Tags diffs using the rules compiled for each row kind.
+ *
+ * Mode tags match the path or anything nested under it. Tolerance tags match
+ * the path exactly and dispatch on {@link CompareTolerance}.
+ **/
+declare function makeTagDiff(rulesByKind: CompareRulesByKind): TagDiff;
+//#endregion
+export { CompareRuleMap, CompareRulesByKind, TagDiff, compileCompareRules, makeTagDiff };