Rust之Substrate框架中的pallet詳解
引言
Substrate 是一個區(qū)塊鏈開發(fā)框架,它提供了一系列模塊化和可擴展的組件,可以幫助開發(fā)人員快速構建自定義區(qū)塊鏈。 Pallet 是 Substrate 區(qū)塊鏈的基礎模塊,它定義了區(qū)塊鏈的業(yè)務邏輯和狀態(tài)轉換規(guī)則。開發(fā)人員可以使用現有的 Pallet 來快速構建區(qū)塊鏈,也可以開發(fā)自定義的 Pallet 來實現特定的功能。
Pallet 概述
Pallet是一個 Rust 程序包,它定義了一組特定的功能和接口。每個 Pallet 都包含了一組存儲項、一組調用函數和一組事件。
一個典型的 Substrate Pallet 由以下部分組成:
- 配置 Trait:定義了 Pallet 的配置接口。
- 存儲項:定義了 Pallet 的狀態(tài)存儲。
- 調用函數:定義了 Pallet 的外部調用接口。
- 事件:定義了 Pallet 的事件類型。
Pallet 開發(fā)
要開發(fā) Substrate Pallet,首先需要搭建開發(fā)環(huán)境。我們需要安裝 Rust 編程語言、Substrate 開發(fā)包和 Node.js 等工具。下面是一個簡單的安裝示例:
# 安裝 Rust 編程語言 curl https://sh.rustup.rs -sSf | sh # 安裝 Substrate 開發(fā)包 curl https://getsubstrate.io -sSf | bash # 安裝 Node.js curl -sL https://deb.nodesource.com/setup_12.x | sudo -E bash - sudo apt-get install -y nodejs
開發(fā)一個 Substrate Pallet 的流程大致如下:
定義配置 Trait:定義 Pallet 的配置接口。
定義存儲項:定義 Pallet 的狀態(tài)存儲。
定義調用函數:定義 Pallet 的外部調用接口。
定義事件:定義 Pallet 的事件類型。
實現業(yè)務邏輯:實現 Pallet 的業(yè)務邏輯。
- 定義配置 Trait:定義 Pallet 的配置接口。 配置 Trait 是一個 Rust Trait,它定義了 Pallet 的配置接口。我們需要在配置 Trait 中定義一些類型和常量,以便在 Pallet 中使用。下面是一個簡單的配置 Trait 示例:
pub trait Trait: system::Trait {
type Event: From<Event<Self>> + Into<<Self as system::Trait>::Event>;
}在這個示例中,我們定義了一個 Trait Trait,它繼承自 system::Trait。我們在 Trait 中定義了一個類型 Event,它用來表示 Pallet 的事件類型。
- 定義存儲項:定義 Pallet 的狀態(tài)存儲。 存儲項是 Pallet 的狀態(tài)存儲,它用來存儲區(qū)塊鏈的狀態(tài)數據。我們可以使用
decl_storage!宏來定義存儲項。下面是一個簡單的存儲項示例:
decl_storage! {
trait Store for Module<T: Trait> as TemplateModule {
pub Something get(fn something): Option<u32>;
}
}在這個示例中,我們使用 decl_storage! 宏定義了一個存儲項 Something。它是一個可選的 u32 類型,可以使用 get 函數來獲取它的值。
- 定義調用函數:定義 Pallet 的外部調用接口。 調用函數是 Pallet 的外部調用接口,它用來接收外部調用并執(zhí)行相應的操作。我們可以使用
decl_module!宏來定義調用函數。下面是一個簡單的調用函數示例:
decl_module! {
pub struct Module<T: Trait> for enum Call where origin: T::Origin {
fn deposit_event() = default;
pub fn do_something(origin, something: u32) -> Result {
let who = ensure_signed(origin)?;
<Something<T>>::put(something);
Self::deposit_event(RawEvent::SomethingStored(something, who));
Ok(())
}
}
}在這個示例中,我們使用 decl_module! 宏定義了一個調用函數 do_something。它接收兩個參數:origin 和 something。origin 表示調用方的身份;something 表示要存儲的數值。在函數體內,我們首先使用 ensure_signed 函數檢查調用方的身份;然后使用 <Something<T>>::put 函數將數值存儲到存儲項中;最后使用 Self::deposit_event 函數觸發(fā)一個事件。
- 定義事件:定義 Pallet 的事件類型。 事件是 Pallet 的一種通知機制,它用來通知外部模塊 Pallet 內部狀態(tài)的變化。我們可以使用
decl_event!宏來定義事件。下面是一個簡單的事件示例:
decl_event!(
pub enum Event<T> where AccountId = <T as system::Trait>::AccountId {
SomethingStored(u32, AccountId),
}
);在這個示例中,我們使用 decl_event! 宏定義了一個事件 SomethingStored。它包含兩個字段:u32 和 AccountId。u32 表示存儲的數值;AccountId 表示調用方的身份。
- 實現業(yè)務邏輯:實現 Pallet 的業(yè)務邏輯。 在完成了上述步驟之后,我們就可以開始實現 Pallet 的業(yè)務邏輯了。我們需要在調用函數中編寫相應的代碼,以實現 Pallet 的功能。下面是一個簡單的業(yè)務邏輯示例:
decl_module! {
pub struct Module<T: Trait> for enum Call where origin: T::Origin {
fn deposit_event() = default;
pub fn do_something(origin, something: u32) -> Result {
let who = ensure_signed(origin)?;
<Something<T>>::put(something);
Self::deposit_event(RawEvent::SomethingStored(something, who));
Ok(())
}
}
}在這個示例中,我們在調用函數 do_something 中實現了一個簡單的業(yè)務邏輯:將傳入的數值存儲到存儲項中,并觸發(fā)一個事件。
Pallet 集成
集成現有 Pallet 要集成現有的 Pallet,我們需要在 Runtime 中引入對應的 Pallet 模塊,并在 construct_runtime! 宏中聲明它。下面是一個簡單的示例:
// 引入 Balances 模塊
use pallet_balances as balances;
// 在 construct_runtime! 宏中聲明 Balances 模塊
construct_runtime!(
pub enum Runtime where
Block = Block,
NodeBlock = opaque::Block,
UncheckedExtrinsic = UncheckedExtrinsic,
{
// ...
Balances: balances::{Module, Call, Storage, Config<T>, Event<T>},
}
);要開發(fā)自定義的 Pallet,我們需要按照上文提到的開發(fā)流程來實現。下面是一個簡單的自定義 Pallet 示例:
use support::{decl_module, decl_storage, decl_event, dispatch::Result};
use system::ensure_signed;
pub trait Trait: system::Trait {
type Event: From<Event<Self>> + Into<<Self as system::Trait>::Event>;
}
decl_storage! {
trait Store for Module<T: Trait> as TemplateModule {
pub Something get(fn something): Option<u32>;
}
}
decl_event!(
pub enum Event<T> where AccountId = <T as system::Trait>::AccountId {
SomethingStored(u32, AccountId),
}
);
decl_module! {
pub struct Module<T: Trait> for enum Call where origin: T::Origin {
fn deposit_event() = default;
pub fn do_something(origin, something: u32) -> Result {
let who = ensure_signed(origin)?;
<Something<T>>::put(something);
Self::deposit_event(RawEvent::SomethingStored(something, who));
Ok(())
}
}
}在這個示例中,我們定義了一個自定義的 Pallet,它包含了一個存儲項 Something、一個調用函數 do_something 和一個事件 SomethingStored。存儲項 Something 用來存儲一個數值;調用函數 do_something 用來修改存儲的數值;事件 SomethingStored 用來記錄修改操作。
總結
Substrate的Pallet具有很多優(yōu)點,例如模塊化、可擴展性和可升級性等。開發(fā)人員可以使用現有的 Pallet 來快速構建區(qū)塊鏈,也可以開發(fā)自定義的 Pallet 來實現特定的功能。
以上就是Rust之Substrate框架中的pallet詳解的詳細內容,更多關于Substrate pallet的資料請關注腳本之家其它相關文章!
相關文章
Rust開發(fā)WebAssembly在Html和Vue中的應用小結(推薦)
這篇文章主要介紹了Rust開發(fā)WebAssembly在Html和Vue中的應用,本文將帶領大家在普通html上和vue手腳架上都來運行wasm的流程,需要的朋友可以參考下2022-08-08
Rust可迭代類型迭代器正確創(chuàng)建自定義可迭代類型的方法
在 Rust 中, 如果一個類型實現了 Iterator, 那么它會被同時實現 IntoIterator, 具體邏輯是返回自身, 因為自身就是迭代器,這篇文章主要介紹了Rust可迭代類型迭代器正確創(chuàng)建自定義可迭代類型的方法,需要的朋友可以參考下2023-12-12
rust使用Atomic創(chuàng)建全局變量和使用操作方法
從 Rust1.34 版本后,就正式支持原子類型,原子指的是一系列不可被 CPU 上下文交換的機器指令,這些指令組合在一起就形成了原子操作,這篇文章主要介紹了rust使用Atomic創(chuàng)建全局變量和使用,需要的朋友可以參考下2024-05-05

