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

package/dist/index.d.cts

@@ -555,7 +555,8 @@ interface VaultMetadata {
   readonly beaconName: string;
   readonly createdAt: string;
   readonly state: string | null;
-  readonly pool: Address | null;
+  /** Pool contract address or a 32-byte pool ID for singleton AMMs such as V4. */
+  readonly pool: Hex | null;
   readonly poolKey?: string | null;
   readonly token0: Address | null;
   readonly token1: Address | null;

package/dist/index.d.mts

@@ -555,7 +555,8 @@ interface VaultMetadata {
   readonly beaconName: string;
   readonly createdAt: string;
   readonly state: string | null;
-  readonly pool: Address | null;
+  /** Pool contract address or a 32-byte pool ID for singleton AMMs such as V4. */
+  readonly pool: Hex | null;
   readonly poolKey?: string | null;
   readonly token0: Address | null;
   readonly token1: Address | null;

package/dist/index.mjs

@@ -139,12 +139,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 ContractFunctionRevertedError) return false;
 		const value = cause;
 		if (value.name === "ContractFunctionRevertedError") return false;
@@ -175,15 +183,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,
@@ -777,9 +785,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 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;
@@ -796,11 +803,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 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(createClient({ transport: custom({ request: ({ method, params }) => context.transport.request(method, params ?? []) }, { retryCount: 0 }) }), mode === "deployless" ? {
+async function executeReader(context, code, mode, read) {
+	const client = createClient({ transport: custom({ request: ({ method, params }) => context.transport.request(method, params ?? []) }, { retryCount: 0 }) });
+	const execution = mode === "deployless" ? {
 		blockNumber: context.blockNumber,
 		code: code.bytecode
 	} : {
@@ -810,7 +833,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) {
@@ -12238,6 +12267,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);
@@ -12254,7 +12288,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),
@@ -12286,6 +12320,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) {
@@ -12818,9 +12861,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;
 		}));
 	}
@@ -23044,17 +23088,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);
@@ -23072,8 +23119,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. */
@@ -24330,7 +24380,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) {
@@ -24339,6 +24390,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;
 			});
@@ -24373,10 +24425,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,
@@ -24432,10 +24488,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,