@opendatalabs/vana-sdk 0.1.0-alpha.ffe4659 → 2.0.0

package/dist/utils/lazy-import.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Provides lazy module loading to avoid Temporal Dead Zone issues.
+ *
+ * @remarks
+ * This module implements a caching lazy import pattern to work around Turbopack's
+ * strict module initialization. Dependencies that access globals during initialization
+ * must be dynamically imported to prevent TDZ errors in Next.js environments.
+ *
+ * @see {@link https://github.com/vercel/next.js/issues/82632 | Turbopack TDZ Issue}
+ *
+ * @category Utilities
+ * @module utils/lazy-import
+ */
+/**
+ * Creates a cached lazy import function for deferred module loading.
+ *
+ * @remarks
+ * Caches the import promise (not the module) to prevent race conditions
+ * during concurrent first calls. On import failure, clears the cache to
+ * allow retry on next attempt.
+ *
+ * @typeParam T - The type of the module being imported
+ *
+ * @param importFn - Function that returns a dynamic import promise.
+ *   Should be a dynamic import expression like `() => import('module')`.
+ * @returns A function that returns the cached import promise
+ *
+ * @example
+ * ```typescript
+ * // Create lazy loader for heavy crypto library
+ * const getOpenPGP = lazyImport(() => import('openpgp'));
+ *
+ * // Use when needed (first call triggers import)
+ * const openpgp = await getOpenPGP();
+ * const encrypted = await openpgp.encrypt(data);
+ *
+ * // Subsequent calls return cached promise
+ * const openpgp2 = await getOpenPGP(); // Same instance
+ * ```
+ *
+ * @category Utilities
+ */
+export declare function lazyImport<T>(importFn: () => Promise<T>): () => Promise<T>;

package/dist/utils/lazy-import.js

@@ -0,0 +1,14 @@
+function lazyImport(importFn) {
+  let cached = null;
+  return () => {
+    cached ??= importFn().catch((err) => {
+      cached = null;
+      throw new Error("Failed to load module", { cause: err });
+    });
+    return cached;
+  };
+}
+export {
+  lazyImport
+};
+//# sourceMappingURL=lazy-import.js.map

package/dist/utils/lazy-import.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/lazy-import.ts"],"sourcesContent":["/**\n * Provides lazy module loading to avoid Temporal Dead Zone issues.\n *\n * @remarks\n * This module implements a caching lazy import pattern to work around Turbopack's\n * strict module initialization. Dependencies that access globals during initialization\n * must be dynamically imported to prevent TDZ errors in Next.js environments.\n *\n * @see {@link https://github.com/vercel/next.js/issues/82632 | Turbopack TDZ Issue}\n *\n * @category Utilities\n * @module utils/lazy-import\n */\n\n/**\n * Creates a cached lazy import function for deferred module loading.\n *\n * @remarks\n * Caches the import promise (not the module) to prevent race conditions\n * during concurrent first calls. On import failure, clears the cache to\n * allow retry on next attempt.\n *\n * @typeParam T - The type of the module being imported\n *\n * @param importFn - Function that returns a dynamic import promise.\n *   Should be a dynamic import expression like `() => import('module')`.\n * @returns A function that returns the cached import promise\n *\n * @example\n * ```typescript\n * // Create lazy loader for heavy crypto library\n * const getOpenPGP = lazyImport(() => import('openpgp'));\n *\n * // Use when needed (first call triggers import)\n * const openpgp = await getOpenPGP();\n * const encrypted = await openpgp.encrypt(data);\n *\n * // Subsequent calls return cached promise\n * const openpgp2 = await getOpenPGP(); // Same instance\n * ```\n *\n * @category Utilities\n */\nexport function lazyImport<T>(importFn: () => Promise<T>): () => Promise<T> {\n  let cached: Promise<T> | null = null;\n\n  return () => {\n    cached ??= importFn().catch((err) => {\n      // Clear cache on error so next attempt can retry\n      cached = null;\n      throw new Error(\"Failed to load module\", { cause: err });\n    });\n    return cached;\n  };\n}\n"],"mappings":"AA2CO,SAAS,WAAc,UAA8C;AAC1E,MAAI,SAA4B;AAEhC,SAAO,MAAM;AACX,eAAW,SAAS,EAAE,MAAM,CAAC,QAAQ;AAEnC,eAAS;AACT,YAAM,IAAI,MAAM,yBAAyB,EAAE,OAAO,IAAI,CAAC;AAAA,IACzD,CAAC;AACD,WAAO;AAAA,EACT;AACF;","names":[]}

package/dist/utils/multicall.cjs

@@ -0,0 +1,233 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var multicall_exports = {};
+__export(multicall_exports, {
+  analyzeCallsForOptimalConfig: () => analyzeCallsForOptimalConfig,
+  gasAwareMulticall: () => gasAwareMulticall
+});
+module.exports = __toCommonJS(multicall_exports);
+var import_viem = require("viem");
+var import_addresses = require("../config/addresses");
+const DEFAULT_OPTIONS = {
+  maxGasPerBatch: 10000000n,
+  // 10M gas - conservative default
+  maxCalldataBytes: 1e5,
+  // 100KB - works with most RPC providers
+  checkpointFrequency: {
+    calls: 32,
+    bytes: 8192
+    // 8KB
+  },
+  allowFailure: false
+};
+async function gasAwareMulticall(client, parameters, options = {}) {
+  const chainId = await client.getChainId();
+  const multicall3Address = options.multicallAddress ?? (0, import_addresses.getUtilityAddress)(chainId, "Multicall3");
+  const opts = {
+    ...DEFAULT_OPTIONS,
+    ...options,
+    multicallAddress: multicall3Address,
+    checkpointFrequency: {
+      ...DEFAULT_OPTIONS.checkpointFrequency,
+      ...options.checkpointFrequency
+    }
+  };
+  if (parameters.allowFailure !== void 0) {
+    opts.allowFailure = parameters.allowFailure;
+  }
+  const { contracts } = parameters;
+  if (!contracts || contracts.length === 0) {
+    return [];
+  }
+  const batches = await createBatches(
+    client,
+    contracts,
+    opts
+  );
+  const batchResults = await Promise.all(
+    batches.map((batch, index) => {
+      if (opts.onProgress && index > 0) {
+        const completed = batches.slice(0, index).reduce((sum, b) => sum + b.length, 0);
+        opts.onProgress(completed, contracts.length);
+      }
+      return client.multicall({
+        ...parameters,
+        contracts: batch,
+        multicallAddress: opts.multicallAddress,
+        allowFailure: opts.allowFailure
+      });
+    })
+  );
+  if (opts.onProgress) {
+    opts.onProgress(contracts.length, contracts.length);
+  }
+  return batchResults.flat();
+}
+async function createBatches(client, contracts, options) {
+  const batches = [];
+  let currentBatch = [];
+  let currentBytes = 0;
+  let lastCheckpointIndex = 0;
+  let lastCheckpointBytes = 0;
+  let lastEstimatedGas = 0n;
+  for (let i = 0; i < contracts.length; i++) {
+    const contract = contracts[i];
+    const encoded = encodeContractCall(contract);
+    const callBytes = (0, import_viem.size)(encoded);
+    const callsSinceCheckpoint = i - lastCheckpointIndex;
+    const bytesSinceCheckpoint = currentBytes - lastCheckpointBytes;
+    const needsCheckpoint = callsSinceCheckpoint >= options.checkpointFrequency.calls || bytesSinceCheckpoint >= options.checkpointFrequency.bytes;
+    if (needsCheckpoint && currentBatch.length > 0) {
+      try {
+        lastEstimatedGas = await estimateBatchGas(
+          client,
+          currentBatch,
+          options.multicallAddress
+        );
+        lastCheckpointIndex = i;
+        lastCheckpointBytes = currentBytes;
+      } catch (error) {
+        if (currentBatch.length > 1) {
+          const halfBatch = currentBatch.slice(
+            0,
+            Math.floor(currentBatch.length / 2)
+          );
+          batches.push(halfBatch);
+          currentBatch = currentBatch.slice(halfBatch.length);
+          currentBytes = calculateBatchSize(currentBatch);
+          lastCheckpointIndex = i;
+          lastCheckpointBytes = currentBytes;
+          lastEstimatedGas = 0n;
+        } else {
+          if (!options.allowFailure) {
+            throw new Error(
+              `Gas estimation failed for call ${i}: ${String(error)}`
+            );
+          }
+          currentBatch = [];
+          currentBytes = 0;
+          continue;
+        }
+      }
+    }
+    const wouldExceedCalldata = currentBytes + callBytes > options.maxCalldataBytes;
+    const wouldExceedGas = lastEstimatedGas > 0n && estimateNextGas(lastEstimatedGas, callsSinceCheckpoint + 1) > options.maxGasPerBatch;
+    if ((wouldExceedCalldata || wouldExceedGas) && currentBatch.length > 0) {
+      batches.push(currentBatch);
+      currentBatch = [];
+      currentBytes = 0;
+      lastCheckpointIndex = i;
+      lastCheckpointBytes = 0;
+      lastEstimatedGas = 0n;
+    }
+    currentBatch.push(contract);
+    currentBytes += callBytes;
+  }
+  if (currentBatch.length > 0) {
+    batches.push(currentBatch);
+  }
+  return batches;
+}
+function encodeContractCall(contract) {
+  const { abi, functionName, args } = contract;
+  return (0, import_viem.encodeFunctionData)({
+    abi,
+    functionName,
+    args
+  });
+}
+function calculateBatchSize(batch) {
+  return batch.reduce((total, contract) => {
+    const encoded = encodeContractCall(contract);
+    return total + (0, import_viem.size)(encoded);
+  }, 0);
+}
+async function estimateBatchGas(client, batch, multicallAddress) {
+  const calls = batch.map((contract) => ({
+    target: contract.address,
+    allowFailure: false,
+    callData: encodeContractCall(contract)
+  }));
+  const gas = await client.estimateGas({
+    to: multicallAddress,
+    data: (0, import_viem.encodeFunctionData)({
+      abi: multicall3Abi,
+      functionName: "aggregate3",
+      args: [calls]
+    })
+  });
+  return gas;
+}
+function estimateNextGas(lastGas, callsSinceCheckpoint) {
+  if (callsSinceCheckpoint === 0) return lastGas;
+  const avgGasPerCall = lastGas / BigInt(Math.max(1, callsSinceCheckpoint - 1));
+  const estimatedGas = lastGas + avgGasPerCall;
+  return estimatedGas * 110n / 100n;
+}
+const multicall3Abi = [
+  {
+    name: "aggregate3",
+    type: "function",
+    stateMutability: "payable",
+    inputs: [
+      {
+        name: "calls",
+        type: "tuple[]",
+        components: [
+          { name: "target", type: "address" },
+          { name: "allowFailure", type: "bool" },
+          { name: "callData", type: "bytes" }
+        ]
+      }
+    ],
+    outputs: [
+      {
+        name: "returnData",
+        type: "tuple[]",
+        components: [
+          { name: "success", type: "bool" },
+          { name: "returnData", type: "bytes" }
+        ]
+      }
+    ]
+  }
+];
+function analyzeCallsForOptimalConfig(contracts) {
+  const totalBytes = contracts.reduce((sum, contract) => {
+    const encoded = encodeContractCall(contract);
+    return sum + (0, import_viem.size)(encoded);
+  }, 0);
+  const avgBytesPerCall = totalBytes / contracts.length;
+  const checkpointFrequency = {
+    calls: avgBytesPerCall > 500 ? 16 : 32,
+    // More frequent for large calls
+    bytes: avgBytesPerCall > 500 ? 4096 : 8192
+  };
+  const maxCalldataBytes = totalBytes > 5e4 || contracts.length > 500 ? 128e3 : 1e5;
+  return {
+    checkpointFrequency,
+    maxCalldataBytes
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  analyzeCallsForOptimalConfig,
+  gasAwareMulticall
+});
+//# sourceMappingURL=multicall.cjs.map

package/dist/utils/multicall.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/multicall.ts"],"sourcesContent":["import type {\n  Address,\n  PublicClient,\n  MulticallParameters,\n  MulticallReturnType,\n  EncodeFunctionDataParameters,\n  Hex,\n  Abi,\n} from \"viem\";\nimport { encodeFunctionData, size } from \"viem\";\nimport { getUtilityAddress } from \"../config/addresses\";\nimport type { VanaChainId } from \"../types\";\n\n/**\n * Type for a contract function configuration used in multicall\n */\nexport interface ContractFunctionConfig {\n  address: Address;\n  abi: Abi;\n  functionName: string;\n  args?: readonly unknown[];\n}\n\n/**\n * Configuration options for gas-aware multicall batching.\n *\n * @remarks\n * These options control how the multicall utility splits large batches\n * to stay within gas and calldata limits. The defaults are conservative\n * to ensure compatibility across different chains and RPC providers.\n */\nexport interface GasAwareMulticallOptions {\n  /**\n   * Maximum gas per batch. Defaults to 10M (conservative for most chains).\n   *\n   * @remarks\n   * This should be set below the block gas limit of your target chain.\n   * Common values:\n   * - Vana mainnet: 30M (use 25M for safety)\n   * - Vana moksha: 30M (use 25M for safety)\n   * - Ethereum mainnet: 30M (use 25M for safety)\n   * - Arbitrum: 32M (use 25M for safety)\n   */\n  maxGasPerBatch?: bigint;\n\n  /**\n   * Maximum calldata size per batch in bytes. Defaults to 100KB.\n   *\n   * @remarks\n   * This is particularly important for L2 chains where calldata is expensive.\n   * Some RPC providers also have limits on request size.\n   */\n  maxCalldataBytes?: number;\n\n  /**\n   * How often to checkpoint gas estimates. Defaults to every 32 calls or 8KB.\n   *\n   * @remarks\n   * More frequent checkpoints give more accurate batching but require more\n   * RPC calls for gas estimation. The default balances accuracy vs performance.\n   */\n  checkpointFrequency?: {\n    /** Checkpoint after this many calls */\n    calls: number;\n    /** Checkpoint after this many bytes of calldata */\n    bytes: number;\n  };\n\n  /**\n   * Whether to allow partial batch failures. Defaults to false.\n   *\n   * @remarks\n   * When true, individual call failures won't fail the entire batch.\n   * This matches viem's multicall behavior with allowFailure option.\n   */\n  allowFailure?: boolean;\n\n  /**\n   * Optional multicall3 contract address override.\n   *\n   * @remarks\n   * By default, uses the standard multicall3 address deployed on most chains:\n   * 0xcA11bde05977b3631167028862bE2a173976CA11\n   */\n  multicallAddress?: Address;\n\n  /**\n   * Optional callback for tracking batching progress.\n   *\n   * @remarks\n   * Useful for showing progress in UI or debugging batch performance.\n   */\n  onProgress?: (completed: number, total: number) => void;\n}\n\n/**\n * Internal configuration with defaults applied\n */\ninterface NormalizedOptions {\n  maxGasPerBatch: bigint;\n  maxCalldataBytes: number;\n  checkpointFrequency: {\n    calls: number;\n    bytes: number;\n  };\n  allowFailure: boolean;\n  multicallAddress: Address;\n  onProgress?: (completed: number, total: number) => void;\n}\n\n/**\n * Default configuration values\n */\nconst DEFAULT_OPTIONS: Omit<NormalizedOptions, \"multicallAddress\"> = {\n  maxGasPerBatch: 10_000_000n, // 10M gas - conservative default\n  maxCalldataBytes: 100_000, // 100KB - works with most RPC providers\n  checkpointFrequency: {\n    calls: 32,\n    bytes: 8192, // 8KB\n  },\n  allowFailure: false,\n};\n\n/**\n * A gas-aware multicall function that automatically batches calls to stay within limits.\n *\n * @remarks\n * This function extends viem's multicall with intelligent batching based on:\n * - Actual gas costs (via periodic estimateGas calls)\n * - Calldata size limits\n * - Chain-specific constraints\n *\n * It uses a greedy algorithm with periodic checkpoints to efficiently determine\n * optimal batch sizes without making excessive RPC calls.\n *\n * @param client - The viem public client to use for RPC calls\n * @param parameters - The multicall parameters (same as viem's multicall)\n * @param options - Optional configuration for gas-aware batching\n * @returns The aggregated results from all batches\n *\n * @example\n * ```typescript\n * // Basic usage - drop-in replacement for viem's multicall\n * const results = await gasAwareMulticall(publicClient, {\n *   contracts: [\n *     { address: '0x...', abi: erc20Abi, functionName: 'balanceOf', args: [address1] },\n *     { address: '0x...', abi: erc20Abi, functionName: 'balanceOf', args: [address2] },\n *     // ... hundreds more calls\n *   ]\n * });\n *\n * // With custom limits for a specific chain\n * const results = await gasAwareMulticall(publicClient, {\n *   contracts: calls,\n * }, {\n *   maxGasPerBatch: 25_000_000n, // 25M for mainnet\n *   maxCalldataBytes: 128_000, // 128KB\n *   onProgress: (done, total) => console.log(`Progress: ${done}/${total}`)\n * });\n * ```\n */\nexport async function gasAwareMulticall<\n  TContracts extends readonly ContractFunctionConfig[],\n  TAllowFailure extends boolean = false,\n>(\n  client: PublicClient,\n  parameters: MulticallParameters<TContracts, TAllowFailure>,\n  options: GasAwareMulticallOptions = {},\n): Promise<MulticallReturnType<TContracts, TAllowFailure>> {\n  // Get the chain-specific Multicall3 address\n  const chainId = await client.getChainId();\n  const multicall3Address =\n    options.multicallAddress ??\n    getUtilityAddress(chainId as VanaChainId, \"Multicall3\");\n\n  // Normalize options with defaults\n  const opts: NormalizedOptions = {\n    ...DEFAULT_OPTIONS,\n    ...options,\n    multicallAddress: multicall3Address,\n    checkpointFrequency: {\n      ...DEFAULT_OPTIONS.checkpointFrequency,\n      ...options.checkpointFrequency,\n    },\n  };\n\n  // Override allowFailure if specified in parameters\n  if (parameters.allowFailure !== undefined) {\n    opts.allowFailure = parameters.allowFailure;\n  }\n\n  const { contracts } = parameters;\n  if (!contracts || contracts.length === 0) {\n    // TODO(TYPES): Empty array needs to match complex generic return type.\n    // Future improvement: Use conditional types to properly type empty results\n    // based on TAllowFailure parameter. Consider creating utility type helper.\n    return [] as unknown as MulticallReturnType<TContracts, TAllowFailure>;\n  }\n\n  // Execute batching algorithm\n  const batches = await createBatches(\n    client,\n    contracts as readonly ContractFunctionConfig[],\n    opts,\n  );\n\n  // Execute all batches in parallel\n  const batchResults = await Promise.all(\n    batches.map((batch, index) => {\n      // Report progress if callback provided\n      if (opts.onProgress && index > 0) {\n        const completed = batches\n          .slice(0, index)\n          .reduce((sum, b) => sum + b.length, 0);\n        opts.onProgress(completed, contracts.length);\n      }\n\n      // Execute batch using viem's multicall\n      return client.multicall({\n        ...parameters,\n        contracts: batch as typeof contracts,\n        multicallAddress: opts.multicallAddress,\n        allowFailure: opts.allowFailure,\n      });\n    }),\n  );\n\n  // Report final progress\n  if (opts.onProgress) {\n    opts.onProgress(contracts.length, contracts.length);\n  }\n\n  // Flatten results\n  return batchResults.flat() as MulticallReturnType<TContracts, TAllowFailure>;\n}\n\n/**\n * Creates optimally-sized batches using greedy algorithm with checkpoints.\n *\n * @param client - The viem public client for making RPC calls\n * @param contracts - Array of contract function configurations to batch\n * @param options - Normalized batching options with limits and settings\n * @returns Array of optimally-sized contract function configuration batches\n */\nasync function createBatches(\n  client: PublicClient,\n  contracts: readonly ContractFunctionConfig[],\n  options: NormalizedOptions,\n): Promise<ContractFunctionConfig[][]> {\n  const batches: ContractFunctionConfig[][] = [];\n  let currentBatch: ContractFunctionConfig[] = [];\n  let currentBytes = 0;\n  let lastCheckpointIndex = 0;\n  let lastCheckpointBytes = 0;\n  let lastEstimatedGas = 0n;\n\n  for (let i = 0; i < contracts.length; i++) {\n    const contract = contracts[i];\n\n    // Calculate encoded size for this call\n    const encoded = encodeContractCall(contract);\n    const callBytes = size(encoded);\n\n    // Check if we need a gas checkpoint\n    const callsSinceCheckpoint = i - lastCheckpointIndex;\n    const bytesSinceCheckpoint = currentBytes - lastCheckpointBytes;\n\n    const needsCheckpoint =\n      callsSinceCheckpoint >= options.checkpointFrequency.calls ||\n      bytesSinceCheckpoint >= options.checkpointFrequency.bytes;\n\n    // Perform checkpoint if needed\n    if (needsCheckpoint && currentBatch.length > 0) {\n      try {\n        lastEstimatedGas = await estimateBatchGas(\n          client,\n          currentBatch,\n          options.multicallAddress,\n        );\n        lastCheckpointIndex = i;\n        lastCheckpointBytes = currentBytes;\n      } catch (error) {\n        // If estimation fails, finalize current batch to be safe\n        if (currentBatch.length > 1) {\n          // Try with half the batch\n          const halfBatch = currentBatch.slice(\n            0,\n            Math.floor(currentBatch.length / 2),\n          );\n          batches.push(halfBatch);\n          currentBatch = currentBatch.slice(halfBatch.length);\n          currentBytes = calculateBatchSize(currentBatch);\n          lastCheckpointIndex = i;\n          lastCheckpointBytes = currentBytes;\n          lastEstimatedGas = 0n;\n        } else {\n          // Single call failed, skip it or throw based on allowFailure\n          if (!options.allowFailure) {\n            throw new Error(\n              `Gas estimation failed for call ${i}: ${String(error)}`,\n            );\n          }\n          currentBatch = [];\n          currentBytes = 0;\n          continue;\n        }\n      }\n    }\n\n    // Check if adding this call would exceed limits\n    const wouldExceedCalldata =\n      currentBytes + callBytes > options.maxCalldataBytes;\n    const wouldExceedGas =\n      lastEstimatedGas > 0n &&\n      estimateNextGas(lastEstimatedGas, callsSinceCheckpoint + 1) >\n        options.maxGasPerBatch;\n\n    // If we would exceed limits, finalize current batch\n    if ((wouldExceedCalldata || wouldExceedGas) && currentBatch.length > 0) {\n      batches.push(currentBatch);\n      currentBatch = [];\n      currentBytes = 0;\n      lastCheckpointIndex = i;\n      lastCheckpointBytes = 0;\n      lastEstimatedGas = 0n;\n    }\n\n    // Add call to current batch\n    currentBatch.push(contract);\n    currentBytes += callBytes;\n  }\n\n  // Add final batch if not empty\n  if (currentBatch.length > 0) {\n    batches.push(currentBatch);\n  }\n\n  return batches;\n}\n\n/**\n * Encodes a contract call to measure its calldata size.\n *\n * @param contract - The contract function configuration to encode\n * @returns Hex-encoded function data\n */\nfunction encodeContractCall(contract: ContractFunctionConfig): Hex {\n  const { abi, functionName, args } = contract;\n\n  return encodeFunctionData({\n    abi,\n    functionName,\n    args,\n  } as EncodeFunctionDataParameters);\n}\n\n/**\n * Calculates total encoded size of a batch.\n *\n * @param batch - Array of contract function configurations to measure\n * @returns Total size in bytes of all encoded calls in the batch\n */\nfunction calculateBatchSize(batch: ContractFunctionConfig[]): number {\n  return batch.reduce((total, contract) => {\n    const encoded = encodeContractCall(contract);\n    return total + size(encoded);\n  }, 0);\n}\n\n/**\n * Estimates gas for a batch of calls via multicall3.\n *\n * @param client - The viem public client for gas estimation\n * @param batch - Array of contract calls to estimate gas for\n * @param multicallAddress - The multicall3 contract address to use\n * @returns Estimated gas cost for executing the batch\n */\nasync function estimateBatchGas(\n  client: PublicClient,\n  batch: ContractFunctionConfig[],\n  multicallAddress: Address,\n): Promise<bigint> {\n  // Encode batch as multicall3 aggregate3 call\n  const calls = batch.map((contract) => ({\n    target: contract.address,\n    allowFailure: false,\n    callData: encodeContractCall(contract),\n  }));\n\n  // Estimate gas for the multicall\n  const gas = await client.estimateGas({\n    to: multicallAddress,\n    data: encodeFunctionData({\n      abi: multicall3Abi,\n      functionName: \"aggregate3\",\n      args: [calls],\n    }),\n  });\n\n  return gas;\n}\n\n/**\n * Extrapolates gas usage for calls added since last checkpoint.\n *\n * @remarks\n * Uses a conservative 1.1x multiplier for safety to account for gas usage variations.\n *\n * @param lastGas - The gas estimate from the last checkpoint\n * @param callsSinceCheckpoint - Number of calls added since the checkpoint\n * @returns Extrapolated gas estimate with safety margin\n */\nfunction estimateNextGas(\n  lastGas: bigint,\n  callsSinceCheckpoint: number,\n): bigint {\n  if (callsSinceCheckpoint === 0) return lastGas;\n\n  // Assume linear scaling with safety factor\n  const avgGasPerCall = lastGas / BigInt(Math.max(1, callsSinceCheckpoint - 1));\n  const estimatedGas = lastGas + avgGasPerCall;\n\n  // Apply 10% safety margin\n  return (estimatedGas * 110n) / 100n;\n}\n\n/**\n * Minimal multicall3 ABI for gas estimation\n */\nconst multicall3Abi = [\n  {\n    name: \"aggregate3\",\n    type: \"function\",\n    stateMutability: \"payable\",\n    inputs: [\n      {\n        name: \"calls\",\n        type: \"tuple[]\",\n        components: [\n          { name: \"target\", type: \"address\" },\n          { name: \"allowFailure\", type: \"bool\" },\n          { name: \"callData\", type: \"bytes\" },\n        ],\n      },\n    ],\n    outputs: [\n      {\n        name: \"returnData\",\n        type: \"tuple[]\",\n        components: [\n          { name: \"success\", type: \"bool\" },\n          { name: \"returnData\", type: \"bytes\" },\n        ],\n      },\n    ],\n  },\n] as const;\n\n/**\n * Utility function to analyze calls and predict optimal batch configuration\n *\n * @remarks\n * This function helps determine the best configuration for a specific set of calls\n * by analyzing their characteristics. Useful for optimizing repeated operations.\n *\n * @param contracts - The calls to analyze\n * @returns Suggested configuration based on call analysis\n */\nexport function analyzeCallsForOptimalConfig(\n  contracts: readonly ContractFunctionConfig[],\n): Pick<GasAwareMulticallOptions, \"checkpointFrequency\" | \"maxCalldataBytes\"> {\n  // Calculate average call size\n  const totalBytes = contracts.reduce((sum, contract) => {\n    const encoded = encodeContractCall(contract);\n    return sum + size(encoded);\n  }, 0);\n\n  const avgBytesPerCall = totalBytes / contracts.length;\n\n  // Suggest checkpoint frequency based on call density\n  const checkpointFrequency = {\n    calls: avgBytesPerCall > 500 ? 16 : 32, // More frequent for large calls\n    bytes: avgBytesPerCall > 500 ? 4096 : 8192,\n  };\n\n  // Suggest calldata limit based on total size\n  // For 1000 calls with small arrays, totalBytes will be much less than 500KB,\n  // so use number of contracts as additional signal\n  const maxCalldataBytes =\n    totalBytes > 50_000 || contracts.length > 500 ? 128_000 : 100_000;\n\n  return {\n    checkpointFrequency,\n    maxCalldataBytes,\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/utils/multicall.d.ts

@@ -0,0 +1,126 @@
+import type { Address, PublicClient, MulticallParameters, MulticallReturnType, Abi } from "viem";
+/**
+ * Type for a contract function configuration used in multicall
+ */
+export interface ContractFunctionConfig {
+    address: Address;
+    abi: Abi;
+    functionName: string;
+    args?: readonly unknown[];
+}
+/**
+ * Configuration options for gas-aware multicall batching.
+ *
+ * @remarks
+ * These options control how the multicall utility splits large batches
+ * to stay within gas and calldata limits. The defaults are conservative
+ * to ensure compatibility across different chains and RPC providers.
+ */
+export interface GasAwareMulticallOptions {
+    /**
+     * Maximum gas per batch. Defaults to 10M (conservative for most chains).
+     *
+     * @remarks
+     * This should be set below the block gas limit of your target chain.
+     * Common values:
+     * - Vana mainnet: 30M (use 25M for safety)
+     * - Vana moksha: 30M (use 25M for safety)
+     * - Ethereum mainnet: 30M (use 25M for safety)
+     * - Arbitrum: 32M (use 25M for safety)
+     */
+    maxGasPerBatch?: bigint;
+    /**
+     * Maximum calldata size per batch in bytes. Defaults to 100KB.
+     *
+     * @remarks
+     * This is particularly important for L2 chains where calldata is expensive.
+     * Some RPC providers also have limits on request size.
+     */
+    maxCalldataBytes?: number;
+    /**
+     * How often to checkpoint gas estimates. Defaults to every 32 calls or 8KB.
+     *
+     * @remarks
+     * More frequent checkpoints give more accurate batching but require more
+     * RPC calls for gas estimation. The default balances accuracy vs performance.
+     */
+    checkpointFrequency?: {
+        /** Checkpoint after this many calls */
+        calls: number;
+        /** Checkpoint after this many bytes of calldata */
+        bytes: number;
+    };
+    /**
+     * Whether to allow partial batch failures. Defaults to false.
+     *
+     * @remarks
+     * When true, individual call failures won't fail the entire batch.
+     * This matches viem's multicall behavior with allowFailure option.
+     */
+    allowFailure?: boolean;
+    /**
+     * Optional multicall3 contract address override.
+     *
+     * @remarks
+     * By default, uses the standard multicall3 address deployed on most chains:
+     * 0xcA11bde05977b3631167028862bE2a173976CA11
+     */
+    multicallAddress?: Address;
+    /**
+     * Optional callback for tracking batching progress.
+     *
+     * @remarks
+     * Useful for showing progress in UI or debugging batch performance.
+     */
+    onProgress?: (completed: number, total: number) => void;
+}
+/**
+ * A gas-aware multicall function that automatically batches calls to stay within limits.
+ *
+ * @remarks
+ * This function extends viem's multicall with intelligent batching based on:
+ * - Actual gas costs (via periodic estimateGas calls)
+ * - Calldata size limits
+ * - Chain-specific constraints
+ *
+ * It uses a greedy algorithm with periodic checkpoints to efficiently determine
+ * optimal batch sizes without making excessive RPC calls.
+ *
+ * @param client - The viem public client to use for RPC calls
+ * @param parameters - The multicall parameters (same as viem's multicall)
+ * @param options - Optional configuration for gas-aware batching
+ * @returns The aggregated results from all batches
+ *
+ * @example
+ * ```typescript
+ * // Basic usage - drop-in replacement for viem's multicall
+ * const results = await gasAwareMulticall(publicClient, {
+ *   contracts: [
+ *     { address: '0x...', abi: erc20Abi, functionName: 'balanceOf', args: [address1] },
+ *     { address: '0x...', abi: erc20Abi, functionName: 'balanceOf', args: [address2] },
+ *     // ... hundreds more calls
+ *   ]
+ * });
+ *
+ * // With custom limits for a specific chain
+ * const results = await gasAwareMulticall(publicClient, {
+ *   contracts: calls,
+ * }, {
+ *   maxGasPerBatch: 25_000_000n, // 25M for mainnet
+ *   maxCalldataBytes: 128_000, // 128KB
+ *   onProgress: (done, total) => console.log(`Progress: ${done}/${total}`)
+ * });
+ * ```
+ */
+export declare function gasAwareMulticall<TContracts extends readonly ContractFunctionConfig[], TAllowFailure extends boolean = false>(client: PublicClient, parameters: MulticallParameters<TContracts, TAllowFailure>, options?: GasAwareMulticallOptions): Promise<MulticallReturnType<TContracts, TAllowFailure>>;
+/**
+ * Utility function to analyze calls and predict optimal batch configuration
+ *
+ * @remarks
+ * This function helps determine the best configuration for a specific set of calls
+ * by analyzing their characteristics. Useful for optimizing repeated operations.
+ *
+ * @param contracts - The calls to analyze
+ * @returns Suggested configuration based on call analysis
+ */
+export declare function analyzeCallsForOptimalConfig(contracts: readonly ContractFunctionConfig[]): Pick<GasAwareMulticallOptions, "checkpointFrequency" | "maxCalldataBytes">;

package/dist/utils/multicall.js

@@ -0,0 +1,208 @@
+import { encodeFunctionData, size } from "viem";
+import { getUtilityAddress } from "../config/addresses";
+const DEFAULT_OPTIONS = {
+  maxGasPerBatch: 10000000n,
+  // 10M gas - conservative default
+  maxCalldataBytes: 1e5,
+  // 100KB - works with most RPC providers
+  checkpointFrequency: {
+    calls: 32,
+    bytes: 8192
+    // 8KB
+  },
+  allowFailure: false
+};
+async function gasAwareMulticall(client, parameters, options = {}) {
+  const chainId = await client.getChainId();
+  const multicall3Address = options.multicallAddress ?? getUtilityAddress(chainId, "Multicall3");
+  const opts = {
+    ...DEFAULT_OPTIONS,
+    ...options,
+    multicallAddress: multicall3Address,
+    checkpointFrequency: {
+      ...DEFAULT_OPTIONS.checkpointFrequency,
+      ...options.checkpointFrequency
+    }
+  };
+  if (parameters.allowFailure !== void 0) {
+    opts.allowFailure = parameters.allowFailure;
+  }
+  const { contracts } = parameters;
+  if (!contracts || contracts.length === 0) {
+    return [];
+  }
+  const batches = await createBatches(
+    client,
+    contracts,
+    opts
+  );
+  const batchResults = await Promise.all(
+    batches.map((batch, index) => {
+      if (opts.onProgress && index > 0) {
+        const completed = batches.slice(0, index).reduce((sum, b) => sum + b.length, 0);
+        opts.onProgress(completed, contracts.length);
+      }
+      return client.multicall({
+        ...parameters,
+        contracts: batch,
+        multicallAddress: opts.multicallAddress,
+        allowFailure: opts.allowFailure
+      });
+    })
+  );
+  if (opts.onProgress) {
+    opts.onProgress(contracts.length, contracts.length);
+  }
+  return batchResults.flat();
+}
+async function createBatches(client, contracts, options) {
+  const batches = [];
+  let currentBatch = [];
+  let currentBytes = 0;
+  let lastCheckpointIndex = 0;
+  let lastCheckpointBytes = 0;
+  let lastEstimatedGas = 0n;
+  for (let i = 0; i < contracts.length; i++) {
+    const contract = contracts[i];
+    const encoded = encodeContractCall(contract);
+    const callBytes = size(encoded);
+    const callsSinceCheckpoint = i - lastCheckpointIndex;
+    const bytesSinceCheckpoint = currentBytes - lastCheckpointBytes;
+    const needsCheckpoint = callsSinceCheckpoint >= options.checkpointFrequency.calls || bytesSinceCheckpoint >= options.checkpointFrequency.bytes;
+    if (needsCheckpoint && currentBatch.length > 0) {
+      try {
+        lastEstimatedGas = await estimateBatchGas(
+          client,
+          currentBatch,
+          options.multicallAddress
+        );
+        lastCheckpointIndex = i;
+        lastCheckpointBytes = currentBytes;
+      } catch (error) {
+        if (currentBatch.length > 1) {
+          const halfBatch = currentBatch.slice(
+            0,
+            Math.floor(currentBatch.length / 2)
+          );
+          batches.push(halfBatch);
+          currentBatch = currentBatch.slice(halfBatch.length);
+          currentBytes = calculateBatchSize(currentBatch);
+          lastCheckpointIndex = i;
+          lastCheckpointBytes = currentBytes;
+          lastEstimatedGas = 0n;
+        } else {
+          if (!options.allowFailure) {
+            throw new Error(
+              `Gas estimation failed for call ${i}: ${String(error)}`
+            );
+          }
+          currentBatch = [];
+          currentBytes = 0;
+          continue;
+        }
+      }
+    }
+    const wouldExceedCalldata = currentBytes + callBytes > options.maxCalldataBytes;
+    const wouldExceedGas = lastEstimatedGas > 0n && estimateNextGas(lastEstimatedGas, callsSinceCheckpoint + 1) > options.maxGasPerBatch;
+    if ((wouldExceedCalldata || wouldExceedGas) && currentBatch.length > 0) {
+      batches.push(currentBatch);
+      currentBatch = [];
+      currentBytes = 0;
+      lastCheckpointIndex = i;
+      lastCheckpointBytes = 0;
+      lastEstimatedGas = 0n;
+    }
+    currentBatch.push(contract);
+    currentBytes += callBytes;
+  }
+  if (currentBatch.length > 0) {
+    batches.push(currentBatch);
+  }
+  return batches;
+}
+function encodeContractCall(contract) {
+  const { abi, functionName, args } = contract;
+  return encodeFunctionData({
+    abi,
+    functionName,
+    args
+  });
+}
+function calculateBatchSize(batch) {
+  return batch.reduce((total, contract) => {
+    const encoded = encodeContractCall(contract);
+    return total + size(encoded);
+  }, 0);
+}
+async function estimateBatchGas(client, batch, multicallAddress) {
+  const calls = batch.map((contract) => ({
+    target: contract.address,
+    allowFailure: false,
+    callData: encodeContractCall(contract)
+  }));
+  const gas = await client.estimateGas({
+    to: multicallAddress,
+    data: encodeFunctionData({
+      abi: multicall3Abi,
+      functionName: "aggregate3",
+      args: [calls]
+    })
+  });
+  return gas;
+}
+function estimateNextGas(lastGas, callsSinceCheckpoint) {
+  if (callsSinceCheckpoint === 0) return lastGas;
+  const avgGasPerCall = lastGas / BigInt(Math.max(1, callsSinceCheckpoint - 1));
+  const estimatedGas = lastGas + avgGasPerCall;
+  return estimatedGas * 110n / 100n;
+}
+const multicall3Abi = [
+  {
+    name: "aggregate3",
+    type: "function",
+    stateMutability: "payable",
+    inputs: [
+      {
+        name: "calls",
+        type: "tuple[]",
+        components: [
+          { name: "target", type: "address" },
+          { name: "allowFailure", type: "bool" },
+          { name: "callData", type: "bytes" }
+        ]
+      }
+    ],
+    outputs: [
+      {
+        name: "returnData",
+        type: "tuple[]",
+        components: [
+          { name: "success", type: "bool" },
+          { name: "returnData", type: "bytes" }
+        ]
+      }
+    ]
+  }
+];
+function analyzeCallsForOptimalConfig(contracts) {
+  const totalBytes = contracts.reduce((sum, contract) => {
+    const encoded = encodeContractCall(contract);
+    return sum + size(encoded);
+  }, 0);
+  const avgBytesPerCall = totalBytes / contracts.length;
+  const checkpointFrequency = {
+    calls: avgBytesPerCall > 500 ? 16 : 32,
+    // More frequent for large calls
+    bytes: avgBytesPerCall > 500 ? 4096 : 8192
+  };
+  const maxCalldataBytes = totalBytes > 5e4 || contracts.length > 500 ? 128e3 : 1e5;
+  return {
+    checkpointFrequency,
+    maxCalldataBytes
+  };
+}
+export {
+  analyzeCallsForOptimalConfig,
+  gasAwareMulticall
+};
+//# sourceMappingURL=multicall.js.map