Features
Features summary
All MultiTest features are listed in the table below.
The Default implementation column indicates whether the feature has a default
implementation in MultiTest that simulates the functionality of the real blockchain as closely
as possible. In cases where MultiTest does not have a default implementation for the feature,
you can provide your own, using AppBuilder’s function listed in AppBuilder constructor
column. Names of MultiTest feature flags required to enable specific functionality are shown
in the column Feature flag.
| Feature | Default implementation | Feature flag | AppBuilder constructor | Functionality |
|---|---|---|---|---|
| Blocks | mock_env().block | with_block | Operations on blocks. | |
| API | MockApi | with_api | Access to CosmWasm API. | |
| Storage | MockStorage | with_storage | Access to storage. | |
| Bank | BankKeeper | with_bank | Interactions with Bank module. | |
| Staking | StakeKeeper | staking | with_staking | Interactions with Staking module. |
| Distribution | DistributionKeeper | staking | with_distribution | Interactions with Distribution module. |
| Governance | GovFailingModule | with_gov | Interactions with Governance module. | |
| Stargate | StargateFailing | stargate | with_stargate | Operations using Stargate and/or Any messages. |
| Wasm | WasmKeeper | with_wasm | Interactions with Wasm module. | |
| Custom | FailingModule | new_custom | Operations using custom module. | |
| IBC | IbcFailingModule | stargate | with_ibc | Inter-blockchain communication operations. |
Feature flags summary
The following table summarizes feature flags supported by MultiTest.
| Feature flag | Description |
|---|---|
backtrace | Enables backtrace feature in anyhow dependency. |
staking | Enables staking feature in cosmwasm-std dependency and enables staking/distribution functionality in MultiTest library. |
stargate | Enables stargate feature in cosmwasm-std dependency and enables stargate/IBC functionality in MultiTest library. |
cosmwasm_1_1 | Enables cosmwasm_1_1 feature in cosmwasm-std dependency. |
cosmwasm_1_2 | Enables cosmwasm_1_2 feature in cosmwasm-std dependency and additionally cosmwasm_1_1 feature in MultiTest library. |
cosmwasm_1_3 | Enables cosmwasm_1_3 feature in cosmwasm-std dependency and additionally cosmwasm_1_2 feature in MultiTest library. |
cosmwasm_1_4 | Enables cosmwasm_1_4 feature in cosmwasm-std dependency and additionally cosmwasm_1_3 feature in MultiTest library. |
cosmwasm_2_0 | Enables cosmwasm_2_0 feature in cosmwasm-std dependency and additionally cosmwasm_1_4 feature in MultiTest library. |
cosmwasm_2_1 | Enables cosmwasm_2_1 feature in cosmwasm-std dependency and additionally cosmwasm_2_0 feature in MultiTest library. |
cosmwasm_2_2 | Enables cosmwasm_2_2 feature in cosmwasm-std dependency and additionally cosmwasm_2_1 feature in MultiTest library. |
Starting point
Usually, a good starting point when using MultiTest is the following dependency configuration
in Cargo.toml file:
Cargo.toml
[dependencies]
cosmwasm-std = "2"
[dev-dependencies]
cw-multi-test = { version = "2", features = ["staking", "stargate", "cosmwasm_2_2"] }