@gauntlet-xyz/sdk 2.5.0 → 3.0.1

package/dist/cjs/evm/userCurrentBalance.js

@@ -0,0 +1,225 @@
+"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 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 queryDeploymentBalance(client, deployment, address) {
+  const publicClient = client.getPublicClient(deployment.chainId);
+  const token = deployment.supplyToken[0];
+  const vaultContract = (0, import_aeraContracts.getMultiDepositorVault)(publicClient, deployment.vaultAddress);
+  const [runtime, units] = await Promise.all([
+    (0, import_aeraContracts.resolveAeraRuntimeContracts)(publicClient, deployment),
+    vaultContract.read.balanceOf([address])
+  ]);
+  const provisionerAddress = runtime.provisioner.address;
+  const isV2 = runtime.provisioner.version === import_types.ContractVersion.V2;
+  const unitsLockedUntilPromise = isV2 ? (0, import_v2.getUserUnitsRefundableUntil)(publicClient, provisionerAddress, address) : Promise.resolve(void 0);
+  const balance = await (0, import_priceAndFeeCalculator.convertUnitsToToken)(
+    publicClient,
+    runtime.feeCalculator.address,
+    runtime.feeCalculator.version,
+    deployment.vaultAddress,
+    token.address,
+    units
+  );
+  const currentBlock = await publicClient.getBlockNumber();
+  const lookback = import_constants.BLOCKS_3_DAYS[deployment.chainId] ?? import_constants.DEFAULT_BLOCKS_3_DAYS;
+  const fromBlock = currentBlock > lookback ? currentBlock - lookback : 0n;
+  const chunks = [];
+  for (let cursor = fromBlock; cursor <= currentBlock; cursor += import_constants.LOG_PAGE_SIZE + 1n) {
+    const end = cursor + import_constants.LOG_PAGE_SIZE <= currentBlock ? cursor + import_constants.LOG_PAGE_SIZE : currentBlock;
+    chunks.push([cursor, end]);
+  }
+  const [depositPages, redeemPages] = await Promise.all([
+    Promise.all(
+      chunks.map(
+        ([from, to]) => isV2 ? publicClient.getContractEvents({
+          address: provisionerAddress,
+          abi: import_provisionerV2.provisionerV2Abi,
+          eventName: "DepositRequested",
+          args: { receiver: address },
+          fromBlock: from,
+          toBlock: to
+        }) : publicClient.getContractEvents({
+          address: provisionerAddress,
+          abi: DEPOSIT_REQUESTED_V1_ABI,
+          eventName: "DepositRequested",
+          args: { user: address },
+          fromBlock: from,
+          toBlock: to
+        })
+      )
+    ),
+    Promise.all(
+      chunks.map(
+        ([from, to]) => isV2 ? publicClient.getContractEvents({
+          address: provisionerAddress,
+          abi: import_provisionerV2.provisionerV2Abi,
+          eventName: "RedeemRequested",
+          args: { user: address },
+          fromBlock: from,
+          toBlock: to
+        }) : publicClient.getContractEvents({
+          address: provisionerAddress,
+          abi: REDEEM_REQUESTED_V1_ABI,
+          eventName: "RedeemRequested",
+          args: { user: 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
+  });
+  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
+  ) : 0n;
+  const unitsLockedUntil = await unitsLockedUntilPromise;
+  return {
+    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) {
+  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.address)];
+  }
+  return Promise.all(evmDeployments.map((d) => queryDeploymentBalance(client, d, params.address)));
+}
+// 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 { ChainMismatchError, UnsupportedProtocolError, VaultNotFoundError } 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 { BLOCKS_3_DAYS, CHAIN_NAMES, DEFAULT_BLOCKS_3_DAYS, LOG_PAGE_SIZE } from '../constants';\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}\n\nexport interface UserCurrentBalance {\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\nasync function queryDeploymentBalance(\n  client: GauntletClient,\n  deployment: EvmVaultDeployment,\n  address: Address\n): Promise<UserCurrentBalance> {\n  const publicClient = client.getPublicClient(deployment.chainId);\n  const token = deployment.supplyToken[0];\n\n  const vaultContract = getMultiDepositorVault(publicClient, deployment.vaultAddress);\n  const [runtime, units] = await Promise.all([\n    resolveAeraRuntimeContracts(publicClient, deployment),\n    vaultContract.read.balanceOf([address]),\n  ]);\n  const provisionerAddress = runtime.provisioner.address;\n  const isV2 = runtime.provisioner.version === ContractVersion.V2;\n  const unitsLockedUntilPromise = isV2\n    ? getUserUnitsRefundableUntil(publicClient, provisionerAddress, address)\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  );\n\n  // Look back ~3 days for pending async requests\n  const currentBlock = await publicClient.getBlockNumber();\n  const lookback = BLOCKS_3_DAYS[deployment.chainId] ?? DEFAULT_BLOCKS_3_DAYS;\n  const fromBlock = currentBlock > lookback ? currentBlock - lookback : 0n;\n\n  // Compute block-range chunks to stay within the 10,000-block RPC limit, then fetch in parallel\n  const chunks: [bigint, bigint][] = [];\n  for (let cursor = fromBlock; cursor <= currentBlock; cursor += LOG_PAGE_SIZE + 1n) {\n    const end = cursor + LOG_PAGE_SIZE <= currentBlock ? cursor + LOG_PAGE_SIZE : currentBlock;\n    chunks.push([cursor, end]);\n  }\n\n  const [depositPages, redeemPages] = await Promise.all([\n    Promise.all(\n      chunks.map(([from, to]) =>\n        isV2\n          ? publicClient.getContractEvents({\n              address: provisionerAddress,\n              abi: provisionerV2Abi,\n              eventName: 'DepositRequested',\n              args: { receiver: 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 },\n              fromBlock: from,\n              toBlock: to,\n            })\n      )\n    ),\n    Promise.all(\n      chunks.map(([from, to]) =>\n        isV2\n          ? publicClient.getContractEvents({\n              address: provisionerAddress,\n              abi: provisionerV2Abi,\n              eventName: 'RedeemRequested',\n              args: { user: 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 },\n              fromBlock: from,\n              toBlock: to,\n            })\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  });\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        )\n      : 0n;\n  const unitsLockedUntil = await unitsLockedUntilPromise;\n\n  return {\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 last ~3 days of provisioner events and cross-checking hash existence on-chain.\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 *\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  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.address)];\n  }\n\n  return Promise.all(evmDeployments.map((d) => queryDeploymentBalance(client, d, params.address)));\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,73 @@
+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;
+} & ({
+    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;AAyB9E,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;CAC7C,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;AA+EF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAAC,UAAU,EAAE,CAAC,CAyGvB"}

package/dist/cjs/evm/withdraw.js

@@ -0,0 +1,161 @@
+"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 withdraw_exports = {};
+__export(withdraw_exports, {
+  getWithdrawTx: () => getWithdrawTx
+});
+module.exports = __toCommonJS(withdraw_exports);
+var import_adapters = require("./adapters");
+var import_attribution = require("../attribution");
+var import_errors = require("../errors");
+var import_aeraContracts = require("./aeraContracts");
+var import_vaults = require("./vaults");
+var import_constants = require("../constants");
+var import_operationMode = require("./operationMode");
+var import_types = require("./types");
+function validateWithdrawParams(params) {
+  const modes = [
+    "amount" in params && params.amount != null,
+    "shares" in params && params.shares != null,
+    "entireAmount" in params && params.entireAmount === true
+  ].filter(Boolean).length;
+  if (modes !== 1) throw new import_errors.InvalidWithdrawParamsError();
+}
+function sameAddress(left, right) {
+  return left.toLowerCase() === right.toLowerCase();
+}
+function validateSyncWithdrawQuote({
+  params,
+  account,
+  chainId,
+  slippageBps,
+  tokenAddress
+}) {
+  const quote = params.syncWithdrawQuote;
+  if (quote === void 0) return;
+  const { context } = quote;
+  if (context.vaultId !== params.vaultId || context.chainId !== chainId || !sameAddress(context.tokenAddress, tokenAddress) || context.slippageBps !== slippageBps) {
+    throw new import_errors.InvalidWithdrawParamsError();
+  }
+  if (context.account !== void 0 && !sameAddress(context.account, account)) {
+    throw new import_errors.InvalidWithdrawParamsError();
+  }
+  switch (context.request.mode) {
+    case "amount":
+      if (quote.kind !== "withdraw" || !("amount" in params && params.amount != null) || context.request.amount !== params.amount || quote.tokensOut !== params.amount) {
+        throw new import_errors.InvalidWithdrawParamsError();
+      }
+      return;
+    case "shares":
+      if (quote.kind !== "redeem" || !("shares" in params && params.shares != null) || context.request.shares !== params.shares || quote.shares !== params.shares) {
+        throw new import_errors.InvalidWithdrawParamsError();
+      }
+      return;
+    case "entireAmount":
+      if (quote.kind !== "redeem" || !("entireAmount" in params && params.entireAmount) || !sameAddress(context.request.account, account)) {
+        throw new import_errors.InvalidWithdrawParamsError();
+      }
+      return;
+  }
+}
+async function getWithdrawTx(client, params) {
+  validateWithdrawParams(params);
+  if (params.slippageBps !== void 0 && (!Number.isInteger(params.slippageBps) || params.slippageBps < 0 || params.slippageBps > Number(import_constants.MAX_BPS))) {
+    throw new import_errors.InvalidSlippageBPSError(params.slippageBps);
+  }
+  const resolved = await (0, import_vaults.resolveVault)(client, params.vaultId, params.chainId);
+  if (!resolved) throw new import_errors.VaultNotFoundError(params.vaultId);
+  const chainId = params.chainId ?? resolved.vault.chainId;
+  const account = client.wallet?.account?.address;
+  if (!account) throw new import_errors.AccountRequiredError();
+  if ("entireAmount" in params && params.entireAmount && params.account !== void 0) {
+    if (!sameAddress(params.account, account)) {
+      throw new import_errors.AccountMismatchError(account, params.account);
+    }
+  }
+  const { vault, protocol } = resolved;
+  const token = vault.supplyToken.length > 1 ? vault.supplyToken.find((tInfo) => tInfo.symbol === params.assetSymbol) : vault.supplyToken[0];
+  if (token === void 0) {
+    throw new import_errors.UnsupportedAssetError(params.assetSymbol ?? "unknown", params.vaultId);
+  }
+  const adapter = (0, import_adapters.getAdapter)(protocol);
+  const publicClient = client.getPublicClient(chainId);
+  const requestedWithdrawMode = (0, import_operationMode.parseOperationMode)(params.vaultId, params.depositMode);
+  const slippageBps = params.slippageBps ?? params.syncWithdrawQuote?.context.slippageBps ?? import_constants.DEFAULT_BPS;
+  let modifiedDepositMode;
+  let aeraRuntime;
+  if (params.syncWithdrawQuote !== void 0) {
+    if (protocol !== "aera" || requestedWithdrawMode === "async") {
+      throw new import_errors.InvalidWithdrawParamsError();
+    }
+    validateSyncWithdrawQuote({
+      params,
+      account,
+      chainId,
+      slippageBps,
+      tokenAddress: token.address
+    });
+  }
+  if (protocol === "aera") {
+    aeraRuntime = await (0, import_aeraContracts.resolveAeraRuntimeContracts)(publicClient, vault);
+    if (aeraRuntime.provisioner.version === import_types.ContractVersion.V2 && (requestedWithdrawMode === "sync" || params.syncWithdrawQuote !== void 0)) {
+      (0, import_aeraContracts.requireAeraSyncRedeemRuntime)(aeraRuntime);
+    }
+    const tokenModeSupport = await (0, import_aeraContracts.resolveAeraTokenModeSupport)(
+      publicClient,
+      aeraRuntime,
+      token.address,
+      { includeSyncModes: requestedWithdrawMode !== "async" }
+    );
+    modifiedDepositMode = (0, import_operationMode.resolveOperationMode)(
+      params.vaultId,
+      params.syncWithdrawQuote !== void 0 ? "sync" : requestedWithdrawMode,
+      {
+        async: tokenModeSupport.asyncRedeem,
+        sync: tokenModeSupport.syncRedeem
+      }
+    );
+    if (modifiedDepositMode === "sync") (0, import_aeraContracts.requireAeraSyncRedeemRuntime)(aeraRuntime);
+  } else {
+    modifiedDepositMode = (0, import_operationMode.resolveSyncOnlyOperationMode)(params.vaultId, requestedWithdrawMode);
+  }
+  const withdrawParams = {
+    vault,
+    receiver: params.receiver ?? account,
+    account,
+    async: modifiedDepositMode === "async",
+    asset: token,
+    publicClient,
+    slippageBps,
+    solverTip: params.solverTip,
+    maxPriceAge: params.maxPriceAge,
+    aeraRuntime,
+    syncWithdrawQuote: params.syncWithdrawQuote,
+    ..."shares" in params && params.shares != null ? { shares: params.shares } : {},
+    ..."amount" in params && params.amount != null ? { amount: params.amount } : {},
+    ..."entireAmount" in params && params.entireAmount ? { entireAmount: true } : {}
+  };
+  const steps = await adapter.buildWithdraw(withdrawParams);
+  return await Promise.all(steps.map((step) => (0, import_attribution.encodeTransactionWithAttribution)(client, step)));
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getWithdrawTx
+});
+//# sourceMappingURL=withdraw.js.map