@continuumdao/ctm-mpc-defi 0.2.42 → 0.2.44

package/dist/protocols/evm/aave-v4/index.js

@@ -1471,6 +1471,40 @@ async function buildEvmMultisignBodyAaveV4MerklClaimRewards(args) {
     })
   });
 }
+async function buildEvmMultisignBodyAaveV4MerklDistributorClaim(args) {
+  const to = getAddress(args.to);
+  const executor = getAddress(args.executorAddress);
+  return buildEvmMultisignBodyAaveV4OneStep({
+    keyGen: args.keyGen,
+    chainId: args.chainId,
+    rpcUrl: args.rpcUrl,
+    chainDetail: args.chainDetail,
+    useCustomGas: args.useCustomGas,
+    customGasChainDetails: args.customGasChainDetails ?? void 0,
+    purposeText: args.purposeText,
+    purposeSuffix: `Aave v4: 1-tx \u2014 wallet-wide Merkl distributor claim (${args.claimLeafCount} reward(s)).`,
+    executorAddress: executor,
+    v: { to, data: args.data, value: args.valueWei },
+    estimateGasFallback: AAVE_MERKL_CLAIM_ESTIMATE_FALLBACK,
+    buildBatchMeta: (ctx) => ({
+      destinationAddress: to,
+      signatureText: JSON.stringify({
+        kind: "AaveV4",
+        name: "Merkl Distributor claim",
+        claimLeafCount: args.claimLeafCount,
+        chainId: args.chainId,
+        valueWei: args.valueWei.toString(),
+        note: "Wallet-wide Merkl API proofs; Distributor.claim(users,tokens,amounts,proofs)."
+      }),
+      evm: { type: "aave_v4_merkl_distributor_claim", version: 1, chainId: String(args.chainId) },
+      aaveV4: {
+        step: "merkl_distributor_claim",
+        claimLeafCount: args.claimLeafCount,
+        gasBuildClaim: { baseGasUnits: ctx.gasLimit.toString() }
+      }
+    })
+  });
+}
 async function buildEvmMultisignBodyEulerV2MerklDistributorClaim(args) {
   const to = getAddress(args.to);
   const executor = getAddress(args.executorAddress);
@@ -1575,7 +1609,8 @@ var AAVE_V4_EVM_TYPES = /* @__PURE__ */ new Set([
   "aave_v4_spoke_withdraw",
   "aave_v4_spoke_borrow",
   "aave_v4_spoke_repay",
-  "aave_v4_merkl_claim_rewards"
+  "aave_v4_merkl_claim_rewards",
+  "aave_v4_merkl_distributor_claim"
 ]);
 function parseExtraJsonObject(detail) {
   if (!detail) return null;
@@ -2544,6 +2579,158 @@ async function aaveV4FetchMarketSummary(args) {
   }
   return out;
 }
+var MERKL_API_BASE = "https://api.merkl.xyz";
+var MERKL_DISTRIBUTOR_ADDRESS = "0x3Ef3D8bA38EBe18DB133cEc108f4D14CE00Dd9Ae";
+var MERKL_DISTRIBUTOR_CLAIM_GAS_FALLBACK = 500000n;
+var MERKL_REWARDS_NOTES = "Wallet-wide Merkl on this chain (not protocol-filtered). Other venues\u2019 campaigns can appear. Claims the first Merkle root batch; call again if additionalRoots > 0. rEUL is omitted (Euler unlock flow). Merkl updates every 8\u201312 hours.";
+function normHex32(p) {
+  const s = (p ?? "").trim();
+  if (!s) return null;
+  const x = s.startsWith("0x") ? s : `0x${s}`;
+  if (!/^0x[0-9a-fA-F]{64}$/.test(x)) return null;
+  return x;
+}
+function merklUserRewardsUrl(addr, chainId) {
+  return `${MERKL_API_BASE}/v4/users/${encodeURIComponent(addr)}/rewards?chainId=${chainId}`;
+}
+async function loadMerklUserRewardsJson(args) {
+  const addr = getAddress(args.user);
+  const url = merklUserRewardsUrl(addr, args.chainId);
+  const res = await fetch(url, { cache: "no-store" });
+  if (!res.ok) {
+    let detail = `Merkl API error ${res.status}`;
+    try {
+      const j = await res.json();
+      if (j?.error) {
+        detail = j.details ? `${j.error}: ${j.details}` : j.error;
+      }
+    } catch {
+    }
+    throw new Error(detail);
+  }
+  return res.json();
+}
+function parseMerklUserRewardsToLeaves(raw, args) {
+  const addr = getAddress(args.user);
+  if (!Array.isArray(raw)) {
+    throw new Error("Merkl API returned an unexpected rewards shape.");
+  }
+  const collected = [];
+  for (const block of raw) {
+    for (const rw of block.rewards ?? []) {
+      const root = (rw.root ?? "").trim();
+      const dist = rw.distributionChainId;
+      if (!root || dist !== args.chainId) continue;
+      let recipient;
+      try {
+        recipient = getAddress((rw.recipient ?? "").trim());
+      } catch {
+        continue;
+      }
+      if (recipient !== addr) continue;
+      let amt = 0n;
+      let clm = 0n;
+      try {
+        amt = BigInt((rw.amount ?? "0").toString().trim() || "0");
+        clm = BigInt((rw.claimed ?? "0").toString().trim() || "0");
+      } catch {
+        continue;
+      }
+      if (amt <= clm) continue;
+      let tokenAddr;
+      try {
+        tokenAddr = getAddress((rw.token?.address ?? "").trim());
+      } catch {
+        continue;
+      }
+      const proofsRaw = rw.proofs ?? [];
+      const proofs = [];
+      for (const p of proofsRaw) {
+        const h = normHex32(String(p));
+        if (!h) continue;
+        proofs.push(h);
+      }
+      if (proofsRaw.length > 0 && proofs.length !== proofsRaw.length) continue;
+      const sym = (rw.token?.symbol ?? "").trim() || "\u2014";
+      let dec = 18;
+      try {
+        const d = Number(rw.token?.decimals ?? 18);
+        if (Number.isFinite(d) && d >= 0 && d <= 36) dec = d;
+      } catch {
+        dec = 18;
+      }
+      collected.push({ root, token: tokenAddr, amountWei: amt, proofs, symbol: sym, decimals: dec });
+    }
+  }
+  return collected;
+}
+function selectFirstRootMerklLeaves(collected) {
+  if (collected.length === 0) return [];
+  const root0 = collected[0].root;
+  return collected.filter((x) => x.root === root0);
+}
+function isMerklRewardEulLeaf(leaf) {
+  const s = leaf.symbol.trim().toLowerCase().replace(/\s+/g, " ").trim();
+  return s === "reul" || s === "reward eul";
+}
+function selectWalletWideMerklClaimLeaves(collected) {
+  return selectFirstRootMerklLeaves(collected.filter((l) => !isMerklRewardEulLeaf(l)));
+}
+async function fetchAllMerklDistributorClaimLeaves(args) {
+  const raw = await loadMerklUserRewardsJson(args);
+  return parseMerklUserRewardsToLeaves(raw, args);
+}
+function encodeMerklDistributorClaimData(args) {
+  if (args.leaves.length === 0) throw new Error("No Merkl claim leaves.");
+  const u = getAddress(args.user);
+  const abi = parseAbi([
+    "function claim(address[] users, address[] tokens, uint256[] amounts, bytes32[][] proofs) external"
+  ]);
+  const users = args.leaves.map(() => u);
+  const tokens = args.leaves.map((l) => l.token);
+  const amounts = args.leaves.map((l) => l.amountWei);
+  const proofs = args.leaves.map((l) => [...l.proofs]);
+  return encodeFunctionData({
+    abi,
+    functionName: "claim",
+    args: [users, tokens, amounts, proofs]
+  });
+}
+function merklLeafToRow(leaf) {
+  return {
+    symbol: leaf.symbol,
+    token: leaf.token,
+    amountHuman: formatUnits(leaf.amountWei, leaf.decimals),
+    amountWei: leaf.amountWei.toString(),
+    decimals: leaf.decimals,
+    root: leaf.root
+  };
+}
+async function fetchMerklRewardsSummary(args) {
+  const user = getAddress(args.user);
+  const chainId = args.chainId;
+  const all = await fetchAllMerklDistributorClaimLeaves({ chainId, user });
+  const skippedReulCount = all.filter(isMerklRewardEulLeaf).length;
+  const display = all.filter((l) => !isMerklRewardEulLeaf(l));
+  const firstRoot = selectFirstRootMerklLeaves(display);
+  const roots = new Set(display.map((l) => l.root));
+  return {
+    chainId,
+    user,
+    distributor: MERKL_DISTRIBUTOR_ADDRESS,
+    claimable: display.map(merklLeafToRow),
+    claimableCount: display.length,
+    firstRootClaimableCount: firstRoot.length,
+    additionalRoots: Math.max(0, roots.size - (firstRoot.length > 0 ? 1 : 0)),
+    skippedReulCount,
+    notes: MERKL_REWARDS_NOTES
+  };
+}
+
+// src/protocols/evm/aave-v4/merklRewards.ts
+async function aaveV4FetchMerklRewardsSummary(args) {
+  return fetchMerklRewardsSummary(args);
+}
 
 // src/protocols/evm/aave-v4/index.ts
 var AAVE_V4_PROTOCOL_ID = "aave-v4";
@@ -2560,11 +2747,13 @@ var aaveV4ProtocolModule = {
     { id: "aave-v4.deposit", protocolId: AAVE_V4_PROTOCOL_ID, chainCategory: "evm", description: "Supply to Aave v4 Spoke", commonParams: ["keyGen", "purposeText", "useCustomGas"], params: {} },
     { id: "aave-v4.withdraw", protocolId: AAVE_V4_PROTOCOL_ID, chainCategory: "evm", description: "Withdraw from Spoke", commonParams: ["keyGen", "purposeText", "useCustomGas"], params: {} },
     { id: "aave-v4.borrow", protocolId: AAVE_V4_PROTOCOL_ID, chainCategory: "evm", description: "Borrow from Spoke", commonParams: ["keyGen", "purposeText", "useCustomGas"], params: {} },
-    { id: "aave-v4.repay", protocolId: AAVE_V4_PROTOCOL_ID, chainCategory: "evm", description: "Repay Spoke debt", commonParams: ["keyGen", "purposeText", "useCustomGas"], params: {} }
+    { id: "aave-v4.repay", protocolId: AAVE_V4_PROTOCOL_ID, chainCategory: "evm", description: "Repay Spoke debt", commonParams: ["keyGen", "purposeText", "useCustomGas"], params: {} },
+    { id: "aave-v4.fetch-merkl-rewards", protocolId: AAVE_V4_PROTOCOL_ID, chainCategory: "evm", description: "List wallet-wide Merkl claimables on a chain", commonParams: [], params: {} },
+    { id: "aave-v4.merkl-claim", protocolId: AAVE_V4_PROTOCOL_ID, chainCategory: "evm", description: "Claim wallet-wide Merkl rewards", commonParams: ["keyGen", "purposeText", "useCustomGas"], params: {} }
   ]
 };
 registerProtocolModule(aaveV4ProtocolModule);
 
-export { AAVE_V4_GRAPHQL_URL, AAVE_V4_PROTOCOL_ID, AAVE_V4_SPOKE_BORROW_DEFAULT_GAS_UNITS, AAVE_V4_SPOKE_REPAY_DEFAULT_GAS_UNITS, AAVE_V4_SPOKE_SUPPLY_DEFAULT_GAS_UNITS, AAVE_V4_SPOKE_WITHDRAW_DEFAULT_GAS_UNITS, MIN_AAVE_V4_DEPOSIT_GAS_EXEC, aaveAvailableLiquidityDisplay, aaveReadSupplyMetrics, aaveUnderlyingAddressForContext, aaveV4BorrowHealthGate, aaveV4FetchMarketSummary, aaveV4FetchMarketsSummary, aaveV4Gql, aaveV4KeyForNodeAssetRow, aaveV4MarketRowFromHubReserve, aaveV4ProtocolModule, aaveV4RepayHealthGate, aaveV4UiMarketIdForHubName, aaveV4UserHasAvailableBorrowCollateralForContextOnSpoke, aaveV4WithdrawHealthGate, aggregateV4SupplyDisplay, borrowableAssetsFromHubReserves, buildAaveV4BorrowTableRowsFromHub, buildEvmMultisignBodyAaveV4DepositBatch, buildEvmMultisignBodyAaveV4MerklClaimRewards, buildEvmMultisignBodyAaveV4SpokeBorrow, buildEvmMultisignBodyAaveV4SpokeRepay, buildEvmMultisignBodyAaveV4SpokeWithdraw, buildEvmMultisignBodyEulerV2MerklDistributorClaim, buildEvmMultisignBodyEulerV2ReulUnlock, ensureAaveV4ChainTokenCache, fetchAaveV4Chains, fetchAaveV4ClaimRewardsCalldata, fetchAaveV4HubReserves, fetchAaveV4HubsForChain, fetchAaveV4MerklClaimRewardIdsForChain, fetchAaveV4MerklClaimableRewardsForChain, fetchAaveV4NativeWrappedToken, fetchAaveV4ReservesForUnderlying, fetchAaveV4SpokeReserveIdForUnderlying, fetchAaveV4SpokeReserveStatusForUnderlying, fetchAaveV4SupportedUnderlyingAddressSet, fetchAaveV4UserBorrowsDebtByUnderlyingForHub, fetchAaveV4UserPositionById, fetchAaveV4UserPositionsByAssetOnChain, fetchAaveV4UserPositionsForChain, fetchAaveV4UserSuppliesForPosition, filterActiveAaveV4HubReserves, findAaveV4HubReserveForChainUnderlying, findHubReserveForUnderlying, formatAavePercentDisplay, formatAaveV4AmountHumanFromApiString, formatAaveV4ApyPercentLabel, formatAaveV4DecimalString, formatAaveV4ExchangeLabel, formatAaveV4HealthFactor, formatAaveV4PercentDisplay, formatAaveV4PositionHealthFactor, formatAaveV4PositionPercent, formatAaveV4ReserveLiquidityFromSummary, formatAaveV4RiskDisplay, formatAaveV4RiskNotionalString, formatAaveV4TokenAmount, isAaveV4DepositEvmSignRequest, isAaveV4HubReserveActive, isValidAaveChainId, loadAaveV4SupportedChainIds, loadAaveV4SupportedChainIdsFromV4Api, parseAaveV4ApyPercent, parseBigDecimalHf, pickAaveV4ReserveRowForSpoke, previewAaveV4BorrowResultingHf, previewAaveV4RepayResultingHf, previewAaveV4WithdrawResultingHf, resolveAaveV4DepositGasUnitsFromSignRequest, resolveAaveV4HubForUiMarket };
+export { AAVE_V4_GRAPHQL_URL, AAVE_V4_PROTOCOL_ID, AAVE_V4_SPOKE_BORROW_DEFAULT_GAS_UNITS, AAVE_V4_SPOKE_REPAY_DEFAULT_GAS_UNITS, AAVE_V4_SPOKE_SUPPLY_DEFAULT_GAS_UNITS, AAVE_V4_SPOKE_WITHDRAW_DEFAULT_GAS_UNITS, MERKL_API_BASE, MERKL_DISTRIBUTOR_ADDRESS, MERKL_DISTRIBUTOR_CLAIM_GAS_FALLBACK, MERKL_REWARDS_NOTES, MIN_AAVE_V4_DEPOSIT_GAS_EXEC, aaveAvailableLiquidityDisplay, aaveReadSupplyMetrics, aaveUnderlyingAddressForContext, aaveV4BorrowHealthGate, aaveV4FetchMarketSummary, aaveV4FetchMarketsSummary, aaveV4FetchMerklRewardsSummary, aaveV4Gql, aaveV4KeyForNodeAssetRow, aaveV4MarketRowFromHubReserve, aaveV4ProtocolModule, aaveV4RepayHealthGate, aaveV4UiMarketIdForHubName, aaveV4UserHasAvailableBorrowCollateralForContextOnSpoke, aaveV4WithdrawHealthGate, aggregateV4SupplyDisplay, borrowableAssetsFromHubReserves, buildAaveV4BorrowTableRowsFromHub, buildEvmMultisignBodyAaveV4DepositBatch, buildEvmMultisignBodyAaveV4MerklClaimRewards, buildEvmMultisignBodyAaveV4MerklDistributorClaim, buildEvmMultisignBodyAaveV4SpokeBorrow, buildEvmMultisignBodyAaveV4SpokeRepay, buildEvmMultisignBodyAaveV4SpokeWithdraw, buildEvmMultisignBodyEulerV2MerklDistributorClaim, buildEvmMultisignBodyEulerV2ReulUnlock, encodeMerklDistributorClaimData, ensureAaveV4ChainTokenCache, fetchAaveV4Chains, fetchAaveV4ClaimRewardsCalldata, fetchAaveV4HubReserves, fetchAaveV4HubsForChain, fetchAaveV4MerklClaimRewardIdsForChain, fetchAaveV4MerklClaimableRewardsForChain, fetchAaveV4NativeWrappedToken, fetchAaveV4ReservesForUnderlying, fetchAaveV4SpokeReserveIdForUnderlying, fetchAaveV4SpokeReserveStatusForUnderlying, fetchAaveV4SupportedUnderlyingAddressSet, fetchAaveV4UserBorrowsDebtByUnderlyingForHub, fetchAaveV4UserPositionById, fetchAaveV4UserPositionsByAssetOnChain, fetchAaveV4UserPositionsForChain, fetchAaveV4UserSuppliesForPosition, fetchAllMerklDistributorClaimLeaves, fetchMerklRewardsSummary, filterActiveAaveV4HubReserves, findAaveV4HubReserveForChainUnderlying, findHubReserveForUnderlying, formatAavePercentDisplay, formatAaveV4AmountHumanFromApiString, formatAaveV4ApyPercentLabel, formatAaveV4DecimalString, formatAaveV4ExchangeLabel, formatAaveV4HealthFactor, formatAaveV4PercentDisplay, formatAaveV4PositionHealthFactor, formatAaveV4PositionPercent, formatAaveV4ReserveLiquidityFromSummary, formatAaveV4RiskDisplay, formatAaveV4RiskNotionalString, formatAaveV4TokenAmount, isAaveV4DepositEvmSignRequest, isAaveV4HubReserveActive, isMerklRewardEulLeaf, isValidAaveChainId, loadAaveV4SupportedChainIds, loadAaveV4SupportedChainIdsFromV4Api, loadMerklUserRewardsJson, merklLeafToRow, merklUserRewardsUrl, parseAaveV4ApyPercent, parseBigDecimalHf, parseMerklUserRewardsToLeaves, pickAaveV4ReserveRowForSpoke, previewAaveV4BorrowResultingHf, previewAaveV4RepayResultingHf, previewAaveV4WithdrawResultingHf, resolveAaveV4DepositGasUnitsFromSignRequest, resolveAaveV4HubForUiMarket, selectFirstRootMerklLeaves, selectWalletWideMerklClaimLeaves };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map