核心用法
Ethereum History 是一个面向 AI Agent 的只读数据接口，专用于查询以太坊主网历史合约的客观事实。核心能力覆盖三大场景：
1. 单合约深度查询：通过 /api/agent/contracts/{address} 获取指定地址的完整档案，包括部署区块/时间戳、部署者地址、运行时字节码、反编译代码（如有）、Etherscan 验证状态、ERC20 代币元数据，以及人工撰写的历史摘要（historical_summary）、历史意义（historical_significance）和时代背景（historical_context）。
2. 批量发现与筛选：通过 /api/agent/contracts 支持按时代（Frontier/Homestead/DAO fork 等）、是否精选、是否缺乏文档描述进行过滤，并支持时间范围查询（ISO 8601 时间戳），适用于研究特定时期的合约生态。
3. 元数据与链接：每个合约附带结构化链接（sources、文档、分析文章）和可扩展的键值元数据，便于交叉验证与深度研究。
所有端点均为 GET 请求，无需认证，返回 JSON 采用 snake_case 键名。
显著优点
- 权威史料整合：不仅提供链上原始数据（字节码、gas 成本），还整合了人工撰写的历史背景与行业共识描述，弥补纯数据接口的叙事缺口。
- 反编译能力：自动反编译合约字节码，即使原始源码未验证也能提供可读的高层级代码结构。
- 时代划分精确：按以太坊硬分叉时代（Frontier → Homestead → DAO → Tangerine → Spurious 等）标记合约，便于进行技术史分期研究。
- 零摩擦接入：无 API Key、无费率限制声明，适合研究型 Agent 高频调用。
潜在局限
- 只读约束：无法执行任何链上操作或模拟交易，仅限历史数据查询。
- 覆盖范围未知：未明确说明归档范围（是否包含全部主网合约，或仅精选子集），可能遗漏极早期或极冷门的合约。
- 依赖外部数据源：Etherscan 合约名称、验证状态等字段依赖第三方，存在同步延迟或失效风险。
- 反编译成功率非 100%：复杂或高度优化的合约可能反编译失败。
适合人群
- 区块链研究者、技术史学家、安全审计员（分析早期合约模式）、DeFi 考古爱好者、需要为链上地址提供上下文说明的 Wallet/Explorer 类 Agent。
常规风险
- 数据时效性：历史摘要为人工撰写，更新频率未明确，可能存在与最新社区共识的偏差。
- 中心化托管风险：服务托管于
ethereumhistory.com，若服务下线或域名变更，Agent 功能将中断。 - 隐私泄露风险低：仅查询公开链上数据，无用户敏感信息交互。
- 无内容安全过滤：反编译代码或历史描述中可能包含恶意合约的原始功能描述，需调用方自行甄别。