区块链研究实验室 | 基于substrate创建Ink智能合约

(http://coral.qq.com/3888157639)

区块链研究实验室 | 基于substrate创建Ink智能合约_第1张图片
image

Parity的Substrate区块链框架,在最终版本开发中取得不错的进展。Ink是Parity为基于Substrate的区块链编写智能合约的解决方案。

与Substrate一样,Ink建立在Rust之上,因此遵循Rust语言规则和语法。本文将介绍一个示例在智能合约中复制一个ERC721令牌,通常称为以太坊区块链上的ERC721令牌。

这是系列文章的第1部分,将介绍创建和部署此Ink智能合约的过程,具体来说,我们将介绍:

如何安装Substrate 和Ink及其依赖项;

编写支持3个主要功能的简单不可替代令牌合同:创造令牌,转移令牌,以及批准另一个帐户代表发送令牌;

如何在Substrate区块链上构建和部署智能合约,并使用Polkadot JS应用程序在链上测试功能;

注意:Polkadot JS应用程序不仅设计用于管理Polkadot本身,还管理任何Substrate链。接口是动态的,因为可用的管理选项取决于Substrate链支持的功能。

在本文中,我们将介绍Ink的安装过程及其所需的依赖关系,并介绍本系列附带的ERC721令牌示例合同,讨论Ink合同的结构以及它与基于Solidity的合同的区别,以及两者之间的相似性。

非同质化令牌

非同质化令牌NFT与ERC20型令牌不同,每个令牌都是独一无二的。在我们的合同中,每个令牌都有一个用于表示令牌的唯一ID。从这里开始,每个令牌都可以拥有自己的值,自己的元数据,或者在应用程序或价值系统中具有特定用途。

批准转移或管理令牌的非所有者帐户也是不同的,并且必须在每个令牌的基础上使用NFT完成。 加密猫是最着名的例子,其中实现了非同质化令牌- 每个令牌代表平台上的小猫。

NFT对标准令牌提出了不同的挑战,因此我们可以根据Ink语法和功能进行更多探讨。让我们下一步安装Substrate,Ink和所需的软件包来编写我们的智能合约。

系统安装

开始编写Ink合约需要一些依赖包。安装后,我们可以在终端窗口-中运行一个Substrate链,我们将使用此链作为部署智能合约的方法。

rust

Substrate和Ink依赖于rust。使用以下命令安装Rust。下面还包含两个命令,以确保您的Nightly Rust版本(最新可用的Rust版本)是最新的,以及Webassembly构建对Nightly Rust的支持:Ink合同编译为.wasm文件,因此作为Webassembly部署到Substrate链。

install rust and update environment

curl https://sh.rustup.rs -sSf | sh

source ~/.cargo/env

run rust updates and add WebAssembly target support

rustupupdatenightly

rustup targetaddwasm32-unknown-unknown--toolchain nightly

注意1:Cargo是Rust的包管理器,其包装称为Crates。

注意2:参考最后一个命令,target指的是rust项目目录中包含程序构建的目标文件夹。我们将在这里构建智能合约文件。

Substrate

使用以下命令安装Substrate:

Wasm utilities

Ink智能合约在上传到Substrate链之前会编译到WebAssembly中。 为此,我们需要安装一些实用程序:

We will install:

Binaryen

Compiler infrastructure and toolchain library for WebAssembly

Wabt

The WebAssembly Binary Toolkit

Parity Wasm Utils

Parity specific WebAssemply utilities */

MacOS

brew install binaryen

brew install wabt

cargo install pwasm-utils-cli --bin wasm-prune

Ubuntu

apt install binaryen

apt install wabt

cargo install pwasm-utils-cli --bin wasm-prune

Ink

我们现在可以通过箱子安装Ink, 运行以下命令:

本地运行substrate链

我们将在您的机器上运行的本地Substrate区块链上进行测试。 现在安装了Substrate,运行以下命令来初始化链:

--dev标志为您初始化开发区块链,仅在您的计算机本地化并初始化一些用户帐户。

此设置纯粹是为了测试目的;您可以将其视为与Truffle的Ganache程序,该程序运行本地基于以太坊的链,为测试目的进行了调整。

现在,您将注意到正在运行的节点正在验证新区块。 按CTRL + C或关闭终端窗口将停止节点执行,但链状态将持续存在,直到您下一次运行链。 在此注释中,如果您想要开始一个新链,请运行以下操作来清除您的链:

随着我们的Substrate链运行和Ink的准备,我们可以编写合同。在这样做之前,还需要提到编辑器支持。我个人发现Visual Studio Code是最好的编辑工作,不仅是Ink开发,还有Rust开发。 快速设置方法:

如果您还没有安装编辑器,请从此处安装VS Code安装RLS(Rust语言支持)扩展和WebAssembly扩展。 这可以直接在Extensions选项卡下的编辑器中完成,或按Shift + CMD + X直接跳转到它。

设置Ink项目

在安装了所有依赖项之后,现在让我们设置项目。

目前最简单的方法是安装Ink的“Hello World”合同,名为Flipper。 安装Flipper后,我们可以构建已经包含的内容,而不必担心配置和编译脚本 - 这些都在Flipper中提供。

注意:Substrate和Ink都处于快速发展阶段并且尚未完成全部功能,因此智能合约环境和智能合约代码本身很可能随着Parity越来越接近框架的最终版本而改变。

启动我们的Ink项目,请使用cargo获取Flipper:

fetch the Flipper Ink contract

cargo contractnewflipper

Flipper为我们提供了开始编写智能合约所需的项目样板,包括:

src / lib.rs中的一个简单的Flipper契约,它通过flip()方法简单地“翻转”true和false之间的布尔值,并使用get()方法在链上获取此值。我们将用NFT合同替换此文件。

Rust特定的Cargo.toml文件,概述项目依赖项和模块元数据,.gitignore文件和build.sh文件。 build.sh文件是我们运行以编译我们的智能合约,导致合同的已编译.wasm文件,合同的JSON抽象等等。我们将进一步探讨建成合约。

让我们把flipper改成一个更合适的名字:nftoken。修改以下内容:

/ flipper文件夹名称为/ nftoken

Cargo.toml:将[package] name和[lib] name更改为nftoken

build.sh:修改PROJNAME = nftoken

另外,确保我们有权运行nftoken / build.sh:

cdnftoken

chmod +x build.sh

最后,将/nftoken文件夹添加到vs代码工作区,我们就可以开始编写了。

关于Ink

Ink具有多个抽象级别,其中较高级别抽象较低级别。我们将使用最高级别,即语言级别或lang级别。这些级别也被分成了可以在这里探索的模块。

lang模块下面是模型和核心模块,分别侧重于中级抽象和核心实用程序。在核心模块下方,我们还可以期望专门用于创建和管理Ink智能合约的CLI。

虽然在撰写本文时几乎没有关于如何使用这些模块的内容,但我们确实有原始API文档可供浏览,包括核心模块和模型模块。如果您正在阅读本文,那么现在可以浏览这些文档,尽管我们下面的合同将利用其中一些API来展示如何通过不可互换的令牌合同在lang级别的上下文中使用它们。

考虑到这一点,接下来让我们来看看我们的lang派生合约的结构是什么样的,并将它与我们对基于Solidity的智能合约的期望进行比较。

智能合约架构

构造一个ink智能合约类似于solidity智能合约,其中我们期望的solidity的主要组成部分在ink中也是一致的:合同变量、事件、公共函数和私有函数,以及获取调用方地址的环境变量等等。

下面是NFoTek契约是如何构造的抽象:

//declaremodules

useparity::

...

//defineevents

enumEvent{

Mint { owner: AccountId,value: u64 },

}

...

//wrap entire contract inside the contract! macro

contract! {

// contractvariablesasastruct

structNFToken {

owner:storage::Value,

...

}

// compulsory deploy method thatisrun upon theinitialcontract

instantiation

impl DeployforNFToken {

fn deploy(&mutself, init_value: u64){}

}

//publiccontract methodsinan impl{}block

impl NFToken {

pub(external) fn total_minted(&self) -> u64 {}

...

}

//privatecontract methodsina separate impl{}block

imp NFToken {

fn is_token_owner(

&self,

of: &AccountId,

token_id: u64) -> bool {}

...

}

}

//testfunctions

modtests {

fn it_works() {}

...

}

让我们简要地访问这些部分,以及它们与我们对Solidity合同的期望有何不同。 Ink是基于Rust构建的,因此这里的所有语法都是有效的Rust语法。

我们的模块声明部分是我们将外部功能引入合同的地方,它与Solidity使用声明的性质类似。

// Ink

useink_core::{

env::{self,AccountId},

memory::format,

storage,

};

useink_lang::contract;

useparity_codec::{Decode,Encode};

// Solidity

interfaceContractName{

using SafeMathforuint256;

using AddressUtilsforaddress;

}

事件在Event枚举中声明,而使用Solidity我们分别定义事件,将每个事件键入事件:

// Ink

enumEvent {

Transfer {

from: AccountId,

to: AccountId,

token_id: u64

},

}

// Solidity

eventTransfer(

address indexedfrom,

address indexed to,

uint256 indexed _tokenId

);

如果solidity合同嵌入到接口块中,那么ink合同嵌入到合同中!宏。我们的事件在这个宏之外声明,而事件在solidity接口内声明。如下所述。

注意:rust中的宏是一个声明,表示包装表达式将被包围的语法块。宏在句法层面抽象,所以智能合约!宏正在用更多的语法包装其内容。

// Ink

// events

contract! {

// rest of contract

}

// Solidity

interfaceContractName{

// events

// rest of contract

}

使用Ink,我们的契约变量写在我们合同名称的结构中。 从Rust的HashMap类型派生的哈希映射代替Solidity的映射类型,提供key =>值列表。

Substrate如何存储值

在Substrate链上持久存储的任何数据称为外在数据,而Ink为我们提供了通过存储模块在链上存储外部数据的方法,存储模块位于语言的核心模块中。 换句话说,您计划在链上保留的所有合约变量都将使用存储中的类型。 相反,存储器模块也可用于在存储器上操作的数据结构。

另一方面,Solidity对此采用了不同的方法。 从Solidity 0.5开始,存储和内存引用类型被引入到函数参数或函数变量中,因此契约知道在哪里引用这些变量。 但是,对于Solidity中的合同变量,这不是必需的。

原始类型也可用,并且在两种语言中都是一致的; Rust使用u64,Solidity采用更详细的uint64类型声明。 总的来说,在两种语言之间实现相同的契约变量结构非常简单。

// Ink

structNFToken{

owner: storage::Value,

approvals: storage::HashMap,

}

// Solidity

address owner;

mapping (uint64 => address) approvals;

在上面的示例中,存储对象处理的值的类型通过尖括号传入,而不是通过类型的泛型。

初始化函数的概念存在于Ink和Solidity中,尽管以不同的方式实现。 使用Ink,我们在Deploy {}实现块中显式定义deploy()方法。 我们为此方法定义的参数代表了我们在初始化合同时发送的数据。 例如。 对于我们的不可替代的令牌,我们将提供初始数量的令牌:

// Inks initialisationfunction,deploy()

impl DeployforNFToken {

fn deploy(&mut self, init_value: u64) {

...

}

}

公共和私有方法也在impl块中定义,其中公共方法使用pub(外部)显式定义。 同样,在将此语法与Solidity的语法进行比较时,内部和外部用于定义私有或公共资源。

注意:在Rust中,函数,模块,特征和结构在默认情况下是私有的,并且必须使用pub关键字定义,以便它们可以从外部访问。 这里pub的(外部)扩展是特定于Ink的,并且必须包含公共Ink功能。

// public functions

impl NFToken {

pub(external)fntotal_minted(&self) -> u64{}

}

// private functions

impl NFToken {

fnmint_impl(

&mut self,

receiver: AccountId,

value: u64) ->bool{

}

}

同样,我们将私有函数和公共函数分开放在单独的impl块中,并为已定义的公共函数包含pub(external)。

作为合同的最后一个构建块,定义了一个测试模块,在测试我们的函数时断言各种条件。 在测试模块中,我们可以测试我们的合同逻辑,而无需编译并将其部署到Substrate链,从而可以快速解决错误并验证合同是否按预期工作。

接下来

我们现在已经讨论了Ink智能合约的构建模块。 在本系列的下一部分中,我们将更深入地探讨非可替代令牌智能合约的功能,理解所使用的Rust设计模式以及它们如何与我们的智能合约逻辑相结合。 然后我们将介绍构建智能合约并将其部署到本地Substrate链的过程,并使用Polkadot JS测试其功能。

作者:Ross Bulat

你可能感兴趣的:(区块链研究实验室 | 基于substrate创建Ink智能合约)