Struct boot_core::Contract

pub struct Contract<Chain: BootEnvironment> {
    pub id: String,
    /* private fields */
}

An instance of a contract. Contains references to the execution environment (chain) and a local state (state) The state is used to store contract addresses/code-ids

Fields

id: String

ID of the contract, used to retrieve addr/code-id

Implementations

impl<Chain: BootEnvironment + Clone> Contract<Chain>

Expose chain and state function to call them on the contract

pub fn new(id: impl ToString, chain: Chain) -> Self

pub fn get_chain(&self) -> &Chain

get_chain instead of chain to disambiguate from the std prelude .chain() method.

pub fn with_wasm_path(self, path: impl ToString) -> Self

pub fn with_mock(
    self,
    mock_contract: Box<dyn TestContract<Empty, Empty>>
) -> Self

pub fn set_mock(&mut self, mock_contract: Box<dyn TestContract<Empty, Empty>>)

pub fn with_address(self, address: Option<&Addr>) -> Self

Sets the address of the contract in the local state

pub fn execute<E: Serialize + Debug>(
    &self,
    msg: &E,
    coins: Option<&[Coin]>
) -> Result<TxResponse<Chain>, BootError>

pub fn instantiate<I: Serialize + Debug>(
    &self,
    msg: &I,
    admin: Option<&Addr>,
    coins: Option<&[Coin]>
) -> Result<TxResponse<Chain>, BootError>

pub fn upload(&mut self) -> Result<TxResponse<Chain>, BootError>

pub fn query<Q: Serialize + Debug, T: Serialize + DeserializeOwned + Debug>(
    &self,
    query_msg: &Q
) -> Result<T, BootError>

pub fn migrate<M: Serialize + Debug>(
    &self,
    migrate_msg: &M,
    new_code_id: u64
) -> Result<TxResponse<Chain>, BootError>

pub fn address(&self) -> Result<Addr, BootError>

pub fn code_id(&self) -> Result<u64, BootError>

pub fn set_address(&self, address: &Addr)

pub fn set_code_id(&self, code_id: u64)

impl Contract<Daemon>

pub fn upload_if_needed(
    &mut self
) -> Result<Option<TxResponse<Daemon>>, BootError>

Only upload the contract if it is not uploaded yet (checksum does not match) @TODO proper response

pub fn latest_is_uploaded(&self) -> Result<bool, BootError>

Returns a bool whether the checksum of the wasm file matches the checksum of the previously uploaded code

pub fn migrate_if_needed(
    &mut self,
    migrate_msg: &impl Serialize + Debug
) -> Result<Option<TxResponse<Daemon>>, BootError>

Only migrate the contract if it is not on the latest code-id yet

pub fn is_running_latest(&self) -> Result<bool, BootError>

Returns a bool whether the contract is running the latest uploaded code for it

impl Contract<Mock>

pub fn set_sender(&mut self, sender: Addr) -> &mut Self

Trait Implementations

impl<Chain: Clone + BootEnvironment> Clone for Contract<Chain>

fn clone(&self) -> Contract<Chain>

Returns a copy of the value.

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

Performs copy-assignment from source.