tv.noixion.troncli

Class TronClient

java.lang.Object

tv.noixion.troncli.TronClient

public class TronClient
extends Object

Represents a org.tron client.

Constructor Summary

Constructors

Constructor and Description
TronClient(List<TronNode> fullNodes, List<TronNode> solidityNodes) Creates a new client for the Tron network.
TronClient(TronNode fullNode) Creates a new client for the Tron network.
TronClient(TronNode fullNode, TronNode solidityNode) Creates a new client for the Tron network.

Method Summary

Modifier and Type	Method and Description
TronTransaction	approveProposal(TronWallet owner, long id, boolean add_approval) Approves a proposal, must be super representative.
TronTransaction	assetIssue(TronWallet owner, String name, String abbr, long totalSupply, TRXAssetConversion conversion, Date start, Date end, String description, String url, int decimals, long freeNetLimitPerAccount, long publicNetLimit, List<TronAssetIssue.FrozenSupply> frozenSupply) Creates a new Asset.
TronTransaction	assetIssue(TronWallet owner, String name, String abbr, long totalSupply, TRXAssetConversion conversion, Date start, Date end, String description, String url, long freeNetLimitPerAccount, long publicNetLimit, List<TronAssetIssue.FrozenSupply> frozenSupply) Creates a new Asset.
TronTransaction	assetIssue(TronWallet owner, String name, String abbr, long totalSupply, TRXAssetConversion conversion, int precision, Date start, Date end, String description, String url, int decimals, long freeNetLimitPerAccount, long publicNetLimit, List<TronAssetIssue.FrozenSupply> frozenSupply) Creates a new Asset.
void	broadcastTransaction(byte[] rawData, List<byte[]> signatures) Broadcasts transaction (already signed).
TronTransaction	buyStorage(TronWallet owner, long quantity) Buys storage points.
TronTransaction	createAccount(TronWallet owner, TronAddress newAccount) Creates an account.
TronTransaction	createProposal(TronWallet owner, Map<Long,Long> params) Creates a new proposal for the blockchain.
TronTransaction	createWitness(TronWallet owner, String url) Creates a witness account.
TronTransaction	deleteProposal(TronWallet owner, long id) Deletes a proposal.
javafx.util.Pair<TronTransaction,TronAddress>	deploySmartContract(TronWallet owner, String contractName, String ABI, String byteCode, TriggerContractDataBuilder constructorCall, TronCurrency feeLimit, long consumeUserResourcePercent, TronCurrency callValue, long callValueTokenId, long callValueToken, long originEnergyLimit, Map<String,TronAddress> libraries) Deploys an smart contract on the Tron network.
javafx.util.Pair<TronTransaction,TronAddress>	deploySmartContract(TronWallet owner, String contractName, String ABI, String byteCode, TriggerContractDataBuilder constructorCall, TronCurrency feeLimit, long consumeUserResourcePercent, TronCurrency callValue, Map<String,TronAddress> libraries) Deploys an smart contract on the Tron network.
TronTransaction	freezeBalance(TronWallet owner, TronCurrency amount, int durationDays, TronResource resource) Freezes your balance in exchange of energy or bandwidth.
TronAccount	getAccountByAddress(TronAddress address) Queries tha information of an account by its address.
TronAccount	getAccountByName(String name) Queries the information of an account by its name.
TronAccountNet	getAccountNet(TronAddress address) Queries the account net usage information.
TronAccountResource	getAccountResources(TronAddress address) Queries the account resources information.
TronAssetIssue	getAssetIssueByName(String name) Gets the information of an assets by its name.
List<TronAssetIssue>	getAssetIssueByOwnerAddress(TronAddress address) Gets the list of assets owned by an address.
TronBlock	getBlock(HashIdentifier id) Get block by its identifier / hash.
TronBlock	getBlock(long number) Gets a block by its number.
List<ChainParameter>	getChainParameters()
TronSmartContract	getContract(TronAddress address) Gets an smart contract deployen on the Tron network.
TronBlock	getLastBlock() Gets the last bock.
TronProposal	getProposalById(long id) Gets a proposal information by its id.
TronTransaction	getTransaction(HashIdentifier id) Gets a transaction.
TronTransactionInformation	getTransactionInformation(HashIdentifier id) Gets the execution information of a transaction,
List<TronTransaction>	getTransactionsFrom(TronAddress address, int offset, int limit) Gets the transactions made by an address.
List<TronTransaction>	getTransactionsTo(TronAddress address, int offset, int limit) Gets the transferences to an address.
List<TronAssetIssue>	listAssetIssue() Lists all assets present in the blockchain.
List<TronNode>	listNodes() List the known nodes by the org.tron node we are connecting to (Full nodes).
List<TronProposal>	listProposals() Lists all proposals.
List<TronWitness>	listWitnesses() Lists all witnesses.
TronTransaction	participateAsset(TronWallet owner, TronAddress receiver, String assetName, long amount) Particiapes in an Asset, exchanging your currency for tokens.
TronTransaction	sellStorage(TronWallet owner, long quantity) Sells storage points.
TronTransaction	setAccountId(TronWallet owner, String id) Sets an account identifier.
void	shutdown() Closes all connections.
TronTransaction	transfer(TronWallet owner, TronAddress receiver, TronCurrency amount) Transfers coins (TRX / SUN)
TronTransaction	transferAsset(TronWallet owner, TronAddress receiver, String assetName, long amount) Transfers assets.
TriggerContractResult	triggerSmartContract(TronWallet owner, TronAddress contractAddress, TriggerContractDataBuilder call, TronCurrency feeLimit, TronCurrency callValue) Triggers a smart contract, calling one method.
TriggerContractResult	triggerSmartContract(TronWallet owner, TronAddress contractAddress, TriggerContractDataBuilder call, TronCurrency feeLimit, TronCurrency callValue, long callValueTokenId, long callValueToken) Triggers a smart contract, calling one method.
TronTransaction	unfreezeAsset(TronWallet owner) Unfreezes all your frozen supply of assets.
TronTransaction	unfreezeBalance(TronWallet owner, TronResource resource) Unfreezes your balance.
TronTransaction	updateAccount(TronWallet owner, String name) Updates an account, setting the name.
TronTransaction	updateAsset(TronWallet owner, String description, String url, long freeNetLimitPerAccount, long publicNetLimit) Updates the settings of an asset.
TronTransaction	updateSmartContractEnergyLimit(TronWallet owner, TronAddress contractAddress, long originEnergyLimit) Updates the energy limit settings of a smart contract.
TronTransaction	updateSmartContractSettings(TronWallet owner, TronAddress contractAddress, long consumeUserResourcePercent) Updates the settings of a smart contract.
TronTransaction	updateWitness(TronWallet owner, String url) Updates a witness account.
TronTransaction	voteWitness(TronWallet owner, Map<TronAddress,Long> votes) Votes to a witness account.
TronTransactionInformation	waitForTransactionConfirmation(HashIdentifier txId, int maxRetries) waits until a transaction is confirmed by the blockchain.
TronTransaction	withdrawBalance(TronWallet owner) Withdraws balance earned from mining blocks.

Methods inherited from class java.lang.Object

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

Constructor Detail

TronClient

public TronClient(TronNode fullNode,
                  TronNode solidityNode)

Creates a new client for the Tron network.

Parameters:

fullNode - Full node

solidityNode - Solidity Node

TronClient

public TronClient(List<TronNode> fullNodes,
                  List<TronNode> solidityNodes)

Creates a new client for the Tron network.

Parameters:

fullNodes - List of trusted full nodes.

solidityNodes - List of trusted solidity nodes.

TronClient

public TronClient(TronNode fullNode)

Creates a new client for the Tron network.

Parameters:

fullNode - Full node

Method Detail

getBlock

public TronBlock getBlock(long number)
                   throws GRPCException

Gets a block by its number.

Parameters:

number - The block number.

Returns:

The block.

Throws:

GRPCException - If an error occurs in the GRPC protocol, generally connection problems.

getBlock

public TronBlock getBlock(HashIdentifier id)
                   throws GRPCException

Get block by its identifier / hash.

Parameters:

id - the identifier / hash of the block.

Returns:

the block.

Throws:

GRPCException - If an error occurs in the GRPC protocol, generally connection problems.

getTransaction

public TronTransaction getTransaction(HashIdentifier id)
                               throws GRPCException

Gets a transaction.

Parameters:

id - the identifier of the transaction.

Returns:

The transaction.

Throws:

GRPCException - If an error occurs in the GRPC protocol, generally connection problems.

getTransactionInformation

public TronTransactionInformation getTransactionInformation(HashIdentifier id)
                                                     throws GRPCException

Gets the execution information of a transaction,

Parameters:

id - the identifier of the transaction.

Returns:

The transaction information.

Throws:

GRPCException - If an error occurs in the GRPC protocol, generally connection problems.

getLastBlock

public TronBlock getLastBlock()
                       throws GRPCException

Gets the last bock.

Returns:

The last block.

Throws:

GRPCException - If an error occurs in the GRPC protocol, generally connection problems.

getAccountByAddress

public TronAccount getAccountByAddress(TronAddress address)
                                throws GRPCException

Queries tha information of an account by its address.

Parameters:

address - the account address.

Returns:

The account information

Throws:

GRPCException - If an error occurs in the GRPC protocol, generally connection problems.

getAccountByName

public TronAccount getAccountByName(String name)
                             throws GRPCException

Queries the information of an account by its name.

Parameters:

name - the account name.

Returns:

the information of the account.

Throws:

GRPCException - If an error occurs in the GRPC protocol, generally connection problems.

getAccountNet

public TronAccountNet getAccountNet(TronAddress address)
                             throws GRPCException

Queries the account net usage information.

Parameters:

address - The address of the account.

Returns:

The net usage information for the account.

Throws:

GRPCException - If an error occurs in the GRPC protocol, generally connection problems.

getAccountResources

public TronAccountResource getAccountResources(TronAddress address)
                                        throws GRPCException

Queries the account resources information.

Parameters:

address - The address of the account.

Returns:

the resources information for the account.

Throws:

GRPCException - If an error occurs in the GRPC protocol, generally connection problems.

getAssetIssueByName

public TronAssetIssue getAssetIssueByName(String name)
                                   throws GRPCException

Gets the information of an assets by its name.

Parameters:

name - the name of the asset.

Returns:

The information about the asset.

Throws:

GRPCException - If an error occurs in the GRPC protocol, generally connection problems.

getAssetIssueByOwnerAddress

public List<TronAssetIssue> getAssetIssueByOwnerAddress(TronAddress address)
                                                 throws GRPCException

Gets the list of assets owned by an address.

Parameters:

address - The address.

Returns:

The list of assets.

Throws:

GRPCException - If an error occurs in the GRPC protocol, generally connection problems.

listAssetIssue

public List<TronAssetIssue> listAssetIssue()
                                    throws GRPCException

Lists all assets present in the blockchain.

Returns:

The complete list of assets.

Throws:

GRPCException - If an error occurs in the GRPC protocol, generally connection problems.

listWitnesses

public List<TronWitness> listWitnesses()
                                throws GRPCException

Lists all witnesses.

Returns:

The complete list of witnesses.

Throws:

GRPCException - If an error occurs in the GRPC protocol, generally connection problems.

listNodes

public List<TronNode> listNodes()
                         throws GRPCException

List the known nodes by the org.tron node we are connecting to (Full nodes).

Returns:

The list of known nodes.

Throws:

GRPCException - If an error occurs in the GRPC protocol, generally connection problems.

getProposalById

public TronProposal getProposalById(long id)
                             throws GRPCException

Gets a proposal information by its id.

Parameters:

id - the proposal id.

Returns:

The proposal information.

Throws:

GRPCException - If an error occurs in the GRPC protocol, generally connection problems.

listProposals

public List<TronProposal> listProposals()
                                 throws GRPCException

Lists all proposals.

Returns:

The list of all proposals.

Throws:

GRPCException - If an error occurs in the GRPC protocol, generally connection problems.

getTransactionsFrom

public List<TronTransaction> getTransactionsFrom(TronAddress address,
                                                 int offset,
                                                 int limit)
                                          throws GRPCException

Gets the transactions made by an address. (Requires solidity node)

Parameters:

address - The address.

offset - The offset.

limit - The max number of transactions to return.

Returns:

The list of transactions.

Throws:

GRPCException - If an error occurs in the GRPC protocol, generally connection problems.

getTransactionsTo

public List<TronTransaction> getTransactionsTo(TronAddress address,
                                               int offset,
                                               int limit)
                                        throws GRPCException

Gets the transferences to an address. (Requires solidity node)

Parameters:

address - The address.

offset - The offset.

limit - The max number of transactions to return.

Returns:

The list of transactions.

Throws:

GRPCException - If an error occurs in the GRPC protocol, generally connection problems.

getContract

public TronSmartContract getContract(TronAddress address)
                              throws GRPCException

Gets an smart contract deployen on the Tron network.

Parameters:

address - The contract address.

Returns:

The Smart contract.

Throws:

GRPCException - If an error occurs in the GRPC protocol, generally connection problems.

transfer

public TronTransaction transfer(TronWallet owner,
                                TronAddress receiver,
                                TronCurrency amount)
                         throws GRPCException,
                                TransactionException

Transfers coins (TRX / SUN)

Parameters:

owner - The owner of the founds.

receiver - The receiver of the founds.

amount - The amount of currency to send

Returns:

The transaction sent to the blockchain.

Throws:

GRPCException - If an error occurs in the GRPC protocol, generally connection problems.

TransactionException - If The transaction fails to be sent.

transferAsset

public TronTransaction transferAsset(TronWallet owner,
                                     TronAddress receiver,
                                     String assetName,
                                     long amount)
                              throws GRPCException,
                                     TransactionException

Transfers assets.

Parameters:

owner - The owner of the assets.

receiver - the receiver of the assets.

assetName - The name of the asset to send.

amount - the number of assets to send.

Returns:

The transaction sent to the blockchain.

Throws:

GRPCException - If an error occurs in the GRPC protocol, generally connection problems.

TransactionException - If The transaction fails to be sent.

participateAsset

public TronTransaction participateAsset(TronWallet owner,
                                        TronAddress receiver,
                                        String assetName,
                                        long amount)
                                 throws GRPCException,
                                        TransactionException

Particiapes in an Asset, exchanging your currency for tokens.

Parameters:

owner - Sender of the transaction.

receiver - The receiver of the tokens (can be your own account).

assetName - The name of the asset.

amount - the amount of tokens you want.

Returns:

The transaction sent to the blockchain.

Throws:

GRPCException - If an error occurs in the GRPC protocol, generally connection problems.

TransactionException - If The transaction fails to be sent.

freezeBalance

public TronTransaction freezeBalance(TronWallet owner,
                                     TronCurrency amount,
                                     int durationDays,
                                     TronResource resource)
                              throws GRPCException,
                                     TransactionException

Freezes your balance in exchange of energy or bandwidth.

Parameters:

owner - Sender of the transaction.

amount - the amount to be frozen.

durationDays - The duration (in days). It is forced to 3 days.

resource - The resource you want (energy or bandwidth)

Returns:

The transaction sent to the blockchain.

Throws:

GRPCException - If an error occurs in the GRPC protocol, generally connection problems.

TransactionException - If The transaction fails to be sent.

voteWitness

public TronTransaction voteWitness(TronWallet owner,
                                   Map<TronAddress,Long> votes)
                            throws GRPCException,
                                   TransactionException

Votes to a witness account. You need org.tron power. 1 Tron Power = 1 TRX frozen.

Parameters:

owner - Sender of the transaction.

votes - The votes you want to emit (Address, number of votes)

Returns:

The transaction sent to the blockchain.

Throws:

GRPCException - If an error occurs in the GRPC protocol, generally connection problems.

TransactionException - If The transaction fails to be sent.

unfreezeBalance

public TronTransaction unfreezeBalance(TronWallet owner,
                                       TronResource resource)
                                throws GRPCException,
                                       TransactionException

Unfreezes your balance.

Parameters:

owner - Sender of the transaction.

resource - bandwidth or energy.

Returns:

The transaction sent to the blockchain.

Throws:

GRPCException - If an error occurs in the GRPC protocol, generally connection problems.

TransactionException - If The transaction fails to be sent.

assetIssue

public TronTransaction assetIssue(TronWallet owner,
                                  String name,
                                  String abbr,
                                  long totalSupply,
                                  TRXAssetConversion conversion,
                                  Date start,
                                  Date end,
                                  String description,
                                  String url,
                                  long freeNetLimitPerAccount,
                                  long publicNetLimit,
                                  List<TronAssetIssue.FrozenSupply> frozenSupply)
                           throws GRPCException,
                                  TransactionException

Creates a new Asset.

Parameters:

owner - Sender of the transaction.

name - Name of the asset.

abbr - Abbreviation.

totalSupply - Total supply of the asset.

conversion - Conversion between TRX and your asset.

start - Start date for your asset.

end - Expiration date for the asset.

description - Description of the asset.

url - Url of the site mantaining the asset.

freeNetLimitPerAccount - The free net limit for your asset.

publicNetLimit - The public net limit for your asset.

frozenSupply - The frozen suply of token.

Returns:

The transaction sent to the blockchain.

Throws:

GRPCException - If an error occurs in the GRPC protocol, generally connection problems.

TransactionException - If The transaction fails to be sent.

assetIssue

public TronTransaction assetIssue(TronWallet owner,
                                  String name,
                                  String abbr,
                                  long totalSupply,
                                  TRXAssetConversion conversion,
                                  Date start,
                                  Date end,
                                  String description,
                                  String url,
                                  int decimals,
                                  long freeNetLimitPerAccount,
                                  long publicNetLimit,
                                  List<TronAssetIssue.FrozenSupply> frozenSupply)
                           throws GRPCException,
                                  TransactionException

Creates a new Asset.

Parameters:

owner - Sender of the transaction.

name - Name of the asset.

abbr - Abbreviation.

totalSupply - Total supply of the asset.

conversion - Conversion between TRX and your asset.

start - Start date for your asset.

end - Expiration date for the asset.

description - Description of the asset.

url - Url of the site mantaining the asset.

decimals - Number of decimals to use.

freeNetLimitPerAccount - The free net limit for your asset.

publicNetLimit - The public net limit for your asset.

frozenSupply - The frozen suply of token.

Returns:

The transaction sent to the blockchain.

Throws:

GRPCException - If an error occurs in the GRPC protocol, generally connection problems.

TransactionException - If The transaction fails to be sent.

assetIssue

public TronTransaction assetIssue(TronWallet owner,
                                  String name,
                                  String abbr,
                                  long totalSupply,
                                  TRXAssetConversion conversion,
                                  int precision,
                                  Date start,
                                  Date end,
                                  String description,
                                  String url,
                                  int decimals,
                                  long freeNetLimitPerAccount,
                                  long publicNetLimit,
                                  List<TronAssetIssue.FrozenSupply> frozenSupply)
                           throws GRPCException,
                                  TransactionException

Creates a new Asset.

Parameters:

owner - Sender of the transaction.

name - Name of the asset.

abbr - Abbreviation.

totalSupply - Total supply of the asset.

conversion - Conversion between TRX and your asset.

precision - Number of decimals

start - Start date for your asset.

end - Expiration date for the asset.

description - Description of the asset.

url - Url of the site mantaining the asset.

decimals - Number of decimals to use.

freeNetLimitPerAccount - The free net limit for your asset.

publicNetLimit - The public net limit for your asset.

frozenSupply - The frozen suply of token.

Returns:

The transaction sent to the blockchain.

Throws:

GRPCException - If an error occurs in the GRPC protocol, generally connection problems.

TransactionException - If The transaction fails to be sent.

updateAsset

public TronTransaction updateAsset(TronWallet owner,
                                   String description,
                                   String url,
                                   long freeNetLimitPerAccount,
                                   long publicNetLimit)
                            throws GRPCException,
                                   TransactionException

Updates the settings of an asset.

Parameters:

owner - Sender of the transaction.

description - The new description.

url - the new url.

freeNetLimitPerAccount - the new free net limit.

publicNetLimit - the new public net limit.

Returns:

The transaction sent to the blockchain.

Throws:

GRPCException - If an error occurs in the GRPC protocol, generally connection problems.

TransactionException - If The transaction fails to be sent.

unfreezeAsset

public TronTransaction unfreezeAsset(TronWallet owner)
                              throws GRPCException,
                                     TransactionException

Unfreezes all your frozen supply of assets.

Parameters:

owner - Sender of the transaction.

Returns:

The transaction sent to the blockchain.

Throws:

GRPCException - If an error occurs in the GRPC protocol, generally connection problems.

TransactionException - If The transaction fails to be sent.

createAccount

public TronTransaction createAccount(TronWallet owner,
                                     TronAddress newAccount)
                              throws GRPCException,
                                     TransactionException

Creates an account.

Parameters:

owner - Sender of the transaction.

newAccount - The new account address.

Returns:

The transaction sent to the blockchain.

Throws:

GRPCException - If an error occurs in the GRPC protocol, generally connection problems.

TransactionException - If The transaction fails to be sent.

updateAccount

public TronTransaction updateAccount(TronWallet owner,
                                     String name)
                              throws GRPCException,
                                     TransactionException

Updates an account, setting the name.

Parameters:

owner - Sender of the transaction.

name - the name of the account.

Returns:

The transaction sent to the blockchain.

Throws:

GRPCException - If an error occurs in the GRPC protocol, generally connection problems.

TransactionException - If The transaction fails to be sent.

setAccountId

public TronTransaction setAccountId(TronWallet owner,
                                    String id)
                             throws GRPCException,
                                    TransactionException

Sets an account identifier.

Parameters:

owner - Sender of the transaction.

id - The account identifier to set.

Returns:

The transaction sent to the blockchain.

Throws:

GRPCException - If an error occurs in the GRPC protocol, generally connection problems.

TransactionException - If The transaction fails to be sent.

withdrawBalance

public TronTransaction withdrawBalance(TronWallet owner)
                                throws GRPCException,
                                       TransactionException

Withdraws balance earned from mining blocks.

Parameters:

owner - Sender of the transaction.

Returns:

The transaction sent to the blockchain.

Throws:

GRPCException - If an error occurs in the GRPC protocol, generally connection problems.

TransactionException - If The transaction fails to be sent.

createWitness

public TronTransaction createWitness(TronWallet owner,
                                     String url)
                              throws GRPCException,
                                     TransactionException

Creates a witness account.

Parameters:

owner - Sender of the transaction.

url - the utl with the information about the witness.

Returns:

The transaction sent to the blockchain.

Throws:

GRPCException - If an error occurs in the GRPC protocol, generally connection problems.

TransactionException - If The transaction fails to be sent.

updateWitness

public TronTransaction updateWitness(TronWallet owner,
                                     String url)
                              throws GRPCException,
                                     TransactionException

Updates a witness account.

Parameters:

owner - Sender of the transaction.

url - the new url.

Returns:

The transaction sent to the blockchain.

Throws:

GRPCException - If an error occurs in the GRPC protocol, generally connection problems.

TransactionException - If The transaction fails to be sent.

createProposal

public TronTransaction createProposal(TronWallet owner,
                                      Map<Long,Long> params)
                               throws GRPCException,
                                      TransactionException

Creates a new proposal for the blockchain.

Parameters:

owner - Sender of the transaction.

params - List of parameters.

Returns:

The transaction sent to the blockchain.

Throws:

GRPCException - If an error occurs in the GRPC protocol, generally connection problems.

TransactionException - If The transaction fails to be sent.

approveProposal

public TronTransaction approveProposal(TronWallet owner,
                                       long id,
                                       boolean add_approval)
                                throws GRPCException,
                                       TransactionException

Approves a proposal, must be super representative.

Parameters:

owner - Sender of the transaction.

id - Proposal identifier.

add_approval - Flag "add_approval"

Returns:

The transaction sent to the blockchain.

Throws:

GRPCException - If an error occurs in the GRPC protocol, generally connection problems.

TransactionException - If The transaction fails to be sent.

deleteProposal

public TronTransaction deleteProposal(TronWallet owner,
                                      long id)
                               throws GRPCException,
                                      TransactionException

Deletes a proposal. Must be the creator of the proposal.

Parameters:

owner - Sender of the transaction.

id - Proposal identifier.

Returns:

The transaction sent to the blockchain.

Throws:

GRPCException - If an error occurs in the GRPC protocol, generally connection problems.

TransactionException - If The transaction fails to be sent.

buyStorage

public TronTransaction buyStorage(TronWallet owner,
                                  long quantity)
                           throws GRPCException,
                                  TransactionException

Buys storage points.

Parameters:

owner - Sender of the transaction.

quantity - the amount of storage points you want to buy.

Returns:

The transaction sent to the blockchain.

Throws:

GRPCException - If an error occurs in the GRPC protocol, generally connection problems.

TransactionException - If The transaction fails to be sent.

sellStorage

public TronTransaction sellStorage(TronWallet owner,
                                   long quantity)
                            throws GRPCException,
                                   TransactionException

Sells storage points.

Parameters:

owner - Sender of the transaction.

quantity - the amount of storage points you want to sell.

Returns:

The transaction sent to the blockchain.

Throws:

GRPCException - If an error occurs in the GRPC protocol, generally connection problems.

TransactionException - If The transaction fails to be sent.

deploySmartContract

public javafx.util.Pair<TronTransaction,TronAddress> deploySmartContract(TronWallet owner,
                                                                         String contractName,
                                                                         String ABI,
                                                                         String byteCode,
                                                                         TriggerContractDataBuilder constructorCall,
                                                                         TronCurrency feeLimit,
                                                                         long consumeUserResourcePercent,
                                                                         TronCurrency callValue,
                                                                         Map<String,TronAddress> libraries)
                                                                  throws GRPCException,
                                                                         TransactionException,
                                                                         EncodingException

Deploys an smart contract on the Tron network.

Parameters:

owner - Sender of the transaction.

contractName - The contract name (account name for the contract address)

ABI - The ABI of the smart contract, in JSON format (must be an array).

byteCode - the byte code of the smart contract in hexadecimal.

constructorCall - The constructor method call.

feeLimit - The fee limit of the transaction.

consumeUserResourcePercent - The % of energy an user will consume when calling a method of the contract. Set it to 0 to consume first the owner resources.

callValue - The constructor method call value. Set it to 0 unless the constructor is Payable.

libraries - The libraries used for the mart contract, including the name and the address of the libraries.

Returns:

The transaction sent to the blockchain and the address of the smart contract.

Throws:

GRPCException - If an error occurs in the GRPC protocol, generally connection problems.

TransactionException - If The transaction fails to be sent.

EncodingException - If the constructor call is invalid.

deploySmartContract

public javafx.util.Pair<TronTransaction,TronAddress> deploySmartContract(TronWallet owner,
                                                                         String contractName,
                                                                         String ABI,
                                                                         String byteCode,
                                                                         TriggerContractDataBuilder constructorCall,
                                                                         TronCurrency feeLimit,
                                                                         long consumeUserResourcePercent,
                                                                         TronCurrency callValue,
                                                                         long callValueTokenId,
                                                                         long callValueToken,
                                                                         long originEnergyLimit,
                                                                         Map<String,TronAddress> libraries)
                                                                  throws GRPCException,
                                                                         TransactionException,
                                                                         EncodingException

Deploys an smart contract on the Tron network.

Parameters:

owner - Sender of the transaction.

contractName - The contract name (account name for the contract address)

ABI - The ABI of the smart contract, in JSON format (must be an array).

byteCode - the byte code of the smart contract in hexadecimal.

constructorCall - The constructor method call.

feeLimit - The fee limit of the transaction.

consumeUserResourcePercent - The % of energy an user will consume when calling a method of the contract. Set it to 0 to consume first the owner resources.

originEnergyLimit - The energy limit that can be consumed from the origin.

callValue - The constructor method call value. Set it to 0 unless the constructor is Payable.

callValueTokenId - The token to send as a token call value

callValueToken - The number of tokens to send as call value

libraries - The libraries used for the mart contract, including the name and the address of the libraries.

Returns:

The transaction sent to the blockchain and the address of the smart contract.

Throws:

GRPCException - If an error occurs in the GRPC protocol, generally connection problems.

TransactionException - If The transaction fails to be sent.

EncodingException - If the constructor call is invalid.

triggerSmartContract

public TriggerContractResult triggerSmartContract(TronWallet owner,
                                                  TronAddress contractAddress,
                                                  TriggerContractDataBuilder call,
                                                  TronCurrency feeLimit,
                                                  TronCurrency callValue)
                                           throws GRPCException,
                                                  TransactionException,
                                                  EncodingException

Triggers a smart contract, calling one method.

Parameters:

owner - Sender of the transaction.

contractAddress - The address of the smart contract you want to trigger.

call - The smart contract method call.

feeLimit - The fee limit of the transaction.

callValue - the method call value.

Returns:

The transaction sent to the blockchain.

Throws:

GRPCException - If an error occurs in the GRPC protocol, generally connection problems.

TransactionException - If The transaction fails to be sent.

EncodingException - If the method call is invalid.

triggerSmartContract

public TriggerContractResult triggerSmartContract(TronWallet owner,
                                                  TronAddress contractAddress,
                                                  TriggerContractDataBuilder call,
                                                  TronCurrency feeLimit,
                                                  TronCurrency callValue,
                                                  long callValueTokenId,
                                                  long callValueToken)
                                           throws GRPCException,
                                                  TransactionException,
                                                  EncodingException

Triggers a smart contract, calling one method.

Parameters:

owner - Sender of the transaction.

contractAddress - The address of the smart contract you want to trigger.

call - The smart contract method call.

feeLimit - The fee limit of the transaction.

callValue - the method call value.

callValueTokenId - The token to send as a token call value

callValueToken - The number of tokens to send as call value

Returns:

The transaction sent to the blockchain.

Throws:

GRPCException - If an error occurs in the GRPC protocol, generally connection problems.

TransactionException - If The transaction fails to be sent.

EncodingException - If the method call is invalid.

updateSmartContractSettings

public TronTransaction updateSmartContractSettings(TronWallet owner,
                                                   TronAddress contractAddress,
                                                   long consumeUserResourcePercent)
                                            throws GRPCException,
                                                   TransactionException

Updates the settings of a smart contract.

Parameters:

owner - Sender of the transaction.

contractAddress - the address of the contract.

consumeUserResourcePercent - the new value for "consumeUserResourcePercent".

Returns:

The transaction sent to the blockchain.

Throws:

GRPCException - If an error occurs in the GRPC protocol, generally connection problems.

TransactionException - If The transaction fails to be sent.

updateSmartContractEnergyLimit

public TronTransaction updateSmartContractEnergyLimit(TronWallet owner,
                                                      TronAddress contractAddress,
                                                      long originEnergyLimit)
                                               throws GRPCException,
                                                      TransactionException

Updates the energy limit settings of a smart contract.

Parameters:

owner - Sender of the transaction.

contractAddress - the address of the contract.

originEnergyLimit - The new value for origin-energy-limit.

Returns:

The transaction sent to the blockchain.

Throws:

GRPCException - If an error occurs in the GRPC protocol, generally connection problems.

TransactionException - If The transaction fails to be sent.

waitForTransactionConfirmation

public TronTransactionInformation waitForTransactionConfirmation(HashIdentifier txId,
                                                                 int maxRetries)
                                                          throws GRPCException,
                                                                 InterruptedException,
                                                                 ConfirmationTimeoutException

waits until a transaction is confirmed by the blockchain.

Parameters:

txId - The transaction identifier.

maxRetries - The max number of blocks to wait for.

Returns:

The transaction information.

Throws:

GRPCException - If an error occurs in the GRPC protocol, generally connection problems.

InterruptedException - If the thread is interrupted.

ConfirmationTimeoutException - The the transaction is not confirmed and max retries is reached.

broadcastTransaction

public void broadcastTransaction(byte[] rawData,
                                 List<byte[]> signatures)
                          throws com.google.protobuf.InvalidProtocolBufferException,
                                 GRPCException,
                                 TransactionException

Broadcasts transaction (already signed).

Parameters:

rawData - The transaction raw data

signatures - The transaction signatures

Throws:

com.google.protobuf.InvalidProtocolBufferException - If the raw data is invalid.

GRPCException - If an error occurs in the GRPC protocol, generally connection problems.

TransactionException - If the transaction fails to be broadcasted.

getChainParameters

public List<ChainParameter> getChainParameters()
                                        throws GRPCException

Throws:

GRPCException

shutdown

public void shutdown()

Closes all connections.