如何使用Rust进行Wasm合约开发

Ontology Wasm 自从上线     测试   网以来,得到了社区开发人员的极大关注。因为这项技术使得业务逻辑复杂的 dApp 合约上链成本降低,极大丰富 dApp 生态。

 如何使用Rust进行Wasm合约开发_设计制作_EDA/IC设计

Ontology Wasm 目前支持使用 Rust 和     C++   两种语言开发。其中 Rust 语言对 Wasm 的支持更好,生成的字节码更加精简,可以进一步降低合约调用的费用。那么如何使用 Rust 进行 Ontology 的合约开发?

一、使用 Rust 进行 Wasm 合约开发

1.1 新建合约

Cargo 是开发 Rust 程序时一款不可多得的项目构建和包管理工具,它可以帮助开发者更好地组织代码和第三方库依赖。新建一个 Ontology Wasm 空合约,仅只需要执行下面的命令:

cargo new --lib hello-world

其生成的项目结构是:

|-Cargo.toml

|-src

|-lib.     rs  

其中,Cargo.toml 文件用来配置项目基本信息和依赖库信息等,文件中的[lib]段必须设置成 cra     te   -type = [“cdylib”];而 lib.rs 文件用来编写合约逻辑代码。另外,需要在配置文件 Cargo.toml 的[dependencies]段中加入依赖项设置:

on     ti   o-std={https://github.com/on  TI o/ontology-wasm-cdt-rust}

利用这个依赖项,开发者可以调用与本体区块链交互的     接口   以及参数序列化等工具。

1.2 合约入口函数

每个程序都有一个入口函数,比如我们常见的 m     ai   n 函数,但是合约并没有 main 函数。在用 Rust 开发 Wasm 合约时,默认用 invoke 函数作为合约执行的入口函数。将 Rust 源代码编译成虚拟机可以执行的字节码时,会对 Rust 中的函数名进行混淆。为了防止编译器生成多余的字节码,减小合约大小,invoke 函数要加上#[no_mangle]注解。

Invoke 函数如何获得交易执行的参数?on  TI o_std 库提供了 run  TI me::input()函数用于接收交易执行的参数,开发者可以使用 ZeroCopySource 对接收到的字节数组进行反序列化。其中,读出来的第一个字节数组是调用的方法名,后面读到的是方法参数。

合约执行结果是如何返回?on  TI o_std 库提供的runtime::ret 函数可以将方法执行结果返回出去。

一个完整的 invoke 函数如下:

#[no_mangle]

pub fn invoke() {

let input = runtime::input();

let mut source = ZeroCopySource::new(&input);

let action: &[u8] = source.read().unwrap();

let mut sink = Sink::new(12);

match action {

b“hello” =》 sink.write(say_hello()),

_ =》 panic!(“unsupported action!”),

}

runtime::ret(sink.bytes())

}

1.3 合约数据序列化和反序列化

在合约开发过程中,开发者总会遇到序列化和反序列化的问题,即如何把一个 struct 类型的数据保存到     数据库   中以及从数据库中读到的字节数组如何进行反序列化以获得 struct 类型的数据。

Ontio_std 库提供了 Decoder 和 Encoder 接口对数据进行序列化和反序列化。Struct 结构体的字段也要实现 Decoder 和 Encoder 接口,这样该 struct 才可以实现序列化和反序列化。在对各种数据类型进行序列化的时候,需要用到 Sink 实例。Sink 实例有个集合类型的字段 buf,该字段存的是字节类型数据,所有序列化的数据都会存到 buf 中。

对于固定长度的数据(例如:byte、u16、u32和 u64等),直接将该数据转换字节数组然后存入 buf 中;对于长度不固定的数据,序列化时需要先序列化长度,然后序列化数据(例如不知大小的无符号整数,包括 u16、u32或 u64等)。

反序列化和序列化正好相反。对于所有的序列化方法,都有对应的反序列化方法。反序列化需要用到 Source 实例。该实例有两个字段 buf 和 pos。Buf 用来     存储   要反序列化的数据,pos 用来存储当前读取的位置。读取指定类型数据的时候,如果知道其长度,可以直接读;对于长度未知的数据,要先读出来长度,然后再读内容。

1.4 访问和更新链上的数据

Ontology-wasm-cdt-rust 已经封装了链上数据的操作方法,能够方便开发者实现链上数据的增删改查等操作。其中:

Ø database::get(key) 用来从链上查询数据, key 要求实现 AsRef 接口。

Ø database::put(key, value) 用来将数据存到链上,key 要求实现 AsRef 接口,value 要求实现 Encoder 接口。

Ø database::delete(key) 用来从链上删除数据,key 要求实现 AsRef 接口。

1.5 合约测试

合约方法执行时需要访问链上的数据并且需要相应的虚拟机进行执行合约字节码,所以一般需要将合约部署到链上才能进行相关测试。但这样的测试方法比较麻烦。为了使开发者更方便地测试合约,ontio_std 库提供了 mock 测试模块。该模块提供了链上数据的模拟,方便开发者对合约中的方法进行单元测试。

具体案例可参考:

https://github.com/ontio/ontology-wasm-cdt-rust/blob/master/examples/oep5token/src/test.rs

1.6 调试合约

开发者可以使用 console::debug(msg) 在合约调试过程中输出相关调试信息。其中, msg 信息会在节点 log 日志里打印出来。这里有个前置条件,即 Ontology 本地测试节点启动的时候日志级别需要设置为 debug 模式。

另外, 开发者也可以使用 runtime::not     if   y(msg) 在合约调试过程中输出相关调试信息。该方法会将打印出来的信息保存到链上,可以通过 getSmartCodeEvent 方法从链上查询。

二、 总结

Ontology 作为领先公链,率先支持 Wasm 合约,为 Wasm 技术的成熟贡献力量。同时,我们也欢迎更多的 Wasm 技术爱好者加入本体开发社区,共同打造技术生态。

43
60
0
28

相关资讯

  1. 1、胆小慎看!恐怖片《阴风阵阵》曝预告,邪气十足2182
  2. 2、王宝强因《天下无贼》大火,冯小刚为何却说后悔捧红王宝强?2491
  3. 3、“美国队长”蜡像抵沪性感女粉丝热情接机4144
  4. 4、《赵氏孤儿案》今央一开播慷慨悲歌展人间大爱1344
  5. 5、《致命名单》热播再现情报特工的真实生活2598
  6. 6、赵宝刚回应《北青》硬伤:没看完就没有发言权4262
  7. 7、阿娇自爆曾因艳照事件被《快乐大本营》拒绝登台2182
  8. 8、《心战》曝前导预告任达华张家辉斗法难辨真凶418
  9. 9、程武与黄建新柴智屏陆川吴文辉,共话新文创时代如何讲好中国故事4627
  10. 10、秋交会观感:“假收视”的病,“大数据”能治!3207
全部评论(0)
我也有话说
0
收藏
点赞
顶部