Struct SafeContractInstance

pub struct SafeContractInstance<P, N = Ethereum> { /* private fields */ }

A SafeContract instance.

Contains type-safe methods for interacting with an on-chain instance of the SafeContract contract located at a given address, using a given provider P.

If the contract bytecode is available (see the sol! documentation on how to provide it), the deploy and deploy_builder methods can be used to deploy a new instance of the contract.

See the module-level documentation for all the available methods.

Implementations

impl<P: Provider<N>, N: Network> SafeContractInstance<P, N>

Instantiation and getters/setters.

pub const fn new(address: Address, provider: P) -> Self

Creates a new wrapper around an on-chain SafeContract contract instance.

See the wrapper’s documentation for more details.

pub const fn address(&self) -> &Address

Returns a reference to the address.

pub fn set_address(&mut self, address: Address)

Sets the address.

pub fn at(self, address: Address) -> Self

Sets the address and returns self.

pub const fn provider(&self) -> &P

Returns a reference to the provider.

impl<P: Clone, N> SafeContractInstance<&P, N>

pub fn with_cloned_provider(self) -> SafeContractInstance<P, N>

Clones the provider and returns a new instance with the cloned provider.

impl<P: Provider<N>, N: Network> SafeContractInstance<P, N>

Function calls.

pub fn call_builder<C: SolCall>(&self, call: &C) -> SolCallBuilder<&P, C, N>

Creates a new call builder using this contract instance’s provider and address.

Note that the call can be any function call, not just those defined in this contract. Prefer using the other methods for building type-safe contract calls.

pub fn nonce(&self) -> SolCallBuilder<&P, nonceCall, N>

Creates a new call builder for the [nonce] function.

pub fn getTransactionHash( &self, to: Address, value: U256, data: Bytes, operation: u8, safeTxGas: U256, baseGas: U256, gasPrice: U256, gasToken: Address, refundReceiver: Address, _nonce: U256, ) -> SolCallBuilder<&P, getTransactionHashCall, N>

Creates a new call builder for the [getTransactionHash] function.

pub fn execTransaction( &self, to: Address, value: U256, data: Bytes, operation: u8, safeTxGas: U256, baseGas: U256, gasPrice: U256, gasToken: Address, refundReceiver: Address, signatures: Bytes, ) -> SolCallBuilder<&P, execTransactionCall, N>

Creates a new call builder for the [execTransaction] function.

impl<P: Provider<N>, N: Network> SafeContractInstance<P, N>

Event filters.

pub fn event_filter<E: SolEvent>(&self) -> Event<&P, E, N>

Creates a new event filter using this contract instance’s provider and address.

Note that the type can be any event, not just those defined in this contract. Prefer using the other methods for building type-safe event filters.

Trait Implementations

impl<P: Clone, N: Clone> Clone for SafeContractInstance<P, N>

fn clone(&self) -> SafeContractInstance<P, N>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<P, N> Debug for SafeContractInstance<P, N>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.