Question

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

• 在搭建私链之前，需要编译二进制文件，可以参考安装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: {lat1q25u0zphmre6tz8nt3cuen0ekmas7qfzaalgh4}

注意：

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

• 编辑创世块配置文件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": "lat1q25u0zphmre6tz8nt3cuen0ekmas7qfzaalgh4",
            "platonFundBalance": 0,
            "cdfAccount": "lat10kvcm60zhmlsfmsjjdqggnsu6nccl5q2v6kqw2",
            "cdfBalance": 331811981000000000000000000
        }
    },
    "nonce": "0x0376e56dffd12ab53bb149bda4e0cbce2b6aabe4cccc0df0b5a39e12977a2fcd23",
    "timestamp": "0x5bc94a8a",
    "extraData": "0xd782070186706c61746f6e86676f312e3131856c696e757800000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
    "gasLimit": "4712388",
    "alloc": {
        "lat1zqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqrdyjj2v": {
            "balance": "200000000000000000000000000"
        },
        "lat1jvm3ljpeyrc6k9c7d6x0sq4dq9m42skueugvxy": {
            "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.blockNumber
platon attach http://localhost:6790 --exec platon.blockNumber

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