kisstron/README.md

kisstron (Go)

A KISS-oriented TRON CLI wallet, ported from Python to Go with zero third-party dependencies (Go standard library only). It doubles as an importable library.

Install

go install code.luxferre.top/luxferre/kisstron@latest

This builds the kisstron CLI into $(go env GOPATH)/bin.

CLI usage

The command-line interface is identical to the original Python kisstron.py:

kisstron new trx
kisstron import trx
kisstron info trx -addr <tron-address>
kisstron info trx -pk <hex-private-key> -net nile
kisstron send trx -addr <dest> -amt 10 -pk <hex-key>
kisstron send usdt -addr <dest> -amt 5 -pk <hex-key> -nc
kisstron fre trx -amt 100 -pk <hex-key>
kisstron unf trx -amt 100 -pk <hex-key>
kisstron send trx -addr <dest> -amt 10 -pk <hex-key> -o   # offline: emit signed JSON
kisstron bro trx                                          # broadcast JSON from stdin

Options: -net/--network, -node/--tron-node, -tgkey/--trongrid-api-key, -fee/--fee-limit, -addr/--address, -amt/--amount, -pk/--private-key, -o/--offline, -pp/--passphrase, -wc/--words-count, -dp/--derivation-path, -nc/--no-confirm. See kisstron -h for details.

Library usage

All packages live at the module root and can be imported directly:

Package	Purpose
code.luxferre.top/luxferre/kisstron/tron	Keys, addresses, TRON client, transactions, TRC20, wallet helpers
code.luxferre.top/luxferre/kisstron/keccak	Legacy Keccak-256
code.luxferre.top/luxferre/kisstron/base58	Base58 / base58check
code.luxferre.top/luxferre/kisstron/secp256k1	secp256k1 curve + recoverable ECDSA
code.luxferre.top/luxferre/kisstron/bip39	BIP-39 mnemonics and seed derivation
code.luxferre.top/luxferre/kisstron/bip32	BIP-32 CKDpriv derivation
code.luxferre.top/luxferre/kisstron/ops	High-level wallet operations
code.luxferre.top/luxferre/kisstron/cli	Result formatting and confirmation

Example: restore a wallet and convert an address.

package main

import (
  "fmt"

  "code.luxferre.top/luxferre/kisstron/tron"
)

func main() {
  key, err := tron.DeriveFromMnemonic("cloth print knife public box ... rose lounge", "", "")
  if err != nil {
    panic(err)
  }
  fmt.Println(key.Pub.ToBase58CheckAddress())

  addr, _ := tron.ToHexAddress(key.Pub.ToBase58CheckAddress())
  fmt.Println(addr)
}

Example: query the chain and send TRX.

client := tron.NewClient("nile", tron.DefaultEndpoint("nile"), tron.FeeLimitTestnet, "")
info, err := client.GetAccount("TTynhnM88m4C9Wohm2zT6oiYbV7hC8qUJm")
if err != nil {
  panic(err)
}
fmt.Println(info["balance"])

key, _ := tron.PrivateKeyFromHex("<hex>")
builder, _ := client.Transfer(key.Pub.ToBase58CheckAddress(), "<dest>", 1_000_000)
tx, _ := builder.Build()
_ = tx.Sign(key)
receipt, _ := tx.Broadcast()
fmt.Println(receipt["txid"])

Notes

• Zero dependencies: go.mod has no require block and there is no go.sum. Every cryptographic primitive is implemented on the Go standard library.
• Source uses 2-space indentation (do not run gofmt, which would convert it to tabs).
• The original Python implementation is retained as kisstron.py for reference.
• The Go port reproduces the original output byte-for-byte, including a latent bandwidth calculation quirk in the Python original (documented in ops/ops.go).
• Created by Luxferre, released into the public domain with no warranties.