专栏首页本体研究院本体技术视点 | Wasm重磅登陆Ontology主网!Wasm合约开发必读入门教程(4)

本体技术视点 | Wasm重磅登陆Ontology主网!Wasm合约开发必读入门教程(4)

日前的政策利好将区块链推向了前所未有风口,“把区块链作为核心技术自主创新重要突破口,加快推动区块链技术和产业创新发展”成为了区块链行业最新的工作指示。我们感到十分兴奋,因为我们一直都在正确的道路上持续前行,为这一场区块链技术攻坚战厉兵秣马。

而就在本体 Ontology 2.0 发布前夕,Ontology v1.8.0于10月29日重磅发布。经过数月在测试网上的稳定运行,Wasm 功能也正式登陆了主网。在往期的技术视点中,我们已推出多部 Ontology Wasm 相关教程,社区伙伴们纷纷表示受益匪浅。本期我们将介绍如何基于 Wasm合约使用 Runtime API,相信你会有所收获。

图 | 网络

Runtime API 简述

Ontology Wasm 合约开发工具库 ontology-wasm-cdt-rust 里面 Runtime 模块封装了合约与 Ontology 链交互的 API 方法。通过这些 API 方法,合约可以获得链上的数据,或者将合约中的数据保存到链上,以下是这些 API 方法的简单描述。

接下来,我们来具体讲述下这些 API 的使用方法。在此之前,开发者可以从 GitHub 上 clone 下来我们的合约模板,然后在lib.rs文件中添加合约逻辑代码。

Runtime API 使用方法

首先,开发者仅需要通过下面的方式将 Runtime 模块引入到当前合约中:

use ontio_std::runtime;

然后就可以通过 Runtime 引用以上所有的 API 接口。

1. timestamp()

timestamp()方法获得当前的时间戳,即返回调用该函数的 Unix 时间,单位为秒。调用示例:

let t = runtime::timestamp();

一个简单的示例代码如下:

#![no_std]
extern crate ontio_std as ostd;
use ostd::abi::{Sink, Source};
use ostd::prelude::*;
use ostd::runtime;


fn hello() -> u64 {
	runtime::timestamp()//取得当前时间戳
}

#[no_mangle]
fn invoke() {
	let input = runtime::input();//获得输入方法名和方法参数
	let mut source = Source::new(&input);//构造反序列化实例
	let action = source.read().unwrap_or_default();//读取方法名
	let mut sink = Sink::new(16);//构造序列化实例
	match action {
		"hello" => {
			sink.write(hello());//将hello()返回的结果序列化
		}
		_ => panic!("unsupported action!")
	}
	runtime::ret(sink.bytes());//将序列化后的结果返回给调用方
}

在下面的 API 方法讲述中,我们将省略具体例子,只介绍 API 方法的作用。小伙伴们可以采用类似于上述例子的代码进行试验。

2. block_height

block_height函数获得当前区块链网络的区块高度,调用示例:

let t = runtime::block_height();

3. address

address 获得当前合约的地址,调用示例:

let t = runtime::address();

4. caller

caller 获得调用方的合约地址,主要用于跨合约调用的场景,比如合约 A 调用合约 B 的应用场景, 在合约 B 中就可以调用该方法获得调用方合约 A 的地址:

let t = runtime::caller();

5. entry_address

entry_address 获得入口合约地址,比如有这样的应用场景,合约 A 通过合约 B 调用合约 C的方法,此时,在合约 C 中就可以通过该方法拿到合约 A 的地址,调用示例:

let t = runtime::entry_address();

6. current_blockhash

current_blockhash 获得当前区块的 hash,示例如下:

let t = runtime::current_blockhash();

7. current_txhash

current_txhash获得当前交易的 hash,示例如下:

let t = runtime::current_txhash();

8. sha256

sha256计算输入参数的 hash256值:

let h = runtime::sha256("test");

9. check_witness

check_witness(from)校验是否含有该地址的签名:

  • 验证当前的函数调用者是不是含有 from 的签名 。若是(即签名验证通过),则函数返回 true;
  • 检查当前函数调用者是不是一个合约。若是合约,且是从该合约发起去执行函数,返回 true。即,验证 from 是不是caller的返回值。其中,caller()函数可以得到调用当前智能合约的合约哈希值。
assert!(runtime::check_witness(from));

10. notify

notify函数将合约中事件推送到全网,并将其内容保存到链上,调用方法如下:

runtime::notify("notify".as_bytes())

在合约中推送事件时,可以自定义一个事件函数,加上#[event]注解即可。我们的工具库中提供了该属性宏,需要通过use ostd::macros::event;引入。示例如下:

use ostd::macros::event;
mod notify {
	use super::*;
	#[event]
	pub fn transfer(from: &Address, to: &Address, amount: U128) {}
}
fn transfer(from: &Address, to: &Address, amount: U128) -> bool {
	...
	notify::transfer(from, to, amount);
}

11. panic

panic方法可以在合约执行发生致命错误的时候立即终止交易的执行,然后回滚当前的交易。该方法在跨合约调用的场景很重要,比如在如下的应用场景中,合约 A 中的方法 a 调用合约 B 中的方法 b,其中合约 A 的 a 方法在调用合约 B 的 b 方法之前会保存一些数据到链上,但是在调用合约 B 的 b 方法时,发生了致命的错误,需要回滚合约 A 中 a 方法执行过程中保存的数据,此时就需要在合约 B 的 b 方法中应用panic方法实现该功能。

runtime::panic("test");

结语

本文主要讲解了 Runtime 模块的 API,该模块提供了与链交互的功能,其中 notify 用于合约中推送事件,开发者可以使用自定义事件的方式推送事件,而不是直接使用 notify 方法。use ostd::macros::event属性宏提供了更加友好的事件推送机制。在跨合约调用的过程中,panic方法在异常处理中具有非常重要的。下一期我们将介绍如何实现 Wasm 合约与 NeoVM 合约及 Native 合约之间的相互调用,欢迎大家关注学习。

Ontology 率先支持 Wasm 合约将会大大提高混合虚拟机的性能,也将吸引众多不同语言的技术开发者加入本体社区,共同推进区块链技术的研发,丰富本体强大的技术生态。同时,基于本体强大的技术研发团队,也可将现有的优秀技术整合到本体生态上来,为合约开发者增加更多选项。欢迎各位技术伙伴与我们共同前行!

本文分享自微信公众号 - 本体研究院(ontologyresearch),作者:Lucas

原文出处及转载信息见文内详细说明,如有侵权,请联系 yunjia_community@tencent.com 删除。

原始发表时间:2019-10-29

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

我来说两句

0 条评论
登录 后参与评论

相关文章

  • 本体技术视点 | Python跨合约静态调用是如何实现的?

    上一期我们介绍了合约升级 API,讲述了如何销毁和迁移智能合约。本期我们讨论如何跨合约静态调用。API 只有一个,用法如下:

    本体Ontology
  • 本体技术视点 | Python智能合约终极篇:合约执行引擎API

    在前两期的本体技术视点中,我们介绍了跨合约静态调用与动态调用,讲述了如何使用 RegisterAppCall API 与 DynamicAppCall API ...

    本体Ontology
  • 本体技术视点 | 智能合约安全与漏洞分析(一)

    智能合约安全问题一直是区块链技术体系中探讨得比较多的话题之一。无论是以以太坊 EVM 虚拟机为代表的智能合约体系,还是以 EOS WASM 虚拟机为代表的智能合...

    本体Ontology
  • 以太坊DApp系列(二)---从入门到出家

    以太坊自2013年V神提出后,被无数人赋予美好的愿景,甚至被称为区块链2.0,其代币发行量更是达到了全球第二,仅次于比特币,而其带来的智能合约概念颠覆了人们对区...

    forrestlin
  • 使用rdesktop来在Windows和Linux之间共享数据

    rdesktop是一个开源的远程桌面客户端,用来从Linux机器连接到Windows机器。它遵循RDP协议(Remote Desktop Protocol),并...

    王云峰
  • Bytom Dapp 开发笔记(二):开发流程

    这章的内容详细分析一下涉及智能合约Dapp的整个开发流程,注意是涉及只能合约,如果你只要一些基本转BTM功能没有太大意义,本内容补充一下官方提供的 比原链DAP...

    比原链Bytom
  • 偷天换日合约易主,地址变脸移花接木——底层函数误用漏洞 | 漏洞分析连载之四

    引子:阵有纵横,天衡为梁,地轴为柱。梁柱以精兵为之,故观其阵,则知精兵之所有。共战他敌时,频更其阵,暗中抽换其精兵,或竟代其为梁柱,势成阵塌,遂兼其兵。并此敌以...

    区块链大本营
  • 以太坊智能合约安全漏洞(1):重入攻击

    虽然仍然处于起步阶段,但 Solidity 已被广泛采用,成为事实上的智能合约标准,新的区块链项目不少都兼容了 Solidity 语言, Solidity 已...

    用户5128711
  • 「React TS3 专题」使用 TS 的方式在类组件里定义事件

    在「React TS3 专题」亲自动手创建一个类组件,我们一起学习了如何用 TS 的方式在React 里定义类组件(class component)以及了解了什...

    前端达人
  • 这是一篇很务正业的可视化推送~(上篇)

    自带学习R语言以来,从来没用把这些技能用在自己的专业方向上,说好的学以致用呢~ 最近看到的一篇微信公众号推文,内容是关于山东省各县(细化到137个县级行政区)2...

    数据小磨坊

扫码关注云+社区

领取腾讯云代金券

玩转腾讯云 有奖征文活动