@steerprotocol/sdk 4.0.0-next.5 → 4.0.0-next.6

package/dist/index.d.cts

@@ -394,6 +394,8 @@ export interface VaultImplementationBinding {
   readonly beaconNames?: readonly string[];
   readonly beaconAddress: Address;
   readonly implementationAddress: Address;
+  /** Runtime hash checked by this binding's native snapshot reader before returning accounting. */
+  readonly implementationCodeHash?: Hex;
   readonly kind: VaultKind;
   readUnderlying(context: VaultReadContext): Promise<readonly UnderlyingReference[]>;
   createVault(context: ResolvedVaultContext): KnownSteerVault;
@@ -705,6 +707,14 @@ interface LiquidityVaultRewards {
 }
 interface LiquidityVaultSnapshot<TPool extends LiquidityPool = LiquidityPool> {
   readonly blockNumber: bigint;
+  /** Verified implementation at blockNumber, supplied by registered bulk snapshot readers. */
+  readonly implementation?: {
+    readonly address: Address;
+    readonly codeHash: Hex;
+    readonly beacon: Address;
+    /** Indexed descriptive name, not onchain identity evidence. */
+    readonly beaconName: string;
+  };
   readonly pool: TPool;
   readonly token0: Address;
   readonly token1: Address;

package/dist/index.d.mts

@@ -394,6 +394,8 @@ export interface VaultImplementationBinding {
   readonly beaconNames?: readonly string[];
   readonly beaconAddress: Address;
   readonly implementationAddress: Address;
+  /** Runtime hash checked by this binding's native snapshot reader before returning accounting. */
+  readonly implementationCodeHash?: Hex;
   readonly kind: VaultKind;
   readUnderlying(context: VaultReadContext): Promise<readonly UnderlyingReference[]>;
   createVault(context: ResolvedVaultContext): KnownSteerVault;
@@ -705,6 +707,14 @@ interface LiquidityVaultRewards {
 }
 interface LiquidityVaultSnapshot<TPool extends LiquidityPool = LiquidityPool> {
   readonly blockNumber: bigint;
+  /** Verified implementation at blockNumber, supplied by registered bulk snapshot readers. */
+  readonly implementation?: {
+    readonly address: Address;
+    readonly codeHash: Hex;
+    readonly beacon: Address;
+    /** Indexed descriptive name, not onchain identity evidence. */
+    readonly beaconName: string;
+  };
   readonly pool: TPool;
   readonly token0: Address;
   readonly token1: Address;

package/dist/index.mjs

@@ -13193,6 +13193,7 @@ function captureVaultSnapshot(snapshot) {
 	return Object.freeze({
 		...snapshot,
 		pool: capturePool(snapshot.pool),
+		...snapshot.implementation ? { implementation: Object.freeze({ ...snapshot.implementation }) } : {},
 		positions: Object.freeze(snapshot.positions.map((position) => Object.freeze({
 			...position,
 			pool: capturePool(position.pool),
@@ -14637,6 +14638,7 @@ const baseAerodromeVaultMappings = /* @__PURE__ */ (() => Object.freeze(aerodrom
 		beaconNames: Object.freeze([identity.name]),
 		beaconAddress: identity.beacon,
 		implementationAddress: identity.implementation,
+		implementationCodeHash: identity.implementationCodeHash,
 		kind: "liquidity",
 		async readUnderlying(context) {
 			const { pool, factory } = await readAerodromePool(context, identity);
@@ -15835,6 +15837,7 @@ const baseIntegralVaultBinding = /* @__PURE__ */ (() => Object.freeze({
 	beaconNames: baseIntegralVaultDiscovery.beaconNames,
 	beaconAddress: baseIntegralVaultIdentity.beacon,
 	implementationAddress: baseIntegralVaultIdentity.implementation,
+	implementationCodeHash: baseIntegralVaultIdentity.implementationCodeHash,
 	kind: "liquidity",
 	async readUnderlying(context) {
 		const { pool, factory } = await readIntegralVaultPool(context);
@@ -15862,7 +15865,8 @@ const polygonIntegralVaultBinding = /* @__PURE__ */ (() => Object.freeze({
 	...baseIntegralVaultBinding,
 	beaconNames: polygonIntegralVaultDiscovery.beaconNames,
 	beaconAddress: polygonIntegralVaultIdentity.beacon,
-	implementationAddress: polygonIntegralVaultIdentity.implementation
+	implementationAddress: polygonIntegralVaultIdentity.implementation,
+	implementationCodeHash: polygonIntegralVaultIdentity.implementationCodeHash
 }))();
 const polygonIntegralVaultProtocol = /* @__PURE__ */ (() => Object.freeze({
 	kind: "liquidity",
@@ -17548,6 +17552,7 @@ const baseV3VaultResolver = /* @__PURE__ */ (() => Object.freeze({
 		beaconNames: baseV3VaultDiscovery.beaconNames,
 		beaconAddress: baseV3VaultIdentity.beacon,
 		implementationAddress: baseV3VaultIdentity.implementation,
+		implementationCodeHash: baseV3VaultIdentity.implementationCodeHash,
 		kind: "liquidity",
 		readUnderlying,
 		readSnapshot: readV3VaultAccounting,
@@ -17568,6 +17573,7 @@ const polygonV3VaultBinding = /* @__PURE__ */ (() => Object.freeze({
 	beaconNames: polygonV3VaultDiscovery.beaconNames,
 	beaconAddress: polygonV3VaultIdentity.beacon,
 	implementationAddress: polygonV3VaultIdentity.implementation,
+	implementationCodeHash: polygonV3VaultIdentity.implementationCodeHash,
 	kind: "liquidity",
 	readUnderlying,
 	readSnapshot: readV3VaultAccounting,
@@ -17588,7 +17594,8 @@ const polygonSushiVaultBinding = /* @__PURE__ */ (() => Object.freeze({
 	readUnderlying: (context) => readUnderlyingForFactory(context, sushiswapV3Polygon.definition.contracts.factory.address),
 	beaconNames: polygonSushiVaultDiscovery.beaconNames,
 	beaconAddress: polygonSushiVaultIdentity.beacon,
-	implementationAddress: polygonSushiVaultIdentity.implementation
+	implementationAddress: polygonSushiVaultIdentity.implementation,
+	implementationCodeHash: polygonSushiVaultIdentity.implementationCodeHash
 }))();
 const polygonRetroVaultDiscovery = /* @__PURE__ */ (() => Object.freeze({
 	amm: retroV3Polygon,
@@ -17599,7 +17606,8 @@ const polygonRetroVaultBinding = /* @__PURE__ */ (() => Object.freeze({
 	readUnderlying: (context) => readUnderlyingForFactory(context, retroV3Polygon.definition.contracts.factory.address),
 	beaconNames: polygonRetroVaultDiscovery.beaconNames,
 	beaconAddress: polygonRetroVaultIdentity.beacon,
-	implementationAddress: polygonRetroVaultIdentity.implementation
+	implementationAddress: polygonRetroVaultIdentity.implementation,
+	implementationCodeHash: polygonRetroVaultIdentity.implementationCodeHash
 }))();
 const polygonSushiVaultProtocol = /* @__PURE__ */ (() => Object.freeze({
 	...polygonV3VaultProtocol,
@@ -19048,6 +19056,7 @@ const bscV4VaultBinding = /* @__PURE__ */ (() => Object.freeze({
 	beaconNames: bscV4VaultDiscovery.beaconNames,
 	beaconAddress: bscV4VaultIdentity.beacon,
 	implementationAddress: bscV4VaultIdentity.implementation,
+	implementationCodeHash: bscV4VaultIdentity.implementationCodeHash,
 	kind: "liquidity",
 	async readUnderlying(context) {
 		const pool = await readV4VaultPool(context);
@@ -20464,6 +20473,7 @@ const polygonLegacyVaultBinding = /* @__PURE__ */ (() => Object.freeze({
 	beaconNames: polygonLegacyVaultDiscovery.beaconNames,
 	beaconAddress: polygonLegacyVaultIdentity.beacon,
 	implementationAddress: polygonLegacyVaultIdentity.implementation,
+	implementationCodeHash: polygonLegacyVaultIdentity.implementationCodeHash,
 	kind: "liquidity",
 	async readUnderlying(context) {
 		const { pool, factory } = await readLegacyVaultPool(context);
@@ -20486,7 +20496,8 @@ const polygonLegacyVaultProtocol = /* @__PURE__ */ (() => Object.freeze({
 const historicalPolygonLegacyVaultBinding = /* @__PURE__ */ (() => Object.freeze({
 	...polygonLegacyVaultBinding,
 	beaconAddress: historicalPolygonLegacyVaultIdentity.beacon,
-	implementationAddress: historicalPolygonLegacyVaultIdentity.implementation
+	implementationAddress: historicalPolygonLegacyVaultIdentity.implementation,
+	implementationCodeHash: historicalPolygonLegacyVaultIdentity.implementationCodeHash
 }))();
 //#endregion
 //#region src/vault/adapters/algebra-legacy/reader/batch-artifact.ts
@@ -20976,6 +20987,18 @@ 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);
 	}
+	#snapshotImplementation(snapshot, binding, beaconName) {
+		const { implementation: _implementation, ...accounting } = snapshot;
+		return Object.freeze({
+			...accounting,
+			...binding.implementationCodeHash ? { implementation: Object.freeze({
+				address: binding.implementationAddress,
+				codeHash: binding.implementationCodeHash,
+				beacon: binding.beaconAddress,
+				beaconName
+			}) } : {}
+		});
+	}
 	#metadata(steer, addresses, supplied) {
 		let pending;
 		return async (address) => {
@@ -21048,9 +21071,9 @@ 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, () => loadMetadata(context.address), read);
+					const { vault, binding } = 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));
+					result.push(this.#snapshotImplementation(await read.readSnapshot(vault), binding, vault.metadata.beaconName));
 				}
 			} else {
 				bulkSupported = false;
@@ -21066,7 +21089,7 @@ var VaultResolver = class {
 					if (!binding.readSnapshot) throw new VaultResolutionError("not-configured", "No verified snapshot reader configured for vault implementation");
 					const snapshot = await binding.readSnapshot(resolved);
 					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, steer.context);
+					return this.#snapshotImplementation(await readValidatedVaultSnapshot(vault, snapshot, steer.context), binding, vault.metadata.beaconName);
 				})));
 			}
 		}