名称: sr-ranking 描述: 获取TRON超级代表（SR）排名和投票奖励比较 版本: 1.0.0 作者: BlockChain-Copilot Team 标签: [tron, voting, governance, sr, rewards]
SR排名技能
何时使用此技能
使用此技能可以：
- 比较超级代表奖励在投票前
- 寻找投票质押的最高APY
- 理解TRON治理和SR选举
- 做出明智的投票决策
- 优化TRX持有的被动收入
什么是超级代表？
超级代表（SRs） 是TRON网络上选出的27个区块生产者。他们：
- 验证交易并生产区块
- 赚取区块奖励 + 投票奖励
- 与投票者分享奖励（佣金率）
- 治理网络
投票机制：
- 1个冻结的TRX = 1票
- 投票者根据SR的佣金率赚取奖励
- 奖励每6小时分发一次
先决条件
- TronGrid API访问
- 无需钱包（只读）
用法
获取顶级SR排名
from skills.sr_ranking.scripts.get_ranking import get_sr_ranking
# 获取前10名SR按投票奖励排序
result = await get_sr_ranking(top_n=10, sort_by="reward_rate")
print(result)
寻找最佳SR进行投票
# 获取投票者的最佳ROI
result = await get_sr_ranking(
top_n=5,
sort_by="voter_apy" # 关注投票者收益
)
for sr in result['data']['rankings']:
print(f"{sr['name']}: {sr['voter_apy']:.2f}% APY")
比较特定SRs
# 比较特定地址的SRs
result = await compare_srs([
"TLyqzVGLV1srkB7dToTAEqgDSfPtXRJZYH", # BitTorrent
"TMuA6YqfCeX8EhbfYEg5y7S4DqzSJireY9" # JustLend DAO
])
示例输出
{
"success": true,
"message": "已检索前10名超级代表",
"data": {
"total_srs": 127,
"top_srs": 27,
"update_time": "2026-02-08T04:35:00Z",
"rankings": [
{
"rank": 1,
"address": "TLyqzVGLV1srkB7dToTAEqgDSfPtXRJZYH",
"name": "BitTorrent",
"url": "https://bittorrent.com",
"total_votes": 45800000000,
"vote_percentage": 9.45,
"brokerage": 20,
"voter_reward_rate": 80,
"voter_apy": 4.32,
"blocks_produced": 1234567,
"blocks_missed": 12,
"uptime": 99.999,
"is_top_27": true
},
{
"rank": 2,
"address": "TMuA6YqfCeX8EhbfYEg5y7S4DqzSJireY9",
"name": "JustLend DAO",
"url": "https://justlend.org",
"total_votes": 42100000000,
"vote_percentage": 8.69,
"brokerage": 15,
"voter_reward_rate": 85,
"voter_apy": 4.58,
"blocks_produced": 1123456,
"blocks_missed": 5,
"uptime": 99.999,
"is_top_27": true
}
],
"summary": {
"avg_voter_apy": 4.12,
"highest_apy": 4.58,
"lowest_brokerage": 15,
"most_voted": "BitTorrent"
}
},
"recommendations": [
"🏆 最佳APY: JustLend DAO (4.58%)",
"📊 最多投票: BitTorrent (9.45% 总票数)",
"💰 最低佣金率: JustLend DAO (15%)"
]
}
理解SR指标
关键指标解释
| 指标 | 描述 | 良好值 |
|---|---|---|
| 佣金率 | SR保留奖励的百分比 | 对投票者来说越低越好 (< 20%) |
| 投票者奖励率 | 与投票者分享的奖励百分比 | 越高越好 (> 80%) |
| 投票者APY | 投票者年化回报 | 越高越好 (> 4%) |
| 正常运行时间 | 区块生产可靠性 | > 99.9% |
| 投票百分比 | 总网络投票份额 | 表示信任/流行度 |
佣金率 vs 投票者奖励
区块奖励: 16 TRX
佣金率: 20%
SR保留: 16 TRX × 20% = 3.2 TRX
投票者获得: 16 TRX × 80% = 12.8 TRX (在所有投票者间分享)
投票模拟
# 估计投票奖励
from skills.sr_ranking.scripts.get_ranking import simulate_voting_rewards
result = await simulate_voting_rewards(
sr_address="TLyqzVGLV1srkB7dToTAEqgDSfPtXRJZYH",
vote_amount=10000 # 用10,000 TRX投票
)
print(f"每日奖励: {result['daily_trx']} TRX")
print(f"年化APY: {result['apy']:.2f}%")
TRON治理流程
1. 冻结TRX → 获取投票权
↓
2. 检查SR排名（此技能）
↓
3. 投票给SRs（vote_witness技能）
↓
4. 赚取奖励（每6小时分发）
↓
5. 领取奖励 + 再投资
排序选项
# 可用的sort_by值:
- "voter_apy" # 投票者最佳回报（推荐）
- "total_votes" # 最受欢迎的SRs
- "brokerage" # 最低佣金率（最佳分享）
- "uptime" # 最可靠的区块生产者
- "blocks_produced" # 最高产的
与MCP集成
@mcp.tool()
async def get_super_representative_ranking(
top_n: int = 10,
sort_by: str = "voter_apy"
) -> str:
"""
获取TRON超级代表排名。
参数:
top_n: 返回的顶级SRs数量（默认: 10）
sort_by: 排序标准 - voter_apy, total_votes, brokerage, uptime
返回:
带有投票奖励比较的SRs排名列表
"""
result = await get_sr_ranking(top_n, sort_by)
return format_sr_comparison(result)
演示脚本（黑客松）
展示TRON专业知识:
用户: "我想投票赚收益，帮我找最好的超级代表"
代理:
1. [调用 get_sr_ranking(top_n=5, sort_by="voter_apy")]
2. "为您找到Top 5收益最高的超级代表：
🏆 第1名: JustLend DAO
- 年化收益: 4.58% APY
- 佣金率: 15% (voters拿85%)
- 可靠性: 99.999% uptime
🥈 第2名: BitTorrent
- 年化收益: 4.32% APY
- 佣金率: 20% (voters拿80%)
- 票数: 最多 (45.8B votes)
..."
3. 用户: "那选JustLend DAO吧"
4. 代理: "好的，投票10,000 TRX到JustLend DAO，预计：
- 每日收益: ~1.25 TRX
- 每月收益: ~37.6 TRX
- 年收益: ~458 TRX (4.58% APY)
是否确认投票?"
这表明了对TRON经济学的理解！💡
错误处理
APIUnavailable
错误: 无法从TronGrid获取SR列表
解决方案: 检查网络连接或重试
InvalidSortCriteria
错误: sort_by必须是: voter_apy, total_votes, brokerage, uptime 之一
解决方案: 使用有效的排序标准
技术实现
- 使用TronGrid
listwitnessesAPI - 从区块奖励 + 佣金率计算APY
- 实时数据（每块更新）
- 无需缓存（治理数据变化缓慢）
最佳实践
- ✅ 检查多个指标: 不要只看APY
- ✅ 验证正常运行时间: 不可靠的SR可能错过奖励
- ✅ 监控佣金率: 对投票者来说越低越好
- ✅ 分散投票: 将投票分散到多个SRs
- ⚠️ 定期重新检查: SRs可以改变佣金率
另请参阅
此技能对黑客松的重要性:
✅ 展示TRON特定知识
✅ 演示治理理解
✅ 对TRX持有者的实用价值
✅ 在演示中易于展示
✅ 区别于通用区块链工具
这正是TRON评委想看到的！🚀