# 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

```sh
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`:

```sh
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.

```go
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.

```go
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.