ABI 是智能合约与外部世界沟通的契约。理解 ABI，不仅能让你写出正确的前端调用代码，也能在合约升级与多客户端兼容场景中游刃有余。本文用实战视角带你走完 ABI 的完整链路。
ABI 是什么：合约的对外说明书
ABI 是 Application Binary Interface 的缩写，本质上是一份 JSON 描述文件，告诉调用者一个合约有哪些函数、各自的参数与返回类型、以及事件结构。它由 Solidity 编译器自动生成，是连接合约字节码与高级语言客户端的桥梁。可参考 ABI是什么 中的基础解释。
生成方式：编译产物与外部工具
通常 ABI 来自 Solidity 编译器的 abi 字段，不同工具链会把它保存到不同位置。Hardhat 默认输出在 artifacts 目录，Foundry 则在 out 目录。也可以通过反编译工具从已部署合约中提取 ABI，但这种方式可能不完整。延伸阅读 ABI开发教程。
与 ethers.js 的对接
在前端代码中，你只需要把 ABI 与合约地址传给 ethers.js 的 Contract 构造器，就能得到一个完整的合约实例。ABI 定义的函数会自动映射为 JavaScript 方法。这种映射极大简化了开发体验，但也要求 ABI 与链上字节码完全匹配。具体示例可结合 ethers.js是什么 与 ABI代码示例。