Struct ethcontract::contract::Instance

pub struct Instance<T: Transport> {
    pub defaults: MethodDefaults,
    /* private fields */
}

Represents a contract instance at an address. Provides methods for contract interaction.

Fields

defaults: MethodDefaults

Default method parameters to use when sending method transactions or querying method calls.

Implementations

impl<T: Transport> Instance<T>

pub fn at(web3: Web3<T>, abi: Abi, address: Address) -> Self

Creates a new contract instance with the specified web3 provider with the given Abi at the given Address.

Note that this does not verify that a contract with a matching Abi is actually deployed at the given address.

pub fn with_deployment_info(
    web3: Web3<T>,
    abi: Abi,
    address: Address,
    deployment_information: Option<DeploymentInformation>
) -> Self

Creates a new contract instance with the specified web3 provider with the given Abi at the given Address and an optional transaction hash. This hash is used to retrieve contract related information such as the creation block (which is useful for fetching all historic events).

Note that this does not verify that a contract with a matching Abi is actually deployed at the given address nor that the transaction hash, when provided, is actually for this contract deployment.

pub async fn deployed(
    web3: Web3<T>,
    contract: Contract
) -> Result<Self, DeployError>

Locates a deployed contract based on the current network ID reported by the web3 provider from the given Contract’s ABI and networks.

Note that this does not verify that a contract with a matching Abi is actually deployed at the given address.

pub fn builder<P>(
    web3: Web3<T>,
    contract: Contract,
    params: P
) -> Result<DeployBuilder<T, Self>, DeployError>where
    P: Tokenize,

Creates a contract builder with the specified web3 provider and the given Contract byte code. This allows the contract deployment transaction to be configured before deploying the contract.

pub fn link_and_deploy<'a, P, I>(
    web3: Web3<T>,
    contract: Contract,
    params: P,
    libraries: I
) -> Result<DeployBuilder<T, Self>, DeployError>where
    P: Tokenize,
    I: Iterator<Item = (&'a str, Address)>,

Deploys a contract with the specified web3 provider with the given Contract byte code and linking libraries.

pub fn web3(&self) -> Web3<T>

Retrieve the underlying web3 provider used by this contract instance.

pub fn abi(&self) -> &Abi

Retrieves the contract ABI for this instance.

pub fn address(&self) -> Address

Returns the contract address being used by this instance.

pub fn deployment_information(&self) -> Option<DeploymentInformation>

Returns the hash for the transaction that deployed the contract if it is known, None otherwise.

pub fn method<P, R>(
    &self,
    signature: impl Into<Signature<P, R>>,
    params: P
) -> AbiResult<MethodBuilder<T, R>>where
    P: Tokenize,
    R: Tokenize,

Returns a method builder to setup a call or transaction on a smart contract method. Note that calls just get evaluated on a node but do not actually commit anything to the block chain.

pub fn view_method<P, R>(
    &self,
    signature: impl Into<Signature<P, R>>,
    params: P
) -> AbiResult<ViewMethodBuilder<T, R>>where
    P: Tokenize,
    R: Tokenize,

Returns a view method builder to setup a call to a smart contract. View method builders can’t actually send transactions and only query contract state.

pub fn fallback<D>(&self, data: D) -> AbiResult<MethodBuilder<T, ()>>where
    D: Into<Vec<u8>>,

Returns a method builder to setup a call to a smart contract’s fallback function.

This method will error if the ABI does not contain an entry for a fallback function.

pub fn event<E>(&self, signature: H256) -> AbiResult<EventBuilder<T, E>>where
    E: Tokenize,

Returns a event builder to setup an event stream for a smart contract that emits events for the specified Solidity event by name.

pub fn all_events(&self) -> AllEventsBuilder<T, RawLog>

Returns a log stream that emits a log for every new event emitted after the stream was created for this contract instance.

Trait Implementations

impl<T: Clone + Transport> Clone for Instance<T>

fn clone(&self) -> Instance<T>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T: Debug + Transport> Debug for Instance<T>

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

Formats the value using the given formatter.

impl<T: Transport> Deploy<T> for Instance<T>

type Context = Linker

The type of the contract instance being created.

fn abi(cx: &Self::Context) -> &Abi

Gets a reference the contract ABI.

fn bytecode(cx: &Self::Context) -> &Bytecode

Gets a reference to the contract bytecode.

fn from_deployment(
    web3: Web3<T>,
    address: Address,
    transaction_hash: H256,
    cx: Self::Context
) -> Self

Create a contract instance from the specified deployment.