Solana 账户交易日志抓取器

解决什么问题

在 Solana 区块链开发中，快速获取某个地址的交易历史和日志是一个常见但繁琐的任务。开发者通常需要：

• 编写脚本调用 RPC 接口
• 处理地址验证
• 解析交易数据
• 管理 API 密钥和环境变量
• 处理 IDL（接口定义语言）来解码交易

这个技能将整个过程自动化，从地址验证到日志拉取，再到结构化输出。

工作流程

当用户提供 Solana 地址时，技能会立即开始工作：

1. 地址验证：使用 isSolanaAddress 检查地址格式，无效地址直接拒绝，不会写入或拉取
2. 项目脚手架：如果当前目录没有项目，自动创建 ./fetch_solana_logs 项目结构
3. 配置持久化：将目标地址写入 target_solana_addr.json，支持多个地址的数组格式
4. 环境准备：检查或创建 .env 文件，优先使用用户提供的 HELIUS_API_KEY，否则从 .env.example 复制
5. 拉取与解析：

- pnpm s1 从 Solana RPC 拉取交易
- pnpm s2 解析交易并生成结构化日志

1. IDL 处理：自动尝试获取 on-chain Anchor IDL，如果程序没有 IDL，会提示用户提供

支持灵活的命令行参数：

• --limit N 限制拉取最近 N 笔交易
• --addr <address> 针对多地址配置只拉取特定地址

适用场景与注意事项

适合的情况：

• 需要快速获取 Solana 地址的交易历史
• 调试智能合约时需要查看交易日志
• 分析特定 program 的 instruction 调用

不适合的情况：

• EVM 链的日志（应该使用 fetch-evm-logs）
• 只需要统计数据的分析
• 一般的 Solana 问答（不涉及拉取交易）

注意事项：

• 完整历史同步需要 Helius API Key，公共 RPC 有速率限制
• 钱包地址或非 Anchor 程序可能没有 IDL，但交易仍可正常拉取
• 如果没有提供地址，会直接询问，不会询问不必要的选项