私链搭建

搭建私链需要部署至少一个产块的全节点,和任意数量的非产块的全节点用于同步区块和广播交易,本示例中只搭建了一个产块的节点和一个非产块的节点

前期准备

  • Oracle JDK 1.8
  • 创建至少两个TRON网络地址并保存地址和对应的私钥,可以使用tronweb或者wallet-cli或者Tronlink来创建地址

部署指南

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

  1. 创建目录
    创建部署目录,建议将两个节点放在不同的目录下。
    $ mkdir SR $ mkdir FullNode
  2. 获取FullNode.jar,并将其分别放到SR和FullNode目录中。
    $ cp FullNode.jar ./SR
    $ cp FullNode.jar ./FullNode
    
  3. 获取节点配置文件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配置内容说明
localwitnesswitness账户私钥不需填值生成区块需要使用私钥签名
genesis.block.witnesses上面私钥对应的地址与SR配置值相同创世块相关的配置,genesis.block需要与SR节点的一样
genesis.block.Assets给特定账户预置TRX。将预先准备的账户地址加入到末尾并随意指定其TRX的余额与SR配置值相同创世块相关的配置
p2p.version11111之外的任意正整数与SR配置值相同SR 和fullnode需相同,只有相同version的节点才能握手成功
seed.node不需填值将ip.list设置为SR的ip地址和SR配置文件中的listen.port端口号能够让fullnode与SR node建立连接并同步数据
needSyncCheckfalsetrue第1个SR设置needSyncCheck为false,其他设置为true
node.discovery.enabletruetrue如果配置成false,则当前节点不会被其他节点发现
block.proposalExpireTime600000与SR配置值相同默认提议生效时间是3天:259200000(ms),如需快速通过提议,可将该项设置为更小的值,如10分钟,即600000ms
block.maintenanceTimeInterval300000与SR配置值相同维护期时间间隔,默认是6小时: 21600000(ms),如需快速通过提议,可将该项设置为更小的值,如五分钟,即300000ms。
committee.allowSameTokenName11允许相同的token name
committee.allowTvmTransferTrc1011允许智能合约转账TRC10代币
  1. 修改配置文件中的端口号,将SR和FullNode的配置成不相同的端口号。注意,如果SR和FullNode运行在一台机器上,此步骤是必须的,否则,可跳过此步。

    • listen.port : p2p的监听端口
    • http端口: Http监听端口
    • rpc 端口: rpc 监听端口
  2. 启动节点

    • 产块的全节点
      $ java -Xmx6g -XX:+HeapDumpOnOutOfMemoryError -jar FullNode.jar  --witness  -c supernode.conf
      
    • 非产块的全节点
      $ java -Xmx6g -XX:+HeapDumpOnOutOfMemoryError -jar FullNode.jar  -c fullnode.conf
      
  3. 修改网络动态参数
    为了跟主网环境一样,需要修改私链网络的动态参数,使其与主网的保持一致,动态参数的修改可通过提议来完成。SR账户可以使用tronweb或者wallet-cli或者节点http接口 wallet/proposalcreate创建提案,wallet/proposalapprove批准提案。

    下面是根据主网先后通过的提议整理出来的动态参数及值,并通过tronweb创建及批准提议的代码示例。SR可以参考它创建一个提议,来一次性完成所有的私链网络动态参数的修改。

    var TronWeb = require('tronweb');
    var tronWeb = new TronWeb({
            fullHost: 'http://localhost:16887',
            privateKey: 'c741f5c0224020d7ccaf4617a33cc099ac13240f150cf35f496db5bfc7d220dc'
        })
    
    var unsignedProposal1Txn = await tronWeb.transactionBuilder.createProposal([{"key":9,"value":1},{"key":10,"value":1},{"key":11,"value":280},{"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":1500},{"key":63,"value":1}],"41D0B69631440F0A494BB51F7EEE68FF5C593C00F0")
    var signedProposal1Txn = await tronWeb.trx.sign(unsignedProposal1Txn, "c741f5c0224020d7ccaf4617a33cc099ac13240f150cf35f496db5bfc7d220dc");
    var receipt1 = await tronWeb.trx.sendRawTransaction(signedProposal1Txn);
    
    setTimeout(async function() { 
            console.log("Vote proposal!") 
            var unsignedVoteP1Txn = await tronWeb.transactionBuilder.voteProposal(1, true, tronWeb.defaultAddress.hex)
            var signedVoteP1Txn = await tronWeb.trx.sign(unsignedVoteP1Txn, "c741f5c0224020d7ccaf4617a33cc099ac13240f150cf35f496db5bfc7d220dc");
            var rtn1 = await tronWeb.trx.sendRawTransaction(signedVoteP1Txn);
        }, 1000)