Skip to content

Latest commit

 

History

History
258 lines (172 loc) · 9.59 KB

private chain.md

File metadata and controls

258 lines (172 loc) · 9.59 KB

私有链搭建

1、环境安装

请安装见证人节点和完整客户端。

2、创建一个存储私链文件的文件夹

创建一个新文件夹作为私链的根目录，并复制见证人节点文件和完整客户端复制到此目录下。

3、初始文件

通过初始文件初始化私链。

基于石墨烯技术的区块链网络创世区块整合了所有见证人、理事会成员和基金会。单个称为nathan的账户可以通过以下私钥获得：

5KQwrPbwdL6PhXujxW37FSSQZ1JiwsST4cqQzDeyXtP79zkvFD3

接下来将讲解如何使用以上私钥，并会说明如何定义你自己的创世文件。

运行这条命令来创建一个名为my-genesis.json的初始文件：

$ witness_node --create-genesis-json my-genesis.json

my-genesis.json这个文件将会存储在你私钥文件夹的根目录下，运行此命令后，所有见证人节点都会自行完成命令。

如果你想要自定义初始设定，打开my-genesis.json，你可以做以下的修改：

  • 修改初始文件中账户， 以及账户名和公钥
  • 区块链资产和初次分发（包含核心资产）
  • 私链参数的最初基准（包括费用）
  • 初始见证人的账户签名秘钥

4、获得区块链ID

区块链ID是初始状态的哈希值。任何一笔交易都对应一个独有的有效区块链ID。因此如您编辑了您的初始文件，您的区块链ID将会变化，而且你将不能和现存的主链同步（除非现存的主链和你的初始文件正好相同）。

运行以下命令:

witness_node --data-dir data   # to use the default genesis, or
witness_node --data-dir data --genesis-json my-genesis.json   # your own genesis block

当这条信息出现时:

3501235ms th_a main.cpp:165 main] Started witness node on a chain with 0 blocks.
3501235ms th_a main.cpp:166 main] Chain ID is 8b7bd36a146a03d0e5d0a971e286098f41230b209d96f92465cd62bd64294824

此时你的初始化已经完成，按ctrl-c 关闭见证人节点。

因此, 你应该生成了两个文件:

  • 在词典库data中创建了一个新文件config.ini
  • Your blockchain id is now known - it’s displayed in the message above.

注意

请注意你的区块链ID会和上述例子中的ID不同。请记录下你的ID，在之后你将会用到它。

5、配置见证人

用文本编辑器打开刚生成的data/config.ini, 做如下设置, 必要时请不要注释这些代码:

rpc-endpoint = 127.0.0.1:11011
genesis-json = my-genesis.json
enable-stale-production = true

在config.ini中定位以下语句:

# ID of witness controlled by this node (e.g. "1.6.5", quotes are required, may specify multiple times)

并添加如下词条:

witness-id = "1.6.1"
witness-id = "1.6.2"
witness-id = "1.6.3"
witness-id = "1.6.4"
witness-id = "1.6.5"
witness-id = "1.6.6"
witness-id = "1.6.7"
witness-id = "1.6.8"
witness-id = "1.6.9"
witness-id = "1.6.10"
witness-id = "1.6.11"

上述列表授权了见证人节点用见证人ID来生成区块. 正常情况下，每个见证人的节点不同，但在私有链中，我们会先设定成全体见证人在同一个节点生产区块。这些见证人ID的私钥（用来签署区块）已经在config.ini中提供：

# Tuple of [PublicKey, WIF private key] (may specify multiple times)
private-key = ["GXC6MRyA...T5GDW5CV","5KQwrPb...tP79zkvFD3"]

6、开始生产区块

通过以下步骤，你可以生产基于你私链的第一个区块了，在见证人节点中运行以下命令:

witness_node --data-dir data

之后私链的区块将开始生成，你会看到如下指示:

********************************
*                              *
*   ------- NEW CHAIN ------   *
*   - Welcome to Graphene! -   *
*   ------------------------   *
*                              *
********************************

之后data/log/witness.log文件会有更多成功生成区块的日志生成:

2322793ms th_a  main.cpp:176     main    ] Started witness node on a chain with 0 blocks.
2322794ms th_a  main.cpp:177     main    ] Chain ID is 8b7bd36a146a03d0e5d0a971e286098f41230b209d96f92465cd62bd64294824
2324613ms th_a  witness.cpp:185  block_production_loo ] Generated block #1 with timestamp 2016-01-21T22:38:40 at time 2016-01-21T22:38:40
2325604ms th_a  witness.cpp:194  block_production_loo ] Not producing block because slot has not yet arrived
2342604ms th_a  witness.cpp:194  block_production_loo ] Not producing block because slot has not yet arrived
2343609ms th_a  witness.cpp:194  block_production_loo ] Not producing block because slot has not yet arrived
2344604ms th_a  witness.cpp:185  block_production_loo ] Generated block #2 with timestamp 2016-01-21T22:39:00 at time 2016-01-21T22:39:00
2345605ms th_a  witness.cpp:194  block_production_loo ] Not producing block because slot has not yet arrived
2349616ms th_a  witness.cpp:185  block_production_loo ] Generated block #3 with timestamp 2016-01-21T22:39:05 at time 2016-01-21T22:39:05
2350602ms th_a  witness.cpp:194  block_production_loo ] Not producing block because slot has not yet arrived
2353612ms th_a  witness.cpp:194  block_production_loo ] Not producing block because slot has not yet arrived
2354605ms th_a  witness.cpp:185  block_production_loo ] Generated block #4 with timestamp 2016-01-21T22:39:10 at time 2016-01-21T22:39:10
2355609ms th_a  witness.cpp:194  block_production_loo ] Not producing block because slot has not yet arrived
2356609ms th_a  witness.cpp:194  block_production_loo ] Not producing block because slot has not yet arrived

如果witness.log无日志生成，可以将日志打印打控制台，可以修改data/config.ini文件如下，然后重新启动witness

[logger.default]
level=debug
appenders=stderr

7、客户端（Cli）用法

现在可以将客户端和你的私链的见证人节点相关联。先确保你的见证人节点在运行状态，在另外一个CMD中运行以下命令：

cli_wallet --wallet-file=my-wallet.json --chain-id 8b7bd36a146a03d0e5d0a971e286098f41230b209d96f92465cd62bd64294824 --server-rpc-endpoint=ws://127.0.0.1:11011

注意

请确保用你自己私链的区块链ID替代上述ID8b7bd36a...4294824区块链ID传递给客户端时需要匹配生成的ID，且给见证人节点需要使用此区块链ID。

如果你收到set_password提示，意味着你的客户端已经成功匹配见证人节点。

创建一个新钱包

首先你需要为你的钱包创建一个新的密码。这个密码被用于加密所有钱包的私钥。在教程中我们使用如下密码：supersecret

但你可以使用字母和数字的组合来创建属于你的密码。通过以下命令来创建你的密码：:

>>> set_password supersecret

现在你可以解锁你新建的钱包了：

unlock supersecret

获得初始份额

在石墨烯中，资产账户包含在钱包账户中， 要向你的钱包中添加钱包账户, 你需要知道账户名以及账户的私钥。 在例子中，我们将通过import_key命令向现有钱包中添加一个名叫nathan的账户：

import_key nathan 5KQwrPbwdL6PhXujxW37FSSQZ1JiwsST4cqQzDeyXtP79zkvFD3

注意

注意nathan在初始文件中会被用于定义账户名. 如果你修改过my-genesies.json 文件，你可以填入一个不同的名字。并且，请注意5KQwrPbwdL...P79zkvFD3是定义在config.ini内的私钥

现在我们已经将私钥导入进钱包，但没有和储蓄相关联。储蓄被保存在初始账户内。这些储蓄可以通过import_balance命令来申明，无需申明费用：

import_balance nathan ["5KQwrPbwdL6PhXujxW37FSSQZ1JiwsST4cqQzDeyXtP79zkvFD3"] true

因此，我们导入了一个名为nathan的账户，且账户储蓄已经完全与GXB相关联，因为我们已经声称这些储蓄被保存在了初始文件内。你可以通过以下命令来检视你的账户：

get_account nathan

用以下命令获取账户余额：

list_account_balances nathan

创建其他账户

现在我们讲创建一个新的账户alpha ，这样我们可以在 nathan和alpha两个账户中来回转账了。

通常我们用一个已有账户来创建新账户，因为登记员需要缴纳注册费用。 并且，登记员的账户需要进入Also, there is the requirement lifetime member (LTM)状态。因此我们必须在创建新账户前，先将账户nathan升级到LTM状态， 使用upgrade_account命令来升级账户：

upgrade_account nathan GXC true

注意

你需要重启客户端，否则将无法识别nathan已经成功升级。通过ctrl-c停止客户端，然后通过如下指令重启客户端：

cli_wallet --wallet-file=my-wallet.json --chain-id 8b7bd36a146a03d0e5d0a971e286098f41230b209d96f92465cd62bd64294824 --server-rpc-endpoint=ws://127.0.0.1:11011

确认nathan已经拥有LTM权限：

get_account nathan

返回的信息中，在membership_expiration_date边上你会发现1969-12-31T23:59:59。 如果你看到1970-01-01T00:00:00，说明之前的操作出现了错误，nathan没能成功升级。

成功升级后，我们可以通过nathan来注册新账户，但首先我们需要拥有新账户的公钥。通过使用suggest_brain_key命令来完成：

suggest_brain_key

然后调用register_account / register_account2接口创建新帐户

register_account alpha GXC6vQtDEgHSickqe9itW8fbFyUrKZK5xsg4FRHzQZ7hStaWqEKhZ GXC6vQtDEgHSickqe9itW8fbFyUrKZK5xsg4FRHzQZ7hStaWqEKhZ nathan nathan 10

最终将有类似如下的回复：

list_account_balances alpha