clawchain-wallet 1.0.0

package/python/clawchain_cli.py

@@ -0,0 +1,1193 @@
+#!/usr/bin/env python3
+"""
+ClawChain CLI - ClawChain 私有链钱包管理工具
+支持：创建钱包、导入钱包、管理钱包、查余额、转账、查询交易
+
+固定配置:
+  - RPC URL: https://n1.clawchain.net
+  - Chain ID: 1911
+  - 代币名称: CLAW
+  - 链名称: ClawChain
+
+支持两种调用方式：
+  1. 传统命令行参数方式
+  2. JSON stdin 方式（更安全，避免命令注入）
+"""
+
+import argparse
+import json
+import os
+import sys
+import time
+import urllib.request
+import urllib.error
+from datetime import datetime
+from pathlib import Path
+from typing import Optional, Dict, List, Any
+
+try:
+    from web3 import Web3
+    from eth_account import Account
+except ImportError:
+    print(json.dumps({"success": False, "error": "请先安装 web3 库: pip install web3"}))
+    sys.exit(1)
+
+# ============== 固定配置 ==============
+CLAWCHAIN_CONFIG = {
+    "rpc_url": "https://n1.clawchain.net",
+    "chain_id": 1911,
+    "gas_price": "auto",
+    "gas_limit": 21000,
+    "chain_name": "ClawChain",
+    "token_symbol": "CLAW"
+}
+
+# 默认钱包存储目录
+DEFAULT_WALLETS_DIR = Path.home() / ".clawchain" / "wallets"
+
+
+def get_wallets_dir(custom_dir: Optional[str] = None) -> Path:
+    """获取钱包存储目录"""
+    if custom_dir:
+        wallets_dir = Path(custom_dir)
+    else:
+        wallets_dir = DEFAULT_WALLETS_DIR
+    wallets_dir.mkdir(parents=True, exist_ok=True)
+    return wallets_dir
+
+
+def get_web3() -> Web3:
+    """获取 Web3 实例"""
+    w3 = Web3(Web3.HTTPProvider(CLAWCHAIN_CONFIG["rpc_url"]))
+    if not w3.is_connected():
+        raise ConnectionError(f"无法连接到 ClawChain RPC 节点 {CLAWCHAIN_CONFIG['rpc_url']}")
+    return w3
+
+
+def output_result(data: dict):
+    """输出 JSON 格式结果"""
+    print(json.dumps(data, ensure_ascii=False, indent=2))
+
+
+def load_wallet_index(wallets_dir: Path) -> Dict[str, Any]:
+    """加载钱包索引文件"""
+    index_file = wallets_dir / "index.json"
+    if index_file.exists():
+        with open(index_file, "r", encoding="utf-8") as f:
+            return json.load(f)
+    return {"wallets": {}}
+
+
+def save_wallet_index(wallets_dir: Path, index: Dict[str, Any]):
+    """保存钱包索引文件"""
+    index_file = wallets_dir / "index.json"
+    with open(index_file, "w", encoding="utf-8") as f:
+        json.dump(index, f, ensure_ascii=False, indent=2)
+
+
+def generate_wallet_id(name: str) -> str:
+    """生成钱包文件名安全的ID"""
+    safe_name = "".join(c if c.isalnum() or c in "-_" else "_" for c in name)
+    return f"{safe_name}_{int(time.time())}"
+
+
+def generate_auto_wallet_name(wallets_dir: Path) -> str:
+    """自动生成钱包名称，格式为 wallet-01, wallet-02 等"""
+    index = load_wallet_index(wallets_dir)
+    existing_names = {w.get("name", "") for w in index.get("wallets", {}).values()}
+    
+    # 找出已使用的 wallet-XX 编号
+    used_numbers = set()
+    for name in existing_names:
+        if name.startswith("wallet-") and len(name) == 9:  # wallet-XX 格式
+            try:
+                num = int(name[7:])
+                used_numbers.add(num)
+            except ValueError:
+                pass
+    
+    # 找到第一个未使用的编号
+    next_num = 1
+    while next_num in used_numbers:
+        next_num += 1
+    
+    return f"wallet-{next_num:02d}"
+
+
+def get_existing_wallet_names(wallets_dir: Path) -> List[str]:
+    """获取所有已存在的钱包名称"""
+    index = load_wallet_index(wallets_dir)
+    return [w.get("name", "") for w in index.get("wallets", {}).values()]
+
+
+# ============== 钱包创建命令 ==============
+
+def cmd_wallet_create(args):
+    """创建新钱包"""
+    try:
+        wallets_dir = get_wallets_dir(args.wallets_dir)
+        
+        # 生成新钱包
+        account = Account.create()
+        
+        # 确定钱包名称
+        if args.name:
+            wallet_name = args.name
+        else:
+            # 自动生成名称 wallet-01, wallet-02 等
+            wallet_name = generate_auto_wallet_name(wallets_dir)
+        
+        wallet_id = generate_wallet_id(wallet_name)
+        
+        # 检查名称是否重复
+        index = load_wallet_index(wallets_dir)
+        existing_names = get_existing_wallet_names(wallets_dir)
+        
+        for existing_wallet in index.get("wallets", {}).values():
+            if existing_wallet.get("name") == wallet_name:
+                # 提供建议的可用名称
+                suggested_name = generate_auto_wallet_name(wallets_dir)
+                output_result({
+                    "success": False,
+                    "error": f"钱包名称 '{wallet_name}' 已存在，请使用其他名称",
+                    "suggestion": f"建议使用名称: '{suggested_name}'",
+                    "existing_wallets": existing_names
+                })
+                return
+        
+        # 保存钱包文件
+        wallet_file = wallets_dir / f"{wallet_id}.json"
+        wallet_data = {
+            "id": wallet_id,
+            "name": wallet_name,
+            "address": account.address,
+            "private_key": account.key.hex(),
+            "created_at": datetime.now().isoformat(),
+            "chain": CLAWCHAIN_CONFIG["chain_name"]
+        }
+        
+        with open(wallet_file, "w", encoding="utf-8") as f:
+            json.dump(wallet_data, f, ensure_ascii=False, indent=2)
+        
+        # 更新索引
+        index["wallets"][wallet_id] = {
+            "name": wallet_name,
+            "address": account.address,
+            "created_at": wallet_data["created_at"]
+        }
+        save_wallet_index(wallets_dir, index)
+        
+        output_result({
+            "success": True,
+            "message": f"钱包 '{wallet_name}' 创建成功",
+            "wallet": {
+                "id": wallet_id,
+                "name": wallet_name,
+                "address": account.address,
+                "private_key": account.key.hex()
+            },
+            "warning": "请妥善保管私钥，丢失将无法找回！"
+        })
+        
+    except Exception as e:
+        output_result({"success": False, "error": str(e)})
+
+
+# ============== 钱包导入命令 ==============
+
+def cmd_wallet_import(args):
+    """从私钥导入钱包"""
+    try:
+        wallets_dir = get_wallets_dir(args.wallets_dir)
+        
+        # 处理私钥格式
+        private_key = args.private_key
+        if not private_key.startswith("0x"):
+            private_key = "0x" + private_key
+        
+        # 验证私钥
+        try:
+            account = Account.from_key(private_key)
+        except Exception:
+            output_result({"success": False, "error": "无效的私钥格式"})
+            return
+        
+        # 确定钱包名称
+        if args.name:
+            wallet_name = args.name
+        else:
+            # 自动生成名称 wallet-01, wallet-02 等
+            wallet_name = generate_auto_wallet_name(wallets_dir)
+        
+        wallet_id = generate_wallet_id(wallet_name)
+        
+        # 检查名称和地址是否重复
+        index = load_wallet_index(wallets_dir)
+        existing_names = get_existing_wallet_names(wallets_dir)
+        
+        for existing_wallet in index.get("wallets", {}).values():
+            if existing_wallet.get("name") == wallet_name:
+                # 提供建议的可用名称
+                suggested_name = generate_auto_wallet_name(wallets_dir)
+                output_result({
+                    "success": False,
+                    "error": f"钱包名称 '{wallet_name}' 已存在，请使用其他名称",
+                    "suggestion": f"建议使用名称: '{suggested_name}'",
+                    "existing_wallets": existing_names
+                })
+                return
+            if existing_wallet.get("address").lower() == account.address.lower():
+                output_result({
+                    "success": False,
+                    "error": f"地址 {account.address} 的钱包已存在，名称为 '{existing_wallet.get('name')}'"
+                })
+                return
+        
+        # 保存钱包文件
+        wallet_file = wallets_dir / f"{wallet_id}.json"
+        wallet_data = {
+            "id": wallet_id,
+            "name": wallet_name,
+            "address": account.address,
+            "private_key": private_key,
+            "created_at": datetime.now().isoformat(),
+            "imported": True,
+            "chain": CLAWCHAIN_CONFIG["chain_name"]
+        }
+        
+        with open(wallet_file, "w", encoding="utf-8") as f:
+            json.dump(wallet_data, f, ensure_ascii=False, indent=2)
+        
+        # 更新索引
+        index["wallets"][wallet_id] = {
+            "name": wallet_name,
+            "address": account.address,
+            "created_at": wallet_data["created_at"],
+            "imported": True
+        }
+        save_wallet_index(wallets_dir, index)
+        
+        output_result({
+            "success": True,
+            "message": f"钱包 '{wallet_name}' 导入成功",
+            "wallet": {
+                "id": wallet_id,
+                "name": wallet_name,
+                "address": account.address
+            }
+        })
+        
+    except Exception as e:
+        output_result({"success": False, "error": str(e)})
+
+
+# ============== 钱包列表命令 ==============
+
+def cmd_wallet_list(args):
+    """列出所有钱包"""
+    try:
+        wallets_dir = get_wallets_dir(args.wallets_dir)
+        index = load_wallet_index(wallets_dir)
+        
+        wallets = []
+        w3 = None
+        
+        for wallet_id, wallet_info in index.get("wallets", {}).items():
+            wallet_entry = {
+                "id": wallet_id,
+                "name": wallet_info.get("name"),
+                "address": wallet_info.get("address"),
+                "created_at": wallet_info.get("created_at"),
+                "imported": wallet_info.get("imported", False)
+            }
+            
+            # 如果需要显示余额
+            if args.show_balance:
+                try:
+                    if w3 is None:
+                        w3 = get_web3()
+                    balance_wei = w3.eth.get_balance(wallet_info["address"])
+                    balance_claw = w3.from_wei(balance_wei, 'ether')
+                    wallet_entry["balance"] = f"{balance_claw} CLAW"
+                    wallet_entry["balance_wei"] = str(balance_wei)
+                except Exception as e:
+                    wallet_entry["balance"] = f"查询失败: {str(e)}"
+            
+            wallets.append(wallet_entry)
+        
+        output_result({
+            "success": True,
+            "count": len(wallets),
+            "wallets": wallets,
+            "chain": CLAWCHAIN_CONFIG["chain_name"]
+        })
+        
+    except Exception as e:
+        output_result({"success": False, "error": str(e)})
+
+
+# ============== 钱包详情命令 ==============
+
+def cmd_wallet_info(args):
+    """获取钱包详情"""
+    try:
+        wallets_dir = get_wallets_dir(args.wallets_dir)
+        index = load_wallet_index(wallets_dir)
+        
+        # 通过名称或 ID 查找钱包
+        target_wallet = None
+        target_id = None
+        
+        for wallet_id, wallet_info in index.get("wallets", {}).items():
+            if wallet_info.get("name") == args.identifier or wallet_id == args.identifier:
+                target_wallet = wallet_info
+                target_id = wallet_id
+                break
+        
+        if not target_wallet:
+            output_result({
+                "success": False,
+                "error": f"未找到钱包: {args.identifier}"
+            })
+            return
+        
+        # 读取完整钱包文件
+        wallet_file = wallets_dir / f"{target_id}.json"
+        if not wallet_file.exists():
+            output_result({
+                "success": False,
+                "error": f"钱包文件丢失: {target_id}"
+            })
+            return
+        
+        with open(wallet_file, "r", encoding="utf-8") as f:
+            wallet_data = json.load(f)
+        
+        # 查询余额
+        try:
+            w3 = get_web3()
+            balance_wei = w3.eth.get_balance(wallet_data["address"])
+            balance_claw = w3.from_wei(balance_wei, 'ether')
+            wallet_data["balance"] = f"{balance_claw} CLAW"
+            wallet_data["balance_wei"] = str(balance_wei)
+        except Exception as e:
+            wallet_data["balance"] = f"查询失败: {str(e)}"
+        
+        # 如果不显示私钥则隐藏
+        if not args.show_private_key:
+            wallet_data["private_key"] = "***已隐藏，使用 --show-private-key 显示***"
+        
+        output_result({
+            "success": True,
+            "wallet": wallet_data
+        })
+        
+    except Exception as e:
+        output_result({"success": False, "error": str(e)})
+
+
+# ============== 钱包删除命令 ==============
+
+def cmd_wallet_delete(args):
+    """删除钱包"""
+    try:
+        wallets_dir = get_wallets_dir(args.wallets_dir)
+        index = load_wallet_index(wallets_dir)
+        
+        # 通过名称或 ID 查找钱包
+        target_id = None
+        target_name = None
+        
+        for wallet_id, wallet_info in index.get("wallets", {}).items():
+            if wallet_info.get("name") == args.identifier or wallet_id == args.identifier:
+                target_id = wallet_id
+                target_name = wallet_info.get("name")
+                break
+        
+        if not target_id:
+            output_result({
+                "success": False,
+                "error": f"未找到钱包: {args.identifier}"
+            })
+            return
+        
+        # 删除钱包文件
+        wallet_file = wallets_dir / f"{target_id}.json"
+        if wallet_file.exists():
+            # 备份到 deleted 目录
+            deleted_dir = wallets_dir / "deleted"
+            deleted_dir.mkdir(exist_ok=True)
+            backup_file = deleted_dir / f"{target_id}_{int(time.time())}.json"
+            wallet_file.rename(backup_file)
+        
+        # 从索引中移除
+        del index["wallets"][target_id]
+        save_wallet_index(wallets_dir, index)
+        
+        output_result({
+            "success": True,
+            "message": f"钱包 '{target_name}' 已删除（备份已保存到 deleted 目录）",
+            "deleted_wallet": {
+                "id": target_id,
+                "name": target_name
+            }
+        })
+        
+    except Exception as e:
+        output_result({"success": False, "error": str(e)})
+
+
+# ============== 钱包重命名命令 ==============
+
+def cmd_wallet_rename(args):
+    """重命名钱包"""
+    try:
+        wallets_dir = get_wallets_dir(args.wallets_dir)
+        index = load_wallet_index(wallets_dir)
+        
+        # 通过名称或 ID 查找钱包
+        target_id = None
+        old_name = None
+        
+        for wallet_id, wallet_info in index.get("wallets", {}).items():
+            if wallet_info.get("name") == args.identifier or wallet_id == args.identifier:
+                target_id = wallet_id
+                old_name = wallet_info.get("name")
+                break
+        
+        if not target_id:
+            output_result({
+                "success": False,
+                "error": f"未找到钱包: {args.identifier}"
+            })
+            return
+        
+        # 检查新名称是否重复
+        for wallet_info in index.get("wallets", {}).values():
+            if wallet_info.get("name") == args.new_name:
+                output_result({
+                    "success": False,
+                    "error": f"钱包名称 '{args.new_name}' 已存在"
+                })
+                return
+        
+        # 更新索引
+        index["wallets"][target_id]["name"] = args.new_name
+        save_wallet_index(wallets_dir, index)
+        
+        # 更新钱包文件
+        wallet_file = wallets_dir / f"{target_id}.json"
+        if wallet_file.exists():
+            with open(wallet_file, "r", encoding="utf-8") as f:
+                wallet_data = json.load(f)
+            wallet_data["name"] = args.new_name
+            with open(wallet_file, "w", encoding="utf-8") as f:
+                json.dump(wallet_data, f, ensure_ascii=False, indent=2)
+        
+        output_result({
+            "success": True,
+            "message": f"钱包已重命名: '{old_name}' → '{args.new_name}'",
+            "wallet": {
+                "id": target_id,
+                "old_name": old_name,
+                "new_name": args.new_name
+            }
+        })
+        
+    except Exception as e:
+        output_result({"success": False, "error": str(e)})
+
+
+# ============== 余额查询命令 ==============
+
+def cmd_balance(args):
+    """查询余额"""
+    try:
+        w3 = get_web3()
+        
+        address = args.address
+        wallet_name = None
+        
+        # 如果提供的是钱包名称而非地址，则查找
+        if not address.startswith("0x"):
+            wallets_dir = get_wallets_dir(args.wallets_dir)
+            index = load_wallet_index(wallets_dir)
+            
+            for wallet_id, wallet_info in index.get("wallets", {}).items():
+                if wallet_info.get("name") == address or wallet_id == address:
+                    address = wallet_info["address"]
+                    wallet_name = wallet_info["name"]
+                    break
+            else:
+                output_result({
+                    "success": False,
+                    "error": f"未找到钱包: {args.address}，且不是有效的地址格式"
+                })
+                return
+        
+        # 验证地址格式
+        if not w3.is_address(address):
+            output_result({
+                "success": False,
+                "error": f"无效的地址格式: {address}"
+            })
+            return
+        
+        balance_wei = w3.eth.get_balance(address)
+        balance_claw = w3.from_wei(balance_wei, 'ether')
+        
+        result = {
+            "success": True,
+            "address": address,
+            "balance": f"{balance_claw} CLAW",
+            "balance_wei": str(balance_wei),
+            "chain": CLAWCHAIN_CONFIG["chain_name"]
+        }
+        
+        if wallet_name:
+            result["wallet_name"] = wallet_name
+        
+        output_result(result)
+        
+    except ConnectionError as e:
+        output_result({"success": False, "error": str(e)})
+    except Exception as e:
+        output_result({"success": False, "error": f"查询余额失败: {str(e)}"})
+
+
+# ============== 转账命令 ==============
+
+def cmd_transfer(args):
+    """转账 CLAW"""
+    try:
+        w3 = get_web3()
+        wallets_dir = get_wallets_dir(args.wallets_dir)
+        
+        # 获取发送方钱包
+        index = load_wallet_index(wallets_dir)
+        sender_wallet = None
+        sender_id = None
+        
+        for wallet_id, wallet_info in index.get("wallets", {}).items():
+            if wallet_info.get("name") == args.from_wallet or wallet_id == args.from_wallet:
+                sender_id = wallet_id
+                break
+        
+        if not sender_id:
+            output_result({
+                "success": False,
+                "error": f"未找到发送方钱包: {args.from_wallet}"
+            })
+            return
+        
+        # 读取钱包私钥
+        wallet_file = wallets_dir / f"{sender_id}.json"
+        with open(wallet_file, "r", encoding="utf-8") as f:
+            sender_wallet = json.load(f)
+        
+        private_key = sender_wallet["private_key"]
+        from_address = sender_wallet["address"]
+        
+        # 处理接收地址
+        to_address = args.to
+        to_wallet_name = None
+        
+        if not to_address.startswith("0x"):
+            # 可能是钱包名称
+            for wallet_id, wallet_info in index.get("wallets", {}).items():
+                if wallet_info.get("name") == to_address or wallet_id == to_address:
+                    to_address = wallet_info["address"]
+                    to_wallet_name = wallet_info["name"]
+                    break
+            else:
+                output_result({
+                    "success": False,
+                    "error": f"未找到接收方钱包: {args.to}，且不是有效的地址格式"
+                })
+                return
+        
+        if not w3.is_address(to_address):
+            output_result({
+                "success": False,
+                "error": f"无效的接收地址: {to_address}"
+            })
+            return
+        
+        # 转换金额
+        value = w3.to_wei(args.amount, 'ether')
+        
+        # 检查余额
+        balance = w3.eth.get_balance(from_address)
+        if balance < value:
+            output_result({
+                "success": False,
+                "error": f"余额不足。当前余额: {w3.from_wei(balance, 'ether')} CLAW，需要: {args.amount} CLAW"
+            })
+            return
+        
+        # 获取 gas price
+        gas_price = w3.eth.gas_price
+        
+        # 获取 nonce
+        nonce = w3.eth.get_transaction_count(from_address)
+        
+        # 构建交易
+        tx = {
+            'nonce': nonce,
+            'to': to_address,
+            'value': value,
+            'gas': CLAWCHAIN_CONFIG["gas_limit"],
+            'gasPrice': gas_price,
+            'chainId': CLAWCHAIN_CONFIG["chain_id"]
+        }
+        
+        # 估算 gas（可选，用于更精确的 gas 限制）
+        try:
+            estimated_gas = w3.eth.estimate_gas(tx)
+            tx['gas'] = int(estimated_gas * 1.2)  # 增加 20% 余量
+        except:
+            pass
+        
+        # 检查总花费
+        total_cost = value + (tx['gas'] * gas_price)
+        if balance < total_cost:
+            output_result({
+                "success": False,
+                "error": f"余额不足以支付 gas 费用。当前余额: {w3.from_wei(balance, 'ether')} CLAW，总需要: {w3.from_wei(total_cost, 'ether')} CLAW"
+            })
+            return
+        
+        # 签名并发送
+        signed_tx = w3.eth.account.sign_transaction(tx, private_key)
+        tx_hash = w3.eth.send_raw_transaction(signed_tx.raw_transaction)
+        tx_hash_hex = tx_hash.hex()
+        
+        result = {
+            "success": True,
+            "message": "交易已发送",
+            "transaction": {
+                "hash": tx_hash_hex,
+                "from": from_address,
+                "from_wallet": sender_wallet["name"],
+                "to": to_address,
+                "amount": f"{args.amount} CLAW",
+                "gas_price": f"{w3.from_wei(gas_price, 'gwei')} Gwei",
+                "estimated_fee": f"{w3.from_wei(tx['gas'] * gas_price, 'ether')} CLAW"
+            }
+        }
+        
+        if to_wallet_name:
+            result["transaction"]["to_wallet"] = to_wallet_name
+        
+        # 等待确认
+        if args.wait:
+            try:
+                receipt = w3.eth.wait_for_transaction_receipt(tx_hash, timeout=120)
+                if receipt.status == 1:
+                    result["confirmed"] = True
+                    result["block_number"] = receipt.blockNumber
+                    result["actual_gas_used"] = receipt.gasUsed
+                    result["actual_fee"] = f"{w3.from_wei(receipt.gasUsed * gas_price, 'ether')} CLAW"
+                else:
+                    result["confirmed"] = False
+                    result["error"] = "交易执行失败"
+            except Exception as e:
+                result["confirmed"] = False
+                result["error"] = f"等待确认超时: {str(e)}"
+        
+        output_result(result)
+        
+    except Exception as e:
+        output_result({"success": False, "error": str(e)})
+
+
+# ============== 交易查询命令 ==============
+
+def cmd_tx_info(args):
+    """查询交易详情"""
+    try:
+        w3 = get_web3()
+        
+        tx_hash = args.hash
+        if not tx_hash.startswith("0x"):
+            tx_hash = "0x" + tx_hash
+        
+        tx = w3.eth.get_transaction(tx_hash)
+        
+        result = {
+            "success": True,
+            "transaction": {
+                "hash": tx.hash.hex(),
+                "from": tx["from"],
+                "to": tx.to,
+                "value": f"{w3.from_wei(tx.value, 'ether')} CLAW",
+                "value_wei": str(tx.value),
+                "gas": tx.gas,
+                "gas_price": f"{w3.from_wei(tx.gasPrice, 'gwei')} Gwei",
+                "nonce": tx.nonce,
+                "block_number": tx.blockNumber
+            }
+        }
+        
+        # 获取回执
+        try:
+            receipt = w3.eth.get_transaction_receipt(tx_hash)
+            result["transaction"]["status"] = "成功" if receipt.status == 1 else "失败"
+            result["transaction"]["gas_used"] = receipt.gasUsed
+            result["transaction"]["actual_fee"] = f"{w3.from_wei(receipt.gasUsed * tx.gasPrice, 'ether')} CLAW"
+        except:
+            result["transaction"]["status"] = "待确认"
+        
+        output_result(result)
+        
+    except Exception as e:
+        output_result({"success": False, "error": f"查询交易失败: {str(e)}"})
+
+
+# ============== 交易历史命令 ==============
+
+def cmd_tx_history(args):
+    """查询钱包交易历史"""
+    try:
+        w3 = get_web3()
+        wallets_dir = get_wallets_dir(args.wallets_dir)
+        
+        # 获取地址
+        address = args.address
+        wallet_name = None
+        
+        if not address.startswith("0x"):
+            index = load_wallet_index(wallets_dir)
+            for wallet_id, wallet_info in index.get("wallets", {}).items():
+                if wallet_info.get("name") == address or wallet_id == address:
+                    address = wallet_info["address"]
+                    wallet_name = wallet_info["name"]
+                    break
+            else:
+                output_result({
+                    "success": False,
+                    "error": f"未找到钱包: {args.address}"
+                })
+                return
+        
+        address = address.lower()
+        latest_block = w3.eth.block_number
+        start_block = max(0, latest_block - args.blocks)
+        
+        transactions = []
+        
+        for block_num in range(start_block, latest_block + 1):
+            try:
+                block = w3.eth.get_block(block_num, full_transactions=True)
+                for tx in block.transactions:
+                    if tx['from'].lower() == address or (tx.to and tx.to.lower() == address):
+                        direction = "发送" if tx['from'].lower() == address else "接收"
+                        transactions.append({
+                            "hash": tx.hash.hex(),
+                            "block": block_num,
+                            "from": tx['from'],
+                            "to": tx.to,
+                            "value": f"{w3.from_wei(tx.value, 'ether')} CLAW",
+                            "direction": direction,
+                            "timestamp": block.timestamp
+                        })
+            except:
+                continue
+        
+        result = {
+            "success": True,
+            "address": address,
+            "scanned_blocks": args.blocks,
+            "transaction_count": len(transactions),
+            "transactions": transactions[-args.limit:]
+        }
+        
+        if wallet_name:
+            result["wallet_name"] = wallet_name
+        
+        output_result(result)
+        
+    except Exception as e:
+        output_result({"success": False, "error": str(e)})
+
+
+# ============== 链信息命令 ==============
+
+def cmd_chain_info(args):
+    """查询链信息"""
+    try:
+        w3 = get_web3()
+        
+        output_result({
+            "success": True,
+            "chain": {
+                "name": CLAWCHAIN_CONFIG["chain_name"],
+                "token_symbol": CLAWCHAIN_CONFIG["token_symbol"],
+                "rpc_url": CLAWCHAIN_CONFIG["rpc_url"],
+                "chain_id": CLAWCHAIN_CONFIG["chain_id"],
+                "connected": True,
+                "latest_block": w3.eth.block_number,
+                "gas_price": f"{w3.from_wei(w3.eth.gas_price, 'gwei')} Gwei"
+            }
+        })
+        
+    except ConnectionError:
+        output_result({
+            "success": True,
+            "chain": {
+                "name": CLAWCHAIN_CONFIG["chain_name"],
+                "token_symbol": CLAWCHAIN_CONFIG["token_symbol"],
+                "rpc_url": CLAWCHAIN_CONFIG["rpc_url"],
+                "chain_id": CLAWCHAIN_CONFIG["chain_id"],
+                "connected": False
+            }
+        })
+    except Exception as e:
+        output_result({"success": False, "error": str(e)})
+
+
+# ============== 区块查询命令 ==============
+
+def cmd_block_info(args):
+    """查询区块信息"""
+    try:
+        w3 = get_web3()
+        
+        if args.number == "latest":
+            block = w3.eth.get_block('latest')
+        else:
+            block = w3.eth.get_block(int(args.number))
+        
+        output_result({
+            "success": True,
+            "block": {
+                "number": block.number,
+                "hash": block.hash.hex(),
+                "parent_hash": block.parentHash.hex(),
+                "timestamp": block.timestamp,
+                "transaction_count": len(block.transactions),
+                "gas_used": block.gasUsed,
+                "gas_limit": block.gasLimit
+            }
+        })
+        
+    except Exception as e:
+        output_result({"success": False, "error": str(e)})
+
+
+# ============== 导出钱包命令 ==============
+
+def cmd_wallet_export(args):
+    """导出钱包（显示私钥）"""
+    try:
+        wallets_dir = get_wallets_dir(args.wallets_dir)
+        index = load_wallet_index(wallets_dir)
+        
+        # 通过名称或 ID 查找钱包
+        target_id = None
+        
+        for wallet_id, wallet_info in index.get("wallets", {}).items():
+            if wallet_info.get("name") == args.identifier or wallet_id == args.identifier:
+                target_id = wallet_id
+                break
+        
+        if not target_id:
+            output_result({
+                "success": False,
+                "error": f"未找到钱包: {args.identifier}"
+            })
+            return
+        
+        # 读取完整钱包文件
+        wallet_file = wallets_dir / f"{target_id}.json"
+        with open(wallet_file, "r", encoding="utf-8") as f:
+            wallet_data = json.load(f)
+        
+        output_result({
+            "success": True,
+            "wallet": {
+                "name": wallet_data["name"],
+                "address": wallet_data["address"],
+                "private_key": wallet_data["private_key"]
+            },
+            "warning": "请妥善保管私钥，不要泄露给他人！"
+        })
+        
+    except Exception as e:
+        output_result({"success": False, "error": str(e)})
+
+
+# ============== 领取空投命令 ==============
+
+# Faucet API 配置
+FAUCET_API_URL = "https://faucet.clawchain.net/api/claim"
+
+def cmd_claim_airdrop(args):
+    """通过 moltbook 帖子领取 CLAW 空投"""
+    try:
+        post_url = args.post_url
+        
+        # 验证 URL 格式
+        if not post_url or not post_url.startswith("https://"):
+            output_result({
+                "success": False,
+                "error": "无效的帖子 URL，必须是 https:// 开头的完整 URL"
+            })
+            return
+        
+        # 验证是否是 moltbook URL
+        if "moltbook.com" not in post_url:
+            output_result({
+                "success": False,
+                "error": "帖子 URL 必须是 moltbook.com 的链接",
+                "hint": "请先在 moltbook 上发布包含你钱包地址的帖子或回复"
+            })
+            return
+        
+        # 构建请求数据
+        request_data = json.dumps({"post_url": post_url}).encode("utf-8")
+        
+        # 发送请求到 faucet API
+        req = urllib.request.Request(
+            FAUCET_API_URL,
+            data=request_data,
+            headers={
+                "Content-Type": "application/json",
+                "User-Agent": "ClawChainWallet/1.0"
+            },
+            method="POST"
+        )
+        
+        try:
+            with urllib.request.urlopen(req, timeout=30) as response:
+                response_data = json.loads(response.read().decode("utf-8"))
+                
+                output_result({
+                    "success": True,
+                    "message": "空投领取请求已发送",
+                    "post_url": post_url,
+                    "faucet_response": response_data
+                })
+                
+        except urllib.error.HTTPError as e:
+            error_body = e.read().decode("utf-8") if e.fp else ""
+            try:
+                error_data = json.loads(error_body)
+                error_msg = error_data.get("error", error_data.get("message", str(e)))
+            except:
+                error_msg = error_body or str(e)
+            
+            output_result({
+                "success": False,
+                "error": f"Faucet API 错误: {error_msg}",
+                "status_code": e.code,
+                "post_url": post_url
+            })
+            
+        except urllib.error.URLError as e:
+            output_result({
+                "success": False,
+                "error": f"网络错误: {str(e.reason)}",
+                "hint": "请检查网络连接或稍后重试"
+            })
+            
+    except Exception as e:
+        output_result({"success": False, "error": str(e)})
+
+
+# ============== JSON Stdin 处理 ==============
+
+class JsonStdinArgs:
+    """模拟 argparse.Namespace，用于 JSON stdin 模式"""
+    def __init__(self, data: Dict[str, Any]):
+        self._data = data
+        self.wallets_dir = data.get("wallets_dir")
+        self.command = data.get("command")
+        args = data.get("args", {})
+        
+        # 通用参数
+        self.name = args.get("name")
+        self.identifier = args.get("identifier")
+        self.new_name = args.get("new_name")
+        self.address = args.get("address")
+        self.hash = args.get("hash")
+        self.number = args.get("number", "latest")
+        
+        # 钱包导入参数
+        self.private_key = args.get("private_key")
+        
+        # 布尔参数
+        self.show_balance = args.get("show_balance", False)
+        self.show_private_key = args.get("show_private_key", False)
+        self.wait = args.get("wait", False)
+        
+        # 转账参数
+        self.from_wallet = args.get("from_wallet")
+        self.to = args.get("to")
+        self.amount = args.get("amount")
+        
+        # 交易历史参数
+        self.blocks = args.get("blocks", 1000)
+        self.limit = args.get("limit", 20)
+        
+        # 空投领取参数
+        self.post_url = args.get("post_url")
+
+
+def handle_json_stdin():
+    """处理 JSON stdin 输入模式"""
+    try:
+        # 从 stdin 读取 JSON
+        json_input = sys.stdin.read()
+        data = json.loads(json_input)
+        
+        # 创建参数对象
+        args = JsonStdinArgs(data)
+        
+        if not args.command:
+            output_result({"success": False, "error": "缺少 command 字段"})
+            return
+        
+        # 命令映射
+        commands = {
+            "wallet-create": cmd_wallet_create,
+            "wallet-import": cmd_wallet_import,
+            "wallet-list": cmd_wallet_list,
+            "wallet-info": cmd_wallet_info,
+            "wallet-delete": cmd_wallet_delete,
+            "wallet-rename": cmd_wallet_rename,
+            "wallet-export": cmd_wallet_export,
+            "balance": cmd_balance,
+            "transfer": cmd_transfer,
+            "tx-info": cmd_tx_info,
+            "tx-history": cmd_tx_history,
+            "chain-info": cmd_chain_info,
+            "block-info": cmd_block_info,
+            "claim-airdrop": cmd_claim_airdrop
+        }
+        
+        handler = commands.get(args.command)
+        if handler:
+            handler(args)
+        else:
+            output_result({"success": False, "error": f"未知命令: {args.command}"})
+            
+    except json.JSONDecodeError as e:
+        output_result({"success": False, "error": f"JSON 解析错误: {str(e)}"})
+    except Exception as e:
+        output_result({"success": False, "error": f"处理错误: {str(e)}"})
+
+
+# ============== 主程序 ==============
+
+def main():
+    # 检查是否使用 JSON stdin 模式
+    if len(sys.argv) == 2 and sys.argv[1] == "--json-stdin":
+        handle_json_stdin()
+        return
+    
+    parser = argparse.ArgumentParser(
+        description="ClawChain CLI - ClawChain 私有链钱包管理工具"
+    )
+    parser.add_argument("--wallets-dir", dest="wallets_dir", help="自定义钱包存储目录")
+    parser.add_argument("--json-stdin", dest="json_stdin", action="store_true", help="从 stdin 读取 JSON 参数")
+    
+    subparsers = parser.add_subparsers(dest="command", help="可用命令")
+    
+    # === wallet create ===
+    wallet_create = subparsers.add_parser("wallet-create", help="创建新钱包")
+    wallet_create.add_argument("--name", help="钱包名称")
+    
+    # === wallet import ===
+    wallet_import = subparsers.add_parser("wallet-import", help="导入钱包")
+    wallet_import.add_argument("--private-key", dest="private_key", required=True, help="私钥")
+    wallet_import.add_argument("--name", help="钱包名称")
+    
+    # === wallet list ===
+    wallet_list = subparsers.add_parser("wallet-list", help="列出所有钱包")
+    wallet_list.add_argument("--show-balance", dest="show_balance", action="store_true", help="显示余额")
+    
+    # === wallet info ===
+    wallet_info = subparsers.add_parser("wallet-info", help="获取钱包详情")
+    wallet_info.add_argument("identifier", help="钱包名称或 ID")
+    wallet_info.add_argument("--show-private-key", dest="show_private_key", action="store_true", help="显示私钥")
+    
+    # === wallet delete ===
+    wallet_delete = subparsers.add_parser("wallet-delete", help="删除钱包")
+    wallet_delete.add_argument("identifier", help="钱包名称或 ID")
+    
+    # === wallet rename ===
+    wallet_rename = subparsers.add_parser("wallet-rename", help="重命名钱包")
+    wallet_rename.add_argument("identifier", help="钱包名称或 ID")
+    wallet_rename.add_argument("new_name", help="新名称")
+    
+    # === wallet export ===
+    wallet_export = subparsers.add_parser("wallet-export", help="导出钱包私钥")
+    wallet_export.add_argument("identifier", help="钱包名称或 ID")
+    
+    # === balance ===
+    balance = subparsers.add_parser("balance", help="查询余额")
+    balance.add_argument("address", help="钱包地址、名称或 ID")
+    
+    # === transfer ===
+    transfer = subparsers.add_parser("transfer", help="转账 CLAW")
+    transfer.add_argument("--from", dest="from_wallet", required=True, help="发送方钱包名称或 ID")
+    transfer.add_argument("--to", required=True, help="接收方地址、钱包名称或 ID")
+    transfer.add_argument("--amount", type=float, required=True, help="转账金额 (CLAW)")
+    transfer.add_argument("--wait", action="store_true", help="等待交易确认")
+    
+    # === tx info ===
+    tx_info = subparsers.add_parser("tx-info", help="查询交易详情")
+    tx_info.add_argument("hash", help="交易哈希")
+    
+    # === tx history ===
+    tx_history = subparsers.add_parser("tx-history", help="查询交易历史")
+    tx_history.add_argument("address", help="钱包地址、名称或 ID")
+    tx_history.add_argument("--blocks", type=int, default=1000, help="扫描区块数量 (默认: 1000)")
+    tx_history.add_argument("--limit", type=int, default=20, help="显示数量限制 (默认: 20)")
+    
+    # === chain info ===
+    subparsers.add_parser("chain-info", help="查询链信息")
+    
+    # === block info ===
+    block_info = subparsers.add_parser("block-info", help="查询区块信息")
+    block_info.add_argument("number", nargs="?", default="latest", help="区块号 (默认: latest)")
+    
+    # === claim airdrop ===
+    claim_airdrop = subparsers.add_parser("claim-airdrop", help="通过 moltbook 帖子领取 CLAW 空投")
+    claim_airdrop.add_argument("--post-url", dest="post_url", required=True, help="moltbook 帖子或回复的 URL")
+    
+    # 解析参数
+    args = parser.parse_args()
+    
+    if not args.command:
+        parser.print_help()
+        return
+    
+    # 执行命令
+    commands = {
+        "wallet-create": cmd_wallet_create,
+        "wallet-import": cmd_wallet_import,
+        "wallet-list": cmd_wallet_list,
+        "wallet-info": cmd_wallet_info,
+        "wallet-delete": cmd_wallet_delete,
+        "wallet-rename": cmd_wallet_rename,
+        "wallet-export": cmd_wallet_export,
+        "balance": cmd_balance,
+        "transfer": cmd_transfer,
+        "tx-info": cmd_tx_info,
+        "tx-history": cmd_tx_history,
+        "chain-info": cmd_chain_info,
+        "block-info": cmd_block_info,
+        "claim-airdrop": cmd_claim_airdrop
+    }
+    
+    handler = commands.get(args.command)
+    if handler:
+        handler(args)
+    else:
+        parser.print_help()
+
+
+if __name__ == "__main__":
+    main()