本章节主要描述使用 Rust 进行 ChainMaker 合约编写的方法,主要面向于使用 Rust 进行 ChainMaker 的合约开发的开发者。
使用 Docker 镜像进行合约开发
1. 拉取镜像
docker pull chainmakerofficial/chainmaker-rust-contract:2.1.0
请指定您本机的工作目录 $WORK_DIR,例如 /data/workspace/contract,挂载到 docker 容器中以方便后续进行必要的一些文件拷贝。
docker run -it --name chainmaker-rust-contract -v $WORK_DIR:/home chainmakerofficial/chainmaker-rust-contract:2.1.0 bash# 或者先后台启动docker run -d --name chainmaker-rust-contract -v $WORK_DIR:/home chainmakerofficial/chainmaker-rust-contract:2.1.0 bash -c "while true; do echo hello world; sleep 5;done"# 再进入容器docker exec -it chainmaker-rust-contract bash
2. 编译合约
cd /home/tar xvf /data/contract_rust_template.tar.gzcd contract_rustmake build
生成的合约字节码文件位置如下:
/home/contract_rust/target/wasm32-unknown-unknown/release/chainmaker_contract.wasm
3. 合约开发框架描述
解压缩 contract_rust_template.tar.gz 后,文件描述如下:
chainmaker-contract-sdk-rust$ tree -I target.├── Cargo.lock # 依赖版本信息├── Cargo.toml # 项目配置及依赖,参考:https://rustwasm.github.io/wasm-pack/book/cargo-toml-configuration.html├── Makefile # build一个wasm文件├── README.md # 编译环境说明├── src│ ├── contract_fact.rs # 存证示例代码│ ├── easycodec.rs # 序列化工具类│ ├── lib.rs # 程序入口│ ├── sim_context.rs # 合约SDK主要接口及实现│ ├── sim_context_bulletproofs.rs # 合约SDK基于bulletproofs的范围证明接口实现│ ├── sim_context_paillier.rs # 合约SDK基于paillier的半同态运算接口实现│ ├── sim_context_rs.rs # 合约SDK sql接口实现│ └── vec_box.rs # 内存管理类
用户使用 Rust 编写智能合约后,可以把源代码更新到
src/contract_fact.rs
文件中并重新编译,得到新的智能合约的字节码,并前往 TBaaS 控制台 上传并部署。更多关于使用 Rust 进行开发长安链智能合约的详情,可参考长安链官网 使用 Rust 进行智能合约开发