Struct cw_multi_test::App

pub struct App<C = Empty> where
    C: Clone + Debug + PartialEq + JsonSchema,  { /* fields omitted */ }

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.

C is the custom message returned init, handle, sudo (Response). All contracts must return Response or Response

Implementations

impl<C> App<C> where
    C: Clone + Debug + PartialEq + JsonSchema, 

pub fn new<B: Bank + 'static>(
    api: Box<dyn Api>,
    block: BlockInfo,
    bank: B,
    storage_factory: fn() -> Box<dyn Storage>
) -> Self

pub fn cache(&self) -> AppCache<'_, C>

pub fn set_block(&mut self, block: BlockInfo)

This can set the block info to any value. Must be done before taking a cache

pub fn update_block<F: Fn(&mut BlockInfo)>(&mut self, action: F)

This let’s use use “next block” steps that add eg. one height and 5 seconds

pub fn block_info(&self) -> BlockInfo

Returns a copy of the current block_info

pub fn set_bank_balance(
    &mut self,
    account: HumanAddr,
    amount: Vec<Coin>
) -> Result<(), String>

This is an “admin” function to let us adjust bank accounts

pub fn store_code(&mut self, code: Box<dyn Contract<C>>) -> u64

This registers contract code (like uploading wasm bytecode on a chain), so it can later be used to instantiate a contract.

pub fn wrap(&self) -> QuerierWrapper<'_>

Simple helper so we get access to all the QuerierWrapper helpers, eg. query_wasm_smart, query_all_balances, …

pub fn query(&self, request: QueryRequest<Empty>) -> Result<Binary, String>

Handles arbitrary QueryRequest, this is wrapped by the Querier interface, but this is nicer to use.

pub fn instantiate_contract<T: Serialize, U: Into<String>, V: Into<HumanAddr>>(
    &mut self,
    code_id: u64,
    sender: V,
    init_msg: &T,
    send_funds: &[Coin],
    label: U
) -> Result<HumanAddr, String>

Create a contract and get the new address. This is just a helper around execute()

pub fn execute_contract<T: Serialize, U: Into<HumanAddr>>(
    &mut self,
    sender: U,
    contract_addr: U,
    msg: &T,
    send_funds: &[Coin]
) -> Result<AppResponse, String>

Execute a contract and process all returned messages. This is just a helper around execute()

pub fn execute(
    &mut self,
    sender: HumanAddr,
    msg: CosmosMsg<C>
) -> Result<AppResponse, String>

Runs arbitrary CosmosMsg. This will create a cache before the execution, so no state changes are persisted if this returns an error, but all are persisted on success.

pub fn execute_multi(
    &mut self,
    sender: HumanAddr,
    msgs: Vec<CosmosMsg<C>>
) -> Result<Vec<AppResponse>, String>

Runs multiple CosmosMsg in one atomic operation. This will create a cache before the execution, so no state changes are persisted if any of them return an error. But all writes are persisted on success.

pub fn sudo<T: Serialize, U: Into<HumanAddr>>(
    &mut self,
    contract_addr: U,
    msg: &T
) -> Result<AppResponse, String>

Runs arbitrary CosmosMsg. This will create a cache before the execution, so no state changes are persisted if this returns an error, but all are persisted on success.

Trait Implementations

impl<C> Querier for App<C> where
    C: Clone + Debug + PartialEq + JsonSchema, 

fn raw_query(&self, bin_request: &[u8]) -> QuerierResult

raw_query is all that must be implemented for the Querier. This allows us to pass through binary queries from one level to another without knowing the custom format, or we can decode it, with the knowledge of the allowed types. People using the querier probably want one of the simpler auto-generated helper methods