‹ 首页

trc20-token-toolkit

@bofai · 收录于 5 天前 · 上游提交 1 周前

Universal TRC20 token operations — transfer, approve, query balances, and fetch metadata.

场景代币转账余额查询合约交互

适合你，如果你需要与TRC20代币合约进行交互

/ 下载安装
https://github.com/bofai/skills/tree/main/trc20-toolkit-skill ↗
/ 通过 npx 安装 校验哈希
npx oh-my-skill add bofai/skills/trc20-token-toolkit
/ 通过 bash 安装
curl -fsSL https://oh-my-skill.com/install.sh | bash -s -- bofai/skills/trc20-token-toolkit
/ 已经装过?验证本机副本,不用重装
npx oh-my-skill verify bofai/skills/trc20-token-toolkit
安装目标可用 --agent / --scope 或 --to 明确指定;省略时只会在唯一已存在的 agent 目录上自动选择,零命中或多命中会停止并提示。content_hash 缺失或不一致均拒装。
88GitHub stars
~1K最小装载
~2.9K含声明引用
~4.2K文本包总量
索引托管

怎么用

商店整理自技能原文 · 版本 39919d1 · 表述以原文为准
它做什么

安装后，Claude 可以查询 TRC20 代币信息、余额，执行转账和授权操作，支持符号或合约地址。

什么时候触发

当用户要求查询代币信息、余额、转账或管理授权时触发。

装好后可以这样说
返回当前钱包的 USDT 持仓。
先 dry-run 验证，确认后执行。
设置精确额度，防止无限授权。
技能原文 SKILL.md作者撰写 · MIT · 39919d1

TRC20 Token Toolkit

Universal TRC20 token operations for AI agents on TRON. Check balances, transfer tokens, manage approvals, and fetch metadata for any TRC20 token. Supports symbol-based lookups for common tokens (USDT, USDD, SUN, etc.) and direct contract addresses for any token.

Quick Start
Wallet required: Run agent-wallet list first. If no wallets exist, invoke bankofai-guide (Section C — Wallet Guard) before proceeding.
  1. Install dependencies: ```bash cd trc20-toolkit-skill && npm install ```
  2. Set environment variables: ```bash export TRON_PRIVATE_KEY="<your-private-key>" export TRON_NETWORK="mainnet" export TRONGRID_API_KEY="<optional>" ```
[!CAUTION] Never display or log the private key.
Available Scripts
1. info.js — Token Metadata
node scripts/info.js <tokenAddressOrSymbol>
node scripts/info.js USDT
node scripts/info.js TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t

Output: name, symbol, decimals, total_supply

2. balance.js — Token Balances
# Single token balance
node scripts/balance.js USDT
node scripts/balance.js USDT TWalletAddress123

# Batch balance check
node scripts/balance.js --batch USDT,USDD,SUN
node scripts/balance.js --batch USDT,USDD TWalletAddress123

Output: trx_balance, tokens[] (each with symbol, balance, decimals)

Behavior note: In --batch mode, invalid token inputs are returned as per-item errors instead of aborting the entire batch.

3. transfer.js — Transfer Tokens

| Parameter | Required | Description | |---|---|---| | token | Yes | Token address or symbol | | toAddress | Yes | Recipient TRON address | | amount | Yes | Human-readable amount | | --dry-run | No | Validate only, no transaction |

node scripts/transfer.js USDT TRecipientAddress 10.5 --dry-run
node scripts/transfer.js USDT TRecipientAddress 10.5

Output: status, tx_id, amount, symbol

Validation rules: Recipient addresses must be valid TRON addresses, self-transfers are rejected, and amount must be greater than 0 even in --dry-run.

4. approve.js — Manage Allowances
# Set allowance (use the exact amount needed, never unlimited)
node scripts/approve.js USDT TSpenderAddress 1000 --dry-run
node scripts/approve.js USDT TSpenderAddress 1000

# Check current allowance
node scripts/approve.js USDT TSpenderAddress --check
node scripts/approve.js USDT TSpenderAddress --check TWalletAddress

Output: allowance, is_max, status, tx_id

Validation rules: Spender and optional owner addresses must be valid TRON addresses, amount must be greater than 0, and unlimited approvals remain disabled.

Usage Patterns
Pattern 1: Check Before Transfer (Recommended)
node scripts/balance.js USDT
node scripts/transfer.js USDT TRecipient 100 --dry-run
# Confirm with user
node scripts/transfer.js USDT TRecipient 100
Pattern 2: Portfolio Overview
node scripts/balance.js --batch USDT,USDD,SUN,JST,BTT
Security Rules
[!CAUTION]
  1. Never display private keys in output or logs.
  2. Never transfer without user confirmation. Always use --dry-run first.
  3. Prevent self-transfers. The script rejects transfers to the sender's own address.
  4. Validate addresses. Ensure all addresses start with T and are valid TRON base58 addresses.
  5. Check balances before transfer. The script validates sufficient balance automatically.
  6. Never use unlimited approvals. Always approve only the exact amount needed for the intended swap or transfer. Infinite (MAX_UINT256) approvals are rejected by the script. This prevents a compromised or malicious spender contract from draining the entire token balance.
  7. Treat multi-permission wallets carefully. These scripts assume a directly usable signing key; wallets that require explicit permissionId selection may need a different transaction flow.
Supported Tokens

Common tokens resolved by symbol: USDT, USDD, USDC, WTRX, SUN, JST, BTT, WIN. Any TRC20 token can be used via its contract address.

See resources/well_known_tokens.json for the full list.

Common Issues

| Problem | Solution | |---|---| | Unknown token symbol | Use the full contract address instead | | Insufficient balance | Check balance first with balance.js | | TRON_PRIVATE_KEY required | Set the environment variable | | Cannot find module 'tronweb' | Run npm install |

Version 1.0.0 — Created by M2M Agent Registry for Bank of AI

按 MIT 许可原样转载,未经改动 · 在 GitHub 查看 →

评论

登录即可评论;带「已验证安装」的,是发布者名下有本店的安装或持有记录。
…