Skip to content

Latest commit

 

History

History
executable file
·
153 lines (100 loc) · 5.73 KB

README.md

File metadata and controls

executable file
·
153 lines (100 loc) · 5.73 KB
Raw

如何加入GOC测试网

一、获取代码

测试时，GOC在Github上的代码目前以私有方式提供，因此首先需向测试网维护人员提供Github账户名，以便授予权限，联系方式见文末。

具体GOC代码包括：

GOC代码：GOC testnet

fc submodule代码(调整了Primary key prefix)：Changed fc submodule

另，我们会在微信GOC测试网公测群发布关于源码分支的信息，重大调整会通过分支的方式预先发布，经过充分测试后，才合并至master主分支。

获得权限后，在命令行终端窗口执行以下命令获取代码并编译：

cd ~    # 退出当前目录，进入主目录
git clone git@github.com:BlockchainLabFudan/GOCtestnet.git
cd GOCtestnet
git submodule update --init --recursive
sudo ./eosio_build.sh -s 'GOC'
sudo ./eosio_install.sh

二、获取BP账户

获取BP账户需先准备好相关信息（如服务器IP）并提交至Github上，然后联系测试网维护人员创建BP账户，具体步骤如下：

1、Fork本repository

2、Clone Fork的repository（不是本repo）到本地

git clone git@github.com:xxxxxxxx/GOC-testnet.git 
# xxxxxxxx替换为你自己的GitHub帐号

3、以gravitypool.ini为例，新建bp-name.ini到producer-info文件夹中，bp-name为你的BP名称

4、将BP名称和p2p-peer-address添加到config.ini文件末尾（以已有信息为例）

5、创建一个pull request将你的BP信息提交至GOC-testnet上

6、联系测试网维护人员创建BP账户

三、注册出块BP

账户创建完成后，将BP账户注册为出块BP：

~/GOCtestnet/build/programs/keosd/keosd   # 启动钱包服务
cd ~/GOCtestnet/build/programs/cleos   # 进入cleos目录
./cleos wallet create --to-console    # 默认创建名为default的钱包，记录显示的钱包密码
./cleos wallet import       # 导入BP账户。运行后会提示输入私钥，输入BP账户的私钥
./cleos wallet create_key    # 创建一对公私钥作为producer key
./cleos -u http://47.52.114.54:8888 system regproducer 'yourbpname' 'your_producer_pub_key' 
# yourbpname为你的BP账户名，your_producer_pub_key为上一条命令创建的公钥

注：若钱包15分钟未使用，会提示钱包被锁，需要用以下命令解锁钱包：

./cleos wallet unlock   # 根据提示输入钱包密码即可

四、准备配置文件

1、genesis.json

在~/GOCtestnet/build/programs/nodeos文件夹下创建 genesis.json 文件，填入以下内容：

{
  "initial_timestamp": "2018-09-09T09:09:09.999",
  "initial_key": "GOC7oiy488wfzwbR6L9QwNDQb4CHGVR5ix9udJjVyykgbLaQLgBc5",
  "initial_configuration": {
    "max_block_net_usage": 1048576,
    "target_block_net_usage_pct": 1000,
    "max_transaction_net_usage": 524288,
    "base_per_transaction_net_usage": 12,
    "net_usage_leeway": 500,
    "context_free_discount_net_usage_num": 20,
    "context_free_discount_net_usage_den": 100,
    "max_block_cpu_usage": 200000,
    "target_block_cpu_usage_pct": 1000,
    "max_transaction_cpu_usage": 150000,
    "min_transaction_cpu_usage": 100,
    "max_transaction_lifetime": 3600,
    "deferred_trx_expiration_window": 600,
    "max_transaction_delay": 3888000,
    "max_inline_action_size": 4096,
    "max_inline_action_depth": 4,
    "max_authority_depth": 6
  }
}

genesis.json文件定义了初始链状态，所有节点必须从相同的初始状态开始

2、config.ini

将GOC-testnet里的config.ini复制到~/GOCtestnet/build/programs/nodeos文件夹下，注意要将自己的p2p-peer-address移除

五、启动出块节点

准备好一切之后，便可启动出块节点，连接测试网：

cd ~/GOCtestnet/build/programs/nodeos

./nodeos --genesis-json ./genesis.json --config-dir ~/GOCtestnet/build/programs/nodeos --http-server-address 0.0.0.0:8888 --p2p-listen-endpoint 0.0.0.0:9876 --http-validate-host=false --producer-name 'yourbpname' --signature-provider='your_producer_pub_key'=KEY:'your_producer_private_key' --plugin eosio::http_plugin --plugin eosio::chain_api_plugin --plugin eosio::producer_plugin --plugin eosio::history_api_plugin
# yourbpname填入BP账户名; your_producer_pub_key、your_producer_private_key分别填入创建的producer key的公钥和私钥。

连接测试网，会先同步测试网中已生产的块，等待一段时间同步完成后，每0.5s会收到出块节点产出的块，终端显示如下示例信息：

2018-09-29T10:47:23.478 thread-0   producer_plugin.cpp:332       on_incoming_block    ] Received block 9838cc2c992c2725... #406196 @ 2018-09-29T10:47:23.500 signed by producer111h [trxs: 0, lib: 406028, conf: 0, latency: -21 ms]
2018-09-29T10:47:24.072 thread-0   producer_plugin.cpp:332       on_incoming_block    ] Received block 3624e2ab8697a1e1... #406197 @ 2018-09-29T10:47:24.000 signed by producer111i [trxs: 0, lib: 406040, conf: 120, latency: 72 ms]

六、投票

再打开另一个命令行终端窗口，输入以下命令：

cd ~/GOCtestnet/build/programs/cleos

./cleos system voteproducer prods 'yourbpname' 'yourbpname'
# yourbpname填入BP账户名

./cleos get schedule 
# 查看当前测试网出块节点

当nodeos同步到最新块，且得票数足够多BP账户出现在schedule中时，便可观察自己的节点是否正常出块

测试网维护人员联系方式

代码层次的技术问题请联系刘博士：baixiangliu@gmail.com

节点连接测试网等其它问题请微信联系vc：Chen7ccc