
先明确访问记录指什么
“区块链访问记录”可能指区块和交易等链上历史,也可能指应用调用节点时产生的接口日志,或者一次请求跨多个服务的追踪信息。查设计文档时,应先确定要回答的是“链上发生了什么”,还是“哪个调用方访问了哪个接口”。这些问题对应的记录层次不同。
本文适用于以太坊节点接口及采用 HTTP 链路追踪的应用场景。具体项目是否记录访问行为、记录哪些字段,仍需由该项目的设计与实现确认。

从节点接口规范确认数据范围
以太坊 JSON-RPC 文档描述应用与节点交互的统一接口,区分状态查询与历史数据查询。例如,eth_getTransactionByHash 查询交易,eth_getTransactionReceipt 查询交易回执;部分状态查询通过区块参数指定查询位置。具体接口支持情况还需核对客户端文档。

据此查找项目文档时,可围绕节点接入、RPC 接口、交易回执和历史状态等主题定位相关章节。接口返回的链上数据并不能直接回答调用者身份、请求耗时等访问审计问题,这些内容需要继续查应用或网关的日志设计。
从追踪规范确认请求如何关联
W3C Trace Context 规定了跨服务传播追踪上下文的 HTTP 头格式。traceparent 携带追踪标识及请求在追踪中的位置信息,tracestate 用于扩展厂商相关上下文,帮助不同组件关联同一条调用链。
在项目文档中,可检索 traceparent、trace-id、链路追踪、请求关联等词,检查应用到网关、再到节点服务的关联方式。追踪标识与交易哈希代表不同对象;若系统需要将两者关联,设计文档应说明关联发生的位置及适用条件。
设计文档需要核对哪些内容
定位项目自身方案时,可以从架构说明、接口说明、日志字段定义及可观测性设计入手。重点检查记录由哪个组件生成、覆盖哪些请求、字段含义是什么,以及日志如何存储和查询。这些是审阅方向,不代表所有项目都具有相同实现。
还应核对文档对应的客户端和部署版本,并确认失败请求、重试及跨服务调用的处理方式。涉及身份、权限、脱敏和保留期限的问题,需要项目专门说明,不能仅凭通用接口规范推断。
常见问题与适用边界
能否只查区块链就知道谁访问过接口?普通读取请求并不自动成为链上交易,因此链上历史不能完整替代接口访问日志。
有 trace-id 是否就有完整审计记录?追踪上下文提供关联机制;是否采集、保存及允许查询记录,还取决于系统实现。两份标准可以帮助理解接口与追踪边界,但无法据此确定某个项目设计文档的实际位置或日志覆盖范围。