mcpField
G
gate-dex-trade

gate-dex-trade

github.com/gateその他48164 回インストール18 週間前に更新
リポジトリ

gate-dex-trade について

gate-dex-tradeは、オンチェーンでトークン交換を実行するユーザー向けのスキルです。MCPで見積もりや取引準備、段階的な署名を進め、残高とリスクの確認を行います。

主な機能

  1. 01同一チェーン・クロスチェーン交換
  2. 02見積もり取得と取引準備
  3. 03段階的な承認と署名
  4. 04取引前の資産・Gas残高確認
  5. 05確認手順とリスク警告

活用シーン

  1. 01トークンを別のトークンに交換
  2. 02クロスチェーン交換を開始
  3. 03取引意図を伴う見積もりの確認

MCP 対応

Gate DEX MCPツールで見積もり、交換取引の準備と確認を行い、段階的な取引チェックインにはGate Web3 GV MCPを使います。明示的にOpenAPIを指定しない限り、MCPが既定です。

インストール

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

$npx skills add https://github.com/gate/gate-skills --skill gate-dex-trade

インストール後、Claude Code で/gate-dex-tradeを入力して読み込まれたか確認します。

同梱ファイル

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

CHANGELOG.md
install.sh
README.md
references/
mcp.md
openapi.md
setup.md
references/openapi/
_shared.md
build.md
errors.md
quote.md
sign.md
sop.md
submit.md
scripts/
check-allowance.py
gate-api-call.py
sign-tx-evm.py
sign-tx-sol.js

詳細

Gate DEX Trade

純粋なルーティングレイヤー — スワップの実行のみです。すべての操作でオンチェーントランザクションが生成されます。仕様はすべて references/ にあります。

一般ルール

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

  • このスキルに明示的に記載されている MCP ツールのみ呼び出してください。 ここに記載されていないツールは、MCP サーバーに存在していても呼び出してはいけません。

トリガーとなるシナリオ：ユーザーがブロックチェーンの状態を変更するトークン交換の実行を希望している場合に使用します。

  • スワップ：「ETHをUSDTにスワップ」「100 USDCをDAIに交換」「自分のBNBを変換」
  • 購入／売却：「ETHを買う」「自分のUSDTを売る」「SOLを購入」
  • クロスチェーン：「ArbitrumからBaseにETHをブリッジ」「クロスチェーンスワップ」
  • スワップ見積もり：「1 ETHでUSDTをいくら受け取れますか」（取引の意図がある場合）

プロジェクトの規約 — MCP のみ（このワークスペース）

ユーザーがOpenAPI／AK／SKを明示的に求めない限り、スワップに OpenAPI を使用しないでください。MCPを利用できない場合は、references/setup.md のみを参照してください。

このスキルの対象ではありません（よくある誤った振り分け）：

  • 「ETHの価格はいくらですか」→ gate-dex-market（読み取り専用の照会で、取引の意図はありません）
  • 「スワップ履歴を確認して」→ gate-dex-wallet（アカウント照会）
  • 「ETHを0xABC...に送金して」→ gate-dex-wallet（直接送金であり、スワップではありません）
  • 「コントラクトを承認して」（スワップの文脈以外）→ gate-dex-wallet（DAppとの連携）

ルーティングフロー

User triggers trading intent
  ↓
Step 1: Has user explicitly specified a mode?
  ├─ Explicitly mentions "OpenAPI" / "AK/SK" / "API Key" → OpenAPI mode
  ├─ Otherwise → MCP only (Step 2)
  └─ Not specified → Step 2
  ↓
Step 2: Is this a cross-chain swap?
  ├─ Cross-chain → Must use MCP mode (OpenAPI doesn't support cross-chain), proceed to Step 3
  └─ Same-chain / uncertain → Step 3
  ↓
Step 3: Gate Wallet MCP Server Discovery & Detection
  a) Scan configured MCP Server list for Servers providing `dex_tx_swap_quote`, `dex_tx_swap_prepare`, and staged swap signing tools (and the Gate GV MCP that exposes `tx_checkin` for staged check-in; see MCP Mode below)
  b) If found → Record server identifier, verify with:
     CallMcpTool(server="<identifier>", toolName="dex_chain_config", arguments={chain: "ETH"})
     ├─ Success → MCP mode
     └─ Failed → Step 4
  c) No matching Server → Step 4
  ↓
Step 4: MCP unavailable → setup guide only (`references/setup.md`), no OpenAPI fallback

モードの振り分け

MCP モード

references/mcp.md を読み、厳密に従い、記載された完全なワークフローに従って実行してください。

対象項目：接続の検出、認証（mcp_token）、MCP のリソース／ツール呼び出し（dex_tx_swap_quote ／ dex_tx_swap_prepare ／ dex_tx_swap_checkin_preview ／段階的な署名・送信／dex_tx_swap_detail）、トークンアドレスの解決、native_in／native_out のルール、3段階の確認ゲートウェイ（SOP）、見積もりテンプレート、リスク警告、スキル間の連携、セキュリティルール。

段階的なスワップのチェックイン — 各段階（必要に応じて approve、続いて swap）で dex_tx_swap_checkin_preview を呼び出した後、プレビューのフィールドを使って Gate Web3 GV MCP ツール tx_checkin を呼び出してください。ユーザー環境にはこの MCP サーバーが含まれている必要があります（tools/list で検出してください）。パラメーターの対応付け： references/mcp.md §4.3 — プレビューの mcp_token を authorization に Bearer <token> として対応付け、user_wallet を wallet_address に、checkin_message を message に対応付けます。source は整数の 3 に設定し、chain ／ chain_category は返された値をそのまま渡してください。GV／製品のドキュメントで空でない値が必須とされていない限り、type は "" に設定してください。ツール結果から data.checkin_token を読み取り（need_otp も処理してください）、その後 dex_tx_swap_sign_approve ／ dex_tx_swap_sign_swap を呼び出してください。GV のチェックインを、生の curl や独自の署名処理で再実装しないでください。

OpenAPI モード（段階的な読み込み）

このワークスペースではデフォルトで無効です。明示的に OpenAPI をリクエストした場合にのみ使用します。

制限：OpenAPI モードは同一チェーン内のスワップのみをサポートし、クロスチェーン取引はサポートしません。

ファイルは段階的に読み込み、現在のステップで必要なものだけを読み込みます。

  1. 最初に必ず読み込む：references/openapi/_shared.md — 環境の検出、認証情報、API 呼び出し方法（ヘルパースクリプト経由）
  2. 次にスワップの段階に応じて読み込む：
段階読み込むファイルタイミング
クエリ（チェーン／ガス）references/openapi/quote.mdユーザーがチェーンまたはガスについて尋ねたとき
スワップ：見積もりの取得references/openapi/quote.md + references/openapi/sop.mdユーザーがスワップを開始したとき
スワップ：トランザクションの構築references/openapi/build.md見積もりの確認後（SOP ステップ 2）
スワップ：トランザクションへの署名references/openapi/sign.md構築の確認後（SOP ステップ 3）
スワップ：送信references/openapi/submit.md署名の完了後
履歴references/openapi/submit.mdユーザーがスワップ履歴を尋ねたとき
  1. エラー時：references/openapi/errors.md

下位互換性のため、従来のモノリシックファイルを references/openapi.md に保持しています。

MCP サーバーのセットアップガイド

MCP の検出に失敗し、セットアップガイドが必要な場合は、references/setup.md を読み込んで表示します。ユーザーの現在のプラットフォームを特定できる場合は、そのプラットフォームの設定のみを表示します。セッションごとに最大 1 回のみ表示します。

サポート対象のチェーン

実際にサポートされるチェーンは、実行時の API／リソースの戻り値によって決まります。

  • MCP モード：swap://supported_chains リソース
  • OpenAPI モード：trade.swap.chain インターフェース

一般的でないチェーンの場合：MCP は dex_chain_config を呼び出し、OpenAPI は trade.swap.chain を呼び出します。

セキュリティルール

  1. 3 段階の確認ゲート：取引ペアの確認 → 見積もりの表示 → 署名の承認。省略できません
  2. 残高の事前確認：取引前に、資産とガストークンが十分であることを必ず確認します
  3. リスク警告：交換価値の差が 5％を超える場合は警告を強制し、高いスリッページ（> 5％）では MEV 攻撃の警告を表示します
  4. 認証と認証情報：gate-runtime-rules.md の §3 に従います。MCP では mcp_token、OpenAPI では AK/SK を使用し、決して混在させません
  5. MCP が失敗した場合、OpenAPI へのフォールバックは行いません（このプロジェクト）
  6. リスク開示（取引結果への記載必須）：デジタル資産の取引には重大なリスクが伴い、投資額の一部または全額を失う可能性があります。このスキルの出力は情報提供のみを目的としており、投資、金融、税務、または法律に関する助言を構成するものではありません。

コメント

Markdown 対応