介绍
# Einstein — Blockchain Analytics via x402
Einstein 提供 27 种区块链分析服务，可通过 x402 微支付（Base 网络上的 USDC）访问。每次查询费用根据复杂度为 $0.25–$1.15 不等。
## 快速开始
```bash # 1. Install dependencies (manual step — the setup wizard will NOT run npm for you) cd packages/project-einstein/openclaw-skill/einstein && npm install
# 2. Set your private key via environment variable (recommended) export EINSTEIN_X402_PRIVATE_KEY=0x_your_private_key_here
# 3. Or run the interactive setup wizard node scripts/einstein-setup.mjs
# 4. List all services (free) node scripts/einstein.mjs services
# 5. Run a query (will prompt for payment confirmation) node scripts/einstein.mjs top-movers --chain base --limit 10 ```
**要求：** - Node.js 18+ - 通过 `npm install` 安装的依赖项（不会自动安装） - 一个**专用**的钱包私钥，需持有 Base 网络上的 USDC（请勿使用您的主钱包） - 设置 `EINSTEIN_X402_PRIVATE_KEY` 环境变量（推荐）或使用 `--save-config` 运行设置
## 服务类别
| 级别 | 原始价格 | 价格 (+AI) | 服务 | |------|-------------|-------------|----------| | 基础 | $0.25 | $0.40 | 最新代币，代币走势图 | | 标准 | $0.40 | $0.55 | 涨幅榜，热门代币，OHLCV，Virtuals，钱包持仓，持有者集中度 | | 平台 | $0.60 | $0.75 | Zora 发布/交易量，Pump.fun 发布/交易量/毕业，BSC alpha，流动性转移 | | 高级 | $0.85 | $1.00 | 巨鲸情报，聪明钱，顶级交易者，DEX 资金，代币狙击，Polymarket 事件 | | 全面 | $1.00 | $1.15 | 投资报告，NFT 分析，MEV 检测，套利扫描器，Rug Pull 扫描器，Polymarket 对比 |
**原始** = 仅结构化数据。**+AI** = 包含 AI 生成的分析和洞察（默认）。
## 免费服务
这些命令是免费的，不需要 x402 支付或钱包密钥。
### Epstein 文件搜索
通过 DugganUSA 公共索引搜索美国司法部（DOJ）发布的 44,886+ 份 Jeffrey Epstein 文件（2026 年 1 月发布）。
```bash # Search by name node scripts/einstein.mjs epstein-search --query "Ghislaine Maxwell" --limit 10
# Search by topic node scripts/einstein.mjs epstein-search --query "flight logs" --limit 20
# Search by location node scripts/einstein.mjs epstein-search --query "Little St James" ```
| 标志 | 描述 | 默认值 | |------|-------------|---------| | `--query <terms>` | 搜索查询（必填） | — | | `--limit <N>` | 结果数量 (1-500) | `10` |
## 使用示例
### 市场分析
```bash # Top movers on Base in the last 24 hours node scripts/einstein.mjs top-movers --chain base --timeperiod 1d --limit 10
# Top tokens by market cap on Ethereum node scripts/einstein.mjs top-tokens --chain ethereum --limit 20
# Latest deployed tokens with liquidity node scripts/einstein.mjs latest-tokens --chain base --limit 15 ```
### 巨鲸与聪明钱情报
```bash # Track whale accumulation on Ethereum node scripts/einstein.mjs whale-intel --chain ethereum --limit 10 --timeperiod 7d
# Smart money leaderboard on Base node scripts/einstein.mjs smart-money --chain base --limit 20 --timeperiod 7d
# Capital-intensive DEX traders node scripts/einstein.mjs dex-capital --chain base --limit 10 --timeperiod 3d ```
### 安全与风险分析
```bash # Scan a token for rug pull risk node scripts/einstein.mjs rug-scan --chain ethereum --token 0x1234...abcd
# Detect MEV/sandwich attacks node scripts/einstein.mjs mev-detect --chain ethereum --limit 10 --timeperiod 1d
# Identify early snipers on a token node scripts/einstein.mjs token-snipe --chain base --token 0x1234...abcd --limit 20 ```
### 发射台监控
```bash # Latest Pump.fun launches on Solana node scripts/einstein.mjs pump-launches --limit 15 --timeperiod 1d
# Pump.fun tokens about to graduate node scripts/einstein.mjs pump-grads --limit 10
# Zora launches on Base node scripts/einstein.mjs zora-launches --limit 10 --timeperiod 3d
# Virtuals Protocol agent tokens node scripts/einstein.mjs virtuals --limit 10 --timeperiod 7d ```
### 投资组合与代币分析
```bash # Check wallet holdings node scripts/einstein.mjs wallet --chain ethereum --wallet 0xd8dA...
# Token holder concentration node scripts/einstein.mjs holders --chain base --token 0x1234... --limit 50
# Token price chart node scripts/einstein.mjs chart --chain base --token 0x1234... --timeperiod 7d
# OHLCV data for technical analysis node scripts/einstein.mjs ohlcv --chain base --token 0x1234... --timeperiod 30d ```
### 高级报告
```bash # Multi-chain investment report node scripts/einstein.mjs investment-report --chains base,ethereum,bsc --limit 10 --timeperiod 7d
# Cross-chain arbitrage opportunities node scripts/einstein.mjs arbitrage --chain ethereum --limit 10 --timeperiod 1d
# NFT collection analytics node scripts/einstein.mjs nft-analytics --chain ethereum --limit 10 --timeperiod 7d ```
### 预测市场
```bash # Polymarket events (Polygon) node scripts/einstein.mjs polymarket --limit 10 --timeperiod 7d
# Compare Polymarket API vs chain data node scripts/einstein.mjs polymarket-compare --limit 10 ```
## 支付原理
Einstein 使用 **x402 协议** —— 一种 HTTP 原生微支付标准。支付是自动进行的：
1. 您的请求发送至 Einstein 的端点 2. 服务器响应 HTTP 402 + 支付挑战 3. 该技能使用您的私钥签署 USDC TransferWithAuthorization (EIP-3009) 4. 请求附带支付签名重新发送 5. Coinbase CDP 助手在 Base 上结算 USDC 转账 6. 您收到分析数据
**无需账户，无需 API 密钥，无需订阅。** 只需要 Base 网络上的 USDC 和一个私钥。
## 选项参考
### `einstein.mjs` (查询 CLI)
| 标志 | 描述 | 默认值 | |------|-------------|---------| | `--chain <chain>` | 区块链网络 | `base` | | `--limit <N>` | 结果数量 (1-500) | `10` | | `--timeperiod <period>` | 时间窗口: 1d, 3d, 7d, 30d | `7d` | | `--token <address>` | 代币合约地址 | — | | `--wallet <address>` | 钱包地址 | — | | `--chains <c1,c2>` | 逗号分隔的链 | — | | `--raw` | 仅数据响应（更便宜） | `false` | | `--yes` / `-y` | 跳过支付确认提示 | `false` |
要全局跳过确认提示，请设置 `EINSTEIN_AUTO_CONFIRM=true` 或在 config.json 中添加 `"autoConfirm": true`。
### `einstein-setup.mjs` (设置向导)
| 标志 | 描述 | 默认值 | |------|-------------|---------| | `--key <privateKey>` | 私钥（跳过交互式提示） | — | | `--url <baseUrl>` | Einstein API 的基础 URL | `https://emc2ai.io` | | `--chain <chain>` | 默认区块链网络 | `base` | | `--save-config` | 将 config.json 写入磁盘（否则打印环境变量导出） | `false` |
**支持的链：** base, ethereum, bsc, solana, arbitrum, polygon, optimism, zksync
## 安全最佳实践
**使用专用钱包。** 创建一个单独的钱包，仅为本技能充入少量 USDC。请勿使用您的主钱包或任何持有大量资金的钱包。
**优先使用环境变量而非 config.json。** 环境变量（`EINSTEIN_X402_PRIVATE_KEY`）不会持久化到磁盘，且更难被意外提交到 git。如果必须使用 config.json（`--save-config`），请限制文件权限：
```bash chmod 600 config.json ```
**签名内容。** 每次付费查询会签署一条 EIP-3009 `TransferWithAuthorization` 消息，该消息授权将确切的查询价格（确认前显示）的 USDC 从您的钱包转移到 Einstein 服务地址。签名是一次性的（唯一 nonce）且有时限。不会授予任何 blanket approvals（无限额授权）。
**支付确认。** 默认情况下，CLI 会在每次付费查询前提示确切成本。要在脚本/自动化使用中跳过提示，请按命令传递 `--yes` / `-y` 或全局设置 `EINSTEIN_AUTO_CONFIRM=true`。
**无自动安装的包。** 设置向导不会自动运行 `npm install`。您必须自己安装依赖项，以便审核正在安装的内容。
**无主目录扫描。** 配置仅从环境变量和技能本地的 `config.json` 加载。不会读取技能目录之外的任何路径。
## 故障排除
**“未配置私钥”** 设置 `EINSTEIN_X402_PRIVATE_KEY` 环境变量或运行 `node scripts/einstein-setup.mjs --save-config`。
**“支付被拒绝” / “余额不足”** 您的钱包需要 Base 网络上的 USDC。通过 https://bridge.base.org 进行跨链桥接。使用持有少量余额的专用钱包。
**“无法连接到 emc2ai.io”** 检查网络连接。服务可能暂时停机。
**“未知服务”** 运行 `node scripts/einstein.mjs services` 查看所有可用命令。
**“未安装依赖项”** 在技能目录中运行 `npm install`：`cd packages/project-einstein/openclaw-skill/einstein && npm install`
## 参考
- `references/services-catalog.md` — 包含参数的完整服务目录 - `references/payment-guide.md` — 详细的 x402 支付协议指南 - `references/examples.md` — 按类别分类的扩展使用示例