Home指南API 参考手册
指南API 参考手册社区Discord博客FAQ漏洞赏金公告中心English(英文版)Log In
指南

私链搭建

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

前期准备

  • 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. 获取节点配置文件config.conf,并将其分别放到SR和FullNode目录中,并分别修改文件名为:supernode.conf、 fullnode.conf。
    $ cp config.conf ./SR/supernode.conf
    $ cp config.conf ./FullNode/fullnode.conf
  4. 修改各节点的配置文件
配置项名称SR Fullnode配置内容FullNode 配置内容说明
localwitnessSR 账户私钥不需填值生成区块需要使用私钥签名
genesis.block.witnesses上面私钥对应的地址与SR配置值相同创世块相关的配置
genesis.block.Assets给特定账户预置TRX。将预先准备的账户地址加入到末尾并随意指定其TRX的余额与SR配置值相同创世块相关的配置
p2p.version11111之外的任意正整数与SR配置值相同SR 和 FullnNode 需相同,只有相同 version 的节点才能握手成功
seed.node不需填值将ip.list设置为SR的ip地址和SR配置文件中的listen.port端口号能够让 FullnNode 与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),如需快速通过提议,可将该项设置为更小的值,如 5 分钟,即 300000ms。
committee.allowSameTokenName11允许相同的 TRC-10 token name
committee.allowTvmTransferTrc1011允许智能合约转账 TRC-10代币
  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可以参考它创建提议,完成所有的私链网络动态参数的修改。由于某些参数之间有依赖关系,根据目前主网链上参数值,可以将私链所有参数的修改分成两个提议来完成,首先SR根据如下代码创建第一个议题,并投票:

const {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接口查询链参数。