release v1.1.3

Release Note v1.1.3

Overview

This is a major feature expansion that introduces a large number of TRON full-node and TronGrid API tools, covering governance, staking, event queries, transaction broadcasting, and more. The codebase has been refactored into a modular architecture, and a readonly mode has been introduced for enhanced security control.

New Tools

R = Read-only, W = Write (requires wallet configuration, unavailable in readonly mode)

Governance & Super Representatives

Query, create, and manage Super Representatives, including voting, rewards, and brokerage settings.

Tool Name	Description	Type
list_witnesses	Get the full list of all Super Representatives	R
get_paginated_witnesses	Get a paginated list of Super Representatives	R
get_next_maintenance_time	Get the next maintenance (vote tally) time	R
get_reward	Query unclaimed voting rewards	R
get_brokerage	Query SR brokerage ratio	R
create_witness	Apply to become a Super Representative candidate	W
update_witness	Update Super Representative info	W
vote_witness	Vote for Super Representatives	W
withdraw_balance	Withdraw SR block rewards	W
update_brokerage	Update brokerage ratio	W

Proposals

Query, create, approve, and delete network governance proposals.

Tool Name	Description	Type
list_proposals	List all governance proposals	R
get_proposal	Get proposal details by ID	R
create_proposal	Create a governance proposal (SR only)	W
approve_proposal	Approve or revoke a proposal (SR only)	W
delete_proposal	Delete a proposal (creator only)	W

Account Management

Full account info, resource queries, delegation lookups, on-chain activation, name setting, and multi-signature permission management.

Tool Name	Description	Type
get_account	Get full account info	R
get_account_balance	Get TRX balance at a specific block height	R
generate_account	Generate a new TRON keypair offline	R
validate_address	Validate address and detect format	R
get_account_net	Get account bandwidth info	R
get_account_resource	Get account energy, bandwidth, and delegation details	R
get_delegated_resource	Query resource delegation between two accounts	R
get_delegated_resource_index	Query delegation index for an account	R
create_account	Activate a new account on-chain	W
update_account	Set account name (can only be set once)	W
account_permission_update	Update multi-signature permissions	W

Account Data (TronGrid)

Query account transaction history, TRC20 transfers, internal transactions, and token balances via TronGrid API.

Tool Name	Description	Type
get_account_info	Get account summary	R
get_account_transactions	Get account transaction history	R
get_account_trc20_transactions	Get account TRC20 transfer history	R
get_account_internal_transactions	Get account internal transaction history	R
get_account_trc20_balances	Get all TRC20 token balances for an account	R

Contract Data (TronGrid)

Query contract transaction records, internal transactions, and token holders via TronGrid API.

Tool Name	Description	Type
get_contract_transactions	Get contract transaction history	R
get_contract_internal_transactions	Get contract internal transactions	R
get_trc20_token_holders	Get TRC20 token holder list	R

Contract Extensions

Contract deployment, energy estimation, ABI fetching, and contract settings management.

Tool Name	Description	Type
get_contract	Get contract metadata (ABI, bytecode)	R
get_contract_info	Get contract ABI and function list	R
fetch_contract_abi	Fetch ABI for verified contracts	R
estimate_energy	Estimate energy consumption for a contract call	R
deploy_contract	Deploy a smart contract	W
update_contract_setting	Update user resource consumption ratio	W
update_energy_limit	Update contract energy limit	W
clear_abi	Clear on-chain ABI metadata	W

Staking (Stake 2.0)

Freeze/unfreeze TRX, withdraw expired balances, and cancel pending unfreezes.

Tool Name	Description	Type
get_available_unfreeze_count	Get remaining unfreeze operation quota	R
get_can_withdraw_unfreeze_amount	Get withdrawable unfreeze amount	R
freeze_balance_v2	Freeze TRX for bandwidth or energy	W
unfreeze_balance_v2	Unfreeze TRX to release resources	W
withdraw_expire_unfreeze	Withdraw expired unfrozen balance	W
cancel_all_unfreeze_v2	Cancel all pending unfreezes and re-stake	W

Resource Delegation (Stake 2.0)

Delegate and undelegate bandwidth/energy between accounts.

Tool Name	Description	Type
get_can_delegated_max_size	Get max delegatable amount	R
get_delegated_resource_v2	Get delegation details between two addresses	R
get_delegated_resource_account_index_v2	Get delegation index for an address	R
delegate_resource	Delegate bandwidth/energy to another address	W
undelegate_resource	Revoke delegated resources	W

Transaction Broadcast & Building

Create unsigned transactions and broadcast signed transactions.

Tool Name	Description	Type
create_transaction	Create an unsigned TRX transfer transaction	W
broadcast_transaction	Broadcast a signed transaction (JSON)	W
broadcast_hex	Broadcast a signed transaction (hex encoded)	W

Events

Query on-chain events by transaction, contract, or block.

Tool Name	Description	Type
get_events_by_transaction_id	Get events by transaction ID	R
get_events_by_contract_address	Get events by contract address	R
get_events_by_block_number	Get events by block number	R
get_events_of_latest_block	Get all events from the latest block	R

Mempool

Query the pending transaction pool.

Tool Name	Description	Type
get_pending_transactions	Get pending transaction ID list	R
get_transaction_from_pending	Get a specific pending transaction by ID	R
get_pending_size	Get pending transaction pool size	R

Node

Tool Name	Description	Type
list_nodes	List all connected nodes on the network	R
get_node_info	Get detailed info about the connected full node	R

Extended Block & Transaction Queries

Additional block and transaction query methods via the full-node HTTP API.

Tool Name	Description	Type
get_block_by_num	Query block by height	R
get_block_by_id	Query block by hash	R
get_block_by_latest_num	Get the latest N solidified blocks	R
get_block_by_limit_next	Query blocks in range [start, end)	R
get_now_block	Get the current latest block	R
get_transaction_by_id	Query transaction content by ID	R
get_transaction_info_by_id	Query transaction receipt by ID	R
get_transaction_info_by_block_num	Query all transaction receipts in a block	R
get_approved_list	Query the list of accounts that signed a transaction	R
get_block_balance	Query all balance changes in a block	R

Network Query Extensions

Tool Name	Description	Type
get_energy_prices	Query historical energy unit prices	R
get_bandwidth_prices	Query historical bandwidth unit prices	R
get_burn_trx	Query total TRX burned from fees	R

Security & Access Control

• Added --readonly (-r) command-line argument to disable all write tools
• Dynamic tool registration: write tools (marked W) are automatically hidden when no wallet is configured or in readonly mode
• Unified requiresWallet and isReadOnly metadata for tools and prompts

Architecture

• Refactored src/core/tools.ts into modular src/core/tools/ directory, split by category (20 module files)
• Refactored services into independent modules (governance, proposals, events, mempool, nodes, etc.)
• Unified tool and prompt registration logic using local helper functions

Other

• Added .env.example with all supported environment variables
• Added start.sh convenience startup script
• Added vitest.config.ts for test configuration
• Comprehensive test coverage for all new services and tools
• Updated README with full API reference, remote server configuration, and improved testing docs
• Updated AGENTS.md with contribution guidelines