私链搭建
搭建私链需要部署至少一个产块的全节点,和任意数量的非产块的全节点用于同步区块和广播交易,本示例中只搭建了一个产块的节点和一个非产块的节点
前期准备
- Oracle JDK 1.8
- 创建至少两个TRON网络地址并保存地址和对应的私钥,可以使用tronweb或者wallet-cli或者Tronlink来创建地址
部署指南
搭建私链节点的流程和搭建主网节点的流程一样,不同点在于节点配置文件内容不同,搭建私链最主要的是要修改配置文件中的配置项,使节点间组成私有网络,可以进行网络发现,区块同步和广播交易。
- 创建目录
创建部署目录,建议将两个节点放在不同的目录下。
$ mkdir SR $ mkdir FullNode - 获取FullNode.jar,并将其分别放到SR和FullNode目录中。
$ cp FullNode.jar ./SR $ cp FullNode.jar ./FullNode - 获取节点配置文件config.conf,并将其分别放到SR和FullNode目录中,并分别修改文件名为:supernode.conf、 fullnode.conf。
$ cp config.conf ./SR/supernode.conf $ cp config.conf ./FullNode/fullnode.conf - 修改各节点的配置文件
| 配置项名称 | SR Fullnode配置内容 | FullNode 配置内容 | 说明 |
|---|---|---|---|
localwitness | SR 账户私钥 | 不需填值 | 生成区块需要使用私钥签名 |
genesis.block.witnesses | 上面私钥对应的地址 | 与SR配置值相同 | 创世块相关的配置 |
genesis.block.Assets | 给特定账户预置TRX。将预先准备的账户地址加入到末尾并随意指定其TRX的余额 | 与SR配置值相同 | 创世块相关的配置 |
p2p.version | 11111之外的任意正整数 | 与SR配置值相同 | SR 和 FullnNode 需相同,只有相同 version 的节点才能握手成功 |
seed.node | 不需填值 | 将ip.list设置为SR的ip地址和SR配置文件中的listen.port端口号 | 能够让 FullnNode 与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),如需快速通过提议,可将该项设置为更小的值,如 5 分钟,即 300000ms。 |
committee.allowSameTokenName | 1 | 1 | 允许相同的 TRC-10 token name |
committee.allowTvmTransferTrc10 | 1 | 1 | 允许智能合约转账 TRC-10代币 |
-
修改配置文件中的端口号,将SR和FullNode的配置成不相同的端口号。注意,如果SR和FullNode运行在一台机器上,此步骤是必须的,否则,可跳过此步。
listen.port: p2p的监听端口http端口: Http监听端口rpc端口: rpc 监听端口
-
启动节点
- 产块的全节点
$ java -Xmx6g -XX:+HeapDumpOnOutOfMemoryError -jar FullNode.jar --witness -c supernode.conf - 非产块的全节点
$ java -Xmx6g -XX:+HeapDumpOnOutOfMemoryError -jar FullNode.jar -c fullnode.conf
- 产块的全节点
-
修改网络动态参数 为了跟主网环境一样,需要修改私链网络的动态参数,使其与主网的保持一致,动态参数的修改可通过提议来完成。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接口查询链参数。
Updated 4 days ago