Back to Details

tron-wallet

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

TRON Wallet Management

TRON钱包管理

6 commands for wallet balance, TRC-20 holdings, transaction history, account info, address validation, and multi-sig support.
6个用于钱包余额、TRC-20持仓、交易历史、账户信息、地址验证及多签支持的命令。

Pre-flight Checks

预检查

  1. Confirm Node.js: Run `node -e "console.log('ok')" # Node.js >= 18 required
  2. API Key (optional): For higher rate limits, set:
    bash
    export TRONGRID_API_KEY="your-api-key"
  1. 确认Node.js环境：运行
    node -e "console.log('ok')"  # Node.js >= 18 required
  2. API密钥（可选）：如需更高调用频率限制，请设置：
    bash
    export TRONGRID_API_KEY="your-api-key"

Skill Routing

Skill路由

  • For token metadata / search → use 
    tron-token
  • For market prices / charts → use 
    tron-market
  • For DEX swap → use 
    tron-swap
  • For energy / bandwidth → use 
    tron-resource
  • For staking / voting → use 
    tron-staking
  • 如需代币元数据/搜索 → 使用
    tron-token
  • 如需市场价格/图表 → 使用
    tron-market
  • 如需去中心化交易所兑换 → 使用
    tron-swap
  • 如需能量/带宽 → 使用
    tron-resource
  • 如需质押/投票 → 使用
    tron-staking

Commands

命令

1. Check TRX Balance

1. 查看TRX余额

bash
node scripts/tron_api.mjs wallet-balance --address <TRON_ADDRESS>
Returns: TRX balance (human-readable), frozen TRX, account creation time.
bash
node scripts/tron_api.mjs wallet-balance --address <TRON_ADDRESS>
返回：TRX余额（易读格式）、冻结的TRX、账户创建时间。

2. Check TRC-20 Token Balance

2. 查看TRC-20代币余额

bash
node scripts/tron_api.mjs token-balance --address <TRON_ADDRESS> --contract <TOKEN_CONTRACT>
Common TRC-20 contracts:
TokenContract
USDT
TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t
USDC
TEkxiTehnzSmSe2XqrBj4w32RUN966rdz8
WTRX
TNUC9Qb1rRpS5CbWLmNMxXBjyFoydXjWFR
BTT
TAFjULxiVgT4qWk6UZwjqwZXTSaGaqnVp4
JST
TCFLL5dx5ZJdKnWuesXxi1VPwjLVmWZZy9
SUN
TSSMHYeV2uE9qYH95DqyoCuNCzEL1NvU3S
WIN
TLa2f6VPqDgRE67v1736s7bJ8Ray5wYjU7
bash
node scripts/tron_api.mjs token-balance --address <TRON_ADDRESS> --contract <TOKEN_CONTRACT>
常见TRC-20合约：
代币合约地址
USDT
TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t
USDC
TEkxiTehnzSmSe2XqrBj4w32RUN966rdz8
WTRX
TNUC9Qb1rRpS5CbWLmNMxXBjyFoydXjWFR
BTT
TAFjULxiVgT4qWk6UZwjqwZXTSaGaqnVp4
JST
TCFLL5dx5ZJdKnWuesXxi1VPwjLVmWZZy9
SUN
TSSMHYeV2uE9qYH95DqyoCuNCzEL1NvU3S
WIN
TLa2f6VPqDgRE67v1736s7bJ8Ray5wYjU7

3. Get All TRC-20 Holdings

3. 查看所有TRC-20持仓

bash
node scripts/tron_api.mjs wallet-tokens --address <TRON_ADDRESS>
Returns: list of all TRC-20 tokens with balances, symbols, and USD values.
bash
node scripts/tron_api.mjs wallet-tokens --address <TRON_ADDRESS>
返回：所有TRC-20代币的列表，包含余额、符号及美元价值。

4. Transaction History

4. 交易历史查询

bash
node scripts/tron_api.mjs tx-history --address <TRON_ADDRESS> --limit 20
Returns: recent transactions with type, amount, timestamp, status.
bash
node scripts/tron_api.mjs tx-history --address <TRON_ADDRESS> --limit 20
返回：近期交易记录，包含交易类型、金额、时间戳、状态。

5. Account Info

5. 账户信息查询

bash
node scripts/tron_api.mjs account-info --address <TRON_ADDRESS>
Returns: account creation date, permissions, resource overview, frozen balances, voting info.
bash
node scripts/tron_api.mjs account-info --address <TRON_ADDRESS>
返回：账户创建日期、权限信息、资源概览、冻结余额、投票信息。

6. Validate Address

6. 地址验证

bash
node scripts/tron_api.mjs validate-address --address <ADDRESS>
Returns: whether the address is valid TRON Base58Check format.
bash
node scripts/tron_api.mjs validate-address --address <ADDRESS>
返回：该地址是否为有效的TRON Base58Check格式。

Address Format Notes

地址格式说明

  • TRON addresses start with 
    T
    and are 34 characters long (Base58Check)
  • Hex addresses start with 
    41
    and are 42 hex characters
  • Example: 
    TNPeeaaFB7K9cmo4uQpcU32zGK8G1NYqeL
  • The script accepts both formats and auto-converts
  • TRON地址以
    T
    开头，长度为34位（Base58Check格式）
  • 十六进制地址以
    41
    开头，长度为42位十六进制字符
  • 示例：
    TNPeeaaFB7K9cmo4uQpcU32zGK8G1NYqeL
  • 本脚本支持两种格式，并会自动转换

Common Token Contracts (Mainnet)

主网常见代币合约

USDT:  TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t
USDC:  TEkxiTehnzSmSe2XqrBj4w32RUN966rdz8
WTRX:  TNUC9Qb1rRpS5CbWLmNMxXBjyFoydXjWFR
TUSD:  TUpMhErZL2fhh4sVNULAbNKLokS4GjC1F4
BTT:   TAFjULxiVgT4qWk6UZwjqwZXTSaGaqnVp4
JST:   TCFLL5dx5ZJdKnWuesXxi1VPwjLVmWZZy9
SUN:   TSSMHYeV2uE9qYH95DqyoCuNCzEL1NvU3S
WIN:   TLa2f6VPqDgRE67v1736s7bJ8Ray5wYjU7
NFT:   TFczxzPhnThNSqr5by8tvxsdCFRRz6cPNq
APENFT: TFczxzPhnThNSqr5by8tvxsdCFRRz6cPNq
USDT:  TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t
USDC:  TEkxiTehnzSmSe2XqrBj4w32RUN966rdz8
WTRX:  TNUC9Qb1rRpS5CbWLmNMxXBjyFoydXjWFR
TUSD:  TUpMhErZL2fhh4sVNULAbNKLokS4GjC1F4
BTT:   TAFjULxiVgT4qWk6UZwjqwZXTSaGaqnVp4
JST:   TCFLL5dx5ZJdKnWuesXxi1VPwjLVmWZZy9
SUN:   TSSMHYeV2uE9qYH95DqyoCuNCzEL1NvU3S
WIN:   TLa2f6VPqDgRE67v1736s7bJ8Ray5wYjU7
NFT:   TFczxzPhnThNSqr5by8tvxsdCFRRz6cPNq
APENFT: TFczxzPhnThNSqr5by8tvxsdCFRRz6cPNq

Troubleshooting

故障排查

"Account not found": The address has never been activated on TRON. A minimum of 1 TRX must be sent to activate it.
"Bandwidth insufficient": The account has used up its daily free bandwidth (600). Either wait for daily reset, freeze TRX for bandwidth, or the transaction will burn TRX as fee.
"Energy insufficient for TRC-20": Smart contract calls require Energy. Freeze TRX for Energy via 
tron-staking
, or TRX will be burned (often 13-27 TRX for a USDT transfer).
“账户未找到”：该地址从未在TRON网络激活过。需向其转入至少1 TRX以激活账户。
“带宽不足”：账户已用完每日免费带宽（600单位）。可等待每日重置，或冻结TRX获取带宽，否则交易将消耗TRX作为手续费。
“TRC-20操作能量不足”：智能合约调用需要Energy。可通过
tron-staking
冻结TRX获取Energy，否则将消耗TRX（通常USDT转账需消耗13-27 TRX）。