@continuumdao/ctm-mpc-defi 0.1.4 → 0.2.1

package/dist/protocols/evm/euler-v2/index.cjs

@@ -0,0 +1,1585 @@
+'use strict';
+
+var viem = require('viem');
+var continuumNodeSdk = require('@continuumdao/continuum-node-sdk');
+
+// src/core/registry.ts
+var modules = [];
+function registerProtocolModule(mod) {
+  const existing = modules.findIndex((m) => m.id === mod.id);
+  if (existing >= 0) {
+    modules[existing] = mod;
+  } else {
+    modules.push(mod);
+  }
+}
+var EULER_SAME_ASSET_BORROW_PROTOCOL_HEADROOM_BPS = 50n;
+var EULER_SAME_ASSET_BORROW_APPROVAL_BUFFER_BPS = 100n;
+var EULER_SAME_ASSET_BORROW_MAX_ROUNDS = 48;
+var EULER_SAME_ASSET_BORROW_RATIO_STOP_EPS_BPS = 15n;
+function eulerBorrowAndCollateralSameAsset(row) {
+  const c = (row.collateralAssetAddressLower ?? "").trim().toLowerCase();
+  const b = (row.borrowAssetAddressLower ?? "").trim().toLowerCase();
+  if (!c.startsWith("0x") || !b.startsWith("0x")) return false;
+  try {
+    return viem.getAddress(c).toLowerCase() === viem.getAddress(b).toLowerCase();
+  } catch {
+    return false;
+  }
+}
+function planSameAssetLeveragedBorrows(args) {
+  const { initialCollateralWei: C0wei, oneBorrowUnitUoAWei, borrowDecimals, maxNewBorrowWei } = args;
+  const targetRaw = Number(args.targetLtvBps);
+  const maxLtvBps = Number(args.maxLtvBps);
+  if (C0wei <= 0n || oneBorrowUnitUoAWei <= 0n || maxNewBorrowWei <= 0n) return null;
+  if (!Number.isFinite(targetRaw) || !(targetRaw > 0) || targetRaw >= 1e4) return null;
+  if (!Number.isFinite(maxLtvBps) || !(maxLtvBps > 0) || maxLtvBps > 1e4) return null;
+  const unit = 10n ** BigInt(borrowDecimals);
+  const effectiveMax = maxLtvBps > Number(EULER_SAME_ASSET_BORROW_PROTOCOL_HEADROOM_BPS) ? maxLtvBps - Number(EULER_SAME_ASSET_BORROW_PROTOCOL_HEADROOM_BPS) : maxLtvBps;
+  let targetBps = Math.min(targetRaw, effectiveMax);
+  if (targetBps <= 0) return null;
+  const workingCeiling = Math.max(1, effectiveMax - Number(EULER_SAME_ASSET_BORROW_RATIO_STOP_EPS_BPS));
+  targetBps = Math.min(targetBps, workingCeiling);
+  const uoaFromBorrowWei = (w) => {
+    if (w <= 0n) return 0n;
+    return w * oneBorrowUnitUoAWei / unit;
+  };
+  let C = uoaFromBorrowWei(C0wei);
+  let D = 0n;
+  if (C <= 0n) return null;
+  const borrowWeis = [];
+  let liquidityLeft = maxNewBorrowWei;
+  const targetBn = BigInt(targetBps);
+  const stopBn = targetBn - BigInt(Number(EULER_SAME_ASSET_BORROW_RATIO_STOP_EPS_BPS));
+  const capBn = BigInt(effectiveMax);
+  for (let i = 0; i < EULER_SAME_ASSET_BORROW_MAX_ROUNDS; i++) {
+    if (C <= 0n) break;
+    const ratioBps = D * 10000n / C;
+    if (ratioBps >= stopBn) break;
+    const headroomUoa = capBn * C / 10000n - D;
+    if (headroomUoa <= 0n) break;
+    const den = 10000n - targetBn;
+    if (den <= 0n) break;
+    let bUoa = (targetBn * C - 10000n * D) / den;
+    if (bUoa <= 0n) break;
+    if (bUoa > headroomUoa) bUoa = headroomUoa;
+    let borrowWei = bUoa * unit / oneBorrowUnitUoAWei;
+    if (borrowWei <= 0n) break;
+    if (borrowWei > liquidityLeft) borrowWei = liquidityLeft;
+    if (borrowWei <= 0n) break;
+    const bUoaActual = uoaFromBorrowWei(borrowWei);
+    borrowWeis.push(borrowWei);
+    D += bUoaActual;
+    C += bUoaActual;
+    liquidityLeft -= borrowWei;
+  }
+  if (borrowWeis.length === 0) return null;
+  const totalBorrowWei = borrowWeis.reduce((a, w) => a + w, 0n);
+  const projectedFinalLtvBps = C > 0n ? D * 10000n / C : 0n;
+  return { borrowWeis, totalBorrowWei, projectedFinalLtvBps };
+}
+function eulerSameAssetTotalCollateralPullWei(args) {
+  let s = args.initialCollateralWei;
+  for (const w of args.loopBorrowWeis) s += w;
+  return s;
+}
+function eulerSameAssetApproveAmountWithBuffer(args) {
+  const extra = args.totalPullWei * EULER_SAME_ASSET_BORROW_APPROVAL_BUFFER_BPS / 10000n;
+  return args.totalPullWei + extra + 1n;
+}
+
+// src/core/purpose.ts
+function mergePurposeText(purposeText, purposeSuffix) {
+  const t = purposeText.trim();
+  const suffix = (purposeSuffix ?? "").trim();
+  if (!suffix) return t;
+  return t ? `${t}
+
+${suffix}` : suffix;
+}
+
+// src/core/envelope.ts
+function finalizeMultisign(input) {
+  const { keyGen, destinationChainID, legs } = input;
+  if (legs.length === 0) {
+    throw new Error("finalizeMultisign requires at least one leg");
+  }
+  const ph = (keyGen.pubkeyhex ?? "").trim();
+  if (!ph) throw new Error("keyGen pubKey (pubkeyhex) is required");
+  const keyList = keyGen.keylist ?? [];
+  const clientId = continuumNodeSdk.getClientIdFromKeyGenResult(keyGen);
+  const first = legs[0];
+  const messageHashes = legs.map((l) => l.msgHash);
+  const messageRawBatch = legs.map((l) => l.msgRaw);
+  const batchMeta = legs.map((l) => ({
+    destinationAddress: l.destinationAddress,
+    signatureText: l.signatureText,
+    ...l.audit
+  }));
+  const proposalTxParams = legs.map((l) => l.proposalTxParams).filter((p) => p != null && typeof p === "object");
+  const extraPayload = {
+    batchMeta,
+    ...input.extraJSON ?? {}
+  };
+  const extraJSON = JSON.stringify(extraPayload);
+  const bodyForSign = {
+    keyList,
+    pubKey: ph,
+    msgHash: messageHashes[0],
+    msgRaw: first.msgRaw,
+    destinationChainID,
+    destinationAddress: input.destinationAddress ?? first.destinationAddress,
+    extraJSON,
+    signatureText: first.signatureText,
+    purpose: mergePurposeText(input.purposeText, input.purposeSuffix),
+    ...first.feeSnapshot
+  };
+  if (legs.length > 1) {
+    bodyForSign.messageHashes = messageHashes;
+    bodyForSign.messageRawBatch = messageRawBatch;
+  }
+  if (proposalTxParams.length > 0) {
+    bodyForSign.proposalTxParams = proposalTxParams;
+  }
+  const valueWei = first.valueWei;
+  if (valueWei != null && valueWei > 0n) {
+    bodyForSign.value = valueWei.toString();
+  }
+  if (clientId) bodyForSign.clientId = clientId;
+  return { bodyForSign, messageToSign: JSON.stringify(bodyForSign) };
+}
+function routerSwapGasLimitFromEstimate(estimatedGas, chainGasLimit) {
+  if (chainGasLimit != null && Number.isFinite(chainGasLimit) && chainGasLimit > 0) {
+    return continuumNodeSdk.gasLimitFromEstimateAndChainConfig(estimatedGas, chainGasLimit);
+  }
+  return (estimatedGas * 12n + 9n) / 10n;
+}
+
+// src/chains/evm/buildBatch.ts
+async function buildEvmMultisignBatch(args) {
+  const { context, steps } = args;
+  const {
+    chainId,
+    rpcUrl,
+    executorAddress,
+    chainDetail,
+    useCustomGas,
+    customGasChainDetails,
+    keyGen,
+    purposeText
+  } = context;
+  if (steps.length === 0) throw new Error("buildEvmMultisignBatch requires at least one step");
+  const ch = viem.defineChain({
+    id: chainId,
+    name: "Destination",
+    nativeCurrency: { decimals: 18, name: "Ether", symbol: "ETH" },
+    rpcUrls: { default: { http: [rpcUrl] } }
+  });
+  const publicClient = viem.createPublicClient({ chain: ch, transport: viem.http(rpcUrl) });
+  const feeParams = await continuumNodeSdk.fetchChainFeeParams(rpcUrl, chainId);
+  const legacy = Boolean(chainDetail?.legacy) || !feeParams.isEip1559;
+  const latestBaseFeeWei = !legacy ? (await publicClient.getBlock({ blockTag: "latest" })).baseFeePerGas ?? 0n : 0n;
+  const gasLimitConfig = useCustomGas && chainDetail?.gasLimit != null ? Number(chainDetail.gasLimit) : void 0;
+  const chainGasLimitRouter = chainDetail?.gasLimit != null && Number.isFinite(Number(chainDetail.gasLimit)) && Number(chainDetail.gasLimit) > 0 ? Number(chainDetail.gasLimit) : void 0;
+  const gasFeeMultiplier = useCustomGas && chainDetail?.gasMultiplier != null ? Number(chainDetail.gasMultiplier) : void 0;
+  const executor = viem.getAddress(executorAddress);
+  const baseNonce = await publicClient.getTransactionCount({ address: executor, blockTag: "pending" });
+  const legs = [];
+  for (let i = 0; i < steps.length; i++) {
+    const step = steps[i];
+    const currentNonce = baseNonce + i;
+    let estimatedGas;
+    if (args.estimateGasForStep) {
+      estimatedGas = await args.estimateGasForStep({ step, index: i, publicClient, executor });
+    } else {
+      try {
+        estimatedGas = await publicClient.estimateGas({
+          to: step.to,
+          data: step.data,
+          value: step.value,
+          account: executor
+        });
+      } catch {
+        estimatedGas = step.fallbackGas ?? 100000n;
+      }
+    }
+    let gasLimitI;
+    if (args.resolveGasLimit) {
+      gasLimitI = await args.resolveGasLimit({ step, index: i, estimatedGas, publicClient });
+    } else if (step.routerSwap) {
+      gasLimitI = routerSwapGasLimitFromEstimate(estimatedGas, chainGasLimitRouter);
+    } else {
+      gasLimitI = useCustomGas ? continuumNodeSdk.gasLimitFromEstimateAndChainConfig(estimatedGas, gasLimitConfig) : estimatedGas;
+    }
+    let proposalTxParams;
+    let feeSnapshot;
+    let serialized;
+    if (legacy) {
+      let gasPriceWei = await publicClient.getGasPrice();
+      if (useCustomGas && gasFeeMultiplier != null && gasFeeMultiplier > 0) {
+        gasPriceWei = gasPriceWei * BigInt(100 + gasFeeMultiplier) / 100n;
+      }
+      if (useCustomGas && chainDetail?.gasPrice != null && chainDetail.gasPrice > 0) {
+        const configured = viem.parseGwei(continuumNodeSdk.gweiToDecimalString(Number(chainDetail.gasPrice)));
+        if (configured > gasPriceWei) gasPriceWei = configured;
+      }
+      serialized = viem.serializeTransaction({
+        type: "legacy",
+        to: step.to,
+        data: step.data,
+        value: step.value,
+        gas: gasLimitI,
+        gasPrice: gasPriceWei,
+        nonce: currentNonce,
+        chainId
+      });
+      proposalTxParams = {
+        nonce: currentNonce,
+        gasLimit: gasLimitI.toString(),
+        txType: "legacy",
+        gasPrice: gasPriceWei.toString()
+      };
+      feeSnapshot = continuumNodeSdk.proposalTxParamsToFeeSnapshot(proposalTxParams);
+    } else {
+      const fetchedBase = feeParams.baseFeeGwei ?? 0;
+      const fetchedPriority = feeParams.priorityFeeGwei ?? 0;
+      const configuredBase = useCustomGas && chainDetail?.baseFee != null ? Number(chainDetail.baseFee) : 0;
+      const configuredPriority = useCustomGas && chainDetail?.priorityFee != null ? Number(chainDetail.priorityFee) : 0;
+      const effectiveBaseFeeGwei = Math.max(fetchedBase, configuredBase);
+      const effectivePriorityFeeGwei = Math.max(fetchedPriority, configuredPriority);
+      const baseFeeMultiplierPct = useCustomGas && chainDetail?.baseFeeMultiplier != null ? Math.max(100, Number(chainDetail.baseFeeMultiplier)) : 100;
+      const baseComponentGwei = effectiveBaseFeeGwei * baseFeeMultiplierPct / 100;
+      const maxFeePerGasGwei = baseComponentGwei + effectivePriorityFeeGwei;
+      let maxPriorityFeePerGas = effectivePriorityFeeGwei > 0 ? viem.parseGwei(continuumNodeSdk.gweiToDecimalString(effectivePriorityFeeGwei)) : viem.parseGwei("1");
+      let maxFeePerGas = viem.parseGwei(continuumNodeSdk.gweiToDecimalString(maxFeePerGasGwei));
+      if (useCustomGas && gasFeeMultiplier != null && gasFeeMultiplier > 0) {
+        maxPriorityFeePerGas = maxPriorityFeePerGas * BigInt(100 + gasFeeMultiplier) / 100n;
+        maxFeePerGas = maxFeePerGas * BigInt(100 + gasFeeMultiplier) / 100n;
+      }
+      ({ maxFeePerGas, maxPriorityFeePerGas } = continuumNodeSdk.alignEip1559FeesWithLatestBase(
+        maxFeePerGas,
+        maxPriorityFeePerGas,
+        latestBaseFeeWei
+      ));
+      serialized = viem.serializeTransaction({
+        type: "eip1559",
+        to: step.to,
+        data: step.data,
+        value: step.value,
+        gas: gasLimitI,
+        maxFeePerGas,
+        maxPriorityFeePerGas,
+        nonce: currentNonce,
+        chainId
+      });
+      proposalTxParams = {
+        nonce: currentNonce,
+        gasLimit: gasLimitI.toString(),
+        txType: "eip1559",
+        maxFeePerGas: maxFeePerGas.toString(),
+        maxPriorityFeePerGas: maxPriorityFeePerGas.toString()
+      };
+      feeSnapshot = i === 0 ? continuumNodeSdk.proposalTxParamsToFeeSnapshot(proposalTxParams) : {};
+    }
+    const h = viem.keccak256(serialized);
+    const msgHash = h.startsWith("0x") ? h.slice(2) : h;
+    const batchMetaExtra = args.buildBatchMeta({ step, index: i, gasLimit: gasLimitI });
+    legs.push({
+      msgHash,
+      msgRaw: i === 0 && args.firstMsgRawNo0x != null ? args.firstMsgRawNo0x : serialized,
+      destinationAddress: step.to,
+      signatureText: typeof batchMetaExtra.signatureText === "string" ? batchMetaExtra.signatureText : JSON.stringify(batchMetaExtra.signatureText ?? {}),
+      audit: batchMetaExtra,
+      feeSnapshot: i === 0 ? feeSnapshot : {},
+      proposalTxParams,
+      valueWei: i === 0 ? step.value : void 0
+    });
+    if (i === 0 && args.firstMsgRawNo0x != null) {
+      legs[0].msgRaw = args.firstMsgRawNo0x;
+    }
+  }
+  const extraJSON = {};
+  if (useCustomGas && customGasChainDetails && Object.keys(customGasChainDetails).length > 0) {
+    extraJSON.customGasChainDetails = customGasChainDetails;
+  }
+  const result = finalizeMultisign({
+    keyGen,
+    purposeText,
+    purposeSuffix: args.purposeSuffix,
+    destinationChainID: String(chainId),
+    destinationAddress: args.destinationAddress ?? steps[0].to,
+    legs,
+    extraJSON: Object.keys(extraJSON).length > 0 ? extraJSON : void 0
+  });
+  const pv = args.payableValueWei;
+  if (pv != null && pv > 0n) {
+    result.bodyForSign.value = pv.toString();
+  }
+  return result;
+}
+
+// src/protocols/evm/euler-v2/vaultWithdrawMultisign.ts
+var EULER_V2_VAULT_WITHDRAW_FALLBACK_GAS = 900000n;
+var erc20DecimalsAbi = viem.parseAbi(["function decimals() view returns (uint8)"]);
+var erc4626AssetAbi = viem.parseAbi(["function asset() view returns (address)"]);
+var erc4626MaxWithdrawAbi = viem.parseAbi(["function maxWithdraw(address owner) view returns (uint256)"]);
+var erc4626WithdrawAbi = viem.parseAbi([
+  "function withdraw(uint256 assets, address receiver, address owner) returns (uint256 shares)"
+]);
+async function fetchEulerVaultUnderlyingMeta(args) {
+  const ch = viem.defineChain({
+    id: args.chainId,
+    name: "Destination",
+    nativeCurrency: { decimals: 18, name: "Ether", symbol: "ETH" },
+    rpcUrls: { default: { http: [args.rpcUrl] } }
+  });
+  const publicClient = viem.createPublicClient({ chain: ch, transport: viem.http(args.rpcUrl) });
+  const assetAddrRaw = await publicClient.readContract({
+    address: args.evault,
+    abi: erc4626AssetAbi,
+    functionName: "asset"
+  });
+  const assetAddr = viem.getAddress(assetAddrRaw);
+  const d = await publicClient.readContract({
+    address: assetAddr,
+    abi: erc20DecimalsAbi,
+    functionName: "decimals"
+  });
+  const n = typeof d === "bigint" ? Number(d) : Number(d);
+  const decimals = !Number.isFinite(n) || n < 0 || n > 36 ? 18 : n;
+  return { asset: assetAddr, decimals };
+}
+function clampEulerUnderlyingDecimalsForEulerUi(args) {
+  const a = args.underlyingAssetLower.trim().toLowerCase();
+  let d = args.fetchedDecimals;
+  if (args.wrappedGasAliasesLower.has(a)) {
+    return Math.max(d, 18);
+  }
+  if (d >= 18) return d;
+  const label = `${args.underlyingSymbol} ${args.marketName}`;
+  const ethish = /\b(WETH|wstETH|stETH|rETH|weETH|eETH)\b/i.test(label) || /(^|[^A-Z0-9])ETH([^A-Z0-9]|$)/i.test(label);
+  if (ethish) return 18;
+  return d;
+}
+async function fetchEulerVaultAssetDecimals(args) {
+  const m = await fetchEulerVaultUnderlyingMeta(args);
+  return m.decimals;
+}
+async function fetchEulerVaultMaxWithdrawWei(args) {
+  const ch = viem.defineChain({
+    id: args.chainId,
+    name: "Destination",
+    nativeCurrency: { decimals: 18, name: "Ether", symbol: "ETH" },
+    rpcUrls: { default: { http: [args.rpcUrl] } }
+  });
+  const publicClient = viem.createPublicClient({ chain: ch, transport: viem.http(args.rpcUrl) });
+  return publicClient.readContract({
+    address: args.evault,
+    abi: erc4626MaxWithdrawAbi,
+    functionName: "maxWithdraw",
+    args: [args.owner]
+  });
+}
+var eulerVaultSharesCashAbi = viem.parseAbi([
+  "function balanceOf(address account) view returns (uint256)",
+  "function convertToAssets(uint256 shares) view returns (uint256)",
+  "function cash() view returns (uint256)"
+]);
+async function eulerDirectWithdrawSimulatesOk(args) {
+  const withdrawData = viem.encodeFunctionData({
+    abi: erc4626WithdrawAbi,
+    functionName: "withdraw",
+    args: [args.assetsWei, args.receiver, args.vaultShareOwner]
+  });
+  try {
+    await args.publicClient.call({
+      account: args.txSender,
+      to: args.evault,
+      data: withdrawData,
+      gas: 8000000n
+    });
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function eulerLendEarnEffectiveMaxWeiBySimulation(args) {
+  const ch = viem.defineChain({
+    id: args.chainId,
+    name: "EulerLendRedeem",
+    nativeCurrency: { decimals: 18, name: "Ether", symbol: "ETH" },
+    rpcUrls: { default: { http: [args.rpcUrl] } }
+  });
+  const publicClient = viem.createPublicClient({ chain: ch, transport: viem.http(args.rpcUrl) });
+  let shareBal;
+  let vaultCash;
+  try {
+    ;
+    [shareBal, vaultCash] = await Promise.all([
+      publicClient.readContract({
+        address: args.evault,
+        abi: eulerVaultSharesCashAbi,
+        functionName: "balanceOf",
+        args: [args.vaultShareOwner]
+      }),
+      publicClient.readContract({
+        address: args.evault,
+        abi: eulerVaultSharesCashAbi,
+        functionName: "cash"
+      })
+    ]);
+  } catch {
+    return 0n;
+  }
+  if (shareBal === 0n) return 0n;
+  let assetsOwned;
+  try {
+    assetsOwned = await publicClient.readContract({
+      address: args.evault,
+      abi: eulerVaultSharesCashAbi,
+      functionName: "convertToAssets",
+      args: [shareBal]
+    });
+  } catch {
+    return 0n;
+  }
+  const hi = vaultCash <= 0n ? 0n : vaultCash <= assetsOwned ? vaultCash : assetsOwned;
+  if (hi === 0n) return 0n;
+  let lo = 0n;
+  let hiProbe = hi;
+  let best = 0n;
+  while (lo <= hiProbe) {
+    const mid = lo + (hiProbe - lo) / 2n;
+    const ok = await eulerDirectWithdrawSimulatesOk({
+      publicClient,
+      evault: args.evault,
+      vaultShareOwner: args.vaultShareOwner,
+      receiver: args.receiver,
+      txSender: args.txSender,
+      assetsWei: mid
+    });
+    if (ok) {
+      best = mid;
+      lo = mid + 1n;
+    } else {
+      hiProbe = mid - 1n;
+    }
+  }
+  return best;
+}
+async function fetchEulerLendEarnVaultEffectiveMaxWithdrawWei(args) {
+  const rpc = args.rpcUrl.trim();
+  if (!rpc) return 0n;
+  const evault = viem.getAddress(args.evault);
+  const vaultShareOwner = viem.getAddress(args.vaultShareOwner);
+  const txSender = viem.getAddress(args.txSender);
+  const receiver = txSender;
+  const std = await fetchEulerVaultMaxWithdrawWei({
+    rpcUrl: rpc,
+    chainId: args.chainId,
+    evault,
+    owner: vaultShareOwner
+  });
+  if (std > 0n) return std;
+  return eulerLendEarnEffectiveMaxWeiBySimulation({
+    rpcUrl: rpc,
+    chainId: args.chainId,
+    evault,
+    vaultShareOwner,
+    receiver,
+    txSender
+  });
+}
+async function buildEvmMultisignBodyEulerV2VaultWithdraw(args) {
+  const evault = viem.getAddress(args.evault);
+  const receiver = viem.getAddress(args.owner);
+  const shareOwner = viem.getAddress(args.vaultShareOwner ?? args.owner);
+  const executor = viem.getAddress(args.executorAddress);
+  const dec = await fetchEulerVaultAssetDecimals({ rpcUrl: args.rpcUrl, chainId: args.chainId, evault });
+  const amountWei = viem.parseUnits(args.amountHuman, dec);
+  if (amountWei === 0n) throw new Error("Withdraw amount is zero after converting with token decimals.");
+  const maxW = await fetchEulerLendEarnVaultEffectiveMaxWithdrawWei({
+    rpcUrl: args.rpcUrl,
+    chainId: args.chainId,
+    evault,
+    vaultShareOwner: shareOwner,
+    txSender: executor
+  });
+  if (amountWei > maxW) {
+    throw new Error("Withdraw amount exceeds simulated max redeem for this vault (LTV / vault cash). Try a smaller amount.");
+  }
+  const withdrawData = viem.encodeFunctionData({
+    abi: erc4626WithdrawAbi,
+    functionName: "withdraw",
+    args: [amountWei, receiver, shareOwner]
+  });
+  const vaultLabel = (args.vaultMarketLabel ?? "").trim() || "Euler vault";
+  const purposeSuffix = `Euler v2: 1-tx \u2014 eVault.withdraw (${args.amountHuman} underlying) from isolated vault "${vaultLabel}" (ERC-4626).`;
+  const evmSteps = [
+    {
+      to: evault,
+      data: withdrawData,
+      value: 0n,
+      fallbackGas: EULER_V2_VAULT_WITHDRAW_FALLBACK_GAS
+    }
+  ];
+  const firstDataNo0x = withdrawData.startsWith("0x") ? withdrawData.slice(2) : withdrawData;
+  return buildEvmMultisignBatch({
+    context: {
+      chainCategory: "evm",
+      keyGen: args.keyGen,
+      purposeText: args.purposeText,
+      chainId: args.chainId,
+      rpcUrl: args.rpcUrl,
+      executorAddress: executor,
+      chainDetail: args.chainDetail,
+      useCustomGas: args.useCustomGas,
+      customGasChainDetails: args.customGasChainDetails
+    },
+    steps: evmSteps,
+    purposeSuffix,
+    firstMsgRawNo0x: firstDataNo0x,
+    destinationAddress: evault,
+    buildBatchMeta: ({ gasLimit }) => ({
+      signatureText: JSON.stringify({
+        kind: "EulerV2",
+        name: "EVault.withdraw",
+        function: "withdraw(uint256 assets, address receiver, address owner)",
+        evault,
+        receiver,
+        owner: shareOwner,
+        vaultMarket: vaultLabel,
+        amountHuman: args.amountHuman
+      }),
+      evm: { type: "euler_v2_vault_withdraw", version: 1, chainId: String(args.chainId) },
+      eulerV2: {
+        vaultMarket: vaultLabel,
+        amountHuman: args.amountHuman,
+        evault,
+        owner: shareOwner,
+        gasBuildWithdraw: { baseGasUnits: gasLimit.toString() }
+      }
+    })
+  });
+}
+
+// src/protocols/evm/euler-v2/borrowCollateralMaxWithdrawWei.ts
+var erc4626WithdrawAbi2 = viem.parseAbi([
+  "function withdraw(uint256 assets, address receiver, address owner) returns (uint256 shares)"
+]);
+var evcBatchAbi = viem.parseAbi([
+  "function batch((address targetContract, address onBehalfOfAccount, uint256 value, bytes data)[])"
+]);
+var eulerCollateralVaultReadAbi = viem.parseAbi([
+  "function balanceOf(address account) view returns (uint256)",
+  "function convertToAssets(uint256 shares) view returns (uint256)",
+  "function cash() view returns (uint256)"
+]);
+async function evcWithdrawSimulatesOk(args) {
+  const withdrawData = viem.encodeFunctionData({
+    abi: erc4626WithdrawAbi2,
+    functionName: "withdraw",
+    args: [args.assetsWei, args.caller, args.subAccount]
+  });
+  const batchData = viem.encodeFunctionData({
+    abi: evcBatchAbi,
+    functionName: "batch",
+    args: [
+      [
+        {
+          targetContract: args.collateralVault,
+          onBehalfOfAccount: args.subAccount,
+          value: 0n,
+          data: withdrawData
+        }
+      ]
+    ]
+  });
+  try {
+    await args.publicClient.call({
+      account: args.caller,
+      to: args.evc,
+      data: batchData,
+      gas: 8000000n
+    });
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function collateralMaxWithdrawBySimulation(args) {
+  const ch = viem.defineChain({
+    id: args.chainId,
+    name: "EulerColMaxW",
+    nativeCurrency: { decimals: 18, name: "Ether", symbol: "ETH" },
+    rpcUrls: { default: { http: [args.rpcUrl] } }
+  });
+  const publicClient = viem.createPublicClient({ chain: ch, transport: viem.http(args.rpcUrl) });
+  let shareBal;
+  let assetsOwned;
+  let vaultCash;
+  try {
+    ;
+    [shareBal, vaultCash] = await Promise.all([
+      publicClient.readContract({
+        address: args.collateralVault,
+        abi: eulerCollateralVaultReadAbi,
+        functionName: "balanceOf",
+        args: [args.subAccount]
+      }),
+      publicClient.readContract({
+        address: args.collateralVault,
+        abi: eulerCollateralVaultReadAbi,
+        functionName: "cash"
+      })
+    ]);
+  } catch {
+    return 0n;
+  }
+  if (shareBal === 0n) return 0n;
+  try {
+    assetsOwned = await publicClient.readContract({
+      address: args.collateralVault,
+      abi: eulerCollateralVaultReadAbi,
+      functionName: "convertToAssets",
+      args: [shareBal]
+    });
+  } catch {
+    return 0n;
+  }
+  const hi = vaultCash <= 0n ? 0n : vaultCash <= assetsOwned ? vaultCash : assetsOwned;
+  if (hi === 0n) return 0n;
+  let lo = 0n;
+  let hiProbe = hi;
+  let best = 0n;
+  while (lo <= hiProbe) {
+    const mid = lo + (hiProbe - lo) / 2n;
+    const ok = await evcWithdrawSimulatesOk({
+      publicClient,
+      evc: args.evc,
+      collateralVault: args.collateralVault,
+      subAccount: args.subAccount,
+      caller: args.caller,
+      assetsWei: mid
+    });
+    if (ok) {
+      best = mid;
+      lo = mid + 1n;
+    } else {
+      hiProbe = mid - 1n;
+    }
+  }
+  return best;
+}
+async function fetchEulerBorrowCollateralMaxWithdrawAssetsWei(args) {
+  const rpcUrl = args.rpcUrl.trim();
+  if (!rpcUrl) return 0n;
+  const evc = viem.getAddress(args.evc);
+  const collateralVault = viem.getAddress(args.collateralVault);
+  const subAccount = viem.getAddress(args.subAccount);
+  const caller = viem.getAddress(args.caller);
+  const stdMax = await fetchEulerVaultMaxWithdrawWei({
+    rpcUrl,
+    chainId: args.chainId,
+    evault: collateralVault,
+    owner: subAccount
+  });
+  if (stdMax > 0n) return stdMax;
+  return collateralMaxWithdrawBySimulation({
+    rpcUrl,
+    chainId: args.chainId,
+    evc,
+    collateralVault,
+    subAccount,
+    caller
+  });
+}
+var EULER_V2_ISOLATED_VAULT_DEPOSIT_FALLBACK_GAS = 950000n;
+var EULER_VAULT_DEPOSIT_ESTIMATE_FALLBACK = EULER_V2_ISOLATED_VAULT_DEPOSIT_FALLBACK_GAS;
+var EULER_ERC20_APPROVE_FALLBACK = 100000n;
+var EULER_WETH_DEPOSIT_FALLBACK = 120000n;
+var wethDepositAbi = viem.parseAbi(["function deposit() payable"]);
+var erc20AllowanceAbi = viem.parseAbi([
+  "function allowance(address owner, address spender) view returns (uint256)",
+  "function decimals() view returns (uint8)"
+]);
+var erc20ApproveAbi = viem.parseAbi(["function approve(address spender, uint256 amount) returns (bool)"]);
+var erc4626DepositAbi = viem.parseAbi([
+  "function deposit(uint256 assets, address receiver) returns (uint256 shares)"
+]);
+async function buildEvmMultisignBodyEulerV2IsolatedLendDepositBatch(args) {
+  const asset = viem.getAddress(args.underlying);
+  const evault = viem.getAddress(args.evault);
+  const weth = viem.getAddress(args.nativeWrapped);
+  const executor = viem.getAddress(args.executorAddress);
+  const receiver = viem.getAddress(args.receiver);
+  if (args.isNativeIn && asset.toLowerCase() !== weth.toLowerCase()) {
+    throw new Error("Native lend path: underlying asset must match the chain wrapped native token.");
+  }
+  const ch = viem.defineChain({
+    id: args.chainId,
+    name: "Destination",
+    nativeCurrency: { decimals: 18, name: "Ether", symbol: "ETH" },
+    rpcUrls: { default: { http: [args.rpcUrl] } }
+  });
+  const publicClient = viem.createPublicClient({ chain: ch, transport: viem.http(args.rpcUrl) });
+  const dec = await publicClient.readContract({
+    address: asset,
+    abi: erc20AllowanceAbi,
+    functionName: "decimals"
+  });
+  const amountWei = viem.parseUnits(args.amountHuman, Number(dec));
+  if (amountWei === 0n) throw new Error("Amount is zero after converting with token decimals.");
+  const steps = [];
+  if (args.isNativeIn) {
+    const dataDeposit = viem.encodeFunctionData({ abi: wethDepositAbi, functionName: "deposit", args: [] });
+    steps.push({ kind: "weth_deposit", to: weth, data: dataDeposit, value: amountWei });
+    const wethAllowance = await publicClient.readContract({
+      address: weth,
+      abi: erc20AllowanceAbi,
+      functionName: "allowance",
+      args: [executor, evault]
+    });
+    if (wethAllowance < amountWei) {
+      if (wethAllowance > 0n) {
+        const dataReset = viem.encodeFunctionData({
+          abi: erc20ApproveAbi,
+          functionName: "approve",
+          args: [evault, 0n]
+        });
+        steps.push({ kind: "approve", to: weth, data: dataReset, value: 0n });
+      }
+      const dataApprove = viem.encodeFunctionData({
+        abi: erc20ApproveAbi,
+        functionName: "approve",
+        args: [evault, amountWei]
+      });
+      steps.push({ kind: "approve", to: weth, data: dataApprove, value: 0n });
+    }
+  } else {
+    const currentAllowance = await publicClient.readContract({
+      address: asset,
+      abi: erc20AllowanceAbi,
+      functionName: "allowance",
+      args: [executor, evault]
+    });
+    if (currentAllowance < amountWei) {
+      if (currentAllowance > 0n) {
+        const dataReset = viem.encodeFunctionData({
+          abi: erc20ApproveAbi,
+          functionName: "approve",
+          args: [evault, 0n]
+        });
+        steps.push({ kind: "approve", to: asset, data: dataReset, value: 0n });
+      }
+      const dataApprove = viem.encodeFunctionData({
+        abi: erc20ApproveAbi,
+        functionName: "approve",
+        args: [evault, amountWei]
+      });
+      steps.push({ kind: "approve", to: asset, data: dataApprove, value: 0n });
+    }
+  }
+  const depositData = viem.encodeFunctionData({
+    abi: erc4626DepositAbi,
+    functionName: "deposit",
+    args: [amountWei, receiver]
+  });
+  steps.push({ kind: "vault_deposit", to: evault, data: depositData, value: 0n });
+  const vaultLabel = (args.vaultMarketLabel ?? "").trim() || "Euler vault";
+  const evmSteps = steps.map((s) => ({
+    to: s.to,
+    data: s.data,
+    value: s.value,
+    fallbackGas: s.kind === "weth_deposit" ? EULER_WETH_DEPOSIT_FALLBACK : s.kind === "approve" ? EULER_ERC20_APPROVE_FALLBACK : EULER_VAULT_DEPOSIT_ESTIMATE_FALLBACK
+  }));
+  const n = steps.length;
+  const hasWrap = args.isNativeIn;
+  const purposeSuffix = (() => {
+    if (hasWrap) {
+      return `Euler v2: ${n}-tx batch \u2014 wrap native to WETH (if needed), approve eVault for the exact amount, then ERC-4626 deposit into isolated vault "${vaultLabel}".`;
+    }
+    if (n === 1) {
+      return `Euler v2: 1-tx \u2014 eVault.deposit (allowance already sufficient) into "${vaultLabel}".`;
+    }
+    return `Euler v2: ${n}-tx batch \u2014 approve eVault for the exact amount, then ERC-4626 deposit into "${vaultLabel}".`;
+  })();
+  const firstDataNo0x = evmSteps[0].data.startsWith("0x") ? evmSteps[0].data.slice(2) : evmSteps[0].data;
+  return buildEvmMultisignBatch({
+    context: {
+      chainCategory: "evm",
+      keyGen: args.keyGen,
+      purposeText: args.purposeText,
+      chainId: args.chainId,
+      rpcUrl: args.rpcUrl,
+      executorAddress: executor,
+      chainDetail: args.chainDetail,
+      useCustomGas: args.useCustomGas,
+      customGasChainDetails: args.customGasChainDetails
+    },
+    steps: evmSteps,
+    purposeSuffix,
+    firstMsgRawNo0x: firstDataNo0x,
+    destinationAddress: steps[0].to,
+    buildBatchMeta: ({ index, gasLimit }) => {
+      const s = steps[index];
+      if (s.kind === "weth_deposit") {
+        return {
+          signatureText: JSON.stringify({
+            kind: "EulerV2",
+            name: "WETH.deposit",
+            function: "deposit()",
+            valueWei: amountWei.toString(),
+            vaultMarket: vaultLabel,
+            note: "Wrap native for Euler v2 isolated vault deposit (same batch)."
+          }),
+          evm: { type: "euler_v2_weth_deposit", version: 1, chainId: String(args.chainId) },
+          eulerV2: {
+            step: "weth_deposit",
+            vaultMarket: vaultLabel,
+            amountHuman: args.amountHuman,
+            evault,
+            underlying: asset
+          }
+        };
+      }
+      if (s.kind === "approve") {
+        return {
+          signatureText: JSON.stringify({
+            kind: "EulerV2",
+            name: "ERC20.approve",
+            to: "Euler eVault",
+            function: "approve(address spender, uint256 amount)",
+            evault,
+            amountHuman: args.amountHuman,
+            note: "Allowance for this deposit amount only (not unlimited)."
+          }),
+          evm: { type: "euler_v2_erc20_approve", version: 1, chainId: String(args.chainId) },
+          eulerV2: { vaultMarket: vaultLabel, amountHuman: args.amountHuman, evault, underlying: asset }
+        };
+      }
+      return {
+        signatureText: JSON.stringify({
+          kind: "EulerV2",
+          name: "EVault.deposit",
+          function: "deposit(uint256 assets, address receiver)",
+          evault,
+          underlying: asset,
+          receiver,
+          vaultMarket: vaultLabel,
+          amountHuman: args.amountHuman
+        }),
+        evm: { type: "euler_v2_vault_deposit", version: 1, chainId: String(args.chainId) },
+        eulerV2: {
+          vaultMarket: vaultLabel,
+          amountHuman: args.amountHuman,
+          evault,
+          underlying: asset,
+          receiver,
+          gasBuildDeposit: { baseGasUnits: gasLimit.toString() }
+        }
+      };
+    }
+  });
+}
+var EULER_BORROW_BATCH_FALLBACK_GAS = 2500000n;
+var EULER_BORROW_BATCH_FALLBACK_GAS_PER_ROUND = 350000n;
+var EULER_ERC20_APPROVE_FALLBACK2 = 100000n;
+var EULER_WETH_DEPOSIT_FALLBACK2 = 120000n;
+var wethDepositAbi2 = viem.parseAbi(["function deposit() payable"]);
+var erc20AllowanceAbi2 = viem.parseAbi([
+  "function allowance(address owner, address spender) view returns (uint256)",
+  "function decimals() view returns (uint8)"
+]);
+var erc20ApproveAbi2 = viem.parseAbi(["function approve(address spender, uint256 amount) returns (bool)"]);
+var erc4626DepositAbi2 = viem.parseAbi([
+  "function deposit(uint256 assets, address receiver) returns (uint256 shares)"
+]);
+var evaultBorrowAbi = viem.parseAbi(["function borrow(uint256 amount, address receiver) returns (uint256)"]);
+var evcAbi = viem.parseAbi([
+  "function batch((address targetContract, address onBehalfOfAccount, uint256 value, bytes data)[])"
+]);
+async function buildEvmMultisignBodyEulerV2IsolatedBorrowBatch(args) {
+  const evc = viem.getAddress(args.evc);
+  const borrowVault = viem.getAddress(args.borrowVault);
+  const collateralVault = viem.getAddress(args.collateralVault);
+  const collateralAsset = viem.getAddress(args.collateralUnderlying);
+  const borrowAsset = viem.getAddress(args.borrowUnderlying);
+  const weth = viem.getAddress(args.nativeWrapped);
+  const executor = viem.getAddress(args.executorAddress);
+  const receiver = viem.getAddress(args.receiver);
+  if (args.isNativeCollateralIn && collateralAsset.toLowerCase() !== weth.toLowerCase()) {
+    throw new Error("Native collateral path: collateral underlying must be the chain wrapped native token.");
+  }
+  const ch = viem.defineChain({
+    id: args.chainId,
+    name: "Destination",
+    nativeCurrency: { decimals: 18, name: "Ether", symbol: "ETH" },
+    rpcUrls: { default: { http: [args.rpcUrl] } }
+  });
+  const publicClient = viem.createPublicClient({ chain: ch, transport: viem.http(args.rpcUrl) });
+  const cDecRaw = await publicClient.readContract({
+    address: collateralAsset,
+    abi: erc20AllowanceAbi2,
+    functionName: "decimals"
+  });
+  const collateralDecimals = Number(cDecRaw);
+  const collateralWei = viem.parseUnits(args.collateralAmountHuman, collateralDecimals);
+  if (collateralWei === 0n) throw new Error("Collateral amount is zero after converting with token decimals.");
+  await publicClient.readContract({
+    address: borrowAsset,
+    abi: erc20AllowanceAbi2,
+    functionName: "decimals"
+  });
+  const loops = [...args.loopBorrowWeis];
+  if (loops.length === 0) throw new Error("At least one borrow round is required.");
+  for (const w of loops) {
+    if (w <= 0n) throw new Error("Each borrow round must be positive.");
+  }
+  if (!args.redepositBorrowedToCollateral && loops.length !== 1) {
+    throw new Error("Multiple borrow rounds require redepositBorrowedToCollateral (same borrow and collateral asset).");
+  }
+  const borrowWeiTotal = loops.reduce((a, w) => a + w, 0n);
+  const totalPullWei = eulerSameAssetTotalCollateralPullWei({
+    initialCollateralWei: collateralWei,
+    loopBorrowWeis: args.redepositBorrowedToCollateral ? loops : []
+  });
+  const approveTargetWei = eulerSameAssetApproveAmountWithBuffer({ totalPullWei });
+  const steps = [];
+  if (args.isNativeCollateralIn) {
+    const dataDeposit = viem.encodeFunctionData({ abi: wethDepositAbi2, functionName: "deposit", args: [] });
+    steps.push({ kind: "weth_deposit", to: weth, data: dataDeposit, value: collateralWei });
+    const wethAllowance = await publicClient.readContract({
+      address: weth,
+      abi: erc20AllowanceAbi2,
+      functionName: "allowance",
+      args: [executor, collateralVault]
+    });
+    if (wethAllowance < approveTargetWei) {
+      if (wethAllowance > 0n) {
+        const dataReset = viem.encodeFunctionData({
+          abi: erc20ApproveAbi2,
+          functionName: "approve",
+          args: [collateralVault, 0n]
+        });
+        steps.push({ kind: "approve", to: weth, data: dataReset, value: 0n });
+      }
+      const dataApprove = viem.encodeFunctionData({
+        abi: erc20ApproveAbi2,
+        functionName: "approve",
+        args: [collateralVault, approveTargetWei]
+      });
+      steps.push({ kind: "approve", to: weth, data: dataApprove, value: 0n });
+    }
+  } else {
+    const currentAllowance = await publicClient.readContract({
+      address: collateralAsset,
+      abi: erc20AllowanceAbi2,
+      functionName: "allowance",
+      args: [executor, collateralVault]
+    });
+    if (currentAllowance < approveTargetWei) {
+      if (currentAllowance > 0n) {
+        const dataReset = viem.encodeFunctionData({
+          abi: erc20ApproveAbi2,
+          functionName: "approve",
+          args: [collateralVault, 0n]
+        });
+        steps.push({ kind: "approve", to: collateralAsset, data: dataReset, value: 0n });
+      }
+      const dataApprove = viem.encodeFunctionData({
+        abi: erc20ApproveAbi2,
+        functionName: "approve",
+        args: [collateralVault, approveTargetWei]
+      });
+      steps.push({ kind: "approve", to: collateralAsset, data: dataApprove, value: 0n });
+    }
+  }
+  const depositData = viem.encodeFunctionData({
+    abi: erc4626DepositAbi2,
+    functionName: "deposit",
+    args: [collateralWei, receiver]
+  });
+  const enableCollData = viem.encodeFunctionData({
+    abi: viem.parseAbi(["function enableCollateral(address account, address vault)"]),
+    functionName: "enableCollateral",
+    args: [receiver, collateralVault]
+  });
+  const enableCtrlData = viem.encodeFunctionData({
+    abi: viem.parseAbi(["function enableController(address account, address vault)"]),
+    functionName: "enableController",
+    args: [receiver, borrowVault]
+  });
+  const batchItems = [
+    { targetContract: collateralVault, onBehalfOfAccount: receiver, value: 0n, data: depositData },
+    { targetContract: evc, onBehalfOfAccount: viem.zeroAddress, value: 0n, data: enableCollData },
+    { targetContract: evc, onBehalfOfAccount: viem.zeroAddress, value: 0n, data: enableCtrlData }
+  ];
+  for (const bw of loops) {
+    const borrowData = viem.encodeFunctionData({
+      abi: evaultBorrowAbi,
+      functionName: "borrow",
+      args: [bw, receiver]
+    });
+    batchItems.push({
+      targetContract: borrowVault,
+      onBehalfOfAccount: receiver,
+      value: 0n,
+      data: borrowData
+    });
+    if (args.redepositBorrowedToCollateral) {
+      const redepositData = viem.encodeFunctionData({
+        abi: erc4626DepositAbi2,
+        functionName: "deposit",
+        args: [bw, receiver]
+      });
+      batchItems.push({
+        targetContract: collateralVault,
+        onBehalfOfAccount: receiver,
+        value: 0n,
+        data: redepositData
+      });
+    }
+  }
+  const batchData = viem.encodeFunctionData({
+    abi: evcAbi,
+    functionName: "batch",
+    args: [batchItems]
+  });
+  steps.push({ kind: "evc_batch", to: evc, data: batchData, value: 0n });
+  const borrowRoundsExtraGas = EULER_BORROW_BATCH_FALLBACK_GAS_PER_ROUND * BigInt(Math.max(0, loops.length - 1 + (args.redepositBorrowedToCollateral ? loops.length : 0)));
+  const vaultLabel = (args.vaultMarketLabel ?? "").trim() || "Euler vault";
+  const evmSteps = steps.map((s) => ({
+    to: s.to,
+    data: s.data,
+    value: s.value,
+    fallbackGas: s.kind === "weth_deposit" ? EULER_WETH_DEPOSIT_FALLBACK2 : s.kind === "approve" ? EULER_ERC20_APPROVE_FALLBACK2 : EULER_BORROW_BATCH_FALLBACK_GAS + borrowRoundsExtraGas
+  }));
+  const n = steps.length;
+  const hasWrap = args.isNativeCollateralIn;
+  const purposeSuffix = (() => {
+    const tail = args.redepositBorrowedToCollateral ? `deposit collateral, enableCollateral, enableController, then ${loops.length}\xD7 borrow+redeposit on "${vaultLabel}" (same-asset target LTV loop).` : `deposit collateral, enableCollateral, enableController, borrow from "${vaultLabel}".`;
+    if (hasWrap) {
+      return `Euler v2: ${n}-tx batch \u2014 wrap native collateral (if needed), approve collateral eVault (buffered for all deposits), then EVC batch: ${tail}`;
+    }
+    return `Euler v2: ${n}-tx batch \u2014 approve collateral (if needed) with buffer for all deposits, then EVC batch: ${tail}`;
+  })();
+  const firstDataNo0x = evmSteps[0].data.startsWith("0x") ? evmSteps[0].data.slice(2) : evmSteps[0].data;
+  return buildEvmMultisignBatch({
+    context: {
+      chainCategory: "evm",
+      keyGen: args.keyGen,
+      purposeText: args.purposeText,
+      chainId: args.chainId,
+      rpcUrl: args.rpcUrl,
+      executorAddress: executor,
+      chainDetail: args.chainDetail,
+      useCustomGas: args.useCustomGas,
+      customGasChainDetails: args.customGasChainDetails
+    },
+    steps: evmSteps,
+    purposeSuffix,
+    firstMsgRawNo0x: firstDataNo0x,
+    destinationAddress: steps[0].to,
+    buildBatchMeta: ({ index }) => {
+      const s = steps[index];
+      if (s.kind === "weth_deposit") {
+        return {
+          signatureText: JSON.stringify({
+            kind: "EulerV2",
+            name: "WETH.deposit",
+            function: "deposit()",
+            valueWei: collateralWei.toString(),
+            vaultMarket: vaultLabel,
+            note: "Wrap native for Euler v2 isolated borrow collateral (same batch as borrow flow)."
+          }),
+          evm: { type: "euler_v2_weth_deposit", version: 1, chainId: String(args.chainId) },
+          eulerV2: { step: "weth_deposit", vaultMarket: vaultLabel, flow: "borrow" }
+        };
+      }
+      if (s.kind === "approve") {
+        return {
+          signatureText: JSON.stringify({
+            kind: "EulerV2",
+            name: "ERC20.approve",
+            to: "Euler collateral eVault",
+            function: "approve(address spender, uint256 amount)",
+            collateralVault,
+            amountHuman: args.collateralAmountHuman,
+            note: "Allowance for initial and follow-on collateral deposits (buffered).",
+            approveTotalWei: approveTargetWei.toString()
+          }),
+          evm: { type: "euler_v2_erc20_approve", version: 1, chainId: String(args.chainId) },
+          eulerV2: { vaultMarket: vaultLabel, flow: "borrow_collateral_approve" }
+        };
+      }
+      const borrowNote = args.redepositBorrowedToCollateral ? `Same-asset leverage: ${loops.length} borrow\u2192deposit round(s); total borrow wei ${borrowWeiTotal.toString()}.` : "Deposit collateral, enableCollateral, enableController, borrow in one EVC batch.";
+      return {
+        signatureText: JSON.stringify({
+          kind: "EulerV2",
+          name: "EVC.batch",
+          function: "batch(BatchItem[])",
+          evc,
+          borrowVault,
+          collateralVault,
+          collateralAmountHuman: args.collateralAmountHuman,
+          borrowAmountHuman: args.borrowAmountHuman,
+          vaultMarket: vaultLabel,
+          loopBorrowRounds: loops.length,
+          redepositBorrowedToCollateral: args.redepositBorrowedToCollateral,
+          borrowWeiTotal: borrowWeiTotal.toString(),
+          note: borrowNote
+        }),
+        evm: { type: "euler_v2_evc_borrow_batch", version: 1, chainId: String(args.chainId) },
+        eulerV2: {
+          flow: "borrow_batch",
+          vaultMarket: vaultLabel,
+          borrowVault,
+          collateralVault,
+          collateralAmountHuman: args.collateralAmountHuman,
+          borrowAmountHuman: args.borrowAmountHuman,
+          loopBorrowRounds: loops.length,
+          redepositBorrowedToCollateral: args.redepositBorrowedToCollateral,
+          borrowWeiTotal: borrowWeiTotal.toString()
+        }
+      };
+    }
+  });
+}
+var EULER_REPAY_BATCH_FALLBACK = 1200000n;
+var EULER_ERC20_APPROVE_FALLBACK3 = 100000n;
+var erc20AllowanceAbi3 = viem.parseAbi([
+  "function allowance(address owner, address spender) view returns (uint256)",
+  "function decimals() view returns (uint8)"
+]);
+var erc20ApproveAbi3 = viem.parseAbi(["function approve(address spender, uint256 amount) returns (bool)"]);
+var evaultRepayAbi = viem.parseAbi(["function repay(uint256 amount, address receiver) returns (uint256)"]);
+var evcAbi2 = viem.parseAbi([
+  "function batch((address targetContract, address onBehalfOfAccount, uint256 value, bytes data)[])"
+]);
+async function buildEvmMultisignBodyEulerV2BorrowRepayBatch(args) {
+  const evc = viem.getAddress(args.evc);
+  const borrowVault = viem.getAddress(args.borrowVault);
+  const borrowAsset = viem.getAddress(args.borrowUnderlying);
+  const subAccount = viem.getAddress(args.subAccount);
+  const executor = viem.getAddress(args.executorAddress);
+  const ch = viem.defineChain({
+    id: args.chainId,
+    name: "EulerRepay",
+    nativeCurrency: { decimals: 18, name: "Ether", symbol: "ETH" },
+    rpcUrls: { default: { http: [args.rpcUrl] } }
+  });
+  const publicClient = viem.createPublicClient({ chain: ch, transport: viem.http(args.rpcUrl) });
+  const bDecRaw = await publicClient.readContract({
+    address: borrowAsset,
+    abi: erc20AllowanceAbi3,
+    functionName: "decimals"
+  });
+  const borrowDecimals = Number(bDecRaw);
+  const debtAbi = viem.parseAbi(["function debtOf(address account) view returns (uint256)"]);
+  const owed = await publicClient.readContract({
+    address: borrowVault,
+    abi: debtAbi,
+    functionName: "debtOf",
+    args: [subAccount]
+  });
+  let repayWei;
+  if (args.repayAll) {
+    repayWei = viem.maxUint256;
+  } else {
+    repayWei = viem.parseUnits(args.amountHuman, borrowDecimals);
+    if (repayWei === 0n) throw new Error("Repay amount is zero after converting with token decimals.");
+    if (repayWei > owed) {
+      repayWei = owed;
+    }
+  }
+  const steps = [];
+  const allowanceTarget = repayWei === viem.maxUint256 ? owed : repayWei;
+  const currentAllowance = await publicClient.readContract({
+    address: borrowAsset,
+    abi: erc20AllowanceAbi3,
+    functionName: "allowance",
+    args: [executor, borrowVault]
+  });
+  if (currentAllowance < allowanceTarget) {
+    if (currentAllowance > 0n) {
+      const dataReset = viem.encodeFunctionData({
+        abi: erc20ApproveAbi3,
+        functionName: "approve",
+        args: [borrowVault, 0n]
+      });
+      steps.push({ kind: "approve", to: borrowAsset, data: dataReset, value: 0n });
+    }
+    const approveAmt = repayWei === viem.maxUint256 ? viem.maxUint256 : repayWei;
+    const dataApprove = viem.encodeFunctionData({
+      abi: erc20ApproveAbi3,
+      functionName: "approve",
+      args: [borrowVault, approveAmt]
+    });
+    steps.push({ kind: "approve", to: borrowAsset, data: dataApprove, value: 0n });
+  }
+  const repayData = viem.encodeFunctionData({
+    abi: evaultRepayAbi,
+    functionName: "repay",
+    args: [repayWei, subAccount]
+  });
+  const batchItems = [
+    { targetContract: borrowVault, onBehalfOfAccount: subAccount, value: 0n, data: repayData }
+  ];
+  const batchData = viem.encodeFunctionData({
+    abi: evcAbi2,
+    functionName: "batch",
+    args: [batchItems]
+  });
+  steps.push({ kind: "evc_batch", to: evc, data: batchData, value: 0n });
+  const vaultLabel = (args.vaultMarketLabel ?? "").trim() || "Euler vault";
+  const evmSteps = steps.map((s) => ({
+    to: s.to,
+    data: s.data,
+    value: s.value,
+    fallbackGas: s.kind === "approve" ? EULER_ERC20_APPROVE_FALLBACK3 : EULER_REPAY_BATCH_FALLBACK
+  }));
+  const n = steps.length;
+  const purposeSuffix = `Euler v2: ${n}-tx batch \u2014 repay borrow on "${vaultLabel}" (approve if needed, then EVC repay).`;
+  const firstDataNo0x = evmSteps[0].data.startsWith("0x") ? evmSteps[0].data.slice(2) : evmSteps[0].data;
+  return buildEvmMultisignBatch({
+    context: {
+      chainCategory: "evm",
+      keyGen: args.keyGen,
+      purposeText: args.purposeText,
+      chainId: args.chainId,
+      rpcUrl: args.rpcUrl,
+      executorAddress: executor,
+      chainDetail: args.chainDetail,
+      useCustomGas: args.useCustomGas,
+      customGasChainDetails: args.customGasChainDetails
+    },
+    steps: evmSteps,
+    purposeSuffix,
+    firstMsgRawNo0x: firstDataNo0x,
+    destinationAddress: steps[0].to,
+    buildBatchMeta: ({ index }) => {
+      const s = steps[index];
+      if (s.kind === "approve") {
+        return {
+          signatureText: JSON.stringify({
+            kind: "EulerV2",
+            name: "ERC20.approve",
+            function: "approve(address spender, uint256 amount)",
+            spender: borrowVault,
+            borrowUnderlying: borrowAsset,
+            note: "Allow Euler liability vault to pull assets for repay."
+          }),
+          evm: { type: "euler_v2_erc20_approve", version: 1, chainId: String(args.chainId) },
+          eulerV2: { vaultMarket: vaultLabel, flow: "borrow_repay_approve" }
+        };
+      }
+      return {
+        signatureText: JSON.stringify({
+          kind: "EulerV2",
+          name: "EVC.batch",
+          function: "batch(BatchItem[]) \u2014 repay",
+          evc,
+          borrowVault,
+          subAccount,
+          amountHuman: args.repayAll ? "max" : args.amountHuman,
+          vaultMarket: vaultLabel,
+          note: "Repay borrow on Euler v2 liability vault via EVC."
+        }),
+        evm: { type: "euler_v2_borrow_repay_batch", version: 1, chainId: String(args.chainId) },
+        eulerV2: {
+          flow: "borrow_repay",
+          vaultMarket: vaultLabel,
+          borrowVault,
+          subAccount,
+          repayAll: args.repayAll,
+          amountHuman: args.amountHuman
+        }
+      };
+    }
+  });
+}
+var EULER_COLLATERAL_DEPOSIT_BATCH_FALLBACK = 1600000n;
+var EULER_ERC20_APPROVE_FALLBACK4 = 100000n;
+var erc20AllowanceAbi4 = viem.parseAbi([
+  "function allowance(address owner, address spender) view returns (uint256)"
+]);
+var erc20ApproveAbi4 = viem.parseAbi(["function approve(address spender, uint256 amount) returns (bool)"]);
+var erc4626DepositAbi3 = viem.parseAbi([
+  "function deposit(uint256 assets, address receiver) returns (uint256 shares)"
+]);
+var evcAbi3 = viem.parseAbi([
+  "function batch((address targetContract, address onBehalfOfAccount, uint256 value, bytes data)[])"
+]);
+async function buildEvmMultisignBodyEulerV2BorrowCollateralDepositBatch(args) {
+  const evc = viem.getAddress(args.evc);
+  const collateralVault = viem.getAddress(args.collateralVault);
+  const collateralAsset = viem.getAddress(args.collateralUnderlying);
+  const subAccount = viem.getAddress(args.subAccount);
+  const executor = viem.getAddress(args.executorAddress);
+  const ch = viem.defineChain({
+    id: args.chainId,
+    name: "EulerColDeposit",
+    nativeCurrency: { decimals: 18, name: "Ether", symbol: "ETH" },
+    rpcUrls: { default: { http: [args.rpcUrl] } }
+  });
+  const publicClient = viem.createPublicClient({ chain: ch, transport: viem.http(args.rpcUrl) });
+  const dec = await fetchEulerVaultAssetDecimals({
+    rpcUrl: args.rpcUrl,
+    chainId: args.chainId,
+    evault: collateralVault
+  });
+  const amountWei = viem.parseUnits(args.amountHuman, dec);
+  if (amountWei === 0n) throw new Error("Deposit amount is zero after converting with token decimals.");
+  const steps = [];
+  const currentAllowance = await publicClient.readContract({
+    address: collateralAsset,
+    abi: erc20AllowanceAbi4,
+    functionName: "allowance",
+    args: [executor, collateralVault]
+  });
+  if (currentAllowance < amountWei) {
+    if (currentAllowance > 0n) {
+      const dataReset = viem.encodeFunctionData({
+        abi: erc20ApproveAbi4,
+        functionName: "approve",
+        args: [collateralVault, 0n]
+      });
+      steps.push({ kind: "approve", to: collateralAsset, data: dataReset, value: 0n });
+    }
+    const dataApprove = viem.encodeFunctionData({
+      abi: erc20ApproveAbi4,
+      functionName: "approve",
+      args: [collateralVault, amountWei]
+    });
+    steps.push({ kind: "approve", to: collateralAsset, data: dataApprove, value: 0n });
+  }
+  const depositData = viem.encodeFunctionData({
+    abi: erc4626DepositAbi3,
+    functionName: "deposit",
+    args: [amountWei, subAccount]
+  });
+  const batchItems = [
+    {
+      targetContract: collateralVault,
+      onBehalfOfAccount: subAccount,
+      value: 0n,
+      data: depositData
+    }
+  ];
+  const batchData = viem.encodeFunctionData({
+    abi: evcAbi3,
+    functionName: "batch",
+    args: [batchItems]
+  });
+  steps.push({ kind: "evc_batch", to: evc, data: batchData, value: 0n });
+  const vaultLabel = (args.vaultMarketLabel ?? "").trim() || "Euler vault";
+  const evmSteps = steps.map((s) => ({
+    to: s.to,
+    data: s.data,
+    value: s.value,
+    fallbackGas: s.kind === "approve" ? EULER_ERC20_APPROVE_FALLBACK4 : EULER_COLLATERAL_DEPOSIT_BATCH_FALLBACK
+  }));
+  const n = steps.length;
+  const purposeSuffix = `Euler v2: ${n}-tx batch \u2014 deposit ${args.amountHuman} collateral into "${vaultLabel}" (approve if needed, then EVC deposit).`;
+  const firstDataNo0x = evmSteps[0].data.startsWith("0x") ? evmSteps[0].data.slice(2) : evmSteps[0].data;
+  return buildEvmMultisignBatch({
+    context: {
+      chainCategory: "evm",
+      keyGen: args.keyGen,
+      purposeText: args.purposeText,
+      chainId: args.chainId,
+      rpcUrl: args.rpcUrl,
+      executorAddress: executor,
+      chainDetail: args.chainDetail,
+      useCustomGas: args.useCustomGas,
+      customGasChainDetails: args.customGasChainDetails
+    },
+    steps: evmSteps,
+    purposeSuffix,
+    firstMsgRawNo0x: firstDataNo0x,
+    destinationAddress: steps[0].to,
+    buildBatchMeta: ({ index }) => {
+      const s = steps[index];
+      if (s.kind === "approve") {
+        return {
+          signatureText: JSON.stringify({
+            kind: "EulerV2",
+            name: "ERC20.approve",
+            function: "approve(address spender, uint256 amount)",
+            spender: collateralVault,
+            collateralUnderlying: collateralAsset,
+            note: "Allow Euler collateral eVault to pull assets for collateral deposit."
+          }),
+          evm: { type: "euler_v2_erc20_approve", version: 1, chainId: String(args.chainId) },
+          eulerV2: { vaultMarket: vaultLabel, flow: "borrow_collateral_deposit_approve" }
+        };
+      }
+      return {
+        signatureText: JSON.stringify({
+          kind: "EulerV2",
+          name: "EVC.batch",
+          function: "batch(BatchItem[]) \u2014 collateral deposit",
+          evc,
+          collateralVault,
+          subAccount,
+          amountHuman: args.amountHuman,
+          vaultMarket: vaultLabel,
+          note: "Deposit collateral into Euler v2 collateral eVault via EVC (reduces LTV)."
+        }),
+        evm: { type: "euler_v2_borrow_collateral_deposit_batch", version: 1, chainId: String(args.chainId) },
+        eulerV2: {
+          flow: "borrow_collateral_deposit",
+          vaultMarket: vaultLabel,
+          collateralVault,
+          subAccount,
+          amountHuman: args.amountHuman
+        }
+      };
+    }
+  });
+}
+var EULER_COLLATERAL_WITHDRAW_BATCH_FALLBACK = 1400000n;
+var erc4626WithdrawAbi3 = viem.parseAbi([
+  "function withdraw(uint256 assets, address receiver, address owner) returns (uint256 shares)"
+]);
+var evcAbi4 = viem.parseAbi([
+  "function batch((address targetContract, address onBehalfOfAccount, uint256 value, bytes data)[])"
+]);
+async function buildEvmMultisignBodyEulerV2BorrowCollateralWithdrawBatch(args) {
+  const evc = viem.getAddress(args.evc);
+  const collateralVault = viem.getAddress(args.collateralVault);
+  const subAccount = viem.getAddress(args.subAccount);
+  const receiver = viem.getAddress(args.receiver);
+  const executor = viem.getAddress(args.executorAddress);
+  const dec = await fetchEulerVaultAssetDecimals({ rpcUrl: args.rpcUrl, chainId: args.chainId, evault: collateralVault });
+  const amountWei = viem.parseUnits(args.amountHuman, dec);
+  if (amountWei === 0n) throw new Error("Withdraw amount is zero after converting with token decimals.");
+  const maxW = await fetchEulerBorrowCollateralMaxWithdrawAssetsWei({
+    rpcUrl: args.rpcUrl,
+    chainId: args.chainId,
+    evc,
+    collateralVault,
+    subAccount,
+    caller: executor
+  });
+  if (amountWei > maxW) {
+    throw new Error(
+      "Withdraw amount exceeds simulated max for this collateral vault (LTV cap, vault cash, or health check). Try a smaller amount."
+    );
+  }
+  const withdrawData = viem.encodeFunctionData({
+    abi: erc4626WithdrawAbi3,
+    functionName: "withdraw",
+    args: [amountWei, receiver, subAccount]
+  });
+  const batchItems = [
+    {
+      targetContract: collateralVault,
+      onBehalfOfAccount: subAccount,
+      value: 0n,
+      data: withdrawData
+    }
+  ];
+  const batchData = viem.encodeFunctionData({
+    abi: evcAbi4,
+    functionName: "batch",
+    args: [batchItems]
+  });
+  const steps = [{ kind: "evc_batch", to: evc, data: batchData, value: 0n }];
+  const vaultLabel = (args.vaultMarketLabel ?? "").trim() || "Euler vault";
+  const purposeSuffix = `Euler v2: 1-tx \u2014 withdraw ${args.amountHuman} collateral from "${vaultLabel}" via EVC (sub-account).`;
+  const firstDataNo0x = batchData.startsWith("0x") ? batchData.slice(2) : batchData;
+  const evmSteps = [
+    { to: evc, data: batchData, value: 0n, fallbackGas: EULER_COLLATERAL_WITHDRAW_BATCH_FALLBACK }
+  ];
+  return buildEvmMultisignBatch({
+    context: {
+      chainCategory: "evm",
+      keyGen: args.keyGen,
+      purposeText: args.purposeText,
+      chainId: args.chainId,
+      rpcUrl: args.rpcUrl,
+      executorAddress: executor,
+      chainDetail: args.chainDetail,
+      useCustomGas: args.useCustomGas,
+      customGasChainDetails: args.customGasChainDetails
+    },
+    steps: evmSteps,
+    purposeSuffix,
+    firstMsgRawNo0x: firstDataNo0x,
+    destinationAddress: steps[0].to,
+    buildBatchMeta: () => ({
+      signatureText: JSON.stringify({
+        kind: "EulerV2",
+        name: "EVC.batch",
+        function: "batch \u2014 collateral withdraw",
+        evc,
+        collateralVault,
+        subAccount,
+        receiver,
+        amountHuman: args.amountHuman,
+        vaultMarket: vaultLabel,
+        note: "Withdraw collateral from Euler v2 eVault via EVC (max from RPC simulate + LTV / vault cash)."
+      }),
+      evm: { type: "euler_v2_borrow_collateral_withdraw_batch", version: 1, chainId: String(args.chainId) },
+      eulerV2: {
+        flow: "borrow_collateral_withdraw",
+        vaultMarket: vaultLabel,
+        collateralVault,
+        subAccount,
+        receiver,
+        amountHuman: args.amountHuman
+      }
+    })
+  });
+}
+
+// src/protocols/evm/euler-v2/index.ts
+var EULER_V2_PROTOCOL_ID = "euler-v2";
+var eulerV2ProtocolModule = {
+  id: EULER_V2_PROTOCOL_ID,
+  chainCategory: "evm",
+  isChainSupported(ctx) {
+    return ctx.chainCategory === "evm";
+  },
+  isTokenSupported(token) {
+    return token.category === "evm" && (token.kind === "native" || token.kind === "erc20");
+  },
+  actions: [
+    { id: "euler-v2.isolated-lend", protocolId: EULER_V2_PROTOCOL_ID, chainCategory: "evm", description: "Deposit into Euler vault", commonParams: ["keyGen", "purposeText", "useCustomGas"], params: {} },
+    { id: "euler-v2.isolated-borrow", protocolId: EULER_V2_PROTOCOL_ID, chainCategory: "evm", description: "Borrow from Euler vault", commonParams: ["keyGen", "purposeText", "useCustomGas"], params: {} },
+    { id: "euler-v2.vault-withdraw", protocolId: EULER_V2_PROTOCOL_ID, chainCategory: "evm", description: "Withdraw from Euler vault", commonParams: ["keyGen", "purposeText", "useCustomGas"], params: {} },
+    { id: "euler-v2.borrow-repay", protocolId: EULER_V2_PROTOCOL_ID, chainCategory: "evm", description: "Repay Euler borrow", commonParams: ["keyGen", "purposeText", "useCustomGas"], params: {} },
+    { id: "euler-v2.collateral-deposit", protocolId: EULER_V2_PROTOCOL_ID, chainCategory: "evm", description: "Deposit borrow collateral", commonParams: ["keyGen", "purposeText", "useCustomGas"], params: {} },
+    { id: "euler-v2.collateral-withdraw", protocolId: EULER_V2_PROTOCOL_ID, chainCategory: "evm", description: "Withdraw borrow collateral", commonParams: ["keyGen", "purposeText", "useCustomGas"], params: {} }
+  ]
+};
+registerProtocolModule(eulerV2ProtocolModule);
+
+exports.EULER_SAME_ASSET_BORROW_APPROVAL_BUFFER_BPS = EULER_SAME_ASSET_BORROW_APPROVAL_BUFFER_BPS;
+exports.EULER_SAME_ASSET_BORROW_MAX_ROUNDS = EULER_SAME_ASSET_BORROW_MAX_ROUNDS;
+exports.EULER_SAME_ASSET_BORROW_PROTOCOL_HEADROOM_BPS = EULER_SAME_ASSET_BORROW_PROTOCOL_HEADROOM_BPS;
+exports.EULER_SAME_ASSET_BORROW_RATIO_STOP_EPS_BPS = EULER_SAME_ASSET_BORROW_RATIO_STOP_EPS_BPS;
+exports.EULER_V2_ISOLATED_VAULT_DEPOSIT_FALLBACK_GAS = EULER_V2_ISOLATED_VAULT_DEPOSIT_FALLBACK_GAS;
+exports.EULER_V2_PROTOCOL_ID = EULER_V2_PROTOCOL_ID;
+exports.EULER_V2_VAULT_WITHDRAW_FALLBACK_GAS = EULER_V2_VAULT_WITHDRAW_FALLBACK_GAS;
+exports.buildEvmMultisignBodyEulerV2BorrowCollateralDepositBatch = buildEvmMultisignBodyEulerV2BorrowCollateralDepositBatch;
+exports.buildEvmMultisignBodyEulerV2BorrowCollateralWithdrawBatch = buildEvmMultisignBodyEulerV2BorrowCollateralWithdrawBatch;
+exports.buildEvmMultisignBodyEulerV2BorrowRepayBatch = buildEvmMultisignBodyEulerV2BorrowRepayBatch;
+exports.buildEvmMultisignBodyEulerV2IsolatedBorrowBatch = buildEvmMultisignBodyEulerV2IsolatedBorrowBatch;
+exports.buildEvmMultisignBodyEulerV2IsolatedLendDepositBatch = buildEvmMultisignBodyEulerV2IsolatedLendDepositBatch;
+exports.buildEvmMultisignBodyEulerV2VaultWithdraw = buildEvmMultisignBodyEulerV2VaultWithdraw;
+exports.clampEulerUnderlyingDecimalsForEulerUi = clampEulerUnderlyingDecimalsForEulerUi;
+exports.eulerBorrowAndCollateralSameAsset = eulerBorrowAndCollateralSameAsset;
+exports.eulerSameAssetApproveAmountWithBuffer = eulerSameAssetApproveAmountWithBuffer;
+exports.eulerSameAssetTotalCollateralPullWei = eulerSameAssetTotalCollateralPullWei;
+exports.eulerV2ProtocolModule = eulerV2ProtocolModule;
+exports.fetchEulerBorrowCollateralMaxWithdrawAssetsWei = fetchEulerBorrowCollateralMaxWithdrawAssetsWei;
+exports.fetchEulerLendEarnVaultEffectiveMaxWithdrawWei = fetchEulerLendEarnVaultEffectiveMaxWithdrawWei;
+exports.fetchEulerVaultAssetDecimals = fetchEulerVaultAssetDecimals;
+exports.fetchEulerVaultMaxWithdrawWei = fetchEulerVaultMaxWithdrawWei;
+exports.fetchEulerVaultUnderlyingMeta = fetchEulerVaultUnderlyingMeta;
+exports.planSameAssetLeveragedBorrows = planSameAssetLeveragedBorrows;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map