org.fisco.bcos.sdk.v3.contract

类 Contract

java.lang.Object

org.fisco.bcos.sdk.v3.contract.Contract

直接已知子类:

AccountManager, BalancePrecompiled, BFSPrecompiled, Committee, CommitteeManager, ConsensusPrecompiled, ContractAuthPrecompiled, KVTablePrecompiled, ProposalManager, ShardingPrecompiled, 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
EventEncoder	eventEncoder
EventSubscribe	eventSubscribe
static java.lang.String	FUNC_DEPLOY
FunctionEncoderInterface	functionEncoder
FunctionReturnDecoderInterface	functionReturnDecoder
protected static org.slf4j.Logger	logger
protected TransactionManager	transactionManager
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	Contract(java.lang.String contractBinary, java.lang.String contractAddress, Client client, TransactionManager transactionManager)

方法概要

限定符和类型	方法和说明
protected void	asyncExecuteCall(Function function, CallCallback callback)
protected void	asyncExecuteCallByTransactionManager(Function function, CallCallback callback)
protected java.lang.String	asyncExecuteTransaction(byte[] data, java.lang.String funName, TransactionCallback callback, int dagAttribute)
protected java.lang.String	asyncExecuteTransaction(byte[] data, java.lang.String funName, TransactionCallback callback, int dagAttribute, java.math.BigInteger value)
protected java.lang.String	asyncExecuteTransaction(Function function, TransactionCallback callback)
protected java.lang.String	asyncExecuteTransaction(FunctionWrapper functionWrapper, 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 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, java.math.BigInteger value)
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	executeDeployTransaction(byte[] data, java.lang.String abi, java.math.BigInteger value)
protected TransactionReceipt	executeTransaction(Function function)
protected TransactionReceipt	executeTransaction(FunctionWrapper functionWrapper)
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)
void	setTransactionManager(TransactionManager transactionManager)
void	setTransactionProcessor(TransactionProcessor transactionProcessor)
static EventValues	staticExtractEventParameters(EventEncoder eventEncoder, FunctionReturnDecoderInterface functionReturnDecoder, Event event, TransactionReceipt.Logs log)
java.lang.String	subscribeEvent(java.math.BigInteger fromBlock, java.math.BigInteger toBlock, java.util.List<java.util.List<java.lang.String>> topics, EventSubCallback callback)
java.lang.String	subscribeEvent(EventSubParams params, EventSubCallback callback)
java.lang.String	subscribeEvent(java.lang.String topic0, java.math.BigInteger fromBlock, java.math.BigInteger toBlock, EventSubCallback callback)
java.lang.String	subscribeEvent(java.lang.String topic0, EventSubCallback callback)
java.lang.String	subscribeEvent(java.lang.String topic0, java.util.List<java.lang.String> otherTopics, java.math.BigInteger fromBlock, java.math.BigInteger toBlock, EventSubCallback callback)
void	unsubscribeEvent(java.lang.String eventId)

从类继承的方法 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 TransactionProcessor transactionProcessor

transactionManager

protected TransactionManager transactionManager

client

protected final Client client

FUNC_DEPLOY

public static final java.lang.String FUNC_DEPLOY

另请参阅:

常量字段值

functionEncoder

public final FunctionEncoderInterface functionEncoder

functionReturnDecoder

public final FunctionReturnDecoderInterface functionReturnDecoder

credential

protected final CryptoKeyPair credential

cryptoSuite

protected final CryptoSuite cryptoSuite

eventEncoder

public final EventEncoder eventEncoder

eventSubscribe

public final EventSubscribe eventSubscribe

构造器详细资料

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

Contract

protected Contract(java.lang.String contractBinary,
                   java.lang.String contractAddress,
                   Client client,
                   TransactionManager transactionManager)

方法详细资料

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()

setTransactionProcessor

public void setTransactionProcessor(TransactionProcessor transactionProcessor)

getCurrentExternalAccountAddress

public java.lang.String getCurrentExternalAccountAddress()

isEnableDAG

public boolean isEnableDAG()

setEnableDAG

public void setEnableDAG(boolean enableDAG)

setTransactionManager

public void setTransactionManager(TransactionManager transactionManager)

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

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,
                                               java.math.BigInteger value)
                                        throws ContractException

抛出:

ContractException

asyncExecuteCall

protected void asyncExecuteCall(Function function,
                                CallCallback callback)

asyncExecuteCallByTransactionManager

protected void asyncExecuteCallByTransactionManager(Function function,
                                                    CallCallback callback)

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(byte[] data,
                                                   java.lang.String funName,
                                                   TransactionCallback callback,
                                                   int dagAttribute,
                                                   java.math.BigInteger value)

asyncExecuteTransaction

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

asyncExecuteTransaction

protected java.lang.String asyncExecuteTransaction(FunctionWrapper functionWrapper,
                                                   TransactionCallback callback)

executeTransaction

protected TransactionReceipt executeTransaction(Function function)

executeTransaction

protected TransactionReceipt executeTransaction(FunctionWrapper functionWrapper)

executeDeployTransaction

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

executeDeployTransaction

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

createSignedTransaction

protected java.lang.String createSignedTransaction(Function function)

subscribeEvent

public java.lang.String subscribeEvent(EventSubParams params,
                                       EventSubCallback callback)

subscribeEvent

public java.lang.String subscribeEvent(java.lang.String topic0,
                                       EventSubCallback callback)

subscribeEvent

public java.lang.String subscribeEvent(java.lang.String topic0,
                                       java.math.BigInteger fromBlock,
                                       java.math.BigInteger toBlock,
                                       EventSubCallback callback)

subscribeEvent

public java.lang.String subscribeEvent(java.lang.String topic0,
                                       java.util.List<java.lang.String> otherTopics,
                                       java.math.BigInteger fromBlock,
                                       java.math.BigInteger toBlock,
                                       EventSubCallback callback)

subscribeEvent

public java.lang.String subscribeEvent(java.math.BigInteger fromBlock,
                                       java.math.BigInteger toBlock,
                                       java.util.List<java.util.List<java.lang.String>> topics,
                                       EventSubCallback callback)

unsubscribeEvent

public void unsubscribeEvent(java.lang.String eventId)

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)