@gauntlet-xyz/sdk 2.5.0 → 3.1.1

package/dist/cjs/evm/userCurrentBalance.js

@@ -0,0 +1,268 @@
+"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 userCurrentBalance_exports = {};
+__export(userCurrentBalance_exports, {
+  getUserCurrentBalance: () => getUserCurrentBalance
+});
+module.exports = __toCommonJS(userCurrentBalance_exports);
+var import_viem = require("viem");
+var import_errors = require("../errors");
+var import_aeraContracts = require("./aeraContracts");
+var import_priceAndFeeCalculator = require("./aeraContracts/priceAndFeeCalculator");
+var import_v2 = require("./aeraContracts/v2");
+var import_provisionerV2 = require("./abis/provisionerV2");
+var import_types = require("./types");
+var import_constants = require("../constants");
+const LOG_CHUNK_CONCURRENCY = 16;
+const DEPOSIT_REQUESTED_V1_ABI = [
+  {
+    type: "event",
+    name: "DepositRequested",
+    inputs: [
+      { type: "address", name: "user", indexed: true },
+      { type: "address", name: "token", indexed: true },
+      { type: "uint256", name: "tokensIn", indexed: false },
+      { type: "uint256", name: "minUnitsOut", indexed: false },
+      { type: "uint256", name: "solverTip", indexed: false },
+      { type: "uint256", name: "deadline", indexed: false },
+      { type: "uint256", name: "maxPriceAge", indexed: false },
+      { type: "bool", name: "isFixedPrice", indexed: false },
+      { type: "bytes32", name: "depositRequestHash", indexed: false }
+    ]
+  }
+];
+const REDEEM_REQUESTED_V1_ABI = [
+  {
+    type: "event",
+    name: "RedeemRequested",
+    inputs: [
+      { type: "address", name: "user", indexed: true },
+      { type: "address", name: "token", indexed: true },
+      { type: "uint256", name: "minTokensOut", indexed: false },
+      { type: "uint256", name: "unitsIn", indexed: false },
+      { type: "uint256", name: "solverTip", indexed: false },
+      { type: "uint256", name: "deadline", indexed: false },
+      { type: "uint256", name: "maxPriceAge", indexed: false },
+      { type: "bool", name: "isFixedPrice", indexed: false },
+      { type: "bytes32", name: "redeemRequestHash", indexed: false }
+    ]
+  }
+];
+const provisionerV1StateAbi = (0, import_viem.parseAbi)([
+  "function asyncDepositHashes(bytes32 asyncDepositHash) view returns (bool exists)",
+  "function asyncRedeemHashes(bytes32 asyncRedeemHash) view returns (bool exists)"
+]);
+function dedupeByRequestHash(logs, hashKey) {
+  const seen = /* @__PURE__ */ new Set();
+  return logs.filter((log) => {
+    const hash = log.args[hashKey];
+    if (hash == null || seen.has(hash)) return false;
+    seen.add(hash);
+    return true;
+  });
+}
+async function requestScanStart(publicClient, chainId, blockNumber, days, cutoff) {
+  let span = (import_constants.BLOCKS_3_DAYS[chainId] ?? import_constants.DEFAULT_BLOCKS_3_DAYS) * BigInt(days) / 3n;
+  for (; ; ) {
+    if (span >= blockNumber) return 0n;
+    const start = blockNumber - span;
+    const block = await publicClient.getBlock({ blockNumber: start });
+    if (block.timestamp <= cutoff) return start;
+    span *= 2n;
+  }
+}
+async function mapInBatches(items, size, fn) {
+  const results = [];
+  for (let i = 0; i < items.length; i += size) {
+    results.push(...await Promise.all(items.slice(i, i + size).map(fn)));
+  }
+  return results;
+}
+async function queryDeploymentBalance(client, deployment, params) {
+  const publicClient = client.getPublicClient(deployment.chainId);
+  const { address } = params;
+  const token = deployment.supplyToken.length > 1 ? deployment.supplyToken.find((candidate) => candidate.symbol === params.assetSymbol) : deployment.supplyToken[0];
+  if (token === void 0)
+    throw new import_errors.UnsupportedAssetError(params.assetSymbol ?? "unknown", params.vaultId);
+  const snapshot = await publicClient.getBlock({ blockTag: "latest" });
+  if (snapshot.number === null) {
+    throw new import_errors.GauntletSDKError("The balance snapshot has no block number");
+  }
+  const blockNumber = snapshot.number;
+  const readOptions = { blockNumber };
+  const expirationDays = deployment.expirationDays ?? 3;
+  if (!Number.isSafeInteger(expirationDays) || expirationDays <= 0) {
+    throw new import_errors.GauntletSDKError("The request expiration must be a positive integer number of days");
+  }
+  const scanDays = Math.max(3, expirationDays);
+  const cutoff = snapshot.timestamp - BigInt(import_constants.DAY) * BigInt(scanDays);
+  const fromBlock = params.fromBlock ?? await requestScanStart(publicClient, deployment.chainId, blockNumber, scanDays, cutoff);
+  if (fromBlock < 0n || fromBlock > blockNumber) {
+    throw new import_errors.GauntletSDKError("The request scan range is invalid");
+  }
+  const vaultContract = (0, import_aeraContracts.getMultiDepositorVault)(publicClient, deployment.vaultAddress);
+  const [runtime, units] = await Promise.all([
+    (0, import_aeraContracts.resolveAeraRuntimeContracts)(publicClient, deployment, readOptions),
+    vaultContract.read.balanceOf([address], readOptions)
+  ]);
+  const provisionerAddress = runtime.provisioner.address;
+  const isV2 = runtime.provisioner.version === import_types.ContractVersion.V2;
+  const unitsLockedUntilPromise = isV2 ? (0, import_v2.getUserUnitsRefundableUntil)(publicClient, provisionerAddress, address, readOptions) : Promise.resolve(void 0);
+  const balance = await (0, import_priceAndFeeCalculator.convertUnitsToToken)(
+    publicClient,
+    runtime.feeCalculator.address,
+    runtime.feeCalculator.version,
+    deployment.vaultAddress,
+    token.address,
+    units,
+    readOptions
+  );
+  const chunks = [];
+  for (let cursor = fromBlock; cursor <= blockNumber; cursor += import_constants.LOG_PAGE_SIZE + 1n) {
+    const end = cursor + import_constants.LOG_PAGE_SIZE <= blockNumber ? cursor + import_constants.LOG_PAGE_SIZE : blockNumber;
+    chunks.push([cursor, end]);
+  }
+  const [depositPages, redeemPages] = await Promise.all([
+    mapInBatches(
+      chunks,
+      LOG_CHUNK_CONCURRENCY,
+      ([from, to]) => isV2 ? publicClient.getContractEvents({
+        address: provisionerAddress,
+        abi: import_provisionerV2.provisionerV2Abi,
+        eventName: "DepositRequested",
+        args: { receiver: address, token: token.address },
+        fromBlock: from,
+        toBlock: to
+      }) : publicClient.getContractEvents({
+        address: provisionerAddress,
+        abi: DEPOSIT_REQUESTED_V1_ABI,
+        eventName: "DepositRequested",
+        args: { user: address, token: token.address },
+        fromBlock: from,
+        toBlock: to
+      })
+    ),
+    mapInBatches(
+      chunks,
+      LOG_CHUNK_CONCURRENCY,
+      ([from, to]) => isV2 ? publicClient.getContractEvents({
+        address: provisionerAddress,
+        abi: import_provisionerV2.provisionerV2Abi,
+        eventName: "RedeemRequested",
+        args: { user: address, token: token.address },
+        fromBlock: from,
+        toBlock: to
+      }) : publicClient.getContractEvents({
+        address: provisionerAddress,
+        abi: REDEEM_REQUESTED_V1_ABI,
+        eventName: "RedeemRequested",
+        args: { user: address, token: token.address },
+        fromBlock: from,
+        toBlock: to
+      })
+    )
+  ]);
+  const depositLogs = dedupeByRequestHash(depositPages.flat(), "depositRequestHash");
+  const redeemLogs = dedupeByRequestHash(redeemPages.flat(), "redeemRequestHash");
+  const pendingChecks = await publicClient.multicall({
+    contracts: [
+      ...depositLogs.map((log) => ({
+        address: provisionerAddress,
+        abi: isV2 ? import_provisionerV2.provisionerV2Abi : provisionerV1StateAbi,
+        functionName: isV2 ? "asyncRequestHashes" : "asyncDepositHashes",
+        args: [log.args.depositRequestHash]
+      })),
+      ...redeemLogs.map((log) => ({
+        address: provisionerAddress,
+        abi: isV2 ? import_provisionerV2.provisionerV2Abi : provisionerV1StateAbi,
+        functionName: isV2 ? "asyncRequestHashes" : "asyncRedeemHashes",
+        args: [log.args.redeemRequestHash]
+      }))
+    ],
+    allowFailure: false,
+    blockNumber
+  });
+  const depositChecks = pendingChecks.slice(0, depositLogs.length);
+  const redeemChecks = pendingChecks.slice(depositLogs.length);
+  let pendingDeposit = 0n;
+  for (let i = 0; i < depositLogs.length; i++) {
+    if (depositChecks[i]) {
+      pendingDeposit += depositLogs[i].args.tokensIn ?? 0n;
+    }
+  }
+  let pendingWithdrawUnits = 0n;
+  for (let i = 0; i < redeemLogs.length; i++) {
+    if (redeemChecks[i]) {
+      pendingWithdrawUnits += redeemLogs[i].args.unitsIn ?? 0n;
+    }
+  }
+  const pendingWithdraw = pendingWithdrawUnits > 0n ? await (0, import_priceAndFeeCalculator.convertUnitsToToken)(
+    publicClient,
+    runtime.feeCalculator.address,
+    runtime.feeCalculator.version,
+    deployment.vaultAddress,
+    token.address,
+    pendingWithdrawUnits,
+    readOptions
+  ) : 0n;
+  const unitsLockedUntil = await unitsLockedUntilPromise;
+  return {
+    blockNumber,
+    fromBlock,
+    chain: import_constants.CHAIN_NAMES[deployment.chainId] ?? `chain-${deployment.chainId}`,
+    chainId: deployment.chainId,
+    token: token.address,
+    decimals: token.decimals,
+    pendingDeposit,
+    balance,
+    pendingWithdraw,
+    ...unitsLockedUntil !== void 0 ? { unitsLockedUntil } : {}
+  };
+}
+async function getUserCurrentBalance(client, params) {
+  params = { ...params };
+  const manifest = await client.manifest;
+  const vaultInfo = manifest.vaults.find((v) => v.vaultId === params.vaultId);
+  if (!vaultInfo) throw new import_errors.VaultNotFoundError(params.vaultId);
+  const evmDeployments = vaultInfo.deployments.filter(
+    (d) => d.chain === "evm" && d.vaultType === "multi-depositor"
+  );
+  if (vaultInfo.protocol !== "aera" || evmDeployments.length === 0) {
+    throw new import_errors.UnsupportedProtocolError(vaultInfo.protocol);
+  }
+  if (params.chainId !== void 0) {
+    const deployment = evmDeployments.find((d) => d.chainId === params.chainId);
+    if (!deployment) {
+      throw new import_errors.ChainMismatchError(
+        `${params.chainId}`,
+        evmDeployments.map((d) => `${d.chainId}`).join(", ")
+      );
+    }
+    return [await queryDeploymentBalance(client, deployment, params)];
+  }
+  if (params.fromBlock !== void 0 && evmDeployments.length > 1) {
+    throw new import_errors.GauntletSDKError("fromBlock requires chainId for a vault with several deployments");
+  }
+  return Promise.all(evmDeployments.map((d) => queryDeploymentBalance(client, d, params)));
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getUserCurrentBalance
+});
+//# sourceMappingURL=userCurrentBalance.js.map

package/dist/cjs/evm/userCurrentBalance.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/evm/userCurrentBalance.ts"],
+  "sourcesContent": ["import { parseAbi, type Address } from 'viem';\nimport type { GauntletClient } from '../client';\nimport type { EvmVaultDeployment } from './types';\nimport {\n  ChainMismatchError,\n  GauntletSDKError,\n  UnsupportedAssetError,\n  UnsupportedProtocolError,\n  VaultNotFoundError,\n} from '../errors';\nimport { getMultiDepositorVault, resolveAeraRuntimeContracts } from './aeraContracts';\nimport { convertUnitsToToken } from './aeraContracts/priceAndFeeCalculator';\nimport { getUserUnitsRefundableUntil } from './aeraContracts/v2';\nimport { provisionerV2Abi } from './abis/provisionerV2';\nimport { ContractVersion } from './types';\nimport {\n  BLOCKS_3_DAYS,\n  CHAIN_NAMES,\n  DAY,\n  DEFAULT_BLOCKS_3_DAYS,\n  LOG_PAGE_SIZE,\n} from '../constants';\n\n// Log chunks fetched at once per event type.\nconst LOG_CHUNK_CONCURRENCY = 16;\n\n// Inline as-const ABI items give viem full type inference for args and return types.\nconst DEPOSIT_REQUESTED_V1_ABI = [\n  {\n    type: 'event',\n    name: 'DepositRequested',\n    inputs: [\n      { type: 'address', name: 'user', indexed: true },\n      { type: 'address', name: 'token', indexed: true },\n      { type: 'uint256', name: 'tokensIn', indexed: false },\n      { type: 'uint256', name: 'minUnitsOut', indexed: false },\n      { type: 'uint256', name: 'solverTip', indexed: false },\n      { type: 'uint256', name: 'deadline', indexed: false },\n      { type: 'uint256', name: 'maxPriceAge', indexed: false },\n      { type: 'bool', name: 'isFixedPrice', indexed: false },\n      { type: 'bytes32', name: 'depositRequestHash', indexed: false },\n    ],\n  },\n] as const;\n\nconst REDEEM_REQUESTED_V1_ABI = [\n  {\n    type: 'event',\n    name: 'RedeemRequested',\n    inputs: [\n      { type: 'address', name: 'user', indexed: true },\n      { type: 'address', name: 'token', indexed: true },\n      { type: 'uint256', name: 'minTokensOut', indexed: false },\n      { type: 'uint256', name: 'unitsIn', indexed: false },\n      { type: 'uint256', name: 'solverTip', indexed: false },\n      { type: 'uint256', name: 'deadline', indexed: false },\n      { type: 'uint256', name: 'maxPriceAge', indexed: false },\n      { type: 'bool', name: 'isFixedPrice', indexed: false },\n      { type: 'bytes32', name: 'redeemRequestHash', indexed: false },\n    ],\n  },\n] as const;\n\nconst provisionerV1StateAbi = parseAbi([\n  'function asyncDepositHashes(bytes32 asyncDepositHash) view returns (bool exists)',\n  'function asyncRedeemHashes(bytes32 asyncRedeemHash) view returns (bool exists)',\n]);\n\nexport interface UserCurrentBalanceParams {\n  vaultId: string;\n  address: Address;\n  chainId?: number;\n  /** Required for deployments that support multiple assets, ignored otherwise. */\n  assetSymbol?: string;\n  /**\n   * Scan from this block, including expired requests that still hold escrow.\n   * Requires `chainId` for a vault with more than one deployment.\n   */\n  fromBlock?: bigint;\n}\n\nexport interface UserCurrentBalance {\n  /** Block used for balances, conversions, and request state. */\n  blockNumber: bigint;\n  /** First block included in the request scan. Older escrow is outside this result. */\n  fromBlock: bigint;\n  /** Chain identifier, e.g. \"base\" */\n  chain: string;\n  /** EVM chain id of the deployment, e.g. 8453 */\n  chainId: number;\n  token: Address;\n  decimals: number;\n  /** Assets queued via async deposit, not yet earning */\n  pendingDeposit: bigint;\n  /** Assets actively earning in the vault */\n  balance: bigint;\n  /** Assets queued via async withdraw, not yet claimable */\n  pendingWithdraw: bigint;\n  /** Timestamp until which this account cannot redeem vault units. */\n  unitsLockedUntil?: bigint;\n}\n\n// V2 legacy wrapper calls can emit both receiver-aware and legacy events for one request.\n// Keep one row per request hash before state checks and summing pending amounts.\nfunction dedupeByRequestHash<TLog extends { args: { [key: string]: unknown } }>(\n  logs: TLog[],\n  hashKey: 'depositRequestHash' | 'redeemRequestHash'\n): TLog[] {\n  const seen = new Set<unknown>();\n\n  return logs.filter((log) => {\n    const hash = log.args[hashKey];\n    // Drop malformed events and duplicates so one pending request cannot be counted twice.\n    if (hash == null || seen.has(hash)) return false;\n    seen.add(hash);\n    return true;\n  });\n}\n\n/** Step back by the expected block count, and widen until the block predates the cutoff. */\nasync function requestScanStart(\n  publicClient: ReturnType<GauntletClient['getPublicClient']>,\n  chainId: number,\n  blockNumber: bigint,\n  days: number,\n  cutoff: bigint\n): Promise<bigint> {\n  let span = ((BLOCKS_3_DAYS[chainId] ?? DEFAULT_BLOCKS_3_DAYS) * BigInt(days)) / 3n;\n  for (;;) {\n    if (span >= blockNumber) return 0n;\n    const start = blockNumber - span;\n    const block = await publicClient.getBlock({ blockNumber: start });\n    if (block.timestamp <= cutoff) return start;\n    span *= 2n;\n  }\n}\n\nasync function mapInBatches<T, P extends Promise<unknown>>(\n  items: T[],\n  size: number,\n  fn: (item: T) => P\n): Promise<Awaited<P>[]> {\n  const results: Awaited<P>[] = [];\n  for (let i = 0; i < items.length; i += size) {\n    results.push(...(await Promise.all(items.slice(i, i + size).map(fn))));\n  }\n  return results;\n}\n\nasync function queryDeploymentBalance(\n  client: GauntletClient,\n  deployment: EvmVaultDeployment,\n  params: UserCurrentBalanceParams\n): Promise<UserCurrentBalance> {\n  const publicClient = client.getPublicClient(deployment.chainId);\n  const { address } = params;\n  const token =\n    deployment.supplyToken.length > 1\n      ? deployment.supplyToken.find((candidate) => candidate.symbol === params.assetSymbol)\n      : deployment.supplyToken[0];\n  if (token === undefined)\n    throw new UnsupportedAssetError(params.assetSymbol ?? 'unknown', params.vaultId);\n  const snapshot = await publicClient.getBlock({ blockTag: 'latest' });\n  if (snapshot.number === null) {\n    throw new GauntletSDKError('The balance snapshot has no block number');\n  }\n  const blockNumber = snapshot.number;\n  const readOptions = { blockNumber };\n  const expirationDays = deployment.expirationDays ?? 3;\n  if (!Number.isSafeInteger(expirationDays) || expirationDays <= 0) {\n    throw new GauntletSDKError('The request expiration must be a positive integer number of days');\n  }\n  const scanDays = Math.max(3, expirationDays);\n  const cutoff = snapshot.timestamp - BigInt(DAY) * BigInt(scanDays);\n  const fromBlock =\n    params.fromBlock ??\n    (await requestScanStart(publicClient, deployment.chainId, blockNumber, scanDays, cutoff));\n  if (fromBlock < 0n || fromBlock > blockNumber) {\n    throw new GauntletSDKError('The request scan range is invalid');\n  }\n\n  const vaultContract = getMultiDepositorVault(publicClient, deployment.vaultAddress);\n  const [runtime, units] = await Promise.all([\n    resolveAeraRuntimeContracts(publicClient, deployment, readOptions),\n    vaultContract.read.balanceOf([address], readOptions),\n  ]);\n  const provisionerAddress = runtime.provisioner.address;\n  const isV2 = runtime.provisioner.version === ContractVersion.V2;\n  const unitsLockedUntilPromise = isV2\n    ? getUserUnitsRefundableUntil(publicClient, provisionerAddress, address, readOptions)\n    : Promise.resolve(undefined);\n\n  const balance = await convertUnitsToToken(\n    publicClient,\n    runtime.feeCalculator.address,\n    runtime.feeCalculator.version,\n    deployment.vaultAddress,\n    token.address,\n    units,\n    readOptions\n  );\n\n  // Compute block-range chunks to stay within the 10,000-block RPC limit, then fetch in bounded batches\n  const chunks: [bigint, bigint][] = [];\n  for (let cursor = fromBlock; cursor <= blockNumber; cursor += LOG_PAGE_SIZE + 1n) {\n    const end = cursor + LOG_PAGE_SIZE <= blockNumber ? cursor + LOG_PAGE_SIZE : blockNumber;\n    chunks.push([cursor, end]);\n  }\n\n  // Each map keeps LOG_CHUNK_CONCURRENCY queries in flight.\n  const [depositPages, redeemPages] = await Promise.all([\n    mapInBatches(chunks, LOG_CHUNK_CONCURRENCY, ([from, to]) =>\n      isV2\n        ? publicClient.getContractEvents({\n            address: provisionerAddress,\n            abi: provisionerV2Abi,\n            eventName: 'DepositRequested',\n            args: { receiver: address, token: token.address },\n            fromBlock: from,\n            toBlock: to,\n          })\n        : publicClient.getContractEvents({\n            address: provisionerAddress,\n            abi: DEPOSIT_REQUESTED_V1_ABI,\n            eventName: 'DepositRequested',\n            args: { user: address, token: token.address },\n            fromBlock: from,\n            toBlock: to,\n          })\n    ),\n    mapInBatches(chunks, LOG_CHUNK_CONCURRENCY, ([from, to]) =>\n      isV2\n        ? publicClient.getContractEvents({\n            address: provisionerAddress,\n            abi: provisionerV2Abi,\n            eventName: 'RedeemRequested',\n            args: { user: address, token: token.address },\n            fromBlock: from,\n            toBlock: to,\n          })\n        : publicClient.getContractEvents({\n            address: provisionerAddress,\n            abi: REDEEM_REQUESTED_V1_ABI,\n            eventName: 'RedeemRequested',\n            args: { user: address, token: token.address },\n            fromBlock: from,\n            toBlock: to,\n          })\n    ),\n  ]);\n\n  const depositLogs = dedupeByRequestHash(depositPages.flat(), 'depositRequestHash');\n  const redeemLogs = dedupeByRequestHash(redeemPages.flat(), 'redeemRequestHash');\n\n  // Check which requests are still pending on-chain via a single multicall\n  const pendingChecks = await publicClient.multicall({\n    contracts: [\n      ...depositLogs.map((log) => ({\n        address: provisionerAddress,\n        abi: isV2 ? provisionerV2Abi : provisionerV1StateAbi,\n        functionName: isV2 ? ('asyncRequestHashes' as const) : ('asyncDepositHashes' as const),\n        args: [log.args.depositRequestHash!] as const,\n      })),\n      ...redeemLogs.map((log) => ({\n        address: provisionerAddress,\n        abi: isV2 ? provisionerV2Abi : provisionerV1StateAbi,\n        functionName: isV2 ? ('asyncRequestHashes' as const) : ('asyncRedeemHashes' as const),\n        args: [log.args.redeemRequestHash!] as const,\n      })),\n    ],\n    allowFailure: false,\n    blockNumber,\n  });\n\n  const depositChecks = pendingChecks.slice(0, depositLogs.length);\n  const redeemChecks = pendingChecks.slice(depositLogs.length);\n\n  let pendingDeposit = 0n;\n  for (let i = 0; i < depositLogs.length; i++) {\n    if (depositChecks[i]) {\n      pendingDeposit += depositLogs[i].args.tokensIn ?? 0n;\n    }\n  }\n\n  let pendingWithdrawUnits = 0n;\n  for (let i = 0; i < redeemLogs.length; i++) {\n    if (redeemChecks[i]) {\n      pendingWithdrawUnits += redeemLogs[i].args.unitsIn ?? 0n;\n    }\n  }\n\n  const pendingWithdraw =\n    pendingWithdrawUnits > 0n\n      ? await convertUnitsToToken(\n          publicClient,\n          runtime.feeCalculator.address,\n          runtime.feeCalculator.version,\n          deployment.vaultAddress,\n          token.address,\n          pendingWithdrawUnits,\n          readOptions\n        )\n      : 0n;\n  const unitsLockedUntil = await unitsLockedUntilPromise;\n\n  return {\n    blockNumber,\n    fromBlock,\n    chain: CHAIN_NAMES[deployment.chainId] ?? `chain-${deployment.chainId}`,\n    chainId: deployment.chainId,\n    token: token.address,\n    decimals: token.decimals,\n    pendingDeposit,\n    balance,\n    pendingWithdraw,\n    ...(unitsLockedUntil !== undefined ? { unitsLockedUntil } : {}),\n  };\n}\n\n/**\n * Returns the current balance breakdown for a user across all EVM deployments of a vault.\n *\n * Queries the vault's on-chain state to split the user's position into three buckets:\n * - `balance` \u2014 assets actively earning inside the vault (converted from vault units to tokens).\n * - `pendingDeposit` \u2014 tokens submitted via async deposit but not yet processed by a solver.\n * - `pendingWithdraw` \u2014 vault units locked in a pending async redeem request (converted to tokens).\n *\n * Only supported for Aera multi-depositor vaults. Pending amounts are detected by scanning\n * the configured request lifetime, with a minimum of three days. Set `fromBlock` (with `chainId`\n * on a multi-chain vault) for older escrow.\n * All state reads use one block. The returned range identifies the scanned history.\n *\n * @param client - A configured `GauntletClient` instance with an EVM public client for each\n *   chain the vault is deployed on.\n * @param params - Query parameters including `vaultId`, the user `address`, and an optional\n *   `chainId` to limit the query to a single deployment.\n * @returns One `UserCurrentBalance` entry per chain queried.\n *\n * @throws {VaultNotFoundError} If the vault ID is not found in the manifest.\n * @throws {UnsupportedProtocolError} If the vault is not an Aera multi-depositor vault.\n * @throws {ChainMismatchError} If `chainId` is specified but no deployment exists for that chain.\n * @throws {UnsupportedAssetError} If a multi-asset deployment gets no matching `assetSymbol`.\n *\n * @example\n * ```ts\n * const balances = await getUserCurrentBalance(client, {\n *   vaultId: 'baseUsdcPrime',\n *   address: '0xYourWalletAddress',\n * });\n * // [{ chain: 'base', chainId: 8453, token: '0x...', decimals: 6, balance: 100_000_000n, pendingDeposit: 0n, pendingWithdraw: 0n }]\n * ```\n */\nexport async function getUserCurrentBalance(\n  client: GauntletClient,\n  params: UserCurrentBalanceParams\n): Promise<UserCurrentBalance[]> {\n  params = { ...params };\n  const manifest = await client.manifest;\n  const vaultInfo = manifest.vaults.find((v) => v.vaultId === params.vaultId);\n  if (!vaultInfo) throw new VaultNotFoundError(params.vaultId);\n\n  const evmDeployments = vaultInfo.deployments.filter(\n    (d): d is EvmVaultDeployment => d.chain === 'evm' && d.vaultType === 'multi-depositor'\n  );\n\n  if (vaultInfo.protocol !== 'aera' || evmDeployments.length === 0) {\n    throw new UnsupportedProtocolError(vaultInfo.protocol);\n  }\n\n  if (params.chainId !== undefined) {\n    const deployment = evmDeployments.find((d) => d.chainId === params.chainId);\n    if (!deployment) {\n      throw new ChainMismatchError(\n        `${params.chainId}`,\n        evmDeployments.map((d) => `${d.chainId}`).join(', ')\n      );\n    }\n    return [await queryDeploymentBalance(client, deployment, params)];\n  }\n  if (params.fromBlock !== undefined && evmDeployments.length > 1) {\n    throw new GauntletSDKError('fromBlock requires chainId for a vault with several deployments');\n  }\n\n  return Promise.all(evmDeployments.map((d) => queryDeploymentBalance(client, d, params)));\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/cjs/evm/vaults.d.ts

@@ -0,0 +1,44 @@
+import type { GauntletClient } from "../client.js";
+import type { VaultDeployment, VaultInfo } from "./types.js";
+export declare enum VaultId {
+    BaseUsdcPrime = "baseUsdcPrime",
+    EthUsdcPrime = "ethUsdcPrime",
+    AeraUsdAlpha = "gtusda",
+    EthUsdcPrimeV2 = "ethUsdcPrimeV2",
+    AeraLeveredFalconX = "gpaafalconx",
+    AeraSyrupUsdc = "gpsyrupusdc",
+    AeraBtcYield = "gtbtc",
+    AeraLeveredUscc = "gtuscc",
+    AeraLend = "gtlend",
+    AeraKastEth = "kasteth"
+}
+export interface VaultFilter {
+    /** Filter to vaults that have at least one EVM deployment on this chainId. */
+    chainId?: number;
+    protocol?: string;
+}
+/**
+ * Returns vaults from the bundled manifest, optionally filtered by chain and/or protocol.
+ * Does not make any network requests.
+ *
+ * @param client - A configured `GauntletClient` instance.
+ * @param filter - Optional filter criteria. `chainId` restricts results to vaults that have
+ *   at least one EVM deployment on that chain. `protocol` restricts results to a specific
+ *   protocol (e.g. `'aera'`, `'morpho'`).
+ * @returns Array of `VaultInfo` objects matching the filter, or all vaults if no filter is given.
+ *
+ * @example
+ * ```ts
+ * // All vaults on Base
+ * const vaults = await getVaults(client, { chainId: base.id });
+ *
+ * // All Aera vaults
+ * const aeraVaults = await getVaults(client, { protocol: 'aera' });
+ * ```
+ */
+export declare function getVaults(client: GauntletClient, filter?: VaultFilter): Promise<VaultInfo[]>;
+export declare function resolveVault(client: GauntletClient, vaultId: string, chainId?: string | number): Promise<{
+    vault: VaultDeployment;
+    protocol: string;
+} | undefined>;
+//# sourceMappingURL=vaults.d.ts.map

package/dist/cjs/evm/vaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vaults.d.ts","sourceRoot":"","sources":["../../../src/evm/vaults.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAkB;AAChD,OAAO,KAAK,EAAsB,eAAe,EAAE,SAAS,EAAE,mBAAgB;AAG9E,oBAAY,OAAO;IACjB,aAAa,kBAAkB;IAC/B,YAAY,iBAAiB;IAC7B,YAAY,WAAW;IACvB,cAAc,mBAAmB;IACjC,kBAAkB,gBAAgB;IAClC,aAAa,gBAAgB;IAC7B,YAAY,UAAU;IACtB,eAAe,WAAW;IAC1B,QAAQ,WAAW;IACnB,WAAW,YAAY;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,8EAA8E;IAC9E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,cAAc,EACtB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,SAAS,EAAE,CAAC,CAetB;AAED,wBAAsB,YAAY,CAChC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GACxB,OAAO,CAAC;IAAE,KAAK,EAAE,eAAe,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAAC,CA0BnE"}

package/dist/cjs/evm/vaults.js

@@ -0,0 +1,78 @@
+"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 vaults_exports = {};
+__export(vaults_exports, {
+  VaultId: () => VaultId,
+  getVaults: () => getVaults,
+  resolveVault: () => resolveVault
+});
+module.exports = __toCommonJS(vaults_exports);
+var import_chains = require("viem/chains");
+var import_errors = require("../errors");
+var VaultId = /* @__PURE__ */ ((VaultId2) => {
+  VaultId2["BaseUsdcPrime"] = "baseUsdcPrime";
+  VaultId2["EthUsdcPrime"] = "ethUsdcPrime";
+  VaultId2["AeraUsdAlpha"] = "gtusda";
+  VaultId2["EthUsdcPrimeV2"] = "ethUsdcPrimeV2";
+  VaultId2["AeraLeveredFalconX"] = "gpaafalconx";
+  VaultId2["AeraSyrupUsdc"] = "gpsyrupusdc";
+  VaultId2["AeraBtcYield"] = "gtbtc";
+  VaultId2["AeraLeveredUscc"] = "gtuscc";
+  VaultId2["AeraLend"] = "gtlend";
+  VaultId2["AeraKastEth"] = "kasteth";
+  return VaultId2;
+})(VaultId || {});
+async function getVaults(client, filter) {
+  const manifest = await client.manifest;
+  let vaults = manifest.vaults;
+  if (filter?.chainId) {
+    vaults = vaults.filter(
+      (v) => v.deployments.some((d) => d.chain === "evm" && d.chainId === filter.chainId)
+    );
+  }
+  if (filter?.protocol) {
+    vaults = vaults.filter((v) => v.protocol === filter.protocol);
+  }
+  return vaults;
+}
+async function resolveVault(client, vaultId, chainId) {
+  const manifest = await client.manifest;
+  const vaultInfo = manifest.vaults.find((v) => v.vaultId === vaultId);
+  if (!vaultInfo) return void 0;
+  const evmDeployments = vaultInfo.deployments.filter(
+    (d) => d.chain === "evm"
+  );
+  if (evmDeployments.length === 1) {
+    if (chainId !== void 0 && evmDeployments[0].chainId !== chainId) {
+      throw new import_errors.ChainMismatchError(`${chainId}`, `${evmDeployments[0].chainId}`);
+    }
+    return { vault: evmDeployments[0], protocol: vaultInfo.protocol };
+  }
+  const defaultChainId = chainId ?? import_chains.base.id;
+  const deployment = evmDeployments.find((d) => d.chainId === defaultChainId);
+  if (!deployment) return void 0;
+  return { vault: deployment, protocol: vaultInfo.protocol };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  VaultId,
+  getVaults,
+  resolveVault
+});
+//# sourceMappingURL=vaults.js.map

package/dist/cjs/evm/vaults.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/evm/vaults.ts"],
+  "sourcesContent": ["import { base } from 'viem/chains';\nimport type { GauntletClient } from '../client';\nimport type { EvmVaultDeployment, VaultDeployment, VaultInfo } from './types';\nimport { ChainMismatchError } from '../errors';\n\nexport enum VaultId {\n  BaseUsdcPrime = 'baseUsdcPrime',\n  EthUsdcPrime = 'ethUsdcPrime',\n  AeraUsdAlpha = 'gtusda',\n  EthUsdcPrimeV2 = 'ethUsdcPrimeV2',\n  AeraLeveredFalconX = 'gpaafalconx',\n  AeraSyrupUsdc = 'gpsyrupusdc',\n  AeraBtcYield = 'gtbtc',\n  AeraLeveredUscc = 'gtuscc',\n  AeraLend = 'gtlend',\n  AeraKastEth = 'kasteth',\n}\n\nexport interface VaultFilter {\n  /** Filter to vaults that have at least one EVM deployment on this chainId. */\n  chainId?: number;\n  protocol?: string;\n}\n\n/**\n * Returns vaults from the bundled manifest, optionally filtered by chain and/or protocol.\n * Does not make any network requests.\n *\n * @param client - A configured `GauntletClient` instance.\n * @param filter - Optional filter criteria. `chainId` restricts results to vaults that have\n *   at least one EVM deployment on that chain. `protocol` restricts results to a specific\n *   protocol (e.g. `'aera'`, `'morpho'`).\n * @returns Array of `VaultInfo` objects matching the filter, or all vaults if no filter is given.\n *\n * @example\n * ```ts\n * // All vaults on Base\n * const vaults = await getVaults(client, { chainId: base.id });\n *\n * // All Aera vaults\n * const aeraVaults = await getVaults(client, { protocol: 'aera' });\n * ```\n */\nexport async function getVaults(\n  client: GauntletClient,\n  filter?: VaultFilter\n): Promise<VaultInfo[]> {\n  const manifest = await client.manifest;\n  let vaults = manifest.vaults;\n\n  if (filter?.chainId) {\n    vaults = vaults.filter((v) =>\n      v.deployments.some((d) => d.chain === 'evm' && d.chainId === filter.chainId)\n    );\n  }\n\n  if (filter?.protocol) {\n    vaults = vaults.filter((v) => v.protocol === filter.protocol);\n  }\n\n  return vaults;\n}\n\nexport async function resolveVault(\n  client: GauntletClient,\n  vaultId: string,\n  chainId?: string | number\n): Promise<{ vault: VaultDeployment; protocol: string } | undefined> {\n  const manifest = await client.manifest;\n  const vaultInfo = manifest.vaults.find((v) => v.vaultId === vaultId);\n  if (!vaultInfo) return undefined;\n\n  const evmDeployments = vaultInfo.deployments.filter(\n    (d): d is EvmVaultDeployment => d.chain === 'evm'\n  );\n\n  if (evmDeployments.length === 1) {\n    // if user specifies a chain we need to make sure they get it\n    if (chainId !== undefined && evmDeployments[0].chainId !== chainId) {\n      throw new ChainMismatchError(`${chainId}`, `${evmDeployments[0].chainId}`);\n    }\n    // otherwise they're expected to know what chain\n    // the single chain vault they request is on\n    return { vault: evmDeployments[0], protocol: vaultInfo.protocol };\n  }\n\n  // now we default to base\n  const defaultChainId = chainId ?? base.id;\n\n  const deployment = evmDeployments.find((d) => d.chainId === defaultChainId);\n  if (!deployment) return undefined;\n\n  return { vault: deployment, protocol: vaultInfo.protocol };\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,oBAAqB;AAGrB,oBAAmC;AAE5B,IAAK,UAAL,kBAAKA,aAAL;AACL,EAAAA,SAAA,mBAAgB;AAChB,EAAAA,SAAA,kBAAe;AACf,EAAAA,SAAA,kBAAe;AACf,EAAAA,SAAA,oBAAiB;AACjB,EAAAA,SAAA,wBAAqB;AACrB,EAAAA,SAAA,mBAAgB;AAChB,EAAAA,SAAA,kBAAe;AACf,EAAAA,SAAA,qBAAkB;AAClB,EAAAA,SAAA,cAAW;AACX,EAAAA,SAAA,iBAAc;AAVJ,SAAAA;AAAA,GAAA;AAsCZ,eAAsB,UACpB,QACA,QACsB;AACtB,QAAM,WAAW,MAAM,OAAO;AAC9B,MAAI,SAAS,SAAS;AAEtB,MAAI,QAAQ,SAAS;AACnB,aAAS,OAAO;AAAA,MAAO,CAAC,MACtB,EAAE,YAAY,KAAK,CAAC,MAAM,EAAE,UAAU,SAAS,EAAE,YAAY,OAAO,OAAO;AAAA,IAC7E;AAAA,EACF;AAEA,MAAI,QAAQ,UAAU;AACpB,aAAS,OAAO,OAAO,CAAC,MAAM,EAAE,aAAa,OAAO,QAAQ;AAAA,EAC9D;AAEA,SAAO;AACT;AAEA,eAAsB,aACpB,QACA,SACA,SACmE;AACnE,QAAM,WAAW,MAAM,OAAO;AAC9B,QAAM,YAAY,SAAS,OAAO,KAAK,CAAC,MAAM,EAAE,YAAY,OAAO;AACnE,MAAI,CAAC,UAAW,QAAO;AAEvB,QAAM,iBAAiB,UAAU,YAAY;AAAA,IAC3C,CAAC,MAA+B,EAAE,UAAU;AAAA,EAC9C;AAEA,MAAI,eAAe,WAAW,GAAG;AAE/B,QAAI,YAAY,UAAa,eAAe,CAAC,EAAE,YAAY,SAAS;AAClE,YAAM,IAAI,iCAAmB,GAAG,OAAO,IAAI,GAAG,eAAe,CAAC,EAAE,OAAO,EAAE;AAAA,IAC3E;AAGA,WAAO,EAAE,OAAO,eAAe,CAAC,GAAG,UAAU,UAAU,SAAS;AAAA,EAClE;AAGA,QAAM,iBAAiB,WAAW,mBAAK;AAEvC,QAAM,aAAa,eAAe,KAAK,CAAC,MAAM,EAAE,YAAY,cAAc;AAC1E,MAAI,CAAC,WAAY,QAAO;AAExB,SAAO,EAAE,OAAO,YAAY,UAAU,UAAU,SAAS;AAC3D;",
+  "names": ["VaultId"]
+}

package/dist/cjs/evm/withdraw.d.ts

@@ -0,0 +1,75 @@
+import type { Address } from 'viem';
+import type { GauntletClient } from "../client.js";
+import type { SyncWithdrawQuoteBounds } from "./withdrawQuote.js";
+import { PreparedTx } from "../attribution/index.js";
+export type EvmWithdrawParams = {
+    vaultId: string;
+    chainId?: number;
+    assetSymbol?: string;
+    /** Request async (queued) or sync withdraw. Availability is read from live vault configuration. */
+    depositMode?: string;
+    receiver?: Address;
+    /** Slippage tolerance in basis points (e.g. 100 = 1%). Defaults to 100. */
+    slippageBps?: number;
+    /** Solver tip passed to async Aera provisioner requests. Defaults to 0. */
+    solverTip?: bigint;
+    /** Maximum price age passed to async Aera provisioner requests. Defaults to 10 days. */
+    maxPriceAge?: bigint;
+    /**
+     * Current sync quote bounds to pin instant withdraw transaction construction.
+     * Supplying bounds implies `depositMode: 'sync'`; explicit async requests are rejected.
+     */
+    syncWithdrawQuote?: SyncWithdrawQuoteBounds;
+    /** Limit a sync withdrawal to the shares reviewed before a rate change. */
+    maxShares?: bigint;
+} & ({
+    shares: bigint;
+    amount?: never;
+    entireAmount?: never;
+} | {
+    amount: bigint;
+    shares?: never;
+    entireAmount?: never;
+} | {
+    account?: Address;
+    entireAmount: true;
+    shares?: never;
+    amount?: never;
+});
+/**
+ * Builds the ordered list of EVM transactions required to withdraw from a Gauntlet vault.
+ *
+ * Specify the withdrawal amount as one of: `shares` (vault units), `amount` (underlying
+ * token amount), or `entireAmount: true` (full balance). Returns an ERC-20 approval
+ * (only when needed for async redeem) followed by the withdraw or async redeem request,
+ * each returned as a `PreparedTx` ready to be signed and sent.
+ *
+ * @param client - A configured `GauntletClient` instance with an EVM public client and wallet.
+ * @param params - Withdrawal parameters including the vault identifier and exactly one of
+ *   `shares`, `amount`, or `entireAmount`, plus optional chain, asset symbol, deposit mode,
+ *   and receiver address.
+ * @returns Ordered array of prepared transactions to execute in sequence.
+ *
+ * @throws {VaultNotFoundError} If the vault ID is not found in the manifest.
+ * @throws {AccountRequiredError} If no wallet account is set on the client.
+ * @throws {UnsupportedDepositModeError} If the requested withdrawal mode is not supported.
+ * @throws {UnsupportedAssetError} If the specified asset symbol is not accepted by the vault.
+ *
+ * @example
+ * ```ts
+ * // Withdraw by token amount
+ * const txs = await getWithdrawTx(client, {
+ *   vaultId: 'baseUsdcPrime',
+ *   amount: 50_000_000n, // 50 USDC (6 decimals)
+ * });
+ *
+ * // Withdraw entire balance
+ * const txs = await getWithdrawTx(client, {
+ *   vaultId: 'baseUsdcPrime',
+ *   entireAmount: true,
+ *   account: walletAddress,
+ * });
+ * ```
+ */
+export declare function getWithdrawTx(client: GauntletClient, params: EvmWithdrawParams): Promise<PreparedTx[]>;
+//# sourceMappingURL=withdraw.d.ts.map

package/dist/cjs/evm/withdraw.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"withdraw.d.ts","sourceRoot":"","sources":["../../../src/evm/withdraw.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAkB;AAEhD,OAAO,KAAK,EAAE,uBAAuB,EAAE,2BAAwB;AAE/D,OAAO,EAAoC,UAAU,EAAE,gCAAuB;AA0B9E,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,EAAE,MAAM,CAAC;IAEhB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mGAAmG;IACnG,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,2EAA2E;IAC3E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wFAAwF;IACxF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,uBAAuB,CAAC;IAC5C,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,CACA;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,KAAK,CAAC;IAAC,YAAY,CAAC,EAAE,KAAK,CAAA;CAAE,GACxD;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,KAAK,CAAC;IAAC,YAAY,CAAC,EAAE,KAAK,CAAA;CAAE,GACxD;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,YAAY,EAAE,IAAI,CAAC;IAAC,MAAM,CAAC,EAAE,KAAK,CAAC;IAAC,MAAM,CAAC,EAAE,KAAK,CAAA;CAAE,CAC5E,CAAC;AAwFF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAAC,UAAU,EAAE,CAAC,CAgHvB"}