Struct CloneTesting

pub struct CloneTesting<S: StateInterface = MockState> {
    pub chain: ChainInfoOwned,
    pub sender: Addr,
    pub state: Rc<RefCell<S>>,
    pub app: Rc<RefCell<App<BankKeeper, MockApiBech32>>>,
}

Wrapper around a cw-multi-test App backend.

Stores a local state with a mapping of contract_id -> code_id/address

The state is customizable by implementing the StateInterface trait on a custom struct and providing it on the custom constructor.

Example

use cw_orch_clone_testing::CloneTesting;
use cw_orch_core::environment::TxHandler;

let chain = cw_orch_daemon::networks::JUNO_1;
let mock: CloneTesting = CloneTesting::new(chain.clone()).unwrap();
let sender = mock.sender();

// set a balance
mock.set_balance(&sender, vec![coin(100u128, "token")]).unwrap();

// query the balance
let balance: Uint128 = mock.query_balance(&sender, "token").unwrap();
assert_eq!(balance.u128(), 100u128);

Example with custom state

use cw_orch_clone_testing::CloneTesting;
use cw_orch_core::environment::StateInterface;
// We just use the MockState as an example here, but you can implement your own state struct.
use cw_orch_clone_testing::MockState as CustomState;

let rt = tokio::runtime::Runtime::new().unwrap();
let chain = cw_orch_daemon::networks::JUNO_1;
let mock: CloneTesting = CloneTesting::new_custom(&rt, chain.clone(), CustomState::new(chain.clone().into(), "mock")).unwrap();

Fields

chain: ChainInfoOwned

Chain data of the chain you want to fork

sender: Addr

Address used for the operations.

state: Rc<RefCell<S>>

Inner mutable state storage for contract addresses and code-ids

app: Rc<RefCell<App<BankKeeper, MockApiBech32>>>

Inner mutable cw-multi-test app backend

Implementations

impl CloneTesting

pub fn init_account(&self) -> Addr

Ceates a new valid account

pub fn set_balance( &self, address: &Addr, amount: Vec<Coin>, ) -> Result<(), CwEnvError>

Set the bank balance of an address.

pub fn add_balance( &self, address: &Addr, amount: Vec<Coin>, ) -> Result<(), CwEnvError>

Adds the bank balance of an address.

pub fn set_balances( &self, balances: &[(&Addr, &[Coin])], ) -> Result<(), CwEnvError>

Set the balance for multiple coins at once.

pub fn query_balance( &self, address: &Addr, denom: &str, ) -> Result<Uint128, CwEnvError>

Query the (bank) balance of a native token for and address. Returns the amount of the native token.

pub fn query_all_balances( &self, address: &Addr, ) -> Result<Vec<Coin>, CwEnvError>

Fetch all the balances of an address.

pub fn upload_wasm<T: Uploadable + ContractInstance<CloneTesting>>( &self, contract: &T, ) -> Result<<Self as TxHandler>::Response, CwEnvError>

impl CloneTesting<MockState>

pub fn new(chain: impl Into<ChainInfoOwned>) -> Result<Self, CwEnvError>

Create a mock environment with the default mock state.

pub fn new_with_runtime( rt: &Runtime, chain: impl Into<ChainInfoOwned>, ) -> Result<Self, CwEnvError>

Create a mock environment with the default mock state. It uses a custom runtime object to control async requests

pub fn new_with_deployment_id( rt: &Runtime, chain: impl Into<ChainInfoOwned>, deployment_id: &str, ) -> Result<Self, CwEnvError>

impl<S: StateInterface> CloneTesting<S>

pub fn new_custom( rt: &Runtime, chain: impl Into<ChainInfoOwned>, custom_state: S, ) -> Result<Self, CwEnvError>

Create a mock environment with a custom mock state. The state is customizable by implementing the StateInterface trait on a custom struct and providing it on the custom constructor.

pub fn storage_analysis(&self) -> StorageAnalyzer

Trait Implementations

impl BankSetter for CloneTesting

type T = CloneBankQuerier

fn set_balance( &mut self, address: &Addr, amount: Vec<Coin>, ) -> Result<(), <Self as TxHandler>::Error>

fn add_balance( &mut self, address: &Addr, amount: Vec<Coin>, ) -> Result<(), Self::Error>

impl<S: StateInterface> ChainState for CloneTesting<S>

type Out = Rc<RefCell<S>>

The type of the underlying state.

fn state(&self) -> Self::Out

Get the underlying state.

fn can_load_state_from_state_file(&self) -> bool

Returns wether this environment can load state from the state file.

impl<S: Clone + StateInterface> Clone for CloneTesting<S>

fn clone(&self) -> CloneTesting<S>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl DefaultQueriers for CloneTesting

type Bank = CloneBankQuerier

type Wasm = CloneWasmQuerier<MockState>

type Node = CloneNodeQuerier

fn bank_querier(&self) -> Self::Bank

fn wasm_querier(&self) -> Self::Wasm

fn node_querier(&self) -> Self::Node

impl EnvironmentQuerier for CloneTesting

fn env_info(&self) -> EnvironmentInfo

Get some details about the environment.

impl<S: StateInterface> QuerierGetter<CloneBankQuerier> for CloneTesting<S>

fn querier(&self) -> CloneBankQuerier

impl<S: StateInterface> QuerierGetter<CloneNodeQuerier> for CloneTesting<S>

fn querier(&self) -> CloneNodeQuerier

impl<S: StateInterface> QuerierGetter<CloneWasmQuerier<S>> for CloneTesting<S>

fn querier(&self) -> CloneWasmQuerier<S>

impl QueryHandler for CloneTesting

type Error = CwEnvError

fn wait_blocks(&self, amount: u64) -> Result<(), CwEnvError>

Wait for an amount of blocks.

fn wait_seconds(&self, secs: u64) -> Result<(), CwEnvError>

Wait for an amount of seconds.

fn next_block(&self) -> Result<(), CwEnvError>

Wait for next block.

fn block_info(&self) -> Result<BlockInfo, <Self::Node as Querier>::Error>

Return current block info see BlockInfo.

fn balance( &self, address: &Addr, denom: Option<String>, ) -> Result<Vec<Coin>, <Self::Bank as Querier>::Error>

fn query<Q, T>( &self, query_msg: &Q, contract_address: &Addr, ) -> Result<T, <Self::Wasm as Querier>::Error>

where Q: Serialize + Debug, T: DeserializeOwned,

Send a QueryMsg to a contract.

impl<S: StateInterface> TxHandler for CloneTesting<S>

type Response = AppResponse

Response type for transactions on an environment.

type Error = CwEnvError

Error type for transactions on an environment.

type ContractSource = Box<dyn Contract<Empty>>

Source type for uploading to the environment.

type Sender = Addr

fn sender(&self) -> &Addr

Get a read-only Sender

fn sender_addr(&self) -> Addr

Gets the address of the current wallet used to sign transactions.

fn set_sender(&mut self, sender: Self::Sender)

Sets wallet to sign transactions.

fn upload<T: Uploadable>( &self, _contract: &T, ) -> Result<Self::Response, CwEnvError>

Uploads a contract to the chain.

fn upload_with_access_config<T: Uploadable>( &self, contract_source: &T, _access_config: Option<AccessConfig>, ) -> Result<Self::Response, Self::Error>

Uploads a contract to the chain and specify the permissions for instantiating

fn execute<E: Serialize + Debug>( &self, exec_msg: &E, coins: &[Coin], contract_address: &Addr, ) -> Result<Self::Response, CwEnvError>

Send a ExecMsg to a contract.

fn instantiate<I: Serialize + Debug>( &self, code_id: u64, init_msg: &I, label: Option<&str>, admin: Option<&Addr>, coins: &[Coin], ) -> Result<Self::Response, CwEnvError>

Send a InstantiateMsg to a contract.

fn migrate<M: Serialize + Debug>( &self, migrate_msg: &M, new_code_id: u64, contract_address: &Addr, ) -> Result<Self::Response, CwEnvError>

Send a MigrateMsg to a contract.

fn instantiate2<I: Serialize + Debug>( &self, code_id: u64, init_msg: &I, label: Option<&str>, admin: Option<&Addr>, coins: &[Coin], salt: Binary, ) -> Result<Self::Response, Self::Error>

Send a Instantiate2Msg to a contract.

fn bank_send( &self, receiver: &Addr, amount: &[Coin], ) -> Result<Self::Response, Self::Error>

fn call_as(&self, sender: &Self::Sender) -> Self

Clones the chain with a different sender. Usually used to call a contract as a different sender.

impl<T> WasmUpload<CloneTesting> for T

where T: Uploadable + ContractInstance<CloneTesting>,

fn upload_wasm( &self, ) -> Result<<CloneTesting as TxHandler>::Response, CwEnvError>