@steerprotocol/sdk 4.0.0-next.12 → 4.0.0-next.13

package/README.md

@@ -2273,6 +2273,12 @@ is an error, not a fabricated key. Pool browsing remains separate and requires a
 Base retains its existing indexed adapter by default. BNB combines indexed browsing with RPC key
 resolution; Robinhood uses RPC key resolution without indexed pool browsing.
 
+### BSC SushiSwap and Uniswap V3 snapshots
+
+The exact qualified `MultiPositionSushi` and `MultiPositionUniswapV3` implementations now support vault resolution, single/bulk snapshots and direct pool reads. They reuse the fixed-fee V3 reader with 15% aggregate fee rounding. Normal bulk snapshot pages use two pinned RPC requests and preserve per-member failures with `allowFailure: true`.
+
+AMM-filtered Steer vault listing works. Underlying AMM pool browsing remains unqualified: both inherited subgraphs returned pool rows without the expected factory identity and the SDK rejects those responses. Deposit/withdrawal flows were not newly qualified by this snapshot work. Base Sushi is separately qualified after the 30-vault migration, using its exact upgraded FeeManager/helper implementation; see [Base Sushi qualification](src/vault/adapters/uniswap-v3/base-sushi-qualification.md). See [source and live qualification](src/vault/adapters/uniswap-v3/bsc-qualification.md).
+
 ### BSC PancakeSwap V3 vault snapshots
 
 `MultiPositionPancake` vaults on BSC use the shared `UniswapV3Vault` implementation and

package/dist/index.cjs

@@ -780,6 +780,9 @@ let AmmDeployment = /* @__PURE__ */ function(AmmDeployment) {
 	AmmDeployment["AerodromeSlipstreamBase"] = "aerodrome-slipstream-base";
 	AmmDeployment["AerodromeSlipstreamV2Base"] = "aerodrome-slipstream-v2-base";
 	AmmDeployment["AerodromeSlipstreamV3Base"] = "aerodrome-slipstream-v3-base";
+	AmmDeployment["SushiSwapV3Base"] = "sushiswap-v3-base";
+	AmmDeployment["SushiSwapV3Bsc"] = "sushiswap-v3-bsc";
+	AmmDeployment["UniswapV3Bsc"] = "uniswap-v3-bsc";
 	AmmDeployment["SushiSwapV3Polygon"] = "sushiswap-v3-polygon";
 	AmmDeployment["RetroV3Polygon"] = "retro-v3-polygon";
 	AmmDeployment["UniswapV3Polygon"] = "uniswap-v3-polygon";
@@ -19918,6 +19921,38 @@ const quickSwapIntegralPolygon = /* @__PURE__ */ new Deployment({
 	}
 }, (context, definition) => new QuickSwapIntegral(context, definition, new AlgebraIntegralDataAdapter(definition.dataAdapter, definition.contracts.factory.address, context.indexerRequest)));
 //#endregion
+//#region src/amm/deployments/sushiswap-v3.ts
+/** Prior SDK endpoint metadata retained; vault reads verify factory registration independently. */
+const sushiswapV3Polygon = /* @__PURE__ */ new Deployment({
+	id: "sushiswap-v3-polygon",
+	chainId: 137,
+	contracts: { factory: { address: "0x917933899c6a5F8E37F31E19f92CdBFF7e8FF0e2" } },
+	dataAdapter: {
+		kind: "subgraph",
+		url: "https://gateway.thegraph.com/api/subgraphs/id/CqLnQY1d6DLcBYu7aZvGmt17LoNdTe4fDYnGbE2EgotR"
+	}
+}, (context, definition) => new SushiSwapV3(context, definition, new UniswapV3DataAdapter(definition.dataAdapter, definition.contracts.factory.address, context.indexerRequest)));
+/** Prior SDK endpoint metadata retained; vault reads verify factory registration independently. */
+const sushiswapV3Bsc = /* @__PURE__ */ new Deployment({
+	id: "sushiswap-v3-bsc",
+	chainId: 56,
+	contracts: { factory: { address: "0x126555dd55a39328F69400d6aE4F782Bd4C34ABb" } },
+	dataAdapter: {
+		kind: "subgraph",
+		url: "https://gateway.thegraph.com/api/subgraphs/id/FiJDXMFCBv88GP17g2TtPh8BcA8jZozn5WRW7hCN7cUT"
+	}
+}, (context, definition) => new SushiSwapV3(context, definition, new UniswapV3DataAdapter(definition.dataAdapter, definition.contracts.factory.address, context.indexerRequest)));
+/** Prior SDK endpoint metadata retained; vault reads verify factory registration independently. */
+const sushiswapV3Base = /* @__PURE__ */ new Deployment({
+	id: "sushiswap-v3-base",
+	chainId: 8453,
+	contracts: { factory: { address: "0xc35DADB65012eC5796536bD9864eD8773aBc74C4" } },
+	dataAdapter: {
+		kind: "subgraph",
+		url: "https://gateway.thegraph.com/api/subgraphs/id/Cz4Snpih41NNNPZcbj1gd3fYXPwFr5q92iWMoZjCarEb"
+	}
+}, (context, definition) => new SushiSwapV3(context, definition, new UniswapV3DataAdapter(definition.dataAdapter, definition.contracts.factory.address, context.indexerRequest)));
+//#endregion
 //#region src/amm/deployments/uniswap-v3.ts
 /** Addresses: https://developers.uniswap.org/docs/protocols/v3/deployments/v3-base-deployments */
 const uniswapV3Base = /* @__PURE__ */ new Deployment({
@@ -19947,6 +19982,20 @@ const uniswapV3Polygon = /* @__PURE__ */ new Deployment({
 		url: "https://gateway.thegraph.com/api/subgraphs/id/EsLGwxyeMMeJuhqWvuLmJEiDKXJ4Z6YsoJreUnyeozco"
 	}
 }, (context, definition) => new UniswapV3(context, definition, new UniswapV3DataAdapter(definition.dataAdapter, definition.contracts.factory.address, context.indexerRequest)));
+/** Addresses: https://developers.uniswap.org/docs/protocols/v3/deployments/bsc-deployments */
+const uniswapV3Bsc = /* @__PURE__ */ new Deployment({
+	id: "uniswap-v3-bsc",
+	chainId: 56,
+	contracts: {
+		factory: { address: "0xdB1d10011AD0Ff90774D0C6Bb92e5C5c8b4461F7" },
+		positionManager: { address: "0x7b8A01B39D58278b5DE7e48c8449c9f4F5170613" },
+		quoter: { address: "0x78D78E420Da98ad378D7799bE8f4AF69033EB077" }
+	},
+	dataAdapter: {
+		kind: "subgraph",
+		url: "https://gateway.thegraph.com/api/subgraphs/id/G5MUbSBM7Nsrm9tH2tGQUiAF4SZDGf2qeo1xPLYjKr7K"
+	}
+}, (context, definition) => new UniswapV3(context, definition, new UniswapV3DataAdapter(definition.dataAdapter, definition.contracts.factory.address, context.indexerRequest)));
 //#endregion
 //#region src/amm/adapters/uniswap-v4/key-lookup.ts
 const abi = /* @__PURE__ */ (0, viem.parseAbi)([
@@ -22946,18 +22995,6 @@ const retroV3Polygon = /* @__PURE__ */ new Deployment({
 	}
 }, (context, definition) => new RetroV3(context, definition, new UniswapV3DataAdapter(definition.dataAdapter, definition.contracts.factory.address, context.indexerRequest)));
 //#endregion
-//#region src/amm/deployments/sushiswap-v3.ts
-/** Prior SDK endpoint metadata retained; vault reads verify factory registration independently. */
-const sushiswapV3Polygon = /* @__PURE__ */ new Deployment({
-	id: "sushiswap-v3-polygon",
-	chainId: 137,
-	contracts: { factory: { address: "0x917933899c6a5F8E37F31E19f92CdBFF7e8FF0e2" } },
-	dataAdapter: {
-		kind: "subgraph",
-		url: "https://gateway.thegraph.com/api/subgraphs/id/CqLnQY1d6DLcBYu7aZvGmt17LoNdTe4fDYnGbE2EgotR"
-	}
-}, (context, definition) => new SushiSwapV3(context, definition, new UniswapV3DataAdapter(definition.dataAdapter, definition.contracts.factory.address, context.indexerRequest)));
-//#endregion
 //#region src/vault/adapters/uniswap-v3/identity.ts
 const baseV3VaultIdentity = /* @__PURE__ */ (() => Object.freeze({
 	beacon: "0xDf0b9Ef4d7C4E294A74efB4407129bd66e4f82f0",
@@ -22966,6 +23003,14 @@ const baseV3VaultIdentity = /* @__PURE__ */ (() => Object.freeze({
 	implementationCodeHash: "0x9fff8189bb2dd53465e6cb2bee210b941b7b37dee5ca30ee6eac3463ce871ff7",
 	helperCodeHash: "0x8d178d093d945e3d89a5ac57aa9f14a56d4446508557da168a5713496de77937"
 }))();
+/** Migrated Base Sushi uses the qualified FeeManager/helper layout. */
+const baseSushiVaultIdentity = /* @__PURE__ */ (() => Object.freeze({
+	...baseV3VaultIdentity,
+	beacon: "0xb4f89b74aee9b9f1340835470fe4a6ed54e7fc11",
+	implementation: "0x6270905CAb3fC7f9bAf13803Fa2F1111D14B8005",
+	implementationCodeHash: "0xce1144e291dec2375eedebc3fd1032f41b107761031bcec1fcef02641c0bdaab",
+	proxyCodeHashes: Object.freeze([baseV3VaultIdentity.proxyCodeHash, "0x925993ab444b9b69993f1a22416897ccc0eadff0f3681fee18ec0617efbc2f4f"])
+}))();
 const beaconSlot = "0xa3f0ad74e5423aebfd80d3ef4346578335a9a72aeaee59ff6cb3582b35133d50";
 const polygonV3VaultIdentity = /* @__PURE__ */ (() => Object.freeze({
 	feePolicy: "fixed",
@@ -22996,11 +23041,29 @@ const bscPancakeVaultIdentity = /* @__PURE__ */ (() => Object.freeze({
 	implementation: "0x588B34D2a9598497f481A9d31B4eD372C6135f32",
 	implementationCodeHash: "0xf5709c6a1fcfeb4488663da7f8182975d3adc7a07f0ed0f04b98d9488cae6a83"
 }))();
+const bscSushiVaultIdentity = /* @__PURE__ */ (() => Object.freeze({
+	...polygonV3VaultIdentity,
+	feeRounding: "aggregate",
+	beacon: "0x33553c0914e1dc95de011f26f438a599df56f268",
+	implementation: "0xE11709193e7b2E0a0F2a4591022cFf4f01E75050",
+	implementationCodeHash: "0x10d00977df1a122495edb85c60972f2ffb92240f14a3770461cd32372e6b4570"
+}))();
+const bscV3VaultIdentity = /* @__PURE__ */ (() => Object.freeze({
+	...polygonV3VaultIdentity,
+	feeRounding: "aggregate",
+	beacon: "0x05ac33a55366a61fed4b0720946691c9faebcbb0",
+	implementation: "0x16BA7102271dC83Fff2f709691c2B601DAD7668e",
+	implementationCodeHash: "0x6cc14caa5a81aea294c4913dfcf437aa9d6528084ca4835ac87f036e424b2da0"
+}))();
 const qualifiedVaults = /* @__PURE__ */ (() => Object.freeze([
 	{
 		amm: uniswapV3Base,
 		identity: baseV3VaultIdentity
 	},
+	{
+		amm: sushiswapV3Base,
+		identity: baseSushiVaultIdentity
+	},
 	{
 		amm: uniswapV3Polygon,
 		identity: polygonV3VaultIdentity
@@ -23016,10 +23079,17 @@ const qualifiedVaults = /* @__PURE__ */ (() => Object.freeze([
 	{
 		amm: pancakeSwapV3Bsc,
 		identity: bscPancakeVaultIdentity
+	},
+	{
+		amm: sushiswapV3Bsc,
+		identity: bscSushiVaultIdentity
+	},
+	{
+		amm: uniswapV3Bsc,
+		identity: bscV3VaultIdentity
 	}
 ]))();
 function v3VaultIdentity(chainId, factory) {
-	if (chainId === 8453) return baseV3VaultIdentity;
 	const qualified = qualifiedVaults.find(({ amm }) => amm.definition.chainId === chainId && sameAddress(factory, amm.definition.contracts.factory.address));
 	if (qualified) return qualified.identity;
 	throw new Error("V3 vault identity is not configured for this chain/factory");
@@ -24234,8 +24304,19 @@ async function executeV3VaultReader(context, args, mode) {
 }
 async function readV3VaultSnapshot(context, rpc, pool, factory) {
 	const storage = await readVaultStorage(context);
+	const identity = v3VaultIdentity(rpc.chainId, factory);
+	let proxyCodeHash = identity.proxyCodeHash;
+	if (identity.feePolicy !== "fixed" && identity.proxyCodeHashes) {
+		const code = await vaultRpc(context).getCode({
+			address: context.address,
+			blockNumber: context.blockNumber
+		});
+		if (!code || !identity.proxyCodeHashes.includes((0, viem.keccak256)(code))) identityMismatch("Unsupported vault contract code");
+		proxyCodeHash = (0, viem.keccak256)(code);
+	}
 	const expected = {
-		...v3VaultIdentity(rpc.chainId, factory),
+		...identity,
+		proxyCodeHash,
 		factory,
 		pool
 	};
@@ -24654,6 +24735,66 @@ const bscPancakeVaultProtocol = /* @__PURE__ */ (() => Object.freeze({
 	protocolAddress: pancakeSwapV3Bsc.definition.contracts.factory.address,
 	deployment: pancakeSwapV3Bsc
 }))();
+const bscSushiVaultDiscovery = /* @__PURE__ */ (() => Object.freeze({
+	amm: sushiswapV3Bsc,
+	beaconNames: Object.freeze(["MultiPositionSushi"])
+}))();
+const bscSushiVaultBinding = /* @__PURE__ */ (() => Object.freeze({
+	readUnderlying: (context) => readUnderlyingForFactory(context, sushiswapV3Bsc.definition.contracts.factory.address),
+	beaconNames: bscSushiVaultDiscovery.beaconNames,
+	kind: "liquidity",
+	readSnapshot: readV3VaultAccounting,
+	createVault: (context) => new UniswapV3Vault(context),
+	beaconAddress: bscSushiVaultIdentity.beacon,
+	implementationAddress: bscSushiVaultIdentity.implementation,
+	implementationCodeHash: bscSushiVaultIdentity.implementationCodeHash
+}))();
+const bscSushiVaultProtocol = /* @__PURE__ */ (() => Object.freeze({
+	kind: "liquidity",
+	role: "amm-factory",
+	protocolAddress: sushiswapV3Bsc.definition.contracts.factory.address,
+	deployment: sushiswapV3Bsc
+}))();
+const bscV3VaultDiscovery = /* @__PURE__ */ (() => Object.freeze({
+	amm: uniswapV3Bsc,
+	beaconNames: Object.freeze(["MultiPositionUniswapV3"])
+}))();
+const bscV3VaultBinding = /* @__PURE__ */ (() => Object.freeze({
+	readUnderlying: (context) => readUnderlyingForFactory(context, uniswapV3Bsc.definition.contracts.factory.address),
+	beaconNames: bscV3VaultDiscovery.beaconNames,
+	kind: "liquidity",
+	readSnapshot: readV3VaultAccounting,
+	createVault: (context) => new UniswapV3Vault(context),
+	beaconAddress: bscV3VaultIdentity.beacon,
+	implementationAddress: bscV3VaultIdentity.implementation,
+	implementationCodeHash: bscV3VaultIdentity.implementationCodeHash
+}))();
+const bscV3VaultProtocol = /* @__PURE__ */ (() => Object.freeze({
+	kind: "liquidity",
+	role: "amm-factory",
+	protocolAddress: uniswapV3Bsc.definition.contracts.factory.address,
+	deployment: uniswapV3Bsc
+}))();
+const baseSushiVaultDiscovery = /* @__PURE__ */ (() => Object.freeze({
+	amm: sushiswapV3Base,
+	beaconNames: Object.freeze(["MultiPositionSushi"])
+}))();
+const baseSushiVaultBinding = /* @__PURE__ */ (() => Object.freeze({
+	readUnderlying: (context) => readUnderlyingForFactory(context, sushiswapV3Base.definition.contracts.factory.address),
+	beaconNames: baseSushiVaultDiscovery.beaconNames,
+	kind: "liquidity",
+	readSnapshot: readV3VaultAccounting,
+	createVault: (context) => new UniswapV3Vault(context),
+	beaconAddress: baseSushiVaultIdentity.beacon,
+	implementationAddress: baseSushiVaultIdentity.implementation,
+	implementationCodeHash: baseSushiVaultIdentity.implementationCodeHash
+}))();
+const baseSushiVaultProtocol = /* @__PURE__ */ (() => Object.freeze({
+	kind: "liquidity",
+	role: "amm-factory",
+	protocolAddress: sushiswapV3Base.definition.contracts.factory.address,
+	deployment: sushiswapV3Base
+}))();
 //#endregion
 //#region src/vault/deployments/base.ts
 function createBaseVaultResolver() {
@@ -24678,7 +24819,16 @@ function createBaseVaultResolver() {
 			snapshotRuntime: integralVaultBatchReaderRuntime,
 			readSnapshot: readIntegralBulkSnapshot
 		},
-		...baseAerodromeVaultMappings
+		...baseAerodromeVaultMappings,
+		{
+			identity: baseSushiVaultIdentity,
+			factory: sushiswapV3Base.definition.contracts.factory.address,
+			runtime: v3VaultResolutionReaderRuntime,
+			binding: baseSushiVaultBinding,
+			snapshotRuntime: v3VaultBatchReaderRuntime,
+			helperCodeHash: baseSushiVaultIdentity.helperCodeHash,
+			readSnapshot: readV3BulkSnapshot
+		}
 	];
 	return Object.freeze({
 		reader: {
@@ -24701,12 +24851,14 @@ function createBaseVaultResolver() {
 		implementations: Object.freeze([
 			...baseV3VaultResolver.implementations,
 			...baseAerodromeVaultMappings.map((mapping) => mapping.binding),
-			baseIntegralVaultBinding
+			baseIntegralVaultBinding,
+			baseSushiVaultBinding
 		]),
 		protocols: Object.freeze([
 			...baseV3VaultResolver.protocols,
 			baseIntegralVaultProtocol,
-			...baseAerodromeVaultProtocols
+			...baseAerodromeVaultProtocols,
+			baseSushiVaultProtocol
 		])
 	});
 }
@@ -24723,6 +24875,7 @@ var base_default = /* @__PURE__ */ defineSteerNetwork({
 	}
 }, baseContracts, "https://api.subgraph.ormilabs.com/api/public/803c8c8c-be12-4188-8523-b9853e23051d/subgraphs/steer-protocol-base/beta/gn", [
 	uniswapV3Base,
+	sushiswapV3Base,
 	uniswapV4Base,
 	quickSwapIntegralBase,
 	aerodromeSlipstreamBase,
@@ -24731,6 +24884,7 @@ var base_default = /* @__PURE__ */ defineSteerNetwork({
 ], /* @__PURE__ */ createBaseVaultResolver(), /* @__PURE__ */ (() => Object.freeze([
 	...baseAerodromeVaultDiscovery,
 	baseV3VaultDiscovery,
+	baseSushiVaultDiscovery,
 	baseIntegralVaultDiscovery
 ]))());
 //#endregion
@@ -25950,14 +26104,33 @@ async function readV4BulkSnapshot(vault, data, rpc) {
 }
 //#endregion
 //#region src/vault/deployments/bsc.ts
-const mappings = /* @__PURE__ */ (() => Object.freeze([{
-	identity: bscPancakeVaultIdentity,
-	factory: pancakeSwapV3Bsc.definition.contracts.factory.address,
-	runtime: v3VaultResolutionReaderRuntime,
-	snapshotRuntime: fixedFeeV3VaultBatchReaderRuntime,
-	binding: bscPancakeVaultBinding,
-	readSnapshot: readV3BulkSnapshot
-}, v4BulkMapping(bscV4VaultIdentity, bscV4VaultBinding, uniswapV4Bsc.definition.contracts)]))();
+const mappings = /* @__PURE__ */ (() => Object.freeze([
+	{
+		identity: bscPancakeVaultIdentity,
+		factory: pancakeSwapV3Bsc.definition.contracts.factory.address,
+		runtime: v3VaultResolutionReaderRuntime,
+		snapshotRuntime: fixedFeeV3VaultBatchReaderRuntime,
+		binding: bscPancakeVaultBinding,
+		readSnapshot: readV3BulkSnapshot
+	},
+	...[{
+		identity: bscSushiVaultIdentity,
+		binding: bscSushiVaultBinding,
+		amm: sushiswapV3Bsc
+	}, {
+		identity: bscV3VaultIdentity,
+		binding: bscV3VaultBinding,
+		amm: uniswapV3Bsc
+	}].map(({ identity, binding, amm }) => ({
+		identity,
+		binding,
+		factory: amm.definition.contracts.factory.address,
+		runtime: v3VaultResolutionReaderRuntime,
+		snapshotRuntime: fixedFeeV3VaultBatchReaderRuntime,
+		readSnapshot: readV3BulkSnapshot
+	})),
+	v4BulkMapping(bscV4VaultIdentity, bscV4VaultBinding, uniswapV4Bsc.definition.contracts)
+]))();
 //#endregion
 //#region src/catalog/bsc.ts
 var bsc_default = /* @__PURE__ */ defineSteerNetwork({
@@ -25971,7 +26144,9 @@ var bsc_default = /* @__PURE__ */ defineSteerNetwork({
 }, bscContracts, "https://api.subgraph.ormilabs.com/api/public/803c8c8c-be12-4188-8523-b9853e23051d/subgraphs/steer-protocol-bsc-beta/prod/gn", [
 	pancakeSwapV3Bsc,
 	pancakeSwapInfinityCLBsc,
-	uniswapV4Bsc
+	uniswapV4Bsc,
+	sushiswapV3Bsc,
+	uniswapV3Bsc
 ], /* @__PURE__ */ (() => Object.freeze({
 	reader: {
 		readMany: (contexts, allowFailure) => readBulkVaults(contexts, mappings, allowFailure),
@@ -25983,14 +26158,29 @@ var bsc_default = /* @__PURE__ */ defineSteerNetwork({
 			await readContext(context.steer.context, { blockNumber: context.blockNumber });
 			const identity = await readRegisteredVaultIdentity(context);
 			if (!identity) return null;
-			if (sameAddress(identity.beaconAddress, bscPancakeVaultIdentity.beacon) && sameAddress(identity.implementationAddress, bscPancakeVaultIdentity.implementation)) await verifyV3Identity(context, identity);
+			if (findV3VaultIdentity(context.steer.context.chainId, identity.beaconAddress, identity.implementationAddress)) await verifyV3Identity(context, identity);
 			else await verifyV4VaultIdentity(context, identity);
 			return identity;
 		}
 	},
-	implementations: Object.freeze([bscPancakeVaultBinding, bscV4VaultBinding]),
-	protocols: Object.freeze([bscPancakeVaultProtocol, bscV4VaultProtocol])
-}))(), /* @__PURE__ */ Object.freeze([bscPancakeVaultDiscovery, bscV4VaultDiscovery]));
+	implementations: Object.freeze([
+		bscPancakeVaultBinding,
+		bscSushiVaultBinding,
+		bscV3VaultBinding,
+		bscV4VaultBinding
+	]),
+	protocols: Object.freeze([
+		bscPancakeVaultProtocol,
+		bscSushiVaultProtocol,
+		bscV3VaultProtocol,
+		bscV4VaultProtocol
+	])
+}))(), /* @__PURE__ */ Object.freeze([
+	bscPancakeVaultDiscovery,
+	bscSushiVaultDiscovery,
+	bscV3VaultDiscovery,
+	bscV4VaultDiscovery
+]));
 //#endregion
 //#region src/catalog/celo.ts
 var celo_default = /* @__PURE__ */ defineSteerNetwork({