tronscan-test

TronScan Agentic Test Toolkit — AI-driven E2E & API test automation for tronscan.org.

Quick Start

# 初始化测试项目
npx tronscan-test init my-tests
cd my-tests

# 安装依赖
npm install -D @playwright/test typescript @types/node
npx playwright install chromium

# 运行全部测试 (47 cases)
npx tronscan-test test

# 运行指定页面
npx tronscan-test test homepage
npx tronscan-test test token
npx tronscan-test test block
npx tronscan-test test transaction
npx tronscan-test test address
npx tronscan-test test contract

# 带浏览器界面
npx tronscan-test test --headed

# 查看 HTML 报告 (含视频录制 + Trace + 截图)
npx tronscan-test report

AI Agent Setup

一行命令为你的 AI 平台生成配置：

npx tronscan-test setup-agent claude      # Claude Code
npx tronscan-test setup-agent cursor      # Cursor
npx tronscan-test setup-agent copilot     # GitHub Copilot
npx tronscan-test setup-agent windsurf    # Windsurf

MCP Server

任何支持 MCP 的 AI 工具都可以连接：

{
  "mcpServers": {
    "tronscan-test": {
      "command": "npx",
      "args": ["tronscan-test-mcp"]
    }
  }
}

Commands

| Command | Description | |---------|-------------| | npx tronscan-test init [dir] | 初始化测试项目 | | npx tronscan-test test [page] | 运行测试 | | npx tronscan-test report | 打开 HTML 报告 | | npx tronscan-test setup-agent <platform> | 配置 AI 平台 | | npx tronscan-test mcp | 启动 MCP Server | | npx tronscan-test heal | 自动修复失败测试 |

Test Coverage

| Page | Cases | Coverage | |------|-------|----------| | Homepage | 7 | 加载、统计、Trending、搜索、导航 | | Block | 6 | 列表、详情、交易、导航、异常 | | Transaction | 7 | 列表、哈希、地址、状态、资源消耗 | | Address | 7 | 余额、Tab 切换、TRC20、分页 | | Contract | 7 | 代码、创建者、Read/Write | | Token List | 13 | Tab 切换、表格、USDT、分页、过滤 |

Project Structure

tests/          # 47 E2E test cases
pages/          # 6 Page Object Models
utils/          # TRON API utilities
agents/         # AI Agent instructions (Planner/Generator/Healer/DataValidator)
specs/          # Test plans (Markdown)
bin/            # CLI & MCP entry points

License

ISC