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 ...

上一章：以太坊安装编译器