> ## Documentation Index > Fetch the complete documentation index at: https://injectivelabs-docs-tokenization-section.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Injective Test Tube `injective-test-tube` 是一个 CosmWasm x Injective 集成测试库，与 `cw-multi-test` 不同，它允许你针对链的实际逻辑而不是模拟来测试你的 CosmWasm 合约。 `dev` 分支依赖于当前私有的仓库，但你可以使用已发布的版本。有关功能和更新信息，请参阅 [`CHANGELOG`](https://github.com/InjectiveLabs/test-tube/blob/dev/packages/injective-test-tube/CHANGELOG.md)。 ### 入门 为了演示 `injective-test-tube` 的工作原理，让我们使用一个简单的示例合约：来自 `cw-plus` 的 [cw-whitelist](https://github.com/CosmWasm/cw-plus/tree/main/contracts/cw1-whitelist)。 以下是如何设置测试： ```rust theme={null} 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`。 ```rust theme={null} 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 文件 * 存储代码 * 实例化 然后我们可以开始与我们的合约交互。让我们这样做。 ```rust theme={null} 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](https://github.com/CosmWasm/cw-plus/releases) 加载 wasm 字节码以进行简单演示。你可能想运行 `cargo wasm` 并在 `target/wasm32-unknown-unknown/release/.wasm` 中找到你的 wasm 文件。 ```rust theme={null} 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::(&contract_addr, &QueryMsg::AdminList {}) .unwrap(); assert_eq!(admin_list.admins, init_admins); assert!(admin_list.mutable); ``` 现在让我们执行合约并验证合约的状态是否正确更新。 ```rust theme={null} 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::(&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::( &contract_addr, &ExecuteMsg::UpdateAdmins { admins: new_admins.clone(), }, &[], admin, ) .unwrap(); let admin_list = wasm .query::(&contract_addr, &QueryMsg::AdminList {}) .unwrap(); assert_eq!(admin_list.admins, new_admins); assert!(admin_list.mutable); ``` ### 调试 在你的合约代码中，如果你想调试，可以使用 [`deps.api.debug(..)`](https://docs.rs/cosmwasm-std/latest/cosmwasm_std/trait.Api.html#tymethod.debug)，它将调试消息打印到 stdout。`wasmd` 默认禁用此功能，但 `InjectiveTestApp` 允许 stdout 输出，以便你可以在运行测试时调试智能合约。 ### 使用模块包装器 在某些情况下，你可能想直接与 appchain 逻辑交互以设置环境或查询 appchain 的状态。模块包装器提供了方便的函数来与 appchain 的模块交互。 让我们尝试与 `Exchange` 模块交互： ```rust theme={null} 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](https://github.com/InjectiveLabs/test-tube/tree/dev/packages/injective-test-tube/src/module) 目录中找到。 ### 版本控制 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` 特定且向后兼容的更改时，补丁号将增加。 如果有破坏性更改，请查看升级指南以升级包 重要的是要注意，我们独立于依赖项的版本跟踪包的版本。