環境配置

目前 XuperChain 節點主要運行在linux和mac上，windows不能運行 XuperChain 節點，

go語言安裝

ubuntu16.04下 通過apt-get install 安裝go 默認版本為1.6，但百度區塊鏈要求安裝go版本為1.11或更高，如果不想做從官網下載go壓縮包并解壓、配置環境變數這些繁瑣流程，可以嘗試這篇帖子: link
帖子中詳細介紹了直接將默認1.6低版本的升級為高版本go，

git安裝

詳情見百度區塊鏈開發手冊：link

$ sudo apt install git

客戶端安裝

使用git下載原始碼到本地：

$ git clone https://github.com/xuperchain/xuperchain.git

git完后當前目錄有一個檔案夾叫xuperchain，這個時候我們可以make一下了，輸入命令

$ cd xuperchain
$ make

這里make一般出大問題，make完后一定要去xuperchain/output/bin檔案夾看有沒有出來三個可執行檔案，

如果缺少xchain、xchain-cli檔案，那就說明失敗了，根據這兩天改這個bug經驗，總結有兩個原因比較關鍵：

1. 和國內網路防火墻有關，官方開發手冊給出如下說明：

make 時，可能出現拉取失敗的情況，可以配置GOPROXY解決此問題

$ export GOPROXY=https://goproxy.cn,direct

GOPATH問題報錯,不推薦使用go1.11版本之前的版本

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

2. go編譯失敗，會出現一長串go : could not … permission denied
   此時不妨試試上述安裝go目錄給出的帖子，按照里面步驟更新一下go，
   如果make成功，出現如下三個可執行檔案，此時說明編譯成功，
   

啟動私鏈

啟動命令：

$ bash control.sh start

這樣，我們就成功啟動一條鏈，在每次執行代碼時都需要先進行啟動操作，
control.sh 腳本提供 start | stop | restart | forcestop 四個命令，可以使用bash control.sh help查看，
也可以查看服務運行的狀態：

$ bin/xchain-cli status -H 127.0.0.1:37101

基本操作命令

1. 創建普通用戶

$ bin/xchain-cli account newkeys --output data/bob

生成的地址，公鑰，私鑰在–output 指定位置，可以看到在output/data/bob里面已經成功創建普通用戶

2. 創建合約賬號

$ bin/xchain-cli account new --account 1111111111111111 --fee 2000

3. 查詢余額

根據賬戶存盤的路徑，查詢該賬戶的余額，–keys為要查詢的賬戶的地址
也可以根據地址查詢該賬戶余額

$ bin/xchain-cli account balance --keys data/keys

$ bin/xchain-cli account balance TeyyPLpp9L7QAcxHangtcHTu7HUZ6iydY

注明：
兩條命令查詢的是同一個地址的余額，即目錄output/data/keys的，和之前創建的bob無關，
打開keys檔案夾，里面有一個address檔案，點開即是地址的十六進制代碼，

而回顧之前創建合約賬號的文本中，記錄了合約地址，同為Teyy …iydY：

至于為什么查詢到的余額在不停的變化，可認為該合約是個公共合約，很多人在使用此合約進行各種轉賬操作，
為了驗證說法正確性，可以去查詢之前創建好的個人賬戶bob檔案夾，檔案夾里面同樣有一個address檔案，點開即是16進制地址，查詢此地址的余額，發現是0，驗證說法完成，

4. 轉賬

轉賬操作需要提供源賬號的私鑰目錄，并不需要提供目標賬號的任何密鑰，只需要提供地址即可，
–keys 從此地址 轉給 --to地址 --amount 金額
命令執行后，回傳一個交易id（txid），

$ bin/xchain-cli transfer --to czojZcZ6cHSiDVJ4jFoZMB1PjKnfUiuFQ --amount 10 --keys data/keys/ -H 127.0.0.1:37101

可以先查詢此命令中地址czoj…iuFQ地址余額，為0，完成轉賬交易后，再次查詢地址余額，說明轉賬交易完成，

5. 查詢交易資訊

根據上述轉賬操作得到的交易id c0ae…69e2，輸入命令得到交易資訊，

$ bin/xchain-cli tx query 交易id -H 127.0.0.1:37101

6. 查詢block資訊

通過上述查詢txid可得到blockid的值，繼而可以查詢區塊的相關資訊，包括區塊內打包的交易、所在鏈的高度、前驅/后繼區塊的id等內容，

$ bin/xchain-cli block txid中得到的blockid -H 127.0.0.1:37101

網路部署（選擇性閱讀）

1. 創建網路部署環境

部署說明：
第一，如果沒有下載tree，回傳到根目錄下載安裝tree

$ sudo apt install tree

第二，在執行如下命令時，需要先回傳到xuperchain目錄下，因為需要使用make命令編譯出testnet，而編譯檔案makefile在xuperchain目錄，

$ make testnet

編譯完成后，xuperchain目錄得到一個名為testnet的檔案夾，輸入命令：

$ tree testnet

此時網路配置完成，節點加入網路需要通過網路中一個或者多個種子節點，區塊鏈網路中任何一個節點都可以作為種子節點，通過配置種子節點的網路連接地址netURL可以加入網路，

2. 配置種子節點netURL、運行節點

以node1為例，進入目錄testnet/node1，輸入命令查看node1節點連接地址netURL，

$ cd testnet/node1
$ ./bin/xchain-cli netURL preview

可以看到ip地址為127.0.0.1，實際使用時，需要將ip配置節點的真實ip，port配置成如下模板：

 /ip4/{{ip地址}}/tcp/{{port配置}}/p2p/Qmf2HeHe4sspGkfRCTq6257Vm3UHzvh2TeQJHHvHzzuFw6

如果想給節點分配一個新的網路連接地址，可以使用如下命令:

$ cd node1
$ ./bin/xchain-cli netURL gen

使用cat命令可以查看p2p網路配置

$ cat conf/network.yaml

注意: 如果是部署在同一個節點上，p2p模塊埠應該配置不同，同時不要和其他已經被占用的埠沖突

啟動命令、查看運行狀態命令：

$ bash ./control.sh start
$ ./bin/xchain-cli status -H :37101

注：如果是啟動node2，則埠寫37102；node3則寫37103，

常見問題：
1、埠沖突：注意如果在一臺機器上部署多個節點，各個節點的RPC監聽埠以及p2p監聽埠都需要設定地不相同，避免沖突；

2、不同節點公私鑰和netURL沖突：注意網路中不同節點./data/keys下的檔案和./data/netkeys下的內容都應該不一樣，這兩個檔案夾是節點在網路中的唯一標識，每個節點需要獨自生成，否則網路啟動例外；

3、啟動時連接種子節點失敗：注意要先將種子節點啟動，再起動其他節點，否則會因為加入網路失敗而啟動失敗；

撰寫一個Solidity合約

1. 提前準備

選擇最為主流的Solidity語言來編譯合約，Solidity是官方推出的編譯語言，
用以下命令查看是否安裝好solc 用于編譯sol檔案，

$ solc --version

如果顯示沒有安裝，則使用如下命令安裝：

$ sudo apt-get install solc

合約默認處于關閉狀態，在部署、呼叫合約之前，請先查看 conf/contract.yaml 中如下圖劃紅線部分，確保合約功能開啟，

以counter合約為例來看如何撰寫一個Solidity合約，counter合約是一個簡單的計數器合約，每呼叫一次合約即計數+1，
為簡化操作，在/output/data目錄下新建檔案夾“shishi”（名字隨便取的），可以去圖形化界面操作，比終端上輸入命令簡單，

在shishi檔案夾里新建一個文本檔案，重命名為Counter.sol
雙擊打開此文本檔案，復制粘貼如下代碼：

pragma solidity >=0.0.0;

contract Counter {
    address owner;
    mapping (string => uint256) values;

    constructor() public{
        owner = msg.sender;
    }

    function increase(string memory key) public payable{
        values[key] = values[key] + 1;
    }

    function get(string memory key) view public returns (uint) {
        return values[key];
    }

    function getOwner() view public returns (address) {
        return owner;
    }

}

保存后退出，

2. 編譯合約

在當前目錄新打開一個終端，通過solc編譯合約原始碼，輸入命令：

$ solc --bin --abi Counter.sol -o .

目錄中出現兩個檔案，合約二進制檔案和abi檔案分別存放在當前目錄下，Counter.bin和Counter.abi

–bin ：表示需要生成合約二進制檔案

–abi ：表示需要生成合約abi檔案，用于合約方法以及引數編解碼

-o：表示編譯結果輸出路徑

編譯合約完成，

3. 部署合約

回傳到output目錄，部署合約前需要先向合約賬戶中轉賬，合約沒有余額的話無法執行合約，也無法呼叫合約中函式，錯誤如圖所示：（顯示utxo error，即交易池中沒有余額，不能執行命令，）

查詢合約余額，為0

用如下命令給合約賬戶充值：

$ xchain-cli transfer --to XC1111111111111111@xuper --amount 100000000

回傳一個tx id，說明轉賬操作成功，合約賬戶有余額后即可部署合約了，用如下命令部署合約：

$ xchain-cli evm deploy --account XC1111111111111111@xuper --cname counterevm  --fee 5200000 Counter.bin --abi Counter.abi

合約部署完成，

4. 呼叫合約

接下來呼叫合約，合約中increase方法每呼叫一次，計數器加1， 呼叫合約get方法即可回傳合約中的計數數值，命令如下：

# 合約increase方法呼叫
$ xchain-cli evm invoke --method increase -a '{"key":"stones"}' counterevm --fee 22787517 --abi Counter.abi
# 合約get方法呼叫
$ xchain-cli evm query --method get -a '{"key":"stones"}' counterevm --abi Counter.abi

通過上面運行截圖可得到，執行第一句increase方法呼叫陳述句后，回傳汽油費：支付費用和tx id，說明呼叫成功；執行第二局get方法呼叫陳述句后，看到回傳的數字“1”，說明計數器合約成功執行，如果重復increase方法呼叫陳述句，則計數不斷往上加，結果如下：