clawchain-wallet 1.0.0

package/python/requirements.txt

@@ -0,0 +1,2 @@
+web3>=6.0.0
+eth-account>=0.10.0

package/scripts/postinstall.js

@@ -0,0 +1,243 @@
+#!/usr/bin/env node
+/**
+ * ClawChain Wallet postinstall 脚本
+ * 
+ * 自动完成以下任务：
+ * 1. 检测 Python 环境
+ * 2. 安装 Python 依赖 (web3, eth-account)
+ * 3. 编译 TypeScript
+ * 4. 注册到 OpenClaw（如果可用）
+ * 
+ * 支持：
+ * - npm install（本地安装）
+ * - npm install -g（全局安装）
+ * - npx 直接执行
+ */
+
+import { execSync, spawnSync } from "node:child_process";
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const rootDir = resolve(join(__dirname, ".."));
+
+// 检测是否在 CI 环境或 npm 生命周期中跳过
+if (process.env.CI || process.env.SKIP_POSTINSTALL) {
+  console.log("跳过 postinstall（CI 环境或 SKIP_POSTINSTALL 设置）");
+  process.exit(0);
+}
+
+// 颜色输出
+const colors = {
+  reset: "\x1b[0m",
+  green: "\x1b[32m",
+  yellow: "\x1b[33m",
+  red: "\x1b[31m",
+  cyan: "\x1b[36m",
+  dim: "\x1b[2m",
+};
+
+function log(msg, color = "reset") {
+  console.log(`${colors[color]}${msg}${colors.reset}`);
+}
+
+function logStep(step, msg) {
+  console.log(`\n${colors.cyan}[${step}]${colors.reset} ${msg}`);
+}
+
+function logSuccess(msg) {
+  console.log(`  ${colors.green}✓${colors.reset} ${msg}`);
+}
+
+function logWarning(msg) {
+  console.log(`  ${colors.yellow}⚠${colors.reset} ${msg}`);
+}
+
+function logError(msg) {
+  console.log(`  ${colors.red}✗${colors.reset} ${msg}`);
+}
+
+function runCommand(cmd, options = {}) {
+  try {
+    const result = execSync(cmd, {
+      encoding: "utf-8",
+      stdio: options.silent ? "pipe" : "inherit",
+      ...options,
+    });
+    return { success: true, output: result };
+  } catch (error) {
+    return { success: false, error: error.message };
+  }
+}
+
+function checkCommand(cmd) {
+  const result = spawnSync("which", [cmd], { encoding: "utf-8" });
+  return result.status === 0;
+}
+
+async function main() {
+  console.log("\n" + "=".repeat(60));
+  log("  ClawChain Wallet - 安装配置", "cyan");
+  console.log("=".repeat(60));
+
+  // Step 1: 检测 Python
+  logStep("1/4", "检测 Python 环境...");
+  
+  let pythonCmd = null;
+  for (const cmd of ["python3", "python"]) {
+    if (checkCommand(cmd)) {
+      const versionResult = spawnSync(cmd, ["--version"], { encoding: "utf-8" });
+      if (versionResult.status === 0) {
+        const version = versionResult.stdout.trim() || versionResult.stderr.trim();
+        if (version.includes("3.")) {
+          pythonCmd = cmd;
+          logSuccess(`找到 ${version}`);
+          break;
+        }
+      }
+    }
+  }
+
+  if (!pythonCmd) {
+    logError("未找到 Python 3！");
+    logWarning("请先安装 Python 3.8 或更高版本");
+    logWarning("macOS: brew install python3");
+    logWarning("Ubuntu: sudo apt install python3 python3-pip");
+    process.exit(1);
+  }
+
+  // Step 2: 检测并安装 pip
+  logStep("2/4", "检测 pip 并安装 Python 依赖...");
+  
+  let pipCmd = null;
+  for (const cmd of ["pip3", "pip"]) {
+    if (checkCommand(cmd)) {
+      pipCmd = cmd;
+      break;
+    }
+  }
+
+  if (!pipCmd) {
+    logWarning("未找到 pip，尝试使用 python -m pip...");
+    pipCmd = `${pythonCmd} -m pip`;
+  }
+
+  // 安装 Python 依赖
+  const requirementsFile = join(rootDir, "python", "requirements.txt");
+  if (existsSync(requirementsFile)) {
+    log(`  安装 Python 依赖 (web3, eth-account)...`, "dim");
+    const pipResult = runCommand(
+      `${pipCmd} install -r "${requirementsFile}" --quiet --disable-pip-version-check`,
+      { silent: true }
+    );
+    
+    if (pipResult.success) {
+      logSuccess("Python 依赖安装成功");
+    } else {
+      logWarning("Python 依赖安装失败，请手动执行:");
+      logWarning(`  ${pipCmd} install -r "${requirementsFile}"`);
+    }
+  }
+
+  // 验证 web3 是否可用
+  const web3Check = spawnSync(pythonCmd, ["-c", "import web3; print(web3.__version__)"], {
+    encoding: "utf-8",
+  });
+  
+  if (web3Check.status === 0) {
+    logSuccess(`web3.py ${web3Check.stdout.trim()} 已就绪`);
+  } else {
+    logWarning("web3 模块未安装，请手动执行:");
+    logWarning(`  ${pipCmd} install web3 eth-account`);
+  }
+
+  // Step 3: 编译 TypeScript
+  logStep("3/4", "编译 TypeScript...");
+  
+  const tscPath = join(rootDir, "node_modules", ".bin", "tsc");
+  if (existsSync(tscPath) || checkCommand("tsc")) {
+    const buildResult = runCommand("npm run build", { cwd: rootDir, silent: true });
+    if (buildResult.success) {
+      logSuccess("TypeScript 编译成功");
+    } else {
+      logWarning("TypeScript 编译失败，可能需要手动执行 npm run build");
+    }
+  } else {
+    logWarning("TypeScript 编译器未找到，跳过编译");
+    logWarning("如需编译，请执行: npm install && npm run build");
+  }
+
+  // Step 4: 尝试注册到 OpenClaw
+  logStep("4/4", "检测 OpenClaw 并注册插件...");
+  
+  if (checkCommand("openclaw")) {
+    logSuccess("找到 OpenClaw CLI");
+    
+    // 检查是否已安装
+    const listResult = spawnSync("openclaw", ["plugins", "list"], { encoding: "utf-8" });
+    const isInstalled = listResult.stdout && listResult.stdout.includes("clawchain-wallet");
+    
+    if (isInstalled) {
+      logSuccess("插件已在 OpenClaw 中注册");
+    } else {
+      log(`  注册插件到 OpenClaw...`, "dim");
+      const installResult = runCommand(`openclaw plugins install "${rootDir}"`, { silent: true });
+      
+      if (installResult.success) {
+        // 启用插件
+        runCommand(`openclaw plugins enable clawchain-wallet`, { silent: true });
+        logSuccess("插件注册并启用成功");
+      } else {
+        logWarning("自动注册失败，请手动执行:");
+        logWarning(`  openclaw plugins install "${rootDir}"`);
+        logWarning(`  openclaw plugins enable clawchain-wallet`);
+      }
+    }
+  } else {
+    logWarning("未检测到 OpenClaw CLI");
+    logWarning("如需使用 OpenClaw 插件功能，请先安装 OpenClaw:");
+    logWarning("  npm install -g openclaw");
+    logWarning("然后手动注册插件:");
+    logWarning(`  openclaw plugins install "${rootDir}"`);
+    logWarning(`  openclaw plugins enable clawchain-wallet`);
+  }
+
+  // 完成
+  console.log("\n" + "=".repeat(60));
+  log("  安装完成！", "green");
+  console.log("=".repeat(60));
+  
+  console.log(`
+${colors.cyan}链信息:${colors.reset}
+  - 链名称: ClawChain
+  - 代币符号: CLAW
+  - RPC URL: https://n1.clawchain.net
+  - Chain ID: 1911
+
+${colors.cyan}可用工具:${colors.reset}
+  - clawchain_wallet_create    创建新钱包
+  - clawchain_wallet_import    导入钱包
+  - clawchain_wallet_list      列出所有钱包
+  - clawchain_wallet_info      获取钱包详情
+  - clawchain_wallet_delete    删除钱包
+  - clawchain_wallet_rename    重命名钱包
+  - clawchain_wallet_export    导出钱包私钥
+  - clawchain_balance          查询余额
+  - clawchain_transfer         转账 CLAW
+  - clawchain_tx_info          查询交易详情
+  - clawchain_tx_history       查询交易历史
+  - clawchain_info             获取链信息
+  - clawchain_block_info       查询区块信息
+  - clawchain_claim_airdrop    领取 CLAW 空投
+
+${colors.cyan}使用方式:${colors.reset}
+  1. 在 OpenClaw 中直接使用上述工具
+  2. 或阅读 SKILL.md 了解详细用法
+
+${colors.dim}如有问题，请查看: ${rootDir}/SKILL.md${colors.reset}
+`);
+}
+
+main().catch(console.error);

package/src/executor.ts

@@ -0,0 +1,88 @@
+/**
+ * ClawChain Python CLI 执行器
+ * 
+ * 使用 JSON stdin 传递参数，避免命令注入风险
+ */
+
+import { execSync } from "node:child_process";
+import type { CommandResult } from "./types.js";
+
+export interface ExecutorOptions {
+  pythonScript: string;
+  walletsDir?: string;
+  timeout?: number;
+}
+
+/**
+ * 命令参数类型定义
+ */
+export interface CommandArgs {
+  [key: string]: string | number | boolean | undefined;
+}
+
+/**
+ * 执行 ClawChain CLI 命令
+ * 
+ * 通过 stdin 传递 JSON 格式的参数，避免命令行注入风险
+ */
+export function executeCommand(
+  options: ExecutorOptions,
+  command: string,
+  args: CommandArgs = {}
+): CommandResult {
+  const { pythonScript, walletsDir, timeout = 60000 } = options;
+  
+  // 构建 JSON 输入
+  const inputData = {
+    command,
+    wallets_dir: walletsDir,
+    args,
+  };
+  
+  const jsonInput = JSON.stringify(inputData);
+  
+  try {
+    const output = execSync(`python3 "${pythonScript}" --json-stdin`, {
+      encoding: "utf-8",
+      timeout,
+      input: jsonInput,
+      stdio: ["pipe", "pipe", "pipe"],
+    });
+    
+    // 解析 JSON 输出
+    try {
+      return JSON.parse(output.trim()) as CommandResult;
+    } catch {
+      // 如果不是 JSON，返回原始输出
+      return {
+        success: true,
+        output: output.trim(),
+      };
+    }
+  } catch (error: unknown) {
+    const execError = error as { stderr?: string; stdout?: string; message?: string };
+    
+    // 尝试从 stdout 解析 JSON 结果（某些情况下错误也会输出到 stdout）
+    if (execError.stdout) {
+      try {
+        return JSON.parse(execError.stdout.trim()) as CommandResult;
+      } catch {
+        // 继续尝试 stderr
+      }
+    }
+    
+    // 尝试从 stderr 解析 JSON 错误
+    if (execError.stderr) {
+      try {
+        return JSON.parse(execError.stderr.trim()) as CommandResult;
+      } catch {
+        // 返回原始错误
+      }
+    }
+    
+    return {
+      success: false,
+      error: execError.message || "命令执行失败",
+    };
+  }
+}