TRON's go-sdk

Forked from https://github.com/sunbankio/gotron-sdk

Getting started

go get -u github.com/jukbot/gotron-sdk

Create grpc client

func Client() (*client.GrpcClient, error) {
  c := client.NewGrpcClient("grpc.shasta.trongrid.io:50051")
  c.SetAPIKey("YOUR_API_KEY_HERE")
  err := c.Start(grpc.WithTransportCredentials(insecure.NewCredentials()))

  if err != nil {
    return nil, err
  }

  if c == nil {
    return nil, errors.New("failed to create new client")
  }
  return c, nil
}

GoSDK and TRON-CLI tool for TRON's blockchain via GRPC

Build

$ git pull -r origin master
$ make

Build for each platform

# MacOS (Apple silicon)
make macos

# Windows and Linux (x86)
make windows
make linux

Usage & Examples

bash completions

once built, add tronctl to your path and add to your .bashrc

. <(tronctl completion)

Transfer JSON file format

The JSON file will be a JSON array where each element has the following attributes:

Key	Value-type	Value-description
`from`	string	[Required] Sender's one address, must have key in keystore.
`to`	string	[Required] The receivers one address.
`amount`	string	[Required] The amount to send in $ONE.
`passphrase-file`	string	[Optional] The file path to file containing the passphrase in plain text. If none is provided, check for passphrase string.
`passphrase-string`	string	[Optional] The passphrase as a string in plain text. If none is provided, passphrase is ''.
`stop-on-error`	boolean	[Optional] If true, stop sending transactions if an error occurred, default is false.

Example of JSON file:

[
  {
    "from": "TUEZSdKsoDHQMeZwihtdoBiN46zxhGWYdH",
    "to": "TKSXDA8HfE9E1y39RczVQ1ZascUEtaSToF",
    "amount": "1",
    "passphrase-string": "",
    "stop-on-error": true
  },
  {
    "from": "TUEZSdKsoDHQMeZwihtdoBiN46zxhGWYdH",
    "to": "TEvHMZWyfjCAdDJEKYxYVL8rRpigddLC1R",
    "amount": "1",
    "passphrase-file": "./pw.txt",
  }
]

Debugging

The gotron-sdk code respects GOTRON_SDK_DEBUG as debugging based environment variables.

GOTRON_SDK_DEBUG=true ./tronctl

GRPC TLS

If you node require TLS connection, use parameter --withTLS TLS credentials can also be set persistent in config file: withTLS: true

Trongrid API Key

To set trongrid API Key first create you api key at www.trongrid.io and use parameter --apiKey=25f66928-0b70-48cd-9ac6-da6f8247c663 (replace with your API key) Trongrid API Key can also be set persistent in config file: apiKey: 25f66928-0b70-48cd-9ac6-da6f8247c663 (replace with your API key)

OS environment variable TRONGRID_APIKEY will overwrite any prior API key configuration if set.

jukbot / gotron-sdk