gotron-sdk

module
v0.0.0-...-cce5508 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jan 30, 2024 License: LGPL-3.0

README

TRON's go-sdk

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

Build

$ git pull -r origin master
$ make
cross build for windows
make windows

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.

Directories

Path Synopsis
cmd
pkg
abi
keys/hd
Package hd provides basic functionality Hierarchical Deterministic Wallets.
Package hd provides basic functionality Hierarchical Deterministic Wallets.
keystore
Package keystore implements encrypted storage of secp256k1 private keys.
Package keystore implements encrypted storage of secp256k1 private keys.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL