kinetic-mcp 1.3.1 → 1.3.2

package/scripts/setup.mjs

@@ -1,760 +1,779 @@
-#!/usr/bin/env node
-
-/**
- * Interactive setup wizard for Kinetic MCP Server.
- *
- * Run: npx kinetic-mcp setup
- *
- * This is a standalone .mjs file — no compilation required.
- * Uses @clack/prompts for beautiful terminal UI.
- */
-
-import {
-  readFileSync,
-  writeFileSync,
-  existsSync,
-  mkdirSync,
-  chmodSync,
-  copyFileSync,
-} from "node:fs";
-import { homedir } from "node:os";
-import { join, resolve, dirname } from "node:path";
-import { execSync } from "node:child_process";
-import { platform, execPath } from "node:process";
-import { createRequire } from "node:module";
-
-import { Keypair } from "@solana/web3.js";
-import bs58 from "bs58";
-import * as p from "@clack/prompts";
-import pc from "picocolors";
-
-// ---------------------------------------------------------------------------
-// Version
-// ---------------------------------------------------------------------------
-
-const require = createRequire(import.meta.url);
-const { version } = require("../package.json");
-
-// ---------------------------------------------------------------------------
-// Non-TTY check
-// ---------------------------------------------------------------------------
-
-if (!process.stdin.isTTY) {
-  console.error("Error: Setup wizard requires an interactive terminal.");
-  console.error("Run: npx kinetic-mcp setup");
-  process.exit(1);
-}
-
-// ---------------------------------------------------------------------------
-// ASCII Banner
-// ---------------------------------------------------------------------------
-
-const BANNER = `
- ██╗  ██╗██╗███╗   ██╗███████╗████████╗██╗ ██████╗
- ██║ ██╔╝██║████╗  ██║██╔════╝╚══██╔══╝██║██╔════╝
- █████╔╝ ██║██╔██╗ ██║█████╗     ██║   ██║██║
- ██╔═██╗ ██║██║╚██╗██║██╔══╝     ██║   ██║██║
- ██║  ██╗██║██║ ╚████║███████╗   ██║   ██║╚██████╗
- ╚═╝  ╚═╝╚═╝╚═╝  ╚═══╝╚══════╝   ╚═╝   ╚═╝ ╚═════╝`;
-
-async function renderBanner() {
-  let rendered;
-  try {
-    const gradient = (await import("gradient-string")).default;
-    const kineticGradient = gradient(["#FEDA75", "#FA7E1E", "#D62976", "#962FBF", "#4F5BD5"]);
-    rendered = kineticGradient.multiline(BANNER);
-  } catch {
-    rendered = pc.bold(pc.magenta(BANNER));
-  }
-
-  console.log(rendered);
-  console.log(pc.dim(`  v${version} — Solana Trading via Claude Desktop`));
-  console.log();
-}
-
-// ---------------------------------------------------------------------------
-// Helpers
-// ---------------------------------------------------------------------------
-
-function handleCancel(value) {
-  if (p.isCancel(value)) {
-    p.cancel("Setup cancelled.");
-    process.exit(0);
-  }
-  return value;
-}
-
-function expandHome(filePath) {
-  if (filePath.startsWith("~/") || filePath.startsWith("~\\")) {
-    return resolve(homedir(), filePath.slice(2));
-  }
-  return filePath;
-}
-
-function isWSL() {
-  try {
-    const ver = readFileSync("/proc/version", "utf-8");
-    return /microsoft|wsl/i.test(ver);
-  } catch {
-    return false;
-  }
-}
-
-function getClaudeConfigPath() {
-  const home = homedir();
-  switch (platform) {
-    case "darwin":
-      return join(home, "Library", "Application Support", "Claude", "claude_desktop_config.json");
-    case "win32":
-      return join(
-        process.env.APPDATA || join(home, "AppData", "Roaming"),
-        "Claude",
-        "claude_desktop_config.json",
-      );
-    case "linux":
-      if (isWSL()) return null;
-      return join(home, ".config", "Claude", "claude_desktop_config.json");
-    default:
-      return null;
-  }
-}
-
-function getDefaultKeypairPath() {
-  return join(homedir(), ".config", "solana", "trading-keypair.json");
-}
-
-function validateKeypairFile(filePath) {
-  const expanded = expandHome(filePath);
-  if (!existsSync(expanded)) {
-    throw new Error(`File not found: ${expanded}`);
-  }
-  const raw = readFileSync(expanded, "utf-8");
-  let parsed;
-  try {
-    parsed = JSON.parse(raw);
-  } catch {
-    throw new Error(
-      "File is not valid JSON. Expected a JSON array of 64 integers (Solana CLI format).",
-    );
-  }
-  if (
-    !Array.isArray(parsed) ||
-    parsed.length !== 64 ||
-    !parsed.every((n) => typeof n === "number" && Number.isInteger(n))
-  ) {
-    throw new Error("Invalid Solana keypair. Expected a JSON array of exactly 64 integers.");
-  }
-  return Keypair.fromSecretKey(Uint8Array.from(parsed));
-}
-
-// ---------------------------------------------------------------------------
-// Step 2: Build Check
-// ---------------------------------------------------------------------------
-
-async function checkBuild() {
-  const buildExists = existsSync(resolve("build", "index.js"));
-  if (buildExists) return;
-
-  p.log.warn("Project hasn't been built yet — build/index.js not found.");
-
-  const runBuild = handleCancel(
-    await p.confirm({ message: "Run npm run build now?", initialValue: true }),
-  );
-
-  if (runBuild) {
-    const s = p.spinner();
-    s.start("Building project...");
-    try {
-      execSync("npm run build", { stdio: "pipe" });
-      s.stop("Build complete");
-    } catch {
-      s.stop("Build failed");
-      p.log.warn("You can try again later with: npm run build");
-    }
-  } else {
-    p.log.info("Skipped. Remember to run npm run build before using the server.");
-  }
-}
-
-// ---------------------------------------------------------------------------
-// Step 3: Keypair Setup
-// ---------------------------------------------------------------------------
-
-async function importFromPhantom() {
-  p.note(
-    [
-      `${pc.bold("How to export from Phantom:")}`,
-      "",
-      "1. Open Phantom → Settings → Manage Accounts → [Your Account] → Show Private Key",
-      "2. Enter your password and copy the base58 string",
-      "",
-      `${pc.dim("Your key will be masked. It is NOT saved to shell history.")}`,
-    ].join("\n"),
-    "Import Private Key",
-  );
-
-  const key = handleCancel(
-    await p.password({
-      message: "Paste your private key:",
-      mask: "*",
-      validate(value) {
-        if (!value || value.trim().length === 0) return "Private key is required.";
-
-        let decoded;
-        try {
-          decoded = bs58.decode(value.trim());
-        } catch {
-          return "Invalid format. Expected a base58-encoded string from Phantom.";
-        }
-
-        if (decoded.length !== 64) {
-          if (decoded.length === 32) {
-            return "This looks like a 32-byte seed. Use the Solana CLI to generate the full keypair.";
-          }
-          return `Expected 64-byte secret key, got ${decoded.length} bytes.`;
-        }
-      },
-    }),
-  );
-
-  const decoded = bs58.decode(key.trim());
-  const keypair = Keypair.fromSecretKey(decoded);
-
-  const publicKey = keypair.publicKey.toBase58();
-  p.log.info(`Wallet address: ${pc.cyan(publicKey)}`);
-  p.log.message(pc.dim("Verify this matches your Phantom wallet address."));
-
-  // Save keypair to default path
-  const defaultPath = getDefaultKeypairPath();
-
-  // Check if file exists
-  if (existsSync(defaultPath)) {
-    const overwrite = handleCancel(
-      await p.confirm({
-        message: `Keypair file already exists at ${pc.dim(defaultPath)}. Overwrite?`,
-        initialValue: false,
-      }),
-    );
-
-    if (!overwrite) {
-      p.log.info("Keeping existing keypair file.");
-      return { publicKey, path: defaultPath };
-    }
-  }
-
-  mkdirSync(dirname(defaultPath), { recursive: true, mode: 0o700 });
-  writeFileSync(defaultPath, JSON.stringify(Array.from(keypair.secretKey)) + "\n", { mode: 0o600 });
-
-  if (platform !== "win32") {
-    try {
-      chmodSync(defaultPath, 0o600);
-    } catch (err) {
-      p.log.warn(`Could not set file permissions: ${err.message}. Run: chmod 600 ${defaultPath}`);
-    }
-  }
-
-  p.log.success(`Keypair saved to ${pc.dim(defaultPath)}`);
-  return { publicKey, path: defaultPath };
-}
-
-async function useExistingKeypair() {
-  const filePath = handleCancel(
-    await p.text({
-      message: "Path to keypair file:",
-      placeholder: "~/.config/solana/id.json",
-      validate(value) {
-        if (!value || value.trim().length === 0) return "Path is required.";
-        try {
-          const expanded = expandHome(value.trim());
-          validateKeypairFile(expanded);
-        } catch (err) {
-          return err.message;
-        }
-      },
-    }),
-  );
-
-  const expanded = expandHome(filePath.trim());
-  const keypair = validateKeypairFile(expanded);
-  const publicKey = keypair.publicKey.toBase58();
-
-  p.log.info(`Wallet address: ${pc.cyan(publicKey)}`);
-
-  return { publicKey, path: expanded };
-}
-
-async function setupKeypair() {
-  const method = handleCancel(
-    await p.select({
-      message: "How would you like to set up your Solana keypair?",
-      options: [
-        {
-          value: "phantom",
-          label: "Import from Phantom",
-          hint: "paste your base58 private key",
-        },
-        {
-          value: "existing",
-          label: "Use existing keypair file",
-          hint: "Solana CLI JSON format",
-        },
-      ],
-    }),
-  );
-
-  if (method === "phantom") {
-    return importFromPhantom();
-  } else {
-    return useExistingKeypair();
-  }
-}
-
-// ---------------------------------------------------------------------------
-// Step 4: API Key
-// ---------------------------------------------------------------------------
-
-async function setupApiKey() {
-  const apiKey = handleCancel(
-    await p.password({
-      message: "Kinetic API key (optional) (press Enter to skip):",
-      mask: "*",
-    }),
-  );
-
-  return apiKey?.trim() || null;
-}
-
-// ---------------------------------------------------------------------------
-// Step 5: Advanced Settings
-// ---------------------------------------------------------------------------
-
-const DEFAULTS = {
-  rpcUrl: "https://api.mainnet-beta.solana.com",
-  maxTradeSol: "10",
-  priorityFeeLamports: "400000",
-  jitoEnabled: false,
-  dynamicSlippageMaxBps: "300",
-};
-
-async function advancedSettings() {
-  const configure = handleCancel(
-    await p.confirm({
-      message: "Configure advanced settings?",
-      initialValue: false,
-    }),
-  );
-
-  if (!configure) return {};
-
-  p.log.info(pc.dim("Press Enter to keep defaults shown."));
-
-  const rpcUrl = handleCancel(
-    await p.text({
-      message: "Solana RPC URL:",
-      placeholder: DEFAULTS.rpcUrl,
-      defaultValue: DEFAULTS.rpcUrl,
-      validate(value) {
-        if (!value) return;
-        try {
-          const url = new URL(value);
-          if (url.protocol !== "https:") return "URL must use https://";
-        } catch {
-          return "Invalid URL format.";
-        }
-      },
-    }),
-  );
-
-  const maxTradeSol = handleCancel(
-    await p.text({
-      message: "Max trade size (SOL):",
-      placeholder: DEFAULTS.maxTradeSol,
-      defaultValue: DEFAULTS.maxTradeSol,
-      validate(value) {
-        if (!value) return;
-        const num = Number(value);
-        if (isNaN(num) || num <= 0) return "Must be a positive number.";
-      },
-    }),
-  );
-
-  const priorityFeeLamports = handleCancel(
-    await p.text({
-      message: `Priority fee (lamports): ${pc.dim("400000 = ~0.0004 SOL")}`,
-      placeholder: DEFAULTS.priorityFeeLamports,
-      defaultValue: DEFAULTS.priorityFeeLamports,
-      validate(value) {
-        if (!value) return;
-        const num = Number(value);
-        if (isNaN(num) || !Number.isInteger(num) || num < 0)
-          return "Must be a non-negative integer.";
-      },
-    }),
-  );
-
-  const jitoEnabled = handleCancel(
-    await p.confirm({
-      message: "Enable Jito MEV protection?",
-      initialValue: DEFAULTS.jitoEnabled,
-    }),
-  );
-
-  const dynamicSlippageMaxBps = handleCancel(
-    await p.text({
-      message: "Max dynamic slippage (BPS):",
-      placeholder: DEFAULTS.dynamicSlippageMaxBps,
-      defaultValue: DEFAULTS.dynamicSlippageMaxBps,
-      validate(value) {
-        if (!value) return;
-        const num = Number(value);
-        if (isNaN(num) || !Number.isInteger(num) || num <= 0) return "Must be a positive integer.";
-        if (num > 1000) return "Cannot exceed 1000 BPS (10%).";
-      },
-    }),
-  );
-
-  // Return only non-default values
-  const settings = {};
-  if (rpcUrl !== DEFAULTS.rpcUrl) settings.SOLANA_RPC_URL = rpcUrl;
-  if (maxTradeSol !== DEFAULTS.maxTradeSol) settings.MAX_TRADE_SOL = maxTradeSol;
-  if (priorityFeeLamports !== DEFAULTS.priorityFeeLamports)
-    settings.PRIORITY_FEE_LAMPORTS = priorityFeeLamports;
-  if (jitoEnabled !== DEFAULTS.jitoEnabled) settings.JITO_ENABLED = jitoEnabled ? "true" : "false";
-  if (dynamicSlippageMaxBps !== DEFAULTS.dynamicSlippageMaxBps)
-    settings.DYNAMIC_SLIPPAGE_MAX_BPS = dynamicSlippageMaxBps;
-
-  return settings;
-}
-
-// ---------------------------------------------------------------------------
-// Step 6: Claude Desktop Config
-// ---------------------------------------------------------------------------
-
-function generateConfigEntry(keypairPath, apiKey, advancedEnv) {
-  const projectRoot = resolve(".");
-  const entry = {
-    command: execPath,
-    args: [join(projectRoot, "build", "index.js").replace(/\\/g, "/")],
-    env: {
-      SOLANA_KEYPAIR_PATH: keypairPath.replace(/\\/g, "/"),
-    },
-  };
-  if (apiKey) {
-    entry.env.API_KEY = apiKey;
-  }
-  // Add non-default advanced settings
-  if (advancedEnv) {
-    Object.assign(entry.env, advancedEnv);
-  }
-  return entry;
-}
-
-function formatConfigSnippet(entry) {
-  const snippet = {
-    mcpServers: {
-      "solana-trading": entry,
-    },
-  };
-  return JSON.stringify(snippet, null, 2);
-}
-
-async function configureClaudeDesktop(keypairPath, apiKey, advancedEnv) {
-  const entry = generateConfigEntry(keypairPath, apiKey, advancedEnv);
-
-  if (isWSL()) {
-    p.note(
-      [
-        "WSL detected. Claude Desktop runs on the Windows host.",
-        "",
-        `Config file: ${pc.dim("%APPDATA%\\Claude\\claude_desktop_config.json")}`,
-        "",
-        "Add this to your config:",
-        "",
-        formatConfigSnippet(entry),
-        "",
-        pc.dim('Merge "solana-trading" into your existing "mcpServers" object.'),
-      ].join("\n"),
-      "Claude Desktop Config",
-    );
-    return;
-  }
-
-  const configPath = getClaudeConfigPath();
-  if (!configPath) {
-    p.note(
-      [
-        "Could not detect Claude Desktop config path.",
-        "",
-        "Add this to your claude_desktop_config.json:",
-        "",
-        formatConfigSnippet(entry),
-      ].join("\n"),
-      "Claude Desktop Config",
-    );
-    return;
-  }
-
-  p.log.info(`Config file: ${pc.dim(configPath)}`);
-
-  const autoModify = handleCancel(
-    await p.confirm({
-      message: "Automatically add this MCP server to Claude Desktop config?",
-      initialValue: true,
-    }),
-  );
-
-  if (!autoModify) {
-    p.note(
-      [
-        "Add this to your claude_desktop_config.json:",
-        "",
-        formatConfigSnippet(entry),
-        "",
-        pc.dim('Merge "solana-trading" into your existing "mcpServers" object.'),
-      ].join("\n"),
-      "Manual Config",
-    );
-    return;
-  }
-
-  const s = p.spinner();
-  s.start("Writing Claude Desktop config...");
-
-  // Read existing config
-  let config = {};
-  if (existsSync(configPath)) {
-    try {
-      const raw = readFileSync(configPath, "utf-8");
-      config = JSON.parse(raw);
-    } catch {
-      s.stop("Existing config has invalid JSON");
-      p.note(
-        [
-          "Could not parse existing config file.",
-          "",
-          "Add this manually to your claude_desktop_config.json:",
-          "",
-          formatConfigSnippet(entry),
-        ].join("\n"),
-        "Manual Config",
-      );
-      return;
-    }
-
-    // Backup
-    const backupPath = configPath + ".bak";
-    copyFileSync(configPath, backupPath);
-    p.log.info(`Backup created: ${pc.dim(backupPath)}`);
-  }
-
-  // Check for existing entry
-  if (config.mcpServers?.["solana-trading"]) {
-    s.stop("Existing entry found");
-    const overwrite = handleCancel(
-      await p.confirm({
-        message: "A 'solana-trading' entry already exists. Overwrite?",
-        initialValue: false,
-      }),
-    );
-
-    if (!overwrite) {
-      p.log.info("Existing config preserved.");
-      return;
-    }
-
-    s.start("Writing Claude Desktop config...");
-  }
-
-  // Merge
-  if (!config.mcpServers) {
-    config.mcpServers = {};
-  }
-  config.mcpServers["solana-trading"] = entry;
-
-  // Write
-  mkdirSync(dirname(configPath), { recursive: true });
-  writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n");
-
-  s.stop("Claude Desktop config updated");
-}
-
-// ---------------------------------------------------------------------------
-// Step 7: Verification
-// ---------------------------------------------------------------------------
-
-const MAX_VERIFICATION_RETRIES = 3;
-
-async function runVerification(keypairPath, rpcUrl, apiKey) {
-  for (let attempt = 0; attempt <= MAX_VERIFICATION_RETRIES; attempt++) {
-    const s = p.spinner();
-    let hasFailure = false;
-
-    // 1. Load keypair
-    s.start("Loading keypair...");
-    let keypair;
-    try {
-      keypair = validateKeypairFile(keypairPath);
-      s.stop(`Keypair loaded — ${pc.cyan(keypair.publicKey.toBase58())}`);
-    } catch (err) {
-      s.stop(`Keypair load failed: ${err.message}`);
-      hasFailure = true;
-    }
-
-    // 2. Check SOL balance (only if keypair loaded)
-    if (keypair) {
-      const effectiveRpc = rpcUrl || DEFAULTS.rpcUrl;
-      s.start("Checking SOL balance...");
-      try {
-        const response = await fetch(effectiveRpc, {
-          method: "POST",
-          headers: { "Content-Type": "application/json" },
-          body: JSON.stringify({
-            jsonrpc: "2.0",
-            id: 1,
-            method: "getBalance",
-            params: [keypair.publicKey.toBase58()],
-          }),
-          signal: AbortSignal.timeout(10_000),
-        });
-
-        const data = await response.json();
-        const lamports = data.result?.value ?? 0;
-        const sol = (lamports / 1e9).toFixed(4);
-
-        if (lamports === 0) {
-          s.stop(`Balance: ${pc.yellow("0 SOL")}`);
-          p.log.warn("Fund this wallet with SOL before trading.");
-        } else {
-          s.stop(`Balance: ${pc.green(sol + " SOL")}`);
-        }
-      } catch (err) {
-        const msg =
-          err.name === "TimeoutError" || err.name === "AbortError"
-            ? "Request timed out"
-            : err.message;
-        s.stop(`Balance check failed: ${pc.yellow(msg)}`);
-        hasFailure = true;
-      }
-    }
-
-    // 3. Test Kinetic API (only if API key provided)
-    if (apiKey) {
-      s.start("Testing Kinetic API...");
-      try {
-        const response = await fetch("https://auth.kinetic.xyz/v1/token", {
-          method: "POST",
-          headers: { "Content-Type": "application/json" },
-          body: JSON.stringify({ apiKey }),
-          signal: AbortSignal.timeout(10_000),
-        });
-
-        if (response.ok) {
-          s.stop(`Kinetic API: ${pc.green("connected")}`);
-        } else {
-          s.stop(`Kinetic API: ${pc.yellow(`${response.status} ${response.statusText}`)}`);
-          hasFailure = true;
-        }
-      } catch (err) {
-        const msg =
-          err.name === "TimeoutError" || err.name === "AbortError"
-            ? "Request timed out"
-            : err.message;
-        s.stop(`Kinetic API: ${pc.yellow(msg)}`);
-        hasFailure = true;
-      }
-    } else {
-      p.log.info(pc.dim("Skipping Kinetic API test (no API key)."));
-    }
-
-    if (!hasFailure) return;
-
-    // Retry on failure (up to MAX_VERIFICATION_RETRIES)
-    if (attempt < MAX_VERIFICATION_RETRIES) {
-      const retry = handleCancel(
-        await p.confirm({
-          message: "Some checks failed. Retry verification?",
-          initialValue: true,
-        }),
-      );
-
-      if (!retry) {
-        p.log.warn("Continuing with warnings. You can verify connectivity later.");
-        return;
-      }
-    } else {
-      p.log.warn("Maximum retries reached. Continuing with warnings.");
-      return;
-    }
-  }
-}
-
-// ---------------------------------------------------------------------------
-// Main
-// ---------------------------------------------------------------------------
-
-async function main() {
-  await renderBanner();
-  p.intro(pc.bold("Setup Wizard"));
-
-  // Step 2: Build check
-  await checkBuild();
-
-  // Step 3: Keypair setup
-  const keypairResult = await setupKeypair();
-
-  // Step 4: API key
-  const apiKey = await setupApiKey();
-
-  // Step 5: Advanced settings
-  const advancedEnv = await advancedSettings();
-
-  // Step 6: Claude Desktop config
-  await configureClaudeDesktop(keypairResult.path, apiKey, advancedEnv);
-
-  // Step 7: Verification
-  const rpcUrl = advancedEnv.SOLANA_RPC_URL || null;
-  await runVerification(keypairResult.path, rpcUrl, apiKey);
-
-  // Step 8: Outro
-  const summaryLines = [
-    `Wallet:  ${pc.cyan(keypairResult.publicKey)}`,
-    `Keypair: ${pc.dim(keypairResult.path)}`,
-  ];
-  if (apiKey) summaryLines.push(`API Key: ${pc.green("configured")}`);
-
-  const advancedKeys = Object.keys(advancedEnv);
-  if (advancedKeys.length > 0) {
-    summaryLines.push("");
-    summaryLines.push(pc.bold("Custom settings:"));
-    for (const [key, val] of Object.entries(advancedEnv)) {
-      summaryLines.push(`  ${pc.dim(key)}: ${val}`);
-    }
-  }
-
-  p.note(summaryLines.join("\n"), "Setup Complete");
-
-  p.note(
-    [
-      `1. ${pc.bold("Restart Claude Desktop")} (fully quit and reopen)`,
-      `2. Look for the ${pc.bold("hammer icon")} in the chat input`,
-      `3. Try: ${pc.cyan('"What\'s my SOL balance?"')}`,
-      "",
-      pc.dim("Safety guardrails:"),
-      pc.dim(`  • Swaps always show a preview first`),
-      pc.dim(`  • Max trade size: ${advancedEnv.MAX_TRADE_SOL || "10"} SOL`),
-      pc.dim(`  • Slippage capped at ${advancedEnv.DYNAMIC_SLIPPAGE_MAX_BPS || "300"} BPS`),
-    ].join("\n"),
-    "Next Steps",
-  );
-
-  p.outro(pc.green("You're all set! Happy trading."));
-}
-
-main().catch((err) => {
-  if (err.message === "Cancelled by user") {
-    p.cancel("Setup cancelled.");
-  } else {
-    p.log.error(`Setup failed: ${err.message}`);
-  }
-  process.exit(1);
-});
+#!/usr/bin/env node
+
+/**
+ * Interactive setup wizard for Kinetic MCP Server.
+ *
+ * Run: npx kinetic-mcp setup
+ *
+ * This is a standalone .mjs file — no compilation required.
+ * Uses @clack/prompts for beautiful terminal UI.
+ */
+
+import {
+  readFileSync,
+  writeFileSync,
+  existsSync,
+  mkdirSync,
+  chmodSync,
+  copyFileSync,
+} from "node:fs";
+import { homedir } from "node:os";
+import { join, resolve, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import { execSync } from "node:child_process";
+import { platform, execPath } from "node:process";
+import { createRequire } from "node:module";
+
+import { Keypair } from "@solana/web3.js";
+import bs58 from "bs58";
+import * as p from "@clack/prompts";
+import pc from "picocolors";
+
+// ---------------------------------------------------------------------------
+// Version
+// ---------------------------------------------------------------------------
+
+const require = createRequire(import.meta.url);
+const { version } = require("../package.json");
+
+// ---------------------------------------------------------------------------
+// Package root detection
+// ---------------------------------------------------------------------------
+
+const packageRoot = resolve(dirname(fileURLToPath(import.meta.url)), "..");
+const isNpmInstall = /node_modules|[/\\]_npx[/\\]/.test(packageRoot);
+
+// ---------------------------------------------------------------------------
+// Non-TTY check
+// ---------------------------------------------------------------------------
+
+if (!process.stdin.isTTY) {
+  console.error("Error: Setup wizard requires an interactive terminal.");
+  console.error("Run: npx kinetic-mcp setup");
+  process.exit(1);
+}
+
+// ---------------------------------------------------------------------------
+// ASCII Banner
+// ---------------------------------------------------------------------------
+
+const BANNER = `
+ ██╗  ██╗██╗███╗   ██╗███████╗████████╗██╗ ██████╗
+ ██║ ██╔╝██║████╗  ██║██╔════╝╚══██╔══╝██║██╔════╝
+ █████╔╝ ██║██╔██╗ ██║█████╗     ██║   ██║██║
+ ██╔═██╗ ██║██║╚██╗██║██╔══╝     ██║   ██║██║
+ ██║  ██╗██║██║ ╚████║███████╗   ██║   ██║╚██████╗
+ ╚═╝  ╚═╝╚═╝╚═╝  ╚═══╝╚══════╝   ╚═╝   ╚═╝ ╚═════╝`;
+
+async function renderBanner() {
+  let rendered;
+  try {
+    const gradient = (await import("gradient-string")).default;
+    const kineticGradient = gradient(["#FEDA75", "#FA7E1E", "#D62976", "#962FBF", "#4F5BD5"]);
+    rendered = kineticGradient.multiline(BANNER);
+  } catch {
+    rendered = pc.bold(pc.magenta(BANNER));
+  }
+
+  console.log(rendered);
+  console.log(pc.dim(`  v${version} — Solana Trading via Claude Desktop`));
+  console.log();
+}
+
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+
+function handleCancel(value) {
+  if (p.isCancel(value)) {
+    p.cancel("Setup cancelled.");
+    process.exit(0);
+  }
+  return value;
+}
+
+function expandHome(filePath) {
+  if (filePath.startsWith("~/") || filePath.startsWith("~\\")) {
+    return resolve(homedir(), filePath.slice(2));
+  }
+  return filePath;
+}
+
+function isWSL() {
+  try {
+    const ver = readFileSync("/proc/version", "utf-8");
+    return /microsoft|wsl/i.test(ver);
+  } catch {
+    return false;
+  }
+}
+
+function getClaudeConfigPath() {
+  const home = homedir();
+  switch (platform) {
+    case "darwin":
+      return join(home, "Library", "Application Support", "Claude", "claude_desktop_config.json");
+    case "win32":
+      return join(
+        process.env.APPDATA || join(home, "AppData", "Roaming"),
+        "Claude",
+        "claude_desktop_config.json",
+      );
+    case "linux":
+      if (isWSL()) return null;
+      return join(home, ".config", "Claude", "claude_desktop_config.json");
+    default:
+      return null;
+  }
+}
+
+function getDefaultKeypairPath() {
+  return join(homedir(), ".config", "solana", "trading-keypair.json");
+}
+
+function validateKeypairFile(filePath) {
+  const expanded = expandHome(filePath);
+  if (!existsSync(expanded)) {
+    throw new Error(`File not found: ${expanded}`);
+  }
+  const raw = readFileSync(expanded, "utf-8");
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch {
+    throw new Error(
+      "File is not valid JSON. Expected a JSON array of 64 integers (Solana CLI format).",
+    );
+  }
+  if (
+    !Array.isArray(parsed) ||
+    parsed.length !== 64 ||
+    !parsed.every((n) => typeof n === "number" && Number.isInteger(n))
+  ) {
+    throw new Error("Invalid Solana keypair. Expected a JSON array of exactly 64 integers.");
+  }
+  return Keypair.fromSecretKey(Uint8Array.from(parsed));
+}
+
+// ---------------------------------------------------------------------------
+// Step 2: Build Check
+// ---------------------------------------------------------------------------
+
+async function checkBuild() {
+  // npm/npx installs ship with build/ already included
+  if (isNpmInstall) return;
+
+  const buildExists = existsSync(join(packageRoot, "build", "index.js"));
+  if (buildExists) return;
+
+  p.log.warn("Project hasn't been built yet — build/index.js not found.");
+
+  const runBuild = handleCancel(
+    await p.confirm({ message: "Run npm run build now?", initialValue: true }),
+  );
+
+  if (runBuild) {
+    const s = p.spinner();
+    s.start("Building project...");
+    try {
+      execSync("npm run build", { stdio: "pipe", cwd: packageRoot });
+      s.stop("Build complete");
+    } catch {
+      s.stop("Build failed");
+      p.log.warn("You can try again later with: npm run build");
+    }
+  } else {
+    p.log.info("Skipped. Remember to run npm run build before using the server.");
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Step 3: Keypair Setup
+// ---------------------------------------------------------------------------
+
+async function importFromPhantom() {
+  p.note(
+    [
+      `${pc.bold("How to export from Phantom:")}`,
+      "",
+      "1. Open Phantom → Settings → Manage Accounts → [Your Account] → Show Private Key",
+      "2. Enter your password and copy the base58 string",
+      "",
+      `${pc.dim("Your key will be masked. It is NOT saved to shell history.")}`,
+    ].join("\n"),
+    "Import Private Key",
+  );
+
+  const key = handleCancel(
+    await p.password({
+      message: "Paste your private key:",
+      mask: "*",
+      validate(value) {
+        if (!value || value.trim().length === 0) return "Private key is required.";
+
+        let decoded;
+        try {
+          decoded = bs58.decode(value.trim());
+        } catch {
+          return "Invalid format. Expected a base58-encoded string from Phantom.";
+        }
+
+        if (decoded.length !== 64) {
+          if (decoded.length === 32) {
+            return "This looks like a 32-byte seed. Use the Solana CLI to generate the full keypair.";
+          }
+          return `Expected 64-byte secret key, got ${decoded.length} bytes.`;
+        }
+      },
+    }),
+  );
+
+  const decoded = bs58.decode(key.trim());
+  const keypair = Keypair.fromSecretKey(decoded);
+
+  const publicKey = keypair.publicKey.toBase58();
+  p.log.info(`Wallet address: ${pc.cyan(publicKey)}`);
+  p.log.message(pc.dim("Verify this matches your Phantom wallet address."));
+
+  // Save keypair to default path
+  const defaultPath = getDefaultKeypairPath();
+
+  // Check if file exists
+  if (existsSync(defaultPath)) {
+    const overwrite = handleCancel(
+      await p.confirm({
+        message: `Keypair file already exists at ${pc.dim(defaultPath)}. Overwrite?`,
+        initialValue: false,
+      }),
+    );
+
+    if (!overwrite) {
+      p.log.info("Keeping existing keypair file.");
+      return { publicKey, path: defaultPath };
+    }
+  }
+
+  mkdirSync(dirname(defaultPath), { recursive: true, mode: 0o700 });
+  writeFileSync(defaultPath, JSON.stringify(Array.from(keypair.secretKey)) + "\n", { mode: 0o600 });
+
+  if (platform !== "win32") {
+    try {
+      chmodSync(defaultPath, 0o600);
+    } catch (err) {
+      p.log.warn(`Could not set file permissions: ${err.message}. Run: chmod 600 ${defaultPath}`);
+    }
+  }
+
+  p.log.success(`Keypair saved to ${pc.dim(defaultPath)}`);
+  return { publicKey, path: defaultPath };
+}
+
+async function useExistingKeypair() {
+  const filePath = handleCancel(
+    await p.text({
+      message: "Path to keypair file:",
+      placeholder: "~/.config/solana/id.json",
+      validate(value) {
+        if (!value || value.trim().length === 0) return "Path is required.";
+        try {
+          const expanded = expandHome(value.trim());
+          validateKeypairFile(expanded);
+        } catch (err) {
+          return err.message;
+        }
+      },
+    }),
+  );
+
+  const expanded = expandHome(filePath.trim());
+  const keypair = validateKeypairFile(expanded);
+  const publicKey = keypair.publicKey.toBase58();
+
+  p.log.info(`Wallet address: ${pc.cyan(publicKey)}`);
+
+  return { publicKey, path: expanded };
+}
+
+async function setupKeypair() {
+  const method = handleCancel(
+    await p.select({
+      message: "How would you like to set up your Solana keypair?",
+      options: [
+        {
+          value: "phantom",
+          label: "Import from Phantom",
+          hint: "paste your base58 private key",
+        },
+        {
+          value: "existing",
+          label: "Use existing keypair file",
+          hint: "Solana CLI JSON format",
+        },
+      ],
+    }),
+  );
+
+  if (method === "phantom") {
+    return importFromPhantom();
+  } else {
+    return useExistingKeypair();
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Step 4: API Key
+// ---------------------------------------------------------------------------
+
+async function setupApiKey() {
+  const apiKey = handleCancel(
+    await p.password({
+      message: "Kinetic API key (optional) (press Enter to skip):",
+      mask: "*",
+    }),
+  );
+
+  return apiKey?.trim() || null;
+}
+
+// ---------------------------------------------------------------------------
+// Step 5: Advanced Settings
+// ---------------------------------------------------------------------------
+
+const DEFAULTS = {
+  rpcUrl: "https://api.mainnet-beta.solana.com",
+  maxTradeSol: "10",
+  priorityFeeLamports: "400000",
+  jitoEnabled: false,
+  dynamicSlippageMaxBps: "300",
+};
+
+async function advancedSettings() {
+  const configure = handleCancel(
+    await p.confirm({
+      message: "Configure advanced settings?",
+      initialValue: false,
+    }),
+  );
+
+  if (!configure) return {};
+
+  p.log.info(pc.dim("Press Enter to keep defaults shown."));
+
+  const rpcUrl = handleCancel(
+    await p.text({
+      message: "Solana RPC URL:",
+      placeholder: DEFAULTS.rpcUrl,
+      defaultValue: DEFAULTS.rpcUrl,
+      validate(value) {
+        if (!value) return;
+        try {
+          const url = new URL(value);
+          if (url.protocol !== "https:") return "URL must use https://";
+        } catch {
+          return "Invalid URL format.";
+        }
+      },
+    }),
+  );
+
+  const maxTradeSol = handleCancel(
+    await p.text({
+      message: "Max trade size (SOL):",
+      placeholder: DEFAULTS.maxTradeSol,
+      defaultValue: DEFAULTS.maxTradeSol,
+      validate(value) {
+        if (!value) return;
+        const num = Number(value);
+        if (isNaN(num) || num <= 0) return "Must be a positive number.";
+      },
+    }),
+  );
+
+  const priorityFeeLamports = handleCancel(
+    await p.text({
+      message: `Priority fee (lamports): ${pc.dim("400000 = ~0.0004 SOL")}`,
+      placeholder: DEFAULTS.priorityFeeLamports,
+      defaultValue: DEFAULTS.priorityFeeLamports,
+      validate(value) {
+        if (!value) return;
+        const num = Number(value);
+        if (isNaN(num) || !Number.isInteger(num) || num < 0)
+          return "Must be a non-negative integer.";
+      },
+    }),
+  );
+
+  const jitoEnabled = handleCancel(
+    await p.confirm({
+      message: "Enable Jito MEV protection?",
+      initialValue: DEFAULTS.jitoEnabled,
+    }),
+  );
+
+  const dynamicSlippageMaxBps = handleCancel(
+    await p.text({
+      message: "Max dynamic slippage (BPS):",
+      placeholder: DEFAULTS.dynamicSlippageMaxBps,
+      defaultValue: DEFAULTS.dynamicSlippageMaxBps,
+      validate(value) {
+        if (!value) return;
+        const num = Number(value);
+        if (isNaN(num) || !Number.isInteger(num) || num <= 0) return "Must be a positive integer.";
+        if (num > 1000) return "Cannot exceed 1000 BPS (10%).";
+      },
+    }),
+  );
+
+  // Return only non-default values
+  const settings = {};
+  if (rpcUrl !== DEFAULTS.rpcUrl) settings.SOLANA_RPC_URL = rpcUrl;
+  if (maxTradeSol !== DEFAULTS.maxTradeSol) settings.MAX_TRADE_SOL = maxTradeSol;
+  if (priorityFeeLamports !== DEFAULTS.priorityFeeLamports)
+    settings.PRIORITY_FEE_LAMPORTS = priorityFeeLamports;
+  if (jitoEnabled !== DEFAULTS.jitoEnabled) settings.JITO_ENABLED = jitoEnabled ? "true" : "false";
+  if (dynamicSlippageMaxBps !== DEFAULTS.dynamicSlippageMaxBps)
+    settings.DYNAMIC_SLIPPAGE_MAX_BPS = dynamicSlippageMaxBps;
+
+  return settings;
+}
+
+// ---------------------------------------------------------------------------
+// Step 6: Claude Desktop Config
+// ---------------------------------------------------------------------------
+
+function generateConfigEntry(keypairPath, apiKey, advancedEnv) {
+  const entry = {
+    env: {
+      SOLANA_KEYPAIR_PATH: keypairPath.replace(/\\/g, "/"),
+    },
+  };
+
+  if (isNpmInstall) {
+    // npm/npx install — use portable npx command
+    entry.command = "npx";
+    entry.args = ["-y", "kinetic-mcp"];
+  } else {
+    // Local source checkout — use direct node path
+    entry.command = execPath;
+    entry.args = [join(packageRoot, "build", "index.js").replace(/\\/g, "/")];
+  }
+
+  if (apiKey) {
+    entry.env.API_KEY = apiKey;
+  }
+  // Add non-default advanced settings
+  if (advancedEnv) {
+    Object.assign(entry.env, advancedEnv);
+  }
+  return entry;
+}
+
+function formatConfigSnippet(entry) {
+  const snippet = {
+    mcpServers: {
+      "solana-trading": entry,
+    },
+  };
+  return JSON.stringify(snippet, null, 2);
+}
+
+async function configureClaudeDesktop(keypairPath, apiKey, advancedEnv) {
+  const entry = generateConfigEntry(keypairPath, apiKey, advancedEnv);
+
+  if (isWSL()) {
+    p.note(
+      [
+        "WSL detected. Claude Desktop runs on the Windows host.",
+        "",
+        `Config file: ${pc.dim("%APPDATA%\\Claude\\claude_desktop_config.json")}`,
+        "",
+        "Add this to your config:",
+        "",
+        formatConfigSnippet(entry),
+        "",
+        pc.dim('Merge "solana-trading" into your existing "mcpServers" object.'),
+      ].join("\n"),
+      "Claude Desktop Config",
+    );
+    return;
+  }
+
+  const configPath = getClaudeConfigPath();
+  if (!configPath) {
+    p.note(
+      [
+        "Could not detect Claude Desktop config path.",
+        "",
+        "Add this to your claude_desktop_config.json:",
+        "",
+        formatConfigSnippet(entry),
+      ].join("\n"),
+      "Claude Desktop Config",
+    );
+    return;
+  }
+
+  p.log.info(`Config file: ${pc.dim(configPath)}`);
+
+  const autoModify = handleCancel(
+    await p.confirm({
+      message: "Automatically add this MCP server to Claude Desktop config?",
+      initialValue: true,
+    }),
+  );
+
+  if (!autoModify) {
+    p.note(
+      [
+        "Add this to your claude_desktop_config.json:",
+        "",
+        formatConfigSnippet(entry),
+        "",
+        pc.dim('Merge "solana-trading" into your existing "mcpServers" object.'),
+      ].join("\n"),
+      "Manual Config",
+    );
+    return;
+  }
+
+  const s = p.spinner();
+  s.start("Writing Claude Desktop config...");
+
+  // Read existing config
+  let config = {};
+  if (existsSync(configPath)) {
+    try {
+      const raw = readFileSync(configPath, "utf-8");
+      config = JSON.parse(raw);
+    } catch {
+      s.stop("Existing config has invalid JSON");
+      p.note(
+        [
+          "Could not parse existing config file.",
+          "",
+          "Add this manually to your claude_desktop_config.json:",
+          "",
+          formatConfigSnippet(entry),
+        ].join("\n"),
+        "Manual Config",
+      );
+      return;
+    }
+
+    // Backup
+    const backupPath = configPath + ".bak";
+    copyFileSync(configPath, backupPath);
+    p.log.info(`Backup created: ${pc.dim(backupPath)}`);
+  }
+
+  // Check for existing entry
+  if (config.mcpServers?.["solana-trading"]) {
+    s.stop("Existing entry found");
+    const overwrite = handleCancel(
+      await p.confirm({
+        message: "A 'solana-trading' entry already exists. Overwrite?",
+        initialValue: false,
+      }),
+    );
+
+    if (!overwrite) {
+      p.log.info("Existing config preserved.");
+      return;
+    }
+
+    s.start("Writing Claude Desktop config...");
+  }
+
+  // Merge
+  if (!config.mcpServers) {
+    config.mcpServers = {};
+  }
+  config.mcpServers["solana-trading"] = entry;
+
+  // Write
+  mkdirSync(dirname(configPath), { recursive: true });
+  writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n");
+
+  s.stop("Claude Desktop config updated");
+}
+
+// ---------------------------------------------------------------------------
+// Step 7: Verification
+// ---------------------------------------------------------------------------
+
+const MAX_VERIFICATION_RETRIES = 3;
+
+async function runVerification(keypairPath, rpcUrl, apiKey) {
+  for (let attempt = 0; attempt <= MAX_VERIFICATION_RETRIES; attempt++) {
+    const s = p.spinner();
+    let hasFailure = false;
+
+    // 1. Load keypair
+    s.start("Loading keypair...");
+    let keypair;
+    try {
+      keypair = validateKeypairFile(keypairPath);
+      s.stop(`Keypair loaded — ${pc.cyan(keypair.publicKey.toBase58())}`);
+    } catch (err) {
+      s.stop(`Keypair load failed: ${err.message}`);
+      hasFailure = true;
+    }
+
+    // 2. Check SOL balance (only if keypair loaded)
+    if (keypair) {
+      const effectiveRpc = rpcUrl || DEFAULTS.rpcUrl;
+      s.start("Checking SOL balance...");
+      try {
+        const response = await fetch(effectiveRpc, {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify({
+            jsonrpc: "2.0",
+            id: 1,
+            method: "getBalance",
+            params: [keypair.publicKey.toBase58()],
+          }),
+          signal: AbortSignal.timeout(10_000),
+        });
+
+        const data = await response.json();
+        const lamports = data.result?.value ?? 0;
+        const sol = (lamports / 1e9).toFixed(4);
+
+        if (lamports === 0) {
+          s.stop(`Balance: ${pc.yellow("0 SOL")}`);
+          p.log.warn("Fund this wallet with SOL before trading.");
+        } else {
+          s.stop(`Balance: ${pc.green(sol + " SOL")}`);
+        }
+      } catch (err) {
+        const msg =
+          err.name === "TimeoutError" || err.name === "AbortError"
+            ? "Request timed out"
+            : err.message;
+        s.stop(`Balance check failed: ${pc.yellow(msg)}`);
+        hasFailure = true;
+      }
+    }
+
+    // 3. Test Kinetic API (only if API key provided)
+    if (apiKey) {
+      s.start("Testing Kinetic API...");
+      try {
+        const response = await fetch("https://auth.kinetic.xyz/v1/token", {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify({ apiKey }),
+          signal: AbortSignal.timeout(10_000),
+        });
+
+        if (response.ok) {
+          s.stop(`Kinetic API: ${pc.green("connected")}`);
+        } else {
+          s.stop(`Kinetic API: ${pc.yellow(`${response.status} ${response.statusText}`)}`);
+          hasFailure = true;
+        }
+      } catch (err) {
+        const msg =
+          err.name === "TimeoutError" || err.name === "AbortError"
+            ? "Request timed out"
+            : err.message;
+        s.stop(`Kinetic API: ${pc.yellow(msg)}`);
+        hasFailure = true;
+      }
+    } else {
+      p.log.info(pc.dim("Skipping Kinetic API test (no API key)."));
+    }
+
+    if (!hasFailure) return;
+
+    // Retry on failure (up to MAX_VERIFICATION_RETRIES)
+    if (attempt < MAX_VERIFICATION_RETRIES) {
+      const retry = handleCancel(
+        await p.confirm({
+          message: "Some checks failed. Retry verification?",
+          initialValue: true,
+        }),
+      );
+
+      if (!retry) {
+        p.log.warn("Continuing with warnings. You can verify connectivity later.");
+        return;
+      }
+    } else {
+      p.log.warn("Maximum retries reached. Continuing with warnings.");
+      return;
+    }
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Main
+// ---------------------------------------------------------------------------
+
+async function main() {
+  await renderBanner();
+  p.intro(pc.bold("Setup Wizard"));
+
+  // Step 2: Build check
+  await checkBuild();
+
+  // Step 3: Keypair setup
+  const keypairResult = await setupKeypair();
+
+  // Step 4: API key
+  const apiKey = await setupApiKey();
+
+  // Step 5: Advanced settings
+  const advancedEnv = await advancedSettings();
+
+  // Step 6: Claude Desktop config
+  await configureClaudeDesktop(keypairResult.path, apiKey, advancedEnv);
+
+  // Step 7: Verification
+  const rpcUrl = advancedEnv.SOLANA_RPC_URL || null;
+  await runVerification(keypairResult.path, rpcUrl, apiKey);
+
+  // Step 8: Outro
+  const summaryLines = [
+    `Wallet:  ${pc.cyan(keypairResult.publicKey)}`,
+    `Keypair: ${pc.dim(keypairResult.path)}`,
+  ];
+  if (apiKey) summaryLines.push(`API Key: ${pc.green("configured")}`);
+
+  const advancedKeys = Object.keys(advancedEnv);
+  if (advancedKeys.length > 0) {
+    summaryLines.push("");
+    summaryLines.push(pc.bold("Custom settings:"));
+    for (const [key, val] of Object.entries(advancedEnv)) {
+      summaryLines.push(`  ${pc.dim(key)}: ${val}`);
+    }
+  }
+
+  p.note(summaryLines.join("\n"), "Setup Complete");
+
+  p.note(
+    [
+      `1. ${pc.bold("Restart Claude Desktop")} (fully quit and reopen)`,
+      `2. Look for the ${pc.bold("hammer icon")} in the chat input`,
+      `3. Try: ${pc.cyan('"What\'s my SOL balance?"')}`,
+      "",
+      pc.dim("Safety guardrails:"),
+      pc.dim(`  • Swaps always show a preview first`),
+      pc.dim(`  • Max trade size: ${advancedEnv.MAX_TRADE_SOL || "10"} SOL`),
+      pc.dim(`  • Slippage capped at ${advancedEnv.DYNAMIC_SLIPPAGE_MAX_BPS || "300"} BPS`),
+    ].join("\n"),
+    "Next Steps",
+  );
+
+  p.outro(pc.green("You're all set! Happy trading."));
+}
+
+main().catch((err) => {
+  if (err.message === "Cancelled by user") {
+    p.cancel("Setup cancelled.");
+  } else {
+    p.log.error(`Setup failed: ${err.message}`);
+  }
+  process.exit(1);
+});