ABI编码器入门指南：从原理到实战避坑

1次阅读

共计 1375 个字符，预计需要花费 4 分钟才能阅读完成。

当我们调用智能合约的函数时，参数需要转换成二进制格式才能在以太坊虚拟机 (EVM) 中执行。这个转换过程就是 ABI（Application Binary Interface）编码。对于新手来说，数据类型转换、动态数组处理等问题常常导致合约调用失败。今天我们就来深入探讨 ABI 编码器的工作原理和实战技巧。

ABI 编码规范了智能合约函数调用和返回值的二进制表示方法。主要包含两个部分：

函数选择器(Function Selector)：函数签名的前 4 个字节的 Keccak-256 哈希值
参数编码(Argument Encoding)：将参数转换为 32 字节的块

不同的开发环境提供了不同的 ABI 编码方式：

Solidity 原生编码：
使用 abi.encode() 和abi.encodePacked()
适用于合约间调用
严格遵循 ABI 规范
Web3.js 编码：
使用web3.eth.abi.encodeFunctionCall()
适用于 DApp 前端调用合约
提供更友好的 JavaScript 接口

不同的数据类型有不同的编码方式：

uint/address：
都编码为 32 字节
address 实际只使用 20 字节，前面补零
bytes：
固定长度 bytesN：直接填充到 32 字节
动态长度 bytes：先编码长度，再编码内容
string：
本质上是动态 bytes
需要注意 UTF- 8 编码

动态数组的编码比较复杂，需要计算偏移量：

首先编码数组长度
然后编码每个元素的偏移量
最后编码每个元素的实际值

// Solidity 动态数组编码示例
function encodeArray(uint[] memory arr) public pure returns (bytes memory) {return abi.encode(arr);
}

在 JavaScript 中使用 Web3.js 进行 ABI 编码：

// Web3.js 编码示例
const encoded = web3.eth.abi.encodeFunctionCall({
    name: 'myFunction',
    type: 'function',
    inputs: [{
        type: 'uint256',
        name: 'myNumber'
    }, {
        type: 'string',
        name: 'myString'
    }]
}, ['2345675643', 'Hello!']);

ABI 编码会直接影响交易 gas 消耗：