@continuumdao/ctm-mpc-defi 0.1.4 → 0.2.0

package/dist/protocols/evm/ethena/index.cjs

@@ -0,0 +1,965 @@
+'use strict';
+
+var viem = require('viem');
+
+// 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);
+  }
+}
+
+// src/chains/evm/chainIdParse.ts
+function parseEvmChainIdToNumber(chainId) {
+  if (chainId == null) return Number.NaN;
+  if (typeof chainId === "bigint") {
+    const n = Number(chainId);
+    return Number.isSafeInteger(n) && n >= 0 ? n : Number.NaN;
+  }
+  if (typeof chainId === "number") {
+    return Number.isInteger(chainId) && chainId >= 0 ? chainId : Number.NaN;
+  }
+  const t = String(chainId).trim();
+  if (!t) return Number.NaN;
+  const low = t.toLowerCase();
+  if (low.startsWith("eip155:")) {
+    const rest = t.slice("eip155:".length).trim();
+    const n = Number.parseInt(rest, 10);
+    return Number.isNaN(n) || n < 0 ? Number.NaN : n;
+  }
+  if (low.startsWith("0x")) {
+    return Number.parseInt(t, 16);
+  }
+  return Number.parseInt(t, 10);
+}
+
+// src/protocols/evm/ethena/constants.ts
+var ETHENA_LABS_GITHUB = "https://github.com/ethena-labs";
+var ETHENA_KEY_ADDRESSES_DOC = "https://docs.ethena.fi/solution-design/key-addresses";
+var USDE_ETHEREUM_MAINNET = "0x4c9edd5852cd905f086c759e8383e09bff1e68b3";
+var SUSDE_ETHEREUM_MAINNET = "0x9d39a5de30e57443bff2a8307a4256c8797a3497";
+var USDE_MOST_L2S = "0x5d3a1Ff2b6BAb83b63cd9AD0787074081a52ef34";
+var USDE_ZKSYNC_ERA = "0x39Fe7a0DACcE31Bd90418e3e659fb0b5f0B3Db0d";
+var L2_SAME_ADDRESS_CHAIN_IDS = /* @__PURE__ */ new Set([
+  42161,
+  // Arbitrum One
+  10,
+  // Optimism
+  8453,
+  // Base
+  56,
+  // BNB Chain
+  59144,
+  // Linea
+  5e3,
+  // Mantle
+  81457,
+  // Blast
+  169,
+  // Manta Pacific
+  534352,
+  // Scroll
+  252,
+  // Fraxtal
+  34443,
+  // Mode
+  196,
+  // X Layer
+  1088,
+  // Metis
+  80084,
+  // Berachain
+  2222,
+  // Kava
+  2818,
+  // Morph
+  1923,
+  // Swell
+  48900
+  // Zircuit
+]);
+var FALLBACK_NAME_BY_ID = {
+  1: "Ethereum",
+  42161: "Arbitrum One",
+  10: "Optimism",
+  8453: "Base",
+  56: "BNB Chain",
+  59144: "Linea",
+  5e3: "Mantle",
+  81457: "Blast",
+  169: "Manta Pacific",
+  534352: "Scroll",
+  252: "Fraxtal",
+  34443: "Mode",
+  196: "X Layer",
+  1088: "Metis",
+  80084: "Berachain",
+  2222: "Kava",
+  2818: "Morph",
+  1923: "Swell",
+  48900: "Zircuit",
+  324: "ZKSync Era"
+};
+function usdeTokenAddressOnEvmChain(chainId) {
+  if (chainId === 1) return USDE_ETHEREUM_MAINNET;
+  if (chainId === 324) return USDE_ZKSYNC_ERA;
+  if (L2_SAME_ADDRESS_CHAIN_IDS.has(chainId)) return USDE_MOST_L2S;
+  return null;
+}
+function isEthenaUsdeOnAssetsChain(assetsChainId, contractAddress) {
+  const n = parseEvmChainIdToNumber(assetsChainId);
+  if (Number.isNaN(n) || n < 0) return false;
+  const expected = usdeTokenAddressOnEvmChain(n);
+  if (!expected) return false;
+  try {
+    return viem.getAddress(contractAddress) === viem.getAddress(expected);
+  } catch {
+    return false;
+  }
+}
+function listEthenaUsdeEvmNetworkRows() {
+  const rows = [
+    { chainId: 1, label: FALLBACK_NAME_BY_ID[1], usde: USDE_ETHEREUM_MAINNET }
+  ];
+  const l2 = [...L2_SAME_ADDRESS_CHAIN_IDS].sort((a, b) => a - b);
+  for (const id of l2) {
+    rows.push({
+      chainId: id,
+      label: FALLBACK_NAME_BY_ID[id] ?? `Chain ${id}`,
+      usde: USDE_MOST_L2S
+    });
+  }
+  rows.push({ chainId: 324, label: FALLBACK_NAME_BY_ID[324], usde: USDE_ZKSYNC_ERA });
+  return rows.sort((a, b) => {
+    if (a.chainId === 1) return -1;
+    if (b.chainId === 1) return 1;
+    return a.chainId - b.chainId;
+  });
+}
+function isEvmChainInEthenaUsdeList(chainId) {
+  return usdeTokenAddressOnEvmChain(chainId) != null;
+}
+
+// src/core/keygen.ts
+function firstClientIdFromKeyGen(data) {
+  const map = data?.ClientKeys;
+  if (!map || typeof map !== "object") return null;
+  for (const v of Object.values(map)) {
+    if (typeof v === "string" && v.trim()) return v.trim();
+  }
+  return null;
+}
+
+// src/chains/evm/txParams.ts
+function gasLimitFromEstimateAndChainConfig(estimatedGas, chainGasLimit) {
+  if (chainGasLimit == null || !Number.isFinite(chainGasLimit) || chainGasLimit <= 0) {
+    return estimatedGas;
+  }
+  const cfg = BigInt(Math.floor(chainGasLimit));
+  return cfg > estimatedGas ? cfg : estimatedGas;
+}
+async function fetchChainFeeParams(rpcUrl, chainId) {
+  const url = rpcUrl.trim();
+  if (!url) return { isEip1559: false };
+  const chainIdNum = chainId;
+  if (Number.isNaN(chainIdNum)) return { isEip1559: false };
+  const chain = viem.defineChain({
+    id: chainIdNum,
+    name: "Discovery",
+    nativeCurrency: { decimals: 18, name: "Ether", symbol: "ETH" },
+    rpcUrls: { default: { http: [url] } }
+  });
+  const publicClient = viem.createPublicClient({
+    chain,
+    transport: viem.http(url)
+  });
+  const getGasPriceGwei = async () => {
+    const gasPriceWei = await publicClient.getGasPrice();
+    return parseFloat(viem.formatUnits(gasPriceWei, 9));
+  };
+  try {
+    const block = await publicClient.getBlock({ blockTag: "latest" });
+    const baseFeePerGas = block?.baseFeePerGas;
+    if (baseFeePerGas == null || baseFeePerGas === void 0) {
+      const gasPriceGwei2 = await getGasPriceGwei();
+      return { isEip1559: false, gasPriceGwei: gasPriceGwei2 };
+    }
+    const baseFeeGwei = parseFloat(viem.formatUnits(baseFeePerGas, 9));
+    let priorityFeeGwei;
+    try {
+      const priorityWei = await publicClient.estimateMaxPriorityFeePerGas();
+      priorityFeeGwei = parseFloat(viem.formatUnits(priorityWei, 9));
+    } catch {
+    }
+    const gasPriceGwei = await getGasPriceGwei();
+    return {
+      isEip1559: true,
+      baseFeeGwei,
+      priorityFeeGwei,
+      gasPriceGwei
+    };
+  } catch {
+    try {
+      const gasPriceWei = await publicClient.getGasPrice();
+      const gasPriceGwei = parseFloat(viem.formatUnits(gasPriceWei, 9));
+      return { isEip1559: false, gasPriceGwei };
+    } catch {
+      return { isEip1559: false };
+    }
+  }
+}
+function finalizeEip1559Fees(maxFeePerGas, maxPriorityFeePerGas, floor, baseWei) {
+  let maxP = maxPriorityFeePerGas;
+  let maxF = maxFeePerGas;
+  if (baseWei > 0n && maxF < baseWei + maxP) {
+    maxF = baseWei + maxP + viem.parseGwei("0.001");
+  }
+  if (maxF < maxP) {
+    maxF = baseWei > 0n ? baseWei + maxP + viem.parseGwei("0.001") : maxP * 2n;
+  }
+  return { maxFeePerGas: maxF, maxPriorityFeePerGas: maxP };
+}
+function alignEip1559FeesWithLatestBase(maxFeePerGas, maxPriorityFeePerGas, latestBlockBaseFeeWei) {
+  return finalizeEip1559Fees(maxFeePerGas, maxPriorityFeePerGas, null, latestBlockBaseFeeWei);
+}
+
+// src/protocols/evm/ethena/multisign.ts
+var AAVE_ERC20_APPROVE_FALLBACK = 100000n;
+var ETHENA_SUSDE_DEPOSIT_GET_SIG_GAS_FALLBACK = 1200000n;
+var ETHENA_SUSDE_DEPOSIT_FALLBACK = ETHENA_SUSDE_DEPOSIT_GET_SIG_GAS_FALLBACK;
+var ETHENA_SUSDE_REDEEM_FALLBACK = 1200000n;
+function gweiToDecimalString(n) {
+  if (!Number.isFinite(n)) return "0";
+  if (n === 0) return "0";
+  const s = String(n);
+  if (s.indexOf("e") !== -1 || s.indexOf("E") !== -1) return n.toFixed(9).replace(/\.?0+$/, "") || "0";
+  return s;
+}
+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 susdeErc4626Abi = viem.parseAbi([
+  "function deposit(uint256 assets, address receiver) returns (uint256 shares)",
+  "function previewDeposit(uint256 assets) view returns (uint256 shares)",
+  "function previewRedeem(uint256 shares) view returns (uint256 assets)",
+  "function redeem(uint256 shares, address receiver, address owner) returns (uint256 assets)",
+  "function decimals() view returns (uint8)"
+]);
+var stakedUsdeV2UnstakeAbi = viem.parseAbi([
+  "function cooldownShares(uint256 shares, address owner) returns (uint256 assets)",
+  "function unstake(address receiver)"
+]);
+async function readEthenaStakePreviewShares(args) {
+  const { rpcUrl, usdeAmountWei } = args;
+  if (usdeAmountWei <= 0n) return 0n;
+  const ch = viem.defineChain({
+    id: 1,
+    name: "Ethereum",
+    nativeCurrency: { decimals: 18, name: "Ether", symbol: "ETH" },
+    rpcUrls: { default: { http: [rpcUrl.trim()] } }
+  });
+  const client = viem.createPublicClient({ chain: ch, transport: viem.http(rpcUrl.trim()) });
+  const vault = viem.getAddress(SUSDE_ETHEREUM_MAINNET);
+  return client.readContract({
+    address: vault,
+    abi: susdeErc4626Abi,
+    functionName: "previewDeposit",
+    args: [usdeAmountWei]
+  });
+}
+async function readEthenaUnstakePreviewUsde(args) {
+  const { rpcUrl, susdeSharesWei } = args;
+  if (susdeSharesWei <= 0n) return 0n;
+  const ch = viem.defineChain({
+    id: 1,
+    name: "Ethereum",
+    nativeCurrency: { decimals: 18, name: "Ether", symbol: "ETH" },
+    rpcUrls: { default: { http: [rpcUrl.trim()] } }
+  });
+  const client = viem.createPublicClient({ chain: ch, transport: viem.http(rpcUrl.trim()) });
+  const vault = viem.getAddress(SUSDE_ETHEREUM_MAINNET);
+  return client.readContract({
+    address: vault,
+    abi: susdeErc4626Abi,
+    functionName: "previewRedeem",
+    args: [susdeSharesWei]
+  });
+}
+async function buildEvmMultisignBodyEthenaUsdeStakeToSusde(args) {
+  if (args.chainId !== 1) {
+    throw new Error("Ethena USDe \u2192 sUSDe stake is only supported on Ethereum mainnet (chain id 1).");
+  }
+  const ph = (args.keyGen.pubkeyhex ?? "").trim();
+  if (!ph) throw new Error("keyGen pubKey (pubkeyhex) is required");
+  const keyList = args.keyGen.keylist ?? [];
+  const clientId = firstClientIdFromKeyGen(args.keyGen);
+  const usde = viem.getAddress(args.usde);
+  const mainnetUsde = viem.getAddress(USDE_ETHEREUM_MAINNET);
+  if (usde.toLowerCase() !== mainnetUsde.toLowerCase()) {
+    throw new Error("Token in must be mainnet USDe for this flow.");
+  }
+  const susde = viem.getAddress(args.susdeVault ?? SUSDE_ETHEREUM_MAINNET);
+  const executor = viem.getAddress(args.executorAddress);
+  const receiver = viem.getAddress(args.receiver);
+  if (viem.getAddress(SUSDE_ETHEREUM_MAINNET).toLowerCase() !== susde.toLowerCase()) {
+    throw new Error("sUSDe vault address mismatch.");
+  }
+  const ch = viem.defineChain({
+    id: 1,
+    name: "Ethereum",
+    nativeCurrency: { decimals: 18, name: "Ether", symbol: "ETH" },
+    rpcUrls: { default: { http: [args.rpcUrl.trim()] } }
+  });
+  const publicClient = viem.createPublicClient({ chain: ch, transport: viem.http(args.rpcUrl.trim()) });
+  const dec = await publicClient.readContract({
+    address: usde,
+    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 = [];
+  const currentAllowance = await publicClient.readContract({
+    address: usde,
+    abi: erc20AllowanceAbi,
+    functionName: "allowance",
+    args: [executor, susde]
+  });
+  if (currentAllowance < amountWei) {
+    if (currentAllowance > 0n) {
+      const dataReset = viem.encodeFunctionData({
+        abi: erc20ApproveAbi,
+        functionName: "approve",
+        args: [susde, 0n]
+      });
+      steps.push({ kind: "approve", to: usde, data: dataReset, value: 0n });
+    }
+    const dataApprove = viem.encodeFunctionData({
+      abi: erc20ApproveAbi,
+      functionName: "approve",
+      args: [susde, amountWei]
+    });
+    steps.push({ kind: "approve", to: usde, data: dataApprove, value: 0n });
+  }
+  const depositData = viem.encodeFunctionData({
+    abi: susdeErc4626Abi,
+    functionName: "deposit",
+    args: [amountWei, receiver]
+  });
+  steps.push({ kind: "deposit", to: susde, data: depositData, value: 0n });
+  const feeParams = await fetchChainFeeParams(args.rpcUrl, 1);
+  const legacy = Boolean(args.chainDetail?.legacy) || !feeParams.isEip1559;
+  const latestBaseFeeWei = !legacy ? (await publicClient.getBlock({ blockTag: "latest" })).baseFeePerGas ?? 0n : 0n;
+  const useCustomGas = args.useCustomGas;
+  const gasLimitConfig = useCustomGas && args.chainDetail?.gasLimit != null ? Number(args.chainDetail.gasLimit) : void 0;
+  const gasFeeMultiplier = useCustomGas && args.chainDetail?.gasMultiplier != null ? Number(args.chainDetail.gasMultiplier) : void 0;
+  const baseNonce = await publicClient.getTransactionCount({ address: executor, blockTag: "pending" });
+  const messageHashes = [];
+  const messageRawBatch = [];
+  const proposalTxParamsBatch = [];
+  const batchMeta = [];
+  let firstTxFeePayload = {};
+  let firstDataNo0x = "";
+  for (let i = 0; i < steps.length; i++) {
+    const s = steps[i];
+    const currentNonce = baseNonce + i;
+    let estimatedGas;
+    const skipDepositEstimateBecausePriorApproves = s.kind === "deposit" && i > 0;
+    if (skipDepositEstimateBecausePriorApproves) {
+      estimatedGas = ETHENA_SUSDE_DEPOSIT_FALLBACK;
+    } else {
+      try {
+        estimatedGas = await publicClient.estimateGas({
+          to: s.to,
+          data: s.data,
+          value: s.value,
+          account: executor
+        });
+      } catch {
+        estimatedGas = s.kind === "approve" ? AAVE_ERC20_APPROVE_FALLBACK : ETHENA_SUSDE_DEPOSIT_FALLBACK;
+      }
+    }
+    const gasLimitI = useCustomGas ? gasLimitFromEstimateAndChainConfig(estimatedGas, gasLimitConfig) : estimatedGas;
+    if (legacy) {
+      let gasPriceWei = await publicClient.getGasPrice();
+      if (useCustomGas && gasFeeMultiplier != null && gasFeeMultiplier > 0) {
+        gasPriceWei = gasPriceWei * BigInt(100 + gasFeeMultiplier) / 100n;
+      }
+      if (useCustomGas && args.chainDetail?.gasPrice != null && args.chainDetail.gasPrice > 0) {
+        const configured = viem.parseGwei(gweiToDecimalString(Number(args.chainDetail.gasPrice)));
+        if (configured > gasPriceWei) gasPriceWei = configured;
+      }
+      const ser = viem.serializeTransaction({
+        type: "legacy",
+        to: s.to,
+        data: s.data,
+        value: s.value,
+        gas: gasLimitI,
+        gasPrice: gasPriceWei,
+        nonce: currentNonce,
+        chainId: 1
+      });
+      const h = viem.keccak256(ser);
+      messageHashes.push(h.startsWith("0x") ? h.slice(2) : h);
+      messageRawBatch.push(ser);
+      proposalTxParamsBatch.push({
+        nonce: currentNonce,
+        gasLimit: gasLimitI.toString(),
+        txType: "legacy",
+        gasPrice: gasPriceWei.toString()
+      });
+      if (i === 0) {
+        firstTxFeePayload = { txNonce: currentNonce, txGasLimit: gasLimitI.toString(), txGasPrice: gasPriceWei.toString() };
+        firstDataNo0x = s.data.startsWith("0x") ? s.data.slice(2) : s.data;
+      }
+    } else {
+      const fetchedBase = feeParams.baseFeeGwei ?? 0;
+      const fetchedPriority = feeParams.priorityFeeGwei ?? 0;
+      const configuredBase = useCustomGas && args.chainDetail?.baseFee != null ? Number(args.chainDetail.baseFee) : 0;
+      const configuredPriority = useCustomGas && args.chainDetail?.priorityFee != null ? Number(args.chainDetail.priorityFee) : 0;
+      const effectiveBaseFeeGwei = Math.max(fetchedBase, configuredBase);
+      const effectivePriorityFeeGwei = Math.max(fetchedPriority, configuredPriority);
+      const baseFeeMultiplierPct = useCustomGas && args.chainDetail?.baseFeeMultiplier != null ? Math.max(100, Number(args.chainDetail.baseFeeMultiplier)) : 100;
+      const baseComponentGwei = effectiveBaseFeeGwei * baseFeeMultiplierPct / 100;
+      const maxFeePerGasGwei = baseComponentGwei + effectivePriorityFeeGwei;
+      let maxPriorityFeePerGas = effectivePriorityFeeGwei > 0 ? viem.parseGwei(gweiToDecimalString(effectivePriorityFeeGwei)) : viem.parseGwei("1");
+      let maxFeePerGas = viem.parseGwei(gweiToDecimalString(maxFeePerGasGwei));
+      if (useCustomGas && gasFeeMultiplier != null && gasFeeMultiplier > 0) {
+        maxPriorityFeePerGas = maxPriorityFeePerGas * BigInt(100 + gasFeeMultiplier) / 100n;
+        maxFeePerGas = maxFeePerGas * BigInt(100 + gasFeeMultiplier) / 100n;
+      }
+      ({ maxFeePerGas, maxPriorityFeePerGas } = alignEip1559FeesWithLatestBase(
+        maxFeePerGas,
+        maxPriorityFeePerGas,
+        latestBaseFeeWei
+      ));
+      const ser = viem.serializeTransaction({
+        type: "eip1559",
+        to: s.to,
+        data: s.data,
+        value: s.value,
+        gas: gasLimitI,
+        maxFeePerGas,
+        maxPriorityFeePerGas,
+        nonce: currentNonce,
+        chainId: 1
+      });
+      const h = viem.keccak256(ser);
+      messageHashes.push(h.startsWith("0x") ? h.slice(2) : h);
+      messageRawBatch.push(ser);
+      proposalTxParamsBatch.push({
+        nonce: currentNonce,
+        gasLimit: gasLimitI.toString(),
+        txType: "eip1559",
+        maxFeePerGas: maxFeePerGas.toString(),
+        maxPriorityFeePerGas: maxPriorityFeePerGas.toString()
+      });
+      if (i === 0) {
+        firstTxFeePayload = {
+          txNonce: currentNonce,
+          txGasLimit: gasLimitI.toString(),
+          txMaxFeePerGas: maxFeePerGas.toString(),
+          txMaxPriorityFeePerGas: maxPriorityFeePerGas.toString()
+        };
+        firstDataNo0x = s.data.startsWith("0x") ? s.data.slice(2) : s.data;
+      }
+    }
+    if (s.kind === "approve") {
+      batchMeta.push({
+        destinationAddress: usde,
+        signatureText: JSON.stringify({
+          kind: "Ethena",
+          name: "ERC20.approve",
+          to: "sUSDe vault",
+          function: "approve(address spender, uint256 amount)",
+          spender: susde,
+          amountHuman: args.amountHuman,
+          note: "Allowance to stake this USDe amount (not unlimited)."
+        }),
+        evm: { type: "ethena_erc20_approve", version: 1, chainId: "1" },
+        ethena: { step: "approve_usde", susde }
+      });
+    } else {
+      batchMeta.push({
+        destinationAddress: susde,
+        signatureText: JSON.stringify({
+          kind: "Ethena",
+          name: "StakedUSDe (ERC-4626).deposit",
+          function: "deposit(uint256 assets, address receiver)",
+          assets: amountWei.toString(),
+          receiver,
+          amountHuman: args.amountHuman
+        }),
+        evm: { type: "ethena_susde_deposit", version: 1, chainId: "1" },
+        ethena: { step: "deposit", vault: susde, gasBuildDeposit: { baseGasUnits: gasLimitI.toString() } }
+      });
+    }
+  }
+  const extraPayload = { batchMeta };
+  if (useCustomGas && args.customGasChainDetails && Object.keys(args.customGasChainDetails).length > 0) {
+    extraPayload.customGasChainDetails = args.customGasChainDetails;
+  }
+  const extraJSON = JSON.stringify(extraPayload);
+  const firstSigText = batchMeta[0].signatureText;
+  const n = steps.length;
+  const purposeSuffix = n === 1 ? "Ethena: 1-tx \u2014 deposit USDe to sUSDe (allowance already set)." : `Ethena: ${n}-tx batch \u2014 approve USDe to sUSDe vault, then deposit.`;
+  const bodyForSign = {
+    keyList,
+    pubKey: ph,
+    msgHash: messageHashes[0],
+    msgRaw: firstDataNo0x,
+    messageHashes,
+    messageRawBatch,
+    destinationChainID: "1",
+    destinationAddress: steps[0].to,
+    extraJSON,
+    signatureText: firstSigText,
+    purpose: (() => {
+      const t = args.purposeText.trim();
+      return (t ? `${t}
+
+` : "") + purposeSuffix;
+    })(),
+    ...firstTxFeePayload,
+    proposalTxParams: proposalTxParamsBatch
+  };
+  if (clientId) bodyForSign.clientId = clientId;
+  return { bodyForSign, messageToSign: JSON.stringify(bodyForSign) };
+}
+var ETHENA_SUSDE_COOLDOWN_SHARES_FALLBACK = 1200000n;
+var ETHENA_SUSDE_UNSTAKE_CLAIM_FALLBACK = 500000n;
+async function buildEthenaStakedUsdeOneTxMultisignBody(args) {
+  if (args.chainId !== 1) {
+    throw new Error("Ethena sUSDe exit is only supported on Ethereum mainnet (chain id 1).");
+  }
+  const ph = (args.keyGen.pubkeyhex ?? "").trim();
+  if (!ph) throw new Error("keyGen pubKey (pubkeyhex) is required");
+  const keyList = args.keyGen.keylist ?? [];
+  const clientId = firstClientIdFromKeyGen(args.keyGen);
+  const { executor } = args;
+  const steps = [args.step];
+  const feeParams = await fetchChainFeeParams(args.rpcUrl, 1);
+  const legacy = Boolean(args.chainDetail?.legacy) || !feeParams.isEip1559;
+  const useCustomGas = args.useCustomGas;
+  const gasLimitConfig = useCustomGas && args.chainDetail?.gasLimit != null ? Number(args.chainDetail.gasLimit) : void 0;
+  const gasFeeMultiplier = useCustomGas && args.chainDetail?.gasMultiplier != null ? Number(args.chainDetail.gasMultiplier) : void 0;
+  const ch = viem.defineChain({
+    id: 1,
+    name: "Ethereum",
+    nativeCurrency: { decimals: 18, name: "Ether", symbol: "ETH" },
+    rpcUrls: { default: { http: [args.rpcUrl.trim()] } }
+  });
+  const publicClient = viem.createPublicClient({ chain: ch, transport: viem.http(args.rpcUrl.trim()) });
+  const latestBaseFeeWei = !legacy ? (await publicClient.getBlock({ blockTag: "latest" })).baseFeePerGas ?? 0n : 0n;
+  const baseNonce = await publicClient.getTransactionCount({ address: executor, blockTag: "pending" });
+  const messageHashes = [];
+  const messageRawBatch = [];
+  const proposalTxParamsBatch = [];
+  const batchMeta = [];
+  let firstTxFeePayload = {};
+  let firstDataNo0x = "";
+  for (let i = 0; i < steps.length; i++) {
+    const s = steps[i];
+    const currentNonce = baseNonce + i;
+    let estimatedGas;
+    try {
+      estimatedGas = await publicClient.estimateGas({
+        to: s.to,
+        data: s.data,
+        value: s.value,
+        account: executor
+      });
+    } catch {
+      estimatedGas = args.gasFallback;
+    }
+    const gasLimitI = useCustomGas ? gasLimitFromEstimateAndChainConfig(estimatedGas, gasLimitConfig) : estimatedGas;
+    if (legacy) {
+      let gasPriceWei = await publicClient.getGasPrice();
+      if (useCustomGas && gasFeeMultiplier != null && gasFeeMultiplier > 0) {
+        gasPriceWei = gasPriceWei * BigInt(100 + gasFeeMultiplier) / 100n;
+      }
+      if (useCustomGas && args.chainDetail?.gasPrice != null && args.chainDetail.gasPrice > 0) {
+        const configured = viem.parseGwei(gweiToDecimalString(Number(args.chainDetail.gasPrice)));
+        if (configured > gasPriceWei) gasPriceWei = configured;
+      }
+      const ser = viem.serializeTransaction({
+        type: "legacy",
+        to: s.to,
+        data: s.data,
+        value: s.value,
+        gas: gasLimitI,
+        gasPrice: gasPriceWei,
+        nonce: currentNonce,
+        chainId: 1
+      });
+      const h = viem.keccak256(ser);
+      messageHashes.push(h.startsWith("0x") ? h.slice(2) : h);
+      messageRawBatch.push(ser);
+      proposalTxParamsBatch.push({
+        nonce: currentNonce,
+        gasLimit: gasLimitI.toString(),
+        txType: "legacy",
+        gasPrice: gasPriceWei.toString()
+      });
+      if (i === 0) {
+        firstTxFeePayload = { txNonce: currentNonce, txGasLimit: gasLimitI.toString(), txGasPrice: gasPriceWei.toString() };
+        firstDataNo0x = s.data.startsWith("0x") ? s.data.slice(2) : s.data;
+      }
+    } else {
+      const fetchedBase = feeParams.baseFeeGwei ?? 0;
+      const fetchedPriority = feeParams.priorityFeeGwei ?? 0;
+      const configuredBase = useCustomGas && args.chainDetail?.baseFee != null ? Number(args.chainDetail.baseFee) : 0;
+      const configuredPriority = useCustomGas && args.chainDetail?.priorityFee != null ? Number(args.chainDetail.priorityFee) : 0;
+      const effectiveBaseFeeGwei = Math.max(fetchedBase, configuredBase);
+      const effectivePriorityFeeGwei = Math.max(fetchedPriority, configuredPriority);
+      const baseFeeMultiplierPct = useCustomGas && args.chainDetail?.baseFeeMultiplier != null ? Math.max(100, Number(args.chainDetail.baseFeeMultiplier)) : 100;
+      const baseComponentGwei = effectiveBaseFeeGwei * baseFeeMultiplierPct / 100;
+      const maxFeePerGasGwei = baseComponentGwei + effectivePriorityFeeGwei;
+      let maxPriorityFeePerGas = effectivePriorityFeeGwei > 0 ? viem.parseGwei(gweiToDecimalString(effectivePriorityFeeGwei)) : viem.parseGwei("1");
+      let maxFeePerGas = viem.parseGwei(gweiToDecimalString(maxFeePerGasGwei));
+      if (useCustomGas && gasFeeMultiplier != null && gasFeeMultiplier > 0) {
+        maxPriorityFeePerGas = maxPriorityFeePerGas * BigInt(100 + gasFeeMultiplier) / 100n;
+        maxFeePerGas = maxFeePerGas * BigInt(100 + gasFeeMultiplier) / 100n;
+      }
+      ({ maxFeePerGas, maxPriorityFeePerGas } = alignEip1559FeesWithLatestBase(
+        maxFeePerGas,
+        maxPriorityFeePerGas,
+        latestBaseFeeWei
+      ));
+      const ser = viem.serializeTransaction({
+        type: "eip1559",
+        to: s.to,
+        data: s.data,
+        value: s.value,
+        gas: gasLimitI,
+        maxFeePerGas,
+        maxPriorityFeePerGas,
+        nonce: currentNonce,
+        chainId: 1
+      });
+      const h = viem.keccak256(ser);
+      messageHashes.push(h.startsWith("0x") ? h.slice(2) : h);
+      messageRawBatch.push(ser);
+      proposalTxParamsBatch.push({
+        nonce: currentNonce,
+        gasLimit: gasLimitI.toString(),
+        txType: "eip1559",
+        maxFeePerGas: maxFeePerGas.toString(),
+        maxPriorityFeePerGas: maxPriorityFeePerGas.toString()
+      });
+      if (i === 0) {
+        firstTxFeePayload = {
+          txNonce: currentNonce,
+          txGasLimit: gasLimitI.toString(),
+          txMaxFeePerGas: maxFeePerGas.toString(),
+          txMaxPriorityFeePerGas: maxPriorityFeePerGas.toString()
+        };
+        firstDataNo0x = s.data.startsWith("0x") ? s.data.slice(2) : s.data;
+      }
+    }
+    batchMeta.push(args.makeBatchMeta({ gasLimitI }));
+  }
+  const extraPayload = { batchMeta };
+  if (useCustomGas && args.customGasChainDetails && Object.keys(args.customGasChainDetails).length > 0) {
+    extraPayload.customGasChainDetails = args.customGasChainDetails;
+  }
+  const extraJSON = JSON.stringify(extraPayload);
+  const firstSigText = batchMeta[0].signatureText;
+  const bodyForSign = {
+    keyList,
+    pubKey: ph,
+    msgHash: messageHashes[0],
+    msgRaw: firstDataNo0x,
+    messageHashes,
+    messageRawBatch,
+    destinationChainID: "1",
+    destinationAddress: steps[0].to,
+    extraJSON,
+    signatureText: firstSigText,
+    purpose: (() => {
+      const t = args.purposeText.trim();
+      return (t ? `${t}
+
+` : "") + args.purposeSuffix;
+    })(),
+    ...firstTxFeePayload,
+    proposalTxParams: proposalTxParamsBatch
+  };
+  if (clientId) bodyForSign.clientId = clientId;
+  return { bodyForSign, messageToSign: JSON.stringify(bodyForSign) };
+}
+async function buildEvmMultisignBodyEthenaSusdeRedeemToUsde(args) {
+  if (args.chainId !== 1) {
+    throw new Error("Ethena sUSDe \u2192 USDe redeem is only supported on Ethereum mainnet (chain id 1).");
+  }
+  const susde = viem.getAddress(args.susdeVault ?? SUSDE_ETHEREUM_MAINNET);
+  if (viem.getAddress(SUSDE_ETHEREUM_MAINNET).toLowerCase() !== susde.toLowerCase()) {
+    throw new Error("sUSDe vault address mismatch.");
+  }
+  const executor = viem.getAddress(args.executorAddress);
+  const receiver = viem.getAddress(args.receiver);
+  const ch = viem.defineChain({
+    id: 1,
+    name: "Ethereum",
+    nativeCurrency: { decimals: 18, name: "Ether", symbol: "ETH" },
+    rpcUrls: { default: { http: [args.rpcUrl.trim()] } }
+  });
+  const publicClient = viem.createPublicClient({ chain: ch, transport: viem.http(args.rpcUrl.trim()) });
+  const dec = await publicClient.readContract({
+    address: susde,
+    abi: susdeErc4626Abi,
+    functionName: "decimals"
+  });
+  const sharesWei = viem.parseUnits(args.sharesHuman, Number(dec));
+  if (sharesWei === 0n) throw new Error("Amount is zero after converting with share decimals.");
+  const redeemData = viem.encodeFunctionData({
+    abi: susdeErc4626Abi,
+    functionName: "redeem",
+    args: [sharesWei, receiver, executor]
+  });
+  const step = { to: susde, data: redeemData, value: 0n };
+  const purposeSuffix = "Ethena: 1-tx \u2014 redeem sUSDe shares to USDe (ERC-4626; no cooldown).";
+  return buildEthenaStakedUsdeOneTxMultisignBody({
+    keyGen: args.keyGen,
+    chainId: args.chainId,
+    rpcUrl: args.rpcUrl,
+    chainDetail: args.chainDetail,
+    useCustomGas: args.useCustomGas,
+    customGasChainDetails: args.customGasChainDetails,
+    susde,
+    executor,
+    step,
+    purposeText: args.purposeText,
+    purposeSuffix,
+    gasFallback: ETHENA_SUSDE_REDEEM_FALLBACK,
+    makeBatchMeta: ({ gasLimitI }) => ({
+      destinationAddress: susde,
+      signatureText: JSON.stringify({
+        kind: "Ethena",
+        name: "StakedUSDe (ERC-4626).redeem",
+        function: "redeem(uint256 shares, address receiver, address owner)",
+        shares: sharesWei.toString(),
+        receiver,
+        owner: executor,
+        amountHuman: args.sharesHuman
+      }),
+      evm: { type: "ethena_susde_redeem", version: 1, chainId: "1" },
+      ethena: { step: "redeem", vault: susde, gasBuildRedeem: { baseGasUnits: gasLimitI.toString() } }
+    })
+  });
+}
+async function buildEvmMultisignBodyEthenaSusdeCooldownShares(args) {
+  if (args.chainId !== 1) {
+    throw new Error("Ethena sUSDe cooldown is only supported on Ethereum mainnet (chain id 1).");
+  }
+  const susde = viem.getAddress(args.susdeVault ?? SUSDE_ETHEREUM_MAINNET);
+  if (viem.getAddress(SUSDE_ETHEREUM_MAINNET).toLowerCase() !== susde.toLowerCase()) {
+    throw new Error("sUSDe vault address mismatch.");
+  }
+  const executor = viem.getAddress(args.executorAddress);
+  const ch = viem.defineChain({
+    id: 1,
+    name: "Ethereum",
+    nativeCurrency: { decimals: 18, name: "Ether", symbol: "ETH" },
+    rpcUrls: { default: { http: [args.rpcUrl.trim()] } }
+  });
+  const publicClient = viem.createPublicClient({ chain: ch, transport: viem.http(args.rpcUrl.trim()) });
+  const dec = await publicClient.readContract({
+    address: susde,
+    abi: susdeErc4626Abi,
+    functionName: "decimals"
+  });
+  const sharesWei = viem.parseUnits(args.sharesHuman, Number(dec));
+  if (sharesWei === 0n) throw new Error("Amount is zero after converting with share decimals.");
+  const data = viem.encodeFunctionData({
+    abi: stakedUsdeV2UnstakeAbi,
+    functionName: "cooldownShares",
+    args: [sharesWei, executor]
+  });
+  const step = { to: susde, data, value: 0n };
+  const purposeSuffix = "Ethena: 1-tx \u2014 cooldownShares (sUSDe \u2192 silo, claim USDe in Unlock after cooldown).";
+  return buildEthenaStakedUsdeOneTxMultisignBody({
+    keyGen: args.keyGen,
+    chainId: args.chainId,
+    rpcUrl: args.rpcUrl,
+    chainDetail: args.chainDetail,
+    useCustomGas: args.useCustomGas,
+    customGasChainDetails: args.customGasChainDetails,
+    susde,
+    executor,
+    step,
+    purposeText: args.purposeText,
+    purposeSuffix,
+    gasFallback: ETHENA_SUSDE_COOLDOWN_SHARES_FALLBACK,
+    makeBatchMeta: ({ gasLimitI }) => ({
+      destinationAddress: susde,
+      signatureText: JSON.stringify({
+        kind: "Ethena",
+        name: "StakedUSDeV2.cooldownShares",
+        function: "cooldownShares(uint256 shares, address owner)",
+        shares: sharesWei.toString(),
+        owner: executor,
+        amountHuman: args.sharesHuman
+      }),
+      evm: { type: "ethena_susde_cooldown_shares", version: 1, chainId: "1" },
+      ethena: { step: "cooldown_shares", vault: susde, gasBuildCooldown: { baseGasUnits: gasLimitI.toString() } }
+    })
+  });
+}
+async function buildEvmMultisignBodyEthenaUnstakeClaim(args) {
+  if (args.chainId !== 1) {
+    throw new Error("Ethena unstake claim is only supported on Ethereum mainnet (chain id 1).");
+  }
+  const susde = viem.getAddress(args.susdeVault ?? SUSDE_ETHEREUM_MAINNET);
+  if (viem.getAddress(SUSDE_ETHEREUM_MAINNET).toLowerCase() !== susde.toLowerCase()) {
+    throw new Error("sUSDe vault address mismatch.");
+  }
+  const executor = viem.getAddress(args.executorAddress);
+  const receiver = viem.getAddress(args.receiver);
+  const data = viem.encodeFunctionData({
+    abi: stakedUsdeV2UnstakeAbi,
+    functionName: "unstake",
+    args: [receiver]
+  });
+  const step = { to: susde, data, value: 0n };
+  const purposeSuffix = "Ethena: 1-tx \u2014 unstake (claim USDe after cooldown).";
+  return buildEthenaStakedUsdeOneTxMultisignBody({
+    keyGen: args.keyGen,
+    chainId: args.chainId,
+    rpcUrl: args.rpcUrl,
+    chainDetail: args.chainDetail,
+    useCustomGas: args.useCustomGas,
+    customGasChainDetails: args.customGasChainDetails,
+    susde,
+    executor,
+    step,
+    purposeText: args.purposeText,
+    purposeSuffix,
+    gasFallback: ETHENA_SUSDE_UNSTAKE_CLAIM_FALLBACK,
+    makeBatchMeta: ({ gasLimitI }) => ({
+      destinationAddress: susde,
+      signatureText: JSON.stringify({
+        kind: "Ethena",
+        name: "StakedUSDeV2.unstake",
+        function: "unstake(address receiver)",
+        receiver
+      }),
+      evm: { type: "ethena_susde_unstake", version: 1, chainId: "1" },
+      ethena: { step: "unstake", vault: susde, gasBuildUnstake: { baseGasUnits: gasLimitI.toString() } }
+    })
+  });
+}
+function parseExtraJsonObject(detail) {
+  if (!detail) return null;
+  const raw = detail.ExtraJSON ?? detail.extraJSON;
+  if (raw == null) return null;
+  if (typeof raw === "object" && !Array.isArray(raw)) return raw;
+  if (typeof raw === "string" && raw.trim()) {
+    try {
+      const p = JSON.parse(raw);
+      if (p && typeof p === "object" && !Array.isArray(p)) return p;
+    } catch {
+      return null;
+    }
+  }
+  return null;
+}
+function parseOptionalGasLimitString(raw) {
+  if (raw == null) return null;
+  const s = String(raw).trim();
+  if (!s) return null;
+  try {
+    if (/^0x[0-9a-fA-F]+$/.test(s)) return BigInt(s);
+    return BigInt(s);
+  } catch {
+    return null;
+  }
+}
+function isEthenaSusdeDepositBatchStep(detail, batchIndex) {
+  if (batchIndex < 0) return false;
+  const ex = parseExtraJsonObject(detail);
+  const bm = ex?.batchMeta;
+  if (!Array.isArray(bm) || !bm[batchIndex] || typeof bm[batchIndex] !== "object" || Array.isArray(bm[batchIndex])) {
+    return false;
+  }
+  const evm = bm[batchIndex].evm;
+  return String(evm?.type ?? "") === "ethena_susde_deposit";
+}
+function resolveEthenaBatchStepGasFromSignRequest(detail, batchIndex) {
+  if (!detail || batchIndex < 0) return null;
+  const propBatch = detail.proposal_tx_params ?? detail.proposalTxParams ?? detail.ProposalTxParams;
+  if (Array.isArray(propBatch) && propBatch.length > batchIndex) {
+    const row = propBatch[batchIndex];
+    if (row && typeof row === "object" && !Array.isArray(row)) {
+      const gl = parseOptionalGasLimitString(row.gasLimit);
+      if (gl != null && gl > 0n) return gl;
+    }
+  }
+  const ex = parseExtraJsonObject(detail);
+  const bm = ex?.batchMeta;
+  if (!Array.isArray(bm) || !bm[batchIndex] || typeof bm[batchIndex] !== "object" || Array.isArray(bm[batchIndex])) {
+    return null;
+  }
+  const ethena = bm[batchIndex].ethena;
+  if (!ethena || typeof ethena !== "object") return null;
+  for (const key of ["gasBuildDeposit", "gasBuildCooldown", "gasBuildUnstake", "gasBuildRedeem"]) {
+    const g = ethena[key];
+    if (g && typeof g === "object") {
+      const p = parseOptionalGasLimitString(g.baseGasUnits);
+      if (p != null && p > 0n) return p;
+    }
+  }
+  return null;
+}
+
+// src/protocols/evm/ethena/index.ts
+var ETHENA_PROTOCOL_ID = "ethena";
+var ethenaProtocolModule = {
+  id: ETHENA_PROTOCOL_ID,
+  chainCategory: "evm",
+  isChainSupported(ctx) {
+    if (ctx.chainCategory !== "evm") return false;
+    const n = typeof ctx.chainId === "number" ? ctx.chainId : Number.parseInt(String(ctx.chainId), 10);
+    return isEvmChainInEthenaUsdeList(n);
+  },
+  isTokenSupported(token) {
+    return token.category === "evm" && token.kind === "erc20";
+  },
+  actions: [
+    { id: "ethena.stake-usde", protocolId: ETHENA_PROTOCOL_ID, chainCategory: "evm", description: "Stake USDe \u2192 sUSDe", commonParams: ["keyGen", "purposeText", "useCustomGas"], params: { amountHuman: { type: "string", required: true, description: "USDe amount" } } },
+    { id: "ethena.redeem-susde", protocolId: ETHENA_PROTOCOL_ID, chainCategory: "evm", description: "Redeem sUSDe \u2192 USDe (no cooldown)", commonParams: ["keyGen", "purposeText", "useCustomGas"], params: {} },
+    { id: "ethena.cooldown-shares", protocolId: ETHENA_PROTOCOL_ID, chainCategory: "evm", description: "Start sUSDe cooldown", commonParams: ["keyGen", "purposeText", "useCustomGas"], params: {} },
+    { id: "ethena.claim-unstake", protocolId: ETHENA_PROTOCOL_ID, chainCategory: "evm", description: "Claim after cooldown", commonParams: ["keyGen", "purposeText", "useCustomGas"], params: {} }
+  ]
+};
+registerProtocolModule(ethenaProtocolModule);
+
+exports.ETHENA_KEY_ADDRESSES_DOC = ETHENA_KEY_ADDRESSES_DOC;
+exports.ETHENA_LABS_GITHUB = ETHENA_LABS_GITHUB;
+exports.ETHENA_PROTOCOL_ID = ETHENA_PROTOCOL_ID;
+exports.ETHENA_SUSDE_DEPOSIT_GET_SIG_GAS_FALLBACK = ETHENA_SUSDE_DEPOSIT_GET_SIG_GAS_FALLBACK;
+exports.SUSDE_ETHEREUM_MAINNET = SUSDE_ETHEREUM_MAINNET;
+exports.USDE_ETHEREUM_MAINNET = USDE_ETHEREUM_MAINNET;
+exports.USDE_MOST_L2S = USDE_MOST_L2S;
+exports.USDE_ZKSYNC_ERA = USDE_ZKSYNC_ERA;
+exports.buildEvmMultisignBodyEthenaSusdeCooldownShares = buildEvmMultisignBodyEthenaSusdeCooldownShares;
+exports.buildEvmMultisignBodyEthenaSusdeRedeemToUsde = buildEvmMultisignBodyEthenaSusdeRedeemToUsde;
+exports.buildEvmMultisignBodyEthenaUnstakeClaim = buildEvmMultisignBodyEthenaUnstakeClaim;
+exports.buildEvmMultisignBodyEthenaUsdeStakeToSusde = buildEvmMultisignBodyEthenaUsdeStakeToSusde;
+exports.ethenaProtocolModule = ethenaProtocolModule;
+exports.isEthenaSusdeDepositBatchStep = isEthenaSusdeDepositBatchStep;
+exports.isEthenaUsdeOnAssetsChain = isEthenaUsdeOnAssetsChain;
+exports.isEvmChainInEthenaUsdeList = isEvmChainInEthenaUsdeList;
+exports.listEthenaUsdeEvmNetworkRows = listEthenaUsdeEvmNetworkRows;
+exports.readEthenaStakePreviewShares = readEthenaStakePreviewShares;
+exports.readEthenaUnstakePreviewUsde = readEthenaUnstakePreviewUsde;
+exports.resolveEthenaBatchStepGasFromSignRequest = resolveEthenaBatchStepGasFromSignRequest;
+exports.usdeTokenAddressOnEvmChain = usdeTokenAddressOnEvmChain;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map