gate-exchange-staking

gate-cli の解決（バイナリパス）

gate-cli は次の順に解決します。（1） command -v gate-cli が成功し、gate-cli --version が成功する。（2） 実行可能な場合は ${HOME}/.local/bin/gate-cli。（3） 実行可能な場合は ${HOME}/.openclaw/skills/bin/gate-cli。正規のルール：exchange-runtime-rules.md §4（または gate-runtime-rules.md §4）。

Gate ステーキングクエリスイート

一般ルール

⚠️ 停止してください。続行する前に、共有ランタイムルールを必ず読み、厳守してください。 すべてのルールを読むまで、ツールを選択したり呼び出したりしないでください。これらのルールが最優先です。 → gate-runtime-rules.md をお読みください。

• このスキルに明記されている gate-cli コマンドのみを使用してください。 ここに記載されていないコマンドは、ほかのインターフェースで利用できる場合でも、これらのワークフローでは実行してはなりません。

スキルの依存関係

使用する gate-cli コマンド

クエリ操作（読み取り専用）

• gate-cli cex earn staking assets
• gate-cli cex earn staking awards
• gate-cli cex earn staking find
• gate-cli cex earn staking orders

実行操作（書き込み）

• gate-cli cex earn staking swap

認証

• 対話形式でのファイル設定： ホスト上で GATE_API_KEY と GATE_API_SECRET の両方が設定されていない場合は、gate-cli config init を実行し、API キー、シークレット、プロファイル、デフォルト値のウィザードを完了してください（gate-cli を参照）。
• 環境変数／フラグ： 認証情報がすでに提供されている場合は、gate-cli config init は不要です。たとえば、ホスト上で GATE_API_KEY と GATE_API_SECRET の両方が設定されている場合や、対応している場所で --api-key ／ --api-secret を使用する場合です。シークレットをチャットに貼り付けるようユーザーに求めてはなりません。
• 権限： Earn:Write
• ポータル： チャット外でキーを作成またはローテーションしてください：https://www.gate.com/myaccount/profile/api-key/manage

インストール確認

• 必須： gate-cli（見つからない場合は、このスキルのディレクトリから sh ./setup.sh を実行してください。GATE_CLI_SETUP_MODE=release は任意です）。
• gate-cli を名前で呼び出す場合は、$HOME/.openclaw/skills/bin（または setup.sh がインストールするディレクトリ）を PATH に追加してください。
• 認証情報： ホストに GATE_API_KEY と GATE_API_SECRET の両方が空でない値で設定されている場合、gate-cli config init を必須にしてはなりません。これは gate-cli の有効な設定と同等です。両方が未設定または空の場合は、gate-cli config init を実行するか、スキルライブラリ内の対応するスキルで GATE_API_KEY ／ GATE_API_SECRET を設定するよう、オペレーターに必ず伝えてください（シークレットをチャットに貼り付けるようユーザーに求めてはなりません）。
• 動作確認： CLI が想定どおりに動作するまで、認証が必要な呼び出しを実行してはなりません（例：gate-cli --version、またはこのスキルの読み取り専用 gate-cli cex ... コマンド）。変更を伴う操作の前に、認証情報が解決されていることを確認してください。

実行モード

references/gate-cli.md を読み、厳守してから、このスキルのステーキングワークフローを実行してください。

• SKILL.md はステーキングの意図の振り分けとシナリオの境界を定めます。
• references/gate-cli.md は、クエリとアクションの分離、確認ゲート、結果検証に関する、権威ある gate-cli 実行契約です。

モジュール概要

モジュール	説明	トリガーキーワード
ポジション	ステーキング中のポジション、残高、利用可能額とロック中の額を照会します	position、balance、staked、staking assets、holdings、redeemable
報酬	報酬履歴、昨日および月次の収益を照会します	reward、earning、profit、income、yesterday earnings、monthly earnings
商品	利用可能なステーキング商品、APY、最小金額を確認します	products、available、APY、stakeable coins、high yield、flexible
注文履歴	ステーキング／償還の注文一覧とページネーションを照会します	history、orders、transactions、staking records、redemption records
ステーキング／償還	スワップを通じてステーキングまたは償還を実行します（pid が必要です）	stake、redeem、unstake、stake 100 USDT、redeem my ETH、swap staking

ミント：即時ステーキングとして扱います。同じステーキングワークフローに進みます。references/staking-swap.md を読み、商品（pid）と金額を特定してから、side=0 で gate-cli cex earn staking swap を呼び出します。GUSD 商品の場合、ユーザーに USDT または USDC を選択してもらい、coin を渡します。

償還のキャンセル（未対応）：ユーザーが償還のキャンセルまたは取り消しを意図している場合（例：すでに送信済みの償還注文のキャンセル）、ツールを呼び出さないでください。この操作は未対応であることを英語で返信します。

ドメイン知識

商品タイプ

productType	ラベル	説明
0	証明書	即時償還が可能な柔軟なステーキング（redeemPeriod = 0）
1	ロックアップ	ロック期間が定められた固定期間のステーキング（redeemPeriod > 0）
2	米国債	米国債を裏付けとする商品（例：GUSD）。ユーザーは暗号資産をステーキングし、米国債金利に基づく利回りを受け取ります。通常、固定または準固定の APR で、リスクは低いです。

償還可能額の計算

ポジションの償還可能額は mortgage_amount − freeze_amount ではありません。正しい計算式は次のとおりです。

redeemable = mortgage_amount × exchangeRate

exchangeRate は、同じ pid と一致する currency に対する gate-cli cex earn staking find の結果から取得します。商品によっては exchangeRate = 1（例：USDT のフレキシブル商品）ですが、異なる場合もあります（例：リキッドステーキングトークン）。

動的交換レート（exchangeRate ≠ 1）

商品の交換レートが 1 でない場合、その商品は動的レート商品です。ステーキング／償還のレスポンスデータ（スワップ結果または注文一覧）では、amount = ステーキング／償還したベースコインの数量、exchangeAmount（または exchange_amount）= 受け取ったクォートコイン／報酬コインの数量です。

表示ルール（英語のみ）：

• ステーキング：exchangeAmount（ユーザーが受け取る額）を表示します。
• 償還：amount（ユーザーが受け取る額）を表示します。 exchangeRate = 1 の場合、どちらかのフィールドを省略するか、同額として表示できます。単一の金額を表示することを推奨します。

報酬の分配

• reward_delay_days = -1 は、報酬が定期的ではなく、償還時に支払われることを意味します。
• interest_delay_days は、ステーキング後に報酬の発生が始まるまでの遅延期間を示します（通常は 1 日／T+1）。
• 複数コインでの報酬：1 つのポジションから複数のコインで報酬が発生することがあります（例：Compound V3 で USDT をステーキングすると、USDT と COMP を受け取ります）。

GUSD／複数通貨の商品（USDT または USDC）

GUSD（または currency もしくは mortgage_coin が "USDT,USDC" である商品）をステーキング、償還、またはミントする場合：

• ユーザーにコインを選択してもらいます。 対応しているのは USDT と USDC のみです。
• 確認例：「この商品では USDT または USDC を利用できます。どちらを使用しますか？」
• ユーザーが選択したコインを coin パラメーターとしてスワップ（またはミント）ツールに渡します。ユーザーが 2 つのうちどちらかを選ぶまで、ツールを呼び出さないでください。

ポジション：status フィールド

ステーキングポジションを表示する場合（ポジション／残高／保有資産の照会時）、status フィールドは無視し、表示しないでください。ユーザー向けのポジション出力には含めません。

結果のタイムスタンプ

結果にタイムスタンプ関連のフィールドを表示したり、形式を変換したりしないでください。 createStamp、redeem_stamp、updateStamp、should_bonus_stampなど、すべてのタイムスタンプフィールドをユーザー向けの出力から省略してください。タイムスタンプを日付、時刻、相対時間（「YYYY-MM-DD」、「HH:mm」、「2 hours ago」など）に変換しないでください。純粋にタイムスタンプに基づくフィールドは表示しないでください。

数値の形式

カテゴリ	精度	末尾のゼロ	例
一般的な金額（mortgage_amount、freeze_amount、income_total、feeなど）	小数点以下8桁	削除	1.23（1.23000000ではない）、100（100.00000000ではない）
レートフィールド（estimateApr、APY、APR、exchangeRate）	小数点以下2桁	保持	5.20%（5.2%ではない）、8.00%（8%ではない）

ルーティングルール

意図	例となる表現	ルーティング先
ポジション	「ステーキングのポジションを見せて」「ステーキング資産を確認して」「何を償還できますか？」	references/staking-assets.mdを読み込む
報酬	「ステーキング報酬」「昨日の収益」「月間収益」「収益記録」	references/staking-list.md（パート2：報酬一覧）を読み込む
商品	「利用可能なステーキング」「ステーキング可能なコイン」「最良のAPY」「フレキシブルのみ」	references/staking-coins.mdを読み込む
注文履歴	「ステーキング履歴」「ステーキング記録」「償還を表示して」「最近のアクティビティ」	references/staking-list.md（パート1：注文一覧）を読み込む
ステーキング／償還	「1 BTCをステーキング」「100 USDTをステーキング」「ETHを償還」「償還」「ステーキングしたい」「ステーキング解除」「償還を手伝って」	references/staking-swap.mdを読み込み、gate-cli cex earn staking swapを使用します。pidは必須で、side=0（ステーキング）またはside=1（償還）を指定します。ステーキングの前に商品一覧を取得し、同じコインに複数のプロトコルがある場合はユーザーに確認してください
ミント	「mint」「ミントしたい」「Mint」「GTをミント」「ミントを手伝って」	ステーキングと同じです。references/staking-swap.mdにルーティングし、ステーキング（side=0）を実行します。ミントは即時ステーキングを意味します。GUSDの場合は、USDTかUSDCをユーザーに選んでもらい、coinを渡してください
償還のキャンセル（未対応）	「償還をキャンセル」「償還を取り消す」「償還を元に戻す」「償還をキャンセルして」「償還リクエストを取り下げる」	ツールを呼び出さないでください。 英語で返信してください：Cancelling or revoking a redeem is not supported here; please use the Gate website or app if needed. I can help you query positions or order history.
不明確	「ステーキングについて教えて」「オンチェーン運用」	確認する：ポジション／報酬／商品／履歴のどれかを確認してからルーティングします

実行

1. 意図とパラメーター

• モジュール（ポジション／報酬／商品／注文履歴／ステークまたは償還）を特定するか、ユーザーがミントまたは償還のキャンセルを意図しているかを判断します。
• ステーク／償還の意図：ユーザーがステークまたは償還を実行したい場合（例：「1 BTCをステーク」「100 USDTをステーク」「自分のETHを償還」）、references/staking-swap.md に進みます。スワップのワークフローに従います。gate-cli cex earn staking swap には pid が必須です。ステークには side=0、償還には side=1 を使用します。ステークの前に gate-cli cex earn staking find を呼び出し、同じコインに複数のプロトコルがある場合は、それらを一覧表示して、スワップツールを呼び出す前にどの商品（pid）を選ぶかユーザーに確認します。
• ミントの意図：ユーザーがミントしたい場合（例：「ミント」「ミントしたい」「GTをミント」「ミントを手伝って」）は、ステークとして扱います。references/staking-swap.md に進み、ステークのワークフロー（side=0）を実行します。ミントは即時ステークです。ステークと同じ商品選択、金額、GUSD コインのルール（USDT／USDC）が適用されます。
• 償還キャンセルの意図：ユーザーが償還をキャンセルまたは取り消したい場合（例：「償還をキャンセル」「自分の償還を取り消して」「償還を元に戻して」）は、MCP ツールを呼び出してはいけません。英語で次のように返信します："Cancelling or revoking a redeem is not supported here; please use the Gate website or app if needed. I can help you query positions or order history." その後、終了します。
• coin、pid、page、amount を抽出します。注文一覧では type（0=ステーク、1=償還）も抽出します。スワップでは gate-cli cex earn staking swap を呼び出す前に、必ず pid を解決するか確認します。
• 不足している場合：ユーザーがポジション／報酬／商品／履歴／アクションを指定せずに「自分のステーキング」と言った場合は、どれを希望するか尋ねるか、デフォルトでポジションを表示します。

2. ツールの選択

モジュール	MCP ツール	必須	任意のパラメーター
ポジション	gate-cli cex earn staking assets	-	coin、pid
報酬	gate-cli cex earn staking awards	-	coin、pid、page
商品	gate-cli cex earn staking find	-	cointype
注文履歴	gate-cli cex earn staking orders	-	coin、pid、type、page
ステーク／償還	gate-cli cex earn staking swap	pid	amount、side（0=ステーク、1=償還）、coin（GUSD）

• ポジション：償還可能額を表示する際は、gate-cli cex earn staking find を呼び出し（必要に応じて cointype を指定）、各ポジションと同じ pid で、currency が一致する商品を探します。その商品の exchangeRate（または API に応じて exchangeRateReserve）を使用します。償還可能額 = mortgage_amount × 該当レートです。mortgage_amount − freeze_amount は使用しないでください。
• ステーク／償還：references/staking-swap.md を読みます。gate-cli cex earn staking swap には pid が必須です。side は、ステークに 0、償還に 1 を使用します。ステークの前に gate-cli cex earn staking find を呼び出します。同じコインに複数の商品（複数の pid）がある場合は、商品を一覧表示し、スワップを呼び出す前にどの商品を選ぶかユーザーに確認します。償還の前に、ユーザーが pid を指定していない場合は、gate-cli cex earn staking assets を使ってポジションを取得します。複数のポジションがある場合は、どの pid を選ぶかユーザーに尋ねます。
• 応答の構造：ポジション → アイテムの配列（pid、mortgage_coin、mortgage_amount、freeze_amount、income_total、yesterday_income / yesterday_income_multi など）。償還可能額 は mortgage_amount − freeze_amount ではありません。償還可能額 = mortgage_amount × 為替レートです。為替レートは、同じ pid で currency（コイン）が一致する商品の gate-cli cex earn staking find から取得します。注文一覧 → page、pageSize、pageCount、totalCount、list[] を含むオブジェクト。報酬一覧 → page、pageSize、pageCount、totalCount、list[]（pid、mortgage_coin、reward_coin、interest、bonus_date など）を含むオブジェクト。商品 → 配列（pid、currency、estimateApr、minStakeAmount、protocolName、redeemPeriod、productType、isDefi、currencyRewards、exchangeRate など）。

3. 応答形式

• 選択したモジュールの参照ファイルに記載されている応答テンプレートとフィールド名を使用してください。
• ポジション：mortgage_amount、freeze_amount、redeemable（mortgage_amount × 為替レート。同じpidでcurrencyが一致する為替レートを gate-cli cex earn staking find から取得）、income_total、yesterday_incomeを表示します。コインごとにまとめるか、pidごとに表示してください。redeemableの計算にmortgage_amount − freeze_amountを使用しないでください。タイムスタンプフィールドは表示も整形もせず、省略してください（createStamp、updateStampを省略）。statusは表示しないでください（ポジションを表示する際はstatusフィールドを無視してください）。
• 報酬：各リスト項目のreward_coin、interest、bonus_date、pid、mortgage_coinを表示します。reward_coinごとに合計し、該当する場合はtotalCount/page/pageCountを使用してください。タイムスタンプフィールドは表示も整形もせず、省略してください（should_bonus_stampなどを省略）。
• 商品：protocolName、currency、estimateApr、minStakeAmount、maxStakeAmount、redeemPeriod、productType、isDefiを表示します。estimateAprで並べ替えるか、cointypeで絞り込んでください。
• 注文履歴：coin、amount、type（0=Stake、1=Redeem）、status、pid、feeを含むリストを表示します。ページネーションにはtotalCount、page、pageCountを使用してください。タイムスタンプは表示も整形もせず（createStamp、redeem_stampなどを省略）、dynamic-rate商品の場合（exchangeRate ≠ 1）、Stakeではexchange_amount、Redeemではamountを表示してください（Domain Knowledgeを参照）。
• Stake / Redeem：references/staking-swap.mdに従ってください。gate-cli cex earn staking swapを呼び出す前にpid（およびamount）を確認してください。成功またはエラーメッセージは英語で表示してください。dynamic-rate商品の場合、Stakeの確認ではexchangeAmount、Redeemの確認ではamountを表示してください。

レポートテンプレート

各クエリの後に、参照情報に沿った簡潔な標準形式の結果を出力してください（例：ポジションの概要、報酬の概要、商品テーブル、注文リスト）。APIの正確な応答フィールド（referencesを参照）を使用し、ユーザーに正しいフィールド名と値を表示してください。

安全ルール

ユーザー確認の必須要件

ユーザーの明示的な確認なしに、gate-cli cex earn staking swapを絶対に呼び出さないでください。 ユーザーの確認がない場合、読み取り／クエリ操作のみ許可されます。

Stake、Redeem、またはMintを実行する前に、必ず次の手順を実行してください。

1. 操作タイプ（stake/redeem/mint）、商品（pid + protocolName）、コイン、amount、side、主要なリスクに関する注意事項（例：ロック期間、為替レート）をまとめたアクション案を提示します。
2. ユーザーから明示的な確認（例：「Confirm」「Yes」「Go ahead」）を待ちます。
3. 直前のユーザーターンで確認を受け取った場合に限り、gate-cli cex earn staking swapを呼び出します。
4. 確認後にパラメーター（amount、pid、coin）が変更された場合は、以前の確認を無効にし、再確認を求めます。
5. 確認が曖昧、古い、または別のコンテキストのものである場合は、実行せず、新たに確認を求めてください。

Stake、Redeem、Mint

• Stake / Redeem：gate-cli cex earn staking swapでサポートされています。references/staking-swap.mdに従ってください。pidは必須です。side=0（stake）またはside=1（redeem）を使用してください。stakeの前に商品を取得し、同じコインに対して複数のプロトコルがある場合は、swapを呼び出す前に使用する商品（pid）をユーザーに確認してください。すべての応答は英語で行ってください。
• Mint：即時stakeとしてサポートされています。ユーザーからmintを依頼された場合は、Stakeワークフローを実行してください。references/staking-swap.mdに従ってpidとamountを特定し、side=0を指定してgate-cli cex earn staking swapを呼び出します。GUSDの場合は、USDTまたはUSDCのどちらを使用するかユーザーに選択してもらい、coinを渡してください。
• Redeemのキャンセル：サポートされていません。ユーザーからRedeemのキャンセルまたは取り消し（例：償還注文のキャンセル）を依頼された場合は、英語で次のように返信してください："Cancelling or revoking a redeem is not supported here; please use the Gate website or app if needed. I can help you query positions or order history." いかなるツールも呼び出さないでください。

エラー

シナリオ	アクション
ポジションが空（list が空、または totalCount が 0）	「ステーキング中のポジションはありません。利用可能な商品を確認して、収益の獲得を始めましょう。」と表示します。references/staking-coins.md を提案します。
まだ報酬がない	「報酬は見つかりませんでした。通常、ステーキングの 24 時間後から報酬が発生します。」と表示します。必要に応じて、gate-cli cex earn staking assets のポジションを表示します。
商品が見つからない／容量がない	gate-cli cex earn staking find の代替商品を提案します（例：estimateApr による検索）。
API エラー／401	「ステーキングデータを取得できません。しばらくしてからもう一度お試しください。」または「ステーキングデータを表示するにはログインしてください。」と表示します。