first step
# 安装vuepress
npm install vuepress -g
# Clone项目
git clone git@github.com:gxchain/docs.git
cd docs
# dev模式启动
npm start
VuePress dev server listening at http://localhost:8080/
访问 http://localhost:8080/ 获取完整手册，提供中文支持
secend step
# 执行这个shell脚本，会自动从github下载最新的测试网程序，并解压至当前目录下
curl 'https://raw.githubusercontent.com/gxchain/gxb-core/dev_master/script/gxchain_testnet_install.sh' | bash
wget http://gxb-package.oss-cn-hangzhou.aliyuncs.com/gxb-core/genesis/testnet-genesis.json -O genesis.json
关于genisis.json
- genisis.json即创世文件
- 每一条链都有唯一的genesis.json
- genesis.json中指定了创世区块所必须的配置信息和节点启动的初始化参数
- 任意一个字符的改变，都会得到一个不同的chain_id
不同的chain_id将导致无法和seed_node之间相互通讯- 因此：请勿改变genisis.json，除非你想跑一条私有链
启动测试节点
./programs/witness_node/witness_node --data-dir=testnet_node --rpc-endpoint="0.0.0.0:28090" --p2p-endpoint="0.0.0.0:9999" --seed-nodes='["testnet.gxchain.org:6789"]' --genesis-json genesis.json &
参数介绍
- --data-dir指定区块数据存储路径
- --rpc-endpoin 开启rpc服务
- --p2p-endpoint 开启p2p监听服务
- --seed-nodes 指定节点启动时连接的种子节点
Writing new config file at /anshi/gxchaintest/testnet_node/config.ini
此状态时可以查看 log
cat ./gxchaintest/testnet_node/logs
区块每次 1000 递增即同步区块，维持 1 区块递增时一般认为区块同步完成。
启动命令行钱包
ws 监听在 28090 端口，所以以下参数启动
./cli_wallet -s ws://127.0.0.1:28090
启动之后生成公钥私钥
key_to_wif( committee_private_key ): 5KCBDTcyDqzsqehcb52tW5nU6pXife6V2rX9Yf7c3saYSzb****
2204910ms th_a main.cpp:159 main ] nathan_pub_key: GXC6MRyAjQq8ud7hVNYcfnVPJqcVpscN5So8BhtHuGYqET5GD****
2204913ms th_a main.cpp:160 main ] key_to_wif( nathan_private_key ): 5KQwrPbwdL6PhXujxW37FSSQZ1JiwsST4cqQzDeyXtP79zk****
Starting a new wallet with chain ID c2af30ef9340ff81fd61654295e98a1ff04b23189748f86727d0b26b40bb**** (from egenesis)
启动之后会提示添加钱包密码
Please use the set_password method to initialize a new wallet before continuing
- wif_priv_key: 私钥，在程序中使用
- pub_key: 公钥，用于链上账户注册
set_password ********
之后解锁账号
unlock ********
导入私钥
- 测试节点 web 钱包
https://testnet.wallet.gxchain.org
创建账户
import_key your_account your_priv_key
- 查看账号信息
get_account your_account - 查看余额
list_account_balances your_account - 详细 wallet_api 接口文档
申领测试网络 GXC
- 申领免费 token
- 测试网络Token自动申领, 每次200个，每天1000个, 浏览器访问
https://testnet.gxchain.org/gxc/get_token?your_account_name
