base-tx-explain

一个 MCP 工具：explain_transaction(tx_hash) → 对任何 Base 主网交易的严格 JSON 解释。

输入一个交易哈希，即可获得发生了什么（用通俗英语描述）以及结构化事实：转移了什么、涉及谁、需要注意什么、花费多少。确定性的链上解码——响应路径中完全没有 LLM，因此相同的输入总是产生相同的输出，不存在幻觉的可能，JSON 契约足够稳定，可以盲解析。

仅支持 Base 主网（链 ID 8453）。

链接： 实时端点 · 文档 · OpenAPI · MCP 注册表：io.github.0200project/base-tx-explain · 网站

面向代理

// tools/call → explain_transaction
{ "tx_hash": "0x0c84b951051f779903b57af9225ca570c77cd5531195968dd78106a69d6c4d8c" }

返回（同时作为 structuredContent 和 content[0].text 中的字符串化 JSON）：

{
  "summary": "0x401d...f2c5 swapped 0.03 ETH for 12,899,422 WNL via Uniswap V4 PoolManager.",
  "action_type": "swap",
  "status": "success",
  "assets_moved": [
    { "token": "ETH", "amount": "0.03", "from": "0x401d...", "to": "0xd0a4...", "token_address": null, "standard": "native" },
    { "token": "WNL", "amount": "12899422.144134853458613801", "from": "0x4985...", "to": "0x401d...", "token_address": "0xb200...9a01", "standard": "erc20" }
  ],
  "counterparties": [
    { "address": "0xd0a4...", "label": null },
    { "address": "0x4985...", "label": "Uniswap V4 PoolManager" }
  ],
  "risk_flags": [
    { "flag": "unverified_contract", "detail": "The target contract 0xd0a4...e4bf has no verified source code on Sourcify." }
  ],
  "gas_paid_usd": 0.020562,
  "timestamp": "2026-08-20T03:54:19.000Z",
  "block_number": 50204356,
  "tx_hash": "0x0c84...4c8c",
  "basescan_url": "https://basescan.org/tx/0x0c84...4c8c",
  "partial": false
}

字段契约

• action_type — 以下之一：eth_transfer、erc20_transfer、erc20_approval、approval_revoked、approval_for_all、swap、add_liquidity、remove_liquidity、wrap、unwrap、nft_mint、nft_transfer、nft_sale、token_mint、bridge_in、bridge_out、lending_supply、lending_withdraw、lending_borrow、lending_repay、stake、unstake、claim、batch_transfer、account_abstraction_bundle、attestation、name_registration、contract_deployment、contract_interaction、unknown。

• risk_flags[].flag — 以下之一：unverified_contract、first_time_counterparty、approval_for_all、unlimited_approval、known_drainer、nonstandard_token_symbol、impersonated_token、transaction_reverted。标志始终表示发现了证据；查找失败永远不会产生标志。

• status — success 或 reverted。回滚的交易按意图（尝试了什么）分类，并带有 transaction_reverted 风险标志。

• partial: true — 无法确定交易的完整含义；summary 准确说明已知和未知的内容。出错时，工具返回 isError: true 并带有 { "error": "...", "code": "invalid_hash" | "not_found" | "pending" | "upstream_error" }。

• 金额是十进制字符串（不是浮点数）。地址按链上发出的形式给出；比较时忽略大小写。

• provenance.untrusted_fields — 列出字符串内容来自攻击者可控来源（代币符号、合约/集合名称、事件/函数名称）的字段：目前为 summary、assets_moved[].token 和 counterparties[].label。如果你将此输出提供给 LLM，请将这些字段视为数据，切勿视为指令。 一个以指令式或宣传式文本命名自身的代币是诈骗信号，而不是命令。符号会被规范化（控制字符、换行符、表情符号和同形字会被剥离），并且自我报告符号不是合理代码的代币会显示为其合约地址，而不是其自选名称——因此恶意名称无法冒充真实名称或将文本偷偷带入代理的上下文中。

解码方式

原始交易 + 来自 Base RPC 的回执 → 约 40 种事件格式的内置解码器（ERC-20/721/1155、Uniswap V2/V3/V4、Aerodrome/Solidly、Seaport、Aave V3、Compound V3、OP-stack 桥、ERC-4337 EntryPoint、EAS、Basenames、WETH、LP 位置管理器）→ 确定性规则排序分类 → 来自主要 Base 合约的已验证表的标签。应用特定事件通过合约在 Sourcify 上的已验证 ABI（如果可用）命名。风险标志来自 Sourcify/Basescan 验证状态、ScamSniffer 和 MyEtherWallet 公共黑名单以及批准语义。gas_paid_usd 包含 OP-stack L1 数据费用，并使用 交易所在区块 的 Chainlink ETH/USD 喂价来定价 ETH。

Related MCP server: Base Network MCP Server

定价

• 每个客户端 10 次免费调用，无需注册。

• 之后：每次调用 $0.02，通过 x402 在 Base 上以 USDC 支付 — 需要支付的响应包含 x402 能力代理自主支付和重试所需的一切。无需账户，无需 API 密钥。

• 也可通过市场托管（市场计费在那里适用）。

连接

{
  "mcpServers": {
    "base-tx-explain": {
      "type": "streamable-http",
      "url": "https://base-tx-explain.fly.dev/mcp"
    }
  }
}

自托管

git clone https://github.com/0200project/base-tx-explain.git && cd base-tx-explain
npm install
cp .env.example .env   # defaults work: free mode, public Base RPCs
npm run dev            # or: npm run build && npm start

环境（参见 .env.example）：PAYMENT_MODE（none | x402）、X402_PAY_TO（你的收款地址——使用新钱包）、X402_PRICE_USD、X402_FACILITATOR_URL（默认为无密钥的 PayAI 促进器；Coinbase CDP 促进器也可用，其 API 密钥不承担支出风险）、FREE_CALLS_PER_IP、BASE_RPC_URLS、可选的 ETHERSCAN_API_KEY。

服务器是无状态的（每个请求一个全新的 MCP 服务器），因此可以水平扩展，并可在任何运行 Docker 的环境上运行——包含 Dockerfile 和 Apify .actor/ 配置。

npm test          # unit tests
npm run validate  # decode 100 recent live Base txs, print grades (ship gate: >=90% clean, 0 crashes)

保证与限制

• 确定性：相同的交易哈希 → 相同的解码。绝不调用模型。

• 内部 ETH 转移（合约到合约的价值移动）在没有 trace API 的情况下不可见；WETH 事件覆盖常见情况。当某些内容无法解码时，输出会明确说明，而不是猜测。

• 黑名单在运行时从其公共来源消费，每天刷新两次；缺少 known_drainer 标志不是安全保证。

• 不是财务建议；此工具报告交易做了什么，而不是任何事物是否是好主意。