WalletLens

一款先进的多链钱包分析工具，可为钱包生成详尽的档案信息，支持以 USD 计价、NFT 集合名称的人类可读化展示、ENS 域名解析，并在 8 大主流 EVM 网络上实现高阶机器人账户检测能力。

核心功能

• 多链支持：覆盖 8 条 EVM 网络，以 ApeChain 为主要优化目标
• USD 价格集成：通过 CoinGecko 提供实时代币价格，具备优雅降级机制
• ENS 域名支持：所有命令自动解析 .eth 域名
• 集合名称解析：通过 Alchemy API + RPC 回退机制获取人类可读的 NFT 集合名称
• 自然语言摘要：启用 --pretty 模式时提供智能钱包洞察
• 高级机器人检测：采用复杂评分算法识别自动化账户
• 稳定可靠性能：内置自动重试逻辑与指数退避策略，保障网络韧性
• 双输出格式：默认 JSON 格式（适用于 Agent 工作流），--pretty 标志启用人类可读文本输出
• 依赖极简：默认使用公开 RPC 端点；可选配置 Alchemy API Key 以启用增强功能

安装

本技能需 Node.js（v16+）。无需额外依赖——直接使用内置 fetch API。

# 验证 Node.js 版本
node --version

快速入门

在 ApeChain 上执行基础钱包查询：

node scripts/wallet-lookup.js 0x8dd6390be6dc732c92b161b9793a3948b56c0126

相同查询，启用人类可读输出：

node scripts/wallet-lookup.js 0x8dd6390be6dc732c92b161b9793a3948b56c0126 --pretty

在 Ethereum 上执行跨链查询：

node scripts/wallet-lookup.js 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 --chain ethereum --pretty

命令参考

所有命令均支持 --chain 参数（默认为 apechain）及 --pretty 标志（启用人类可读输出）。

钱包查询（Wallet Lookup）

用途：生成完整钱包档案，包含原生代币余额、交易总数及 NFT 活动摘要

node scripts/wallet-lookup.js 
 [--chain ] [--pretty]

返回内容：原生代币余额、交易总数、NFT 活动（接收/发送数量）、持有 NFT 集合数、持仓 Top 列表

示例输出（JSON 格式）：

{
  "address": "0x8dd6390be6dc732c92b161b9793a3948b56c0126",
  "chain": "ApeChain",
  "chainId": 33139,
  "isContract": false,
  "balance": { "APE": 10.1398 },
  "transactionCount": 6352,
  "nftActivity": { "received": 2, "sent": 1 },
  "nftCollectionsHeld": 1,
  "topHoldings": [
    { "contract": "0x6f2a21a8b9cf699d7d3a713a9d7cfbb9e9760f97", "count": 2 }
  ],
  "explorer": "https://apescan.io/address/0x8dd6390be6dc732c92b161b9793a3948b56c0126"
}

示例输出（Pretty 格式）：

🔍 钱包: 0x8dd6390be6dc732c92b161b9793a3948b56c0126
⛓️  链: ApeChain (33139)
💰 余额: 10.1398 APE
📊 交易数: 6,352
🎨 NFT 活动: 接收 2 笔，发送 1 笔
📦 集合数: 1
🔗 浏览器: https://apescan.io/address/0x8dd6390be6dc732c92b161b9793a3948b56c0126

合约信息（Contract Information）

用途：提供智能合约的深度分析，包括合约类型识别与元数据提取

node scripts/contract-info.js 
 [--chain ] [--pretty]

返回内容：合约类型（ERC-20 / ERC-721 / ERC-1155）、名称、符号、总供应量、小数位数、所有者地址

典型用例：代币调研、合约验证、尽职调查

交易历史（Transaction History）

用途：获取近期转账活动，含时间戳与完整交易细节

node scripts/tx-history.js 
 [--chain ] [--limit ] [--pretty]

返回内容：近期 ERC-20 与 NFT 转账记录，标注方向（IN/OUT）、时间戳、合约地址

典型用例：活动分析、交易追踪、钱包监控

NFT 持仓（NFT Holdings）

用途：列出当前持有的全部 NFT 集合，并提供详细 Token 信息

node scripts/nft-holdings.js 
 [--chain ] [--collection ] [--pretty]

返回内容：按集合分组的当前持有 NFT、Token ID 列表、转移统计信息

典型用例：NFT 投资组合分析、集合追踪、投资研究

机器人检测（Bot Detection）

用途：基于行为模式的高级分析，识别潜在自动化账户

node scripts/bot-detect.js 
 [--chain ] [--pretty]

返回内容：机器人评分（0–100）、判定分类、各评分维度的详细拆解

评分维度：

• 封装代币使用频率（30 分）：使用封装型原生代币（如 wETH、wAPE）的频次
• 快速倒手（25 分）：24 小时内完成“买入→卖出”循环的次数
• 快速上架（20 分）：购入后 30 分钟内即上架出售
• 激进定价（15 分）：存在明显价格操纵行为模式
• 跨集合活动（10 分）：在大量不同 NFT 集合中均有活跃行为

评分解读：

• 75–100：确定为机器人
• 60–74：很可能为机器人
• 40–59：存疑
• 20–39：大概率为真人
• 0–19：真人

典型用例：尽职调查、空投资格筛选、社区成员真实性验证

支持的网络

详见 references/CHAINS.md，其中包含各链的完整性状态说明与性能特征详情。

稳定链 ✅

• ApeChain（主推）——速度最快、可靠性最高
• Ethereum——稳定性强，适用于高价值地址分析
• Base——L2 性能优异，响应迅速
• Arbitrum——L2 可靠性高，官方 RPC 支持完善

间歇性链 🟡

• Polygon——偶发超时，建议配合重试逻辑使用
• Optimism——偶有性能波动
• BNB Chain——可靠性随网络负载变化
• Avalanche——测试覆盖有限，建议谨慎使用

输出格式

所有脚本均支持两种输出模式：

JSON 格式（默认）

结构化数据，专为程序化调用与 Agent 工作流设计：

node scripts/wallet-lookup.js 

# 返回格式化 JSON 数据

Pretty 格式（人类可读）

简洁清晰、带 emoji 的文本输出，便于人工审阅：

node scripts/wallet-lookup.js 
 --pretty
# 返回带 emoji 与清晰分区的格式化文本

环境变量

无需配置任何环境变量。该技能默认使用 scripts/lib/rpc.js 中预设的公共 RPC 端点。

自定义 RPC 端点（高级）

如需使用自定义 RPC 端点，请修改 scripts/lib/rpc.js 中的 CHAINS 对象：

const CHAINS = {
  apechain: { 
    id: 33139, 
    rpc: "your-custom-rpc-url", 
    name: "ApeChain", 
    symbol: "APE", 
    explorer: "https://apescan.io" 
  },
  // ... 其他链配置
};

错误处理与可靠性

自动重试逻辑

• 最多重试 3 次，采用指数退避策略（500ms → 1s → 2s）
• 单次请求超时上限为 10 秒
• 失败时返回清晰、无堆栈跟踪的错误提示

输入校验

• 地址格式校验（必须为 0x 开头 + 40 位十六进制字符）
• 链名称校验（是否在支持列表中）
• 错误信息简洁明确，不暴露技术细节

常见错误消息

{"error": "Invalid address format. Address must be 0x followed by 40 hexadecimal characters"}
{"error": "Unsupported chain "invalidchain". Supported chains: apechain, ethereum, base, arbitrum, polygon, optimism, avalanche, bsc"}
{"error": "RPC request timed out after 10000ms"}

性能与限制

响应时间

• 快速（< 1 秒）：ApeChain、Arbitrum
• 良好（1–2 秒）：Ethereum、Base
• 波动（1–5 秒）：Polygon、Optimism、BNB Chain、Avalanche

数据覆盖范围

• 近期活动：根据链性能差异，覆盖最近 50 万至 200 万个区块
• 历史数据限制：极早期交易可能无法检索
• NFT 检测：通过 Transfer 事件支持 ERC-721 和 ERC-1155 标准
• 机器人分析：评分需至少 3 笔 NFT 购买行为作为基础

资源占用

• 内存：极低——采用流式处理方式
• 网络：查询期间突发使用，其余时间空闲
• CPU：极低——主要为 I/O 密集型操作

故障排查

网络问题

# 若发生 RPC 超时，可尝试切换至其他链：
node scripts/wallet-lookup.js 
 --chain ethereum

# 对于间歇性链，重试通常可成功：
node scripts/wallet-lookup.js 
 --chain polygon

空结果

• 确认该地址在所选链上确为活跃地址
• 若预期存在跨链活动，可尝试其他链
• 针对较早的历史活动，可扩大区块扫描范围

性能优化建议

• 使用 --limit 参数限制交易历史返回条数
• 优先选用稳定链（ApeChain、Ethereum、Base、Arbitrum）保障一致性体验
• 关注各链实际响应时间，合理调整性能预期

高级用法

批量分析

# 批量分析多个地址
for addr in 0xaddr1 0xaddr2 0xaddr3; do
  echo "=== Analysis for $addr ==="
  node scripts/wallet-lookup.js $addr --pretty
  node scripts/bot-detect.js $addr --pretty
  echo
done

跨链调查

# 在多条链上同步检查同一地址
for chain in apechain ethereum base arbitrum; do
  echo "=== $chain ==="
  node scripts/wallet-lookup.js 0x8dd6390be6dc732c92b161b9793a3948b56c0126 --chain $chain --pretty
done

集合专项分析

# 聚焦特定 NFT 集合
node scripts/nft-holdings.js 
 --collection 0x --pretty

参考资料

• 链详情：references/CHAINS.md —— 各链状态与性能数据全览
• 机器人评分机制：references/bot-scoring.md —— 机器人检测方法论详解

版本历史

• v2.0：新增自动重试逻辑、输入校验、Pretty 格式输出、全面链文档
• v1.0：初始发布，支持基础多链查询与机器人检测

需要帮助？请查阅 references 目录下的详细文档，或运行任意命令时不带参数以获取使用说明。