GXChain文档

# 快速开始

# 认识GXChain

GXChain是一条去中心化的、高性能的、生态丰富的治理型公链，在GXChain生态中，理事会、公信节点、持币人共同完成链的治理。

  • 理事会：公信节点按得票数的前 11 名当选为 GXChain 理事会成员，主要负责区块链动态参数的修改。
  • 公信节点：负责打包区块、验证交易，每 1 小时统计一次投票，按得票数选出前 21 个为公信节点。
  • 持币人：持有任意数量GXC的个体或机构，持币人可以参与GXChain生态，为公信节点投票。

GXChain底层采用基于DPoS共识机制的石墨烯架构，拥有更高的性能。

  • 区块生成时间：3 s
  • TPS：千级

# 环境要求

  • 系统: macOS / Ubuntu 14.04 64-bit, 4.4.0-63-generic 以上内核
  • 内存: 16GB+
  • 硬盘: 100GB+
  • 网络： 20MB+带宽

依赖安装

  • 安装ntp
sudo apt-get install ntp
# macOS安装ntp:  brew install ntp
  • 安装libstdc++-7-dev
# Ubuntu系统需要安装, macOS不需要
apt-get update
apt-get install software-properties-common
add-apt-repository ppa:ubuntu-toolchain-r/test
apt-get update
apt-get install libstdc++-7-dev
  • 如果你想运行带插件的版本(-with-plugin)，需要安装libcurl3
apt-get install libcurl3 -y

# 节点安装

以下的步骤演示的是主网节点的启动

# 1. 下载Release包

# 执行这个shell脚本，会自动从github下载最新的主网程序，并解压至当前目录下
curl 'https://raw.githubusercontent.com/gxchain/gxb-core/dev_master/script/gxchain_install.sh' | bash

# 2. 启动节点， 同步数据

nohup ./programs/witness_node/witness_node --data-dir=trusted_node --rpc-endpoint="127.0.0.1:28090" 1>nohup.out 2>&1 &

上面的命令:

  • 启动了一个监听在 127.0.0.1:28090 的RPC服务
  • 指定了区块信息保存在 ./trusted_node 目录下

友情提示

  • 同步区块大约需要 30+小时, 当然这和你的网络情况有一定关系
  • 在区块同步完成之前，你只需耐心等待，在此期间可以阅读一下文档

# 3. 查看日志，等待数据同步完成

tail -f trusted_node/logs/witness.log

节点同步完成后，日志看起来是这样的(每3秒钟从网络接收1个新区块):

2018-06-28T03:43:03 th_a:invoke handle_block         handle_block ] Got block: #10731531 time: 2018-06-28T03:43:03 latency: 60 ms from: miner11  irreversible: 10731513 (-18)			application.cpp:489
2018-06-28T03:43:06 th_a:invoke handle_block         handle_block ] Got block: #10731532 time: 2018-06-28T03:43:06 latency: 16 ms from: taffy  irreversible: 10731515 (-17)			application.cpp:489
2018-06-28T03:43:09 th_a:invoke handle_block         handle_block ] Got block: #10731533 time: 2018-06-28T03:43:09 latency: 49 ms from: david12  irreversible: 10731515 (-18)			application.cpp:489
2018-06-28T03:43:12 th_a:invoke handle_block         handle_block ] Got block: #10731534 time: 2018-06-28T03:43:12 latency: 42 ms from: miner6  irreversible: 10731516 (-18)			application.cpp:489
2018-06-28T03:43:15 th_a:invoke handle_block         handle_block ] Got block: #10731535 time: 2018-06-28T03:43:15 latency: 10 ms from: sakura  irreversible: 10731516 (-19)			application.cpp:489
2018-06-28T03:43:18 th_a:invoke handle_block         handle_block ] Got block: #10731536 time: 2018-06-28T03:43:18 latency: 57 ms from: miner9  irreversible: 10731517 (-19)			application.cpp:489
2018-06-28T03:43:21 th_a:invoke handle_block         handle_block ] Got block: #10731537 time: 2018-06-28T03:43:21 latency: 56 ms from: robin-green  irreversible: 10731517 (-20)			application.cpp:489
2018-06-28T03:43:24 th_a:invoke handle_block         handle_block ] Got block: #10731538 time: 2018-06-28T03:43:24 latency: 17 ms from: kairos  irreversible: 10731522 (-16)			application.cpp:489
2018-06-28T03:43:27 th_a:invoke handle_block         handle_block ] Got block: #10731539 time: 2018-06-28T03:43:27 latency: 21 ms from: dennis1  irreversible: 10731524 (-15)			application.cpp:489
2018-06-28T03:43:30 th_a:invoke handle_block         handle_block ] Got block: #10731540 time: 2018-06-28T03:43:30 latency: 17 ms from: aaron  irreversible: 10731524 (-16)			application.cpp:489
2018-06-28T03:43:33 th_a:invoke handle_block         handle_block ] Got block: #10731541 time: 2018-06-28T03:43:33 latency: 23 ms from: caitlin  irreversible: 10731526 (-15)			application.cpp:489

# 账户注册

GXChain采用账户模型，并且引入了推荐注册机制，因此在GXChain上注册一个账号，需要以下三个要素:

  • 推荐人，推荐人是链上已存在的账户，会使用你的账户名和公钥帮你注册一个账号
  • 账户名，账户名在链上是唯一的，所以请记住在GXChain上，账户名即地址 (如gxchain-genius)
  • ECC公钥，以GXC开头，Base64 编码的ECC公钥 (如何生成公钥？别担心，请往后看)

有两种方式可以完成账户的注册:

# 1. 在线钱包

使用在线钱包https://wallet.gxb.io (opens new window)在界面上完成上述步骤

# 2. 手动注册

推荐对私钥安全要求较高的开发者使用这种方式完成注册，保证私钥是离线的

# 步骤1: 通过cli_wallet来生成一对公私钥

./programs/cli_wallet/cli_wallet --suggest-brain-key
{
  "brain_priv_key": "SHAP CASCADE AIRLIKE WRINKLE CUNETTE FROWNY MISREAD MOIST HANDSET COLOVE EMOTION UNSPAN SEAWARD HAGGIS TEENTY NARRAS",
  "wif_priv_key": "5J2FpCq3UmvcodkCCofXSNvHYTodufbPajwpoEFAh2TJf27EuL3",
  "pub_key": "GXC75UwALPEFECfHLjHyNSxCk1j7XzSvApQiXKEbanWgr7yvXXbdG"
}

字段解释

  • brain_priv_key: 助记词，是私钥的原始文本，通过助记词可以还原出私钥
  • wif_priv_key: 私钥，在程序中使用
  • pub_key: 公钥，用于链上账户注册

# 步骤2: 通过水龙头来完成账户注册

  1. 想一个专属的账户名(account_name),如gxchain-genius
  2. 替换下面curl命令中的 <account_name> and <public_key> 并在终端执行:
curl 'https://opengateway.gxb.io/account/register' -H 'Content-type: application/json' -H 'Accept: application/json' -d '{"account":{"name":"<account_name>","owner_key":"<public_key>","active_key":"<public_key>","memo_key":"<public_key>","refcode":null,"referrer":null}}'

客户端 →