Repository navigation
v0.27.0
🔖 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 sendnow fails when the token'sdecimals()cannot be read, instead of assuming 0 (#302).tronctl keys listgains aSCHEMEcolumn (#308).
✨ Features
- Post-quantum protobuf types — vendored TIP-899
pq_auth_sigtypes from the Nile fork (#304) - PQ key types — new
pkg/pqcwith ML-DSA-44 (pure Go) and FN-DSA-512 (liboqs,-tags falcon) keys and an encrypted PQ keystore (#305) - PQ signing —
signer.NewPQSignersigns any transaction, alone or alongside ECDSA, with an earlyErrPQSchemeDisabledprobe intxcore.Sendandtransaction.Controller(#306) signer.Signereverywhere —tronctlandtransaction.Controllersign throughsigner.Signer(WithSigner), so any signer can sign any command (#307)tronctlPQ keys —keys add|import|list|export|remove --scheme fn-dsa-512|ml-dsa-44, and signing any command with a PQ key (#308)tronctl-pqrelease archives — FN-DSA-512-capable builds for linux/amd64, linux/arm64, darwin/amd64, darwin/arm64 and windows/amd64, listed inchecksums.txt(#311)- PQ helpers for wallet servers —
pqc.ParseScheme,pqc.MaxAuthSigSize,client.PermissionOperations,client.PermissionUpdateMaps,txcore.CheckPQSchemes,signer.PQSignatures,transaction.EstimateBandwidthandstore.ScanPQAccounts(#321) - PQ helpers for multisig signers — check a scheme before signing (
txcore.CheckPQSchemeswith 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.shverifies every archive againstchecksums.txt, andtronctl upgradeno longer pipes a script frommasterintosh: 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
GetRawDatafails, keepRecoverPubkeyfrom mutating its input, refuse an unknownSigningImpl(#298, #309) - Untrusted input — validate node, keystore and caller data before indexing, asserting or dereferencing (#297)
- Unlocked keystore closed —
tronctlcloses the unlocked keystore once a command has signed (#310) - Security policy —
SECURITY.mdwith private vulnerability reporting (#313)
🐛 Bug Fixes
- No more panics on an unstarted client —
GrpcClientmethods returnclient.ErrNotConnectedbeforeStart, afterStopor on a nil client (#320) - No panic or hang without
$HOME—storereturnsstore.ErrNoConfigDir, andtronctlreports it instead of panicking (#321) --estimatebroadcast —contract trigger --estimateno 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
bytesNtypes 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/storewaits for keystore goroutines instead of a fixed sleep (#322)
📦 Dependencies
- Updated
google.golang.org/grpcto v1.82.1,golang.org/x/cryptoto v0.54.0 andgolang.org/x/netto v0.56.0 (#294) - Added
github.com/cloudflare/circlv1.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