合约 ABI 入门：函数、事件与自定义错误

ABI描述接口不保证实现

ABI告诉工具怎样编码函数调用、返回值和事件，但不证明部署字节码与文档相同，也不等于安全审计。先核对合约地址、链、代理实现和ABI来源，再解释解码结果。

公开ABI可能来自过期版本或错误地址，先核对区块浏览器的实现和源码说明。代理的入口与实际业务逻辑不同，工具选错ABI可能给出看似自然但错误的函数名称，因此解码显示仍需证据支持。

理解selector与类型

函数选择器来自完整签名，重载函数需要准确类型。地址、整数、数组和tuple的编码方式不同，界面显示可读名称也可能来自错误ABI。读调用前确认参数单位和小数位，不把原始十六进制直接当作人类金额。

函数选择器只占有限字节，不能在所有情况下唯一证明函数含义。完整签名、合约上下文和实现一起看，尤其不要把陌生签名请求里的可读文字当成全部交易效果。教学用只读调用更容易控制风险。

事件的索引字段不同

indexed字段进入topics，动态类型可能只留下哈希，无法从日志还原原文。非索引参数在data中编码，事件同名不意味着来自同一合约版本。对账时记录日志位置、交易和合约，而不是只复制页面标签。

事件不是合约状态快照，某条Transfer日志也需确认真正资产合约与执行结果。动态参数哈希无法凭空恢复，页面显示的名称可能由外部索引补足。引用时说明链上字段与工具推断的差别，避免精确但来源不明的结论。

错误数据帮助诊断

自定义错误或标准错误可以从revert数据解码，但状态变化、代理和缺少ABI都会限制解释。错误说明调用被拒绝的路径，不证明发送者恶意，也不保证重试一定成功。不要为了“测试错误”向真实合约广播未知交易。

错误信息可以被合约自行定义，友好文字并不自动可信。某次调用失败后状态通常按执行规则回滚，但Gas费用处理需另看。诊断时保留原始返回和区块，不通过反复提高金额试探未知合约。

用只读样本建立习惯

选择公开、低风险的只读函数，记录selector、参数、返回和事件，再与源码说明交叉核对。保存ABI版本和区块高度，后续实现升级时重新判断。ABI是编码地图，不是对资金或权限安全的承诺。

练习记录可以按原始字节、解码值、来源和限制四列，遇到未知类型注明未能解码。不要为填满表格猜值或下载陌生解码插件。只有确有必要的公开资料进入文章，敏感业务数据不因ABI可解码就适合公开。

练习记录可以围绕“函数签名”“参数编码”“事件字段”“错误数据”分别填写概念、假想输入、观察结果和适用限制。逐步核对单位与时间，明确哪个结果来自公式、哪个来自工具，无法确认的地方不靠猜测填满。练习不需要真实私钥或大额交易，完成后保存方法和版本即可。把学习结果迁移到真实服务前，还要核对当地资格、费用和当前软件行为。