区块链 · 数字资产知识 · 行业资讯
文章库关于本站

资料与核验

用只读接口复核链上数据的三个习惯

摘要

JSON-RPC 可以把网页之外的查询过程写清楚。固定网络、固定时点、保留原始返回,是复查资料的起点。

玻璃文档与棱镜的原创资料研究概念插画

查询前先固定网络和方法

以太坊客户端通过 JSON-RPC 提供统一的交互方法,其中包括读取区块、交易及账户信息。接口名称说明要查询哪类对象,参数说明对象是谁。练习复核时,可以先写出问题,再选择只读方法,不必进行签名或提交交易。

一个常用的起点是查询链标识,确认服务对应的网络。记录接口地址、方法名和参数时,也要避免把服务访问凭据写进公开笔记。笔记的目标是让别人理解查询条件,不是复制某个私人服务账户的所有配置。

比较数据时使用相同观察条件

许多链上读取与区块位置相关。两次查询如果分别使用不断前进的最新区块,出现差异未必表示其中一次出错。为方便比较,可以在支持的读取方法中指定同一个区块,并记录区块哈希,明确自己比较的状态位置。

还要检查数字编码。JSON-RPC 的数量常以带前缀的十六进制字符串返回,展示页面则可能转成十进制并进一步换算单位。保留原始值、转换规则与展示值三项,能帮助排查究竟是数据不同,还是表达方式不同。

对空值与错误保留完整说明

接口返回空结果、协议错误和网络请求失败,是不同的观察结果。整理资料时分别记录,而不要统一填成零。零是一个具体数值,缺少结果则意味着此次查询尚未提供相应证据,这种区别在做表格或统计图时尤其容易被忽略。

可以为一次复核保存一份小记录:查询时间、网络、方法、参数、原始返回,以及一句有限结论。若改用另一个服务重复查询,先确保这些条件可比。这样的记录可以由后来的人重新执行,也能解释为什么某一项暂时没有展示值。

← 返回全部文章

延伸阅读 · 相关栏目

区块链基础技术原理数字资产知识资料与核验