Rust NIS模块pallet-nis的使用：Substrate区块链框架中的非交互式质押与治理功能库

NIS模块

提供了一种非交互式的质押变体。

许可证: Apache-2.0

元数据

• 版本: 42.0.0
• 发布时间: 约17小时前
• 2021版本
• 大小: 45 KiB

安装

在你的项目目录中运行以下Cargo命令:

cargo add pallet-nis

或者在你的Cargo.toml中添加以下行:

pallet-nis = "42.0.0"

完整示例代码

// 引入必要的依赖
use frame_support::{decl_module, decl_event, decl_storage, dispatch::DispatchResult};
use frame_system::ensure_signed;

// 定义NIS模块
pub trait Trait: frame_system::Trait {
    type Event: From<Event<Self>> + Into<<Self as frame_system::Trait>::Event>;
}

// 定义存储项
decl_storage! {
    trait Store for Module<T: Trait> as Nis {
        // 存储质押总额
        pub TotalStake get(fn total_stake): u64;
        // 存储账户质押余额
        pub AccountStake get(fn account_stake): map hasher(blake2_128_concat) T::AccountId => u64;
    }
}

// 定义事件
decl_event!(
    pub enum Event<T> where AccountId = <T as frame_system::Trait>::AccountId {
        // 质押事件
        Staked(AccountId, u64),
        // 解除质押事件
        Unstaked(AccountId, u64),
    }
);

// 定义模块
decl_module! {
    pub struct Module<T: Trait> for enum Call where origin: T::Origin {
        // 初始化事件
        fn deposit_event() = default;

        // 质押函数
        #[weight = 10_000]
        pub fn stake(origin, amount: u64) -> DispatchResult {
            let sender = ensure_signed(origin)?;
            
            // 更新存储
            <AccountStake<T>>::mutate(&sender, |balance| *balance += amount);
            <TotalStake<T>>::mutate(|total| *total += amount);
            
            // 发出事件
            Self::deposit_event(RawEvent::Staked(sender, amount));
            
            Ok(())
        }

        // 解除质押函数
        #[weight = 10_000]
        pub fn unstake(origin, amount: u64) -> DispatchResult {
            let sender = ensure_signed(origin)?;
            
            // 检查余额是否足够
            let current = <AccountStake<T>>::get(&sender);
            if current < amount {
                return Err("Insufficient stake balance".into());
            }
            
            // 更新存储
            <AccountStake<T>>::mutate(&sender, |balance| *balance -= amount);
            <TotalStake<T>>::mutate(|total| *total -= amount);
            
            // 发出事件
            Self::deposit_event(RawEvent::Unstaked(sender, amount));
            
            Ok(())
        }
    }
}

// 测试模块
#[cfg(test)]
mod tests {
    use super::*;
    use frame_support::{assert_ok, assert_err, impl_outer_origin, parameter_types};
    use sp_core::H256;
    use sp_runtime::{testing::Header, traits::{BlakeTwo256, IdentityLookup}, Perbill};
    
    impl_outer_origin! {
        pub enum Origin for Test {}
    }
    
    #[derive(Clone, Eq, PartialEq)]
    pub struct Test;
    parameter_types! {
        pub const BlockHashCount: u64 = 250;
        pub const MaximumBlockWeight: u32 = 1024;
        pub const MaximumBlockLength: u32 = 2 * 1024;
        pub const AvailableBlockRatio: Perbill = Perbill::from_percent(75);
    }
    
    impl frame_system::Trait for Test {
        type Origin = Origin;
        type Call = ();
        type Index = u64;
        type BlockNumber = u64;
        type Hash = H256;
        type Hashing = BlakeTwo256;
        type AccountId = u64;
        type Lookup = IdentityLookup<Self::AccountId>;
        type Header = Header;
        type Event = ();
        type BlockHashCount = BlockHashCount;
        type MaximumBlockWeight = MaximumBlockWeight;
        type MaximumBlockLength = MaximumBlockLength;
        type AvailableBlockRatio = AvailableBlockRatio;
        type Version = ();
        type ModuleToIndex = ();
        type AccountData = ();
        type OnNewAccount = ();
        type OnKilledAccount = ();
    }
    
    impl Trait for Test {
        type Event = ();
    }
    
    type Nis = Module<Test>;
    
    #[test]
    fn test_stake() {
        new_test_ext().execute_with(|| {
            // 初始状态检查
            assert_eq!(Nis::total_stake(), 0);
            assert_eq!(Nis::account_stake(1), 0);
            
            // 质押成功
            assert_ok!(Nis::stake(Origin::signed极简，仅包含核心功能，适合快速上手和理解NIS模块的基本概念。