tron-staking

name	tron-staking
description	This skill should be used when the user asks to 'stake TRX', 'freeze TRX', 'unfreeze TRX', 'vote for SR', 'TRON super representative', 'claim TRON rewards', 'TRON staking rewards', 'how to earn with TRX', 'delegate TRX', 'Stake 2.0', 'unfreeze period', or mentions staking, freezing, unfreezing, voting for Super Representatives, claiming rewards, or Stake 2.0 on the TRON network. Do NOT use for resource queries — use tron-resource. Do NOT use for balance checks — use tron-wallet.
license	MIT
metadata	{"author":"tronlink-skills","version":"1.1.0","homepage":"https://trongrid.io"}

TRON Staking (Stake 2.0)

3 commands for SR list, staking info, and APY estimation (read-only queries).

TRON Stake 2.0 — Essential Knowledge

Stake 2.0 replaced the legacy Stake 1.0 system. Key differences:

• Freezing and voting are separate operations (Stake 1.0 combined them)
• Resources can be delegated to other addresses
• Unfreezing has a 14-day waiting period before TRX can be withdrawn
• Voting for Super Representatives (SRs) earns TRX rewards (~3-5% APY)

Staking Lifecycle

Freeze TRX → Get Energy or Bandwidth → Vote for SR → Earn Rewards → Unfreeze → Wait 14 days → Withdraw

Resolve the CLI path

Every command below runs node "$TRON_API". Set $TRON_API once per session so it works no matter how the skill was installed (Claude Code plugin, install.sh → ~/.tronlink-skills, or inside the cloned repo):

TRON_API="${CLAUDE_PLUGIN_ROOT:-$HOME/.tronlink-skills}/scripts/tron_api.mjs"
[ -f "$TRON_API" ] || TRON_API="scripts/tron_api.mjs"   # fallback when run inside the repo

Read-only / informational: this skill explains staking and reads on-chain staking state, APY, and SR data. It does not freeze/unfreeze, vote, or claim — those require signing in the TronLink wallet itself.

Commands

1. Super Representative List

node "$TRON_API" sr-list --limit 30

Returns: SR name, address, total votes, vote percentage, block production rate, APY estimate, commission rate.

2. My Staking Info

node "$TRON_API" staking-info --address <TRON_ADDRESS>

Returns:

• TRX frozen for Energy (amount, unlock date)
• TRX frozen for Bandwidth (amount, unlock date)
• TRON Power (total votes available)
• Current votes (which SRs, how many)
• Unclaimed rewards
• Pending unfreezes (amount, unlock date)
• Delegated resources — the addresses this account delegated to / received from (per-pair amounts require a deeper getdelegatedresourcev2 lookup)

3. APY Estimation

node "$TRON_API" staking-apy --amount <TRX_TO_STAKE>

Returns: estimated annual yield based on current network parameters, SR rewards, and commission rates.

Top Super Representatives (Reference)

SR	Focus	Commission
Poloniex	Exchange	20%
Binance Staking	Exchange	20%
SUN Community	DeFi	0% (community)
JustinSunTron	Foundation	20%
CryptoGuyInZA	Community	0%
sesameseed	Community	Compound

⚠️ SR list changes frequently. Always check current data with sr-list.

Staking Strategy Guide for Agents

For Frequent Users (Daily TRC-20 Transfers)

• Freeze enough TRX to cover daily Energy needs (~65,000 Energy per USDT transfer)
• Rule of thumb: 1 TRX frozen ≈ 4.5 Energy per day
• For 1 USDT transfer/day: freeze ~14,500 TRX
• Vote for highest-APY SR to earn rewards

For Occasional Users

• Keep TRX liquid, accept burning for occasional transactions
• Or rent Energy from marketplace (cheaper for < 5 tx/month)

For Passive Income

• Freeze all available TRX
• Vote for SRs with lowest commission and highest APY
• Claim rewards every few days (claiming itself costs minimal bandwidth)
• Compound by re-freezing claimed rewards

Common Pitfalls

"Cannot unfreeze": TRX has not been frozen for the minimum 14 days, or you have pending votes that need to be removed first.

"Insufficient TRON Power": You're trying to vote with more TP than you have frozen. Check staking-info for available TP.

"Withdraw failed": The 14-day unfreeze waiting period has not completed. Check pending unfreezes in staking-info.

"Reward is 0": You haven't voted, or the maintenance cycle (6 hours) hasn't completed yet. Vote first, then wait at least 6 hours.