Injective Test Tube - Injective Docs

injective-test-tube 是一个 CosmWasm x Injective 集成测试库，与 cw-multi-test 不同，它允许你针对链的实际逻辑而不是模拟来测试你的 CosmWasm 合约。 dev 分支依赖于当前私有的仓库，但你可以使用已发布的版本。有关功能和更新信息，请参阅 CHANGELOG。

入门

为了演示 injective-test-tube 的工作原理，让我们使用一个简单的示例合约：来自 cw-plus 的 cw-whitelist。以下是如何设置测试：

use cosmwasm_std::Coin;
use injective_test_tube::InjectiveTestApp;

// 创建新的 injective appchain 实例。
let app = InjectiveTestApp::new();

// 创建具有初始资金的新账户
let accs = app
    .init_accounts(
        &[
            Coin::new(1_000_000_000_000, "usdt"),
            Coin::new(1_000_000_000_000, "inj"),
        ],
        2,
    )
    .unwrap();

let admin = &accs[0];
let new_admin = &accs[1];

现在我们有了 appchain 实例和具有一些初始余额的账户，可以与 appchain 交互。这不会运行 Docker 实例或生成外部进程，它只是将 appchain 的代码作为库加载以创建内存实例。请注意，init_accounts 是一个便利函数，用于创建具有相同初始余额的多个账户。如果你只想创建一个账户，可以使用 init_account。

use cosmwasm_std::Coin;
use injective_test_tube::InjectiveTestApp;

let app = InjectiveTestApp::new();

let account = app.init_account(&[
    Coin::new(1_000_000_000_000, "usdt"),
    Coin::new(1_000_000_000_000, "inj"),
]);

现在如果我们想测试一个 cosmwasm 合约，我们需要

构建 wasm 文件
存储代码
实例化

然后我们可以开始与我们的合约交互。让我们这样做。

use cosmwasm_std::Coin;
use cw1_whitelist::msg::{InstantiateMsg}; // 用于实例化 cw1_whitelist 合约
use injective_test_tube::{Account, Module, InjectiveTestApp, Wasm};

let app = InjectiveTestApp::new();
let accs = app
    .init_accounts(
        &[
            Coin::new(1_000_000_000_000, "usdt"),
            Coin::new(1_000_000_000_000, "inj"),
        ],
        2,
    )
    .unwrap();
let admin = &accs[0];
let new_admin = &accs[1];

// ============= 新代码 ================

// `Wasm` 是我们用来与 appchain 上的 cosmwasm 相关逻辑交互的模块
// 它实现了 `Module` trait，你稍后会看到更多。
let wasm = Wasm::new(&app);

// 加载编译后的 wasm 字节码
let wasm_byte_code = std::fs::read("./test_artifacts/cw1_whitelist.wasm").unwrap();
let code_id = wasm
    .store_code(&wasm_byte_code, None, admin)
    .unwrap()
    .data
    .code_id;

请注意，在此示例中，它从 cw-plus release 加载 wasm 字节码以进行简单演示。你可能想运行 cargo wasm 并在 target/wasm32-unknown-unknown/release/<contract_name>.wasm 中找到你的 wasm 文件。

use cosmwasm_std::Coin;
use cw1_whitelist::msg::{InstantiateMsg, QueryMsg, AdminListResponse};
use injective_test_tube::{Account, Module, InjectiveTestApp, Wasm};

let app = InjectiveTestApp::new();
let accs = app
    .init_accounts(
        &[
            Coin::new(1_000_000_000_000, "usdt"),
            Coin::new(1_000_000_000_000, "inj"),
        ],
        2,
    )
    .unwrap();
let admin = &accs[0];
let new_admin = &accs[1];

let wasm = Wasm::new(&app);


let wasm_byte_code = std::fs::read("./test_artifacts/cw1_whitelist.wasm").unwrap();
let code_id = wasm
    .store_code(&wasm_byte_code, None, admin)
    .unwrap()
    .data
    .code_id;

// ============= 新代码 ================

// 使用初始 admin 实例化合约并使 admin 列表可变
let init_admins = vec![admin.address()];
let contract_addr = wasm
    .instantiate(
        code_id,
        &InstantiateMsg {
            admins: init_admins.clone(),
            mutable: true,
        },
        None, // 用于迁移的合约 admin，与 cw1_whitelist admin 不同
        Some("Test label"), // 合约标签
        &[], // 资金
        admin, // 签名者
    )
    .unwrap()
    .data
    .address;

// 查询合约状态以检查合约实例化是否正常工作
let admin_list = wasm
    .query::<QueryMsg, AdminListResponse>(&contract_addr, &QueryMsg::AdminList {})
    .unwrap();

assert_eq!(admin_list.admins, init_admins);
assert!(admin_list.mutable);

现在让我们执行合约并验证合约的状态是否正确更新。

use cosmwasm_std::Coin;
use cw1_whitelist::msg::{InstantiateMsg, QueryMsg, ExecuteMsg, AdminListResponse};
use injective_test_tube::{Account, Module, InjectiveTestApp, Wasm};

let app = InjectiveTestApp::new();
let accs = app
    .init_accounts(
        &[
            Coin::new(1_000_000_000_000, "usdt"),
            Coin::new(1_000_000_000_000, "inj"),
        ],
        2,
    )
    .unwrap();
let admin = &accs[0];
let new_admin = &accs[1];

let wasm = Wasm::new(&app);


let wasm_byte_code = std::fs::read("./test_artifacts/cw1_whitelist.wasm").unwrap();
let code_id = wasm
    .store_code(&wasm_byte_code, None, admin)
    .unwrap()
    .data
    .code_id;

// 使用初始 admin 实例化合约并使 admin 列表可变
let init_admins = vec![admin.address()];
let contract_addr = wasm
    .instantiate(
        code_id,
        &InstantiateMsg {
            admins: init_admins.clone(),
            mutable: true,
        },
        None, // 用于迁移的合约 admin，与 cw1_whitelist admin 不同
        Some("Test label"), // 合约标签
        &[], // 资金
        admin, // 签名者
    )
    .unwrap()
    .data
    .address;

let admin_list = wasm
    .query::<QueryMsg, AdminListResponse>(&contract_addr, &QueryMsg::AdminList {})
    .unwrap();

assert_eq!(admin_list.admins, init_admins);
assert!(admin_list.mutable);

// ============= 新代码 ================

// 更新 admin 列表并重新检查状态
let new_admins = vec![new_admin.address()];
wasm.execute::<ExecuteMsg>(
    &contract_addr,
    &ExecuteMsg::UpdateAdmins {
        admins: new_admins.clone(),
    },
    &[],
    admin,
)
.unwrap();

let admin_list = wasm
    .query::<QueryMsg, AdminListResponse>(&contract_addr, &QueryMsg::AdminList {})
    .unwrap();

assert_eq!(admin_list.admins, new_admins);
assert!(admin_list.mutable);

调试

在你的合约代码中，如果你想调试，可以使用 deps.api.debug(..)，它将调试消息打印到 stdout。wasmd 默认禁用此功能，但 InjectiveTestApp 允许 stdout 输出，以便你可以在运行测试时调试智能合约。

使用模块包装器

在某些情况下，你可能想直接与 appchain 逻辑交互以设置环境或查询 appchain 的状态。模块包装器提供了方便的函数来与 appchain 的模块交互。让我们尝试与 Exchange 模块交互：

use cosmwasm_std::{Addr, Coin};
use injective_std::types::injective::exchange::v1beta1::{
    MarketStatus, MsgInstantSpotMarketLaunch,
    QuerySpotMarketsRequest, QuerySpotMarketsResponse, SpotMarket,
};
use injective_test_tube::{Account, Exchange, InjectiveTestApp};
use test_tube_inj::Module;

let app = InjectiveTestApp::new();
let signer = app
    .init_account(&[
        Coin::new(10_000_000_000_000_000_000_000u128, "inj"),
        Coin::new(100_000_000_000_000_000_000u128, "usdt"),
    ])
    .unwrap();
let trader = app
    .init_account(&[
        Coin::new(10_000_000_000_000_000_000_000u128, "inj"),
        Coin::new(100_000_000_000_000_000_000u128, "usdt"),
    ])
    .unwrap();
let exchange = Exchange::new(&app);

exchange
    .instant_spot_market_launch(
        MsgInstantSpotMarketLaunch {
            sender: signer.address(),
            ticker: "INJ/USDT".to_owned(),
            base_denom: "inj".to_owned(),
            quote_denom: "usdt".to_owned(),
            min_price_tick_size: "10000".to_owned(),
            min_quantity_tick_size: "100000".to_owned(),
        },
        &signer,
    )
    .unwrap();

exchange
    .instant_spot_market_launch(
        MsgInstantSpotMarketLaunch {
            sender: signer.address(),
            ticker: "INJ/USDT".to_owned(),
            base_denom: "inj".to_owned(),
            quote_denom: "usdt".to_owned(),
            min_price_tick_size: "10000".to_owned(),
            min_quantity_tick_size: "100000".to_owned(),
        },
        &signer,
    )
    .unwrap_err();

app.increase_time(1u64);

let spot_markets = exchange
    .query_spot_markets(&QuerySpotMarketsRequest {
        status: "Active".to_owned(),
        market_ids: vec![],
    })
    .unwrap();

let expected_response = QuerySpotMarketsResponse {
    markets: vec![SpotMarket {
        ticker: "INJ/USDT".to_string(),
        base_denom: "inj".to_string(),
        quote_denom: "usdt".to_string(),
        maker_fee_rate: "-100000000000000".to_string(),
        taker_fee_rate: "1000000000000000".to_string(),
        relayer_fee_share_rate: "400000000000000000".to_string(),
        market_id: "0xd5a22be807011d5e42d5b77da3f417e22676efae494109cd01c242ad46630115"
            .to_string(),
        status: MarketStatus::Active.into(),
        min_price_tick_size: "10000".to_string(),
        min_quantity_tick_size: "100000".to_string(),
    }],
};
assert_eq!(spot_markets, expected_response);

更多示例可以在 modules 目录中找到。

版本控制

injective-test-tube 的版本由其依赖项 injective 和 test-tube 的版本以及其自身的更改决定。版本以 A.B.C 格式表示，其中：

A 是 injective 的主版本号，
B 是 test-tube 的次版本号，
C 是 injective-test-tube 本身的补丁号。

当发布新版本的 injective 并包含破坏性更改时，我们还将发布 test-tube 的破坏性更改（如果有）并增加 injective-test-tube 的主版本号。这样，很明显新版本的 injective-test-tube 与以前的版本不向后兼容。当向 injective-test-tube 添加向后兼容的新功能时，次版本号将增加。当修复错误或进行其他 injective-test-tube 特定且向后兼容的更改时，补丁号将增加。如果有破坏性更改，请查看升级指南以升级包重要的是要注意，我们独立于依赖项的版本跟踪包的版本。

​入门

​调试

​使用模块包装器

​版本控制

入门

调试

使用模块包装器

版本控制