首页 > 其他分享> > 【Substrate Collectables教程】【第1章基础】1. 创建 module

【Substrate Collectables教程】【第1章基础】1. 创建 module

2022-05-11 22:02:58 作者：互联网

前言：

本节中，会通过学习创建自定义runtime的基础知识，学会

1. 如何使用runtime存储
2. 如何公开runtime函数
3. 如何使用Polkadot-JS APPs UI与runtime进行交互

在开始学习之前，了解以下的几个概念：

Runtime: 区块链的执行逻辑,在substrate中是以WebAssembly （一种可以使用非 JavaScript 编程语言编写代码并且能在浏览器上运行的技术方案\JS的API）

Module: 模块。区块链runtime由多种特性和功能组成，这些特性和功能可以为区块链提供支撑，如账户管理、Token余额、治理、runtime升级等。上述的这些都是代码库中所提供的模块，包含在runtime中。Substrate提供默认模块集合被称做Substrate Runtime Module Library。

在Substrate中，我们要学习的就是如何在runtime中创建新的module。

Rust: Substrate和Runtime的开发使用Rust编程语言。

ownership和borrowing（待学习）: rust中的一种特性，可以保证rust在没有垃圾回收器的情况下，保证内存安全

Trait: Traits 是 Rust 中唯一和 interface 类似的概念

使用 Result 表示 Recoverable Errors：？？？模块函数必须返回 Result 类型，这允许我们处理函数中的错误。返回结果是 Ok() 时表示成功，是 Err() 时表示失败。

Macros: 宏，编写代码的代码。

1.1 创建Module

首先，我们需要为 runtime 创建一个新 module。为此，我们将使用一个空 module 模板，并把它放在一个新的 appletrace.rs 文件中：

注意： substrate-node-template还提供了一个template.rs文件。通常你可以从这个模板文件开始构建你的模块。这里为了从头开始，我们使用一个新文件。

appletrace.rs的内容如下

use support::{decl_storage, decl_module};

pub trait Trait: system::Trait {}

decl_storage! {
    trait Store for Module<T: Trait> as KittyStorage {
        // Declare storage and getter functions here
    }
}

decl_module! {
    pub struct Module<T: Trait> for enum Call where origin: T::Origin {
        // Declare public functions here
    }
}