2. 合约管理

2. 合约管理

XuperChain 支持丰富的智能合约开发语言，比如go，Solitidy，C++，Java等。

2.1. 编写合约

本教程以 counter 合约为例，进行合约基本操作，不同语言合约代码见

c++ counter 合约

go counter 合约

java counter 合约

solidity counter 合约

2.2. 部署wasm合约

编译合约
C++ 合约使用 xdev 编译，使用前需要安装 xdev 并确保 xdev 所在路径在 PATH 环境变量中。

执行以下命令，编译 counter 合约
```
$ git clone https://github.com/xuperchain/contract-sdk-cpp.git
$ cd contract-sdk-cpp
$ xdev build -o counter.wasm example/counter.cc
```
注解
1. 编译 C++ 合约依赖从 Dockerhub 拉取镜像，请在编译前确认docker相关环境是可用的
2. 你可以把生成的 counter.wasm 拷贝到 xuperchain 目录下的 output 目录中，以简化后续命令的执行

部署合约

部署合约的操作需要由合约账号完成，部署操作同样需要支付手续费，操作前需要确保合约账号下有足够的余额
$ xchain-cli wasm deploy --account XC1111111111111111@xuper  -a '{"creator":"XC1111111111111111@xuper"}' --cname counter counter.wasm
contract response: initialize succeed
The gas you cousume is: 155387
You need add fee
xchain-cli wasm deploy --account XC1111111111111111@xuper  -a '{"creator":"XC1111111111111111@xuper"}' --cname counter counter.wasm --fee 155387
contract response: initialize succeed
The gas you cousume is: 155387
The fee you pay is: 155387
Tx id: 2f96749f23be514d170e8bfadc9f7e22a9d1f41185b8af4874dfd00e75e273a6
运行时会提示手续费的数目，需要按照命令行运行结果给出的数值，添加一个不小于它的费用（使用 –fee 参数）。

合约调用

$ xchain-cli wasm invoke --method increase -a '{"key":"test"}' counter --fee 100
contract response: 1
The gas you cousume is: 94
The fee you pay is: 100
Tx id: 0ec552773d9716526c919bdf1ba1c16e09b26bb627c3d5f26ab1bc9146edef5a
$ xchain-cli wasm query --method get -a '{"key":"test"}' counter
contract response: 1

2.3. 部署native合约

在部署、调用native合约之前，请先查看 `conf/contract.yaml`_ 中native一节，确保native合约功能开启。

# 管理native合约的配置
native:
    enable: true

编译合约
GO 合约使用标准的 GO 环境编译，进入 counter 合约目录
```
$ git clone https://github.com/xuperchain/contract-sdk-go
$ cd contract-sdk-go/example/counter
$ go build -o counter
```
注解

可以把生成的 counter 文件拷贝到 xuperchain 下的 output 目录，以简化后续命令的执行

JAVA 合约使用 maven 编译
```
$ git clone https://github.com/xuperchain/contract-sdk-java.git
$ cd contract-sdk-java/example/counter
$ mvn package
```
注解

可以把生成的 target/counter-0.1.0-jar-with-dependencies.jar 拷贝到 xuperchain 下的 output 目录，以简化后续命令的执行

部署合约

部署native合约。针对不同语言实现的合约，主要通过 --runtime 字段进行区分

# 部署golang native合约
$ xchain-cli native deploy --account XC1111111111111111@xuper --fee 15587517 --runtime go -a '{"creator":"XC1111111111111111@xuper"}'   --cname golangcounter counter
 contract response: ok
 The gas you cousume is: 14311874
 The fee you pay is: 15587517
 Tx id: af0d46f6df2edba4d9d9d07e1db457e5267274b1c9fe0611bb994c0aa7931933
# 部署java native合约
$ xchain-cli native deploy --account XC1111111111111111@xuper --fee 15587517 --runtime java   --cname javacounter counter-0.1.0-jar-with-dependencies.jar
 The gas you cousume is: 14311876
 The fee you pay is: 15587517
 Tx id: 875d2c9129973a1c64811d7a5a55ca80743102abc30d19f012656fa52ee0f4f7

合约调用

针对不同语言实现的 native合约，调用方式相同。通过合约名直接发起合约调用和查询

# 调用golang native合约，Increase方法，golangcounter为合约名
$ xchain-cli native invoke --method Increase -a '{"key":"test"}' golangcounter --fee 10
contract response: 1
# 调用golang native合约，Get方法，golangcounter为合约名
$ xchain-cli native query --method Get -a '{"key":"test"}' golangcounter
contract response: 1
# 调用java native合约，increase方法，javacounter为合约名
$ xchain-cli native invoke --method increase -a '{"key":"test"}' javacounter --fee 10
contract response: 1
# 调用java native合约，get方法，javacounter为合约名
$ xchain-cli native query --method get -a '{"key":"test"}' javacounter
  contract response: 1

2.4. 部署solidity合约

在部署、调用solidity合约之前，请先查看`conf/contract.yaml` 中evm一节，确保evm合约功能开启。

# evm合约配置
evm:
    driver: “evm”
    enable: true

编译合约 - Solidity

使用 solc 编译器编译 solidity 合约。

# 也可使用solc-select编译，solc-select是一个很好的工具
# 安装 python
sudo apt install python3-pip
sudo pip3 install solc-select
solc-select install           // 查询可以安装的版本
solc-select install 0.5.9     // 安装需要的版本
solc-select versions          // 查看当前已有的版本及正在使用的版本
solc-select use 0.5.9        // 选择自己需要的版本
solc --version                // 查看当前正在使用的版本

我们以如下Counter 合约为例

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;
    }
}

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

注解

可以把生成的 Counter.abi 和 Counter.bin 拷贝到 xuperchain 下的 output 目录，以简化后续命令的执行

部署合约

$ xchain-cli evm deploy --account XC1111111111111111@xuper --cname counterevm  --fee 5200000 Counter.bin --abi Counter.abi
 contract response: ok
 The gas you cousume is: 1789
 The fee you pay is: 22787517
 Tx id: 78469246d86a92ad47e5c15991a55978075902809346e48533e09a8eb0e3a7e4
--abi Counter.abi ：表示部署需要使用的abi文件，用于合约方法参数编解码

-a ：如果合约需要构造函数，通过-a进行指定

合约调用

调用solidity合约。通过合约名直接发起合约调用和查询。

# 调用solidity合约，increase方法，counterevm为合约名
$ xchain-cli evm invoke --method increase -a '{"key":"test"}' counterevm --fee 22787517
# 调用solidity合约，get方法，counterevm为合约名
$ xchain-cli evm query --method get -a '{"key":"test"}' counterevm
# 调用结果，其中0表示返回值的次序，1为返回值
# key,value: 0 1

XuperChain 账户与EVM账户地址转换

XuperChain 有普通地址、合约账户以及合约名，这三类账户在EVM运行时需要转换为以太坊的地址类型（16进制编码字符串，形如0x1234567890abcdef1234567890abcdef12345678格式）。 XuperChain 提供了上述三个地址与EVM地址类型转换工具。

# xchain合约账户地址转evm地址，contract-account表示 XuperChain 合约账户
xchain-cli evm addr-trans -t x2e -f XC1111111111111113@xuper
result, 3131313231313131313131313131313131313133    contract-account
# evm地址转xchain合约账户，contract-account表示 XuperChain 合约账户
xchain-cli evm addr-trans -t e2x -f 3131313231313131313131313131313131313133
result, XC1111111111111113@xuper     contract-account
# evm地址转xchain普通账户地址，xchain表示 XuperChain 普通账户
xchain-cli evm addr-trans -t e2x -f 93F86A462A3174C7AD1281BCF400A9F18D244E06
result, dpzuVdosQrF2kmzumhVeFQZa1aYcdgFpN   xchain
# xchain普通账户地址转evm地址，xchain表示 XuperChain 普通账户
xchain-cli evm addr-trans -t x2e -f dpzuVdosQrF2kmzumhVeFQZa1aYcdgFpN
result, 93F86A462A3174C7AD1281BCF400A9F18D244E06   xchain
# xchain合约名地址转evm地址，contract-name表示 XuperChain 合约名
xchain-cli evm addr-trans -t x2e -f storagedata11
result, 313131312D2D2D73746F72616765646174613131   contract-name
# evm地址转xchain合约名，contract-name表示 XuperChain 合约名
xchain-cli evm addr-trans -t e2x -f 313131312D2D2D73746F72616765646174613131
result, storagedata11   contract-name

x2e ：表示 XuperChain 地址转换为EVM地址
e2x ：表示EVM地址转换为 XuperChain 地址。

2.5. 合约升级

XuperChain 支持合约升级，在使用合约升级功能之前需要修改 conf/contract.yaml，开启合约升级功能

# 合约通用配置
contract:
    enableUpgrade: true

合约升级与合约部署的命令十分类似，区别在于

不需要指定 runtime
不需要指定初始化参数

以升级 wasm 的 counter 合约为例

xchain-cli wasm upgrade --account XC1111111111111111@xuper --cname counter counter.wasm

其他合约的升级命令类似