@gauntlet-xyz/sdk 2.3.0 → 3.0.1

package/dist/cjs/evm/aeraContracts.js

@@ -0,0 +1,224 @@
+"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 aeraContracts_exports = {};
+__export(aeraContracts_exports, {
+  applySlippageDown: () => applySlippageDown,
+  applySlippageUp: () => applySlippageUp,
+  getMultiDepositorVault: () => getMultiDepositorVault,
+  requireAeraSyncRedeemRuntime: () => requireAeraSyncRedeemRuntime,
+  resolveAeraRuntimeContracts: () => resolveAeraRuntimeContracts,
+  resolveAeraTokenModeSupport: () => resolveAeraTokenModeSupport,
+  resolveContractVersion: () => resolveContractVersion
+});
+module.exports = __toCommonJS(aeraContracts_exports);
+var import_viem = require("viem");
+var import_errors = require("../errors");
+var import_multiDepositorVault = require("./abis/multiDepositorVault");
+var import_provisioner = require("./abis/provisioner");
+var import_provisionerV2 = require("./abis/provisionerV2");
+var import_constants = require("../constants");
+var import_types = require("./types");
+var import_readOptions = require("./aeraContracts/readOptions");
+const contractVersionCache = /* @__PURE__ */ new Map();
+const contractVersionAbi = [
+  {
+    type: "function",
+    inputs: [],
+    name: "version",
+    outputs: [{ name: "", internalType: "string", type: "string" }],
+    stateMutability: "view"
+  }
+];
+const solvingGateAbi = [
+  {
+    type: "function",
+    inputs: [
+      { name: "provisioner", internalType: "address", type: "address" },
+      { name: "token", internalType: "address", type: "address" }
+    ],
+    name: "paused",
+    outputs: [{ name: "", internalType: "bool", type: "bool" }],
+    stateMutability: "view"
+  }
+];
+function requireAeraSyncRedeemRuntime(runtime) {
+  if (runtime.provisioner.version !== import_types.ContractVersion.V2) {
+    throw new import_errors.UnsupportedFeatureError("Aera: sync redeem requires a V2 provisioner");
+  }
+  if (runtime.feeCalculator.version !== import_types.ContractVersion.V2) {
+    throw new import_errors.UnsupportedFeatureError("Aera: sync redeem requires a V2 price and fee calculator");
+  }
+}
+function applySlippageDown(amount, slippageBps) {
+  return amount * (import_constants.MAX_BPS - BigInt(slippageBps)) / import_constants.MAX_BPS;
+}
+function applySlippageUp(amount, slippageBps) {
+  return (amount * (import_constants.MAX_BPS + BigInt(slippageBps)) + import_constants.MAX_BPS - 1n) / import_constants.MAX_BPS;
+}
+function contractVersionCacheKey(client, address) {
+  return `${client.chain?.id ?? "unknown"}:${address.toLowerCase()}`;
+}
+function isVersionUnavailableError(error) {
+  if (!(error instanceof import_viem.ContractFunctionExecutionError) || error.functionName !== "version") {
+    return false;
+  }
+  if (error.cause instanceof import_viem.ContractFunctionRevertedError) {
+    const hasDecodedError = error.cause.signature !== void 0 || error.cause.data !== void 0 || error.cause.raw !== void 0 && error.cause.raw !== "0x";
+    return !hasDecodedError && (error.cause.reason === void 0 || error.cause.reason === "execution reverted");
+  }
+  return error.cause instanceof import_viem.ContractFunctionZeroDataError;
+}
+function getMultiDepositorVault(client, vaultAddress) {
+  return (0, import_viem.getContract)({
+    address: vaultAddress,
+    abi: import_multiDepositorVault.multiDepositorVaultAbi,
+    client
+  });
+}
+async function resolveContractVersion(client, address, options = {}) {
+  const cacheKey = contractVersionCacheKey(client, address);
+  const cached = contractVersionCache.get(cacheKey);
+  if (cached) return cached;
+  try {
+    const versionString = await client.readContract({
+      address,
+      abi: contractVersionAbi,
+      functionName: "version",
+      ...(0, import_readOptions.readAtBlock)(options)
+    });
+    const version = versionString.startsWith("2.") ? import_types.ContractVersion.V2 : import_types.ContractVersion.V1;
+    contractVersionCache.set(cacheKey, version);
+    return version;
+  } catch (error) {
+    if (!isVersionUnavailableError(error)) throw error;
+    contractVersionCache.set(cacheKey, import_types.ContractVersion.V1);
+    return import_types.ContractVersion.V1;
+  }
+}
+async function resolveAeraRuntimeContracts(client, vault, options = {}) {
+  if (vault.vaultType !== "multi-depositor") {
+    throw new import_errors.UnimplementedFeatureError("Aera: single depositor vaults");
+  }
+  const [provisionerAddress, feeCalculatorAddress] = await Promise.all([
+    client.readContract({
+      address: vault.vaultAddress,
+      abi: import_multiDepositorVault.multiDepositorVaultAbi,
+      functionName: "provisioner",
+      ...(0, import_readOptions.readAtBlock)(options)
+    }),
+    client.readContract({
+      address: vault.vaultAddress,
+      abi: import_multiDepositorVault.multiDepositorVaultAbi,
+      functionName: "feeCalculator",
+      ...(0, import_readOptions.readAtBlock)(options)
+    })
+  ]);
+  if (provisionerAddress === import_viem.zeroAddress) {
+    throw new import_errors.UnsupportedFeatureError("Aera: vault without provisioner");
+  }
+  if (feeCalculatorAddress === import_viem.zeroAddress) {
+    throw new import_errors.UnsupportedFeatureError("Aera: vault without price and fee calculator");
+  }
+  const [provisionerVersion, feeCalculatorVersion] = await Promise.all([
+    resolveContractVersion(client, provisionerAddress, options),
+    resolveContractVersion(client, feeCalculatorAddress, options)
+  ]);
+  return {
+    provisioner: {
+      address: provisionerAddress,
+      version: provisionerVersion
+    },
+    feeCalculator: {
+      address: feeCalculatorAddress,
+      version: feeCalculatorVersion
+    }
+  };
+}
+async function resolveAeraTokenModeSupport(client, runtime, token, options = {}) {
+  if (runtime.provisioner.version === import_types.ContractVersion.V2) {
+    const tokenDetailsPromise = client.readContract({
+      address: runtime.provisioner.address,
+      abi: import_provisionerV2.provisionerV2Abi,
+      functionName: "tokensDetails",
+      args: [token],
+      ...(0, import_readOptions.readAtBlock)(options)
+    });
+    if (options.includeSyncModes === false) {
+      const tokenDetails3 = await tokenDetailsPromise;
+      return {
+        asyncDeposit: Boolean(tokenDetails3[0]),
+        asyncRedeem: Boolean(tokenDetails3[1]),
+        syncDeposit: false,
+        syncRedeem: false
+      };
+    }
+    const [tokenDetails2, solvingGateEnabled, solvingGate] = await Promise.all([
+      tokenDetailsPromise,
+      client.readContract({
+        address: runtime.provisioner.address,
+        abi: import_provisionerV2.provisionerV2Abi,
+        functionName: "SOLVING_GATE_ENABLED",
+        ...(0, import_readOptions.readAtBlock)(options)
+      }),
+      client.readContract({
+        address: runtime.provisioner.address,
+        abi: import_provisionerV2.provisionerV2Abi,
+        functionName: "solvingGate",
+        ...(0, import_readOptions.readAtBlock)(options)
+      })
+    ]);
+    const solvingPaused = solvingGateEnabled && solvingGate !== import_viem.zeroAddress ? await client.readContract({
+      address: solvingGate,
+      abi: solvingGateAbi,
+      functionName: "paused",
+      args: [runtime.provisioner.address, token],
+      ...(0, import_readOptions.readAtBlock)(options)
+    }) : false;
+    return {
+      asyncDeposit: Boolean(tokenDetails2[0]),
+      asyncRedeem: Boolean(tokenDetails2[1]),
+      syncDeposit: Boolean(tokenDetails2[2]) && !solvingPaused,
+      syncRedeem: Boolean(tokenDetails2[3]) && !solvingPaused && runtime.feeCalculator.version === import_types.ContractVersion.V2
+    };
+  }
+  const tokenDetails = await client.readContract({
+    address: runtime.provisioner.address,
+    abi: import_provisioner.provisionerAbi,
+    functionName: "tokensDetails",
+    args: [token],
+    ...(0, import_readOptions.readAtBlock)(options)
+  });
+  return {
+    asyncDeposit: Boolean(tokenDetails[0]),
+    asyncRedeem: Boolean(tokenDetails[1]),
+    syncDeposit: false,
+    syncRedeem: false
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  applySlippageDown,
+  applySlippageUp,
+  getMultiDepositorVault,
+  requireAeraSyncRedeemRuntime,
+  resolveAeraRuntimeContracts,
+  resolveAeraTokenModeSupport,
+  resolveContractVersion
+});
+//# sourceMappingURL=aeraContracts.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/evm/aeraContracts.ts"],
+  "sourcesContent": ["import {\n  ContractFunctionExecutionError,\n  ContractFunctionRevertedError,\n  ContractFunctionZeroDataError,\n  type Address,\n  type Client,\n  type GetContractReturnType,\n  type PublicClient,\n  getContract,\n  zeroAddress,\n} from 'viem';\nimport { UnimplementedFeatureError, UnsupportedFeatureError } from '../errors';\nimport { multiDepositorVaultAbi } from './abis/multiDepositorVault';\nimport { provisionerAbi } from './abis/provisioner';\nimport { provisionerV2Abi } from './abis/provisionerV2';\nimport { MAX_BPS } from '../constants';\nimport { ContractVersion, type EvmVaultDeployment } from './types';\nimport { readAtBlock } from './aeraContracts/readOptions';\n\nconst contractVersionCache = new Map<string, ContractVersion>();\n\nconst contractVersionAbi = [\n  {\n    type: 'function',\n    inputs: [],\n    name: 'version',\n    outputs: [{ name: '', internalType: 'string', type: 'string' }],\n    stateMutability: 'view',\n  },\n] as const;\n\nconst solvingGateAbi = [\n  {\n    type: 'function',\n    inputs: [\n      { name: 'provisioner', internalType: 'address', type: 'address' },\n      { name: 'token', internalType: 'address', type: 'address' },\n    ],\n    name: 'paused',\n    outputs: [{ name: '', internalType: 'bool', type: 'bool' }],\n    stateMutability: 'view',\n  },\n] as const;\n\nexport interface AeraRuntimeContracts {\n  provisioner: {\n    address: Address;\n    version: ContractVersion;\n  };\n  feeCalculator: {\n    address: Address;\n    version: ContractVersion;\n  };\n}\n\nexport interface AeraTokenModeSupport {\n  asyncDeposit: boolean;\n  asyncRedeem: boolean;\n  syncDeposit: boolean;\n  syncRedeem: boolean;\n}\n\nexport function requireAeraSyncRedeemRuntime(runtime: AeraRuntimeContracts): void {\n  if (runtime.provisioner.version !== ContractVersion.V2) {\n    throw new UnsupportedFeatureError('Aera: sync redeem requires a V2 provisioner');\n  }\n  if (runtime.feeCalculator.version !== ContractVersion.V2) {\n    throw new UnsupportedFeatureError('Aera: sync redeem requires a V2 price and fee calculator');\n  }\n}\n\nexport type AeraReadOptions = {\n  blockNumber?: bigint;\n};\n\nexport function applySlippageDown(amount: bigint, slippageBps: number): bigint {\n  return (amount * (MAX_BPS - BigInt(slippageBps))) / MAX_BPS;\n}\n\nexport function applySlippageUp(amount: bigint, slippageBps: number): bigint {\n  return (amount * (MAX_BPS + BigInt(slippageBps)) + MAX_BPS - 1n) / MAX_BPS;\n}\n\nfunction contractVersionCacheKey(client: PublicClient, address: Address): string {\n  return `${client.chain?.id ?? 'unknown'}:${address.toLowerCase()}`;\n}\n\nfunction isVersionUnavailableError(error: unknown): boolean {\n  if (!(error instanceof ContractFunctionExecutionError) || error.functionName !== 'version') {\n    return false;\n  }\n\n  if (error.cause instanceof ContractFunctionRevertedError) {\n    const hasDecodedError =\n      error.cause.signature !== undefined ||\n      error.cause.data !== undefined ||\n      (error.cause.raw !== undefined && error.cause.raw !== '0x');\n\n    return (\n      !hasDecodedError &&\n      (error.cause.reason === undefined || error.cause.reason === 'execution reverted')\n    );\n  }\n\n  return error.cause instanceof ContractFunctionZeroDataError;\n}\n\nexport type MultiDepositorVaultContract<T extends Client> = GetContractReturnType<\n  typeof multiDepositorVaultAbi,\n  T,\n  Address\n>;\n\nexport function getMultiDepositorVault<T extends Client>(\n  client: T,\n  vaultAddress: Address\n): MultiDepositorVaultContract<T> {\n  return getContract({\n    address: vaultAddress,\n    abi: multiDepositorVaultAbi,\n    client,\n  });\n}\n\nexport async function resolveContractVersion(\n  client: PublicClient,\n  address: Address,\n  options: AeraReadOptions = {}\n): Promise<ContractVersion> {\n  const cacheKey = contractVersionCacheKey(client, address);\n  const cached = contractVersionCache.get(cacheKey);\n  if (cached) return cached;\n\n  try {\n    const versionString = await client.readContract({\n      address,\n      abi: contractVersionAbi,\n      functionName: 'version',\n      ...readAtBlock(options),\n    });\n    const version = versionString.startsWith('2.') ? ContractVersion.V2 : ContractVersion.V1;\n    contractVersionCache.set(cacheKey, version);\n\n    return version;\n  } catch (error) {\n    if (!isVersionUnavailableError(error)) throw error;\n\n    contractVersionCache.set(cacheKey, ContractVersion.V1);\n    return ContractVersion.V1;\n  }\n}\n\nexport async function resolveAeraRuntimeContracts(\n  client: PublicClient,\n  vault: EvmVaultDeployment,\n  options: AeraReadOptions = {}\n): Promise<AeraRuntimeContracts> {\n  if (vault.vaultType !== 'multi-depositor') {\n    throw new UnimplementedFeatureError('Aera: single depositor vaults');\n  }\n\n  const [provisionerAddress, feeCalculatorAddress] = await Promise.all([\n    client.readContract({\n      address: vault.vaultAddress,\n      abi: multiDepositorVaultAbi,\n      functionName: 'provisioner',\n      ...readAtBlock(options),\n    }),\n    client.readContract({\n      address: vault.vaultAddress,\n      abi: multiDepositorVaultAbi,\n      functionName: 'feeCalculator',\n      ...readAtBlock(options),\n    }),\n  ]);\n\n  if (provisionerAddress === zeroAddress) {\n    throw new UnsupportedFeatureError('Aera: vault without provisioner');\n  }\n  if (feeCalculatorAddress === zeroAddress) {\n    throw new UnsupportedFeatureError('Aera: vault without price and fee calculator');\n  }\n\n  const [provisionerVersion, feeCalculatorVersion] = await Promise.all([\n    resolveContractVersion(client, provisionerAddress, options),\n    resolveContractVersion(client, feeCalculatorAddress, options),\n  ]);\n\n  return {\n    provisioner: {\n      address: provisionerAddress,\n      version: provisionerVersion,\n    },\n    feeCalculator: {\n      address: feeCalculatorAddress,\n      version: feeCalculatorVersion,\n    },\n  };\n}\n\nexport async function resolveAeraTokenModeSupport(\n  client: PublicClient,\n  runtime: AeraRuntimeContracts,\n  token: Address,\n  options: AeraReadOptions & { includeSyncModes?: boolean } = {}\n): Promise<AeraTokenModeSupport> {\n  if (runtime.provisioner.version === ContractVersion.V2) {\n    const tokenDetailsPromise = client.readContract({\n      address: runtime.provisioner.address,\n      abi: provisionerV2Abi,\n      functionName: 'tokensDetails',\n      args: [token],\n      ...readAtBlock(options),\n    });\n    if (options.includeSyncModes === false) {\n      const tokenDetails = await tokenDetailsPromise;\n      return {\n        asyncDeposit: Boolean(tokenDetails[0]),\n        asyncRedeem: Boolean(tokenDetails[1]),\n        syncDeposit: false,\n        syncRedeem: false,\n      };\n    }\n\n    const [tokenDetails, solvingGateEnabled, solvingGate] = await Promise.all([\n      tokenDetailsPromise,\n      client.readContract({\n        address: runtime.provisioner.address,\n        abi: provisionerV2Abi,\n        functionName: 'SOLVING_GATE_ENABLED',\n        ...readAtBlock(options),\n      }),\n      client.readContract({\n        address: runtime.provisioner.address,\n        abi: provisionerV2Abi,\n        functionName: 'solvingGate',\n        ...readAtBlock(options),\n      }),\n    ]);\n    const solvingPaused =\n      solvingGateEnabled && solvingGate !== zeroAddress\n        ? await client.readContract({\n            address: solvingGate,\n            abi: solvingGateAbi,\n            functionName: 'paused',\n            args: [runtime.provisioner.address, token],\n            ...readAtBlock(options),\n          })\n        : false;\n\n    return {\n      asyncDeposit: Boolean(tokenDetails[0]),\n      asyncRedeem: Boolean(tokenDetails[1]),\n      syncDeposit: Boolean(tokenDetails[2]) && !solvingPaused,\n      syncRedeem:\n        Boolean(tokenDetails[3]) &&\n        !solvingPaused &&\n        runtime.feeCalculator.version === ContractVersion.V2,\n    };\n  }\n\n  const tokenDetails = await client.readContract({\n    address: runtime.provisioner.address,\n    abi: provisionerAbi,\n    functionName: 'tokensDetails',\n    args: [token],\n    ...readAtBlock(options),\n  });\n\n  return {\n    asyncDeposit: Boolean(tokenDetails[0]),\n    asyncRedeem: Boolean(tokenDetails[1]),\n    syncDeposit: false,\n    syncRedeem: false,\n  };\n}\n"],
+  "mappings": "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",
+  "names": ["tokenDetails"]
+}

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

@@ -0,0 +1,50 @@
+import type { Address } from 'viem';
+import type { GauntletClient } from "../client.js";
+import { PreparedTx } from "../attribution/index.js";
+export interface EvmDepositParams {
+    vaultId: string;
+    amount: bigint;
+    chainId?: number;
+    assetSymbol?: string;
+    /** Request async (queued) or sync deposit. 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;
+    /** Caller-reviewed minimum output for an explicit Aera synchronous deposit. */
+    minUnitsOut?: bigint;
+}
+/**
+ * Builds the ordered list of EVM transactions required to deposit into a Gauntlet vault.
+ *
+ * Returns one or two transactions: an ERC-20 approval (only if the current allowance is
+ * insufficient) followed by the deposit or async deposit request. Each transaction is
+ * returned as a `PreparedTx` object ready to be signed and sent.
+ *
+ * @param client - A configured `GauntletClient` instance with an EVM public client and wallet.
+ * @param params - Deposit parameters including the vault identifier, token amount, and optional
+ *   chain, asset symbol, deposit mode (`'sync'` | `'async'`), 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 deposit mode is not supported by the vault.
+ * @throws {UnsupportedAssetError} If the specified asset symbol is not accepted by the vault.
+ *
+ * @example
+ * ```ts
+ * const txs = await getDepositTx(client, {
+ *   vaultId: 'baseUsdcPrime',
+ *   amount: 100_000_000n, // 100 USDC (6 decimals)
+ * });
+ * for (const tx of txs) {
+ *   await walletClient.sendTransaction(tx.tx);
+ * }
+ * ```
+ */
+export declare function getDepositTx(client: GauntletClient, params: EvmDepositParams): Promise<PreparedTx[]>;
+//# sourceMappingURL=deposit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deposit.d.ts","sourceRoot":"","sources":["../../../src/evm/deposit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAkB;AAGhD,OAAO,EAAoC,UAAU,EAAE,gCAAuB;AAsB9E,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IAEf,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kGAAkG;IAClG,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,+EAA+E;IAC/E,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC,UAAU,EAAE,CAAC,CAuGvB"}

package/dist/cjs/evm/deposit.js

@@ -0,0 +1,112 @@
+"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 deposit_exports = {};
+__export(deposit_exports, {
+  getDepositTx: () => getDepositTx
+});
+module.exports = __toCommonJS(deposit_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");
+async function getDepositTx(client, params) {
+  const slippageBps = params.slippageBps ?? import_constants.DEFAULT_BPS;
+  if (!Number.isInteger(slippageBps) || slippageBps < 0 || slippageBps > Number(import_constants.MAX_BPS)) {
+    throw new import_errors.InvalidSlippageBPSError(slippageBps);
+  }
+  if (params.minUnitsOut !== void 0 && (typeof params.minUnitsOut !== "bigint" || params.minUnitsOut <= 0n)) {
+    throw new import_errors.InvalidSyncDepositBoundError();
+  }
+  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();
+  const { vault, protocol } = resolved;
+  const adapter = (0, import_adapters.getAdapter)(protocol);
+  const publicClient = client.getPublicClient(chainId);
+  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 requestedDepositMode = (0, import_operationMode.parseOperationMode)(params.vaultId, params.depositMode);
+  if (params.minUnitsOut !== void 0 && (protocol !== "aera" || requestedDepositMode !== "sync")) {
+    throw new import_errors.InvalidSyncDepositBoundError();
+  }
+  let modifiedDepositMode;
+  let aeraRuntime;
+  if (protocol === "aera") {
+    aeraRuntime = await (0, import_aeraContracts.resolveAeraRuntimeContracts)(publicClient, vault);
+    const tokenModeSupport = await (0, import_aeraContracts.resolveAeraTokenModeSupport)(
+      publicClient,
+      aeraRuntime,
+      token.address,
+      { includeSyncModes: requestedDepositMode !== "async" }
+    );
+    modifiedDepositMode = (0, import_operationMode.resolveOperationMode)(params.vaultId, requestedDepositMode, {
+      async: tokenModeSupport.asyncDeposit,
+      sync: tokenModeSupport.syncDeposit
+    });
+  } else {
+    modifiedDepositMode = (0, import_operationMode.resolveSyncOnlyOperationMode)(params.vaultId, requestedDepositMode);
+  }
+  const spender = protocol === "aera" && modifiedDepositMode === "async" ? aeraRuntime.provisioner.address : vault.vaultAddress;
+  const { sufficient } = await adapter.checkAllowance({
+    publicClient,
+    token: token.address,
+    owner: account,
+    spender,
+    amount: params.amount
+  });
+  const steps = [];
+  if (!sufficient) {
+    steps.push(
+      adapter.buildApproval({
+        token: token.address,
+        spender,
+        amount: params.amount,
+        account
+      })
+    );
+  }
+  const depositSteps = await adapter.buildDeposit({
+    vault,
+    amount: params.amount,
+    receiver: params.receiver ?? account,
+    account,
+    async: modifiedDepositMode === "async",
+    asset: token,
+    publicClient,
+    slippageBps,
+    solverTip: params.solverTip,
+    maxPriceAge: params.maxPriceAge,
+    aeraRuntime,
+    minUnitsOut: params.minUnitsOut
+  });
+  steps.push(...depositSteps);
+  return Promise.all(steps.map((step) => (0, import_attribution.encodeTransactionWithAttribution)(client, step)));
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getDepositTx
+});
+//# sourceMappingURL=deposit.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/evm/deposit.ts"],
+  "sourcesContent": ["import type { Address } from 'viem';\nimport type { GauntletClient } from '../client';\nimport type { EvmTxStep } from './adapters/types';\nimport { getAdapter } from './adapters';\nimport { encodeTransactionWithAttribution, PreparedTx } from '../attribution';\nimport {\n  AccountRequiredError,\n  VaultNotFoundError,\n  UnsupportedAssetError,\n  InvalidSlippageBPSError,\n  InvalidSyncDepositBoundError,\n} from '../errors';\nimport {\n  resolveAeraRuntimeContracts,\n  resolveAeraTokenModeSupport,\n  type AeraRuntimeContracts,\n} from './aeraContracts';\nimport { resolveVault } from './vaults';\nimport { DEFAULT_BPS, MAX_BPS } from '../constants';\nimport {\n  parseOperationMode,\n  resolveOperationMode,\n  resolveSyncOnlyOperationMode,\n  type OperationMode,\n} from './operationMode';\n\nexport interface EvmDepositParams {\n  vaultId: string;\n  amount: bigint;\n  // Required for multichain vaults, will default to base\n  chainId?: number;\n  // Required for multiasset vaults, not utilized yet\n  assetSymbol?: string;\n  /** Request async (queued) or sync deposit. Availability is read from live vault configuration. */\n  depositMode?: string;\n  // So a developer is able to specify a separate receiver than the tx sender\n  receiver?: Address;\n  /** Slippage tolerance in basis points (e.g. 100 = 1%). Defaults to 100. */\n  slippageBps?: number;\n  /** Solver tip passed to async Aera provisioner requests. Defaults to 0. */\n  solverTip?: bigint;\n  /** Maximum price age passed to async Aera provisioner requests. Defaults to 10 days. */\n  maxPriceAge?: bigint;\n  /** Caller-reviewed minimum output for an explicit Aera synchronous deposit. */\n  minUnitsOut?: bigint;\n}\n\n/**\n * Builds the ordered list of EVM transactions required to deposit into a Gauntlet vault.\n *\n * Returns one or two transactions: an ERC-20 approval (only if the current allowance is\n * insufficient) followed by the deposit or async deposit request. Each transaction is\n * returned as a `PreparedTx` object ready to be signed and sent.\n *\n * @param client - A configured `GauntletClient` instance with an EVM public client and wallet.\n * @param params - Deposit parameters including the vault identifier, token amount, and optional\n *   chain, asset symbol, deposit mode (`'sync'` | `'async'`), and receiver address.\n * @returns Ordered array of prepared transactions to execute in sequence.\n *\n * @throws {VaultNotFoundError} If the vault ID is not found in the manifest.\n * @throws {AccountRequiredError} If no wallet account is set on the client.\n * @throws {UnsupportedDepositModeError} If the requested deposit mode is not supported by the vault.\n * @throws {UnsupportedAssetError} If the specified asset symbol is not accepted by the vault.\n *\n * @example\n * ```ts\n * const txs = await getDepositTx(client, {\n *   vaultId: 'baseUsdcPrime',\n *   amount: 100_000_000n, // 100 USDC (6 decimals)\n * });\n * for (const tx of txs) {\n *   await walletClient.sendTransaction(tx.tx);\n * }\n * ```\n */\nexport async function getDepositTx(\n  client: GauntletClient,\n  params: EvmDepositParams\n): Promise<PreparedTx[]> {\n  const slippageBps = params.slippageBps ?? DEFAULT_BPS;\n  if (!Number.isInteger(slippageBps) || slippageBps < 0 || slippageBps > Number(MAX_BPS)) {\n    throw new InvalidSlippageBPSError(slippageBps);\n  }\n  if (\n    params.minUnitsOut !== undefined &&\n    (typeof params.minUnitsOut !== 'bigint' || params.minUnitsOut <= 0n)\n  ) {\n    throw new InvalidSyncDepositBoundError();\n  }\n\n  const resolved = await resolveVault(client, params.vaultId, params.chainId);\n  if (!resolved) throw new VaultNotFoundError(params.vaultId);\n\n  const chainId = params.chainId ?? resolved.vault.chainId;\n\n  const account = client.wallet?.account?.address;\n  if (!account) throw new AccountRequiredError();\n\n  const { vault, protocol } = resolved;\n\n  const adapter = getAdapter(protocol);\n  const publicClient = client.getPublicClient(chainId);\n  const token =\n    vault.supplyToken.length > 1\n      ? vault.supplyToken.find((tInfo) => tInfo.symbol === params.assetSymbol)\n      : vault.supplyToken[0];\n\n  if (token === undefined) {\n    throw new UnsupportedAssetError(params.assetSymbol ?? 'unknown', params.vaultId);\n  }\n\n  const requestedDepositMode = parseOperationMode(params.vaultId, params.depositMode);\n  if (\n    params.minUnitsOut !== undefined &&\n    (protocol !== 'aera' || requestedDepositMode !== 'sync')\n  ) {\n    throw new InvalidSyncDepositBoundError();\n  }\n  let modifiedDepositMode: OperationMode;\n  let aeraRuntime: AeraRuntimeContracts | undefined;\n\n  if (protocol === 'aera') {\n    aeraRuntime = await resolveAeraRuntimeContracts(publicClient, vault);\n    const tokenModeSupport = await resolveAeraTokenModeSupport(\n      publicClient,\n      aeraRuntime,\n      token.address,\n      { includeSyncModes: requestedDepositMode !== 'async' }\n    );\n    modifiedDepositMode = resolveOperationMode(params.vaultId, requestedDepositMode, {\n      async: tokenModeSupport.asyncDeposit,\n      sync: tokenModeSupport.syncDeposit,\n    });\n  } else {\n    modifiedDepositMode = resolveSyncOnlyOperationMode(params.vaultId, requestedDepositMode);\n  }\n\n  const spender =\n    protocol === 'aera' && modifiedDepositMode === 'async'\n      ? aeraRuntime!.provisioner.address\n      : vault.vaultAddress;\n\n  // NOTE: this could be moved to the buildDeposit level\n  const { sufficient } = await adapter.checkAllowance({\n    publicClient,\n    token: token.address,\n    owner: account,\n    spender,\n    amount: params.amount,\n  });\n\n  const steps: EvmTxStep[] = [];\n\n  if (!sufficient) {\n    steps.push(\n      adapter.buildApproval({\n        token: token.address,\n        spender,\n        amount: params.amount,\n        account,\n      })\n    );\n  }\n\n  const depositSteps = await adapter.buildDeposit({\n    vault,\n    amount: params.amount,\n    receiver: params.receiver ?? account,\n    account,\n    async: modifiedDepositMode === 'async',\n    asset: token,\n    publicClient,\n    slippageBps,\n    solverTip: params.solverTip,\n    maxPriceAge: params.maxPriceAge,\n    aeraRuntime,\n    minUnitsOut: params.minUnitsOut,\n  });\n  steps.push(...depositSteps);\n\n  return Promise.all(steps.map((step) => encodeTransactionWithAttribution(client, step)));\n}\n"],
+  "mappings": "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",
+  "names": []
+}

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

@@ -0,0 +1,32 @@
+import type { GauntletClient } from "../client.js";
+export type SyncDepositQuote = Readonly<{
+    unitsOut: bigint;
+    minUnitsOut: bigint;
+    /** Deposit amount converted to the vault's numeraire, after the Instant Supply fee. */
+    numeraireOut: bigint;
+    /** Instant Supply fee applied to the deposited token amount, in basis points. */
+    feeBps: bigint;
+    /** Slippage tolerance used to derive `minUnitsOut`, in basis points. */
+    slippageBps: number;
+}>;
+export type SyncDepositQuoteParams = {
+    vaultId: string;
+    chainId?: number;
+    assetSymbol?: string;
+    amount: bigint;
+    slippageBps?: number;
+};
+export type SyncDepositRateParams = {
+    vaultId: string;
+    chainId?: number;
+    assetSymbol?: string;
+};
+export type SyncDepositRate = Readonly<{
+    /** Instant Supply fee, in basis points. Independent of the deposit amount. */
+    feeBps: bigint;
+}>;
+/** Quotes an Aera synchronous deposit and its execution bounds. */
+export declare function getSyncDepositQuote(client: GauntletClient, params: SyncDepositQuoteParams): Promise<SyncDepositQuote>;
+/** Reads the live Instant Supply fee for a vault token, without requiring a deposit amount. */
+export declare function getSyncDepositRate(client: GauntletClient, params: SyncDepositRateParams): Promise<SyncDepositRate>;
+//# sourceMappingURL=depositQuote.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"depositQuote.d.ts","sourceRoot":"","sources":["../../../src/evm/depositQuote.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAkB;AAmBhD,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,uFAAuF;IACvF,YAAY,EAAE,MAAM,CAAC;IACrB,iFAAiF;IACjF,MAAM,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC,CAAC;AAEH,MAAM,MAAM,sBAAsB,GAAG;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC;IACrC,8EAA8E;IAC9E,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC,CAAC;AA6CH,mEAAmE;AACnE,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,sBAAsB,GAC7B,OAAO,CAAC,gBAAgB,CAAC,CAyB3B;AAED,+FAA+F;AAC/F,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,eAAe,CAAC,CAS1B"}

package/dist/cjs/evm/depositQuote.js

@@ -0,0 +1,96 @@
+"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 depositQuote_exports = {};
+__export(depositQuote_exports, {
+  getSyncDepositQuote: () => getSyncDepositQuote,
+  getSyncDepositRate: () => getSyncDepositRate
+});
+module.exports = __toCommonJS(depositQuote_exports);
+var import_constants = require("../constants");
+var import_errors = require("../errors");
+var import_aeraContracts = require("./aeraContracts");
+var import_v2 = require("./aeraContracts/v2");
+var import_operationMode = require("./operationMode");
+var import_types = require("./types");
+var import_vaults = require("./vaults");
+async function resolveSyncDepositContext(client, params, readKind) {
+  const resolved = await (0, import_vaults.resolveVault)(client, params.vaultId, params.chainId);
+  if (!resolved) throw new import_errors.VaultNotFoundError(params.vaultId, params.chainId);
+  if (resolved.protocol !== "aera") {
+    throw new import_errors.UnsupportedFeatureError(
+      readKind === "quote" ? "Sync deposit quote is only available for Aera vaults" : "Sync deposit rate is only available for Aera vaults"
+    );
+  }
+  const { vault } = resolved;
+  const token = vault.supplyToken.length > 1 ? vault.supplyToken.find(({ symbol }) => symbol === params.assetSymbol) : vault.supplyToken[0];
+  if (!token) throw new import_errors.UnsupportedAssetError(params.assetSymbol ?? "unknown", params.vaultId);
+  const publicClient = client.getPublicClient(params.chainId ?? vault.chainId);
+  const runtime = await (0, import_aeraContracts.resolveAeraRuntimeContracts)(publicClient, vault);
+  if (runtime.provisioner.version !== import_types.ContractVersion.V2) {
+    throw new import_errors.UnsupportedFeatureError(
+      readKind === "quote" ? "Sync deposit quote requires an Aera V2 provisioner" : "Sync deposit rate requires an Aera V2 provisioner"
+    );
+  }
+  const tokenModeSupport = await (0, import_aeraContracts.resolveAeraTokenModeSupport)(publicClient, runtime, token.address, {
+    includeSyncModes: true
+  });
+  (0, import_operationMode.resolveOperationMode)(params.vaultId, "sync", {
+    async: tokenModeSupport.asyncDeposit,
+    sync: tokenModeSupport.syncDeposit
+  });
+  return { publicClient, vault, token, runtime };
+}
+async function getSyncDepositQuote(client, params) {
+  const slippageBps = params.slippageBps ?? import_constants.DEFAULT_BPS;
+  if (!Number.isInteger(slippageBps) || slippageBps < 0 || slippageBps > Number(import_constants.MAX_BPS)) {
+    throw new import_errors.InvalidSlippageBPSError(slippageBps);
+  }
+  const { publicClient, vault, token, runtime } = await resolveSyncDepositContext(
+    client,
+    params,
+    "quote"
+  );
+  const { unitsOut, feeBps, numeraireOut } = await (0, import_v2.getSyncDepositQuoteValues)(
+    publicClient,
+    runtime.provisioner.address,
+    runtime.feeCalculator.address,
+    runtime.feeCalculator.version,
+    vault.vaultAddress,
+    token.address,
+    params.amount
+  );
+  const minUnitsOut = (0, import_aeraContracts.applySlippageDown)(unitsOut, slippageBps);
+  if (minUnitsOut <= 0n) throw new import_errors.InvalidSyncDepositBoundError();
+  return { unitsOut, minUnitsOut, numeraireOut, feeBps, slippageBps };
+}
+async function getSyncDepositRate(client, params) {
+  const { publicClient, runtime, token } = await resolveSyncDepositContext(client, params, "rate");
+  const feeBps = await (0, import_v2.getSyncDepositFeeBps)(
+    publicClient,
+    runtime.provisioner.address,
+    token.address
+  );
+  return { feeBps };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getSyncDepositQuote,
+  getSyncDepositRate
+});
+//# sourceMappingURL=depositQuote.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/evm/depositQuote.ts"],
+  "sourcesContent": ["import type { GauntletClient } from '../client';\nimport { DEFAULT_BPS, MAX_BPS } from '../constants';\nimport {\n  InvalidSlippageBPSError,\n  InvalidSyncDepositBoundError,\n  UnsupportedAssetError,\n  UnsupportedFeatureError,\n  VaultNotFoundError,\n} from '../errors';\nimport {\n  applySlippageDown,\n  resolveAeraRuntimeContracts,\n  resolveAeraTokenModeSupport,\n} from './aeraContracts';\nimport { getSyncDepositFeeBps, getSyncDepositQuoteValues } from './aeraContracts/v2';\nimport { resolveOperationMode } from './operationMode';\nimport { ContractVersion } from './types';\nimport { resolveVault } from './vaults';\n\nexport type SyncDepositQuote = Readonly<{\n  unitsOut: bigint;\n  minUnitsOut: bigint;\n  /** Deposit amount converted to the vault's numeraire, after the Instant Supply fee. */\n  numeraireOut: bigint;\n  /** Instant Supply fee applied to the deposited token amount, in basis points. */\n  feeBps: bigint;\n  /** Slippage tolerance used to derive `minUnitsOut`, in basis points. */\n  slippageBps: number;\n}>;\n\nexport type SyncDepositQuoteParams = {\n  vaultId: string;\n  chainId?: number;\n  assetSymbol?: string;\n  amount: bigint;\n  slippageBps?: number;\n};\n\nexport type SyncDepositRateParams = {\n  vaultId: string;\n  chainId?: number;\n  assetSymbol?: string;\n};\n\nexport type SyncDepositRate = Readonly<{\n  /** Instant Supply fee, in basis points. Independent of the deposit amount. */\n  feeBps: bigint;\n}>;\n\nasync function resolveSyncDepositContext(\n  client: GauntletClient,\n  params: SyncDepositRateParams,\n  readKind: 'quote' | 'rate'\n) {\n  const resolved = await resolveVault(client, params.vaultId, params.chainId);\n  if (!resolved) throw new VaultNotFoundError(params.vaultId, params.chainId);\n  if (resolved.protocol !== 'aera') {\n    throw new UnsupportedFeatureError(\n      readKind === 'quote'\n        ? 'Sync deposit quote is only available for Aera vaults'\n        : 'Sync deposit rate is only available for Aera vaults'\n    );\n  }\n\n  const { vault } = resolved;\n  const token =\n    vault.supplyToken.length > 1\n      ? vault.supplyToken.find(({ symbol }) => symbol === params.assetSymbol)\n      : vault.supplyToken[0];\n  if (!token) throw new UnsupportedAssetError(params.assetSymbol ?? 'unknown', params.vaultId);\n\n  const publicClient = client.getPublicClient(params.chainId ?? vault.chainId);\n  const runtime = await resolveAeraRuntimeContracts(publicClient, vault);\n  if (runtime.provisioner.version !== ContractVersion.V2) {\n    throw new UnsupportedFeatureError(\n      readKind === 'quote'\n        ? 'Sync deposit quote requires an Aera V2 provisioner'\n        : 'Sync deposit rate requires an Aera V2 provisioner'\n    );\n  }\n\n  const tokenModeSupport = await resolveAeraTokenModeSupport(publicClient, runtime, token.address, {\n    includeSyncModes: true,\n  });\n  resolveOperationMode(params.vaultId, 'sync', {\n    async: tokenModeSupport.asyncDeposit,\n    sync: tokenModeSupport.syncDeposit,\n  });\n\n  return { publicClient, vault, token, runtime };\n}\n\n/** Quotes an Aera synchronous deposit and its execution bounds. */\nexport async function getSyncDepositQuote(\n  client: GauntletClient,\n  params: SyncDepositQuoteParams\n): Promise<SyncDepositQuote> {\n  const slippageBps = params.slippageBps ?? DEFAULT_BPS;\n  if (!Number.isInteger(slippageBps) || slippageBps < 0 || slippageBps > Number(MAX_BPS)) {\n    throw new InvalidSlippageBPSError(slippageBps);\n  }\n\n  const { publicClient, vault, token, runtime } = await resolveSyncDepositContext(\n    client,\n    params,\n    'quote'\n  );\n\n  const { unitsOut, feeBps, numeraireOut } = await getSyncDepositQuoteValues(\n    publicClient,\n    runtime.provisioner.address,\n    runtime.feeCalculator.address,\n    runtime.feeCalculator.version,\n    vault.vaultAddress,\n    token.address,\n    params.amount\n  );\n  const minUnitsOut = applySlippageDown(unitsOut, slippageBps);\n  if (minUnitsOut <= 0n) throw new InvalidSyncDepositBoundError();\n\n  return { unitsOut, minUnitsOut, numeraireOut, feeBps, slippageBps };\n}\n\n/** Reads the live Instant Supply fee for a vault token, without requiring a deposit amount. */\nexport async function getSyncDepositRate(\n  client: GauntletClient,\n  params: SyncDepositRateParams\n): Promise<SyncDepositRate> {\n  const { publicClient, runtime, token } = await resolveSyncDepositContext(client, params, 'rate');\n\n  const feeBps = await getSyncDepositFeeBps(\n    publicClient,\n    runtime.provisioner.address,\n    token.address\n  );\n  return { feeBps };\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,uBAAqC;AACrC,oBAMO;AACP,2BAIO;AACP,gBAAgE;AAChE,2BAAqC;AACrC,mBAAgC;AAChC,oBAA6B;AAgC7B,eAAe,0BACb,QACA,QACA,UACA;AACA,QAAM,WAAW,UAAM,4BAAa,QAAQ,OAAO,SAAS,OAAO,OAAO;AAC1E,MAAI,CAAC,SAAU,OAAM,IAAI,iCAAmB,OAAO,SAAS,OAAO,OAAO;AAC1E,MAAI,SAAS,aAAa,QAAQ;AAChC,UAAM,IAAI;AAAA,MACR,aAAa,UACT,yDACA;AAAA,IACN;AAAA,EACF;AAEA,QAAM,EAAE,MAAM,IAAI;AAClB,QAAM,QACJ,MAAM,YAAY,SAAS,IACvB,MAAM,YAAY,KAAK,CAAC,EAAE,OAAO,MAAM,WAAW,OAAO,WAAW,IACpE,MAAM,YAAY,CAAC;AACzB,MAAI,CAAC,MAAO,OAAM,IAAI,oCAAsB,OAAO,eAAe,WAAW,OAAO,OAAO;AAE3F,QAAM,eAAe,OAAO,gBAAgB,OAAO,WAAW,MAAM,OAAO;AAC3E,QAAM,UAAU,UAAM,kDAA4B,cAAc,KAAK;AACrE,MAAI,QAAQ,YAAY,YAAY,6BAAgB,IAAI;AACtD,UAAM,IAAI;AAAA,MACR,aAAa,UACT,uDACA;AAAA,IACN;AAAA,EACF;AAEA,QAAM,mBAAmB,UAAM,kDAA4B,cAAc,SAAS,MAAM,SAAS;AAAA,IAC/F,kBAAkB;AAAA,EACpB,CAAC;AACD,iDAAqB,OAAO,SAAS,QAAQ;AAAA,IAC3C,OAAO,iBAAiB;AAAA,IACxB,MAAM,iBAAiB;AAAA,EACzB,CAAC;AAED,SAAO,EAAE,cAAc,OAAO,OAAO,QAAQ;AAC/C;AAGA,eAAsB,oBACpB,QACA,QAC2B;AAC3B,QAAM,cAAc,OAAO,eAAe;AAC1C,MAAI,CAAC,OAAO,UAAU,WAAW,KAAK,cAAc,KAAK,cAAc,OAAO,wBAAO,GAAG;AACtF,UAAM,IAAI,sCAAwB,WAAW;AAAA,EAC/C;AAEA,QAAM,EAAE,cAAc,OAAO,OAAO,QAAQ,IAAI,MAAM;AAAA,IACpD;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAEA,QAAM,EAAE,UAAU,QAAQ,aAAa,IAAI,UAAM;AAAA,IAC/C;AAAA,IACA,QAAQ,YAAY;AAAA,IACpB,QAAQ,cAAc;AAAA,IACtB,QAAQ,cAAc;AAAA,IACtB,MAAM;AAAA,IACN,MAAM;AAAA,IACN,OAAO;AAAA,EACT;AACA,QAAM,kBAAc,wCAAkB,UAAU,WAAW;AAC3D,MAAI,eAAe,GAAI,OAAM,IAAI,2CAA6B;AAE9D,SAAO,EAAE,UAAU,aAAa,cAAc,QAAQ,YAAY;AACpE;AAGA,eAAsB,mBACpB,QACA,QAC0B;AAC1B,QAAM,EAAE,cAAc,SAAS,MAAM,IAAI,MAAM,0BAA0B,QAAQ,QAAQ,MAAM;AAE/F,QAAM,SAAS,UAAM;AAAA,IACnB;AAAA,IACA,QAAQ,YAAY;AAAA,IACpB,MAAM;AAAA,EACR;AACA,SAAO,EAAE,OAAO;AAClB;",
+  "names": []
+}

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

@@ -0,0 +1,17 @@
+import type { Address } from 'viem';
+import type { GauntletClient } from "../client.js";
+import type { PreparedTx } from "../attribution/index.js";
+export interface EvmDepositReceiverApprovalParams {
+    vaultId: string;
+    depositor: Address;
+    approved?: boolean;
+    chainId?: number;
+}
+/**
+ * Builds the V2 receiver-side approval transaction required before a depositor
+ * can make sync deposits to a separate receiver.
+ *
+ * The wallet account on the client is the receiver and must sign this transaction.
+ */
+export declare function getDepositReceiverApprovalTx(client: GauntletClient, params: EvmDepositReceiverApprovalParams): Promise<PreparedTx>;
+//# sourceMappingURL=depositReceiverApproval.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"depositReceiverApproval.d.ts","sourceRoot":"","sources":["../../../src/evm/depositReceiverApproval.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAkB;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,gCAAuB;AAQjD,MAAM,WAAW,gCAAgC;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAsB,4BAA4B,CAChD,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,gCAAgC,GACvC,OAAO,CAAC,UAAU,CAAC,CAwBrB"}