hera.client

Class ContractTemplate

java.lang.Object

hera.client.ContractTemplate

All Implemented Interfaces:

ContractOperation, ChannelInjectable, ContextProviderInjectable

@ApiAudience.Private
 @ApiStability.Unstable
public class ContractTemplate
extends java.lang.Object
implements ContractOperation, ChannelInjectable, ContextProviderInjectable

Field Summary

Fields

Modifier and Type	Field and Description
protected ContextProvider	contextProvider
protected ContractBaseTemplate	contractBaseTemplate
protected ExceptionConverter<RpcException>	exceptionConverter

Constructor Summary

Constructors

Constructor and Description
ContractTemplate()

Method Summary

Modifier and Type	Method and Description
ContractTxHash	deploy(Account creator, ContractDefinition contractDefinition, long nonce) Use ContractOperation.deploy(Signer, ContractDefinition, long, Fee) instead.
ContractTxHash	deploy(Account creator, ContractDefinition contractDefinition, long nonce, Fee fee) Use ContractOperation.deploy(Signer, ContractDefinition, long, Fee) instead.
ContractTxHash	deploy(Signer signer, ContractDefinition contractDefinition, long nonce, Fee fee) Deploy smart contract.
ContractTxHash	execute(Account executor, ContractInvocation contractInvocation, long nonce) Use ContractOperation.execute(Signer, ContractInvocation, long, Fee) instead.
ContractTxHash	execute(Account executor, ContractInvocation contractInvocation, long nonce, Fee fee) Use ContractOperation.execute(Signer, ContractInvocation, long, Fee) instead.
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.
void	setChannel(io.grpc.ManagedChannel channel)
void	setContextProvider(ContextProvider contextProvider)
Subscription<Event>	subscribeEvent(EventFilter filter, StreamObserver<Event> observer) Subscribe event corresponding to an event filter.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

exceptionConverter

protected final ExceptionConverter<RpcException> exceptionConverter

contractBaseTemplate

protected ContractBaseTemplate contractBaseTemplate

contextProvider

protected ContextProvider contextProvider

Constructor Detail

ContractTemplate

public ContractTemplate()

Method Detail

setChannel

public void setChannel(io.grpc.ManagedChannel channel)

Specified by:

setChannel in interface ChannelInjectable

setContextProvider

public void setContextProvider(ContextProvider contextProvider)

Specified by:

setContextProvider in interface ContextProviderInjectable

getReceipt

public ContractTxReceipt getReceipt(ContractTxHash contractTxHash)

Description copied from interface: ContractOperation

Get receipt of transaction.

Specified by:

getReceipt in interface ContractOperation

Parameters:

contractTxHash - contract transaction hash

Returns:

receipt of transaction

deploy

public ContractTxHash deploy(Account creator,
                             ContractDefinition contractDefinition,
                             long nonce)

Description copied from interface: ContractOperation

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

Specified by:

deploy in interface ContractOperation

Parameters:

creator - an creator account

contractDefinition - contract definition

nonce - an nonce used in making transaction

Returns:

contract definition transaction hash

deploy

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

Description copied from interface: ContractOperation

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

Specified by:

deploy in interface ContractOperation

Parameters:

creator - an creator account

contractDefinition - contract definition

nonce - an nonce used in making transaction

fee - transaction fee

Returns:

contract definition transaction hash

deploy

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

Description copied from interface: ContractOperation

Deploy smart contract.

Specified by:

deploy in interface ContractOperation

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

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

Description copied from interface: ContractOperation

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

Specified by:

redeploy in interface ContractOperation

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

public ContractInterface getContractInterface(ContractAddress contractAddress)

Description copied from interface: ContractOperation

Get smart contract interface corresponding to contract address.

Specified by:

getContractInterface in interface ContractOperation

Parameters:

contractAddress - contract address

Returns:

contract interface

execute

public ContractTxHash execute(Account executor,
                              ContractInvocation contractInvocation,
                              long nonce)

Description copied from interface: ContractOperation

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

Specified by:

execute in interface ContractOperation

Parameters:

executor - an executor account

contractInvocation - ContractInvocation

nonce - an nonce used in making transaction

Returns:

contract execution transaction hash

execute

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

Description copied from interface: ContractOperation

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

Specified by:

execute in interface ContractOperation

Parameters:

executor - an executor account

contractInvocation - ContractInvocation

nonce - an nonce used in making transaction

fee - transaction fee

Returns:

contract execution transaction hash

execute

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

Description copied from interface: ContractOperation

Execute the smart contract.

Specified by:

execute in interface ContractOperation

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

public ContractResult query(ContractInvocation contractInvocation)

Description copied from interface: ContractOperation

Query the smart contract state by calling smart contract function.

Specified by:

query in interface ContractOperation

Parameters:

contractInvocation - ContractInvocation

Returns:

contract result

listEvents

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

Description copied from interface: ContractOperation

List events corresponding to an event filter.

Specified by:

listEvents in interface ContractOperation

Parameters:

filter - an event filter

Returns:

event list

subscribeEvent

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

Description copied from interface: ContractOperation

Subscribe event corresponding to an event filter.

Specified by:

subscribeEvent in interface ContractOperation

Parameters:

filter - an event filter

observer - a stream observer which is invoked on event

Returns:

a subscription