@continuumdao/ctm-mpc-defi 0.1.4 → 0.2.0

package/dist/protocols/evm/maple/index.js

@@ -0,0 +1,693 @@
+import { parseAbi, getAddress, parseUnits, encodeFunctionData, parseGwei, serializeTransaction, keccak256, defineChain, createPublicClient, http, stringToBytes, toHex, formatUnits } from '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/protocols/evm/maple/constants.ts
+var MAPLE_SYRUP_DEPOSIT_DATA_ASCII = "0:continuumdao";
+var MAPLE_INTEGRATION_DOCS_URL = "https://docs.maple.finance/integrate/ethereum-mainnet/frontend-integration";
+function mapleGraphqlEndpointForChain(chainId) {
+  if (chainId === 1) return "https://api.maple.finance/v2/graphql";
+  if (chainId === 11155111) return "https://sepolia.api.maple.finance/v2/graphql";
+  return null;
+}
+function isMapleSyrupSupportedChain(chainId) {
+  return chainId === 1 || chainId === 11155111;
+}
+
+// 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 = typeof chainId === "string" ? parseInt(chainId, 10) : chainId;
+  if (Number.isNaN(chainIdNum)) return { isEip1559: false };
+  const chain = defineChain({
+    id: chainIdNum,
+    name: "Discovery",
+    nativeCurrency: { decimals: 18, name: "Ether", symbol: "ETH" },
+    rpcUrls: { default: { http: [url] } }
+  });
+  const publicClient = createPublicClient({
+    chain,
+    transport: http(url)
+  });
+  const getGasPriceGwei = async () => {
+    const gasPriceWei = await publicClient.getGasPrice();
+    return parseFloat(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(formatUnits(baseFeePerGas, 9));
+    let priorityFeeGwei;
+    try {
+      const priorityWei = await publicClient.estimateMaxPriorityFeePerGas();
+      priorityFeeGwei = parseFloat(formatUnits(priorityWei, 9));
+    } catch {
+    }
+    const gasPriceGwei = await getGasPriceGwei();
+    return {
+      isEip1559: true,
+      baseFeeGwei,
+      priorityFeeGwei,
+      gasPriceGwei
+    };
+  } catch {
+    try {
+      const gasPriceWei = await publicClient.getGasPrice();
+      const gasPriceGwei = parseFloat(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 + parseGwei("0.001");
+  }
+  if (maxF < maxP) {
+    maxF = baseWei > 0n ? baseWei + maxP + parseGwei("0.001") : maxP * 2n;
+  }
+  return { maxFeePerGas: maxF, maxPriorityFeePerGas: maxP };
+}
+function alignEip1559FeesWithLatestBase(maxFeePerGas, maxPriorityFeePerGas, latestBlockBaseFeeWei) {
+  return finalizeEip1559Fees(maxFeePerGas, maxPriorityFeePerGas, null, latestBlockBaseFeeWei);
+}
+
+// src/protocols/evm/maple/multisign.ts
+var AAVE_ERC20_APPROVE_FALLBACK = 100000n;
+var MAPLE_SYRUP_DEPOSIT_GAS_FALLBACK = 1500000n;
+var MAPLE_SYRUP_DEPOSIT_FALLBACK = MAPLE_SYRUP_DEPOSIT_GAS_FALLBACK;
+var MAPLE_REQUEST_REDEEM_FALLBACK = 1200000n;
+var erc20AllowanceAbi = parseAbi([
+  "function allowance(address owner, address spender) view returns (uint256)",
+  "function decimals() view returns (uint8)"
+]);
+var erc20ApproveAbi = parseAbi(["function approve(address spender, uint256 amount) returns (bool)"]);
+var syrupRouterAbi = parseAbi([
+  "function deposit(uint256 assets, bytes32 depositData)",
+  "function authorizeAndDeposit(uint256 bitmap,uint256 deadline,uint8 auth_v,bytes32 auth_r,bytes32 auth_s,uint256 amount,bytes32 depositData)"
+]);
+var poolV2ExitAbi = parseAbi([
+  "function previewDeposit(uint256 assets) view returns (uint256 shares)",
+  "function convertToExitShares(uint256 assets_) view returns (uint256 shares_)",
+  "function requestRedeem(uint256 shares, address receiver) returns (uint256)",
+  "function decimals() view returns (uint8)"
+]);
+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;
+}
+function formatBytes32DataLabel(s) {
+  const b = stringToBytes(s);
+  if (b.length > 32) throw new Error("Maple depositData label is too long for bytes32.");
+  const padded = new Uint8Array(32);
+  padded.set(b);
+  return toHex(padded);
+}
+function publicClientForChain(chainId, rpcUrl) {
+  const rpc = rpcUrl.trim();
+  if (chainId === 1) {
+    const ch = defineChain({
+      id: 1,
+      name: "Ethereum",
+      nativeCurrency: { decimals: 18, name: "Ether", symbol: "ETH" },
+      rpcUrls: { default: { http: [rpc] } }
+    });
+    return createPublicClient({ chain: ch, transport: http(rpc) });
+  }
+  if (chainId === 11155111) {
+    const ch = defineChain({
+      id: 11155111,
+      name: "Sepolia",
+      nativeCurrency: { decimals: 18, name: "Ether", symbol: "ETH" },
+      rpcUrls: { default: { http: [rpc] } }
+    });
+    return createPublicClient({ chain: ch, transport: http(rpc) });
+  }
+  throw new Error(`Maple Syrup multisign: unsupported chain id ${chainId}.`);
+}
+async function readMaplePoolShareDecimals(args) {
+  const client = publicClientForChain(args.chainId, args.rpcUrl);
+  const d = await client.readContract({
+    address: getAddress(args.pool),
+    abi: poolV2ExitAbi,
+    functionName: "decimals"
+  });
+  return Number(d);
+}
+async function readMapleStakePreviewShares(args) {
+  if (args.assetAmountWei <= 0n) return 0n;
+  const client = publicClientForChain(args.chainId, args.rpcUrl);
+  return client.readContract({
+    address: getAddress(args.pool),
+    abi: poolV2ExitAbi,
+    functionName: "previewDeposit",
+    args: [args.assetAmountWei]
+  });
+}
+async function readMapleUnstakeExitSharesForAssets(args) {
+  if (args.assetAmountWei <= 0n) return 0n;
+  const client = publicClientForChain(args.chainId, args.rpcUrl);
+  return client.readContract({
+    address: getAddress(args.pool),
+    abi: poolV2ExitAbi,
+    functionName: "convertToExitShares",
+    args: [args.assetAmountWei]
+  });
+}
+function parseMapleStakeAuthInputs(args) {
+  const bitmapT = args.bitmap.trim();
+  let bitmap;
+  if (!bitmapT) return { ok: false, message: "Enter authorization bitmap (uint256)." };
+  try {
+    bitmap = bitmapT.startsWith("0x") || bitmapT.startsWith("0X") ? BigInt(bitmapT) : BigInt(bitmapT);
+  } catch {
+    return { ok: false, message: "Bitmap must be a decimal or 0x-prefixed integer." };
+  }
+  const deadlineT = args.deadline.trim();
+  if (!deadlineT || !/^\d+$/.test(deadlineT)) {
+    return { ok: false, message: "Deadline must be a Unix timestamp (seconds), decimal digits only." };
+  }
+  const deadline = BigInt(deadlineT);
+  if (deadline <= 0n) return { ok: false, message: "Deadline must be positive." };
+  const vT = args.v.trim();
+  if (!/^\d+$/.test(vT)) return { ok: false, message: "v must be an integer 0\u2013255 (often 27 or 28)." };
+  const v = Number(vT);
+  if (!Number.isFinite(v) || v < 0 || v > 255) return { ok: false, message: "v must be between 0 and 255." };
+  let r = args.r.trim();
+  let s = args.s.trim();
+  if (!r.startsWith("0x")) r = "0x" + r;
+  if (!s.startsWith("0x")) s = "0x" + s;
+  if (!/^0x[0-9a-fA-F]{64}$/.test(r)) return { ok: false, message: "r must be 32 bytes (64 hex chars), optional 0x." };
+  if (!/^0x[0-9a-fA-F]{64}$/.test(s)) return { ok: false, message: "s must be 32 bytes (64 hex chars), optional 0x." };
+  return { ok: true, sig: { bitmap, deadline, v, r, s } };
+}
+async function buildEvmMultisignBodyMapleSyrupDeposit(args) {
+  if (args.chainId !== 1 && args.chainId !== 11155111) {
+    throw new Error("Maple Syrup deposit is only supported on Ethereum mainnet or Sepolia.");
+  }
+  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 asset = getAddress(args.asset);
+  const router = getAddress(args.syrupRouter);
+  const pool = getAddress(args.pool);
+  const executor = getAddress(args.executorAddress);
+  const depositData = formatBytes32DataLabel(MAPLE_SYRUP_DEPOSIT_DATA_ASCII);
+  const publicClient = publicClientForChain(args.chainId, args.rpcUrl);
+  const dec = args.assetDecimals;
+  if (!Number.isFinite(dec) || dec < 0 || dec > 255) throw new Error("Invalid asset decimals.");
+  const amountWei = parseUnits(args.amountHuman, dec);
+  if (amountWei === 0n) throw new Error("Amount is zero after converting with token decimals.");
+  const stakeMethod = args.stakeMethod ?? "deposit";
+  if (stakeMethod === "authorizeAndDeposit") {
+    const a = args.authorizeSig;
+    if (!a) throw new Error("authorizeSig is required for authorizeAndDeposit.");
+    if (a.v < 0 || a.v > 255) throw new Error("Invalid authorization v (must be 0\u2013255).");
+  }
+  const steps = [];
+  const currentAllowance = await publicClient.readContract({
+    address: asset,
+    abi: erc20AllowanceAbi,
+    functionName: "allowance",
+    args: [executor, router]
+  });
+  if (currentAllowance < amountWei) {
+    if (currentAllowance > 0n) {
+      const dataReset = encodeFunctionData({
+        abi: erc20ApproveAbi,
+        functionName: "approve",
+        args: [router, 0n]
+      });
+      steps.push({ kind: "approve", to: asset, data: dataReset, value: 0n });
+    }
+    const dataApprove = encodeFunctionData({
+      abi: erc20ApproveAbi,
+      functionName: "approve",
+      args: [router, amountWei]
+    });
+    steps.push({ kind: "approve", to: asset, data: dataApprove, value: 0n });
+  }
+  if (stakeMethod === "authorizeAndDeposit") {
+    const a = args.authorizeSig;
+    const authCalldata = encodeFunctionData({
+      abi: syrupRouterAbi,
+      functionName: "authorizeAndDeposit",
+      args: [a.bitmap, a.deadline, a.v, a.r, a.s, amountWei, depositData]
+    });
+    steps.push({ kind: "authorizeAndDeposit", to: router, data: authCalldata, value: 0n });
+  } else {
+    const depositCalldata = encodeFunctionData({
+      abi: syrupRouterAbi,
+      functionName: "deposit",
+      args: [amountWei, depositData]
+    });
+    steps.push({ kind: "deposit", to: router, data: depositCalldata, value: 0n });
+  }
+  const feeParams = await fetchChainFeeParams(args.rpcUrl, args.chainId);
+  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 skipFinalStakeEstimateBecausePriorApproves = (s.kind === "deposit" || s.kind === "authorizeAndDeposit") && i > 0;
+    if (skipFinalStakeEstimateBecausePriorApproves) {
+      estimatedGas = MAPLE_SYRUP_DEPOSIT_FALLBACK;
+    } else {
+      try {
+        estimatedGas = await publicClient.estimateGas({
+          to: s.to,
+          data: s.data,
+          value: s.value,
+          account: executor
+        });
+      } catch (e) {
+        if (s.kind === "deposit" || s.kind === "authorizeAndDeposit") {
+          const msg = e instanceof Error ? e.message : String(e);
+          if (/NOT_AUTHORIZED|SR:D:NOT_AUTHORIZED/i.test(msg)) {
+            throw new Error(
+              stakeMethod === "authorizeAndDeposit" ? "Maple SyrupRouter rejected authorizeAndDeposit (SR:D:NOT_AUTHORIZED). Check the authorization signature, deadline, and bitmap from Maple; they must match this chain, router, and owner." : "Maple SyrupRouter rejected deposit (SR:D:NOT_AUTHORIZED): this executor is not allowlisted as a Syrup lender on-chain. Use authorizeAndDeposit with a Maple-issued signature for the first deposit, or ask Maple to allowlist this address."
+            );
+          }
+        }
+        estimatedGas = s.kind === "approve" ? AAVE_ERC20_APPROVE_FALLBACK : MAPLE_SYRUP_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 = parseGwei(gweiToDecimalString(Number(args.chainDetail.gasPrice)));
+        if (configured > gasPriceWei) gasPriceWei = configured;
+      }
+      const ser = serializeTransaction({
+        type: "legacy",
+        to: s.to,
+        data: s.data,
+        value: s.value,
+        gas: gasLimitI,
+        gasPrice: gasPriceWei,
+        nonce: currentNonce,
+        chainId: args.chainId
+      });
+      const h = 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 ? parseGwei(gweiToDecimalString(effectivePriorityFeeGwei)) : parseGwei("1");
+      let maxFeePerGas = 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 = serializeTransaction({
+        type: "eip1559",
+        to: s.to,
+        data: s.data,
+        value: s.value,
+        gas: gasLimitI,
+        maxFeePerGas,
+        maxPriorityFeePerGas,
+        nonce: currentNonce,
+        chainId: args.chainId
+      });
+      const h = 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;
+      }
+    }
+    const chainIdStr = String(args.chainId);
+    if (s.kind === "approve") {
+      batchMeta.push({
+        destinationAddress: asset,
+        signatureText: JSON.stringify({
+          kind: "MapleSyrup",
+          name: "ERC20.approve",
+          note: "Allow SyrupRouter to pull this deposit amount.",
+          spender: router,
+          asset,
+          pool,
+          amountHuman: args.amountHuman
+        }),
+        evm: { type: "maple_syrup_erc20_approve", version: 1, chainId: chainIdStr },
+        maple: { step: "approve_asset", router, pool, asset }
+      });
+    } else if (s.kind === "deposit") {
+      batchMeta.push({
+        destinationAddress: router,
+        signatureText: JSON.stringify({
+          kind: "MapleSyrup",
+          name: "SyrupRouter.deposit",
+          function: "deposit(uint256 assets, bytes32 depositData)",
+          assets: amountWei.toString(),
+          pool,
+          router,
+          amountHuman: args.amountHuman
+        }),
+        evm: { type: "maple_syrup_router_deposit", version: 1, chainId: chainIdStr },
+        maple: { step: "deposit", router, pool, gasBuildDeposit: { baseGasUnits: gasLimitI.toString() } }
+      });
+    } else {
+      const a = args.authorizeSig;
+      batchMeta.push({
+        destinationAddress: router,
+        signatureText: JSON.stringify({
+          kind: "MapleSyrup",
+          name: "SyrupRouter.authorizeAndDeposit",
+          function: "authorizeAndDeposit(uint256 bitmap,uint256 deadline,uint8 auth_v,bytes32 auth_r,bytes32 auth_s,uint256 amount,bytes32 depositData)",
+          bitmap: a.bitmap.toString(),
+          deadline: a.deadline.toString(),
+          auth_v: a.v,
+          assets: amountWei.toString(),
+          pool,
+          router,
+          amountHuman: args.amountHuman
+        }),
+        evm: { type: "maple_syrup_router_authorize_and_deposit", version: 1, chainId: chainIdStr },
+        maple: { step: "authorize_and_deposit", router, pool, 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 finalVerb = stakeMethod === "authorizeAndDeposit" ? "authorizeAndDeposit (permission + deposit)" : "deposit";
+  const purposeSuffix = n === 1 ? `Maple Syrup: 1-tx \u2014 ${finalVerb} via SyrupRouter (allowance already set).` : `Maple Syrup: ${n}-tx batch \u2014 approve asset for SyrupRouter, then ${finalVerb}.`;
+  const bodyForSign = {
+    keyList,
+    pubKey: ph,
+    msgHash: messageHashes[0],
+    msgRaw: firstDataNo0x,
+    messageHashes,
+    messageRawBatch,
+    destinationChainID: String(args.chainId),
+    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) };
+}
+async function buildEvmMultisignBodyMaplePoolRequestRedeem(args) {
+  if (args.chainId !== 1 && args.chainId !== 11155111) {
+    throw new Error("Maple Syrup redeem request is only supported on Ethereum mainnet or Sepolia.");
+  }
+  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 pool = getAddress(args.pool);
+  const executor = getAddress(args.executorAddress);
+  const receiver = executor;
+  const ud = args.underlyingDecimals;
+  if (!Number.isFinite(ud) || ud < 0 || ud > 255) throw new Error("Invalid underlying decimals.");
+  const assetWei = parseUnits(args.underlyingAmountHuman, ud);
+  if (assetWei === 0n) throw new Error("Amount is zero after converting with token decimals.");
+  const publicClient = publicClientForChain(args.chainId, args.rpcUrl);
+  const exitShares = await publicClient.readContract({
+    address: pool,
+    abi: poolV2ExitAbi,
+    functionName: "convertToExitShares",
+    args: [assetWei]
+  });
+  if (exitShares === 0n) throw new Error("Exit shares are zero for this amount; check pool liquidity and amount.");
+  const data = encodeFunctionData({
+    abi: poolV2ExitAbi,
+    functionName: "requestRedeem",
+    args: [exitShares, receiver]
+  });
+  const feeParams = await fetchChainFeeParams(args.rpcUrl, args.chainId);
+  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 currentNonce = await publicClient.getTransactionCount({ address: executor, blockTag: "pending" });
+  let estimatedGas;
+  try {
+    estimatedGas = await publicClient.estimateGas({
+      to: pool,
+      data,
+      value: 0n,
+      account: executor
+    });
+  } catch {
+    estimatedGas = MAPLE_REQUEST_REDEEM_FALLBACK;
+  }
+  const gasLimitI = useCustomGas ? gasLimitFromEstimateAndChainConfig(estimatedGas, gasLimitConfig) : estimatedGas;
+  const chainIdStr = String(args.chainId);
+  let firstTxFeePayload = {};
+  let ser;
+  let proposalTxParams0;
+  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 = parseGwei(gweiToDecimalString(Number(args.chainDetail.gasPrice)));
+      if (configured > gasPriceWei) gasPriceWei = configured;
+    }
+    ser = serializeTransaction({
+      type: "legacy",
+      to: pool,
+      data,
+      value: 0n,
+      gas: gasLimitI,
+      gasPrice: gasPriceWei,
+      nonce: currentNonce,
+      chainId: args.chainId
+    });
+    firstTxFeePayload = {
+      txNonce: currentNonce,
+      txGasLimit: gasLimitI.toString(),
+      txGasPrice: gasPriceWei.toString()
+    };
+    proposalTxParams0 = {
+      nonce: currentNonce,
+      gasLimit: gasLimitI.toString(),
+      txType: "legacy",
+      gasPrice: gasPriceWei.toString()
+    };
+  } 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 ? parseGwei(gweiToDecimalString(effectivePriorityFeeGwei)) : parseGwei("1");
+    let maxFeePerGas = 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
+    ));
+    ser = serializeTransaction({
+      type: "eip1559",
+      to: pool,
+      data,
+      value: 0n,
+      gas: gasLimitI,
+      maxFeePerGas,
+      maxPriorityFeePerGas,
+      nonce: currentNonce,
+      chainId: args.chainId
+    });
+    firstTxFeePayload = {
+      txNonce: currentNonce,
+      txGasLimit: gasLimitI.toString(),
+      txMaxFeePerGas: maxFeePerGas.toString(),
+      txMaxPriorityFeePerGas: maxPriorityFeePerGas.toString()
+    };
+    proposalTxParams0 = {
+      nonce: currentNonce,
+      gasLimit: gasLimitI.toString(),
+      txType: "eip1559",
+      maxFeePerGas: maxFeePerGas.toString(),
+      maxPriorityFeePerGas: maxPriorityFeePerGas.toString()
+    };
+  }
+  const h = keccak256(ser);
+  const messageHashes = [h.startsWith("0x") ? h.slice(2) : h];
+  const messageRawBatch = [ser];
+  const proposalTxParamsBatch = [proposalTxParams0];
+  const firstDataNo0x = data.startsWith("0x") ? data.slice(2) : data;
+  const batchMeta = [
+    {
+      destinationAddress: pool,
+      signatureText: JSON.stringify({
+        kind: "MapleSyrup",
+        name: "PoolV2.requestRedeem",
+        function: "requestRedeem(uint256 shares, address receiver)",
+        shares: exitShares.toString(),
+        underlyingAmountHuman: args.underlyingAmountHuman,
+        receiver,
+        pool
+      }),
+      evm: { type: "maple_pool_v2_request_redeem", version: 1, chainId: chainIdStr },
+      maple: { step: "request_redeem", pool, gasBuildRedeem: { 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 purposeSuffix = "Maple Syrup: 1-tx \u2014 request redeem (queue withdrawal of underlying from pool shares).";
+  const bodyForSign = {
+    keyList,
+    pubKey: ph,
+    msgHash: messageHashes[0],
+    msgRaw: firstDataNo0x,
+    messageHashes,
+    messageRawBatch,
+    destinationChainID: String(args.chainId),
+    destinationAddress: pool,
+    extraJSON,
+    signatureText: batchMeta[0].signatureText,
+    purpose: (() => {
+      const t = args.purposeText.trim();
+      return (t ? `${t}
+
+` : "") + purposeSuffix;
+    })(),
+    ...firstTxFeePayload,
+    proposalTxParams: proposalTxParamsBatch
+  };
+  if (clientId) bodyForSign.clientId = clientId;
+  return { bodyForSign, messageToSign: JSON.stringify(bodyForSign) };
+}
+
+// src/protocols/evm/maple/index.ts
+var MAPLE_PROTOCOL_ID = "maple-syrup";
+var mapleProtocolModule = {
+  id: MAPLE_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 isMapleSyrupSupportedChain(n);
+  },
+  isTokenSupported(token) {
+    return token.category === "evm" && token.kind === "erc20";
+  },
+  actions: [
+    { id: "maple-syrup.deposit", protocolId: MAPLE_PROTOCOL_ID, chainCategory: "evm", description: "Deposit into Maple Syrup pool", commonParams: ["keyGen", "purposeText", "useCustomGas"], params: {} },
+    { id: "maple-syrup.request-redeem", protocolId: MAPLE_PROTOCOL_ID, chainCategory: "evm", description: "Request redeem from pool", commonParams: ["keyGen", "purposeText", "useCustomGas"], params: {} }
+  ]
+};
+registerProtocolModule(mapleProtocolModule);
+
+export { MAPLE_INTEGRATION_DOCS_URL, MAPLE_PROTOCOL_ID, MAPLE_SYRUP_DEPOSIT_DATA_ASCII, MAPLE_SYRUP_DEPOSIT_GAS_FALLBACK, buildEvmMultisignBodyMaplePoolRequestRedeem, buildEvmMultisignBodyMapleSyrupDeposit, isMapleSyrupSupportedChain, mapleGraphqlEndpointForChain, mapleProtocolModule, parseMapleStakeAuthInputs, readMaplePoolShareDecimals, readMapleStakePreviewShares, readMapleUnstakeExitSharesForAssets };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map