ABI（应用程序二进制接口）

什么是加密货币领域的 ABI？

ABI 是 Application Binary Interface（应用程序二进制接口）的缩写。在加密货币领域，它通常指一种标准格式，使钱包、去中心化应用、脚本和智能合约能够理解如何与区块链上的智能合约交互。

ABI 就像智能合约通信的可读说明书。

它会告诉软件合约有哪些函数、这些函数需要哪些输入、会返回哪些输出、合约可以发出哪些事件，以及数据在发送到链上前应如何编码。

Solidity 官方文档将合约 ABI 描述为 Ethereum 生态中与合约交互的标准方式，既适用于区块链外部的交互，也适用于合约之间的交互。

你可以在 Solidity 合约 ABI 规范中查看技术资料。

简单来说，ABI 是连接人类可读的智能合约代码与机器可读的区块链交易数据的桥梁。

如果没有 ABI，用户界面可能知道合约地址，却不知道应该提供哪些按钮、表单、输入项或函数调用。

对于加密货币用户来说，ABI 很重要，因为它能帮助 dApp 显示转账、授权、质押、铸造、领取、充值、提现、投票或兑换等合约操作。

对于开发者来说，ABI 很重要，因为它能让智能合约调用变得可预测、结构化，并可在钱包、库、区块链浏览器和后端服务之间重复使用。

ABI 对智能合约为何重要

智能合约是存储在区块链地址上的程序，用户通过发送格式正确的交易数据与之交互。

Ethereum 说明，智能合约是在某个地址运行的程序，包含数据和函数，并会在收到交易时执行。

你可以阅读 Ethereum 关于智能合约结构的官方指南。

区块链本身不需要漂亮的用户界面也能执行函数。

它只需要与用户想要调用的函数相匹配且经过正确编码的数据。

ABI 能帮助软件正确生成这些编码数据。

例如，代币合约可能包含一个转账函数，需要输入收款地址和金额。

ABI 会告诉钱包或应用该函数确实存在，第一个输入应为地址，第二个输入应为无符号整数。

随后，应用就可以构建合约能够理解的交易。

这就是 ABI 成为加密货币用户界面背后重要概念之一的原因。

ABI 的工作原理

ABI 通过结构化格式定义智能合约的外部接口。

大多数 Ethereum 式 ABI 都以 JSON 数组表示。

数组中的每个对象描述一个合约项目，例如函数、构造函数、事件、接收函数、回退函数或自定义错误。

对于函数，ABI 可以包含函数名称、输入类型、输出类型和状态可变性。

状态可变性描述函数是读取数据、修改数据、接收原生币，还是具有其他执行行为。

对于事件，ABI 可以包含事件名称、索引字段、非索引字段，以及事件是否为匿名事件。

对于自定义错误，ABI 可以包含错误名称和参数，用于说明交易回滚的原因。

这种结构化描述可以让链下软件将易读指令转换为底层调用数据。

它还能让软件将底层返回数据和事件日志解码为人类易于理解的信息。

ABI 编码

ABI 编码是将函数调用及其参数转换为 Ethereum 虚拟机能够理解的二进制数据的过程。

Solidity ABI 规范指出，ABI 数据根据类型进行编码；由于编码结果本身不包含类型说明，因此需要使用模式进行解码。

这个模式就是 ABI。

这一点非常重要，因为原始交易数据不会清楚地说明自身含义。

一串十六进制数据可能代表代币转账、流动性充值、NFT 铸造或治理投票。

ABI 能帮助软件正确解读这些数据。

用户在 dApp 中点击按钮时，应用会使用 ABI 对所选函数及其参数进行编码。

随后，钱包会显示交易请求；如果详情看起来正确，用户便可以签署交易。

交易发送后，区块链会针对合约执行经过编码的指令。

许多日常加密货币操作就是通过这一流程，从网页转变为实际的链上交易。

函数选择器

函数选择器是编码数据的前 4 个字节，用于标识应调用哪个智能合约函数。

在 Ethereum 式合约中，函数选择器由规范函数签名的 Keccak-256 哈希生成。

规范函数签名包含函数名称和参数类型，例如 transfer(address,uint256)。

ABI 能帮助软件识别该签名并构建正确的调用数据。

例如，代币转账不会向区块链发送“转移这个代币”这样的文字。

它会发送一段简短的十六进制数据，其中以函数选择器开头，后面是经过编码的参数。

接收合约会读取选择器，并将执行流程路由到相应函数。

如果选择器与任何可用函数都不匹配，合约可能会调用回退函数，也可能拒绝该调用。

这种机制提高了智能合约交互的效率，但也让 ABI 成为人类可读解读的关键。

ABI 与合约地址

合约地址告诉软件智能合约在链上的位置。

ABI 则告诉软件如何与该合约通信。

要获得良好的用户体验，通常需要同时具备这两项信息。

如果开发者只有地址，仍可发送原始交易数据，但可能很难知道有哪些函数可用。

如果开发者只有 ABI，就能了解接口，却不知道应调用哪个已部署合约。

合约地址与 ABI 结合后，应用便可以在常见 Web3 库中创建合约实例。

之后可以使用该合约实例调用读取函数、估算 Gas、准备交易并监听事件。

因此，许多开发者教程会要求先提供地址和 ABI，再讲解如何与已部署合约交互。

ABI 与读取函数

读取函数是不会改变区块链状态、只用于检索信息的智能合约函数。

在 Solidity 中，这类函数通常标记为 view 或 pure。

dApp 可以使用 ABI 调用读取函数，并显示代币余额、总供应量、所有者地址、质押仓位、资金池参数或治理提案详情等数据。

读取调用通常通过节点 RPC 方法处理；如果用户只是通过节点在本地查询数据，一般无需支付 Gas。

Ethereum 的 JSON-RPC 文档说明，应用可以通过标准化的 RPC 方法与 Ethereum 节点通信。

你可以在 Ethereum JSON-RPC API 文档中查看官方参考资料。

ABI 能帮助应用对读取请求进行编码，并解码返回结果。

如果没有 ABI，返回结果可能只会显示为原始十六进制数据。

ABI 与写入函数

写入函数是能够改变区块链状态的智能合约函数。

示例包括转移代币、批准代币支出、铸造资产、领取奖励、质押币、创建提案或更改协议设置。

由于写入函数会改变状态，因此通常需要签署交易并支付网络费用。

ABI 能帮助钱包或 dApp 为函数调用准备正确的交易数据。

用户签署交易后，钱包会将其广播到区块链网络。

如果交易有效且费用支付正确，验证者就会将其打包进区块。

ABI 不会判断交易是否安全或是否有利可图。

它只描述合约要求如何构造调用。

用户仍需核实自己签署的内容，尤其是在批准代币额度或与不熟悉的合约交互时。

ABI 与事件

事件是智能合约发出的信号，可帮助应用追踪交易中发生的情况。

例如，代币合约可能会在代币从一个地址转到另一个地址时发出 Transfer 事件。

借贷合约可能会在用户充值、借款、还款或提取资产时发出事件。

NFT 合约可能会在代币铸造、转移或获批时发出事件。

ABI 会描述事件名称和参数类型，让软件能够将日志解码为易读记录。

这很重要，因为钱包、仪表板、分析工具、索引器和投资组合追踪器都会广泛使用区块链日志。

事件不仅对用户有用。

它们还有助于后端系统追踪活动，而无需直接读取每项内部存储变更。

在加密货币领域，许多用户余额、历史记录和分析视图都依赖正确解码的事件数据。

ABI 与代币标准

代币标准在很大程度上依赖可预测的接口。

例如，同质化代币合约通常采用 totalSupply、balanceOf、transfer、allowance、approve 和 transferFrom 等标准函数。

ERC-20 标准为 Ethereum 式网络上的同质化代币定义了通用接口。

你可以在 EIP-20 代币标准中直接查看该标准。

由于许多代币采用相同的标准函数名称和参数类型，钱包和 dApp 能够更轻松地支持它们。

ABI 让这种支持切实可行，因为软件能够调用预期函数并解码预期事件。

非同质化代币标准和多代币标准也依赖已定义的接口。

这也是加密货币生态能够构建可重复使用的钱包、市场、区块链浏览器和分析工具的原因之一。

标准接口可以减少定制集成工作，并提升应用之间的互操作性。

ABI 与 ERC-165 接口检测

ABI 会告诉软件如何与合约交互，但有些合约还支持接口检测。

ERC-165 是一项标准，允许合约声明自己是否支持特定接口。

ERC-165 官方提案指出，该标准规范了接口的概念以及接口识别方式。

你可以在 ERC-165 标准接口检测中阅读相关标准。

这很重要，因为应用可能需要了解合约是否支持某种代币标准或功能集。

例如，NFT 应用可能会在显示高级功能前检查合约是否支持特定 NFT 接口。

ABI 和 ERC-165 彼此相关，但并不是同一回事。

ABI 描述可调用的函数和事件，而 ERC-165 提供了一种标准方法，用于在运行时检查支持哪些接口。

ABI JSON 格式

最常见的 ABI 格式是由智能合约编译器生成的 JSON 文件或 JSON 数组。

典型的 ABI 条目包含 type、name、inputs、outputs、stateMutability 和 anonymous 等字段。

type 字段用于标识 ABI 项目是函数、事件、构造函数、接收函数、回退函数还是错误。

inputs 字段列出合约所需的参数。

outputs 字段列出合约返回的值。

stateMutability 字段描述函数是 view、pure、payable 还是 nonpayable。

anonymous 字段适用于事件，并会影响事件的记录方式。

开发者库也可能支持更便于使用的人类可读 ABI 格式。

例如，ethers.js 在其 ABI 文档中介绍了多种表示 ABI 片段的方式。

dApp 中的 ABI

去中心化应用使用 ABI 将前端连接到智能合约。

前端看起来可能与普通网站相似，但其中的按钮通常会触发合约读取或合约写入操作。

用户打开质押页面时，应用可能会使用 ABI 读取用户当前的质押余额。

用户点击质押按钮时，应用可能会使用 ABI 编码质押交易。

交易完成后，应用可能会使用事件 ABI 更新显示的活动历史。

这一流程常见于去中心化金融、NFT、游戏、去中心化身份、治理和链上奖励等领域。

因此，ABI 虽然不可见，却是用户体验中不可或缺的一部分。

大多数用户不会直接看到 ABI，但只要 dApp 以友好方式显示合约函数，他们就离不开 ABI。

钱包中的 ABI

钱包会使用 ABI 信息向用户展示交易可能执行的操作。

能够解码交易数据的钱包可以显示函数名称和参数，而不只是原始十六进制数据。

这样可以提高签名过程的安全性，因为用户能更好地了解自己是在批准代币、转移资产、铸造 NFT，还是与合约模块交互。

不过，解码数据的可靠性取决于 ABI 本身和钱包的解读方式。

恶意界面仍可能在钱包提示出现前误导用户。

令人困惑的合约也可能让某个函数看起来无害，实际却会产生意料之外的影响。

用户应将 ABI 解码视为有帮助的安全措施，而不是完整保障。

对于高价值交易，用户应在签名前核实合约、函数、收款方、代币金额和授权范围。

区块链浏览器中的 ABI

区块链浏览器通常会使用 ABI，让合约页面更易于阅读。

合约通过验证后，区块链浏览器可以显示易读的合约函数、解码后的交易和事件日志。

这有助于用户检查代币转账、智能合约调用、所有权设置、代理关系和治理活动。

如果没有 ABI 信息，区块链浏览器可能只能显示原始输入数据和底层日志。

这些原始数据对进阶研究者仍然有用，但大多数用户较难理解。

ABI 还可以帮助审计人员、分析师和社区成员查看协议在链上的运作方式。

在加密货币领域，透明度不仅取决于公开数据，也取决于能否使用工具正确解码这些数据。

ABI 是让区块链透明度真正发挥作用的关键工具之一。

ABI 与合约验证

合约验证是将已部署字节码与已发布的源代码及编译器设置进行匹配的过程。

智能合约通过验证后，用户通常可以同时查看源代码和 ABI。

这有助于提升可信度，因为用户可以检查 ABI 是否与合约实际编译出的接口相符。

通过验证并不意味着合约自动安全。

已验证合约仍可能存在漏洞、不当权限、具有风险的升级控制或有害逻辑。

不过，与未验证合约相比，验证能为用户和研究人员提供更多信息。

验证后，ABI 尤其有用，因为它能让界面和区块链浏览器以结构化方式显示合约交互。

条件允许时，用户应优先选择已验证的合约，但仍需检查权限、审计情况、所有权和链上行为。

ABI 与字节码

ABI 和字节码彼此相关，但二者有很大区别。

字节码是编译后的机器级代码，会在区块链虚拟机上运行。

ABI 是接口说明，告诉软件如何从外部调用该字节码。

即使 ABI 未公开，智能合约仍可以以字节码形式存在于链上。

在这种情况下，进阶用户仍可能通过手动构造调用数据与合约交互。

大多数用户和应用都需要 ABI，才能方便地与合约交互。

字节码是区块链执行的内容。

ABI 则是外部工具用来了解如何与这段可执行代码通信的接口。

ABI 与代理合约

代理合约会让 ABI 的使用变得更加复杂。

代理合约会将调用转发给另一个包含主要逻辑的合约。

这种模式常用于可升级智能合约。

代理地址可能保持不变，而实现合约则可能发生变化。

在这种情况下，用户可能需要使用实现合约的 ABI，而不只是代理合约的基础 ABI。

如果使用了错误的 ABI，界面可能会显示缺失的函数、错误的函数或令人困惑的交易数据。

因此，许多区块链浏览器和开发者工具都会尝试识别代理关系。

对于用户来说，可升级合约需要格外留意，因为如果治理或管理员权限允许升级，合约逻辑就可能发生变化。

ABI 与自定义错误

现代 Solidity 合约可以使用自定义错误来说明交易回滚的原因。

在许多情况下，自定义错误比冗长的回滚字符串更节省 Gas。

ABI 可以包含自定义错误定义，让工具将回滚数据解码为易读说明。

例如，失败的交易可能会返回一条错误信息，说明调用者未经授权或输入金额过低。

如果没有 ABI 支持，用户可能只会看到令人困惑的十六进制错误值。

解码后的自定义错误有助于开发者调试合约，也有助于用户理解交易失败的原因。

这再次说明 ABI 如何提升区块链系统的易用性。

更好的解码不会消除风险，但能帮助人们了解发生了什么。

ABI 安全风险

ABI 本身通常不是智能合约风险的来源，但错误或具有误导性的 ABI 信息可能造成严重混淆。

伪造的 ABI 可能让合约交互看起来与实际情况不同。

过时的 ABI 可能隐藏新函数，或显示不再符合已部署实现的旧行为。

不完整的 ABI 可能导致用户看不到所有可用函数或事件。

恶意 dApp 可能使用真实 ABI，却展示具有误导性的用户界面。

如果代理合约的实现随着时间发生变化，ABI 的解读也可能变得更加困难。

用户不应认为易读的函数名称就意味着交易安全。

用户应核实合约地址、检查可信来源、仔细阅读钱包提示、限制代币授权，并避免签署自己不理解的交易。

ABI 的常见用途

开发者使用 ABI 构建能够调用智能合约函数的 dApp。

钱包使用 ABI 解码交易请求，让用户更清楚地了解签名内容。

区块链浏览器使用 ABI 显示易读的合约调用和事件日志。

索引器使用 ABI 收集和整理链上数据，以供分析使用。

审计人员使用 ABI 了解合约的外部接口并测试交互。

交易机器人和自动化脚本使用 ABI 以编程方式调用合约函数。

治理仪表板使用 ABI 读取提案、投票、法定人数设置和执行状态。

投资组合工具使用 ABI 读取余额、仓位、奖励和历史活动。

在以上各种场景中，ABI 都能让智能合约数据更容易编码、解码、展示和使用。

用通俗语言解释 ABI

想象一台只能识别特定按钮代码的自动售货机。

这台机器可能支持购买零食、查看库存、补充商品和收取资金等操作。

普通人不会想要手动向机器发送底层二进制命令。

人们需要的是一份清晰菜单，显示可用操作和所需输入。

ABI 对智能合约的作用与此类似。

它会告诉软件有哪些操作，以及每项操作需要哪些信息。

软件随后可以将用户的选择转换为合约要求的准确编码数据。

因此，ABI 常被称为合约的通信接口。

ABI 与 API

ABI 和 API 听起来相似，但并不是一回事。

API 是 Application Programming Interface（应用程序编程接口）的缩写，通常描述软件系统如何在更高层面上进行通信。

ABI 是 Application Binary Interface（应用程序二进制接口）的缩写，描述软件如何在二进制数据层面进行通信。

在加密货币领域，API 可能用于让应用向某项服务请求代币价格、余额或交易历史。

ABI 则用于让应用编码和解码直接的智能合约交互。

dApp 可能会同时使用 API 和 ABI。

例如，dApp 可能使用 API 获取市场数据，并使用 ABI 发送链上的质押交易。

API 负责信息流转，ABI 则负责合约执行和解码。

如何获取合约 ABI

开发者通常从智能合约编译器的输出中获取 ABI。

编译 Solidity 合约时，编译器可以同时生成字节码和 ABI 数据。

字节码会部署到区块链上。

ABI 会被保存下来，供需要与已部署合约交互的应用使用。

用户还可以在已验证合约页面、项目官方代码仓库、开发者文档或软件包版本中找到 ABI。

通常最安全的来源是项目官方文档，或与确切地址和网络相匹配的已验证合约记录。

用户应谨慎使用从随机网站、聊天或未经验证来源复制的 ABI 文件。

错误的 ABI 可能导致交易失败、界面显示误导性信息或数据解码错误。

开发者如何使用 ABI

开发者通常会将 ABI 导入 Web3 库，并与合约地址结合使用。

随后，该库会创建一个合约对象，并开放与 ABI 相对应的可调用函数。

开发者可以使用该对象读取合约状态、发送交易、估算 Gas 和监听事件。

这种工作流程常见于 JavaScript、TypeScript、Python、Rust、Go 和其他区块链开发环境。

开发者还会在测试中使用 ABI，检查合约是否按预期运行。

后端服务使用 ABI 监控事件，并在链上活动发生时更新数据库。

前端应用使用 ABI 渲染按钮、表单和交易提示。

在生产系统中，ABI 版本控制十分重要，因为合约升级可能会改变可用函数和事件。

常见 ABI 错误

一个常见错误是使用了错误合约版本的 ABI。

另一个常见错误是使用正确的 ABI，却搭配了错误的合约地址。

第三个错误是在某个网络上的合约交互中使用了另一个网络的 ABI。

第四个错误是忽略代理合约，并在需要实现合约 ABI 时使用代理 ABI。

第五个错误是只相信用户界面，而不检查实际的钱包提示。

第六个错误是认为解码后的函数名称足以说明合约可能执行的所有内部操作。

第七个错误是在不了解获批合约能够执行哪些操作的情况下，批准无限额代币支出。

这些错误表明，即使不是开发者，了解 ABI 也很有用。

ABI 对加密货币安全为何重要

了解 ABI 有助于用户理解钱包和 dApp 显示的内容。

当钱包显示解码后的函数时，解码过程通常会用到 ABI。

了解 ABI 的用户可以更好地理解合约交互有时为何会显示为原始数据。

当合法合约难以解码时，这有助于减少用户的担忧。

如果交易提示显示危险授权或陌生函数，也能提高用户的警惕性。

ABI 知识在去中心化金融领域尤其有用，因为许多操作都涉及智能合约权限。

用户应特别留意授权、操作员权限、委托调用、可升级合约以及具有管理员控制权的合约。

ABI 有助于揭示交互接口，但安全性仍取决于代码质量、权限、审计和用户判断。

常见问题

加密货币领域的 ABI 是什么意思？

ABI 是 Application Binary Interface（应用程序二进制接口）的缩写，在加密货币领域，它描述软件应如何编码、调用和解码智能合约函数及事件。

ABI 有什么用途？

钱包、dApp、脚本、区块链浏览器和开发者工具使用 ABI，以结构化方式与智能合约交互。

ABI 和智能合约是一回事吗？

不是。智能合约是链上程序，而 ABI 是接口说明，告诉软件如何与该程序通信。

ABI 和字节码是一回事吗？

不是。字节码是可执行的合约代码，而 ABI 是用于编码和解码代码交互的可读接口格式。

dApp 为什么需要 ABI？

dApp 需要 ABI 来显示合约函数、收集用户输入、构建交易数据、调用读取函数并解码合约响应。

没有公开 ABI，合约还能运行吗？

可以。合约即使没有公开 ABI 也能运行，但大多数用户和应用需要 ABI，才能方便、安全地与其交互。

在哪里可以找到合约 ABI？

通常可以在编译器输出、项目官方代码仓库、开发者文档或区块链浏览器上的已验证合约页面中找到合约 ABI。

ABI 可能是伪造的吗？

可能。如果 ABI 来自不可信来源，它可能有误、已经过时、不完整或具有误导性。

ABI 能保护用户免受诈骗吗？

不能。ABI 可以帮助解码合约交互，但无法证明合约安全、已通过审计或值得信任。

为什么我的钱包会显示原始十六进制数据？

如果钱包没有该合约交互所需的正确 ABI 或解码信息，就可能显示原始十六进制数据。

什么是 ABI 编码？

ABI 编码是将函数名称和参数转换为智能合约能够理解的二进制格式的过程。

什么是 ABI 解码？

ABI 解码是将原始区块链数据转换回易读的函数调用、返回值、事件或错误的过程。

结论

ABI 是智能合约生态中最重要的底层构件之一。

它让钱包、dApp、开发者工具、区块链浏览器和分析系统能够理解如何与智能合约通信。

对初学者来说，可以把 ABI 理解为说明合约可调用函数、预期输入、输出、事件和错误的使用手册。

对开发者来说，ABI 是结构化接口，使合约集成、测试、监控和自动化成为可能。

对日常加密货币用户来说，ABI 很重要，因为它能帮助钱包和应用将原始区块链数据转换为易读操作。

正确的 ABI 可以让智能合约交互更清晰、更安全、更易于理解。

错误或具有误导性的 ABI 则可能造成混乱并增加交易风险。

最佳做法是使用官方或已验证来源提供的 ABI，仔细核对合约地址，阅读钱包提示，并避免签署不清楚的交易。

在加密货币领域，ABI 本身不是合约，而是帮助人类和软件正确与合约沟通的语言指南。