您好,登錄后才能下訂單哦!
這篇文章主要介紹“Rust之Substrate框架中的pallet怎么使用”,在日常操作中,相信很多人在Rust之Substrate框架中的pallet怎么使用問題上存在疑惑,小編查閱了各式資料,整理出簡單好用的操作方法,希望對大家解答”Rust之Substrate框架中的pallet怎么使用”的疑惑有所幫助!接下來,請跟著小編一起來學習吧!
Substrate 是一個區塊鏈開發框架,它提供了一系列模塊化和可擴展的組件,可以幫助開發人員快速構建自定義區塊鏈。 Pallet 是 Substrate 區塊鏈的基礎模塊,它定義了區塊鏈的業務邏輯和狀態轉換規則。開發人員可以使用現有的 Pallet 來快速構建區塊鏈,也可以開發自定義的 Pallet 來實現特定的功能。
Pallet是一個 Rust 程序包,它定義了一組特定的功能和接口。每個 Pallet 都包含了一組存儲項、一組調用函數和一組事件。
一個典型的 Substrate Pallet 由以下部分組成:
配置 Trait:定義了 Pallet 的配置接口。
存儲項:定義了 Pallet 的狀態存儲。
調用函數:定義了 Pallet 的外部調用接口。
事件:定義了 Pallet 的事件類型。
要開發 Substrate Pallet,首先需要搭建開發環境。我們需要安裝 Rust 編程語言、Substrate 開發包和 Node.js 等工具。下面是一個簡單的安裝示例:
# 安裝 Rust 編程語言 curl https://sh.rustup.rs -sSf | sh # 安裝 Substrate 開發包 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
開發一個 Substrate Pallet 的流程大致如下:
定義配置 Trait:定義 Pallet 的配置接口。
定義存儲項:定義 Pallet 的狀態存儲。
定義調用函數:定義 Pallet 的外部調用接口。
定義事件:定義 Pallet 的事件類型。
實現業務邏輯:實現 Pallet 的業務邏輯。
定義配置 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 的狀態存儲。 存儲項是 Pallet 的狀態存儲,它用來存儲區塊鏈的狀態數據。我們可以使用 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 的外部調用接口,它用來接收外部調用并執行相應的操作。我們可以使用 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
函數觸發一個事件。
定義事件:定義 Pallet 的事件類型。 事件是 Pallet 的一種通知機制,它用來通知外部模塊 Pallet 內部狀態的變化。我們可以使用 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
表示調用方的身份。
實現業務邏輯:實現 Pallet 的業務邏輯。 在完成了上述步驟之后,我們就可以開始實現 Pallet 的業務邏輯了。我們需要在調用函數中編寫相應的代碼,以實現 Pallet 的功能。下面是一個簡單的業務邏輯示例:
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
中實現了一個簡單的業務邏輯:將傳入的數值存儲到存儲項中,并觸發一個事件。
集成現有 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>}, } );
要開發自定義的 Pallet,我們需要按照上文提到的開發流程來實現。下面是一個簡單的自定義 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
用來記錄修改操作。
到此,關于“Rust之Substrate框架中的pallet怎么使用”的學習就結束了,希望能夠解決大家的疑惑。理論與實踐的搭配能更好的幫助大家學習,快去試試吧!若想繼續學習更多相關知識,請繼續關注億速云網站,小編會繼續努力為大家帶來更多實用的文章!
免責聲明:本站發布的內容(圖片、視頻和文字)以原創、轉載和分享為主,文章觀點不代表本網站立場,如果涉及侵權請聯系站長郵箱:is@yisu.com進行舉報,并提供相關證據,一經查實,將立刻刪除涉嫌侵權內容。