io.github.alleriawindrunner.sdk.v3.contract

类 Contract

java.lang.Object

io.github.alleriawindrunner.sdk.v3.contract.Contract

直接已知子类:

AccountManager, BFSPrecompiled, Committee, CommitteeManager, ConsensusPrecompiled, ContractAuthPrecompiled, KVTablePrecompiled, ProposalManager, SystemConfigPrecompiled, TableManagerPrecompiled, TablePrecompiled

public class Contract
extends java.lang.Object

Contract help manage all operations including deploy, send transaction, call contract, and subscribe event of one specific contract. It is inherited by precompiled contracts and contract java wrappers.

嵌套类概要

嵌套类

限定符和类型	类和说明
static class	Contract.EventValuesWithLog Adds a log field to EventValues.

字段概要

字段

限定符和类型	字段和说明
protected Client	client
protected java.lang.String	contractAddress
protected java.lang.String	contractBinary
protected CryptoKeyPair	credential
protected CryptoSuite	cryptoSuite
protected TransactionReceipt	deployReceipt
protected EventEncoder	eventEncoder
static java.lang.String	FUNC_DEPLOY
protected FunctionEncoderInterface	functionEncoder
protected FunctionReturnDecoderInterface	functionReturnDecoder
protected static org.slf4j.Logger	logger
protected TransactionProcessor	transactionProcessor

构造器概要

构造器

限定符	构造器和说明
protected	Contract(java.lang.String contractBinary, java.lang.String contractAddress, Client client, CryptoKeyPair credential) Constructor, auto create a TransactionProcessor object
protected	Contract(java.lang.String contractBinary, java.lang.String contractAddress, Client client, CryptoKeyPair credential, TransactionProcessor transactionProcessor) Constructor

方法概要

限定符和类型	方法和说明
protected java.lang.String	asyncExecuteTransaction(byte[] data, java.lang.String funName, TransactionCallback callback, int dagAttribute)
protected java.lang.String	asyncExecuteTransaction(Function function, TransactionCallback callback)
static <S extends Type,T> java.util.List<T>	convertToNative(java.util.List<S> arr)
protected java.lang.String	createSignedTransaction(Function function)
protected static <T extends Contract> T	deploy(java.lang.Class<T> type, Client client, CryptoKeyPair credential, java.lang.String binary, java.lang.String abi, byte[] encodedConstructor, java.lang.String path) Deploy contract
protected java.util.List<Type>	executeCallWithMultipleValueReturn(Function function)
protected <T extends Type,R> R	executeCallWithSingleValueReturn(Function function, java.lang.Class<R> returnType)
protected TransactionReceipt	executeDeployTransaction(byte[] data, java.lang.String abi)
protected TransactionReceipt	executeTransaction(Function function)
protected EventValues	extractEventParameters(Event event, TransactionReceipt.Logs log)
protected java.util.List<EventValues>	extractEventParameters(Event event, TransactionReceipt transactionReceipt)
protected java.util.List<Contract.EventValuesWithLog>	extractEventParametersWithLog(Event event, java.util.List<TransactionReceipt.Logs> logs)
protected Contract.EventValuesWithLog	extractEventParametersWithLog(Event event, TransactionReceipt.Logs log)
protected java.util.List<Contract.EventValuesWithLog>	extractEventParametersWithLog(Event event, TransactionReceipt transactionReceipt)
protected int	generateTxAttributeWithDagFlag(java.lang.String functionName, int dagAttribute)
java.lang.String	getContractAddress()
java.lang.String	getCurrentExternalAccountAddress()
TransactionReceipt	getDeployReceipt()
TransactionProcessor	getTransactionProcessor()
boolean	isEnableDAG()
void	setContractAddress(java.lang.String contractAddress)
void	setDeployReceipt(TransactionReceipt deployReceipt)
void	setEnableDAG(boolean enableDAG)
static EventValues	staticExtractEventParameters(EventEncoder eventEncoder, FunctionReturnDecoderInterface functionReturnDecoder, Event event, TransactionReceipt.Logs log)

从类继承的方法 java.lang.Object

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

字段详细资料

logger

protected static org.slf4j.Logger logger

contractBinary

protected final java.lang.String contractBinary

contractAddress

protected java.lang.String contractAddress

deployReceipt

protected TransactionReceipt deployReceipt

transactionProcessor

protected final TransactionProcessor transactionProcessor

client

protected final Client client

FUNC_DEPLOY

public static final java.lang.String FUNC_DEPLOY

另请参阅:

常量字段值

functionEncoder

protected final FunctionEncoderInterface functionEncoder

functionReturnDecoder

protected final FunctionReturnDecoderInterface functionReturnDecoder

credential

protected final CryptoKeyPair credential

cryptoSuite

protected final CryptoSuite cryptoSuite

eventEncoder

protected final EventEncoder eventEncoder

构造器详细资料

Contract

protected Contract(java.lang.String contractBinary,
                   java.lang.String contractAddress,
                   Client client,
                   CryptoKeyPair credential,
                   TransactionProcessor transactionProcessor)

Constructor

参数:

contractBinary - the contract binary code hex string

contractAddress - the contract address

client - a Client object

credential - key pair to use when sign transaction

transactionProcessor - TransactionProcessor object

Contract

protected Contract(java.lang.String contractBinary,
                   java.lang.String contractAddress,
                   Client client,
                   CryptoKeyPair credential)

Constructor, auto create a TransactionProcessor object

参数:

contractBinary - the contract binary code hex string

contractAddress - the contract address

client - a Client object to send requests

credential - key pair to use when sign transaction

方法详细资料

getContractAddress

public java.lang.String getContractAddress()

setContractAddress

public void setContractAddress(java.lang.String contractAddress)

getDeployReceipt

public TransactionReceipt getDeployReceipt()

setDeployReceipt

public void setDeployReceipt(TransactionReceipt deployReceipt)

getTransactionProcessor

public TransactionProcessor getTransactionProcessor()

getCurrentExternalAccountAddress

public java.lang.String getCurrentExternalAccountAddress()

isEnableDAG

public boolean isEnableDAG()

setEnableDAG

public void setEnableDAG(boolean enableDAG)

deploy

protected static <T extends Contract> T deploy(java.lang.Class<T> type,
                                               Client client,
                                               CryptoKeyPair credential,
                                               java.lang.String binary,
                                               java.lang.String abi,
                                               byte[] encodedConstructor,
                                               java.lang.String path)
                                        throws ContractException

Deploy contract

类型参数:

T - a smart contract object extends Contract

参数:

type - class type

client - a Client object to send requests

credential - key pair to use when sign transaction

abi - ABI json string

binary - the contract binary code hex string

encodedConstructor - constructor params

path - bfs path, this param only use in wasm vm

返回:

T type smart contract

抛出:

ContractException - throws when deploy failed

executeCallWithSingleValueReturn

protected <T extends Type,R> R executeCallWithSingleValueReturn(Function function,
                                                                java.lang.Class<R> returnType)
                                                         throws ContractException

抛出:

ContractException

executeCallWithMultipleValueReturn

protected java.util.List<Type> executeCallWithMultipleValueReturn(Function function)
                                                           throws ContractException

抛出:

ContractException

generateTxAttributeWithDagFlag

protected int generateTxAttributeWithDagFlag(java.lang.String functionName,
                                             int dagAttribute)

asyncExecuteTransaction

protected java.lang.String asyncExecuteTransaction(byte[] data,
                                                   java.lang.String funName,
                                                   TransactionCallback callback,
                                                   int dagAttribute)

asyncExecuteTransaction

protected java.lang.String asyncExecuteTransaction(Function function,
                                                   TransactionCallback callback)

executeTransaction

protected TransactionReceipt executeTransaction(Function function)

executeDeployTransaction

protected TransactionReceipt executeDeployTransaction(byte[] data,
                                                      java.lang.String abi)

createSignedTransaction

protected java.lang.String createSignedTransaction(Function function)

staticExtractEventParameters

public static EventValues staticExtractEventParameters(EventEncoder eventEncoder,
                                                       FunctionReturnDecoderInterface functionReturnDecoder,
                                                       Event event,
                                                       TransactionReceipt.Logs log)

extractEventParameters

protected EventValues extractEventParameters(Event event,
                                             TransactionReceipt.Logs log)

extractEventParameters

protected java.util.List<EventValues> extractEventParameters(Event event,
                                                             TransactionReceipt transactionReceipt)

extractEventParametersWithLog

protected Contract.EventValuesWithLog extractEventParametersWithLog(Event event,
                                                                    TransactionReceipt.Logs log)

extractEventParametersWithLog

protected java.util.List<Contract.EventValuesWithLog> extractEventParametersWithLog(Event event,
                                                                                    TransactionReceipt transactionReceipt)

extractEventParametersWithLog

protected java.util.List<Contract.EventValuesWithLog> extractEventParametersWithLog(Event event,
                                                                                    java.util.List<TransactionReceipt.Logs> logs)

convertToNative

public static <S extends Type,T> java.util.List<T> convertToNative(java.util.List<S> arr)