以太坊abi
什么是abi
ABI是Application Binary Interface的缩写,字面意思 应用二进制接口,可以通俗的理解为合约的接口说明。当合约被编译后,那么它的abi也就确定了。
我们来看看一个很简单的合约和它的abi
合约代码如下:
pragma solidity ^0.4.4; contract test { string public a; function modify_a(string val) { a = val; } }
经过编译之后,它的字节码如下:
6060604052341561000c57fe5b5b60e18061001b6000396000f30060606040526000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff1680630dbe671f146044578063efa3b144146067575bfe5b3415604b57fe5b60516098565b6040518082815260200191505060405180910390f35b3415606e57fe5b60826004808035906020019091905050609e565b6040518082815260200191505060405180910390f35b60005481565b60006005820260008190555060005490505b9190505600a165627a7a72305820e7910925075fb58319dd637b47520b821714dd11ad896cb6d8272151aff714690029
abi如下,是json格式的
[ { "constant": true, "inputs": [ ], "name": "a", "outputs": [ { "name": "", "type": "uint256" } ], "payable": false, "type": "function" }, { "constant": false, "inputs": [ { "name": "val", "type": "uint256" } ], "name": "modify_a", "outputs": [ { "name": "", "type": "uint256" } ], "payable": false, "type": "function" } ]
可以看到,这是一个json格式的数组,它包含两个对象,每个对象都对应着一个合约方法,这里因为a是public类型的,编译的时候会自动为它生成get()方法,所以这个合约实际是包含两个方法的,我们对方法的参数做一下整理。
>type 方法类型,包括function,constructor,fallback(缺省方法)可以缺省,默认为function
>name 方法名
>inputs 方法参数,它是一个对应数组,数组里的每个对象都是一个参数说明
name 参数名
type 参数类型
>outputs 方法返回值,格式和inputs类型一样,如果没有返回值可以缺省
>constant 布尔值,如果为true说明方法不会修改合约的状态变量
>payable 布尔值,标明方法是否可以接受ether
构造方法和缺省方法不能有name和outputs,缺省方法也不能有inputs,向一个没有payable标注的方法发送ether会抛异常。