2. 环境准备

2.1. Rust智能合约开发环境

接入雄安应用系统前,应先具有Rust智能合约安装环境,具体步骤如下所示:

  • 按照官方安装Go环境,本教程推荐使用1.17+版本。安装好后,在命令行输入go version验证版本

    Go语言版本验证

    如上图所示, golang1.18.3版本运行环境已经安装成功

  • 安装rustup。rustup是rust的安装和管理工具,在本项目中rustup用来维护依赖和处理cargo、rustc的版本更新,安装脚本:

    curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
    rustup default stable
    
  • 刷新环境变量:

    source $HOME/.cargo/env
    
  • 安装后,通过cargo version命令获取cargo版本,如下图:

    cargo版本验证

  • 运行版本低于1.55,用下面命令更新:

    rust update stable
    
  • rust安装成功后,通过下面命令,确认安装了wasm32 target:

    rustup target list --installed
    

    确认安装wasm32 target

  • 如果显示并没有安装wasm 32,执行以下命令进行安装:

    rustup target add wasm32-unknown-unknown
    
  • 再次执行rustup target list –installed查看是否安装成功

  • 选择开发智能合约的ide,使用vscode安装rust插件或idea安装intellij-rust和intellij-toml以便更好的开发智能合约:intellij-rust是Rust语言插件,intellij-toml是为Toml语言的插件。本教程以Intellij IDEA为例:

    1. 安装Intellij IDEA,可以根据自己的需要选择商业版或免费版。

    2. 安装开发智能合约需要的两个插件Rust和Toml。安装方式:Perferences.. ->Plugins 在Marketplact中直接搜索Rust和Toml并安装即可

  • 合约开发参考Demo完成

2.2. 接入环境

  • xcd、xccli拷贝到linux服务器工作目录

  • so拷贝到linux服务器/lib目录(so、xcd、xccli可从xccli处下载)

  • 运行/sbin/ldconfig -v 加载依赖库

  • 将xcd、xccli文件所在目录加入path环境变量

  • 通过xccli生成一个组织管理员密钥和地址

  • 命令行输入xccli keys add <管理员账号名>,如输入xccli keys add admin,则生成名为admin的管理员,输入命令后命令行信息如下文所示:

    {
    "name": "admin",
    "type": "local",
    "address": "cosmos1u2aqzefhj37e7k9akercv80gfxauwjayk77gez",
    "pubkey":
    "cosmospub1addwnpepqfn7s74hhmyqkqj09xvvttuezp6qe8d27yxa3fksn3emfenczr6acmq2v59",
    "mnemonic": "all cage select bench blanket chapter capable artefact other
    alone toss ghost need fall dinner rapid rather control budget alpha solid
    dial name special"
    }
    

    其中name为管理员账户的名字,type为管理原账户的类型,mnemonic为管理员的私钥的助记符,pubkey为管理员账户的公钥,address为管理员账户的地址。

    在命令行中输入xccli status,获取 网络名称channelrpc_address等信息。

    信息

  • 把以上信息发送至网络管理员