mcpField
T
TRX Staking & SR Voting

TRX Staking & SR Voting

github.com/bofaiその他16375 回インストール1 週間前に更新
リポジトリ

TRX Staking & SR Voting について

TRX Staking & SR Votingは、TRONのステーキング状況の確認、Super Representativeの選択、投票、報酬請求を行うスキルです。TRON Stake 2.0のデータモデルに対応し、投票や報酬取引をdry-runで事前確認できます。

主な機能

  1. 01TRON Powerとステーク残高の確認
  2. 02順位順のSuper Representative一覧
  3. 03単一または複数SRへの投票
  4. 04投票報酬の確認と請求
  5. 05投票・請求操作のプレビュー

活用シーン

  1. 01投票前に利用可能な投票権を確認
  2. 02SRの順位と得票比率を比較
  3. 03選択した代表者に票を配分
  4. 04蓄積した投票報酬を確認または請求

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/bofai/skills --skill trx-staking-&-sr-voting

インストール後、Claude Code で/trx-staking-&-sr-votingを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

package.json
.gitignore
package-lock.json
README.md
resources/
staking_config.json
scripts/
utils.js
status.js
sr-list.js
rewards.js
vote.js

詳細

TRX ステーキングと SR 投票

TRX をステーキングして TRON Power を獲得し、スーパー代表(SR)に投票して、投票報酬を請求します。TRON は委任型プルーフ・オブ・ステークを採用しており、投票数上位 27 名の SR がブロックを生成し、6 時間ごとに投票者へ投票数に応じた報酬を分配します。


クイックスタート

cd trx-staking-skill && npm install
export TRON_PRIVATE_KEY="<your-private-key>"
export TRON_NETWORK="mainnet"

注意

秘密鍵を表示したり、ログに記録したりしないでください。


利用可能なスクリプト

1. status.js — ステーキングの概要
node scripts/status.js
node scripts/status.js TWalletAddress

出力: tron_power、total_frozen_trx、votes[]、unused_tron_power、pending_reward_trx

2. sr-list.js — スーパー代表の一覧
node scripts/sr-list.js              # Top 27 (active SRs)
node scripts/sr-list.js --top 50     # Top 50 (includes partners)

出力: super_representatives[](順位、アドレス、URL、投票数、投票シェア、アクティブな SR かどうか)

3. vote.js — SR への投票
# All votes to one SR
node scripts/vote.js TSRAddress --dry-run
node scripts/vote.js TSRAddress

# Split votes across multiple SRs
node scripts/vote.js --split TSR1:60,TSR2:40 --dry-run

メモ

投票するには、TRON Power(ステーキング済みの TRX)が必要です。TRX のステーキングには energy-bandwidth スキルを使用してください。

4. rewards.js — 投票報酬
node scripts/rewards.js              # Check pending rewards
node scripts/rewards.js --claim --dry-run
node scripts/rewards.js --claim

使用パターン

ステーキングの一連の手順
  1. TRX をステーキング(energy-bandwidth スキルを使用):node stake.js 1000 ENERGY
  2. TRON Power を確認:node scripts/status.js
  3. SR を確認:node scripts/sr-list.js --top 10
  4. 投票:node scripts/vote.js TSRAddress --dry-run → 確認 → 実行
  5. 報酬を定期的に確認:node scripts/rewards.js
  6. 請求:node scripts/rewards.js --claim

TRON Stake 2.0 への準拠

このスキルは TRON Stake 2.0 のデータモデルと API に対応しています。

  • アカウントデータ: Stake 2.0 の frozenV2[] 配列を読み取り、TRON Power と投票可能数を計算します(status.js、vote.js)。
  • 投票: Stake 2.0 の凍結残高から得た TRON Power を使い、voteWitnessAccount で投票します。
  • 投票報酬: getReward で確認し、withdrawBalance で請求します(rewards.js)。これはステーキング解除時の引き出しとは別の処理です。
  • TRX のステーキング/ステーキング解除は、関連する energy-bandwidth スキルが処理します(freezeBalanceV2、unfreezeBalanceV2、withdrawExpireUnfreeze を使用します)。

注意

14 日間のアンボンディング期間: TRX のステーキングを解除すると(energy-bandwidth スキルを使用)、14 日間のクールダウン期間に入り、その間、TRX はロックされ、リソースも投票力も獲得できません。ステーキング解除を開始する前に、エージェントは必ずこの遅延についてユーザーに警告してください。14 日後も TRX は自動的には戻りません。取り戻すには withdrawExpireUnfreeze を呼び出す必要があります。ステーキングを解除すると、それに対応する TRON Power も失われるため、それに依存する有効な投票は無効になります。


主な情報

項目値
凍結した TRX 1 枚= 1 TRON Power(TP)
アクティブな SR投票数上位 27 名
SR パートナー28~127 位
投票サイクル6 時間ごと
ブロック報酬1 サイクルあたり 128 TRX。投票数に応じて分配
ステーキング解除のクールダウン14 日間(必須、Stake 2.0)
ステーキング解除後の引き出し手動 — withdrawExpireUnfreeze の呼び出しが必要

セキュリティルール

  1. 秘密鍵を表示しないでください。
  2. 投票前にドライランを実行してください。 投票すると、以前の投票はすべて置き換えられます。
  3. 投票前に SR アドレスを確認してください。sr-list.js で確認できます。
  4. 投票すると以前の投票がすべて置き換わることを理解してください。各投票トランザクションで、投票先の一覧全体が設定されます。
  5. ステーキング解除前に、必ず 14 日間のアンボンディング期間について警告してください。 ユーザーがステーキングを解除する場合(energy-bandwidth スキルを使用)、TRX が 14 日間ロックされ、手動で引き出す必要があること、失われた TRON Power によって投票が無効になることを理解してもらう必要があります。

よくある問題

問題解決策
No TRON Powerまず energy-bandwidth スキルを使って TRX をステーキングしてください
Percentages don't sum to 100%配分率を調整してください
No rewards to claim投票後、投票サイクル(6 時間)が経過するまでお待ちください

バージョン 1.0.0 — M2M Agent Registry が Bank of AI 向けに作成

コメント