@steerprotocol/sdk 4.0.0-next.10 → 4.0.0-next.11

package/dist/index.d.cts

@@ -525,6 +525,8 @@ export declare abstract class LiquidityVault<TAmm extends AmmAdapter = AmmAdapte
   abstract readonly amm: TAmm;
   abstract getPositions(options?: ReadOptions): Promise<readonly LiquidityPosition<TPool>[]>;
   abstract getSnapshot(options?: ReadOptions): Promise<LiquidityVaultSnapshot<TPool>>;
+  /** Read strategy inputs at an explicit block, with timestamp-bounded indexed execution history. */
+  getExecutionContext(request: VaultExecutionContextRequest, options?: DataAdapterRequestOptions): Promise<VaultExecutionContext>;
   /** Calculate the other token maximum at the vault's current deposit ratio. Does not swap. */
   abstract quoteDeposit(input: AssetAmount, options?: ReadOptions): Promise<DepositQuote>;
   abstract previewDeposit(request: DepositRequest, options?: ReadOptions): Promise<LiquidityDepositPreview>;
@@ -565,6 +567,44 @@ interface VaultMetadata {
     readonly id: string;
   } | null;
 }
+interface VaultExecutionContextRequest {
+  readonly blockNumber: bigint;
+  /** Explicit execution epoch in Unix seconds, never inferred from the wall clock. */
+  readonly epochTimestamp: bigint;
+}
+interface VaultExecutionHistoryRequest {
+  readonly vaultAddress: Address;
+  readonly blockNumber: bigint;
+  readonly timestamp: bigint;
+}
+type VaultExecutionPoolFamily = "uniswap-v3-compatible" | "algebra" | "algebra-directional" | "algebra-integral" | "aerodrome-cl" | "uniswap-v4";
+/** JSON-safe strategy inputs. Totals follow the original contract's unpoked semantics. */
+interface VaultExecutionContext {
+  readonly chainId: number;
+  readonly blockNumber: string;
+  readonly epochTimestamp: string;
+  readonly vaultAddress: Address;
+  readonly protocol: AmmProtocol;
+  readonly beaconName: string;
+  readonly beaconAddress: Address;
+  readonly poolFamily: VaultExecutionPoolFamily;
+  readonly poolAddress: Address | null;
+  readonly factoryAddress: Address | null;
+  readonly poolId: Hex | null;
+  readonly poolManagerAddress: Address | null;
+  readonly poolKey: V4PoolKey | null;
+  readonly currentTick: number;
+  readonly tickSpacing: number;
+  readonly positions: readonly {
+    readonly lowerTick: number;
+    readonly upperTick: number;
+    readonly relativeWeight: number;
+  }[];
+  readonly totalAmount0: string;
+  readonly totalAmount1: string;
+  readonly lastExecutionTimestamp: string | null;
+  readonly lastExecutionTimeSeconds: string | null;
+}
 /** Loading options. Supplied indexed metadata never replaces onchain identity checks. */
 interface VaultLoadOptions extends ReadOptions {
   /** Complete records for the requested addresses; omit to fetch from the subgraph. */
@@ -879,6 +919,8 @@ export declare abstract class LendingDataAdapter<TMarketRef> extends DataAdapter
   abstract listMarkets(request?: PageRequest): Promise<Page<TMarketRef>>;
 }
 export declare abstract class SteerDataAdapter extends DataAdapter {
+  /** Latest indexed execution through the requested block and timestamp, or null if absent. */
+  getLastVaultExecution(_request: VaultExecutionHistoryRequest, _options?: DataAdapterRequestOptions): Promise<bigint | null>;
   listUserVaults(_request: UserVaultListRequest, _options?: DataAdapterRequestOptions): Promise<UserVaultPage>;
   getVaultMetadata(_addresses: readonly Address[], _options?: DataAdapterRequestOptions): Promise<readonly VaultMetadata[]>;
   abstract listVaults(request?: VaultListRequest, options?: DataAdapterRequestOptions): Promise<Page<VaultMetadata>>;
@@ -3857,5 +3899,5 @@ export declare class UniswapV4Vault extends LiquidityVault<UniswapV4Adapter, V4V
   prepareDeposit(request: PrepareDepositRequest, options?: ReadOptions): Promise<DepositPlan>;
 }
 //#endregion
-export { type AerodromeDepositPlan, type AerodromeDepositPreview, type AerodromeVaultSnapshot, type AerodromeWithdrawPlan, type AerodromeWithdrawPreview, type AlgebraContracts, type AlgebraIntegralContracts, type AlgebraIntegralPoolState, type AlgebraLegacyContracts, type AlgebraLegacyPoolLookupRequest, type AlgebraLegacyPoolState, type AlgebraLegacyPoolsLookupRequest, type AlgebraPoolLookupRequest, type AlgebraPoolReference, type AlgebraPoolState, type AlgebraPoolsLookupRequest, type AlgebraSwapFee, type AmmLookupRequest, type AmmProtocolAdapter, type AmmProtocolAdapters, type AmmProtocolVersion, type AmmVersion, type AssetAmount, type BlackholeNativeUnwrapPlan, type BlackholePosition, type BlackholeVaultSnapshot, type BlackholeWithdrawPlan, type BlackholeWithdrawPreview, type ConcentratedPoolState, type DepositPlan, type DepositPreview, type DepositQuote, type DepositRequest, type DiscoveredPool, type IndexerConfig, type InfinityCLContracts, type InfinityCLDirectionalFees, type InfinityCLPoolFees, type InfinityCLPoolIdReference, type InfinityCLPoolKey, type InfinityCLPoolKeyInput, type InfinityCLPoolLookupRequest, type InfinityCLPoolReference, type InfinityCLPoolState, type InfinityCLPoolsLookupRequest, type InfinityCLSwapQuoteRequest, type KnownSteerVault, type LiquidityDepositPreview, type LiquidityDepth, type LiquidityDepthRequest, type LiquidityDistribution, type LiquidityFees, type LiquidityInterval, type LiquidityPool, type LiquidityPosition, type LiquidityPositionRange, type LiquidityVaultRewards, type LiquidityVaultSnapshot, type LiquidityVaultUserPosition, type LogEvent, type Logger, type PoolBatchReadOptions, type PoolLookupRequest, type PoolPrice, type PoolReadOptions, type PoolReadResult, type PoolState, type PoolTicks, type PoolTokenBalance, type PoolsLookupRequest, type PrepareDepositRequest, type PrepareWithdrawRequest, type SlipstreamContracts, type SlipstreamPoolFees, type SlipstreamPoolLookupRequest, type SlipstreamPoolState, type SlipstreamPoolsLookupRequest, type SlipstreamQuoteOptions, type StrategyPosition, type SurroundingTicks, type SwapQuote, type SwapQuoteRequest, type TheGraphIndexerConfig, type TickLiquidity, type TickPoolState, type TickRange, type TokenPairAmounts, type UserVaultDiscoveryRequest, type UserVaultListRequest, type UserVaultPage, type V3Contracts, type V3PoolFees, type V3PoolLookupRequest, type V3PoolState, type V3PoolsLookupRequest, type V4Contracts, type V4DirectionalFees, type V4PoolFees, type V4PoolKey, type V4PoolLookupRequest, type V4PoolReference, type V4PoolState, type V4PoolsLookupRequest, type V4ReadOptions, type V4SwapQuoteRequest, type V4VaultPool, type VaultAmmFilter, type VaultDiscoveryRequest, type VaultListRequest, type VaultLoadOptions, type VaultLoadResult, type VaultMetadata, type VaultRewardAsset, type VaultRewardFee, type VaultRewardPayout, type VaultSnapshotResult, type VaultUnderlying, type VaultUserPosition, type WithdrawPlan, type WithdrawPreview, type WithdrawRequest, type WithdrawRewards, ethereumContracts as mainnetContracts };
+export { type AerodromeDepositPlan, type AerodromeDepositPreview, type AerodromeVaultSnapshot, type AerodromeWithdrawPlan, type AerodromeWithdrawPreview, type AlgebraContracts, type AlgebraIntegralContracts, type AlgebraIntegralPoolState, type AlgebraLegacyContracts, type AlgebraLegacyPoolLookupRequest, type AlgebraLegacyPoolState, type AlgebraLegacyPoolsLookupRequest, type AlgebraPoolLookupRequest, type AlgebraPoolReference, type AlgebraPoolState, type AlgebraPoolsLookupRequest, type AlgebraSwapFee, type AmmLookupRequest, type AmmProtocolAdapter, type AmmProtocolAdapters, type AmmProtocolVersion, type AmmVersion, type AssetAmount, type BlackholeNativeUnwrapPlan, type BlackholePosition, type BlackholeVaultSnapshot, type BlackholeWithdrawPlan, type BlackholeWithdrawPreview, type ConcentratedPoolState, type DepositPlan, type DepositPreview, type DepositQuote, type DepositRequest, type DiscoveredPool, type IndexerConfig, type InfinityCLContracts, type InfinityCLDirectionalFees, type InfinityCLPoolFees, type InfinityCLPoolIdReference, type InfinityCLPoolKey, type InfinityCLPoolKeyInput, type InfinityCLPoolLookupRequest, type InfinityCLPoolReference, type InfinityCLPoolState, type InfinityCLPoolsLookupRequest, type InfinityCLSwapQuoteRequest, type KnownSteerVault, type LiquidityDepositPreview, type LiquidityDepth, type LiquidityDepthRequest, type LiquidityDistribution, type LiquidityFees, type LiquidityInterval, type LiquidityPool, type LiquidityPosition, type LiquidityPositionRange, type LiquidityVaultRewards, type LiquidityVaultSnapshot, type LiquidityVaultUserPosition, type LogEvent, type Logger, type PoolBatchReadOptions, type PoolLookupRequest, type PoolPrice, type PoolReadOptions, type PoolReadResult, type PoolState, type PoolTicks, type PoolTokenBalance, type PoolsLookupRequest, type PrepareDepositRequest, type PrepareWithdrawRequest, type SlipstreamContracts, type SlipstreamPoolFees, type SlipstreamPoolLookupRequest, type SlipstreamPoolState, type SlipstreamPoolsLookupRequest, type SlipstreamQuoteOptions, type StrategyPosition, type SurroundingTicks, type SwapQuote, type SwapQuoteRequest, type TheGraphIndexerConfig, type TickLiquidity, type TickPoolState, type TickRange, type TokenPairAmounts, type UserVaultDiscoveryRequest, type UserVaultListRequest, type UserVaultPage, type V3Contracts, type V3PoolFees, type V3PoolLookupRequest, type V3PoolState, type V3PoolsLookupRequest, type V4Contracts, type V4DirectionalFees, type V4PoolFees, type V4PoolKey, type V4PoolLookupRequest, type V4PoolReference, type V4PoolState, type V4PoolsLookupRequest, type V4ReadOptions, type V4SwapQuoteRequest, type V4VaultPool, type VaultAmmFilter, type VaultDiscoveryRequest, type VaultExecutionContext, type VaultExecutionContextRequest, type VaultExecutionHistoryRequest, type VaultExecutionPoolFamily, type VaultListRequest, type VaultLoadOptions, type VaultLoadResult, type VaultMetadata, type VaultRewardAsset, type VaultRewardFee, type VaultRewardPayout, type VaultSnapshotResult, type VaultUnderlying, type VaultUserPosition, type WithdrawPlan, type WithdrawPreview, type WithdrawRequest, type WithdrawRewards, ethereumContracts as mainnetContracts };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.mts

@@ -525,6 +525,8 @@ export declare abstract class LiquidityVault<TAmm extends AmmAdapter = AmmAdapte
   abstract readonly amm: TAmm;
   abstract getPositions(options?: ReadOptions): Promise<readonly LiquidityPosition<TPool>[]>;
   abstract getSnapshot(options?: ReadOptions): Promise<LiquidityVaultSnapshot<TPool>>;
+  /** Read strategy inputs at an explicit block, with timestamp-bounded indexed execution history. */
+  getExecutionContext(request: VaultExecutionContextRequest, options?: DataAdapterRequestOptions): Promise<VaultExecutionContext>;
   /** Calculate the other token maximum at the vault's current deposit ratio. Does not swap. */
   abstract quoteDeposit(input: AssetAmount, options?: ReadOptions): Promise<DepositQuote>;
   abstract previewDeposit(request: DepositRequest, options?: ReadOptions): Promise<LiquidityDepositPreview>;
@@ -565,6 +567,44 @@ interface VaultMetadata {
     readonly id: string;
   } | null;
 }
+interface VaultExecutionContextRequest {
+  readonly blockNumber: bigint;
+  /** Explicit execution epoch in Unix seconds, never inferred from the wall clock. */
+  readonly epochTimestamp: bigint;
+}
+interface VaultExecutionHistoryRequest {
+  readonly vaultAddress: Address;
+  readonly blockNumber: bigint;
+  readonly timestamp: bigint;
+}
+type VaultExecutionPoolFamily = "uniswap-v3-compatible" | "algebra" | "algebra-directional" | "algebra-integral" | "aerodrome-cl" | "uniswap-v4";
+/** JSON-safe strategy inputs. Totals follow the original contract's unpoked semantics. */
+interface VaultExecutionContext {
+  readonly chainId: number;
+  readonly blockNumber: string;
+  readonly epochTimestamp: string;
+  readonly vaultAddress: Address;
+  readonly protocol: AmmProtocol;
+  readonly beaconName: string;
+  readonly beaconAddress: Address;
+  readonly poolFamily: VaultExecutionPoolFamily;
+  readonly poolAddress: Address | null;
+  readonly factoryAddress: Address | null;
+  readonly poolId: Hex | null;
+  readonly poolManagerAddress: Address | null;
+  readonly poolKey: V4PoolKey | null;
+  readonly currentTick: number;
+  readonly tickSpacing: number;
+  readonly positions: readonly {
+    readonly lowerTick: number;
+    readonly upperTick: number;
+    readonly relativeWeight: number;
+  }[];
+  readonly totalAmount0: string;
+  readonly totalAmount1: string;
+  readonly lastExecutionTimestamp: string | null;
+  readonly lastExecutionTimeSeconds: string | null;
+}
 /** Loading options. Supplied indexed metadata never replaces onchain identity checks. */
 interface VaultLoadOptions extends ReadOptions {
   /** Complete records for the requested addresses; omit to fetch from the subgraph. */
@@ -879,6 +919,8 @@ export declare abstract class LendingDataAdapter<TMarketRef> extends DataAdapter
   abstract listMarkets(request?: PageRequest): Promise<Page<TMarketRef>>;
 }
 export declare abstract class SteerDataAdapter extends DataAdapter {
+  /** Latest indexed execution through the requested block and timestamp, or null if absent. */
+  getLastVaultExecution(_request: VaultExecutionHistoryRequest, _options?: DataAdapterRequestOptions): Promise<bigint | null>;
   listUserVaults(_request: UserVaultListRequest, _options?: DataAdapterRequestOptions): Promise<UserVaultPage>;
   getVaultMetadata(_addresses: readonly Address[], _options?: DataAdapterRequestOptions): Promise<readonly VaultMetadata[]>;
   abstract listVaults(request?: VaultListRequest, options?: DataAdapterRequestOptions): Promise<Page<VaultMetadata>>;
@@ -3857,5 +3899,5 @@ export declare class UniswapV4Vault extends LiquidityVault<UniswapV4Adapter, V4V
   prepareDeposit(request: PrepareDepositRequest, options?: ReadOptions): Promise<DepositPlan>;
 }
 //#endregion
-export { type AerodromeDepositPlan, type AerodromeDepositPreview, type AerodromeVaultSnapshot, type AerodromeWithdrawPlan, type AerodromeWithdrawPreview, type AlgebraContracts, type AlgebraIntegralContracts, type AlgebraIntegralPoolState, type AlgebraLegacyContracts, type AlgebraLegacyPoolLookupRequest, type AlgebraLegacyPoolState, type AlgebraLegacyPoolsLookupRequest, type AlgebraPoolLookupRequest, type AlgebraPoolReference, type AlgebraPoolState, type AlgebraPoolsLookupRequest, type AlgebraSwapFee, type AmmLookupRequest, type AmmProtocolAdapter, type AmmProtocolAdapters, type AmmProtocolVersion, type AmmVersion, type AssetAmount, type BlackholeNativeUnwrapPlan, type BlackholePosition, type BlackholeVaultSnapshot, type BlackholeWithdrawPlan, type BlackholeWithdrawPreview, type ConcentratedPoolState, type DepositPlan, type DepositPreview, type DepositQuote, type DepositRequest, type DiscoveredPool, type IndexerConfig, type InfinityCLContracts, type InfinityCLDirectionalFees, type InfinityCLPoolFees, type InfinityCLPoolIdReference, type InfinityCLPoolKey, type InfinityCLPoolKeyInput, type InfinityCLPoolLookupRequest, type InfinityCLPoolReference, type InfinityCLPoolState, type InfinityCLPoolsLookupRequest, type InfinityCLSwapQuoteRequest, type KnownSteerVault, type LiquidityDepositPreview, type LiquidityDepth, type LiquidityDepthRequest, type LiquidityDistribution, type LiquidityFees, type LiquidityInterval, type LiquidityPool, type LiquidityPosition, type LiquidityPositionRange, type LiquidityVaultRewards, type LiquidityVaultSnapshot, type LiquidityVaultUserPosition, type LogEvent, type Logger, type PoolBatchReadOptions, type PoolLookupRequest, type PoolPrice, type PoolReadOptions, type PoolReadResult, type PoolState, type PoolTicks, type PoolTokenBalance, type PoolsLookupRequest, type PrepareDepositRequest, type PrepareWithdrawRequest, type SlipstreamContracts, type SlipstreamPoolFees, type SlipstreamPoolLookupRequest, type SlipstreamPoolState, type SlipstreamPoolsLookupRequest, type SlipstreamQuoteOptions, type StrategyPosition, type SurroundingTicks, type SwapQuote, type SwapQuoteRequest, type TheGraphIndexerConfig, type TickLiquidity, type TickPoolState, type TickRange, type TokenPairAmounts, type UserVaultDiscoveryRequest, type UserVaultListRequest, type UserVaultPage, type V3Contracts, type V3PoolFees, type V3PoolLookupRequest, type V3PoolState, type V3PoolsLookupRequest, type V4Contracts, type V4DirectionalFees, type V4PoolFees, type V4PoolKey, type V4PoolLookupRequest, type V4PoolReference, type V4PoolState, type V4PoolsLookupRequest, type V4ReadOptions, type V4SwapQuoteRequest, type V4VaultPool, type VaultAmmFilter, type VaultDiscoveryRequest, type VaultListRequest, type VaultLoadOptions, type VaultLoadResult, type VaultMetadata, type VaultRewardAsset, type VaultRewardFee, type VaultRewardPayout, type VaultSnapshotResult, type VaultUnderlying, type VaultUserPosition, type WithdrawPlan, type WithdrawPreview, type WithdrawRequest, type WithdrawRewards, ethereumContracts as mainnetContracts };
+export { type AerodromeDepositPlan, type AerodromeDepositPreview, type AerodromeVaultSnapshot, type AerodromeWithdrawPlan, type AerodromeWithdrawPreview, type AlgebraContracts, type AlgebraIntegralContracts, type AlgebraIntegralPoolState, type AlgebraLegacyContracts, type AlgebraLegacyPoolLookupRequest, type AlgebraLegacyPoolState, type AlgebraLegacyPoolsLookupRequest, type AlgebraPoolLookupRequest, type AlgebraPoolReference, type AlgebraPoolState, type AlgebraPoolsLookupRequest, type AlgebraSwapFee, type AmmLookupRequest, type AmmProtocolAdapter, type AmmProtocolAdapters, type AmmProtocolVersion, type AmmVersion, type AssetAmount, type BlackholeNativeUnwrapPlan, type BlackholePosition, type BlackholeVaultSnapshot, type BlackholeWithdrawPlan, type BlackholeWithdrawPreview, type ConcentratedPoolState, type DepositPlan, type DepositPreview, type DepositQuote, type DepositRequest, type DiscoveredPool, type IndexerConfig, type InfinityCLContracts, type InfinityCLDirectionalFees, type InfinityCLPoolFees, type InfinityCLPoolIdReference, type InfinityCLPoolKey, type InfinityCLPoolKeyInput, type InfinityCLPoolLookupRequest, type InfinityCLPoolReference, type InfinityCLPoolState, type InfinityCLPoolsLookupRequest, type InfinityCLSwapQuoteRequest, type KnownSteerVault, type LiquidityDepositPreview, type LiquidityDepth, type LiquidityDepthRequest, type LiquidityDistribution, type LiquidityFees, type LiquidityInterval, type LiquidityPool, type LiquidityPosition, type LiquidityPositionRange, type LiquidityVaultRewards, type LiquidityVaultSnapshot, type LiquidityVaultUserPosition, type LogEvent, type Logger, type PoolBatchReadOptions, type PoolLookupRequest, type PoolPrice, type PoolReadOptions, type PoolReadResult, type PoolState, type PoolTicks, type PoolTokenBalance, type PoolsLookupRequest, type PrepareDepositRequest, type PrepareWithdrawRequest, type SlipstreamContracts, type SlipstreamPoolFees, type SlipstreamPoolLookupRequest, type SlipstreamPoolState, type SlipstreamPoolsLookupRequest, type SlipstreamQuoteOptions, type StrategyPosition, type SurroundingTicks, type SwapQuote, type SwapQuoteRequest, type TheGraphIndexerConfig, type TickLiquidity, type TickPoolState, type TickRange, type TokenPairAmounts, type UserVaultDiscoveryRequest, type UserVaultListRequest, type UserVaultPage, type V3Contracts, type V3PoolFees, type V3PoolLookupRequest, type V3PoolState, type V3PoolsLookupRequest, type V4Contracts, type V4DirectionalFees, type V4PoolFees, type V4PoolKey, type V4PoolLookupRequest, type V4PoolReference, type V4PoolState, type V4PoolsLookupRequest, type V4ReadOptions, type V4SwapQuoteRequest, type V4VaultPool, type VaultAmmFilter, type VaultDiscoveryRequest, type VaultExecutionContext, type VaultExecutionContextRequest, type VaultExecutionHistoryRequest, type VaultExecutionPoolFamily, type VaultListRequest, type VaultLoadOptions, type VaultLoadResult, type VaultMetadata, type VaultRewardAsset, type VaultRewardFee, type VaultRewardPayout, type VaultSnapshotResult, type VaultUnderlying, type VaultUserPosition, type WithdrawPlan, type WithdrawPreview, type WithdrawRequest, type WithdrawRewards, ethereumContracts as mainnetContracts };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -2302,6 +2302,10 @@ var DataAdapter = class {
 var PoolDataAdapter = class extends DataAdapter {};
 var LendingDataAdapter = class extends DataAdapter {};
 var SteerDataAdapter = class extends DataAdapter {
+	/** Latest indexed execution through the requested block and timestamp, or null if absent. */
+	async getLastVaultExecution(_request, _options) {
+		throw new Error("Vault execution history is not configured for this data adapter");
+	}
 	async listUserVaults(_request, _options) {
 		throw new Error("User vault discovery is not configured for this data adapter");
 	}
@@ -12777,6 +12781,29 @@ var CatalogSteerDataAdapter = class extends SteerDataAdapter {
 	#factories = /* @__PURE__ */ new Map();
 	#identity;
 	#context;
+	async getLastVaultExecution(request, options) {
+		const vaultAddress = indexedAddress(request.vaultAddress);
+		const { blockNumber, timestamp } = request;
+		if (typeof blockNumber !== "bigint" || blockNumber < 0n || blockNumber > 2147483647n) throw new Error("Execution history block must fit a nonnegative GraphQL Int");
+		if (typeof timestamp !== "bigint" || timestamp < 0n) throw new Error("Execution history timestamp must be nonnegative");
+		const data = await this.#query(`query VaultExecutionHistory($vault: String!, $timestamp: BigInt!, $block: Int!) {
+        vaultSnapshots(first: 1, orderBy: timestamp, orderDirection: desc,
+          block: {number: $block}, where: {vaultAddress: $vault, timestamp_lte: $timestamp}) {
+          timestamp
+        }
+        _meta(block: {number: $block}) { ${metaFields} }
+      }`, {
+			vault: vaultAddress,
+			timestamp: timestamp.toString(),
+			block: Number(blockNumber)
+		}, options);
+		if (BigInt(snapshot$1(data).block) !== blockNumber) throw new Error("Execution history returned another block");
+		if (!Array.isArray(data.vaultSnapshots) || data.vaultSnapshots.length > 1) throw new Error("Malformed vault execution history");
+		if (data.vaultSnapshots.length === 0) return null;
+		const value = record(data.vaultSnapshots[0]).timestamp;
+		if (typeof value !== "string" || !/^\d+$/.test(value) || BigInt(value) > timestamp) throw new Error("Invalid vault execution timestamp");
+		return BigInt(value);
+	}
 	constructor(definition, context, mappings) {
 		super(definition.dataAdapter);
 		if (definition.dataAdapter.kind !== "subgraph") throw new Error("Steer vault listing requires a subgraph endpoint");
@@ -13427,7 +13454,7 @@ function captureAsset$1({ asset, amount }, allowNative = false) {
 		amount
 	});
 }
-function captureRequest(input, allowNative) {
+function captureRequest$1(input, allowNative) {
 	const { account, receiver } = input;
 	requireAddress(account);
 	requireAddress(receiver);
@@ -13485,7 +13512,7 @@ function buildPreview(snapshot, state, desired0, desired1, minimumInitialShares,
 	});
 }
 async function previewLiquidityDeposit(vault, input, minimumInitialShares, options, accounting = defaultAccounting) {
-	const request = captureRequest(input, accounting.allowNative);
+	const request = captureRequest$1(input, accounting.allowNative);
 	const { snapshot, state, desired0, desired1 } = await readDepositInput(vault, request.assets, options, void 0, accounting, request.receiver);
 	return buildPreview(snapshot, state, desired0, desired1, minimumInitialShares, accounting.singleSidedRounding);
 }
@@ -13507,7 +13534,7 @@ async function quoteLiquidityDeposit(vault, input, options, accounting = default
 	});
 }
 async function prepareLiquidityDeposit(vault, input, minimumInitialShares, options, accounting = defaultAccounting) {
-	const request = captureRequest(input, accounting.allowNative);
+	const request = captureRequest$1(input, accounting.allowNative);
 	const slippageBps = input.slippageBps;
 	if (!Number.isInteger(slippageBps) || slippageBps < 0 || slippageBps > 1e4) throw new Error("Deposit slippageBps must be an integer from 0 through 10000");
 	const { snapshot, state, desired0, desired1 } = await readDepositInput(vault, request.assets, options, request.account, accounting, request.receiver);
@@ -14102,6 +14129,10 @@ var SteerVault = class {
 };
 var LiquidityVault = class extends SteerVault {
 	kind = "liquidity";
+	/** Read strategy inputs at an explicit block, with timestamp-bounded indexed execution history. */
+	getExecutionContext(request, options) {
+		return this.steer.readVaultExecutionContext(this, request, options);
+	}
 	/** Simulates the original withdrawal as account at one verified block. Never submits. */
 	previewWithdraw(request, options) {
 		return previewLiquidityWithdraw(this, request, options);
@@ -25384,6 +25415,133 @@ function createIndexerRequest(config, defaults) {
 	});
 }
 //#endregion
+//#region src/vault/adapters/blackhole/execution.ts
+/** Custom-pool routing comes from the qualified vault layout, never an address-only guess. */
+async function readBlackholeExecutionPool(vault, blockNumber) {
+	const { target } = await readBlackholePool({
+		steer: vault.steer,
+		address: vault.address,
+		blockNumber
+	});
+	if (!sameAddress(target.address, vault.pool)) throw new Error("Blackhole vault pool changed");
+	const pool = await vault.amm.getPool(Object.freeze({ ...target }), Object.freeze({ blockNumber }));
+	if (!sameAddress(pool.deployer, target.deployer)) throw new Error("Blackhole execution pool deployer does not match the vault");
+	return pool;
+}
+//#endregion
+//#region src/vault/execution-pool.ts
+function validatePoolState(block, tick, spacing, expected) {
+	if (block !== expected || !Number.isInteger(tick) || tick < -887272 || tick > 887272 || !Number.isInteger(spacing) || spacing <= 0 || spacing > 8388607) throw new Error("Invalid execution pool state or block");
+}
+/** Dispatch actual registered adapters, then check the result against the verified vault pool. */
+async function readExecutionPool(vault, snapshot) {
+	const amm = vault.amm;
+	const options = Object.freeze({ blockNumber: snapshot.blockNumber });
+	if (amm.context.chainId !== vault.chain.chainId || amm.context.transport !== vault.chain.transport) throw new Error("Execution AMM belongs to another chain or transport");
+	if (typeof snapshot.pool !== "string") {
+		if (!isUniswapV4Adapter(amm)) throw new Error("Execution pool requires a V4 adapter");
+		const pool = await amm.getPool(snapshot.pool.key, options);
+		validatePoolState(pool.blockNumber, pool.tick, pool.key.tickSpacing, snapshot.blockNumber);
+		if (!sameLiquidityPool(snapshot.pool, {
+			poolId: pool.poolId,
+			poolManager: pool.poolManager,
+			key: pool.key
+		}) || !sameAddress(pool.poolManager, amm.contracts.poolManager.address) || !sameAddress(pool.key.currency0, snapshot.token0) || !sameAddress(pool.key.currency1, snapshot.token1)) throw new Error("Execution pool identity does not match the vault");
+		return Object.freeze({
+			poolFamily: "uniswap-v4",
+			poolAddress: null,
+			factoryAddress: null,
+			poolId: pool.poolId,
+			poolManagerAddress: pool.poolManager,
+			poolKey: Object.freeze({ ...pool.key }),
+			currentTick: pool.tick,
+			tickSpacing: pool.key.tickSpacing
+		});
+	}
+	if (!isUniswapV3Adapter(amm) && !isAlgebraLegacyAdapter(amm) && !isAlgebraIntegralAdapter(amm) && !(amm instanceof AerodromeSlipstreamAdapter)) throw new Error("Unsupported execution pool family");
+	const factory = amm.contracts.factory.address;
+	const pool = vault instanceof BlackholeVault ? await readBlackholeExecutionPool(vault, snapshot.blockNumber) : await amm.getPool(snapshot.pool, options);
+	validatePoolState(pool.blockNumber, pool.tick, pool.tickSpacing, snapshot.blockNumber);
+	if (!sameAddress(pool.address, snapshot.pool) || !sameAddress(pool.factory, factory) || !sameAddress(pool.token0, snapshot.token0) || !sameAddress(pool.token1, snapshot.token1)) throw new Error("Execution pool identity does not match the vault");
+	const poolFamily = isUniswapV3Adapter(amm) ? "uniswap-v3-compatible" : isAlgebraLegacyAdapter(amm) ? amm instanceof AlgebraDirectionalAdapter ? "algebra-directional" : "algebra" : isAlgebraIntegralAdapter(amm) ? "algebra-integral" : "aerodrome-cl";
+	return Object.freeze({
+		poolFamily,
+		poolAddress: pool.address,
+		factoryAddress: pool.factory,
+		poolId: null,
+		poolManagerAddress: null,
+		poolKey: null,
+		currentTick: pool.tick,
+		tickSpacing: pool.tickSpacing
+	});
+}
+//#endregion
+//#region src/vault/execution-context.ts
+function captureRequest(request) {
+	const { blockNumber, epochTimestamp } = request;
+	if (typeof blockNumber !== "bigint" || blockNumber < 0n || blockNumber > 2147483647n) throw new Error("Execution block must fit a nonnegative GraphQL Int");
+	if (typeof epochTimestamp !== "bigint" || epochTimestamp < 0n) throw new Error("Execution timestamp must be nonnegative Unix seconds");
+	return Object.freeze({
+		blockNumber,
+		epochTimestamp
+	});
+}
+function executionPositions(snapshot) {
+	const seen = /* @__PURE__ */ new Set();
+	return Object.freeze((snapshot.configuredPositions ?? snapshot.positions).map(({ lowerTick, upperTick, relativeWeight }) => {
+		const key = `${lowerTick}:${upperTick}`;
+		if (!Number.isInteger(lowerTick) || !Number.isInteger(upperTick) || lowerTick < -887272 || upperTick > 887272 || lowerTick >= upperTick || !Number.isInteger(relativeWeight) || relativeWeight < 0 || relativeWeight > 65535 || seen.has(key)) throw new Error("Invalid configured execution ranges");
+		seen.add(key);
+		return Object.freeze({
+			lowerTick,
+			upperTick,
+			relativeWeight
+		});
+	}));
+}
+/** Keep original contract totals separate from the SDK's net-fee accounting snapshot. */
+async function readLiquidityExecutionContext(vault, beaconAddress, input, options) {
+	const { blockNumber, epochTimestamp } = captureRequest(input);
+	const { address: vaultAddress, chain, steer, metadata, amm } = vault;
+	const beaconName = metadata.beaconName;
+	const protocol = amm.protocol;
+	const rpc = await vaultReadContext(chain, { blockNumber });
+	const client = rpcClient(rpc.transport);
+	const snapshot = await steer.readVaultSnapshot(vault, { blockNumber });
+	const positions = executionPositions(snapshot);
+	const pool = await readExecutionPool(vault, snapshot);
+	const totals = await client.readContract({
+		address: vaultAddress,
+		abi: depositAbi,
+		functionName: "getTotalAmounts",
+		blockNumber
+	});
+	const block = await client.getBlock({ blockNumber });
+	if (block.number !== blockNumber || typeof block.timestamp !== "bigint" || block.timestamp < 0n) throw new Error("Execution RPC returned an invalid block");
+	const timestamp = block.timestamp < epochTimestamp ? block.timestamp : epochTimestamp;
+	const lastExecution = await steer.dataAdapter.getLastVaultExecution({
+		vaultAddress,
+		blockNumber,
+		timestamp
+	}, options);
+	if (lastExecution !== null && (typeof lastExecution !== "bigint" || lastExecution < 0n || lastExecution > timestamp)) throw new Error("Invalid vault execution timestamp");
+	return Object.freeze({
+		chainId: rpc.chainId,
+		blockNumber: blockNumber.toString(),
+		epochTimestamp: epochTimestamp.toString(),
+		vaultAddress,
+		protocol,
+		beaconName,
+		beaconAddress,
+		...pool,
+		positions,
+		totalAmount0: totals[0].toString(),
+		totalAmount1: totals[1].toString(),
+		lastExecutionTimestamp: lastExecution?.toString() ?? null,
+		lastExecutionTimeSeconds: lastExecution === null ? null : (epochTimestamp - lastExecution).toString()
+	});
+}
+//#endregion
 //#region src/vault/resolver.ts
 function addressKey(address) {
 	if (!/^0x[0-9a-fA-F]{40}$/.test(address) || /^0x0{40}$/i.test(address)) throw new VaultResolutionError("identity-mismatch", "Invalid identity address");
@@ -25483,6 +25641,12 @@ var VaultResolver = class {
 		if (snapshot.blockNumber !== blockNumber || !vault.underlying.some((position) => position.kind === "liquidity" && sameLiquidityPool(position.pool, snapshot.pool))) throw new Error("Vault returned another accounting snapshot");
 		return readValidatedVaultSnapshot(vault, snapshot, vault.steer.context);
 	}
+	/** @internal The native snapshot reader revalidates this binding at the requested block. */
+	executionContext(vault, request, options) {
+		const binding = this.#snapshotBindings.get(vault);
+		if (!binding?.readSnapshot) throw new Error("No verified execution reader configured for vault");
+		return readLiquidityExecutionContext(vault, binding.beaconAddress, request, options);
+	}
 	#snapshotImplementation(snapshot, binding, beaconName) {
 		const { implementation: _implementation, ...accounting } = snapshot;
 		return Object.freeze({
@@ -25760,6 +25924,11 @@ var SteerNetwork = class {
 		if (vault.steer !== this) throw new VaultResolutionError("identity-mismatch", "Vault belongs to another Steer deployment");
 		return this.#vaultResolver().snapshot(vault, options);
 	}
+	/** @internal Retain the resolved vault's exact binding and registered overrides. */
+	readVaultExecutionContext(vault, request, options) {
+		if (vault.steer !== this) throw new Error("Vault belongs to another Steer deployment");
+		return this.#vaultResolver().executionContext(vault, request, options);
+	}
 	#vaultResolver() {
 		if (!this.#resolver) throw new VaultResolutionError("not-configured", "No vault resolver configured for this Steer deployment");
 		return this.#resolver;