宇宙链 宇宙链
Ctrl+D收藏宇宙链
首页 > 酷币下载 > 正文

Rust智能合约养成日记:编写Rust智能合约单元测试用例

作者:

时间:1900/1/1 0:00:00

往期回顾:Rust智能合约养成日记合约状态数据定义与方法实现

在上一期BlockSec针对Rust智能合约开发的文章中,我们介绍了如何为合约StatusMessage定义合约状态,并为该合约实现了不同的方法。本期我们将继续基于该合约展开叙述,详细介绍编写单元测试用例的方法,并在本地进行合约的测试。

1.准备单元测试环境

为编写单元测试,首先我们需要在src/lib.rs中加入如下代码,对单元测试进行环境设置:

1?#2?#3?mod?tests?{4????use?super::*;5????use?near_sdk::MockedBlockchain;6????use?near_sdk::{testing_env,?VMContext};78???...9}?

在上述代码的第1-3行中,我们为StatusMessage添加了tests子模块(使用mod关键字声明该新模块),并在该模块的代码片段之前标注了cfg属性宏#。此外,由于Rust的本地单元测试无需获得Wasm代码,因此可为该测试模块配置Rust编译条件#。

代码第4-6行从near_sdk中导入了合约测试环境的相关依赖项。具体观察代码的每一行中,use关键词的用法类似于python语言代码在导入其他所依赖的模块时所使用的import。use声明可创建一个或多个与其他路径同义的局部名称绑定,即通常可使用use关键词来声明引用模块项所需的路径,且这些声明通常可能出现在Rust模块或代码块的顶部。

Trust Wallet与Web3Auth合作部署MPC解决方案:4月26日消息,Trust Wallet 宣布与 Web3Auth 达成合作,拟部署由其支持的 MPC(多方计算)解决方案,以消除当前对助记词的要求,保护用户免受人为错误和单点故障的影响,从而加强账户安全。用户将能够使用他们现有的 Google、Apple、Telegram 和 Discord 帐户直接访问 Trust Wallet 服务。目前 Trust Wallet 的 MPC 功能尚处于 Beta 阶段,预计不久将向所有用户开放。[2023/4/26 14:28:42]

在第4行中,super关键字可用于从当前模块访问父模块StatusMessage,使得能够访问父模块中所定义的功能与方法,如之前我们为StatusMessage合约所定义的方法函数set_status与get_status。第5行使用use关键词引用了nearsdk所提供的模拟区块链MockedBlockchain支持模块,可用于智能合约的测试。第6行则从nearsdk引入了合约测试执行的环境,以及有关测试环境上下文信息格式的支持。

在导入支持NEAR智能合约单元测试所需的外部依赖模块后,我们还需要在测试模块中定义如下函数get_context(),用于配置并返回测试环境中所需使用的上下文信息:VMContext。

1????fn?get_default_context(view_call:?bool)?->?VMContext?{2??????VMContext?{3????????current_account_id:?"alice_near".to_string(),4????????signer_account_id:?"bob_near".to_string(),5????????signer_account_pk:?vec!,6????????predecessor_account_id:?"carol_near".to_string(),7????????input:?vec!,8????????block_index:?0,9????????block_timestamp:?0,10???????account_balance:?0,11???????account_locked_balance:?0,12???????storage_usage:?0,13???????attached_deposit:?0,14???????prepaid_gas:?10u64.pow(18),15???????random_seed:?vec!,16???????is_view:?view_call,17???????output_data_receivers:?vec!,18???????epoch_height:?0,19????}20??}?

灰度CEO:Grayscale Decentraland Trust为投资者接触元宇宙的一种方式:金色财经报道,Grayscale首席执行官 Michael Sonnenshein 在本周活动上表示,该公司已经将其Grayscale Decentraland Trust视为投资者接触元宇宙的一种被动方式。?对于那些不一定想积极管理Axie Infinity账户或为MANA建立和销售场景的投资者来说,Grayscale Decentraland Trust一直是一种有吸引力的方式。因此,这是投资者可以考虑将资金投入到一种资产中的一种方式,这种资产将随着像Decentraland本身这样的元宇宙的崛起而潜在地升值,这只是几个应用中的一个。我们一直在寻找我们也能带给投资者的其他资产。

MANA是灰度Decentraland信托背后的唯一资产,在过去24小时内上涨高达28%。在过去的14天里,MANA的价格已经上涨了超过253%。

Grayscale Decentraland Trust 于 2 月底推出,目前管理着 4920 万美元。它自成立以来上涨了 943.8%,仅在上个月就上涨了 235.9%。?[2021/11/13 6:49:41]

VMContext设定了多个模拟的,合约用户账户信息,以及包括区块高度,区块时间戳,合约存储用量等在内的区块链底层相关的上下文配置信息。

下面首先对VMContext中几处关键的属性配置加以说明:

current_account_id:执行当前合约的帐户。

瑞士银行Sygnum Bank与Taurus Group合作存储数字资产:瑞士金融科技公司Taurus Group已选择Sygnum Bank作为其数字资产托管服务的最新客户。Sygnum Bank是持有瑞士金融市场监管局(FINMA)银行执照的两家B2B公司之一,它将利用Taurus的Protect安全存储基础结构,并利用Taurus的区块链节点集群Taurus Explorer。(Coindesk)[2020/11/6 11:50:46]

signer_account_id:触发当前合约函数调用执行的交易签名者。所有的合约调用都是某个交易的结果,且该交易由某个帐户使用其访问密钥(AccessKey)签署,该账户即为signer_account_id。

signer_account_pk:交易签名者所使用的AccessKey公钥(PublicKey)。

predecessor_account_id:当合约的执行属于跨合约调用或回调时,该属性指代了该调用的发起者帐户。而当进行单一的合约内部函数调用时,该值将与signer_account_id一致。

prepaid_gas:在区块链中执行合约时存在一个特点,即用户需要支付一定的交易执行费用(gasfee)。这里的prepaid_gas设定了可供当前交易合约函数调用时所能扣除的Gas最大值,并附加到当前的合约调用中。

is_view:该参数is_view(类型为bool)可设置合约函数的调用能否对合约的状态数据进行修改。若该值为ture,则合约函数执行时,合约的状态数据是只读的。反之如果该值为false,则合约的执行环境将允许对合约数据进行修改。

动态 | Torus赠送ETH以鼓励用户测试Torus钱包:金色财经报道,私钥管理公司Torus今天在Reddit上宣布,对于渴望测试Torus的Reddit用户,Torus将向其Reddit帐户发送一些ETH。用户需要使用Reddit帐户登录以获得ETH。根据该公司此前的博客文章,最新版的Torus非托管钱包允许用户使用其Facebook、Reddit、Twitch或Discord帐户登录。用户也可以将ETH和ERC20代币转移到任何以太坊钱包地址、Gmail或GSuite电子邮件帐户、Reddit ID和Discord ID,无论接收者之前是否已登录Torus。[2019/12/25]

VMContext中其余属性的内容和用法将在后续的文章中详细展开描述。

当执行NEAR合约时,程序可配合一些NEARSDK所提供的相关API读取这些已设置的上下文信息。例如:

near_sdk::env::current_account_id()near_sdk::env::predecessor_account_id()near_sdk::env::signer_account_pk()near_sdk::env::input()near_sdk::env::predecessor_account_id()?

上述API均可返回上下文具体属性的值,这些API可以使用前文所述的use声明导入。

在定义完函数get_context()后,我们便可以在test模块中逐个地编写单元测试的内容了。

动态 | UTRUST与ETC开发团队达成合作:据cryptoninjas报道,加密支付解决方案UTRUST今日宣布,已与ETC开发团队达成合作,双方签署了一份谅解备忘录,将把ETC集成到UTRUST平台上。[2018/9/12]

2.单元测试一

如下是单元测试1的代码片段:

1???#2???fn?set_get_message(){3?????let?context?=?get_default_context(false);4?????testing_env!(context);5?????letmut?contract?=?StatusMessage::default();6?????contract.set_status("hello".to_string());7?????assert_eq!(8???????"hello".to_string(),9???????contract.get_status("bob_near".to_string()).unwrap()10????);11??}?

现在我们对测试用例的具体写法展开描述:

上述代码片段的第1行,我们为该单元测试函数标注了#宏,表明这是该单元测试的起点。紧接着第2行,便是该单元测试函数set_get_message()的声明。

代码的3-10行即该单元测试函数内部的主要测试逻辑,其中的代码实现首先将调用前面所定义的get_context初始化一个测试环境中所使用的上下文context。此外值得一提的是,由于本单元测试需要向合约的状态数据中写入数据,因此需要为get_context设置参数,将前文所述VMContext中的is_view属性设置为false,否则单元测试内部将引发panic导致测试无法通过。

在设置得到一个合理的合约执行上下文后,代码的第4行将利用该上下文VMContext,使用testing_env!宏初始化一个用于智能合约交互的MockedBlockchain实例。代码的第5行将调用父模块中定义的StatusMessage::default()生成初始化后的合约对象contract。

在后续的代码中,测试会首先调用父模块StatusMessage所定义的set_status方法,在合约状态数据中保存字符串"Hello"。随后再利用get_status从合约状态数据中读取该条数据,并与期望所获得内容进行对比。如果内容相互匹配,则通过该单元测试,若不匹配则会在该测试线程中触发"assertionfailed"类型的panic。

有关单元测试中利用断言assert进行校验的写法描述如下:

assert!(expression)宏可检验boolean值,当且仅当expression表达式所指代的内容为true时则通过检验;assert_eq!(left,right)宏常用于校验是否相等,当且仅当left和right表达式所指代的内容一致时通过校验;assert_ne!(left,right)宏常用于校验是否不同,当且仅当left和right表达式所指代的内容不同时通过校验;

3.单元测试二

如下是单元测试2的代码片段:

1???#2???fn?get_nonexistent_message(){3?????let?context?=?get_default_context(true);4?????testing_env!(context);5?????let?contract?=?StatusMessage::default();6?????assert_eq!(None,?contract.get_status("francis.near".to_string()));7??}?

在第6行的测试中,assert_eq右边的表达式利用合约方法get_status尝试从合约状态数据中查询StatusMessage合约用户francis.near所对应的message信息。但是由于代码的第5行仅仅初始化了整个合约的状态,因此此时的合约数据整体为空,因此其返回值将是None。最终由于该结果符合预期,因此断言正确,可以通过该单元测试。

4.执行测试用例

在编写完上述单元测试后,我们还需要在该StatusMessageRust项目中配置该合约的Cargo.toml文件,即在该文件的小节中添加对near-sdk的依赖。

near-sdk?=?"3.1.0"?

同时我们还需要在src/lib.rs文件的开头处导入这些来自于near_sdk所提供的模块或包:

use?near_sdk::borsh::{self,?BorshDeserialize,?BorshSerialize};use?near_sdk::collections::LookupMap;use?near_sdk::{env,?near_bindgen};?

在配置完合约项目的依赖后,我们便可以利用cargo执行所有的单元测试用例。具体的命令如下:

$cargo?test?--package?status-message?

测试将返回具体的测试结果:

testresult:ok.?2?passed;?0?failed;?0?ignored;?0?measured;?0?filteredout;finished?in0.00s?

此外,我们还可以单独指定单元测试的运行:

$cargo?test?--package?status-messageset_get_message?

同样地,我们可以获得单独测试的结果:

testresult:ok.?1?passed;?0?failed;?0?ignored;?0?measured;?1?filteredout;finished?in0.00s?

本期总结和预告

这是BlockSec针对Rust合约开发的第二期blog,本期我们介绍了如何编写单元测试用例,以及在本地进行测试的方法。下一期我们将进一步描述如何编译合约代码生成WASM目标代码,并最终部署到NEAR测试链(testnet)上运行。

标签:CONTCONONTNEARSunContractWrapped Concealont币最新价格Linear Finance

酷币下载热门资讯
比特币侧链Liquid Network将进行DynaFed升级,节点需进行升级以避免服务中断

巴比特讯,9月29日,Blockstream团队宣布比特币侧链LiquidNetwork将进行DynaFed升级.

1900/1/1 0:00:00
关于元宇宙的8个问题:诞生何处,去向何方?

这个想法从何而来? 来自科幻小说。在尼尔·斯蒂芬森1992年创作的科幻小说《雪崩》中,元宇宙是一个3D虚拟现实世界,人们可以在其中逃离反乌托邦的现实:一个庞大的网络游戏,人们的化身在其中四处游荡,相互交流,访问在线服务,去虚拟酒吧,或.

1900/1/1 0:00:00
国务院建议探索区块链等技术缩短承兑期限 | 产业区块链发展周报

摘要 产业动态: 全球大学区块链能力排名:新加坡国立大学第一,清华第八韩国记者协会与与PUBLISH合作,采用区块链技术改善新闻媒体生态系统Ripple与卡塔尔国家银行达成合作.

1900/1/1 0:00:00
区块链说数据没被篡改过,是不是在你 ?

前文《打破K/V存储的性能瓶颈》中,我们提到用一个哈希值来反映区块链系统中所有对象的当前状态集合,并称之为“世界状态”.

1900/1/1 0:00:00
Rust智能合约养成日记: 合约部署,函数调用,及explorer使用

往期回顾: Rust智能合约养成日记合约状态数据定义与方法实现Rust智能合约养成日记编写Rust智能合约单元测试在本期Rust智能合约开发Blog中.

1900/1/1 0:00:00
Facebook踏上“万人元宇宙”旅程,要在欧洲招聘万名员工

10月18日,社交媒体巨头Facebook官网发文表示,Facebook计划在未来五年内在欧盟招聘10,000名员工,以帮助建立所谓的元宇宙。这将是该公司朝着这一概念迈出的重要一步,这是最近几个月最高老板马克扎克伯格吹捧的.

1900/1/1 0:00:00