@moly-mcp/lido 1.0.6 → 1.0.8

package/dist/{session-RFQTJ6WZ.js → session-37TYTCEU.js}

@@ -1,27 +1,57 @@
 #!/usr/bin/env node
+import {
+  getSettings,
+  stakeEth,
+  updateSettings
+} from "./chunk-CQ6ZSCMZ.js";
 import {
   castVote,
   claimWithdrawals,
-  getBalance,
-  getConversionRate,
   getProposal,
   getProposals,
-  getRewards,
-  getSettings,
   getWithdrawalRequests,
   getWithdrawalStatus,
-  requestWithdrawal,
-  stakeEth,
+  requestWithdrawal
+} from "./chunk-EQYEWCQO.js";
+import {
+  configureAlertChannels,
+  listAlerts,
+  removeAlertById,
+  setAlert
+} from "./chunk-6UIRFWG4.js";
+import "./chunk-6F64RPQQ.js";
+import {
+  bridgeToEthereum,
+  getBridgeQuote,
+  getBridgeStatus,
+  getL2Balance,
+  getTotalPosition
+} from "./chunk-GL6TLHSF.js";
+import {
+  getBalance,
+  getConversionRate,
+  getRewards,
   unwrapWsteth,
-  updateSettings,
   wrapSteth
-} from "./chunk-RE3UIDLV.js";
-import "./chunk-PIFEXJ56.js";
+} from "./chunk-EKZFGIVK.js";
+import "./chunk-P6VFMSPM.js";
+import {
+  loadBounds,
+  saveBounds
+} from "./chunk-CH4MXPWS.js";
+import {
+  initLedger,
+  ledgerStats,
+  logEntry,
+  queryLedger
+} from "./chunk-RR74UAKD.js";
+import "./chunk-PDX44BCA.js";
 
 // src/chat/session.ts
 import * as readline from "readline";
 import * as fs from "fs";
 import * as path from "path";
+import { fileURLToPath } from "url";
 
 // src/chat/providers.ts
 async function callAnthropic(apiKey, model, messages, tools) {
@@ -325,14 +355,158 @@ var TOOL_DEFS = [
   },
   {
     name: "update_settings",
-    description: "Change mode, network, or RPC.",
+    description: "Change mode, network, RPC, or chain scope.",
     parameters: {
       type: "object",
       properties: {
         network: { type: "string", enum: ["hoodi", "mainnet"] },
         mode: { type: "string", enum: ["simulation", "live"] },
         rpc: { type: "string", nullable: true },
-        model: { type: "string" }
+        model: { type: "string" },
+        chain_scope: { type: "string", enum: ["ethereum", "all"], description: "ethereum = L1 only, all = L1 + Base/Arbitrum bridging" }
+      }
+    }
+  },
+  {
+    name: "get_l2_balance",
+    description: "Get ETH and wstETH balances on Base or Arbitrum L2. Mainnet only.",
+    parameters: {
+      type: "object",
+      required: ["source_chain"],
+      properties: {
+        source_chain: { type: "string", enum: ["base", "arbitrum"], description: "L2 chain to query" },
+        address: { type: "string", description: "Address to check (optional, defaults to wallet)" }
+      }
+    }
+  },
+  {
+    name: "get_bridge_quote",
+    description: "Get a quote for bridging ETH or wstETH from an L2 to Ethereum L1 via LI.FI. Mainnet only.",
+    parameters: {
+      type: "object",
+      required: ["source_chain", "token", "amount"],
+      properties: {
+        source_chain: { type: "string", enum: ["base", "arbitrum"] },
+        token: { type: "string", enum: ["ETH", "wstETH"], description: "Token to bridge" },
+        amount: { type: "string", description: 'Amount to bridge (e.g. "0.1")' },
+        to_token: { type: "string", enum: ["ETH", "wstETH"], description: "Token to receive on L1 (default ETH)" }
+      }
+    }
+  },
+  {
+    name: "bridge_to_ethereum",
+    description: "Bridge ETH or wstETH from Base/Arbitrum to Ethereum L1 via LI.FI. Mainnet only.",
+    parameters: {
+      type: "object",
+      required: ["source_chain", "token", "amount"],
+      properties: {
+        source_chain: { type: "string", enum: ["base", "arbitrum"] },
+        token: { type: "string", enum: ["ETH", "wstETH"] },
+        amount: { type: "string", description: "Amount to bridge" },
+        to_token: { type: "string", enum: ["ETH", "wstETH"] },
+        dry_run: { type: "boolean", description: "Simulate without broadcasting" }
+      }
+    }
+  },
+  {
+    name: "get_bridge_status",
+    description: "Check the status of an in-progress bridge transaction. Mainnet only.",
+    parameters: {
+      type: "object",
+      required: ["tx_hash", "source_chain"],
+      properties: {
+        tx_hash: { type: "string", description: "Bridge transaction hash on the L2" },
+        source_chain: { type: "string", enum: ["base", "arbitrum"] }
+      }
+    }
+  },
+  {
+    name: "set_alert",
+    description: "Create a new alert. Conditions: balance_below, balance_above, reward_rate_below, reward_rate_above, withdrawal_ready, proposal_new, conversion_rate_above, conversion_rate_below.",
+    parameters: {
+      type: "object",
+      required: ["condition"],
+      properties: {
+        condition: { type: "string", description: "Alert condition type" },
+        threshold: { type: "number", description: "Numeric threshold (required for _above/_below conditions)" },
+        channel: { type: "string", enum: ["telegram", "webhook"], description: "Notification channel (default: telegram)" }
+      }
+    }
+  },
+  {
+    name: "list_alerts",
+    description: "List all configured alerts.",
+    parameters: { type: "object", properties: {} }
+  },
+  {
+    name: "remove_alert",
+    description: "Remove an alert by ID.",
+    parameters: {
+      type: "object",
+      required: ["id"],
+      properties: { id: { type: "string", description: "Alert ID to remove" } }
+    }
+  },
+  {
+    name: "configure_alert_channels",
+    description: "Configure Telegram and/or webhook notification channels for alerts.",
+    parameters: {
+      type: "object",
+      properties: {
+        telegram_token: { type: "string", description: "Telegram bot token" },
+        telegram_chat_id: { type: "string", description: "Telegram chat ID" },
+        webhook_url: { type: "string", description: "Webhook URL for HTTP POST notifications" }
+      }
+    }
+  },
+  {
+    name: "get_total_position",
+    description: "Aggregated cross-chain position: ETH, stETH, wstETH across Ethereum + Base + Arbitrum, all converted to ETH equivalent.",
+    parameters: {
+      type: "object",
+      properties: {
+        address: { type: "string", description: "Ethereum address (optional)" }
+      }
+    }
+  },
+  {
+    name: "get_bounds",
+    description: "Get current policy bounds (max stake per tx, daily limit, min ETH reserve, governance auto-vote).",
+    parameters: { type: "object", properties: {} }
+  },
+  {
+    name: "set_bounds",
+    description: "Update policy bounds that gate write operations.",
+    parameters: {
+      type: "object",
+      properties: {
+        maxStakePerTx: { type: "number", description: "Max ETH per single stake" },
+        maxDailyStake: { type: "number", description: "Max ETH staked per day" },
+        minEthReserve: { type: "number", description: "Min ETH to keep unstaked for gas" },
+        autoRestakeThreshold: { type: "number", description: "Auto-restake rewards threshold in ETH" },
+        governanceAutoVote: { type: "boolean", description: "Allow agent to auto-vote on proposals" }
+      }
+    }
+  },
+  {
+    name: "get_trade_history",
+    description: "Query the activity ledger with filters.",
+    parameters: {
+      type: "object",
+      properties: {
+        tool: { type: "string", description: "Filter by tool name (e.g. stake_eth)" },
+        since: { type: "string", description: "ISO date to filter from (e.g. 2026-01-01)" },
+        limit: { type: "number", description: "Max results (default 50)" }
+      }
+    }
+  },
+  {
+    name: "get_staking_summary",
+    description: "Aggregate stats from the activity ledger: total operations, staked ETH, errors.",
+    parameters: {
+      type: "object",
+      properties: {
+        since: { type: "string", description: "ISO date to filter from (optional)" }
       }
     }
   }
@@ -386,6 +560,54 @@ async function executeTool(name, args) {
       case "update_settings":
         result = updateSettings(args);
         break;
+      case "get_l2_balance":
+        result = await getL2Balance(args.source_chain, args.address);
+        break;
+      case "get_bridge_quote":
+        result = await getBridgeQuote(args.source_chain, args.token, args.amount, args.to_token);
+        break;
+      case "bridge_to_ethereum":
+        result = await bridgeToEthereum(args.source_chain, args.token, args.amount, args.to_token, args.dry_run);
+        break;
+      case "get_bridge_status":
+        result = await getBridgeStatus(args.tx_hash, args.source_chain);
+        break;
+      case "set_alert":
+        result = setAlert(args);
+        break;
+      case "list_alerts":
+        result = listAlerts();
+        break;
+      case "remove_alert":
+        result = removeAlertById(args.id);
+        break;
+      case "configure_alert_channels":
+        result = configureAlertChannels(args);
+        break;
+      case "get_total_position":
+        result = await getTotalPosition(args.address);
+        break;
+      case "get_bounds":
+        result = loadBounds();
+        break;
+      case "set_bounds": {
+        const current = loadBounds();
+        const patch = args;
+        if (patch.maxStakePerTx !== void 0) current.maxStakePerTx = patch.maxStakePerTx;
+        if (patch.maxDailyStake !== void 0) current.maxDailyStake = patch.maxDailyStake;
+        if (patch.minEthReserve !== void 0) current.minEthReserve = patch.minEthReserve;
+        if (patch.autoRestakeThreshold !== void 0) current.autoRestakeThreshold = patch.autoRestakeThreshold;
+        if (patch.governanceAutoVote !== void 0) current.governanceAutoVote = patch.governanceAutoVote;
+        saveBounds(current);
+        result = current;
+        break;
+      }
+      case "get_trade_history":
+        result = queryLedger({ tool: args.tool, since: args.since, limit: args.limit });
+        break;
+      case "get_staking_summary":
+        result = ledgerStats(args.since);
+        break;
       default:
         return `Unknown tool: ${name}`;
     }
@@ -395,6 +617,50 @@ async function executeTool(name, args) {
   }
 }
 
+// src/bounds/enforce.ts
+var STAKE_TOOLS = /* @__PURE__ */ new Set(["stake_eth", "bridge_to_ethereum"]);
+async function checkBounds(toolName, args) {
+  const bounds = loadBounds();
+  const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+  if (bounds.lastResetDate !== today) {
+    bounds.dailyStaked = 0;
+    bounds.lastResetDate = today;
+    saveBounds(bounds);
+  }
+  if (toolName === "cast_vote" && !bounds.governanceAutoVote) {
+    return { allowed: false, reason: `Governance auto-vote is disabled. Set bounds: governanceAutoVote = true` };
+  }
+  if (STAKE_TOOLS.has(toolName)) {
+    const amount = parseFloat(args.amount_eth ?? args.amount ?? "0");
+    if (isNaN(amount) || amount <= 0) return { allowed: true };
+    if (amount > bounds.maxStakePerTx) {
+      return { allowed: false, reason: `Amount ${amount} ETH exceeds max per tx (${bounds.maxStakePerTx} ETH)` };
+    }
+    if (bounds.dailyStaked + amount > bounds.maxDailyStake) {
+      return { allowed: false, reason: `Would exceed daily limit: staked today ${bounds.dailyStaked.toFixed(4)} + ${amount} > ${bounds.maxDailyStake} ETH` };
+    }
+    try {
+      const bal = await getBalance();
+      const ethBal = parseFloat(bal.balances.eth);
+      if (ethBal - amount < bounds.minEthReserve) {
+        return { allowed: false, reason: `Would leave only ${(ethBal - amount).toFixed(4)} ETH, below reserve of ${bounds.minEthReserve} ETH` };
+      }
+    } catch {
+    }
+  }
+  return { allowed: true };
+}
+function recordStake(amount) {
+  const bounds = loadBounds();
+  const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+  if (bounds.lastResetDate !== today) {
+    bounds.dailyStaked = 0;
+    bounds.lastResetDate = today;
+  }
+  bounds.dailyStaked += amount;
+  saveBounds(bounds);
+}
+
 // src/chat/session.ts
 var R = "\x1B[0m";
 var B = "\x1B[1m";
@@ -412,30 +678,39 @@ ${CY}${B}  \u2588\u2588\u2554\u2588\u2588\u2588\u2588\u2554\u2588\u2588\u2551\u2
 ${CY}${B}  \u2588\u2588\u2551\u255A\u2588\u2588\u2554\u255D\u2588\u2588\u2551\u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2551    \u255A\u2588\u2588\u2554\u255D  ${R}
 ${CY}${B}  \u2588\u2588\u2551 \u255A\u2550\u255D \u2588\u2588\u2551\u255A\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2551   ${R}
 ${CY}${B}  \u255A\u2550\u255D     \u255A\u2550\u255D \u255A\u2550\u2550\u2550\u2550\u2550\u255D \u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u255D   ${R}
-${D}              powered by Lido \u2B21${R}
+${D}              powered by Lido${R}
 `;
 function ln(text = "") {
   process.stdout.write(text + "\n");
 }
+function printResponse(text) {
+  const lines = text.split("\n");
+  const prefix = `${B}${GR}moly${R} \u203A `;
+  const indent = "       ";
+  ln();
+  lines.forEach((line, i) => {
+    process.stdout.write((i === 0 ? prefix : indent) + line + "\n");
+  });
+  ln();
+}
 function saveTrade(toolName, args, result) {
   try {
-    const tradesDir = path.join(process.cwd(), "trades");
-    if (!fs.existsSync(tradesDir)) fs.mkdirSync(tradesDir, { recursive: true });
-    const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
-    const file = path.join(tradesDir, `${today}.jsonl`);
-    const record = JSON.stringify({
-      ts: (/* @__PURE__ */ new Date()).toISOString(),
+    let txHash;
+    let amount;
+    try {
+      const parsed = JSON.parse(result);
+      txHash = parsed.txHash ?? parsed.tx_hash;
+      amount = args.amount_eth ?? args.amount_steth ?? args.amount;
+    } catch {
+    }
+    logEntry({
       tool: toolName,
       args,
-      result: (() => {
-        try {
-          return JSON.parse(result);
-        } catch {
-          return result;
-        }
-      })()
+      result,
+      tx_hash: txHash,
+      amount,
+      status: "ok"
     });
-    fs.appendFileSync(file, record + "\n");
   } catch {
   }
 }
@@ -453,18 +728,44 @@ var WRITE_TOOLS = /* @__PURE__ */ new Set([
   "claim_withdrawals",
   "wrap_steth",
   "unwrap_wsteth",
-  "cast_vote"
+  "cast_vote",
+  "bridge_to_ethereum"
 ]);
 async function startChatSession(cfg) {
   if (!cfg.ai) {
     ln(`${RE}No AI provider configured. Run: moly setup${R}`);
     process.exit(1);
   }
+  try {
+    initLedger();
+  } catch {
+  }
   const { provider, apiKey, model } = cfg.ai;
+  let skillContext = "";
+  try {
+    const skillPath = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../../lido.skill.md");
+    if (fs.existsSync(skillPath)) {
+      skillContext = fs.readFileSync(skillPath, "utf-8") + "\n\n";
+    }
+  } catch {
+  }
   const messages = [
     {
       role: "user",
-      content: `You are Moly, a terminal assistant for Lido Finance on ${cfg.network}. Mode: ${cfg.mode} (${cfg.mode === "simulation" ? "dry-run, nothing broadcast" : "LIVE - real on-chain transactions"}). You can only do what your tools support: staking ETH, withdrawals, wrap/unwrap stETH/wstETH, balances, rewards, and Lido DAO governance. If asked about anything outside those tools (e.g. Lido Vaults, validators, node operators, DeFi integrations), say clearly and briefly that it is not supported. IMPORTANT: This is a terminal. Never use markdown. No **bold**, no bullet points, no headers, no backticks. Plain text only. Be concise. For live transactions always confirm first.`
+      content: skillContext + `You are Moly, a terminal assistant for Lido Finance on ${cfg.network}.
+Mode: ${cfg.mode} (${cfg.mode === "simulation" ? "dry-run, nothing broadcast" : "LIVE - real on-chain transactions"}).
+Chain scope: ${cfg.chainScope ?? "ethereum"}.
+
+You can only do what your tools support: staking ETH, withdrawals, wrap/unwrap stETH/wstETH, balances, rewards, Lido DAO governance${cfg.chainScope === "all" ? ", and L2 bridging from Base/Arbitrum to Ethereum via LI.FI" : ""}.
+${cfg.chainScope === "all" ? "If the user wants to stake ETH from Base or Arbitrum, first check their L2 balance with get_l2_balance, then bridge to Ethereum with bridge_to_ethereum, then after bridging completes use stake_eth. Bridge takes 1-20 min, tell user to check with get_bridge_status.\n" : ""}If asked about anything outside those tools (e.g. Lido Vaults, validators, node operators, DeFi integrations), say clearly and briefly that it is not supported.
+
+OUTPUT FORMAT RULES (terminal, no markdown):
+- Never use **bold**, _italic_, # headers, or backtick code blocks.
+- Use plain dashes (-) for lists, one item per line.
+- Use blank lines to separate sections or groups of information.
+- For key/value data (balances, settings, etc.) use "  key: value" format, one per line.
+- Keep prose concise. Lead with the answer, then details.
+- For live transactions always confirm with the user first.`
     },
     {
       role: "assistant",
@@ -473,8 +774,8 @@ async function startChatSession(cfg) {
   ];
   printBanner(cfg);
   const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-  const prompt = () => new Promise((resolve, reject) => {
-    rl.question(`${B}${BL}you${R} \u203A `, resolve);
+  const prompt = () => new Promise((resolve2, reject) => {
+    rl.question(`${B}${BL}you${R} \u203A `, resolve2);
     rl.once("close", () => reject(new Error("closed")));
   });
   while (true) {
@@ -500,25 +801,38 @@ async function startChatSession(cfg) {
           const toolResults = [];
           for (const tc of response.toolCalls) {
             ln(`${D}  \u21B3  ${MA}${tc.name}${R}${D} ${JSON.stringify(tc.args)}${R}`);
+            if (WRITE_TOOLS.has(tc.name)) {
+              try {
+                const check = await checkBounds(tc.name, tc.args);
+                if (!check.allowed) {
+                  ln(`${RE}  \u2715  BLOCKED: ${check.reason}${R}`);
+                  toolResults.push(makeToolResultMessage(provider, tc.id, tc.name, JSON.stringify({ blocked: true, reason: check.reason })));
+                  continue;
+                }
+              } catch {
+              }
+            }
             const result = await executeTool(tc.name, tc.args);
             ln(`${D}     ${result.slice(0, 300)}${result.length > 300 ? "\u2026" : ""}${R}`);
             if (WRITE_TOOLS.has(tc.name)) {
               saveTrade(tc.name, tc.args, result);
+              if (tc.name === "stake_eth" && tc.args.amount_eth) {
+                try {
+                  recordStake(parseFloat(tc.args.amount_eth));
+                } catch {
+                }
+              }
             }
             toolResults.push(makeToolResultMessage(provider, tc.id, tc.name, result));
           }
           messages.push(...toolResults);
           if (response.text) {
-            ln();
-            ln(`${B}${GR}moly${R} \u203A ${response.text}`);
-            ln();
+            printResponse(response.text);
           }
           continue;
         }
         if (response.text) {
-          ln();
-          ln(`${B}${GR}moly${R} \u203A ${response.text}`);
-          ln();
+          printResponse(response.text);
         }
         break;
       }

package/dist/store-5CEITPDY.js

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+import {
+  DEFAULT_BOUNDS,
+  loadBounds,
+  resetBounds,
+  saveBounds
+} from "./chunk-CH4MXPWS.js";
+import "./chunk-PDX44BCA.js";
+export {
+  DEFAULT_BOUNDS,
+  loadBounds,
+  resetBounds,
+  saveBounds
+};

package/dist/store-SKFUVSK4.js

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+import {
+  addAlert,
+  loadAlerts,
+  loadChannelConfig,
+  removeAlert,
+  saveAlerts,
+  saveChannelConfig
+} from "./chunk-6F64RPQQ.js";
+import "./chunk-P6VFMSPM.js";
+import "./chunk-PDX44BCA.js";
+export {
+  addAlert,
+  loadAlerts,
+  loadChannelConfig,
+  removeAlert,
+  saveAlerts,
+  saveChannelConfig
+};

package/dist/store-WRLUM7OW.js

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+import {
+  exportLedger,
+  initLedger,
+  ledgerStats,
+  logEntry,
+  queryLedger
+} from "./chunk-RR74UAKD.js";
+import "./chunk-PDX44BCA.js";
+export {
+  exportLedger,
+  initLedger,
+  ledgerStats,
+  logEntry,
+  queryLedger
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moly-mcp/lido",
-  "version": "1.0.6",
+  "version": "1.0.8",
   "description": "Lido MCP Server — stake, unstake, wrap, govern. Works with Claude Desktop, Cursor, Windsurf, and any MCP client.",
   "license": "MIT",
   "type": "module",
@@ -23,10 +23,15 @@
     "@clack/prompts": "^0.9.1",
     "@lidofinance/lido-ethereum-sdk": "^4.7.0",
     "@modelcontextprotocol/sdk": "^1.27.1",
+    "better-sqlite3": "^11.7.0",
     "viem": "^2.47.4",
     "zod": "^3.24.0"
   },
+  "optionalDependencies": {
+    "@open-wallet-standard/core": "^0.1.0"
+  },
   "devDependencies": {
+    "@types/better-sqlite3": "^7.6.12",
     "@types/node": "^20",
     "tsup": "^8.4.0",
     "typescript": "^5"