@steerprotocol/sdk 4.0.0-next.3 → 4.0.0-next.4

package/README.md

@@ -134,6 +134,23 @@ entry points honor client `indexers`/`http` configuration and accept per-request
 timeout, and cancellation overrides as the second argument. The existing `getVault()` API and
 its onchain identity checks remain the loading path.
 
+When catalog records are already available, supply them through the optional `VaultLoadOptions.metadata` field:
+
+```ts
+const vaults = await steer.getVaults(ChainId.Base, records.map((record) => record.id), {
+  blockNumber: 100000n,
+  metadata: records,
+});
+```
+
+This skips metadata subgraph requests while retaining all onchain registration, implementation,
+protocol and pool checks. Records are matched by address case-insensitively and copied before IO.
+Supply one complete record per unique requested address. Missing, duplicate, unrequested or malformed
+records fail without a metadata fetch. Results preserve requested order and duplicate addresses.
+Omit `metadata` to retain the existing subgraph lookup. The same options work on `getVault`, typed
+vault getters and the connected-network loading methods. Metadata remains descriptive and is never
+forwarded to viem/RPC or used to establish verified identity. Snapshot/accounting options are unchanged.
+
 `getVaults(chainId, addresses, options)` returns the same resolved vault objects as `getVault()`
 in input order, including duplicate inputs. Base V3/Integral resolution uses a bulk Solidity reader:
 **two RPC requests per page of at most 64 vaults** at a pinned block. Latest reads add one shared

package/dist/index.cjs

@@ -11433,6 +11433,20 @@ function vaultMetadata(value) {
 		strategyToken: strategy === null ? null : Object.freeze({ id: String(strategy.id) })
 	});
 }
+/** Validate and detach caller-owned metadata before any asynchronous resolution. */
+function captureVaultMetadata(addresses, values) {
+	if (!Array.isArray(values)) throw new Error("Supplied vault metadata must be an array");
+	const requested = new Set(addresses.map((address) => address.toLowerCase()));
+	const records = /* @__PURE__ */ new Map();
+	for (const value of values) {
+		const metadata = vaultMetadata(value);
+		if (!requested.has(metadata.id)) throw new Error(`Supplied vault metadata contains an unrequested address: ${metadata.id}`);
+		if (records.has(metadata.id)) throw new Error(`Supplied vault metadata contains a duplicate address: ${metadata.id}`);
+		records.set(metadata.id, metadata);
+	}
+	for (const address of requested) if (!records.has(address)) throw new Error(`Supplied vault metadata is missing address: ${address}`);
+	return records;
+}
 //#endregion
 //#region src/vault/resolver-types.ts
 let ProtocolContractRole = /* @__PURE__ */ function(ProtocolContractRole) {
@@ -20954,9 +20968,14 @@ 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);
 	}
-	#metadata(steer, addresses) {
+	#metadata(steer, addresses, supplied) {
 		let pending;
 		return async (address) => {
+			if (supplied) {
+				const metadata = supplied.get(address.toLowerCase());
+				if (!metadata) throw new Error(`Supplied vault metadata is missing address: ${address}`);
+				return metadata;
+			}
 			pending ??= steer.dataAdapter.getVaultMetadata(addresses);
 			const metadata = (await pending).find((record) => record.id.toLowerCase() === address.toLowerCase());
 			if (!metadata) throw new Error("Vault metadata is not indexed");
@@ -20967,13 +20986,15 @@ var VaultResolver = class {
 	async resolveMany(steer, addresses, options) {
 		const inputs = [...addresses];
 		for (const address of inputs) addressKey(address);
+		const supplied = options?.metadata;
+		const metadata = supplied === void 0 ? void 0 : captureVaultMetadata(inputs, supplied);
 		if (!inputs.length) return Object.freeze([]);
 		const blockNumber = await this.#blockNumber(steer, options);
 		const result = [];
 		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);
+			const loadMetadata = this.#metadata(steer, batch, metadata);
 			const contexts = batch.map((address) => Object.freeze({
 				steer,
 				address,
@@ -21130,7 +21151,10 @@ var SteerNetwork = class {
 		return this.#vaultResolver().resolve(this, address, options);
 	}
 	async getVaults(addresses, options) {
-		if (!addresses.length) return Object.freeze([]);
+		if (!addresses.length) {
+			if (options?.metadata !== void 0) captureVaultMetadata(addresses, options.metadata);
+			return Object.freeze([]);
+		}
 		return this.#vaultResolver().resolveMany(this, addresses, options);
 	}
 	getVaultSnapshots(addresses, options) {