私链网络¶

搭建私链需要部署至少一个产块的全节点，和任意数量的非产块的全节点用于同步区块和广播交易，本示例中只搭建了一个产块的节点和一个非产块的节点。搭建私链之前，请先安装Oracle JDK 1.8， 然后需要准备至少两个TRON网络地址并保存地址和对应的私钥，可以使用wallet-cli或者Tronlink来创建地址。

部署指南¶

搭建私链节点的流程和搭建主网节点的流程一样，不同点在于节点配置文件内容不同，搭建私链最主要的是要修改配置文件中的配置项，使节点间组成私链网络，可以进行网络发现，区块同步和广播交易。

1. 创建目录

   创建部署目录，建议将两个节点放在不同的目录下。

   $ mkdir SR
   $ mkdir FullNode
   

2. 获取FullNode.jar

   获取 FullNode.jar，将其分别放到SR和FullNode目录中。

   $ cp FullNode.jar ./SR
   $ cp FullNode.jar ./FullNode
   

3. 获取节点配置文件private_net_config.conf，

   获取节点配置文件 private_net_config.conf，将其分别放到SR和FullNode目录中,并分别修改文件名为：supernode.conf、 fullnode.conf。

   $ cp private_net_config.conf ./SR/supernode.conf
   $ cp private_net_config.conf ./FullNode/fullnode.conf
   

4. 修改各节点的配置文件

   请根据如下表格中的说明，依次修改节点的各个配置项：

   配置项名称	SR Fullnode配置内容	FullNode配置内容	说明
   localwitness	witness账户私钥	不需填值	生成区块需要使用私钥签名
   genesis.block.witnesses	上面私钥对应的地址	与SR配置值相同	创世块相关的配置，genesis.block需要与SR节点的一样
   genesis.block.Assets	给特定账户预置TRX。将预先准备的账户地址写入并随意指定其TRX的余额。可以直接修改原来已有账户的address字段，其它字段不需要修改；或者在末尾添加新账户信息	与SR配置值相同	创世块相关的配置
   p2p.version	11111之外的任意正整数	与SR配置值相同	SR 和fullnode需相同，只有相同version的节点才能握手成功
   seed.node	不需填值	将ip.list设置为SR的ip地址和SR配置文件中的listen.port端口号	能够让fullnode与SR node建立连接并同步数据
   needSyncCheck	false	true	第1个SR设置needSyncCheck为false，其他设置为true
   node.discovery.enable	true	true	如果配置成false，则当前节点不会被其他节点发现
   block.proposalExpireTime	600000	与SR配置值相同	默认提议生效时间是3天：259200000(ms)，如需快速通过提议，可将该项设置为更小的值，如10分钟，即600000ms
   block.maintenanceTimeInterval	300000	与SR配置值相同	维护期时间间隔，默认是6小时: 21600000(ms),如需快速通过提议，可将该项设置为更小的值，如五分钟，即300000ms。
   committee.allowSameTokenName	1	1	允许相同的token name
   committee.allowTvmTransferTrc10	1	1	允许智能合约转账TRC10代币

5. 修改配置文件中的端口号，将SR和FullNode的配置成不相同的端口号。注意，如果SR和FullNode运行在一台机器上，此步骤是必须的，否则，可跳过此步。

   • listen.port ： p2p的监听端口
   • http端口： Http监听端口
   • rpc 端口： rpc 监听端口

6. 启动节点

   产块的全节点和非产块的全节点，启动命令不同：

   • 产块的全节点

     $ java -Xmx6g -XX:+HeapDumpOnOutOfMemoryError -jar FullNode.jar  --witness  -c supernode.conf
     

   • 非产块的全节点

     $ java -Xmx6g -XX:+HeapDumpOnOutOfMemoryError -jar FullNode.jar  -c fullnode.conf
     

7. 修改网络动态参数

   为了跟主网环境一样，需要修改私链网络的动态参数，使其与主网的保持一致，动态参数的修改可通过提议来完成。SR账户可以使用wallet-cli或者节点http接口 wallet/proposalcreate创建提案，wallet/proposalapprove批准提案。

   下面是根据主网先后通过的提议整理出来的动态参数及值，并通过tronweb创建及批准提议的代码示例。SR可以参考它创建提议，完成所有的私链网络动态参数的修改。由于某些参数之间有依赖关系，根据目前主网链上参数值，可以将私链所有参数的修改分成两个提议来完成，首先SR根据如下代码创建第一个议题，并投票：

   var TronWeb = require('tronweb');
   var tronWeb = new TronWeb({
       fullHost: 'http://localhost:16887',
       privateKey: 'c741f5c0224020d7ccaf4617a33cc099ac13240f150cf35f496db5bfc7d220dc'
   })
   
   // First proposal: "key":30 and "key":70 must be modified first
   var parametersForProposal1 = [{"key":9,"value":1},{"key":10,"value":1},{"key":11,"value":420},{"key":19,"value":90000000000},{"key":15,"value":1},{"key":18,"value":1},{"key":16,"value":1},{"key":20,"value":1},{"key":26,"value":1},{"key":30,"value":1},{"key":5,"value":16000000},{"key":31,"value":160000000},{"key":32,"value":1},{"key":39,"value":1},{"key":41,"value":1},{"key":3,"value":1000},{"key":47,"value":10000000000},{"key":49,"value":1},{"key":13,"value":80},{"key":7,"value":1000000},{"key":61,"value":600},{"key":63,"value":1},{"key":65,"value":1},{"key":66,"value":1},{"key":67,"value":1},{"key":68,"value":1000000},{"key":69,"value":1},{"key":70,"value":14},{"key":71,"value":1},{"key":76,"value":1}];
   
   var parametersForProposal2 = [{"key":47,"value":15000000000},{"key":59,"value":1},{"key":72,"value":1},{"key":73,"value":3000000000},{"key":74,"value":2000},{"key":75,"value":12000},{"key":77,"value":1},{"key":78,"value":864000}];
   
   async function modifyChainParameters(parameters,proposalID){
   
       parameters.sort((a, b) => {
               return a.key.toString() > b.key.toString() ? 1 : a.key.toString() === b.key.toString() ? 0 : -1;
           })
       var unsignedProposal1Txn = await tronWeb.transactionBuilder.createProposal(parameters,"41D0B69631440F0A494BB51F7EEE68FF5C593C00F0")
       var signedProposal1Txn = await tronWeb.trx.sign(unsignedProposal1Txn);
       var receipt1 = await tronWeb.trx.sendRawTransaction(signedProposal1Txn);
   
       setTimeout(async function() {
           console.log(receipt1)
           console.log("Vote proposal 1 !")
           var unsignedVoteP1Txn = await tronWeb.transactionBuilder.voteProposal(proposalID, true, tronWeb.defaultAddress.hex)
           var signedVoteP1Txn = await tronWeb.trx.sign(unsignedVoteP1Txn);
           var rtn1 = await tronWeb.trx.sendRawTransaction(signedVoteP1Txn);
       }, 1000)
   
   }
   
   modifyChainParameters(parametersForProposal1, 1)
   

   通过上述代码创建完成提议后，你可以通过http://127.0.0.1:xxxx/wallet/listproposals 接口查询提案的生效时间 "expiration_time" ，该时间戳以毫秒为单位，超过该时间后，如果该接口的返回值中的"state" 为 "APPROVED"，则表示该提案已经通过，则可以进行下一步的操作，创建第二个议案，示例代码如下：

   modifyChainParameters(parametersForProposal2, 2)
   

   等待该提议生效后，私链的动态参数与主网就一致了，您可以通过/wallet/getchainparameters接口查询链参数。