tron-api-cli v0.0.1

tron-api-cli

TRON blockchain api client for nodejs and browser

Tron api cli uses trxplorer.io api (https://api.trxplorer.io) to interract with TRON blockchain protocol

Install

yarn install tron-api-cli

Features

• Query blockchain (blocks, transactions, accounts, representative etc ...)
• Create transactions for contracts (send trx, freeze/unfreeze trx, vote etc ...)
• Sign transaction

## Usage example

import tronapi from "tron-api-client"

# Get user transactions
tronapi.account('TXuLKjf8J8aCKgDgA5uczwn1yQNYVPLocY').getTransactions().then((transactions)=>{ console.log(transactions)})

# Send trx with account/pkey (transaction is automatically signed before broadcasting to TRON network)
tronapi.account('TXuLKjf8J8aCKgDgA5uczwn1yQNYVPLocY',pkey).sendTRX({to:'TZuLFjf8J8aCKgDgA5uczwn1yQNYVPLocY',amount:100})

Cli

Kind: global class

• Cli
  • new Cli(options)
  • .account(address, pkey) ⇒ AccountCli
  • .accountExists(criteria)
  • .witness()

new Cli(options)

cli.account(address, pkey) ⇒ AccountCli

Get an instance of account client

Kind: instance method of Cli

cli.accountExists(criteria)

Checks if an account with a name or an address (or both) exists

Kind: instance method of Cli

cli.witness()

Get an instance of witness client

AccountCli

Kind: global class

• AccountCli
  • new AccountCli(endpoint, address, privateKey)
  • .getInfo() ⇒ AccountInfo
  • .getTransactions(criteria)
  • .getAllVotes(criteria)
  • .getAllFreeze(criteria)
  • .getTokens(criteria)
  • .sendTRX(toAddress, amount, pkey) ⇒ TransactionResult
  • .sendToken(toAddress, tokenName, amount, pkey) ⇒ TransactionResult
  • .vote()
  • .freeze(amount, duration) ⇒ TransactionResult
  • .unfreeze() ⇒ TransactionResult
  • .widthdraw() ⇒ TransactionResult
  • .sign(transaction)
  • .createWitness(url)
  • .update(name)

new AccountCli(endpoint, address, privateKey)

Account client

accountCli.getInfo() ⇒ AccountInfo

Get basic account informations

Kind: instance method of AccountCli

accountCli.getTransactions(criteria)

Get transactions where current account is involved

Kind: instance method of AccountCli

accountCli.getAllVotes(criteria)

Get all votes associated to current account

Kind: instance method of AccountCli

accountCli.getAllFreeze(criteria)

Get all freeze/unfreeze history associated to current account

Kind: instance method of AccountCli

accountCli.getTokens(criteria)

Get the token balances associated to this account

Kind: instance method of AccountCli

accountCli.sendTRX(toAddress, amount, pkey) ⇒ TransactionResult

Send an amount of TRX to an address

/!\ It is highly recommended to use this method with an offline signature strategy

Kind: instance method of AccountCli
Returns: TransactionResult - transaction result

accountCli.sendToken(toAddress, tokenName, amount, pkey) ⇒ TransactionResult

Send an amount of the specified token to an address

/!\ It is highly recommended to use this method with an offline signature strategy

Kind: instance method of AccountCli
Returns: TransactionResult - transaction result

accountCli.vote()

Vote for representatives

Kind: instance method of AccountCli

accountCli.freeze(amount, duration) ⇒ TransactionResult

Freeze an amount of TRX for a given duration (in days)

/!\ It is highly recommended to use this method with an offline signature strategy

Kind: instance method of AccountCli
Returns: TransactionResult - transaction result

accountCli.unfreeze() ⇒ TransactionResult

Unfreeze the amount of TRX that can be frozen at this time

/!\ It is highly recommended to use this method with an offline signature strategy

Kind: instance method of AccountCli
Returns: TransactionResult - transaction result

accountCli.widthdraw() ⇒ TransactionResult

Withdraw available allowance (for super representatives rewarded for producing blocks)

/!\ It is highly recommended to use this method with an offline signature strategy

Kind: instance method of AccountCli
Returns: TransactionResult - transaction result

accountCli.sign(transaction)

Sign a transaction with provided private key

Kind: instance method of AccountCli

accountCli.createWitness(url)

Make current account become a witness if possible

Kind: instance method of AccountCli

accountCli.update(name)

Update account informations

Kind: instance method of AccountCli

AccountInfo : Object

Kind: global typedef
Properties

TransactionResult : Object

Kind: global typedef
Properties

BlockCli

Kind: global class

• BlockCli
  • new BlockCli(endpoint)
  • .getLatest()
  • .addRef(transaction)

new BlockCli(endpoint)

Block client

blockCli.getLatest()

Get the latest available block

Kind: instance method of BlockCli

blockCli.addRef(transaction)

Add Bock reference to a transaction

Kind: instance method of BlockCli

WitnessCli

Kind: global class

• WitnessCli
  • new WitnessCli(endpoint)
  • .getAll(criteria)

new WitnessCli(endpoint)

Witness client

witnessCli.getAll(criteria)

Get all witnesses matching the criteria

Kind: instance method of WitnessCli