Solc 编译智能合约

我们的简单智能合约已经准备好了,如下所示:

pragma solidity ^0.4.24;

contract Vault {
    uint vaultData;
    function set(uint data) public{
        vaultData = data;
    }

    function get() public view returns (uint) {
        return vaultData;
    }
}

简单解释一下各个部分。智能合约的名字是 Vault,是一个存储合约,它开辟一个存储区 vaultData,该存储区是一个 uint 类型的变量(unsigned int,正整数)。智能合约一共包含两个方法:set 与get。分别为设置 vaultData 的值和读取 vaultData 的值。整个合约不会产生事件,所以也不会产生日志。合约指定需要编译器版本 0.4.24 来进行编译

我们来到控制台,执行以下命令编译该智能合约:

solc --optimize --combined-json abi,bin,interface Vault.sol

我们在命令中指定 solc 在编译时尽量优化代码,并将编译好的字节码 bin,与合约接口描述 ABI(Applicatoin Binary Interface) [1] 组合在一起输出。控制台中立即返回了编译结果。

{"contracts":{"Vault.sol:Vault":{"abi":"[{\"constant\":false,\"inputs\":[{\"name\":\"data\",\"type\":\"uint256\"}],\"name\":\"set\",\"outputs\":[],\"payable\":false,\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"get\",\"outputs\":[{\"name\":\"\",\"type\":\"uint256\"}],\"payable\":false,\"stateMutability\":\"view\",\"type\":\"function\"}]","bin":"608060405234801561001057600080fd5b5060bf8061001f6000396000f30060806040526004361060485763ffffffff7c010000000000000000000000000000000000000000000000000000000060003504166360fe47b18114604d5780636d4ce63c146064575b600080fd5b348015605857600080fd5b5060626004356088565b005b348015606f57600080fd5b506076608d565b60408051918252519081900360200190f35b600055565b600054905600a165627a7a723058203269ba0a634bf05e2a15966872aaa719b6d147aaa419d656374ad860104e6ef40029"}},"version":"0.4.24+commit.e67f0147.Darwin.appleclang"}

我们将该编译结果放入一份 temp.js 文件中并重新排版。

var output = {"contracts":{"Vault.sol:Vault":{"abi":"[{\"constant\":false,\"inputs\":[{\"name\":\"data\",\"type\":\"uint256\"}],\"name\":\"set\",\"outputs\":[],\"payable\":false,\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"get\",\"outputs\":[{\"name\":\"\",\"type\":\"uint256\"}],\"payable\":false,\"stateMutability\":\"view\",\"type\":\"function\"}]","bin":"608060405234801561001057600080fd5b5060bf8061001f6000396000f30060806040526004361060485763ffffffff7c010000000000000000000000000000000000000000000000000000000060003504166360fe47b18114604d5780636d4ce63c146064575b600080fd5b348015605857600080fd5b5060626004356088565b005b348015606f57600080fd5b506076608d565b60408051918252519081900360200190f35b600055565b600054905600a165627a7a723058203269ba0a634bf05e2a15966872aaa719b6d147aaa419d656374ad860104e6ef40029"}},"version":"0.4.24+commit.e67f0147.Darwin.appleclang"}

输出结果一共分为两个组成大部分,第一部分是智能合约抽象描述Application Binary Interface:ABI ,它展开后如代码所示。

[{
  "constant": false,
  "inputs": [{
      "name": "data",
      "type": "uint256"
  }],
  "name": "set",
  "outputs": [],
  "payable": false,
  "stateMutability": "nonpayable",
  "type": "function"
}, {
  "constant": true,
  "inputs": [],
  "name": "get",
  "outputs": [{
      "name": "",
      "type": "uint256"
  }],
  "payable": false,
  "stateMutability": "view",
  "type": "function"
}]

ABI 代表了一份“说明书”,展示了对于我们生成的合约究竟可以进行哪些操作、操作的参数又是哪些。 在编译期我们就已经确定了参数类型和函数名称,不存在动态类型。

我们研读这份 ABI 的总体结构,是一个列表。 列表里共2个项目:get 方法与 set 的方法,其中 set 方法接受一个 uinit256 的参数, 名为 data( uint256 即256位的 uint,在solidity中与 uint 同义); get 方法不接受 任何的参数,但是输出一个结果为 uint256 的值,且返回值不命名。

下面对ABI 中常见的几个关键字进行解释。

名称 解释
type 接口类型,默认为function,也可以是construnctor、fallback等
name 方法名字
inputs 接口输入参数列表,每一项都是参数名+参数类型
outputs 接口输出结果列表,每一项都是返回值名+返回值类型
constant 布尔值,若为true 则该接口不修改合约存储区,是只读方法
payable 布尔值,标明该方法是否接受以太币
stateMutability 枚举类型,为下列选项之一:
  pure:表明该方法只读不修改存储,且不读取区块链状态
  view:表明该方法只读不修改存储,但读取区块链状态
  nonpayable:该方法不能接受以太币
  payable:该方法可以接受以太币

第二部分是 bin 也就是经过编译器优化过后的可运行的合约字节码。真正部署到区块链上的是 bin 这一部分的代码,这部分代码的内容是初始化代码,包含了如何清理空间、创建变量、初始化合约的指令。

下一章:智能合约发布准备

我们将这份智能合约部署到Geth节点运行的私有区块链上,如果还未开始,请按如下命令启动 Geth节点并启用挖矿。cd ether-testgeth --datadir ./db/ --rpc --rpcaddr=127.0 ...