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

package/README.md

@@ -176,6 +176,13 @@ equivalent is `steer.getDeployment(chainId).getVaults(addresses, options)`.
 
 ## Bulk vault accounting snapshots
 
+Bulk snapshots include optional `implementation: { address, codeHash, beacon, beaconName }` metadata from the
+registered native reader's verified identity at `blockNumber`. This reuses the implementation hash
+already checked by that reader and adds no RPC calls. Custom bindings without a registered verified
+`implementationCodeHash` omit the metadata. `beaconName` reuses the indexed descriptive name from
+the vault metadata, not onchain identity evidence. It does not assert fee-event completeness.
+
+
 ```ts
 const supported: boolean = steer.getDeployment(chainId).supportsVaultSnapshots(beaconName);
 ```

package/dist/index.cjs

@@ -13194,6 +13194,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),
@@ -14638,6 +14639,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);
@@ -15836,6 +15838,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);
@@ -15863,7 +15866,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",
@@ -17549,6 +17553,7 @@ const baseV3VaultResolver = /* @__PURE__ */ (() => Object.freeze({
 		beaconNames: baseV3VaultDiscovery.beaconNames,
 		beaconAddress: baseV3VaultIdentity.beacon,
 		implementationAddress: baseV3VaultIdentity.implementation,
+		implementationCodeHash: baseV3VaultIdentity.implementationCodeHash,
 		kind: "liquidity",
 		readUnderlying,
 		readSnapshot: readV3VaultAccounting,
@@ -17569,6 +17574,7 @@ const polygonV3VaultBinding = /* @__PURE__ */ (() => Object.freeze({
 	beaconNames: polygonV3VaultDiscovery.beaconNames,
 	beaconAddress: polygonV3VaultIdentity.beacon,
 	implementationAddress: polygonV3VaultIdentity.implementation,
+	implementationCodeHash: polygonV3VaultIdentity.implementationCodeHash,
 	kind: "liquidity",
 	readUnderlying,
 	readSnapshot: readV3VaultAccounting,
@@ -17589,7 +17595,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,
@@ -17600,7 +17607,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,
@@ -19049,6 +19057,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);
@@ -20465,6 +20474,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);
@@ -20487,7 +20497,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
@@ -20977,6 +20988,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) => {
@@ -21049,9 +21072,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;
@@ -21067,7 +21090,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);
 				})));
 			}
 		}