hera.api

Interface ContractOperation

All Known Implementing Classes:

ContractTemplate

@ApiAudience.Public
 @ApiStability.Unstable
public interface ContractOperation

Provide contract related operations. It provides followings:

• lookup contract transaction receipt
• getting already deployed contract interface
• deploying / executing / querying contract
• contract event related operations

Method Summary

Modifier and Type	Method and Description
ContractTxHash	deploy(Account creator, ContractDefinition contractDefinition, long nonce) Deprecated.
ContractTxHash	deploy(Account creator, ContractDefinition contractDefinition, long nonce, Fee fee) Deprecated.
ContractTxHash	deploy(Signer signer, ContractDefinition contractDefinition, long nonce, Fee fee) Deploy smart contract.
ContractTxHash	execute(Account executor, ContractInvocation contractInvocation, long nonce) Deprecated.
ContractTxHash	execute(Account executor, ContractInvocation contractInvocation, long nonce, Fee fee) Deprecated.
ContractTxHash	execute(Signer signer, ContractInvocation contractInvocation, long nonce, Fee fee) Execute the smart contract.
ContractInterface	getContractInterface(ContractAddress contractAddress) Get smart contract interface corresponding to contract address.
ContractTxReceipt	getReceipt(ContractTxHash contractTxHash) Get receipt of transaction.
java.util.List<Event>	listEvents(EventFilter filter) List events corresponding to an event filter.
ContractResult	query(ContractInvocation contractInvocation) Query the smart contract state by calling smart contract function.
ContractTxHash	redeploy(Signer signer, ContractAddress existingContract, ContractDefinition contractDefinition, long nonce, Fee fee) Re-deploy smart contract.
Subscription<Event>	subscribeEvent(EventFilter filter, StreamObserver<Event> observer) Subscribe event corresponding to an event filter.

Method Detail

getReceipt

ContractTxReceipt getReceipt(ContractTxHash contractTxHash)

Get receipt of transaction.

Parameters:

contractTxHash - contract transaction hash

Returns:

receipt of transaction

deploy

@Deprecated
ContractTxHash deploy(Account creator,
                                  ContractDefinition contractDefinition,
                                  long nonce)

Deprecated.

Use deploy(Signer, ContractDefinition, long, Fee) instead.

Parameters:

creator - an creator account

contractDefinition - contract definition

nonce - an nonce used in making transaction

Returns:

contract definition transaction hash

deploy

@Deprecated
ContractTxHash deploy(Account creator,
                                  ContractDefinition contractDefinition,
                                  long nonce,
                                  Fee fee)

Deprecated.

Use deploy(Signer, ContractDefinition, long, Fee) instead.

Parameters:

creator - an creator account

contractDefinition - contract definition

nonce - an nonce used in making transaction

fee - transaction fee

Returns:

contract definition transaction hash

deploy

ContractTxHash deploy(Signer signer,
                      ContractDefinition contractDefinition,
                      long nonce,
                      Fee fee)

Deploy smart contract.

Parameters:

signer - a signer whose principal is smart contract creator.

contractDefinition - a contract definition

nonce - an nonce used in making transaction

fee - a transaction fee

Returns:

contract definition transaction hash

redeploy

ContractTxHash redeploy(Signer signer,
                        ContractAddress existingContract,
                        ContractDefinition contractDefinition,
                        long nonce,
                        Fee fee)

Re-deploy smart contract. A principal of signer must be creator and contractAddress must be existing one.

Parameters:

signer - a signer whose principal is smart contract creator.

existingContract - an existing contract address

contractDefinition - contract definition to re-deploy

nonce - an nonce used in making transaction

fee - a transaction fee

Returns:

contract definition transaction hash

getContractInterface

ContractInterface getContractInterface(ContractAddress contractAddress)

Get smart contract interface corresponding to contract address.

Parameters:

contractAddress - contract address

Returns:

contract interface

execute

@Deprecated
ContractTxHash execute(Account executor,
                                   ContractInvocation contractInvocation,
                                   long nonce)

Deprecated.

Use execute(Signer, ContractInvocation, long, Fee) instead.

Parameters:

executor - an executor account

contractInvocation - ContractInvocation

nonce - an nonce used in making transaction

Returns:

contract execution transaction hash

execute

@Deprecated
ContractTxHash execute(Account executor,
                                   ContractInvocation contractInvocation,
                                   long nonce,
                                   Fee fee)

Deprecated.

Use execute(Signer, ContractInvocation, long, Fee) instead.

Parameters:

executor - an executor account

contractInvocation - ContractInvocation

nonce - an nonce used in making transaction

fee - transaction fee

Returns:

contract execution transaction hash

execute

ContractTxHash execute(Signer signer,
                       ContractInvocation contractInvocation,
                       long nonce,
                       Fee fee)

Execute the smart contract.

Parameters:

signer - a signer which will execute smart contract.

contractInvocation - ContractInvocation

nonce - an nonce used in making transaction

fee - transaction fee

Returns:

contract execution transaction hash

query

ContractResult query(ContractInvocation contractInvocation)

Query the smart contract state by calling smart contract function.

Parameters:

contractInvocation - ContractInvocation

Returns:

contract result

listEvents

java.util.List<Event> listEvents(EventFilter filter)

List events corresponding to an event filter.

Parameters:

filter - an event filter

Returns:

event list

subscribeEvent

Subscription<Event> subscribeEvent(EventFilter filter,
                                   StreamObserver<Event> observer)

Subscribe event corresponding to an event filter.

Parameters:

filter - an event filter

observer - a stream observer which is invoked on event

Returns:

a subscription