TronBox

概述

Tronbox是一个区块链开发工具，您可以使用tronbox来创建和部署智能合约。

你将学到什么？

通过本章学习，您将学会如何使用Tronbox创建智能合约并将其部署至TRON网络。

你将做什么？

安装和设置Tronbox
在TRON网络上部署合约
在Tronscan上检查合约部署状态

设置开发环境

在我们开始之前，请安装以下软件:

Node.js(5.0+) LTS and npm (comes with Node)

一旦我们安装完成，我们只需要一个命令来安装Tronbox：

$ npm install -g tronbox

在终端上输入Tronbox version 来检查Tronbox是否正确安装。

创建一个项目

MetaCoin 项目

我们将以创建一个MetaCoin代币项目为例，介绍Tronbox的相关操作。

为MetaCoin项目创建一个新目录：
```
$ mkdir MetaCoin
$ cd MetaCoin
```
下载 MetaCoin 项目：
```
$ tronbox unbox metacoin
```

这时您就成功创建了一个包含合约、部署、测试和配置文件的Tronbox项目，当然您也可以使用tronbox init命令初始化一个新的tronbox项目。项目中的几个关键文件及文件夹包括：

文件/文件夹	说明
./contract	所有的智能合约文件
./migrations	所有用于迁移的 javascript 文件
./test	用来测试您的智能合约的所有测试脚本
./tronbox.js	项目的配置文件。在此文件中声明您的 fullnode 地址和事件服务器

下面是本示例项目的/contract/MetaCoin.sol 中的智能合约代码：

pragma solidity ^0.5.4;

import "./ConvertLib.sol";

// This is just a simple example of a coin-like contract.
// It is not standards compatible and cannot be expected to talk to other
// coin/token contracts.

contract MetaCoin {
  mapping(address => uint) balances;

  event Transfer(address _from, address _to, uint256 _value);

  address owner;

  constructor(uint initialBalance) public {
    owner = msg.sender;
    balances[msg.sender] = initialBalance;
  }

  function sendCoin(address receiver, uint amount) public returns (bool sufficient) {
    if (balances[msg.sender] < amount) return false;
    balances[msg.sender] -= amount;
    balances[receiver] += amount;
    emit Transfer(msg.sender, receiver, amount);
    return true;
  }

  function getBalanceInEth(address addr) public view returns (uint){

    return ConvertLib.convert(getBalance(addr), 2);
  }

  function getBalance(address addr) public view returns (uint) {
    return balances[addr];
  }

  function getOwner() public view returns (address) {
    return owner;
  }
}

配置编译和部署参数

在部署合约之前，您需要在tronbox.js 文件中配置好私钥、网络、编译器版本、userFeePercentage和feeLimit等编译和部署参数。

module.exports = {
  networks: {
    mainnet: {
      // Don't put your private key here:
      privateKey: process.env.PRIVATE_KEY_MAINNET,
      /*
Create a .env file (it must be gitignored) containing something like
  export PRIVATE_KEY_MAINNET=4E7Fxxxxxxxxx
Then, run the migration with:
  source .env && tronbox migrate --network mainnet

*/
      userFeePercentage: 100,
      feeLimit: 1000 * 1e6,
      fullHost: 'https://api.trongrid.io',
      network_id: '1'
    },
    shasta: {
      privateKey: process.env.PRIVATE_KEY_SHASTA,
      userFeePercentage: 50,
      feeLimit: 1000 * 1e6,
      fullHost: 'https://api.shasta.trongrid.io',
      network_id: '2'
    },
    nile: {
      privateKey: process.env.PRIVATE_KEY_NILE,
      userFeePercentage: 100,
      feeLimit: 1000 * 1e6,
      fullHost: 'https://api.nileex.io',
      network_id: '3'
    }，
    compilers: {
      solc: {
        version: '0.6.0' // for compiler version
      }
    }
  },  
  // solc compiler optimize
  solc: {
    optimizer: {
      enabled: false, // default: false, true: enable solc optimize
      runs: 200
    },
    evmVersion: 'istanbul'
  }
}

请注意，tronbox.js可以配置多个网络信息，部署时根据名称来选择要将合约部署到的哪个网络。您还需要给Tronbox传递私钥，这是您要部署合约帐户的私钥，建议在环境变量中设置私钥，然后将环境变量配置到privateKey中，以保护您的账户安全。

编译合约

使用如下命令编译智能合约：

$ tronbox compile

您将看到以下输出：

编译后的.json文件将位于./build/contracts目录中。

部署合约

使用如下命令部署合约，其中可以使用--network参数指定部署的网络，网络必须是tronbox.js中networks列表的一个网络名称，下面以部署到shasta网络为例：

$ tronbox migrate --network shasta

恭喜！您已使用Tronbox成功部署了MetaCoin智能合约。现在您可以根据合约地址在Shasta测试网浏览器检查部署状态，并且与部署的合约进行交互。