org.tron.trident.core.contract

Class Contract

java.lang.Object

org.tron.trident.core.contract.Contract

Direct Known Subclasses:

Trc20Contract

public class Contract
extends java.lang.Object

The Contract class is a wrapper for the SmartContract class defined in the .proto file. An object of Contract contains same attributes with the SmartContract class.

This class provides mutator and accessor methods for all attributes. Besides, functions of smart contracts are wrapped and can be easily viewed through ContractFunction.toString()

Since:

jdk 1.8.0_231

See Also:

ContractFunction, Common.SmartContract

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Contract.Builder

Field Summary

Fields

Modifier and Type	Field and Description
protected Common.SmartContract.ABI	abi
protected com.google.protobuf.ByteString	bytecode
protected long	callValue
protected com.google.protobuf.ByteString	cntrAddr
protected com.google.protobuf.ByteString	codeHash
protected ContractConstructor	constructor
protected long	consumeUserResourcePercent
protected java.util.List<ContractFunction>	functions
protected java.lang.String	name
protected com.google.protobuf.ByteString	originAddr
protected long	originEnergyLimit
protected com.google.protobuf.ByteString	ownerAddr
protected com.google.protobuf.ByteString	trxHash
protected int	version
protected ApiWrapper	wrapper

Constructor Summary

Constructors

Constructor and Description
Contract(com.google.protobuf.ByteString cntrAddr, Common.SmartContract.ABI abi, com.google.protobuf.ByteString bytecode, long consumeUserResourcePercent, java.lang.String name, long originEnergyLimit)
Contract(Contract.Builder builder)
Contract(Contract cntr, java.lang.String ownerAddr, ApiWrapper wrapper)

Method Summary

Modifier and Type	Method and Description
protected void	abiToFunctions() Convert abi entries to ContractFunction objects
protected java.util.List<java.lang.String>	collectParams(java.util.List<Common.SmartContract.ABI.Entry.Param> params, char flag)
Contract.CreateSmartContract	createSmartContract(java.util.List<Type<?>> buildParams) create a CreateSmartContract object to get ready for deployment.
TransactionBuilder	deploy()
TransactionBuilder	deploy(java.util.List<Type<?>> buildParams)
static void	loadAbiFromJson(java.lang.String abiString, Common.SmartContract.ABI.Builder builder) load abi from json format string
protected void	loadConstructor() load the constructor from ABI
void	setAbi(java.lang.String abiString)
Common.SmartContract	toProto() build a SmartContract object

Methods inherited from class java.lang.Object

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

Field Detail

wrapper

protected ApiWrapper wrapper

originAddr

protected com.google.protobuf.ByteString originAddr

cntrAddr

protected com.google.protobuf.ByteString cntrAddr

abi

protected Common.SmartContract.ABI abi

bytecode

protected com.google.protobuf.ByteString bytecode

callValue

protected long callValue

consumeUserResourcePercent

protected long consumeUserResourcePercent

name

protected java.lang.String name

originEnergyLimit

protected long originEnergyLimit

codeHash

protected com.google.protobuf.ByteString codeHash

trxHash

protected com.google.protobuf.ByteString trxHash

version

protected int version

ownerAddr

protected com.google.protobuf.ByteString ownerAddr

functions

protected java.util.List<ContractFunction> functions

constructor

protected ContractConstructor constructor

Constructor Detail

Contract

public Contract(Contract cntr,
                java.lang.String ownerAddr,
                ApiWrapper wrapper)

Contract

public Contract(com.google.protobuf.ByteString cntrAddr,
                Common.SmartContract.ABI abi,
                com.google.protobuf.ByteString bytecode,
                long consumeUserResourcePercent,
                java.lang.String name,
                long originEnergyLimit)

Contract

public Contract(Contract.Builder builder)

Method Detail

setAbi

public void setAbi(java.lang.String abiString)
            throws java.lang.Exception

Throws:

java.lang.Exception

createSmartContract

public Contract.CreateSmartContract createSmartContract(java.util.List<Type<?>> buildParams)
                                                 throws java.lang.Exception

create a CreateSmartContract object to get ready for deployment. please note if any deposit is made during deployment(@see callValue), the constructor of this contract must be payable

Returns:

TransactionBuilder object for signing and broadcasting

Throws:

java.lang.Exception - if deployment duplicating / owner and origin address don't match

ContractCreateException - if passes parameters but no constructor exists

abiToFunctions

protected void abiToFunctions()

Convert abi entries to ContractFunction objects

See Also:

Common.SmartContract.ABI.Entry, ;

collectParams

protected java.util.List<java.lang.String> collectParams(java.util.List<Common.SmartContract.ABI.Entry.Param> params,
                                                         char flag)

toProto

public Common.SmartContract toProto()

build a SmartContract object

Returns:

SmartContract object

deploy

public TransactionBuilder deploy()
                          throws java.lang.Exception

Throws:

java.lang.Exception

deploy

public TransactionBuilder deploy(java.util.List<Type<?>> buildParams)
                          throws java.lang.Exception

Throws:

java.lang.Exception

loadConstructor

protected void loadConstructor()

load the constructor from ABI

loadAbiFromJson

public static void loadAbiFromJson(java.lang.String abiString,
                                   Common.SmartContract.ABI.Builder builder)
                            throws java.lang.Exception

load abi from json format string

Parameters:

abiString - abi string in json format

Throws:

java.lang.Exception - if the input is not valid JSON format or there are unknown fields in the input