gate-exchange-launchpool

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 LaunchPool Suite

一般ルール

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

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

スキルの依存関係

使用する gate-cli コマンド

照会操作（読み取り専用）

• gate-cli cex launch pledge-records
• gate-cli cex launch projects
• gate-cli cex launch reward-records

実行操作（書き込み）

• gate-cli cex launch pledge
• gate-cli cex launch redeem

認証

• 対話式のファイル設定： ホスト上で 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 が指定されている場合です。シークレットをチャットに貼り付けるよう、ユーザーに求めてはいけません。
• 権限： Launch: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 を読み、厳密に従ってから、このスキルの LaunchPool ワークフローを実行してください。

• SKILL.md では、ルーティングと製品の仕様を扱います。
• references/gate-cli.md は、プロジェクト／記録の照会、ステークおよび償還の確認ゲート、結果検証に関する、権威ある gate-cli 実行契約です。

モジュールの概要

モジュール	説明	トリガーキーワード
Projects	LaunchPool のプロジェクト一覧を閲覧し、ステータス／APR／コイン／プールの種類で絞り込みます	projects, activities, events, ongoing, ended, warming up, APY, APR, which LaunchPool
Stake	LaunchPool プロジェクトにトークンをステーキングします	stake, participate, join, pledge, contribute, put in
Redeem	プロジェクトにステーキングした資産を早期に償還します	redeem, withdraw, unstake, take out, exit, pull out
Pledge Records	ステーキング／償還の参加履歴を照会します	pledge records, participation history, staking records, my LaunchPool history
Reward Records	エアドロップ報酬の配布履歴を照会します	airdrop, rewards, earnings, reward records, airdrop history, LaunchPool income

ドメイン知識

LaunchPool の概念

概念	説明
LaunchPool	既存のトークンをステーキングして、新しいトークンのエアドロップを獲得できるプラットフォーム機能です。プロジェクトごとに固定のステーキング期間が設けられています。
Project (pid)	特定の新しいトークンを対象とする LaunchPool キャンペーンです。開始／終了時刻、報酬プール総額、ステーキングルールが設定されています。
Reward Pool (rid)	プロジェクト内には、ステーキングするコインごとに異なる報酬プール（例：USDT プール、BTC プール）があります。それぞれに独自の推定 APR が設定されています。
Staking Period	ユーザーがステーキングして報酬を獲得できる期間です。期間終了後に報酬が配布されます。
Estimated APR	rate_year — 報酬プールの推定年利（単利、複利なし）です。ユーザーが口語的に「APY」と表現する場合がありますが、出力では常に「推定 APR」と表示してください。
Newbie Pool	新規ユーザー向けに、参加条件を緩和したりボーナス報酬を付与したりする特別なプールです（limit_rule=1）。
Normal Pool	すべてのユーザーが参加できる標準的なステーキングプールです（limit_rule=0）。
Status (project_state)	プロジェクトのライフサイクルです：準備中（2）→ 進行中（1）→ 終了（3）。リクエストパラメーター status は、0（すべて）および4（進行中＋準備中）にも対応しています。
Personal Limit	報酬プールごとのユーザーあたりのステーキング額の上限／下限です（personal_max_amount／personal_min_amount）。
Transaction Config	ユーザーの**過去60日間の取引総額（USD）**に基づく段階的な参加条件です。各段階では transaction_amount のしきい値と、それに対応する mortgage_limit（個人のステーキング上限。単位は報酬プールのステーキング用 coin に準じます）が定義されています。ユーザーの取引量が最も低い段階のしきい値を下回る場合、ステーキング上限は 0 となり、参加資格がありません。transaction_config 配列は任意項目で、一部の報酬プールにのみ設定されています。

タイムスタンプの書式

プレッジ／報酬レコードの create_timest フィールドと reward_timest フィールドは、API によって事前に書式設定された文字列です（例：「2026-03-16 09:32:22」）。データ行ではそのまま表示し、各値の末尾に付けるのではなく、テーブルのヘッダーに「(UTC)」を記載してください。

プロジェクトの時間フィールド（start_timest、end_timest）は内部データです。ユーザーには表示しないでください。

報酬レコードの時間パラメーター：報酬レコード API では、start_time／end_time に整数の Unix タイムスタンプが必要です。計算ミスが起きやすいため、references/records.md のタイムスタンプ戦略（戦略1：最近のクエリでは時間パラメーターを省略、戦略2：過去の期間にはアンカーテーブルを使用）に従ってください。アンカーテーブルを使わずに、Unix タイムスタンプを頭の中で計算しようとしないでください。

数値の書式

カテゴリー	精度	例
金額（ステーキング、償還、報酬）	小数点以下8桁。末尾のゼロは省略	1.23000000 ではなく 1.23
レートフィールド（推定 APR）	小数点以下2桁。末尾のゼロは保持	5.2% ではなく 5.20%

ルーティングルール

インテント	例となるフレーズ	ルーティング先
プロジェクトの閲覧	「LaunchPool のプロジェクトを表示」「現在開催中の LaunchPool イベントは？」「APR が最も高い LaunchPool」「USDT の LaunchPool はある？」「初心者向けのプールプロジェクト」	references/launch-projects.md を読む
ステーキング	「LaunchPool の BTC プロジェクトに 500 USDT をステーキング」「LaunchPool に参加したい」「LaunchPool に 1000 USDT を入れる」	references/stake-redeem.md を読む（Stake セクション）
償還	「LaunchPool の BTC ステーキングを償還」「LaunchPool から出金」「LaunchPool の USDT をステーキング解除」	references/stake-redeem.md を読む（Redeem セクション）
プレッジ記録	「先月の LaunchPool 参加履歴」「LaunchPool のステーキング記録を表示」「BTC LaunchPool のプレッジ履歴を確認」	references/records.md を読む（パート 1：プレッジ記録）
報酬記録	「LaunchPool のエアドロップ報酬」「今月の LaunchPool の収益を確認」「BTC LaunchPool のエアドロップを表示」	references/records.md を読む（パート 2：報酬記録）
不明確	「LaunchPool」「launch pool」	確認する：プロジェクト／ステーキング／償還／プレッジ記録／報酬記録のどれかを確認してからルーティング

実行

1. インテントとパラメーター

• モジュール（プロジェクト／ステーキング／償還／プレッジ記録／報酬記録）を特定します。
• ステーキングのインテント：ユーザーがトークンのステーキングを希望する場合は、references/stake-redeem.md の Stake セクションにルーティングします。プロジェクトの特定、数量、ユーザーの確認が必要です。
• 償還のインテント：ユーザーが償還を希望する場合は、references/stake-redeem.md の Redeem セクションにルーティングします。プロジェクトの特定、数量、ユーザーの確認が必要です。
• パラメーターを抽出します：coin、pid、rid、amount、status、sort_type、limit_rule、page、start_time、end_time。
• 指定漏れ：ユーザーがインテントを指定せずに「LaunchPool」と言った場合は、どの操作を希望するかを尋ねるか、デフォルトでプロジェクトを表示します。

2. ツールの選択

モジュール	MCP ツール	必須パラメーター	任意パラメーター
プロジェクト	gate-cli cex launch projects	page、page_size	status、sort_type、mortgage_coin、search_coin、limit_rule
ステーキング	gate-cli cex launch pledge	body（JSON：pid、rid、amount）	—
償還	gate-cli cex launch redeem	body（JSON：pid、rid、amount）	—
プレッジ記録	gate-cli cex launch pledge-records	—	coin、type、start_time、end_time、page、page_size
報酬記録	gate-cli cex launch reward-records	page、page_size	coin、status、start_time、end_time

• ステーキング：まず gate-cli cex launch projects を呼び出して対象プロジェクトの pid と報酬プールの rid を特定します。次にプレビューを表示し、確認を待ってから gate-cli cex launch pledge を呼び出します。
• 償還：償還内容のプレビューを表示し、確認を待ってから gate-cli cex launch redeem を呼び出します。

3. 応答の形式

• 選択したモジュールの参照ファイルにある 応答テンプレート とフィールド名を使用します。
• プロジェクト：name、project_state、total_amount、days を表示し、各報酬プールについて coin、rate_year、already_buy_total_amount、personal_max_amount／personal_min_amount、transaction_config を表示します。start_timest／end_timest、pid、rid は表示しないでください。
• ステーキング／償還：まず注文のプレビューを表示し、その後に確認結果を表示します。ステーキングでは flow_id が返され、償還では success のブール値が返されます。
• プレッジ記録：create_timest、reward_coin、coin、amount、type（1＝ステーキング、2＝償還）を表示します。注：API はプロジェクト名を返しません。
• 報酬記録：reward_timest、coin（報酬のコイン）、valid_mortgage_amount、amount_base、amount_ext を表示します。注：API はプロジェクト名を返しません。

レポートテンプレート

各操作の後に、参照に沿った短い標準形式の結果を出力してください（例：プロジェクト一覧テーブル、ステーク確認、償還確認、プレッジ記録一覧、報酬記録一覧）。API の正確なレスポンスフィールドを使用し（参照を確認）、ユーザーに正しいフィールド名と値を表示してください。

言語への適応：常にユーザーの入力と同じ言語で応答してください。参照ファイルのレスポンステンプレートは、表示する構成とフィールドを定めるものであり、出力言語そのものを定めるものではありません。表示ラベルはすべて、ユーザーの言語に合わせて翻訳してください。

翻訳しないでください（言語にかかわらず、そのまま維持してください）：

• 製品名：LaunchPool
• API の通貨記号：USDT、GT、BTC、DOGE など
• API の name フィールドにあるプロジェクト名（例：「DOGE」、「USDT-rudy」）
• 技術 ID とその値：pid、rid、flow_id（内部使用のみ、ユーザーには表示しないでください）
• (UTC) 接尾辞を含むタイムスタンプ形式
• API エラーラベル：INVALID_PARAM_VALUE、INSUFFICIENT_BALANCE、INVALID_CREDENTIALS、PROJECT_NOT_FOUND
• 数値、パーセンテージ、取引高のしきい値における単位 USD

その他の表示ラベルはすべて、ユーザーの言語に合わせて翻訳してください。

エラー処理

API エラーラベル

API は label フィールドを含む構造化エラーを返します。以下のように対応してください。

API ラベル	ユーザー向けメッセージ
INVALID_PARAM_VALUE	「リクエストパラメーターが無効です。入力内容を確認して、もう一度お試しください。」
INVALID_CREDENTIALS	「LaunchPool の機能を利用するには、ログインしてください。」
INSUFFICIENT_BALANCE	「残高が不足しています。先に入金してください。」
PROJECT_NOT_FOUND	「指定された LaunchPool プロジェクトが見つかりませんでした。」

結果が空の場合の処理

シナリオ	対応
プロジェクト一覧が空	「条件に一致する LaunchPool プロジェクトはありません。フィルターを変更するか、しばらくしてからもう一度ご確認ください。」
プレッジ記録が空	「LaunchPool の参加記録はありません。募集中のプロジェクトを閲覧して、参加してみましょう。」
報酬記録が空	「エアドロップ報酬は見つかりませんでした。報酬は通常、ステーキング期間の終了後に配布されます。」
コンプライアンス上の制限	「コンプライアンス上の制限により、お住まいの地域では LaunchPool をご利用いただけません。」
ステーク上限超過	「このプロジェクトには個人ごとのステーキング上限があります。金額を減らしてください。」
API エラー／401	「LaunchPool のデータを取得できませんでした。しばらくしてからもう一度お試しください。」または「LaunchPool の機能を利用するには、ログインしてください。」

安全に関するルール

確認必須

• ステークと償還は書き込み操作です。 gate-cli cex launch pledge または gate-cli cex launch redeem を呼び出す前に、必ず注文内容のプレビューを表示し、ユーザーの明示的な確認を待ってください。
• プレビュー形式：プロジェクト名、ステーキング通貨、金額、予想 APR（ステークの場合）、ステーキング期間。
• 続行するには「confirm」、中止するには「cancel」と返信するようユーザーに求めてください。
• 明示的な確認を受け取った後に限り、API を呼び出してください。

コンプライアンス

• API がコンプライアンスまたは地域制限のエラーを返した場合は、ユーザーに配慮したメッセージを表示してください：「コンプライアンス上の制限により、お住まいの地域では LaunchPool をご利用いただけません。」再試行しないでください。