Rust区块链开发工具parachains-runtimes-test-utils的使用：Substrate测试框架与平行链运行时模拟

安装

在项目目录中运行以下Cargo命令：

cargo add parachains-runtimes-test-utils

或者将以下行添加到您的Cargo.toml中：

parachains-runtimes-test-utils = "23.0.0"

元数据

• 版本: 23.0.0
• 发布时间: 15天前
• 许可证: Apache-2.0
• 大小: 47.6 KiB
• Rust版本: 2021 edition

示例代码

以下是一个使用parachains-runtimes-test-utils进行平行链运行时测试的完整示例：

use parachains_runtimes_test_utils::{
    AccountId, Balances, ExtBuilder, Runtime, System, TestExternalities,
};
use sp_runtime::traits::IdentifyAccount;

// 设置测试环境
fn setup_test_env() -> TestExternalities {
    ExtBuilder::default()
        .balances(vec![
            // 初始化账户余额
            (alice_account(), 100_000),
            (bob_account(), 50_000),
        ])
        .build()
}

// 获取测试账户
fn alice_account() -> AccountId {
    AccountId::from([1u8; 32])
}

fn bob_account() -> AccountId {
    AccountId::from([2u8; 32])
}

#[test]
fn test_balance_transfer() {
    let mut ext = setup_test_env();
    
    ext.execute_with(|| {
        // 初始余额检查
        assert_eq!(Balances::free_balance(&alice_account()), 100_000);
        assert_eq!(Balances::free_balance(&bob_account()), 50_000);
        
        // 执行转账
        Balances::transfer(
            RuntimeOrigin::signed(alice_account()),
            bob_account().into(),
            10_000,
        ).unwrap();
        
        // 转账后余额检查
        assert_eq!(Balances::free_balance(&alice_account()), 90_000);
        assert_eq!(Balances::free_balance(&bob_account()), 60_000);
    });
}

#[test]
fn test_block_production() {
    let mut ext = setup_test_env();
    
    ext.execute_with(|| {
        // 初始区块号检查
        assert_eq!(System::block_number(), 0);
        
        // 生产一个区块
        System::set_block_number(1);
        
        // 验证区块号已更新
        assert_eq!(System::block_number(), 1);
    });
}

功能说明

parachains-runtimes-test-utils提供以下主要功能：

1. 测试环境构建器 (ExtBuilder) - 轻松设置具有自定义初始状态的测试环境
2. 模拟区块生产 - 测试链上操作和状态转换
3. 账户管理 - 创建和管理测试账户
4. 余额操作 - 测试代币转移和其他金融操作
5. 事件检查 - 验证运行时事件是否正确触发

这个工具集是Substrate框架生态系统中测试平行链运行时的重要组成部分，特别适合开发需要与中继链交互的平行链应用。

完整示例代码

以下是一个更完整的示例，展示了如何使用parachains-runtimes-test-utils进行全面的平行链运行时测试：

use parachains_runtimes_test_utils::{
    AccountId, Balances, ExtBuilder, Runtime, System, TestExternalities,
    Event, RuntimeCall, RuntimeEvent
};
use sp_runtime::traits::IdentifyAccount;
use frame_support::{assert_ok, assert_noop};

// 设置更复杂的测试环境
fn setup_complex_test_env() -> TestExternalities {
    ExtBuilder::default()
        .balances(vec![
            (alice_account(), 200_000),
            (bob_account(), 100_000),
            (charlie_account(), 50_000),
        ])
        .build()
}

// 测试账户
fn alice_account() -> AccountId {
    AccountId::from([1u8; 32])
}

fn bob_account() -> AccountId {
    AccountId::from([2u8; 32])
}

fn charlie_account() -> AccountId {
    AccountId::from([3u8; 32])
}

#[test]
fn test_complex_balance_operations() {
    let mut ext = setup_complex_test_env();
    
    ext.execute_with(|| {
        // 初始状态验证
        assert_eq!(System::block_number(), 0);
        assert_eq!(Balances::free_balance(&alice_account()), 200_000);
        assert_eq!(Balances::free_balance(&bob_account()), 100_000);
        assert_eq!(Balances::free_balance(&charlie_account()), 50_000);
        
        // Alice转账给Bob
        assert_ok!(Balances::transfer(
            RuntimeOrigin::signed(alice_account()),
            bob_account().into(),
            25_000,
        ));
        
        // Bob转账给Charlie
        assert_ok!(Balances::transfer(
            RuntimeOrigin::signed(bob_account()),
            charlie_account().into(),
            10_000,
        ));
        
        // 验证转账后的余额
        assert_eq!(Balances::free_balance(&alice_account()), 175_000);
        assert_eq!(Balances::free_balance(&bob_account()), 85_000);
        assert_eq!(Balances::free_balance(&charlie_account()), 60_000);
        
        // 测试无效转账(余额不足)
        assert_noop!(
            Balances::transfer(
                RuntimeOrigin::signed(charlie_account()),
                alice_account().into(),
                100_000,
            ),
            "Insufficient balance"
        );
    });
}

#[test]
fn test_block_and_event_processing() {
    let mut ext = setup_complex_test_env();
    
    ext.execute_with(|| {
        // 生产10个区块
        for i in 1..=10 {
            System::set_block_number(i);
            
            // 每个区块Alice都转账1给Bob
            assert_ok!(Balances::transfer(
                RuntimeOrigin::signed(alice_account()),
                bob_account().into(),
                1,
            ));
            
            // 验证事件是否触发
            let event = RuntimeEvent::Balances(
                pallet_balances::Event::Transfer {
                    from: alice_account(),
                    to: bob_account(),
                    amount: 1,
                }
            );
            assert!(System::events().iter().any(|record| record.event == event));
        }
        
        // 最终验证
        assert_eq!(System::block_number(), 10);
        assert_eq!(Balances::free_balance(&alice_account()), 200_000 - 10);
        assert_eq!(Balances::free_balance(&bob_account()), 100_000 + 10);
    });
}