8. 只读跨链场景使用文档

跨链的背景知识可以参考超级链的技术文档 超级链跨链技术 ，这里介绍一下超级链跨链只读使用说明。

8.1. B网络搭建

搭建B网络，设置背书配置为true，部署被调用合约B,例如counter：

  1. 1. xchain.yaml增加配置： enableXEndorser: true
  2. 2. 配置节点背书公私钥，./data/endorser/keys 目录下，增加背书地址及公私钥；

8.2. A网络搭建

搭建A网络，部署跨链寻址合约，部署测试合约A用于查看B网络的counter合约；

8.2.1. 部署查询合约A

查询合约可参考：core/contractsdk/cpp/example/cross_query_demo/src/main.cc

  1. DEFINE_METHOD(Hello, cross_query) {
  2.         xchain::Context* ctx = self.context();
  3.         xchain::Response response;
  4.         // 合约SDK 增加cross query方法
  5.         ctx->cross_query("xuper://mainnet.xuper?module=wasm&bcname=xuper&contract_name=counter&method_name=get", {{"key", "zq"}}, &response);
  6.         *ctx->mutable_response() = response;
  7. }

8.2.2. 部署跨链寻址合约

超级链提供了默认的寻址合约（crossQueryNaming）的实现，路径为core/contractsdk/cpp/example/naming/src/naming.cc。在 core/contractsdk/cpp 目录下执行 sh build.sh 即可编译生成 naming.wasm ，即可使用 naming.wasm实现寻址合约的部署。

8.2.3. 创建合约账户

  1. ./xchain-cli account new --account 1111111111111111 --fee 1000
  2. ./xchain-cli transfer --to XC1111111111111111@xuper --amount 9999999999999999    ##给合约账号充钱

8.2.4. 部署wasm

注意：合约名必须为crossQueryNaming

  1. ./xchain-cli wasm deploy -n crossQueryNaming ./naming.wasm  --account XC1111111111111111@xuper --fee xxxxx

8.2.5. 注册链名

  1. ./xchain-cli wasm invoke crossQueryNaming --method RegisterChain -a '{"name":"mainnet.xuper","type":"xuper", "min_endorsor_num":"2"}' --fee 888
  • name：B网络.链名
  • type：链的种类，超级链
  • min_endorsor_num： 表示背书个数

8.2.6. 添加信任节点

注意此处address及pub_key在./data/endorser/keys下

  1. ./xchain-cli wasm invoke crossQueryNaming --method AddEndorsor -a '{"name":"mainnet.xuper", "address":"bobfffff", "host":"ip1:port1", "pub_key":"xxxxx"}' --fee 555
  3. ./xchain-cli wasm invoke crossQueryNaming --method AddEndorsor -a '{"name":"mainnet.xuper", "address":"alicefffff", "host":"ip2:port2", "pub_key":"yyyyy"}' --fee 555
  • address：背书地址
  • host：背书节点ip:port
  • pub_key: 背书公钥

8.2.7. 链名解析

  1. ./xchain-cli wasm query crossQueryNaming --method Resolve -a '{"name":"mainnet.xuper"}'

8.3. 跨链查询

8.3.1. B网络调用counter

在B网络调用counter合约，自增key值并查询自增后的结果：

  1. ./xchain-cli wasm invoke counter --method increase -a '{"key":"zq"}'--fee 100-H=ipB:portB
  2. ./xchain-cli wasm invoke counter --method get -a '{"key":"zq"}'--fee 100-H=ipB:portB

8.3.2. A网络调用crossQueryNaming

在A网络调用crossQueryNaming查询，即实现跨链查询B网络xuper链上counter合约key值结果：

  1. ./xchain-cli wasm invoke cross_query_demo --method cross_query -H=ipA:portA