tronWallet

README

tron-wallet

tron wallet package for creating and generating wallet, transferring TRX, getting wallet balance and crawling blocks to find wallet transactions

Installation

go get github.com/obeylowe95/tron-wallet

Test

test for Crawler, TronWallet and Token located at /test

go test ./test

Wallet methods

Set environment variables TRON_PRO_API_KEY in production if you want to avoid rate limit.

• generating tron wallet

w := GenerateTronWallet(enums.SHASTA_NODE)
w.Address // string 
w.AddressBase58 // string 
w.PrivateKey // string 
w.PublicKey // string 

• creating tron wallet from private key

w := CreateTronWallet(enums.SHASTA_NODE,privateKeyHex)
w.Address // string 
w.AddressBase58 // string 
w.PrivateKey // string 
w.PublicKey // string 

• generating mnemonic

mnenomic := tronWallet.GenerateMnemonic(12)
// net uncle rigid useless coast explain saddle crawl pupil erase veteran slender

• creating tron wallet from mnemonic with account path

mnemonic := "net uncle rigid useless coast explain saddle crawl pupil erase veteran slender"
wallet, _ := tronWallet.MnemonicToTronWallet(enums.NILE_NODE, mnemonic, "m/44'/195'/3'/0/1", "")

wallet.AddressBase58 // TXTaWVTCMAEjC35S6sLF5gi6ZKVrxAkmGX
wallet.Address  // 41ebb83dedb47dc852a5e2863acaf7b11989bc07a9
wallet.PrivateKey // 900b8fc4c8c83a9baffc40917aa1a029eb4b75215d05d0de92e365b907f27c22
wallet.PublicKey //04487ff8ed9de594a4148dfe0f83b7320e069fa66848f078f90270b695022c671af47417004b4cdd53487e8def2ebb6fe696fd883e48d68a0ed1bed9a3459f4a01

• getting wallet trx balance

balanceInSun,err := w.Balance()
balanceInSun // int64 

• getting wallet trc20 balance

balanceInToken,err := w.BalanceTRC20(token)
balanceInToken // int64 

• crawl blocks for addresses transactions

c := &Crawler{
		Node: enums.SHASTA_NODE, // network -> maninet, shasta, nile
		Addresses: []string{
			"TY3PJu3VY8xVUc5BjYwJtyRgP7TfivV666", // list of your addresses
		},
	}
	
res, err := c.ScanBlocks(40) // scan latest 40 block on block chain and extract addressess transactions 
res, err := c.ScanBlocksFromTo(28905305, 28905307) // or scan block from to number
Example 
// *
{
    {
        "address": "TY3PJu3VY8xVUc5BjYwJtyRgP7TfivV666",
        "tranasctions": {
            {
                "tx_id": "6afbc5758d49e8d8bedddd903edbfc01c5f11ebfbaa6237e887294a6fc9394a2",
                "from_address": "TJnsY5bGiwuPCQFismQDwyVTPAn7M88888",
                "to_address": "TY3PJu3VY8xVUc5BjYwJtyRgP7TfivV666",
                "amount": "195500", // sun
                "confirmations": 1,
                "symbol": "TRX",
            },
            {
                "tx_id": "61624fffb31d09b9fe7252cd743733a5890c2a9077698d4a9bcb3d70ebb28777",
                "from_address": "TSw5FSuWhTAcaJmBUVFY9fUY4ihwx588b6",
                "to_address": "TJnsY5bGiwuPCQFismQDwyVTPAn7M88888",
                "amount": "10000", // in token sub value 
                "confirmations": 1,
                "symbol": "USDT",
            },
        }
    },
    ...
}
* // 
	

Estimate transfer trx fee

feeInSun,err := w.EstimateTransferFee("TJnsY5bGiwuPCQFismQDwyVTPAn7M88888",10000)
feeInSun // int64

Estimate transfer trc20 fee

feeInSun,err := w.EstimateTransferTRC20Fee()
feeInSun // int64

• transfer trx from wallet

txId, err := w.Transfer(toAddressBase58, amount)
txId // string 

• transfer trc20 from wallet

txId, err := w.TransferTRC20(token, toAddressBase58, amount, feeLimit)
txId // string 

Token methods

• declaring token

token := &tronWallet.Token{
    ContractAddress: enums.SHASTA_Tether_USDT,
}

• Getting token name

token.GetName(w.Node, w.AddressBase58) // return string,error

• Getting token symbol

token.GetSymbol(w.Node, w.AddressBase58) // return string,error

• Getting token decimals

token.GetDecimal(w.Node, w.AddressBase58) // return int64,error

Supported networks

check enums/nodes file alternatively you can create your own node

node := enums.CreateNode("grpc.test.com:50051")

Supported contracts

check enums/contracts file alternatively you can create your own contract

contractAddress := enums.CreateContractAddress("TPYmHEhy5n8TCEfYGqW2rPxsghSfzghPDn")

TRX Faucet

Follow TronTestnet Twitter account @TronTest2 . Write your address in your tweet and @TronTest2 . They will transfer 10,000 test TRX (usually within five minutes). Each address can only be obtained once a day. If you need TRX for the nile testnet, please add "NILE" in your tweet.

TRC20 Faucet

Go to https://developers.tron.network/ and connect to the discord community. You can than ask for usdt in #faucet channel. Just type !shasta_usdt YOUR_WALLET_ADDRESS and send. TronFAQ bot will send you 5000 USDT (SASHTA) soon.

Important

I simplified this repository https://github.com/fbsobreira repository to create this package You can check go tron sdk for better examples and functionalities and do not use this package in production, I created this package for education purposes.

Donation

Address TUE66D1BT79FQcJE7fwf5vdfu3BYM4ph9Y

Documentation

Index

• func CreateAndBroadcastMultiTransaction(node enums.Node, fromAddressBase58 string, toAddressBase58 string, ...) (string, error)
• func GenerateMnemonic(numberOfWords int) string
• type CrawlResult
• type CrawlTransaction
• type Crawler
  • func (c *Crawler) ScanBlocks(count int) ([]CrawlResult, error)
  • func (c *Crawler) ScanBlocksFromTo(from int, to int) ([]CrawlResult, error)
• type Token
  • func (t *Token) GetBalance(node enums.Node, addressBase58 string) (*big.Int, error)
  • func (t *Token) GetDecimals(node enums.Node, addressBase58 string) (*big.Int, error)
  • func (t *Token) GetName(node enums.Node, addressBase58 string) (string, error)
  • func (t *Token) GetSymbol(node enums.Node, addressBase58 string) (string, error)
• type TronWallet
  • func CreateTronWallet(node enums.Node, privateKeyHex string) (*TronWallet, error)
  • func GenerateTronWallet(node enums.Node) *TronWallet
  • func MnemonicToTronWallet(node enums.Node, mnemonic, accountPath, passphrase string) (*TronWallet, error)
  • func (t *TronWallet) Balance() (int64, error)
  • func (t *TronWallet) BalanceTRC20(token *Token) (int64, error)
  • func (t *TronWallet) EstimateTransferFee(toAddressBase58 string, amountInSun int64) (int64, error)
  • func (t *TronWallet) EstimateTransferTRC20Fee() (int64, error)
  • func (t *TronWallet) PrivateKeyBytes() ([]byte, error)
  • func (t *TronWallet) PrivateKeyRCDSA() (*ecdsa.PrivateKey, error)
  • func (t *TronWallet) Transfer(toAddressBase58 string, amountInSun int64) (string, error)
  • func (t *TronWallet) TransferTRC20(token *Token, toAddressBase58 string, amountInTRC20 int64, feeLimit int64) (string, error)

Functions

func CreateAndBroadcastMultiTransaction

func CreateAndBroadcastMultiTransaction(node enums.Node, fromAddressBase58 string, toAddressBase58 string, amountInSun int64, privateKeys []*ecdsa.PrivateKey, _ ecdsa.PrivateKey) (string, error)

func GenerateMnemonic

func GenerateMnemonic(numberOfWords int) string

generating

Types

type CrawlResult

type CrawlResult struct {
	Address      string
	Transactions []CrawlTransaction
}

type CrawlTransaction

type CrawlTransaction struct {
	TxId          string
	Confirmations int64
	FromAddress   string
	ToAddress     string
	Amount        int64
	Symbol        string
}

type Crawler

type Crawler struct {
	Node      enums.Node
	Addresses []string
}

func (*Crawler) ScanBlocks

func (c *Crawler) ScanBlocks(count int) ([]CrawlResult, error)

func (*Crawler) ScanBlocksFromTo

func (c *Crawler) ScanBlocksFromTo(from int, to int) ([]CrawlResult, error)

type Token

type Token struct {
	ContractAddress enums.ContractAddress
}

func (*Token) GetBalance

func (t *Token) GetBalance(node enums.Node, addressBase58 string) (*big.Int, error)

func (*Token) GetDecimals

func (t *Token) GetDecimals(node enums.Node, addressBase58 string) (*big.Int, error)

func (*Token) GetName

func (t *Token) GetName(node enums.Node, addressBase58 string) (string, error)

func (*Token) GetSymbol

func (t *Token) GetSymbol(node enums.Node, addressBase58 string) (string, error)

type TronWallet

type TronWallet struct {
	Node          enums.Node
	Address       string
	AddressBase58 string
	PrivateKey    string
	PublicKey     string
}

func CreateTronWallet

func CreateTronWallet(node enums.Node, privateKeyHex string) (*TronWallet, error)

func GenerateTronWallet

func GenerateTronWallet(node enums.Node) *TronWallet

func MnemonicToTronWallet

func MnemonicToTronWallet(node enums.Node, mnemonic, accountPath, passphrase string) (*TronWallet, error)

func (*TronWallet) Balance

func (t *TronWallet) Balance() (int64, error)

func (*TronWallet) BalanceTRC20

func (t *TronWallet) BalanceTRC20(token *Token) (int64, error)

func (*TronWallet) EstimateTransferFee

func (t *TronWallet) EstimateTransferFee(toAddressBase58 string, amountInSun int64) (int64, error)

func (*TronWallet) EstimateTransferTRC20Fee

func (t *TronWallet) EstimateTransferTRC20Fee() (int64, error)

func (*TronWallet) PrivateKeyBytes

func (t *TronWallet) PrivateKeyBytes() ([]byte, error)

func (*TronWallet) PrivateKeyRCDSA

func (t *TronWallet) PrivateKeyRCDSA() (*ecdsa.PrivateKey, error)

func (*TronWallet) Transfer

func (t *TronWallet) Transfer(toAddressBase58 string, amountInSun int64) (string, error)

func (*TronWallet) TransferTRC20

func (t *TronWallet) TransferTRC20(token *Token, toAddressBase58 string, amountInTRC20 int64, feeLimit int64) (string, error)