Release v1.0.10

TronLib v1.0.10 Release Notes

🎉 What's New in v1.0.10

This release brings significant enhancements to the TronLib library, adding new low-level methods and improving event decoding capabilities. The changes are all backward compatible and add new functionality without breaking existing code.

🆕 New Features

Low-Level API Enhancements

• Account Management: Added GetAccountBalance and GetBlockBalanceTrace methods for improved account and block balance queries
• Block Operations: Added GetBlock method to retrieve blocks by ID or number
• Resource Management: Added FreezeBalance2 and UnfreezeBalance2 methods (version 2, preferred)
• Transaction Handling: Added methods to handle pending transactions:
  • GetTransactionFromPending
  • GetTransactionListFromPending
  • GetPendingSize

Enhanced Event Decoding

• Expanded Event Support: Added comprehensive builtin event definitions in pkg/eventdecoder/builtin.go
• Improved Examples: Updated event decoder example with better demonstrations
• Enhanced ABI Generator: Improved event ABI generator tool

Network Operations

• Transaction Information: Added GetTransactionInfoByBlockNum method for retrieving transaction information by block number
• Signer Utilities: Extracted signer utility functions from pkg/utils/transaction.go

🔧 Improvements

Testing Infrastructure

• Test Coverage Workflow: Added comprehensive test coverage workflow in GitHub Actions
• Dependency Updates: Updated dependencies to latest versions
• Test Documentation: Enhanced testing guide and documentation

Code Quality

• Documentation Updates: Updated package documentation across all modules
• Example Improvements: Enhanced examples with better error handling and documentation

📊 What Changed Since v1.0.8

Component	Changes
pkg/client/lowlevel/	+57 lines - New account, block, resource, and transaction methods
pkg/network/	+11 lines - Added block-based transaction info method
pkg/utils/	+49 lines - Enhanced transaction utilities and tests
pkg/eventdecoder/	+250 lines - Comprehensive builtin event definitions
examples/	+80 lines - Improved event decoder examples
docs/	+10 lines - Updated API reference documentation
tests/	+24 lines - Enhanced ABI encoding/decoding tests

✅ Backward Compatibility

All changes are fully backward compatible:

• No breaking API changes
• All existing functionality preserved
• New methods are additive only
• No changes to public interfaces

🧪 Testing

All tests pass successfully:

• ✅ Unit tests for all packages
• ✅ Integration tests for read and write operations
• ✅ Example validation tests

📦 Dependencies

Updated dependencies to latest stable versions:

• go-ethereum: v1.16.3
• grpc: v1.75.1
• protobuf: v1.36.9
• testify: v1.11.1

🎯 Release Highlights

1. Enhanced Low-Level Operations: New methods provide more granular control over TRON network operations
2. Better Event Support: Expanded builtin event definitions improve transaction log decoding
3. Improved Development Experience: Better examples, documentation, and testing infrastructure
4. Resource Management: New v2 freeze/unfreeze methods for better resource handling

📝 Migration Guide

No migration is required for existing users. The new methods can be used immediately:

// Example: Using new account balance method
balance, err := client.GetAccountBalance(ctx, req)
if err != nil {
    log.Fatal(err)
}
fmt.Printf("Account balance: %v", balance)