Skip to content

如何在B91中部署超级节点

b91foundation edited this page Sep 9, 2019 · 3 revisions

介绍

在B91中,只有超级节点才有铸币权。这篇文章将会介绍部署超级节点的具体步骤。另外,还会介绍一些节点运营和资产保管的安全建议。

准备

超级节点硬件要求

目前阶段,系统配置是最小16G内存,直存固态硬盘和10Gbps带宽

与之相匹配的是i3 large型号的亚马逊云主机(AWS)。

我们强烈建议每一台超级节点都对应配置一台同样型号的备份服务器。

超级节点软件要求

操作系统

可以是所有 Java 1.8 和 Python 可以运行的任何操作系统 (包括 Ubuntu, CentOS, MacOS, Windows 等)。

我们推荐的操作系统是 Ubuntu 16.04 LTS (或其更高版本)。

这篇文档我们以Ubuntu 16.04为例进行介绍。

软件服务安装

首先我们更新软件包管理器

$ sudo apt-get update

在主机上安装Java 1.8

$ sudo apt-get install openjdk-8-jdk

检查Java版本(需要删除低版本的Java)

$ java -version
openjdk version "1.8.0_181"
OpenJDK Runtime Environment (build 1.8.0_181-8u181-b13-0ubuntu0.16.04.1-b13)
OpenJDK 64-Bit Server VM (build 25.181-b13, mixed mode)

如果您选择编译我们的源码搭建全节点,需要安装Scala编译工具(SBT)

$ echo "deb https://dl.bintray.com/sbt/debian /" | sudo tee -a /etc/apt/sources.list.d/sbt.list
$ sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 2EE0EA64E40A89B84B2DF73499E82A75642AC823
$ sudo apt-get update
$ sudo apt-get install sbt

如果没有Unzip和Git,请在主机上安装这些软件

$ sudo apt-get install unzip
$ sudo apt-get install git-core

启动B91全节点

第1步: 准备程序

有两种方法准备全节点程序,请任意选择一个方法。

下载编译源代码(方法1)

从GitHub上下载源代码

$ git clone https://github.com/b91foundation/B91_spos.git
$ cd B91_spos

用SBT编译源代码。如果您希望编译测试网(Testnet)的B91全节点,请运行

# Compile TestNet B91 full node
$ sbt -Dnetwork=testnet packageAll

如果您希望编译主网(Mainnet)的B91全节点,请运行

# Compile MainNet B91 full node
$ sbt packageAll

编译好的文件将会放在target/b91-all-[version].jar这个位置。复制到你自己的工作目录,例如:

$ mkdir ../b91-node
$ cp target/b91-all-*.jar ../b91-node/b91-all.jar
$ cd ../b91-node

下载已经编译好的文件(方法2)

如果您不想编译源代码,您也可以选择在 https://github.com/b91foundation/B91_spos/releases 下载最新的JAR文件。

b91-all-[version].jar保存到您的工作目录。

第2步: 配置

设置您的配置文件

# B91 node settings
vsys {
  # Path Settings
  directory = <block & wallet data file path>
  # Application logging level. Could be DEBUG | INFO | WARN | ERROR. Default value is INFO.
  logging-level = INFO
  # P2P Network settings
  network {
    known-peers = ["<peer ip>:<peer port>"]
    black-list-residence-time = 30s
    peers-broadcast-interval = 5s
    connection-timeout = 30s
    # Network address to bind to
    bind-address = "0.0.0.0"
    # Node name to send during handshake. Comment this string out to set random node name.
    # node-name = "My MAINNET node"
    # String with IP address and port to send as external address during handshake. Could be set automatically if uPnP is enabled.
    declared-address = "localhost:8921"
  }
  # Wallet settings
  wallet {
    # Password to protect wallet file
    password = ""
    # Wallet seed as BASE58 string
    # seed = ""
  }
  # Blockchain settings
  blockchain.type = MAINNET   # Should be TESTNET or MAINNET
  # Matcher settings
  matcher.enable = no
  # Minter settings
  miner {
    enable = yes
    offline = no
    quorum = 1
    generation-delay = 1s
    interval-after-last-block-then-generation-is-allowed = 120h
    tf-like-scheduling = no
    # Left to empty as default to minter address
    reward-address = ""
  }
  # Node's REST API settings
  rest-api {
    # Enable/disable node's REST API
    enable = yes
    # Network address to bind to
    bind-address = "0.0.0.0"
    # Hash of API key string
    api-key-hash = "your own api key's hash"
  }
  checkpoints.public-key = "A9MX22tXpNdTTx5wBf3CunZz299c1nnca6kH3MzL312L"
}

几个比较关键的配置

  • directory应该设为您自己的工作目录。我们建您挂载一个较大的硬盘,然后工作目录设置到这个硬盘下。

  • known-peers 这项最好填3个或以上的已知节点。您可以在B91 explorer查询这些已知节点。现在正在运行的一些节点有:

     # 测试网
     known-peers = ["47.56.23.247:8923"]
     # 主网 (欲知更多节点请和我们联系)
     known-peers = ["47.244.234.146:8921","119.3.143.201:8921","119.3.55.150:8921","122.112.231.114:8921","139.9.173.143:8921"]
    
  • blockchain.type 应该填 TESTNET 或 MAINNET.

  • miner中的enable是控制节点铸币的,主服务器请设为yes,备份服务器请保持no

  • 为确保铸币安全,我们建议reward-address配置填为您的冷钱包地址。您可以在这里下载冷钱包 https://www.b91.com 或者通过这个程序生成您的冷钱包地址 wallet generator

  • 为安全起见,api-key-hash这项应该设置成您自己的哈希值。您可以通过这个命令算出您的api密钥的哈希值:

     curl -X POST -d '<输入任意字符作为您的api密钥>' 'http://47.56.23.247:8922/utils/hash/secure'
    
  • 最后,我们命名并保存配置文件,例如命名为"b91-mainnet.conf"。

第3步: 运行

我们建立一个screen并运行

$ screen -S b91-node
$ sudo java -jar b91-all*.jar b91-mainnet.conf

如果需要退出screen,可以在键盘上按 Ctrl + A + D

如果需要再次进入screen看状态,可以运行

$ screen -x b91-node

超级节点竞选条件

在介绍竞选条件之前,先说明几个余额概念:

  • 您钱包当前所持有币的余额,叫做regular余额。
  • 可用余额(available)则为持有余额减去租出金额的余额(可用余额 = 持有余额 - 租出金额)。
  • 有效余额(effective)则为持有余额减去租出金额加上租入金额(有效余额 = 持有余额 - 租出金额 + 租入金额)。
  • Minting Average Balance (MAB)值是SPoS特有的一个概念。MAB值的计算和币龄有关,当一些币被交易或者租赁到另一个新地址,这些币的币龄将会从0开始计算,随着新的区块生成而开始增长。当经历完86400个区块后,这些币的币龄到满。也就是说,按照目前15个超级节点出块的情况来计算,钱包地址MAB值大概要经历4天时间才能达到最大。

(重点)普通节点想竞选超级节点成功需要符合以下条件:

  • 可用余额(available)>= 50000个B91币 (手续费)
  • 竞选时,有效余额(effective)>= 1百万个B91币 (超级节点有效余额的最低门槛)
  • 您的MAB值(mintingAverage)> 竞选目标节点的MAB值

募集资金增加MAB

当节点程序启动后,您可以通过API了解目前节点的状况(您可以打开浏览器输入地址http://<全节点ip>:8922打开Swagger客户端查看所有API)。

第1步:查询节点钱包地址

用 HTTP 的 GET 请求 /addresses 这个API可以得到当前节点钱包的所有地址:

$ curl -X GET 'http://<node ip>:8922/addresses'

如果成功将返回类似结果:

MAINNET:
[
  "b9XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
]
TESTNET:
[
  "bLXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
]

您需要把您的节点钱包地址告知给您的超级节点支持者并让他们把币租赁到节点钱包地址上,这些租赁的币将会增加节点地址的MAB,大概经历4天时间达到最大。

第2步:查询节点地址余额

查询这一个地址的余额可以通过 HTTP 的 GET 请求 /addresses/balance/details/{address} 这个API

$ curl -X GET 'http://<node ip>:8922/addresses/balance/details/b9XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'

如果成功将返回类似结果:

{
	'address': 'b9XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX',
	'mintingAverage': 123456700000000,    # MAB值
	'regular': 100801100000000, 		# 持有余额
	'available': 100801100000000,  		# 可用余额 (= 持有余额 - 租出金额)
	'effective': 100801100000000,  		# 有效余额 (= 持有余额 - 租出金额 + 租入金额)
	'height': 25200
}

(100000000 = 1个B91币)

第3步:查询竞选目标节点的MAB值

用 HTTP 的 GET 请求 /consensus/allSlotsInfo 这个API可以查到所有超级节点的 mintingAverageBalance (MAB) 信息:

$ curl -X GET 'http://<node ip>:8922/consensus/allSlotsInfo'

如果成功将返回类似结果:

[
  {
    "height": 25200
  },
  {
    "slotId": 0,
    "address": "b9xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "mintingAverageBalance": 25325183100020
  },
  {
    "slotId": 1,
    "address": "None",
    "mintingAverageBalance": 0
  },
  {
    "slotId": 2,
    "address": "None",
    "mintingAverageBalance": 0
  },
  {
    "slotId": 3,
    "address": "None",
    "mintingAverageBalance": 0
  },
  {
    "slotId": 4,
    "address": "b9yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy",
    "mintingAverageBalance": 24041001225854
  },
  {
    "slotId": 5,
    "address": "None",
    "mintingAverageBalance": 0
  },
  ......
]

您需要选一个MAB比您低的超级节点来竞争。需要特别提醒是,当因为MAB低于目标节点而导致的竞选失败的情况下,竞选所交的手续费将不会退回。

开始竞选

当一切准备就绪(可用余额>=50000个B91币,有效余额>=1百万个B91币,您的MAB值>竞选目标节点的MAB值),您就可以开始竞选超级节点了。

使用 Python SDK

如果您比较熟悉Python,我们建议您用B91spos_py_sdk来进行竞选。以下是在测试网上竞选的代码范例:

import B91SDK as pv
from B91SDK import Account
custom_wrapper = pv.create_api_wrapper('http://<node ip>:8922', api_key='')
ts_chain = pv.Chain(chain_name='testnet', chain_id='T', address_version=19, api_wrapper=custom_wrapper)
my_node = Account(chain=ts_chain, private_key='<your base58 private key>')
my_node.contend(<target slot id>)

使用 Swagger

您可以在浏览器里打开http://<node ip>:8922进入Swagger客户端

通过 POST 请求 /spos/contend 这个API来竞选。发送的JSON内容如下所示:

{
  "sender": "<您的节点钱包地址>",
  "slotId": <目标slot id>,
  "fee": 5000000000000,
  "feeScale": 100
}

注意:如果您发送请求后得到的是Provided API key is not correct错误,请确保您在Swagger客户端右上方的输入框输入了正确的api_key。同时您的节点的配置文件里api-key-hash项填写了正确的哈希值。

检查竞选结果

当您竞选成功后,如果您的超级节点保持运行,您可以查看您填写的reward-address的余额,每分钟应该都会收到铸币奖励。

当然您也可以通过API来查询铸币槽(slot)所属节点的情况。通过HTTP 的 GET 请求 /consensus/slotInfo/{slotId} 这个API:

$ curl -X GET 'http://<node ip>:8922/consensus/slotInfo/<slot id>'

如果成功将返回类似结果:

{
  "slotId": <slot id>,
  "address": "b9xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "mintingAverageBalance": 28151913800011,
  "height": 25310
}

如果address变成了您的节点钱包地址,说明您竞选成功。

竞选后续事项

安全问题

为确保铸币安全,我们建议您的超级节点服务器设置防火墙规则,不要将8922端口开放到公网,仅内网使用。如果您需要在公网使用Swagger客户端查询链上信息,您可以另起一个全节点,然后开放8922端口。建议打开8921端口,可以使得节点之间通讯更为发达和通畅,降低掉块率。

超级节点的维护

竞选成为超级节点后,为保证铸币一直运行,您应该建立另一台服务器做为备份服务器,当主服务器发生故障的时候可以马上切换服务器恢复铸币。备份服务器和主服务器相互切换可以通过修改配置文件中miner的enable项,或者切换钱包文件(钱包文件的位置在 <block & wallet data file path>/wallet/wallet.dat)。备份服务器要保持运行,保持区块同步,需要切换的的时候,切换配置文件或者钱包文件然后重启节点程序即可。强烈建议写一个自动化监控切换程序,一旦发现reward address得不到收益或者超级节点高度不增加的时候,自动切换配置文件或者钱包文件并重启节点程序。

定期分息

您的超级节点支持者将币租赁给您将增加您的MAB值,增加了其他竞争者抢占您这个铸币槽(slot)的难度。为了让支持者持续的为您保持MAB,您可以制定自己的派息策略来回馈您的支持者。查看正在租赁的的交易信息可以通过GET /transactions/activeLeaseList/{address} 这个API来查询:

$ curl -X GET 'http://<node ip>:8922/transactions/activeLeaseList/<您的节点钱包地址>'

如果成功将返回类似结果:

[
  [
    {
      "type": 3,
      "id": "idaidaidaidaidaidaidaidaidaidaidaidaidaidaid",
      "fee": 10000000,
      "timestamp": 1557911060003288000,
      "proofs": [
        {
          "proofType": "Curve25519",
          "publicKey": "publicKeypublicKeypublicKeypublicKeypublicK0",
          "signature": "signaturesignaturesignaturesignaturesignaturesignaturesignaturesignaturesignaturesignat0"
        }
      ],
      "amount": 830000000000,
      "recipient": "b9xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
      "feeScale": 100,
      "status": "Success",
      "feeCharged": 10000000,
      "height": 25325
    },
    {
      "type": 3,
      "id": "idbidbidbidbidbidbidbidbidbidbidbidbidbidbid",
      "fee": 10000000,
      "timestamp": 1558800150003288000,
      "proofs": [
        {
          "proofType": "Curve25519",
          "publicKey": "publicKeypublicKeypublicKeypublicKeypublicK1",
          "signature": "signaturesignaturesignaturesignaturesignaturesignaturesignaturesignaturesignaturesignat1"
        }
      ],
      "amount": 69487000000000,
      "recipient": "b9yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy",
      "feeScale": 100,
      "status": "Success",
      "feeCharged": 10000000,
      "height": 25330
    },
    ......
  ]
]

计算这些租赁的贡献,用您的派息策略来回馈您的支持者,让支持者持续的在您节点一直租赁。

You can’t perform that action at this time.