@steerprotocol/sdk 4.0.0-next.7 → 4.0.0-next.8

package/README.md

@@ -90,7 +90,8 @@ interface VaultMetadata {
   readonly beaconName: string;
   readonly createdAt: string;
   readonly state: string | null;
-  readonly pool: Address | null;
+  /** Contract address or 32-byte V4 pool ID. */
+  readonly pool: Hex | null;
   readonly poolKey?: string | null;
   readonly token0: Address | null;
   readonly token1: Address | null;
@@ -102,6 +103,7 @@ interface VaultMetadata {
 This replaces address-only pages. Use `item.id` when passing a listed result to a vault getter.
 `decimals` and `createdAt` retain their indexed string representation. Null fields remain null;
 Unavailable indexed pool/token address fields represented by empty strings become `null`; the native zero address remains unchanged.
+`pool` preserves either a contract address or a 32-byte V4 pool ID.
 `poolKey` is omitted when the subgraph schema does not expose it. Only an explicit rejection of
 that optional field permits querying without it; other GraphQL and transport errors propagate.
 
@@ -1750,10 +1752,24 @@ This initial family implementation uses original contract reads and the existing
 reader with its deployless/override/Multicall fallback. A pinned resolved snapshot takes
 16 RPCs normally or 19 through compatibility; latest adds one. Bulk reads use bounded
 compatibility orchestration, not the optimized two-RPC V3/Algebra vault readers. BNB AMM
-listing is unavailable without a qualified indexer. ID-only and full-key reads work through
-the configured onchain data adapter; missing historical key-index entries need archival RPC.
-Steer indexed V4 beacon candidates are available, but token metadata is incomplete and
-V4 token search is not qualified. Direct address-based reads are independently verified.
+pool browsing and token filtering use the configured Uniswap V4 subgraph with the client's
+Graph API key or proxy. ID-only reads retain the onchain key resolver independently of indexer
+availability; missing historical key-index entries need archival RPC. Indexed keys whose mutable
+fees no longer match their IDs require RPC initialization logs to recover the original key.
+Steer indexed V4 token metadata is populated, and ERC-20 address, symbol and name searches are
+live-verified for the registered Reserve vaults. Direct address-based reads remain independently verified.
+
+```ts
+const amm = steer.getAmm({
+  chainId: ChainId.BSC,
+  protocol: AmmProtocol.Uniswap,
+  version: UniswapVersion.V4,
+});
+const pools = await amm.listPools({ token: { symbol: "USDC" }, limit: 25 });
+const nextPools = pools.nextCursor
+  ? await amm.listPools({ cursor: pools.nextCursor, limit: 25 })
+  : undefined;
+```
 See [deployment qualification and budgets](src/vault/adapters/uniswap-v4/qualification.md).
 
 ### Aerodrome Slipstream on Base
@@ -1902,7 +1918,8 @@ Pools absent from that contract's key index are recovered from their original in
 event using historical RPC state. Recovery searches recent history first; older pools require
 an archival provider. Missing history
 is an error, not a fabricated key. Pool browsing remains separate and requires an indexed adapter.
-Base retains its existing indexed adapter by default. BNB and Robinhood use RPC key resolution.
+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 PancakeSwap V3 vault snapshots

package/dist/index.cjs

@@ -140,12 +140,20 @@ var Operation = class {
 };
 //#endregion
 //#region src/rpc/read-errors.ts
+/** @internal Shared context or helper execution failed before a member outcome is available. */
+var SharedRpcReadError = class extends Error {
+	constructor(message, options) {
+		super(message, options);
+		this.name = "SharedRpcReadError";
+	}
+};
 /** Transport failures are shared by the request, never successful per-item outcomes. */
 function sharedReadError(error) {
 	const seen = /* @__PURE__ */ new Set();
 	let shared = false;
 	for (let cause = error; cause && typeof cause === "object" && !seen.has(cause);) {
 		seen.add(cause);
+		if (cause instanceof SharedRpcReadError) return true;
 		if (cause instanceof viem.ContractFunctionRevertedError) return false;
 		const value = cause;
 		if (value.name === "ContractFunctionRevertedError") return false;
@@ -176,15 +184,15 @@ function sameAddress(left, right) {
 	return left.toLowerCase() === right.toLowerCase();
 }
 function quantity(value) {
-	if (typeof value !== "string" || !/^0x(?:0|[1-9a-f][\da-f]*)$/i.test(value)) throw new Error("Invalid RPC quantity");
+	if (typeof value !== "string" || !/^0x(?:0|[1-9a-f][\da-f]*)$/i.test(value)) throw new SharedRpcReadError("Invalid RPC quantity");
 	return BigInt(value);
 }
 async function readContext(context, options) {
 	const transport = context.transport;
-	if (!transport) throw new Error(`No RPC transport configured for chain ${context.chainId}`);
-	if (quantity(await transport.request("eth_chainId", [])) !== BigInt(context.chainId)) throw new Error("RPC chain does not match requested chain");
+	if (!transport) throw new SharedRpcReadError(`No RPC transport configured for chain ${context.chainId}`);
+	if (quantity(await transport.request("eth_chainId", [])) !== BigInt(context.chainId)) throw new SharedRpcReadError("RPC chain does not match requested chain");
 	const blockNumber = options?.blockNumber ?? quantity(await transport.request("eth_blockNumber", []));
-	if (blockNumber < 0n) throw new Error("Block number must be nonnegative");
+	if (blockNumber < 0n) throw new SharedRpcReadError("Block number must be nonnegative");
 	return {
 		...context,
 		transport,
@@ -778,9 +786,8 @@ function readerUnsupported(error, mode) {
 	for (let cause = error; cause && typeof cause === "object" && !seen.has(cause);) {
 		seen.add(cause);
 		const value = cause;
-		if (cause instanceof viem.ContractFunctionRevertedError || hasRevertData(value.data)) return false;
+		if (hasReaderRevert(cause)) return false;
 		const message = typeof value.message === "string" ? value.message : "";
-		if (/execution reverted|out of gas|invalid opcode/i.test(message)) return false;
 		if (value.code === -32602 || value.code === -32004 || value.code === -32e3) {
 			const feature = mode === "deployless" ? /contract creation|deployless|creation calls?/i : /state.?overrides?/i;
 			const rejection = /not supported|unsupported|disabled/i;
@@ -797,11 +804,27 @@ function hasRevertData(data) {
 	const wrapped = data;
 	return [wrapped.data, wrapped.originalError?.data].some((value) => typeof value === "string" && /^0x[\da-f]+$/i.test(value));
 }
+/** A failed member contract must not become a shared malformed-response error. */
+function readerReverted(error) {
+	const seen = /* @__PURE__ */ new Set();
+	for (let cause = error; cause && typeof cause === "object" && !seen.has(cause);) {
+		seen.add(cause);
+		if (hasReaderRevert(cause)) return true;
+		cause = cause.cause;
+	}
+	return false;
+}
+function hasReaderRevert(error) {
+	const value = error;
+	if (value.name?.startsWith("AbiDecoding")) return false;
+	return error instanceof viem.ContractFunctionRevertedError || hasRevertData(value.data) || typeof value.message === "string" && /execution reverted|out of gas|invalid opcode/i.test(value.message);
+}
 //#endregion
 //#region src/rpc/reader.ts
 /** Ephemeral code-only execution. Vault callers verify original proxy code before overriding it. */
-function executeReader(context, code, mode, read) {
-	return read((0, viem.createClient)({ transport: (0, viem.custom)({ request: ({ method, params }) => context.transport.request(method, params ?? []) }, { retryCount: 0 }) }), mode === "deployless" ? {
+async function executeReader(context, code, mode, read) {
+	const client = (0, viem.createClient)({ transport: (0, viem.custom)({ request: ({ method, params }) => context.transport.request(method, params ?? []) }, { retryCount: 0 }) });
+	const execution = mode === "deployless" ? {
 		blockNumber: context.blockNumber,
 		code: code.bytecode
 	} : {
@@ -811,7 +834,13 @@ function executeReader(context, code, mode, read) {
 			address: code.address,
 			code: code.runtime
 		}]
-	});
+	};
+	try {
+		return await read(client, execution);
+	} catch (error) {
+		if (readerUnsupported(error, mode) || readerReverted(error) || sharedReadError(error)) throw error;
+		throw new SharedRpcReadError("Shared reader execution failed", { cause: error });
+	}
 }
 /** Compatibility is eligible only after both execution modes explicitly reject support. */
 async function readWithFallback(read) {
@@ -12239,6 +12268,11 @@ function nullableString(value) {
 	if (value === null || typeof value === "string") return value;
 	throw new Error("Malformed vault metadata string");
 }
+function poolIdentifier(value) {
+	if (value === null) return null;
+	if (typeof value === "string" && /^0x[0-9a-fA-F]{64}$/.test(value)) return value.toLowerCase();
+	return indexedAddress(value, true);
+}
 /** Validate and detach indexed data, preserving nulls and optional pool keys. */
 function vaultMetadata(value) {
 	const row = record(value);
@@ -12255,7 +12289,7 @@ function vaultMetadata(value) {
 		beaconName: row.beaconName,
 		createdAt: row.createdAt,
 		state: nullableString(row.state),
-		pool: row.pool === null ? null : indexedAddress(row.pool, true),
+		pool: poolIdentifier(row.pool),
 		...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),
@@ -12287,6 +12321,15 @@ function captureVaultMetadata(addresses, values) {
 	for (const address of requested) if (!records.has(address)) throw new Error(`Supplied vault metadata is missing address: ${address}`);
 	return records;
 }
+/** @internal A valid indexed response can omit individual vaults. */
+var MissingVaultMetadataError = class extends Error {
+	records;
+	constructor(records) {
+		super("Vault metadata is not indexed");
+		this.name = "MissingVaultMetadataError";
+		this.records = Object.freeze([...records]);
+	}
+};
 //#endregion
 //#region src/vault/resolver-types.ts
 let ProtocolContractRole = /* @__PURE__ */ function(ProtocolContractRole) {
@@ -12819,9 +12862,10 @@ var CatalogSteerDataAdapter = class extends SteerDataAdapter {
 			if (!unique.includes(metadata.id) || records.has(metadata.id)) throw new Error("Unexpected or duplicate vault metadata");
 			records.set(metadata.id, metadata);
 		}
+		if (unique.some((id) => !records.has(id))) throw new MissingVaultMetadataError([...records.values()]);
 		return Object.freeze(ids.map((id) => {
 			const metadata = records.get(id);
-			if (!metadata) throw new Error("Vault metadata is not indexed");
+			if (!metadata) throw new Error("Missing validated vault metadata");
 			return metadata;
 		}));
 	}
@@ -23045,17 +23089,20 @@ async function readV4PoolKey(context, contracts, id, options) {
 }
 //#endregion
 //#region src/amm/adapters/uniswap-v4/rpc-data-adapter.ts
-/** Pool-key resolution through onchain metadata, independent of indexed pool listing. */
+/** Onchain pool-key resolution with optional independent indexed listing. */
 var UniswapV4RpcDataAdapter = class extends V4PoolDataAdapter {
 	context;
 	contracts;
-	constructor(context, contracts) {
-		super({ kind: "rpc" });
+	#listing;
+	constructor(context, contracts, listing) {
+		super(listing?.definition ?? { kind: "rpc" });
 		this.context = context;
 		this.contracts = contracts;
+		this.#listing = listing;
 	}
-	async listPools() {
-		throw new Error("Uniswap V4 pool listing is not configured on this network");
+	async listPools(request, options) {
+		if (!this.#listing) throw new Error("Uniswap V4 pool listing is not configured on this network");
+		return this.#listing.listPools(request, options);
 	}
 	getPoolKey(id, options) {
 		return readV4PoolKey(this.context, this.contracts, id, options);
@@ -23073,8 +23120,11 @@ const uniswapV4Bsc = /* @__PURE__ */ new Deployment({
 		stateView: { address: "0xd13dd3d6e93f276fafc9db9e6bb47c1180aee0c4" },
 		quoter: { address: "0x9f75dd27d6664c475b90e105573e550ff69437b0" }
 	},
-	dataAdapter: { kind: "rpc" }
-}, (context, definition) => new UniswapV4(context, definition, new UniswapV4RpcDataAdapter(context, definition.contracts)));
+	dataAdapter: {
+		kind: "subgraph",
+		url: "https://gateway.thegraph.com/api/subgraphs/id/EAq1nJKgjnuKH6Gj4RFjCW7LcL7E2uipbncdwV7TTWkX"
+	}
+}, (context, definition) => new UniswapV4(context, definition, new UniswapV4RpcDataAdapter(context, definition.contracts, new UniswapV4DataAdapter(definition.dataAdapter, definition.contracts.poolManager.address, context))));
 //#endregion
 //#region src/amm/deployments/uniswap-v4-robinhood.ts
 /** Qualified Robinhood V4 deployment; full pool keys are available from vault contracts. */
@@ -24331,7 +24381,8 @@ var VaultResolver = class {
 			}) } : {}
 		});
 	}
-	#metadata(steer, addresses, supplied, onRequestError) {
+	#metadata(steer, addresses, options = {}) {
+		const { supplied, allowMissing, onRequestError } = options;
 		let pending;
 		return async (address) => {
 			if (supplied) {
@@ -24340,6 +24391,7 @@ var VaultResolver = class {
 				return metadata;
 			}
 			pending ??= steer.dataAdapter.getVaultMetadata(addresses).catch((error) => {
+				if (allowMissing && error instanceof MissingVaultMetadataError) return error.records;
 				if (onRequestError) return onRequestError(error);
 				throw error;
 			});
@@ -24374,10 +24426,14 @@ 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, metadata, (error) => {
-				metadataFailed = true;
-				metadataError = error;
-				throw error;
+			const loadMetadata = this.#metadata(steer, batch, {
+				...metadata ? { supplied: metadata } : {},
+				allowMissing: partial,
+				onRequestError: (error) => {
+					metadataFailed = true;
+					metadataError = error;
+					throw error;
+				}
 			});
 			const contexts = batch.map((address) => Object.freeze({
 				steer,
@@ -24433,10 +24489,13 @@ 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, void 0, (error) => {
-				metadataFailed = true;
-				metadataError = error;
-				throw error;
+			const loadMetadata = this.#metadata(steer, batch, {
+				allowMissing: partial,
+				onRequestError: (error) => {
+					metadataFailed = true;
+					metadataError = error;
+					throw error;
+				}
 			});
 			const contexts = batch.map((address) => Object.freeze({
 				steer,