• 1. XuperUnion环境部署
    • 1.1. 准备环境
    • 1.2. 编译XuperUnion
  • 2. XuperUnion基本操作
    • 2.1. 部署xchain服务
      • 2.1.1. 创建链
      • 2.1.2. 启动服务
      • 2.1.3. 确认服务状态
    • 2.2. 基本功能的使用
      • 2.2.1. 创建新账号
      • 2.2.2. 查询资源余额
      • 2.2.3. 转账
      • 2.2.4. 查询交易信息
      • 2.2.5. 查询block信息
      • 2.2.6. 发起多重签名交易

    本章节将指导您获取XuperUnion的代码并部署一个基础的可用环境，还会展示一些基本操作

    1. XuperUnion环境部署

    1.1. 准备环境

    XuperUnion主要由Golang开发，需要首先准备编译运行的环境

    • 安装go语言编译环境，版本为1.11或更高
      • 下载地址：golang
    • 安装git
      • 下载地址：git

    1.2. 编译XuperUnion

    • 使用git下载源码到本地
    • git clone https://github.com/xuperchain/xuperunion.git
    • 执行命令
    1. cd src/github.com/xuperchain/xuperunion
    2. make
    • 在output目录得到产出xchain和xchain-cli

    注解

    可能需要配置go语言环境变量（$GOROOT, $PATH）

    • GOPATH问题报错（go1.11版本之后无需关注）
      • 在1.11版本之前需要配置。配置成以下形式：
      • 比如代码路径xxx/github.com/xuperchain/xuperunion/src/baidu.com/xchain/xxx
      • export GOPATH=xxx/github.com/xuperchain/xuperunion

    GCC版本需要升级到4或5以上

    2. XuperUnion基本操作

    在output下，主要目录有data, logs, conf, plugins等, 二进制文件有xchain，xchain-cli

    各目录的功能如下表：

    目录名功能
    output/节点根目录
    ├─ confxchain.yaml: xchain服务的配置信息（注意端口冲突）plugins.conf: 插件的配置信息
    ├─ data数据的存放目录，创世块信息，以及共识和合约的样例
    │ ··· ├─ blockchain账本目录
    │ ··· ├─ keys此节点的地址，具有全局唯一性
    │ ··· ├─ netkeys此节点的网络标识ID，具有全局唯一性
    │ ··· └─ config包括创始的共识，初始的资源数，矿工奖励机制等
    ├─ logs程序日志目录
    ├─ pluginsso扩展的存放目录
    ├─ xchainxchain服务的二进制文件
    ├─ xchain-clixchain客户端工具
    └─ wasm2cwasm工具（智能合约会用到）

    2.1. 部署xchain服务

    2.1.1. 创建链

    在启动xchain服务之前，我们首先需要创建一条链（创世区块），xchain客户端工具提供了此功能

    1. # 创建xuper链
    2. ./xchain-cli createChain

    创建链 创建链

    这样我们就使用 config/xuper.json 中的配置创建了一条链（此时 data/blockchain 中会生成 xuper 目录，里面即是我们创建的链的账本等文件）

    2.1.2. 启动服务

    启动服务命令十分简单，还可以配合多种参数使用，详见命令行的 -h 输出

    1. # 启动服务节点
    2. nohup ./xchain &

    2.1.3. 确认服务状态

    按照默认配置，xchain服务会监听37101端口，可以使用如下命令查看xchain服务的运行状态

    1. # check服务运行状况
    2. ./xchain-cli status -H 127.0.0.1:37101

    查看状态 查看运行状态

    2.2. 基本功能的使用

    2.2.1. 创建新账号

    xchain中，账号分为普通账号和“合约账号”，这里先介绍普通账号的创建，命令如下

    1. # 创建普通用户, 包含地址，公钥，私钥
    2. ./xchain-cli account newkeys --output data/bob
    3. # 在bob目录下会看到文件address，publickey，privatekey生成

    创建账号

    创建账号

    2.2.2. 查询资源余额

    对于普通账号，可使用如下命令查询账号资源余额，其中 -H 参数为xchain服务的地址

    1. ./xchain-cli account balance --keys data/keys -H 127.0.0.1:37101

    查询余额 查询余额

    2.2.3. 转账

    转账操作需要提供源账号的私钥目录，也就类似“1.2.4.1”中生成的目录，这里注意到并不需要提供目标账号的任何密钥，只需要提供地址即可

    1. # --keys 从此地址 转给 --to地址 --amount 钱
    2. ./xchain-cli transfer --to czojZcZ6cHSiDVJ4jFoZMB1PjKnfUiuFQ --amount 10 --keys data/keys/ -H 127.0.0.1:37101

    命令执行的返回是转账操作的交易id（txid）

    普通转账 普通转账操作

    2.2.4. 查询交易信息

    通过以下命令可以查询交易的信息，包括交易状态、交易的源和目标账号、交易的金额、所在的区块（如果已上链）等内容

    1. # 可查询上一步生成的txid的交易信息
    2. ./xchain-cli tx query cbbda2606837c950160e99480049e2aec3e60689a280b68a2d253fdd8a6ce931 -H 127.0.0.1:37101

    查询交易 查询交易

    2.2.5. 查询block信息

    通过blockid可以查询区块的相关信息，包括区块内打包的交易、所在链的高度、前驱/后继区块的id等内容

    1. # 可查询上一步交易所在的block id信息
    2. ./xchain-cli block 0354240c8335e10d8b48d76c0584e29ab604cfdb7b421d973f01a2a49bb67fee -H 127.0.0.1:37101

    查询区块 查询区块

    2.2.6. 发起多重签名交易

    对于需要多个账号签名才可以生效的交易，需要先发起多重签名交易，收集需要的签名，然后在发出

    对需要收集签名的账号地址，需要事先维护在一个文件中（假定名为addr_list），每个地址一行

    1. YDYBchKWXpG7HSkHy4YoyzTJnd3hTFBgG
    2. ZAmWoJViiNn5pKz32m2MVgmPnSpgLia7z

    假设要发起一笔转账操作

    1. # 从账号发起
    2. ./xchain-cli multisig gen --to czojZcZ6cHSiDVJ4jFoZMB1PjKnfUiuFQ --amount 100 -A addr_list
    3. # 从合约账号发起
    4. ./xchain-cli multisig gen --to czojZcZ6cHSiDVJ4jFoZMB1PjKnfUiuFQ --amount 100 -A addr_list --from XC11111111111111@xuper

    这样会生成一个tx.out文件，包含了需发起的交易内容

    1. # 各方在签名之前可以check 原始交易是否ok，查看visual.out
    2. ./xchain-cli multisig check --input tx.out --output visual.out

    然后收集需要的签名

    1. # 首先需要发起者自己的签名
    2. ./xchain-cli multisig sign --tx tx.out --output my.sign
    3. # 假设addr_list中的地址对应的私钥存放在alice、bob中
    4. ./xchain-cli multisig sign --keys data/account/alice --tx tx.out --output alice.sign
    5. ./xchain-cli multisig sign --keys data/account/bob --tx tx.out --output bob.sign

    最后将交易和收集好的签名发出

    1. # send后第一个参数是发起者的签名文件，第二个参数是需要收集的签名文件，均为逗号分割
    2. ./xchain-cli multisig send --tx tx.out my.sign alice.sign,bob.sign