跳到主要内容

私有网络

本文档描述了如何快速部署个人私有区块链。

  • 在搭建私链之前,需要编译二进制文件,可以参考安装PlatON文档

  • 私链部署方法以Ubuntu为例,包括单节点和集群部署,Windows上的部署方法和Ubuntu类似。

如果你不方便连接到外部网络,也可以选择搭建自己的私有网络。PlatON支持单节点模式和集群模式运行私有网络。本文以Ubuntu环境为例,假设节点数据目录为:~/platon-node/data (用户可自行调整),进行操作说明。

单节点#

  • 生成nodekey和blskey等相关文件
mkdir -p ~/platon-node/data && platonkey genkeypair | tee >(grep "PrivateKey" | awk '{print $2}' > ~/platon-node/data/nodekey) >(grep "PublicKey" | awk '{print $3}' > ~/platon-node/data/nodeid) && platonkey genblskeypair | tee >(grep "PrivateKey" | awk '{print $2}' > ~/platon-node/data/blskey) >(grep "PublicKey" | awk '{print $3}' > ~/platon-node/data/blspub)

说明:

  • nodeid:节点公钥(ID)文件,保存节点的公钥,用于标识节点身份
  • nodekey:节点私钥文件,保存节点的私钥,不能公开并且需要做好备份。
  • blspub:节点BLS公钥文件,保存节点的BLS公钥,用于共识协议中快速验证签名。
  • blskey:节点BLS私钥文件,保存节点的BLS私钥,不能公开并且需要做好备份。
  • 创建钱包文件
mkdir -p ~/platon-node/data && platon --datadir ~/platon-node/data account new

Your new account is locked with a password. Please give a password. Do not forget this password.

Passphrase:

Repeat passphrase:

Address: {lat1zg69v7yszg69v7yszg69v7yszg69v7y30mluqx}

注意:

钱包文件和口令对于生成的该账户地址非常重要,丢失钱包文件或者忘记口令都将导致该账户内的令牌丢失,请对钱包文件做好备份并牢记口令。

  • 编辑创世块配置文件platon.json

在~/platon-node目录下创建创世区块配置文件platon.json,然后将以下的创世区块配置文件模板内容拷贝到platon.json文件中,修改 your-node-pubkey 为之前生成的节点公钥(nodeid)your-node-blspubkey节点bls公钥(blspub)your-account-address创建钱包的地址(Address)

……    "cbft": {    "initialNodes": [{        "node": "enode://your-node-pubkey@127.0.0.1:16789",        "blsPubKey": "your-node-blspubkey"    }],    ……    "alloc": {      "your-account-address": {            "balance": "999000000000000000000"      }    },……
  • 创世块配置文件platon.json模板
{    "config": {        "chainId": 1021,        "eip155Block": 3,        "cbft": {            "initialNodes": [              {                    "node":"enode://4fcc251cf6bf3ea53a748971a223f5676225ee4380b65c7889a2b491e1551d45fe9fcc19c6af54dcf0d5323b5aa8ee1d919791695082bae1f86dd282dba4150f@127.0.0.1:16790",                    "blsPubKey":"d341a0c485c9ec00cecf7ea16323c547900f6a1bacb9daacb00c2b8bacee631f75d5d31b75814b7f1ae3a4e18b71c617bc2f230daa0c893746ed87b08b2df93ca4ddde2816b3ac410b9980bcc048521562a3b2d00e900fd777d3cf88ce678719"              }            ],            "amount": 10,            "period": 10000,            "validatorMode": "ppos"        },        "genesisVersion": 3328    },    "economicModel":{        "common":{            "maxEpochMinutes":4,            "maxConsensusVals":4,            "additionalCycleTime":28        },        "staking":{            "stakeThreshold": 1000000000000000000000000,            "operatingThreshold": 10000000000000000000,            "maxValidators": 30,            "unStakeFreezeDuration": 2,            "rewardPerMaxChangeRange": 500,            "rewardPerChangeInterval": 10        },        "slashing":{           "slashFractionDuplicateSign": 100,           "duplicateSignReportReward": 50,           "maxEvidenceAge":1,           "slashBlocksReward":20,           "zeroProduceCumulativeTime":3,           "zeroProduceNumberThreshold":2,           "zeroProduceFreezeDuration":1        },         "gov": {            "versionProposalVoteDurationSeconds": 160,            "versionProposalSupportRate": 6670,            "textProposalVoteDurationSeconds": 160,            "textProposalVoteRate": 5000,            "textProposalSupportRate": 6670,                      "cancelProposalVoteRate": 5000,            "cancelProposalSupportRate": 6670,            "paramProposalVoteDurationSeconds": 160,            "paramProposalVoteRate": 5000,            "paramProposalSupportRate": 6670              },        "reward":{            "newBlockRate": 50,            "platonFoundationYear": 10,            "increaseIssuanceRatio": 250        },        "innerAcc":{            "platonFundAccount": "lax1fyeszufxwxk62p46djncj86rd553skpptsj8v6",            "platonFundBalance": 0,            "cdfAccount": "lax1c8enpvs5v6974shxgxxav5dsn36e5jl4v29pec",            "cdfBalance": 331811981000000000000000000        }    },    "nonce": "0x0376e56dffd12ab53bb149bda4e0cbce2b6aabe4cccc0df0b5a39e12977a2fcd23",    "timestamp": "0x5bc94a8a",    "extraData": "0xd782070186706c61746f6e86676f312e3131856c696e757800000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",    "gasLimit": "4712388",    "alloc": {        "lax1zqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqrzpqayr": {            "balance": "200000000000000000000000000"        },        "lax17ekt83lj35zc4c7xak2f834fu2naw7rdxuz3wt": {            "balance": "9718188019000000000000000000"        }    },    "number": "0x0",    "gasUsed": "0x0",    "parentHash": "0x0000000000000000000000000000000000000000000000000000000000000000"}
  • 初始化创世区块
cd ~/platon-node && platon --datadir ./data init platon.json

说明:

出现Successfully wrote genesis state相关提示说明初始化创世信息完成。

  • 启动节点

    一般情况下,platon 进程一直在前台进行,这样我们就不能进行其他操作了,并且如果中途退出该终端,程序将退出。Ubuntu下可以以nohup方式启动程序:

cd ~/platon-node && nohup platon --identity "platon" --datadir ./data --port 16789 --rpcaddr 127.0.0.1 --rpcport 6789 --rpcapi "db,platon,net,web3,admin,personal" --rpc --nodiscover --nodekey ./data/nodekey --cbft.blskey ./data/blskey & > ./data/platon.log 2>&1 &

当shell中提示nohup成功后再按下一次回车,确保不会因为误关闭终端引起进程退出。

  • 检查节点运行状态
platon attach http://localhost:6789 --exec platon.blockNumber

多执行几次上面的命令,如果块高一直在增长,表示单节点私链部署成功。

PlatON 集群环境#

PlatON集群是有多节点参与的网络环境,这里我们假设你已经可以构建PlatON单节点。并且,我们将在一台服务器构建两个节点组成的网络。更多的节点在操作流程上类似。

为了在本地运行PlatON多节点,你要确保:

  • 每个节点实例拥有单独的data目录(--datadir)
  • 每个实例运行在不同的端口上,不管是p2p端口还是rpc端口(--port and --rpcport )
  • 节点可以彼此互连
  • RPC服务器端口不被占用

1.创建目录

在platon-node目录下创建目录data0和data1,作为两个节点的数据目录。分别生成两个节点的coinbase账户。

mkdir -p ~/platon-node/data0 ~/platon-node/data1

2.生成密钥对

分别将2个节点的nodekey和blskey保存到'data0'和'data1'

cd ~/platon-node/data0 && platonkey genkeypair | tee >(grep "PrivateKey" | awk '{print $2}' > ./nodekey) >(grep "PublicKey" | awk '{print $3}' > ./nodeid) && platonkey genblskeypair | tee >(grep "PrivateKey" | awk '{print $2}' > ./blskey) >(grep "PublicKey" | awk '{print $3}' > ./blspub)
cd ~/platon-node/data1 && platonkey genkeypair | tee >(grep "PrivateKey" | awk '{print $2}' > ./nodekey) >(grep "PublicKey" | awk '{print $3}' > ./nodeid) && platonkey genblskeypair | tee >(grep "PrivateKey" | awk '{print $2}' > ./blskey) >(grep "PublicKey" | awk '{print $3}' > ./blspub)

3.编辑创世文件

修改创世块配置文件platon.json

将两个节点的节点信息加入 initialNodes 数组中,因为我们生成的是两个节点组成的集群环境,所以数组长度为2。 需要修改platon.json文件: 请将以下文件内容'node0-nodekey'、'node1-nodekey'、'node0-blspubkey'和'node1-blspubkey'分别替换为上一步生成的节点公钥和节点bls公钥。 'your-account-address'替换为钱包地址。

……  "cbft": {  "initialNodes": [{        "node": "enode://node0-pubkey@127.0.0.1:16789",        "blsPubKey": "node0-blspubkey"    },{        "node": "enode://node1-pubkey@127.0.0.1:16790",        "blsPubKey": "node1-blspubkey"    }],    ……  "alloc": {    "your-account-address": {        "balance": "999000000000000000000"    },    "1000000000000000000000000000000000000003": {        "balance": "200000000000000000000000000"    }  },……

4.初始化和启动

分别为节点0和节点1初始化创世块信息:

platon --datadir ~/platon-node/data0 init platon.json && platon --datadir ~/platon-node/data1 init platon.json

初始化成功后,分别用nohup方式启动节点0和节点1:

cd ~/platon-node && nohup platon --identity "platon0" --datadir ./data0 --port 16789 --rpcaddr 0.0.0.0 --rpcport 6789 --rpcapi "db,platon,net,web3,admin,personal" --rpc --nodiscover --nodekey ./data0/nodekey --cbft.blskey ./data0/blskey > ./data0/platon.log 2>&1 &
cd ~/platon-node && nohup platon --identity "platon1" --datadir ./data1 --port 16790 --rpcaddr 0.0.0.0 --rpcport 6790 --rpcapi "db,platon,net,web3,admin,personal" --rpc --nodiscover --nodekey ./data1/nodekey --cbft.blskey ./data1/blskey  > ./data1/platon.log 2>&1 &

5.检查

通过前面所述的方式进入任意一个节点platon控制台,查看节点是否和对端建立连接以及通过查看blockNumber是否在持续增长来判断集群是否已成功启动。

platon attach http://localhost:6789 --exec platon.blockNumberplaton attach http://localhost:6790 --exec platon.blockNumber

多执行几次,观察块高的增长情况。