TRC20 Token Toolkit

Retrieve TRC20 token metadata, balances, transfers, and allowances on TRON.

91|14|Updated Mar 2, 2026

Search Tags:#metadata #dry-run #tron #allowance #trc20 #token transfer #token balances

Ready to run

npx skills add https://github.com/BofAI/skills --skill trc20-token-toolkit

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: TRC20 Token Toolkit
Source: https://github.com/BofAI/skills/tree/main/trc20-toolkit-skill
Command: npx skills add https://github.com/BofAI/skills --skill trc20-token-toolkit

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires tronweb, and includes scripts (resource) and assets (resource) components.

What problem does it solve?

It eliminates manual TRC20 token lookups and error-prone wallet operations by providing validated, agent-ready utilities for TRON token metadata, balances, transfers, and approvals.

Core Features & Use Cases

Token metadata lookup: Fetch name, symbol, decimals, and total_supply for any TRC20 token by symbol or contract address.
Balances (single and batch): Query trx_balance and TRC20 balances, including batch balance checks with per-token error reporting.
Safety-guarded execution: Validate recipient/spender addresses, reject self-transfers, enforce positive amounts, and support --dry-run before broadcasting.
Approval management: Check current allowance and set allowances with a security constraint that disables unlimited (MAX_UINT256) approvals.

Quick Start

Ask the agent: "Check my USDT and SUN balances on TRON mainnet."

Frequently Asked Questions about TRC20 Token Toolkit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I check TRC20 token balances for multiple contracts on TRON?▼

You can check TRC20 token balances for multiple contracts using batch balance queries. This functionality retrieves TRX and TRC20 balances across specified tokens, providing per-token error reporting to identify any failed lookups within the batch operation.

How do I safely transfer TRC20 tokens without risking invalid transactions?▼

Safely transfer TRC20 tokens by utilizing a dry-run validation process before broadcasting. The system enforces address correctness, rejects self-transfers, and requires positive amounts to ensure only valid transactions are executed on the TRON blockchain.

Can I set an unlimited allowance for a TRC20 token spender?▼

No, you cannot set an unlimited allowance for a TRC20 token spender. The approval management system enforces a security constraint that disables MAX_UINT256 approvals, requiring you to specify exact allowance amounts to protect your funds.

How do I retrieve TRC20 token metadata like decimals and total supply?▼

Retrieve TRC20 token metadata like decimals and total supply by querying the token's symbol or direct contract address. This process fetches essential attributes including name, symbol, decimals, and total_supply directly from the TRON blockchain.

What do I need to sign and broadcast TRC20 transfers on the TRON network?▼

To sign and broadcast TRC20 transfers on the TRON network, you need a funded TRON account configured via TRON_PRIVATE_KEY. This key authorizes signing actions for token transfers and approval management operations executed through tronweb.