@steerprotocol/sdk 4.0.0-next.2 → 4.0.0-next.3

package/dist/index.d.cts

@@ -386,6 +386,7 @@ export type ProtocolBinding = {
 };
 export interface ResolvedVaultContext extends VaultReadContext {
   readonly underlying: readonly VaultUnderlying[];
+  readonly metadata: VaultMetadata;
 }
 /** Exact implementation-specific readers and constructors, supplied by SDK integration code. */
 export interface VaultImplementationBinding {
@@ -448,7 +449,7 @@ export declare class SteerNetwork {
   get contracts(): SteerContracts;
   get subgraphUrl(): string | undefined;
   listUserVaults(request: UserVaultListRequest, options?: DataAdapterRequestOptions): Promise<UserVaultPage>;
-  listVaults(request?: VaultListRequest, options?: DataAdapterRequestOptions): Promise<Page<`0x${string}`>>;
+  listVaults(request?: VaultListRequest, options?: DataAdapterRequestOptions): Promise<Page<VaultMetadata>>;
   getVault(address: Address, options?: ReadOptions): Promise<KnownSteerVault>;
   getVaults(addresses: readonly Address[], options?: ReadOptions): Promise<readonly KnownSteerVault[]>;
   getVaultSnapshots(addresses: readonly Address[], options?: ReadOptions): Promise<readonly LiquidityVaultSnapshot<LiquidityPool>[]>;
@@ -465,7 +466,8 @@ export declare abstract class SteerVault {
   readonly steer: SteerNetwork;
   abstract readonly kind: VaultKind;
   readonly underlying: readonly VaultUnderlying[];
-  constructor(address: Address, chain: ChainContext, steer: SteerNetwork, underlying: readonly VaultUnderlying[]);
+  readonly metadata: VaultMetadata;
+  constructor(address: Address, chain: ChainContext, steer: SteerNetwork, underlying: readonly VaultUnderlying[], metadata: VaultMetadata);
   abstract getShareBalance(account: Address, options?: ReadOptions): Promise<bigint>;
   abstract getPositions(options?: ReadOptions): Promise<readonly StrategyPosition[]>;
   /** SDK request shape; contract implementations encode their own ABI and enforce asset rules. */
@@ -500,6 +502,24 @@ export declare abstract class CompositeVault extends SteerVault {
 //#endregion
 //#region src/vault/types.d.ts
 type VaultAmmFilter = { [Protocol in AmmProtocol]: Omit<AmmLookupRequest<Protocol>, "chainId">; }[AmmProtocol];
+/** Indexed descriptive data. This record does not establish current onchain identity. */
+interface VaultMetadata {
+  readonly id: Address;
+  readonly name: string | null;
+  readonly symbol: string | null;
+  readonly decimals: string | null;
+  readonly beaconName: string;
+  readonly createdAt: string;
+  readonly state: string | null;
+  readonly pool: Address | null;
+  readonly poolKey?: string | null;
+  readonly token0: Address | null;
+  readonly token1: Address | null;
+  readonly payloadIpfs: string | null;
+  readonly strategyToken: {
+    readonly id: string;
+  } | null;
+}
 interface VaultListRequest extends PageRequest {
   /** Select a configured AMM using the same protocol/version rules as getAmm(). */
   readonly amm?: VaultAmmFilter;
@@ -761,7 +781,8 @@ export declare abstract class LendingDataAdapter<TMarketRef> extends DataAdapter
 }
 export declare abstract class SteerDataAdapter extends DataAdapter {
   listUserVaults(_request: UserVaultListRequest, _options?: DataAdapterRequestOptions): Promise<UserVaultPage>;
-  abstract listVaults(request?: VaultListRequest, options?: DataAdapterRequestOptions): Promise<Page<Address>>;
+  getVaultMetadata(_addresses: readonly Address[], _options?: DataAdapterRequestOptions): Promise<readonly VaultMetadata[]>;
+  abstract listVaults(request?: VaultListRequest, options?: DataAdapterRequestOptions): Promise<Page<VaultMetadata>>;
 }
 //#endregion
 //#region src/amm/adapters/aerodrome/types.d.ts
@@ -3529,7 +3550,7 @@ export declare class SteerClient {
   getVaultSnapshots(chainId: number, addresses: readonly Address[], options?: ReadOptions): Promise<readonly LiquidityVaultSnapshot<LiquidityPool>[]>;
   getVaultUserPositions(chainId: number, addresses: readonly Address[], account: Address, options?: ReadOptions): Promise<readonly VaultUserPosition[]>;
   listUserVaults(request: UserVaultDiscoveryRequest, options?: DataAdapterRequestOptions): Promise<UserVaultPage>;
-  listVaults(request: VaultDiscoveryRequest, options?: DataAdapterRequestOptions): Promise<Page<`0x${string}`>>;
+  listVaults(request: VaultDiscoveryRequest, options?: DataAdapterRequestOptions): Promise<Page<VaultMetadata>>;
   getLiquidityVault(chainId: number, address: Address, options?: ReadOptions): Promise<LiquidityVault<AmmAdapter<unknown, unknown, Readonly<Record<string, ContractDeployment>>, unknown>, LiquidityPool>>;
   getLendingVault(chainId: number, address: Address, options?: ReadOptions): Promise<LendingVault<LendingAdapter<unknown, unknown, Readonly<Record<string, ContractDeployment>>>>>;
   getCompositeVault(chainId: number, address: Address, options?: ReadOptions): Promise<CompositeVault>;
@@ -3649,5 +3670,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 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 PoolLookupRequest, type PoolPrice, type PoolReadOptions, 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 VaultRewardPayout, 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 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 PoolLookupRequest, type PoolPrice, type PoolReadOptions, 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 VaultMetadata, type VaultRewardPayout, 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

@@ -386,6 +386,7 @@ export type ProtocolBinding = {
 };
 export interface ResolvedVaultContext extends VaultReadContext {
   readonly underlying: readonly VaultUnderlying[];
+  readonly metadata: VaultMetadata;
 }
 /** Exact implementation-specific readers and constructors, supplied by SDK integration code. */
 export interface VaultImplementationBinding {
@@ -448,7 +449,7 @@ export declare class SteerNetwork {
   get contracts(): SteerContracts;
   get subgraphUrl(): string | undefined;
   listUserVaults(request: UserVaultListRequest, options?: DataAdapterRequestOptions): Promise<UserVaultPage>;
-  listVaults(request?: VaultListRequest, options?: DataAdapterRequestOptions): Promise<Page<`0x${string}`>>;
+  listVaults(request?: VaultListRequest, options?: DataAdapterRequestOptions): Promise<Page<VaultMetadata>>;
   getVault(address: Address, options?: ReadOptions): Promise<KnownSteerVault>;
   getVaults(addresses: readonly Address[], options?: ReadOptions): Promise<readonly KnownSteerVault[]>;
   getVaultSnapshots(addresses: readonly Address[], options?: ReadOptions): Promise<readonly LiquidityVaultSnapshot<LiquidityPool>[]>;
@@ -465,7 +466,8 @@ export declare abstract class SteerVault {
   readonly steer: SteerNetwork;
   abstract readonly kind: VaultKind;
   readonly underlying: readonly VaultUnderlying[];
-  constructor(address: Address, chain: ChainContext, steer: SteerNetwork, underlying: readonly VaultUnderlying[]);
+  readonly metadata: VaultMetadata;
+  constructor(address: Address, chain: ChainContext, steer: SteerNetwork, underlying: readonly VaultUnderlying[], metadata: VaultMetadata);
   abstract getShareBalance(account: Address, options?: ReadOptions): Promise<bigint>;
   abstract getPositions(options?: ReadOptions): Promise<readonly StrategyPosition[]>;
   /** SDK request shape; contract implementations encode their own ABI and enforce asset rules. */
@@ -500,6 +502,24 @@ export declare abstract class CompositeVault extends SteerVault {
 //#endregion
 //#region src/vault/types.d.ts
 type VaultAmmFilter = { [Protocol in AmmProtocol]: Omit<AmmLookupRequest<Protocol>, "chainId">; }[AmmProtocol];
+/** Indexed descriptive data. This record does not establish current onchain identity. */
+interface VaultMetadata {
+  readonly id: Address;
+  readonly name: string | null;
+  readonly symbol: string | null;
+  readonly decimals: string | null;
+  readonly beaconName: string;
+  readonly createdAt: string;
+  readonly state: string | null;
+  readonly pool: Address | null;
+  readonly poolKey?: string | null;
+  readonly token0: Address | null;
+  readonly token1: Address | null;
+  readonly payloadIpfs: string | null;
+  readonly strategyToken: {
+    readonly id: string;
+  } | null;
+}
 interface VaultListRequest extends PageRequest {
   /** Select a configured AMM using the same protocol/version rules as getAmm(). */
   readonly amm?: VaultAmmFilter;
@@ -761,7 +781,8 @@ export declare abstract class LendingDataAdapter<TMarketRef> extends DataAdapter
 }
 export declare abstract class SteerDataAdapter extends DataAdapter {
   listUserVaults(_request: UserVaultListRequest, _options?: DataAdapterRequestOptions): Promise<UserVaultPage>;
-  abstract listVaults(request?: VaultListRequest, options?: DataAdapterRequestOptions): Promise<Page<Address>>;
+  getVaultMetadata(_addresses: readonly Address[], _options?: DataAdapterRequestOptions): Promise<readonly VaultMetadata[]>;
+  abstract listVaults(request?: VaultListRequest, options?: DataAdapterRequestOptions): Promise<Page<VaultMetadata>>;
 }
 //#endregion
 //#region src/amm/adapters/aerodrome/types.d.ts
@@ -3529,7 +3550,7 @@ export declare class SteerClient {
   getVaultSnapshots(chainId: number, addresses: readonly Address[], options?: ReadOptions): Promise<readonly LiquidityVaultSnapshot<LiquidityPool>[]>;
   getVaultUserPositions(chainId: number, addresses: readonly Address[], account: Address, options?: ReadOptions): Promise<readonly VaultUserPosition[]>;
   listUserVaults(request: UserVaultDiscoveryRequest, options?: DataAdapterRequestOptions): Promise<UserVaultPage>;
-  listVaults(request: VaultDiscoveryRequest, options?: DataAdapterRequestOptions): Promise<Page<`0x${string}`>>;
+  listVaults(request: VaultDiscoveryRequest, options?: DataAdapterRequestOptions): Promise<Page<VaultMetadata>>;
   getLiquidityVault(chainId: number, address: Address, options?: ReadOptions): Promise<LiquidityVault<AmmAdapter<unknown, unknown, Readonly<Record<string, ContractDeployment>>, unknown>, LiquidityPool>>;
   getLendingVault(chainId: number, address: Address, options?: ReadOptions): Promise<LendingVault<LendingAdapter<unknown, unknown, Readonly<Record<string, ContractDeployment>>>>>;
   getCompositeVault(chainId: number, address: Address, options?: ReadOptions): Promise<CompositeVault>;
@@ -3649,5 +3670,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 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 PoolLookupRequest, type PoolPrice, type PoolReadOptions, 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 VaultRewardPayout, 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 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 PoolLookupRequest, type PoolPrice, type PoolReadOptions, 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 VaultMetadata, type VaultRewardPayout, type VaultUnderlying, type VaultUserPosition, type WithdrawPlan, type WithdrawPreview, type WithdrawRequest, type WithdrawRewards, ethereumContracts as mainnetContracts };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -2062,6 +2062,7 @@ var AerodromeSlipstreamAdapter = class extends AmmAdapter {
 			blockNumber: context.blockNumber,
 			...captured.account ? { account: captured.account } : {}
 		});
+		if (result[1] <= sqrtRatioAtTick(-887272) + 1n || result[1] >= sqrtRatioAtTick(887272) - 1n) throw new Error("Slipstream quote reached the price limit; full input consumption is not established");
 		return Object.freeze({
 			amountIn: input.amountIn,
 			amountOut: result[0]
@@ -2102,6 +2103,9 @@ var SteerDataAdapter = class extends DataAdapter {
 	async listUserVaults(_request, _options) {
 		throw new Error("User vault discovery is not configured for this data adapter");
 	}
+	async getVaultMetadata(_addresses, _options) {
+		throw new Error("Vault metadata is not configured for this data adapter");
+	}
 };
 //#endregion
 //#region src/data/subgraph.ts
@@ -7742,6 +7746,7 @@ var RpcUniswapV3Adapter = class RpcUniswapV3Adapter extends UniswapV3Adapter {
 			fee: pool.fee,
 			sqrtPriceLimitX96: 0n
 		}]);
+		if (result[1] <= sqrtRatioAtTick(-887272) + 1n || result[1] >= sqrtRatioAtTick(887272) - 1n) throw new Error("V3 quote reached the price limit; full input consumption is not established");
 		return {
 			amountIn: request.amountIn,
 			amountOut: result[0]
@@ -11398,6 +11403,36 @@ var DeploymentRegistry = class {
 	}
 };
 //#endregion
+//#region src/vault/metadata.ts
+function nullableString(value) {
+	if (value === null || typeof value === "string") return value;
+	throw new Error("Malformed vault metadata string");
+}
+/** Validate and detach indexed data, preserving nulls and optional pool keys. */
+function vaultMetadata(value) {
+	const row = record(value);
+	if (typeof row.beaconName !== "string" || !row.beaconName || typeof row.createdAt !== "string" || !/^\d+$/.test(row.createdAt)) throw new Error("Malformed vault metadata identity");
+	const decimals = nullableString(row.decimals);
+	if (decimals !== null && !/^\d+$/.test(decimals)) throw new Error("Malformed vault metadata decimals");
+	const strategy = row.strategyToken === null ? null : record(row.strategyToken);
+	if (strategy !== null && (typeof strategy.id !== "string" || !strategy.id)) throw new Error("Malformed vault strategy token");
+	return Object.freeze({
+		id: indexedAddress(row.id),
+		name: nullableString(row.name),
+		symbol: nullableString(row.symbol),
+		decimals,
+		beaconName: row.beaconName,
+		createdAt: row.createdAt,
+		state: nullableString(row.state),
+		pool: row.pool === null ? null : indexedAddress(row.pool, true),
+		...row.poolKey === void 0 ? {} : { poolKey: nullableString(row.poolKey) },
+		token0: row.token0 === null ? null : indexedAddress(row.token0, true),
+		token1: row.token1 === null ? null : indexedAddress(row.token1, true),
+		payloadIpfs: nullableString(row.payloadIpfs),
+		strategyToken: strategy === null ? null : Object.freeze({ id: String(strategy.id) })
+	});
+}
+//#endregion
 //#region src/vault/resolver-types.ts
 let ProtocolContractRole = /* @__PURE__ */ function(ProtocolContractRole) {
 	ProtocolContractRole["AmmFactory"] = "amm-factory";
@@ -11785,18 +11820,25 @@ async function filterVaultsByFactory(context, vaults, factory, blockNumber) {
 //#endregion
 //#region src/vault/data-adapter.ts
 const nonShareBeacons = ["ScheduledJobs", "DynamicJobs"];
-const vaultsQuery = `query Vaults($first: Int!, $where: Vault_filter!, $block: Int!) {
+const metadataFields = `id name symbol decimals beaconName createdAt state pool poolKey token0 token1 payloadIpfs strategyToken { id }`;
+const metadataQuery = `query VaultMetadata($ids: [ID!]!, $first: Int!) {
+  vaults(first: $first, orderBy: id, orderDirection: asc, where: {id_in: $ids}) { ${metadataFields} }
+  _meta { ${metaFields} }
+}`;
+const vaultsQuery = (balances) => `query Vaults($first: Int!, $where: Vault_filter!, $block: Int!) {
   vaults(first: $first, orderBy: id, orderDirection: asc, where: $where, block: {number: $block}) {
-    id beaconName token0 token1 token0Symbol token1Symbol token0Name token1Name
+    ${balances ? "id beaconName token0 token1" : metadataFields}
+    token0Symbol token1Symbol token0Name token1Name
   }
   _meta(block: {number: $block}) { ${metaFields} }
 }`;
 function matchesToken(row, token, side) {
-	const address = indexedAddress(row[`token${side}`]);
+	if (row[`token${side}`] === null) return false;
+	const address = indexedAddress(row[`token${side}`], true);
 	const symbol = row[`token${side}Symbol`];
 	const name = row[`token${side}Name`];
-	if (typeof symbol !== "string" || typeof name !== "string") throw new Error("Malformed vault token metadata");
-	return (!token.address || token.address === address) && (!token.symbol || symbol.toLowerCase().includes(token.symbol)) && (!token.name || name.toLowerCase().includes(token.name));
+	if (symbol !== null && typeof symbol !== "string" || name !== null && typeof name !== "string") throw new Error("Malformed vault token metadata");
+	return (!token.address || token.address === address) && (!token.symbol || typeof symbol === "string" && symbol.toLowerCase().includes(token.symbol)) && (!token.name || typeof name === "string" && name.toLowerCase().includes(token.name));
 }
 function vaultFilter(token, after, beacons, balances) {
 	const base = {
@@ -11885,7 +11927,7 @@ var CatalogSteerDataAdapter = class extends SteerDataAdapter {
 			...cursor === void 0 ? {} : { cursor },
 			limit: input.limit ?? 1e3
 		}, options, true);
-		const items = await scanVaultBalances(this.#context, page.items, input.account, page.indexedBlock);
+		const items = await scanVaultBalances(this.#context, page.items.map((row) => indexedAddress(row.id)), input.account, page.indexedBlock);
 		return Object.freeze({
 			items,
 			indexedBlock: page.indexedBlock,
@@ -11896,9 +11938,44 @@ var CatalogSteerDataAdapter = class extends SteerDataAdapter {
 			}) } : {}
 		});
 	}
+	async #metadataQuery(query, variables, options) {
+		try {
+			return await this.#query(query, variables, options);
+		} catch (error) {
+			const errors = error instanceof Error ? error.cause : void 0;
+			if (!query.includes("poolKey") || !Array.isArray(errors) || !errors.length || !errors.every((value) => typeof value?.message === "string" && /^Cannot query field "poolKey" on type "Vault"\.(?: Did you mean .*\?)?$/.test(value.message))) throw error;
+			return this.#query(query.replace(/\bpoolKey\b/g, ""), variables, options);
+		}
+	}
+	async getVaultMetadata(addresses, options = {}) {
+		const ids = addresses.map((address) => indexedAddress(address));
+		const unique = [...new Set(ids)];
+		if (!unique.length) return Object.freeze([]);
+		if (unique.length > 1e3) throw new Error("Vault metadata lookup supports at most 1000 addresses");
+		const data = await this.#metadataQuery(metadataQuery, {
+			ids: unique,
+			first: unique.length
+		}, options);
+		snapshot(data);
+		if (!Array.isArray(data.vaults) || data.vaults.length > unique.length) throw new Error("Malformed vault metadata response");
+		const records = /* @__PURE__ */ new Map();
+		for (const value of data.vaults) {
+			const metadata = vaultMetadata(value);
+			if (!unique.includes(metadata.id) || records.has(metadata.id)) throw new Error("Unexpected or duplicate vault metadata");
+			records.set(metadata.id, metadata);
+		}
+		return Object.freeze(ids.map((id) => {
+			const metadata = records.get(id);
+			if (!metadata) throw new Error("Vault metadata is not indexed");
+			return metadata;
+		}));
+	}
 	async listVaults(request = {}, options = {}) {
-		const { indexedBlock: _, ...page } = await this.#listVaults(request, options, false);
-		return Object.freeze(page);
+		const { indexedBlock: _, items, ...page } = await this.#listVaults(request, options, false);
+		return Object.freeze({
+			...page,
+			items: Object.freeze(items.map(vaultMetadata))
+		});
 	}
 	async #listVaults(request = {}, options = {}, balances = false) {
 		const limit = request.limit ?? 100;
@@ -11931,7 +12008,7 @@ var CatalogSteerDataAdapter = class extends SteerDataAdapter {
 			} });
 		} else expected = snapshot(await this.#query(snapshotQuery, {}, options));
 		const beacons = amm ? this.#beacons.get(amm) : void 0;
-		const data = await this.#query(vaultsQuery, {
+		const data = await this.#metadataQuery(vaultsQuery(balances), {
 			first: limit,
 			where: vaultFilter(token, after, beacons, balances),
 			block: expected.block
@@ -11948,13 +12025,15 @@ var CatalogSteerDataAdapter = class extends SteerDataAdapter {
 			if (balances && (typeof row.beaconName !== "string" || nonShareBeacons.includes(row.beaconName))) throw new Error("User vault listing returned a non-share deployment");
 			if (beacons && (typeof row.beaconName !== "string" || !beacons.includes(row.beaconName))) throw new Error("Vault listing does not match the AMM beacon mapping");
 			if (token && !matchesToken(row, token, 0) && !matchesToken(row, token, 1)) throw new Error("Vault listing does not match the token filter");
-			return address;
+			if (!balances) vaultMetadata(row);
+			return row;
 		});
-		const last = items.at(-1);
+		const last = items.at(-1)?.id;
 		const factory = amm ? this.#factories.get(amm) : void 0;
-		const filtered = factory ? await filterVaultsByFactory(this.#context, items, factory, BigInt(expected.block)) : items;
+		const filtered = factory ? await filterVaultsByFactory(this.#context, items.map((row) => indexedAddress(row.id)), factory, BigInt(expected.block)) : items.map((row) => indexedAddress(row.id));
+		const included = new Set(filtered);
 		return Object.freeze({
-			items: Object.freeze(filtered),
+			items: Object.freeze(items.filter((row) => included.has(indexedAddress(row.id)))),
 			indexedBlock: BigInt(expected.block),
 			...items.length === limit && last ? { nextCursor: JSON.stringify({
 				version: 1,
@@ -13758,10 +13837,13 @@ var SteerVault = class {
 	chain;
 	steer;
 	underlying;
-	constructor(address, chain, steer, underlying) {
+	metadata;
+	constructor(address, chain, steer, underlying, metadata) {
 		this.address = address;
 		this.chain = chain;
 		this.steer = steer;
+		this.metadata = vaultMetadata(metadata);
+		if (this.metadata.id !== address.toLowerCase()) throw new Error("Vault metadata belongs to another vault");
 		this.underlying = Object.freeze([...underlying]);
 	}
 };
@@ -14423,7 +14505,7 @@ var AerodromeVault = class extends LiquidityVault {
 	#positionManager;
 	/** @internal */
 	constructor(context, identity) {
-		super(context.address, context.steer.context, context.steer, context.underlying);
+		super(context.address, context.steer.context, context.steer, context.underlying, context.metadata);
 		const underlying = context.underlying[0];
 		if (context.underlying.length !== 1 || underlying?.kind !== "liquidity" || !(underlying.amm instanceof AerodromeSlipstreamAdapter) || typeof underlying.pool !== "string") identityMismatch("Expected one Aerodrome vault pool");
 		requireAddress(underlying.pool);
@@ -14527,6 +14609,7 @@ async function readAerodromeBulkSnapshot(vault, data, rpc, beacon) {
 		steer: vault.steer,
 		address: vault.address,
 		underlying: vault.underlying,
+		metadata: vault.metadata,
 		blockNumber: rpc.blockNumber
 	}, identity, {
 		raw: decodeAerodromeSnapshot(data),
@@ -15566,6 +15649,7 @@ async function readIntegralBulkSnapshot(vault, data, rpc) {
 		steer: vault.steer,
 		address: vault.address,
 		underlying: vault.underlying,
+		metadata: vault.metadata,
 		blockNumber: rpc.blockNumber
 	}, {
 		raw,
@@ -15579,7 +15663,7 @@ var AlgebraIntegralVault = class extends LiquidityVault {
 	amm;
 	pool;
 	constructor(context) {
-		super(context.address, context.steer.context, context.steer, context.underlying);
+		super(context.address, context.steer.context, context.steer, context.underlying, context.metadata);
 		const underlying = context.underlying[0];
 		if (context.underlying.length !== 1 || underlying?.kind !== "liquidity" || !isAlgebraIntegralAdapter(underlying.amm) || typeof underlying.pool !== "string") identityMismatch("Expected one Integral vault pool");
 		requireAddress(underlying.pool);
@@ -17178,6 +17262,7 @@ async function readV3BulkSnapshot(vault, data, rpc) {
 		steer: vault.steer,
 		address: vault.address,
 		underlying: vault.underlying,
+		metadata: vault.metadata,
 		blockNumber: rpc.blockNumber
 	}, {
 		raw,
@@ -17191,7 +17276,7 @@ var UniswapV3Vault = class extends LiquidityVault {
 	amm;
 	pool;
 	constructor(context) {
-		super(context.address, context.steer.context, context.steer, context.underlying);
+		super(context.address, context.steer.context, context.steer, context.underlying, context.metadata);
 		const underlying = context.underlying[0];
 		if (context.underlying.length !== 1 || underlying?.kind !== "liquidity" || !isUniswapV3Adapter(underlying.amm) || typeof underlying.pool !== "string") identityMismatch("Expected one V3 vault pool");
 		requireAddress(underlying.pool);
@@ -18824,7 +18909,7 @@ var UniswapV4Vault = class extends LiquidityVault {
 	amm;
 	pool;
 	constructor(context) {
-		super(context.address, context.steer.context, context.steer, context.underlying);
+		super(context.address, context.steer.context, context.steer, context.underlying, context.metadata);
 		const underlying = context.underlying[0];
 		if (context.underlying.length !== 1 || underlying?.kind !== "liquidity" || !(underlying.amm instanceof UniswapV4Adapter) || !isLiquidityPool(underlying.pool) || typeof underlying.pool === "string") identityMismatch("Expected one standalone V4 vault pool");
 		this.amm = underlying.amm;
@@ -20204,6 +20289,7 @@ async function readLegacyBulkSnapshot(vault, data, rpc, beacon) {
 		steer: vault.steer,
 		address: vault.address,
 		underlying: vault.underlying,
+		metadata: vault.metadata,
 		blockNumber: rpc.blockNumber
 	}, {
 		raw,
@@ -20217,7 +20303,7 @@ var AlgebraLegacyVault = class extends LiquidityVault {
 	amm;
 	pool;
 	constructor(context) {
-		super(context.address, context.steer.context, context.steer, context.underlying);
+		super(context.address, context.steer.context, context.steer, context.underlying, context.metadata);
 		const underlying = context.underlying[0];
 		if (context.underlying.length !== 1 || underlying?.kind !== "liquidity" || !isAlgebraLegacyAdapter(underlying.amm) || typeof underlying.pool !== "string") identityMismatch("Expected one Legacy vault pool");
 		requireAddress(underlying.pool);
@@ -20824,7 +20910,7 @@ var VaultResolver = class {
 		if (!vault) throw new Error("Missing resolved vault");
 		return vault;
 	}
-	async #createVault(context, identity, verified) {
+	async #createVault(context, identity, loadMetadata, verified) {
 		const { steer, address } = context;
 		if (!identity) throw new VaultResolutionError("not-registered", "Vault is not registered with Steer");
 		if (identity.chainId !== steer.context.chainId || addressKey(identity.vaultAddress) !== addressKey(address) || addressKey(identity.registryAddress) !== addressKey(steer.contracts.VaultRegistry.address) || addressKey(identity.beaconAddress) !== addressKey(identity.proxyBeaconAddress)) throw new VaultResolutionError("identity-mismatch", "Vault identity does not match the request");
@@ -20836,9 +20922,12 @@ var VaultResolver = class {
 			lending: /* @__PURE__ */ new Map()
 		};
 		const resolvedUnderlying = Object.freeze(underlying.map((position) => this.#resolveUnderlying(position, adapters)));
+		const metadata = await loadMetadata();
+		if (metadata.id.toLowerCase() !== address.toLowerCase()) throw new Error("Vault metadata belongs to another vault");
 		const resolved = Object.freeze({
 			...context,
-			underlying: resolvedUnderlying
+			underlying: resolvedUnderlying,
+			metadata
 		});
 		const vault = binding.createVault(resolved);
 		this.#validateVault(vault, binding, resolved);
@@ -20858,11 +20947,21 @@ var VaultResolver = class {
 			steer: vault.steer,
 			address: vault.address,
 			underlying: vault.underlying,
+			metadata: vault.metadata,
 			blockNumber
 		});
 		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);
 	}
+	#metadata(steer, addresses) {
+		let pending;
+		return async (address) => {
+			pending ??= steer.dataAdapter.getVaultMetadata(addresses);
+			const metadata = (await pending).find((record) => record.id.toLowerCase() === address.toLowerCase());
+			if (!metadata) throw new Error("Vault metadata is not indexed");
+			return metadata;
+		};
+	}
 	/** Bounded bulk identity pages at one block; compatibility uses four active loads. */
 	async resolveMany(steer, addresses, options) {
 		const inputs = [...addresses];
@@ -20873,6 +20972,7 @@ var VaultResolver = class {
 		let bulkSupported = !!this.#reader.readMany;
 		for (let start = 0; start < inputs.length; start += 64) {
 			const batch = inputs.slice(start, start + 64);
+			const loadMetadata = this.#metadata(steer, batch);
 			const contexts = batch.map((address) => Object.freeze({
 				steer,
 				address,
@@ -20884,13 +20984,13 @@ var VaultResolver = class {
 				for (const [i, context] of contexts.entries()) {
 					const read = reads[i];
 					if (!read) throw new VaultResolutionError("identity-mismatch", "Missing bulk vault identity");
-					result.push((await this.#createVault(context, read.identity, read)).vault);
+					result.push((await this.#createVault(context, read.identity, () => loadMetadata(context.address), read)).vault);
 				}
 			} else {
 				bulkSupported = false;
 				for (let i = 0; i < batch.length; i += 4) result.push(...await Promise.all(contexts.slice(i, i + 4).map(async (context) => {
 					const identity = await this.#reader.readIdentity(context);
-					return (await this.#createVault(context, identity)).vault;
+					return (await this.#createVault(context, identity, () => loadMetadata(context.address))).vault;
 				})));
 			}
 		}
@@ -20906,6 +21006,7 @@ var VaultResolver = class {
 		let bulkSupported = !!this.#reader.readSnapshots;
 		for (let start = 0; start < inputs.length; start += 16) {
 			const batch = inputs.slice(start, start + 16);
+			const loadMetadata = this.#metadata(steer, batch);
 			const contexts = batch.map((address) => Object.freeze({
 				steer,
 				address,
@@ -20917,7 +21018,7 @@ var VaultResolver = class {
 				for (const [i, context] of contexts.entries()) {
 					const read = reads[i];
 					if (!read) throw new Error("Missing bulk vault snapshot");
-					const { vault } = await this.#createVault(context, read.identity, read);
+					const { vault } = await this.#createVault(context, read.identity, () => loadMetadata(context.address), read);
 					if (vault.kind !== "liquidity") throw new VaultResolutionError("invalid-vault", "Vault does not support liquidity snapshots");
 					result.push(await read.readSnapshot(vault));
 				}
@@ -20930,7 +21031,7 @@ var VaultResolver = class {
 						blockNumber
 					});
 					const identity = await this.#reader.readIdentity(context);
-					const { vault, binding, context: resolved } = await this.#createVault(context, identity);
+					const { vault, binding, context: resolved } = await this.#createVault(context, identity, () => loadMetadata(context.address));
 					if (vault.kind !== "liquidity") throw new VaultResolutionError("invalid-vault", "Vault does not support liquidity snapshots");
 					if (!binding.readSnapshot) throw new VaultResolutionError("not-configured", "No verified snapshot reader configured for vault implementation");
 					const snapshot = await binding.readSnapshot(resolved);