Expand description
Multitest is a design to simulate a blockchain environment in pure Rust. This allows us to run unit tests that involve contract -> contract, and contract -> bank interactions. This is not intended to be a full blockchain app but to simulate the Cosmos SDK x/wasm module close enough to gain confidence in multi-contract deployements before testing them on a live blockchain.
To understand the design of this module, please refer to ../DESIGN.md
Modules§
Structs§
- App
- Router is a persisted state. You can query this. Execution generally happens on the RouterCache, which then can be atomically committed or rolled back. We offer .execute() as a wrapper around cache, execute, commit/rollback process.
- AppBuilder
- Utility to build App in stages. If particular items wont be set, defaults would be used
- AppResponse
- Bank
Keeper - Contract
Wrapper - Wraps the exported functions from a contract and provides the normalized format Place T4 and E4 at the end, as we just want default placeholders for most contracts that don’t have sudo
- Distribution
Keeper - Failing
Module - Mock
Address Generator - Address generator that mimics the wasmd behavior.
- Router
- Simple
Address Generator - Default contract address generator used in WasmKeeper.
- Stake
Keeper - Staking
Info - Stargate
Keeper - Stargate
Msg - Wasm
Keeper - Wasm
Sudo
Enums§
- Bank
Sudo - Staking
Sudo - SudoMsg
- We use it to allow calling into modules from another module in sudo mode. Things like gov proposals belong here.
Constants§
- QUERY_
ALL_ BALANCES_ PATH - QUERY_
BALANCE_ PATH - QUERY_
SUPPLY_ PATH - QUERY_
WASM_ CODE_ INFO_ PATH - QUERY_
WASM_ CONTRACT_ INFO_ PATH - QUERY_
WASM_ CONTRACT_ RAW_ PATH - QUERY_
WASM_ CONTRACT_ SMART_ PATH
Traits§
- Address
Generator - Common address generator interface.
- Bank
- Contract
- Interface to call into a Contract
- Cosmos
Router - Executor
- Ibc
- Module
- Staking
- Stargate
- Stargate
Message Handler - Stargate
Query Handler - Wasm
Functions§
- custom_
app - Creates new default
Appimplementation working with customized exec and query messages. Outside ofAppimplementation to make type elision better. - next_
block
Type Aliases§
- Basic
App - Type alias for default build
Appto make its storing simpler in typical scenario - Basic
AppBuilder - This is essential to create a custom app with custom handler. let mut app = BasicAppBuilder::<E, Q>::new_custom().with_custom(handler).build();