3. 创建合约

3.1. 编写合约

源码可以参考 xuperchain/xuperunion/contractsdk/go/example/math/math.go

主要实现struct中initialize,invoke和query三个方法来实现自己的逻辑

1func (m *math) Initialize(nci code.Context) code.Response { ... }
2func (m *math) Invoke(nci code.Context) code.Response { ... }
3func (m *math) Query(nci code.Context) code.Response { ... }

每个函数的入口参数均为 code.Context ,具体结构可参考 xuperchain/xuperunion/contractsdk/go/code/context.go 接口中定义了如何获取传入方法的参数,如何使用读写功能,以及如何在链上进行交易/区块的查询、转账或调用其他合约

 1type Context interface {
 2    Args() map[string][]byte
 3    Caller() string
 4    Initiator() string
 5    AuthRequire() []string
 6
 7    PutObject(key []byte, value []byte) error
 8    GetObject(key []byte) ([]byte, error)
 9    DeleteObject(key []byte) error
10    NewIterator(start, limit []byte) Iterator
11
12    QueryTx(txid []byte) (*TxStatus, error)
13    QueryBlock(blockid []byte) (*Block, error)
14    Transfer(to string, amount *big.Int) error
15    Call(module, contract, method string, args map[string][]byte) (*Response, error)
16}

对于C++版本的合约,可以参考代码 contractsdk/cpp/example/counter.cc 原理和Golang合约是一致的

注解

除了 Initialize 外的其他函数,是可以自行定义函数名的,可参考contractsdk/go/example/counter/counter.go中的具体实例,在之后调用合约时写明函数名即可

3.2. 部署wasm合约

  1. 编译合约 - Golang

    注意合约编译环境与源码编译环境一致,编译参数如下

    1GOOS=js GOARCH=wasm go build XXX.go
    
  2. 编译合约 - C++

    对于C++合约,已提供编译脚本,位于 contractsdk/cpp/build.sh,需要注意的是,脚本依赖从hub.baidubce.com拉取的docker镜像,请在编译前确认docker相关环境是可用的

  3. 部署wasm合约

    将编译好的合约二进制文件(以counter为例)放到目录node/data/blockchain/${chain name}/native/下,这里我们默认的链名 ${chain name}=xuper

    部署合约的操作需要由合约账号完成,部署操作同样需要支付手续费,操作前需要确保合约账号下有足够的余额

    在合约账号权限AK是节点账号的情况下(即ACL中有当前节点的签名即可生效),我们按照如下命令即可完成部署

    1./xchain-cli wasm deploy --account XC1111111111111111@xuper --cname counter -H localhost:37101 data/blockchain/xuper/native/counter
    

    运行时会提示手续费的数目,使用 –fee 参数传入即可

    对于合约账号权限AK有多个的情况,部署操作需要多方的签名,需要提前在 data/acl/addrs 维护好需要的合作的地址列表(每个AK地址写一行),运行时增加 -m 参数

    1./xchain-cli wasm deploy --account XC1111111111111111@xuper --cname counter -H localhost:37101 -m data/blockchain/xuper/native/counter
    

    生成的 tx.out 就像类似修改ACL的操作一样,收集各个AK的签名,然后发送即可

3.3. 部署native合约

  1. 编译合约

    编译native合约时,只要保持环境和编译xuperunion源码时一致即可,我们还是以example中的counter为例

    1cd contractsdk/go/example/counter
    2go build
    3# 产出二进制counter
    
  2. 激活合约

    native合约部署需要进行一次 提案-投票 操作,