Struct Contract__Client 

pub struct Contract__Client<'a> {
    pub env: Env,
    pub address: Address,
    /* private fields */
}

Contract__Client is a client for calling the contract defined in “Contract__”.

Fields

env: Env

address: Address

Implementations

impl<'a> Contract__Client<'a>

pub fn new(env: &Env, address: &Address) -> Self

pub fn set_auths(&self, auths: &'a [SorobanAuthorizationEntry]) -> Self

Set authorizations in the environment which will be consumed by contracts when they invoke Address::require_auth or Address::require_auth_for_args functions.

Requires valid signatures for the authorization to be successful. To mock auth without requiring valid signatures, use mock_auths.

See soroban_sdk::Env::set_auths for more details and examples.

pub fn mock_auths(&self, mock_auths: &'a [MockAuth<'a>]) -> Self

Mock authorizations in the environment which will cause matching invokes of Address::require_auth and Address::require_auth_for_args to pass.

See soroban_sdk::Env::set_auths for more details and examples.

pub fn mock_all_auths(&self) -> Self

Mock all calls to the Address::require_auth and Address::require_auth_for_args functions in invoked contracts, having them succeed as if authorization was provided.

See soroban_sdk::Env::mock_all_auths for more details and examples.

pub fn mock_all_auths_allowing_non_root_auth(&self) -> Self

A version of mock_all_auths that allows authorizations that are not present in the root invocation.

Refer to mock_all_auths documentation for details and prefer using mock_all_auths unless non-root authorization is required.

See soroban_sdk::Env::mock_all_auths_allowing_non_root_auth for more details and examples.

impl<'a> Contract__Client<'a>

pub fn owner_get(&self) -> Option<Address>

Returns the owner of the contract

pub fn try_owner_get( &self, ) -> Result<Result<Option<Address>, <Option<Address> as TryFromVal<Env, Val>>::Error>, Result<Error, InvokeError>>

Returns the owner of the contract

pub fn owner_set(&self, new_owner: &Address)

Sets the owner of the contract. If one already set it transfers it to the new owner, if signed by owner.

pub fn try_owner_set( &self, new_owner: &Address, ) -> Result<Result<(), <() as TryFromVal<Env, Val>>::Error>, Result<Error, InvokeError>>

Sets the owner of the contract. If one already set it transfers it to the new owner, if signed by owner.

pub fn redeploy(&self, wasm_hash: &BytesN<32>)

Redeploy the contract to a Wasm hash

pub fn try_redeploy( &self, wasm_hash: &BytesN<32>, ) -> Result<Result<(), <() as TryFromVal<Env, Val>>::Error>, Result<Error, InvokeError>>

Redeploy the contract to a Wasm hash