Substrate - 创建一个自己的Pallet包

简介

• 参考文档：https://substrate.dev/docs/en/tutorials/create-a-pallet

在GitHub 上创建测试用的Pallet 项目

• 访问：https://github.com/substrate-developer-hub/substrate-pallet-template 需要注意这是一个项目奖里面的pallet模板，点击绿色的大按钮（use this template）
  

  image.png

• 然后我们给自己的仓库起名test-pallet，（实际上任何名字都可以）
  

  image.png

Clone 新建立的项目到 template /pallets 目录下面

• cd /Users/apple/lin-files/work-files/coding/git-fiels/learning-rust/start-a-private-network/substrate-node-template/pallets
• 如果你的Substrate-node-template也在git下面，可以添加submodule ，git submodule add [email protected]:kami1983/test-pallet.git 否则直接 git clone 就可以了。
• （题外话）通过submodule 会在根目录的 .git/config 下面生成：

[submodule "start-a-private-network/substrate-node-template/pallets/test-pallet"]
        url = [email protected]:kami1983/test-pallet.git
        active = true

• 此时：git add --all;git commit -m "ass" pallets/test-pallet 目录也会被提交。
  
  image.png
• 好了 test-pallet 项目代码准备好后就可以进行下一步操作了。

重新命名你的Crate

• 修改 pallets/test-pallet/Cargo.toml

[package]
authors = ['Kmai1983']
description = '建立一个测试用的Pallet create'
edition = '2018'
homepage = 'https://github.com/kami1983'
license = 'Unlicensed'
name = 'test-pallet'
repository = 'https://github.com/kami1983/test-pallet'
version = '3.0.0'

编译 Pallet

• cd test-pallet 输入check 命令：SKIP_WASM_BUILD=1 cargo check
• 使用如下命令，确认 Substrate 模块模板测试通过：SKIP_WASM_BUILD=1 cargo test

将模块添加到节点中

• 修改 runtime/Cargo.toml

# --snip--
test-pallet = { path = '../pallets/test-pallet', default-features = false, version = '3.0.0' }

# toward the bottom
[features]
default = ['std']
std = [
    'test-pallet/std',
    # --snip--
]

• 接下来更新 runtime/src/lib.rs启用我们的 runtime pallet：

// add this line (or modify all of these to your named pallet 
// corresponding to `test-pallet` in its cargo.toml file)
pub use test_pallet;

// --snip--

// add this block
impl test_pallet::Config for Runtime {
  type Event = Event;
}

// --snip--
construct_runtime!(
  pub enum Runtime where
    Block = Block,
    NodeBlock = opaque::Block,
    UncheckedExtrinsic = UncheckedExtrinsic
  {
    // --snip--
    // add the following line
    TestPallet: test_pallet::{Module, Call, Storage, Event},
  }
);

运行节点

• cargo run -- --dev --tmp 成功启动后，访问 https://polkadot.js.org/链接到我们启动的测试链上，然后选择 开发者-》交易-》可以看到 testPallet 也就是表示我们成功了。

image.png

发布模块

将模块发布到 GitHub

• 将代码上传到Github 后，我们就可以将依赖指向成GIt地址，修改 runtime/Cargo.toml

[dependencies.your-pallet-name]
default_features = false
git = 'https://github.com/your-username/your-pallet'
branch = 'master'

# You may choose a specific commit or tag instead of branch
# rev = ''
# tag = '

将模块发布到 Crates.io

• 将代码包发布到Crate.io后，就可以修改 runtime/Cargo.toml

[dependencies.your-pallet-name]
default_features = false
version = 'some-compatible-version'

结束

感谢阅读，See you at work.