百度超级链基本操作教程
1、准备环境
百度超级链更新到 5.1 版本了，但是我们使用 3.10 版本，这个版本的功能用起来刚好
官网文档：https://github.com/xuperchain/xuperchain/tree/v3.10
# 下载源码
git clone https://github.com/xuperchain/xuperchain.git
# 编译源码
cd xuperchain
git checkout v3.10
make
编译完成后，在 output 下，主要目录有 data, logs, conf, plugins 等，二进制文件有 xchain，xchain-cli，xchain-httpgw 等
make 时，可能出现拉取失败的情况，可以配置 GOPROXY 解决此问题$ export GOPROXY=https://goproxy.cn,direct
GOPATH 问题报错，不推荐使用 go1.11 版本之前的版本
GCC 版本需要升级到 4 或 5 以上
各目录的功能如下表：
output/：节点根目录
├─ conf：xchain.yaml: xchain 服务的配置信息（注意端口冲突） plugins.conf: 插件的配置信息
├─ data：数据的存放目录，创世块信息，以及共识和合约的样例
│ ··· ├─ blockchain：账本目录
│ ··· ├─ keys：此节点的地址，具有全局唯一性
│ ··· ├─ netkeys：此节点的网络标识 ID，具有全局唯一性
│ ··· └─ config：包括创始的共识，初始的资源数，矿工奖励机制等
├─ logs：程序日志目录
├─ plugins：so 扩展的存放目录
├─ xchain：xchain 服务的二进制文件
├─ xchain-cli：xchain 客户端工具
└─ wasm2c：wasm 工具（智能合约会用到）
2、部署 xchain 服务
2.1 创建链
在启动 xchain 服务之前，我们首先需要创建一条链（创世区块），xchain 客户端工具提供了此功能
# 创建xuper链
./xchain-cli createChain
这样我们就使用 config/xuper.json 中的配置创建了一条链（此时 data/blockchain 中会生成 xuper 目录，里面即是我们创建的链的账本等文件）
2.2 启动服务
启动服务命令十分简单，还可以配合多种参数使用，详见命令行的 -h 输出
# 启动服务节点
nohup ./xchain &
2.3 确认服务状态
按照默认配置，xchain 服务会监听 37101 端口，可以使用如下命令查看 xchain 服务的运行状态
# check服务运行状况
./xchain-cli status -H 127.0.0.1:37101
3、基本功能的使用
3.1 创建账号
xchain 中，账号分为“普通账号”和 “合约账号”，普通账号和合约账号的创建，命令如下：
# 创建普通用户, 包含地址，公钥，私钥
./xchain-cli account newkeys --output data/bob
# 在bob目录下会看到文件address，publickey，privatekey生成
# 创建合约账号
./xchain-cli account new --account 1111111111111111 # 16位数字组成的字符串
创建合约账号会创建一个名为 XC1111111111111111@xuper 的账号，由于我们没有制定 ACL 的具体内容，其 ACL 被赋值为默认状态，即背后有权限的账号只有当前节点上默认账号一个（地址默认位于 data/keys/address）
创建合约账号的操作需要提供手续费，需要按照命令行运行结果给出的数值，添加一个不小于它的费用（使用 –fee 参数）
3.2 查询账号余额
对于普通账号和合约账号，可使用如下命令查询账号资源余额，其中 -H 参数为 xchain 服务的地址
# 查询普通账号余额
./xchain-cli account balance --keys data/keys -H 127.0.0.1:37101
# 查询合约账号余额
./xchain-cli account balance XC1111111111111111@xuper -H 127.0.0.1:37101
3.3 转账
转账操作需要提供源账号的私钥目录，也就类似 “3.1” 中生成的目录，这里注意到并不需要提供目标账号的任何密钥，只需要提供地址即可，这里既可以给普通账号转账也可以给合约账号转账
# --keys 从此地址 转给 --to地址 --amount 钱
# 向普通账号转账
./xchain-cli transfer --to czojZcZ6cHSiDVJ4jFoZMB1PjKnfUiuFQ --amount 1000000000 --keys data/keys/ -H 127.0.0.1:37101
# 向合约账号转账
./xchain-cli transfer --to XC1111111111111111@xuper --amount 10000000000 --keys data/keys/ -H 127.0.0.1:37101
命令执行的返回是转账操作的交易 id（txid），这个 txid 也就是交易hash ，通过txid 可以查询交易信息
3.4 查询交易信息
通过以下命令可以查询交易的信息，包括交易状态、交易的源和目标账号、交易的金额、所在的区块（如果已上链）等内容
# 可查询上一步生成的txid的交易信息
./xchain-cli tx query cbbda2606837c950160e99480049e2aec3e60689a280b68a2d253fdd8a6ce931 -H 127.0.0.1:37101
3.5 查询 block 信息
通过 blockid 可以查询区块的相关信息，包括区块内打包的交易、所在链的高度、前驱 / 后继区块的 id 等内容
# 可查询上一步交易所在的block id信息
./xchain-cli block 0354240c8335e10d8b48d76c0584e29ab604cfdb7b421d973f01a2a49bb67fee -H 127.0.0.1:37101
3.6 部署合约
部署合约的操作需要由合约账号完成，部署操作同样需要支付手续费，操作前需要确保合约账号下有足够的余额，否则会报错。
1、部署合约
其中，-a 是 合约的初始参数，counter.wasm 文件是合约编译之后的二进制文件
# 部署 counter 合约，counter 是百度超级链提供部的一个模板合约
./xchain-cli wasm deploy --account XC1111111111111111@xuper -a '{"creator":"XC1111111111111111@xuper"}' --cname counter ./counter.wasm
# 部署 filehash 合约，filehash 是百度超级链提供部的一个模板合约
./xchain-cli wasm deploy --account XC1111111111111111@xuper -a '{}' --cname filehash ./filehash.wasm --fee 160000
运行时会提示手续费的数目，使用 –fee 参数传入即可
2、合约调用
# 调用 counter 合约方法
./xchain-cli wasm invoke --method increase -a '{"key":"test"}' counter --fee 100
# The gas you cousume is: 93
# The fee you pay is: 100
# Tx id: 141e4c1fb99566ce4b6ba32fa92af73c0e9857189debf773cf5753d64e1416a7
./xchain-cli wasm query --method get -a '{"key":"test"}'
# counter contract response: 1
