Skip to content

v0.27.0

Choose a tag to compare

@github-actions github-actions released this 13 Oct 13:15
· 3 commits to master since this release
49f4122

🔖 Release: v0.27.0 — Post-Quantum Signatures (TIP-899) & Security Hardening

Experimental TIP-899 post-quantum signing (ML-DSA-44 and FN-DSA-512, Nile only) across the SDK and tronctl, plus a security hardening pass over keystores, signing, installs and input validation.

⚠️ Minimum Go is now 1.25 (#294). trc20 send now fails when the token's decimals() cannot be read, instead of assuming 0 (#302). tronctl keys list gains a SCHEME column (#308).

✨ Features

  • Post-quantum protobuf types — vendored TIP-899 pq_auth_sig types from the Nile fork (#304)
  • PQ key types — new pkg/pqc with ML-DSA-44 (pure Go) and FN-DSA-512 (liboqs, -tags falcon) keys and an encrypted PQ keystore (#305)
  • PQ signing — signer.NewPQSigner signs any transaction, alone or alongside ECDSA, with an early ErrPQSchemeDisabled probe in txcore.Send and transaction.Controller (#306)
  • signer.Signer everywhere — tronctl and transaction.Controller sign through signer.Signer (WithSigner), so any signer can sign any command (#307)
  • tronctl PQ keys — keys add|import|list|export|remove --scheme fn-dsa-512|ml-dsa-44, and signing any command with a PQ key (#308)
  • tronctl-pq release archives — FN-DSA-512-capable builds for linux/amd64, linux/arm64, darwin/amd64, darwin/arm64 and windows/amd64, listed in checksums.txt (#311)
  • PQ helpers for wallet servers — pqc.ParseScheme, pqc.MaxAuthSigSize, client.PermissionOperations, client.PermissionUpdateMaps, txcore.CheckPQSchemes, signer.PQSignatures, transaction.EstimateBandwidth and store.ScanPQAccounts (#321)
  • PQ helpers for multisig signers — check a scheme before signing (txcore.CheckPQSchemes with pending schemes), and whether a key may sign under java-tron's rules: transaction.OwnerAndPermission, client.SigningPermission, client.PermissionAllows; store.ErrKeystoreNotFound (#322)

🔒 Security

  • Verified installs and native upgrade — install.sh verifies every archive against checksums.txt, and tronctl upgrade no longer pipes a script from master into sh: it downloads, verifies and replaces the binary in Go (#319)
  • Keystore hardening — constant-time MAC comparison and key material zeroed after use in the V3 and V1 keystores (#317)
  • Key derivation and account names — validate mnemonic, derivation path and key input, and keep account names inside the keystore directory (#318)
  • Signing integrity — stop signing when GetRawData fails, keep RecoverPubkey from mutating its input, refuse an unknown SigningImpl (#298, #309)
  • Untrusted input — validate node, keystore and caller data before indexing, asserting or dereferencing (#297)
  • Unlocked keystore closed — tronctl closes the unlocked keystore once a command has signed (#310)
  • Security policy — SECURITY.md with private vulnerability reporting (#313)

🐛 Bug Fixes

  • No more panics on an unstarted client — GrpcClient methods return client.ErrNotConnected before Start, after Stop or on a nil client (#320)
  • No panic or hang without $HOME — store returns store.ErrNoConfigDir, and tronctl reports it instead of panicking (#321)
  • --estimate broadcast — contract trigger --estimate no longer broadcasts a real transaction (#295)
  • Version check — fixed panics, hangs and misreported release builds in the post-error version check (#296)
  • ABI encoding — canonical selectors, out-of-range ints rejected, all bytesN types encoded (#299)
  • Exact amounts — CLI monetary amounts are parsed exactly instead of through float64 (#300)
  • TRC20 decimals and TRC10 ICO — fail on unreadable decimals; correct the ICO token amount (#302)
  • JSON output — commands fail when their JSON output cannot be encoded (#316)
  • Release changelog groups — match the commit subject and allow a ticket prefix (#312)
  • Flaky goroutine-leak test — pkg/store waits for keystore goroutines instead of a fixed sleep (#322)

📦 Dependencies

  • Updated google.golang.org/grpc to v1.82.1, golang.org/x/crypto to v0.54.0 and golang.org/x/net to v0.56.0 (#294)
  • Added github.com/cloudflare/circl v1.6.5 for ML-DSA-44 (#305)

📖 Documentation

  • SDK guide for PQ signing, checking a key may sign, and migrating an ECDSA account to a PQ key (#315, #321, #322)
  • Bug report issue template (#314)

Which archive signs FN-DSA-512?

Only the tronctl-pq_* archives can create FN-DSA-512 (Falcon-512) keys and sign with them. They are built with -tags falcon and a statically linked liboqs, for linux/amd64, linux/arm64, darwin/amd64, darwin/arm64 and windows/amd64; there is no windows/arm64 build.

The tronctl_* archives and the Homebrew formula are built without CGO: they handle ML-DSA-44 fully and can import, list and export FN-DSA-512 keys, but cannot create FN-DSA-512 keys or sign with them.

Every archive is listed in checksums.txt. TIP-899 is experimental and live only on the Nile testnet; see docs/post-quantum.md.

Full Changelog: v0.26.0...v0.27.0