TRC20 Token Toolkit

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

91|14|Updated Mar 2, 2026
One-click install
npx skills add https://github.com/BofAI/skills --skill trc20-token-toolkit
Or copy as Structured Prompt for Agent
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.