内容
# 加密知识库
**自主AI代理的链上大脑。** 一个 [MCP](https://modelcontextprotocol.io) 服务器，允许代理执行复杂的加密操作 — 跨链路由、合约解码、投资组合和许可管理、gas/profit 估算以及防欺诈安全检查 — 安全且确定性。
> **设计上无密钥存储。** 服务器从不持有私钥，从不签名。每个写操作返回一个 *未签名的、待签名的交易*；代理使用自己的钱包签名。服务器是多租户和无状态的 — 自带地址，获取数据 + 未签名的交易。
## 工具列表
| 工具 | 功能 |
|---|---|
| `route` | 任意链/token 之间的最佳跨链路由（例如 CRO → SOL）。并行查询 **LiFi + deBridge**，比较输出，返回最佳路由以及替代方案，每个方案都有一个待签名的交易。 |
| `pumpfun` | 直接在链上读取 pump.fun：实时 bonding-curve 储备、价格、毕业进度、市值和解析的 IPFS 元数据。 |
| `profitability` | EIP-1559 多链 gas 估算 + 净利润判决（套利保护）。 |
| `abi` | 获取任何已验证的 EVM 合约的 ABI（Etherscan V2 / Sourcify），遵循 EIP-1967 代理，并告诉代理每个函数需要哪些参数。解码/编码 calldata — `decode_calldata` 甚至适用于 **未验证** 的合约，通过 4byte 目录选择器查找。缓存。 |
| `portfolio` | 多链余额（原生 + ERC-20 + SPL）和 ERC-20 许可管理（检查 / 批准 / 撤销）返回未签名的交易。 |
| `security` | 通过 **GoPlus + honeypot.is** 进行防欺诈扫描（EVM **和 Solana**）：honeypot/不可转让、税收、流动性锁、mint/冻结/黑名单/暂停权限、持有者集中度 → 0-100 风险评分，带有红旗。 |
| `mev_protection` | 私有 RPC 指导（Flashbots Protect，MEV Blocker）+ 按链划分的 sandwich 风险，以便代理安全广播。 |
| `whale_watch` | 最近的大型 ERC-20 转账（“鲸鱼移动”）用于某个代币，超过一个区块窗口，解码并排序。 |
| `solana_swap` | 通过 **Jupiter** 报价和构建同链 Solana 交换（例如 SOL→USDC，购买一个毕业的 pump 代币）— 返回一个序列化的未签名交易。 |
| `simulate` | 在签名之前 dry-run 一个 EVM 交易（eth_call），并解码 revert 原因（Error/Panic/custom）— 永远不要在一个失败的交易上烧 gas。 |
| `catalog` | 发现：列出每个工具、支持的链（id/原生资产）和提供者模式，以便代理可以自我配置。 |
## 支持的链
以太坊、Base、Arbitrum、Optimism、Polygon、**Cronos**、ApeChain、BNB Smart Chain、Avalanche、Solana（10）。设计上与链无关 — 添加一条链只是一个注册表条目（`src/registry/chains.ts`）。
## 快速开始
```bash
npm install
cp .env.example .env # 可选密钥 — 没有它们，所有功能都会降级为公共 RPC
npm test # 31 个确定性单元测试
npm run dev # 通过 stdio 运行 MCP 服务器
```
### 从 MCP 客户端（例如 Claude Code）使用它
```json
{
"mcpServers": {
"crypto-knowledge": {
"command": "npx",
"args": ["tsx", "/absolute/path/to/Crypto-Knowledge/src/index.ts"]
}
}
}
```
## 提供者模式（每个调用）
调用者选择如何获取 RPC/数据：
- **`open`** — 仅使用公共 RPC。免费，但数据有限（例如，没有 ERC-20 自动发现）和较低的速率限制。
- **`own_key`** ⭐ *推荐* — 传递您自己的免费 `heliusKey` / `alchemyKey`。最佳性能，您的配额。密钥仅暂时使用，绝不会存储或记录。
- **`tool`** — 使用操作员的密钥（从不暴露）。为 NFT 持有人保留/付费层级，当启用访问控制时。
> 在 [helius.dev](https://helius.dev) （Solana）和 [alchemy.com](https://alchemy.com) （EVM）上获取免费密钥。当您使用降级的公共 RPC 时，工具会提示您。
## 访问与货币化（托管模式）
当 `ACCESS_GATING_ENABLED=true`（默认为本地 stdio 使用禁用）：
- **持有者** — 拥有配置的 gating NFT（链上验证）→ 免费，更高的限制，可以使用工具的密钥。
- **付费** — 通过 [x402](https://x402.org) 支付 \$0.10/请求。
- **免费** — 公共 RPC 级别，限制保守。
## 架构
```
代理 ──▶ MCP 工具（6 个模块）
└─ 核心：RPC 池 · 重试/回退 · 规范错误 · 提供者解析器
└─ 访问：滑动窗口速率限制 · NFT 门控
返回 仅 unsigned tx + 数据 → 代理本地签名
```
参见 [`ARCHITECTURE.md`](./ARCHITECTURE.md)，了解完整的设计、JSON I/O 规范和研发路线图。
## 安全
- 永远不会有私钥。仅读取 + 构建 unsigned tx。
- 操作员密钥仅在服务器端使用，从不回声给调用者。
- 调用者提供的密钥是暂时的（从不持久/记录）。
## 许可证
MIT
