gate-dex-wallet

Gate DEX ウォレット

純粋なルーティングレイヤー — この SKILL.md は軽量なルーターです。すべてのサブモジュールの詳細は references/ にあります。

一般ルール

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

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

署名ゲート — Gate Verify MCP（必須）

dex_wallet_sign_transaction、dex_wallet_sign_message、または dex_tx_x402_fetch（署名ツールのみ。dex_tx_x402_checkin_preview は署名呼び出しではなく、事前の tx_checkin は不要です）への あらゆる MCP 呼び出しの前に、次の手順を実施してください。

1. ユーザーは、その操作に対する既存の確認ゲート（プレビュー／メッセージ本文／支払いの意図）を通過する必要があります。
2. エージェントは Gate Verify HTTP MCP サーバー（MCP サーバー接続の検出の Gate Verify MCP を参照）のツール /v1/tx/checkin または tx_checkin を、references/tx-checkin.md に従って必ず呼び出し、その成功を 必須条件 として扱ってください。従来の tx-checkin シェルバイナリを実行したり、ユーザーにローカルのチェックインコマンドを実行するよう求めたりしてはいけません。設定済み MCP サーバーをスキャンし、tools/list にチェックインツールが含まれるサーバーを検出してください。認証： チェックインツールの arguments で authorization を渡してください。その値は、ウォレット MCP 呼び出しと同じ mcp_token にします。ウォレットサーバーの HTTP headers を Verify MCP エントリにコピーしてはいけません。references/tx-checkin.md を参照してください。
3. dex_tx_transfer_preview の後、チェックインの message 引数には、プレビューのフィールド txBundle の文字列のみを指定してください。unsigned_tx_hex やその他のフィールドから txbundle JSON を組み立ててはいけません（references/tx-checkin.md を参照）。
4. x402（dex_tx_x402_fetch）：402 を調べるために、最初に dex_tx_x402_fetch を呼び出してはいけません。EVM exact／EIP-3009（例：Base 上の CoinGecko Pro x402）の場合、まずウォレット MCP の dex_tx_x402_checkin_preview を呼び出してください。これは tx_checkin のペイロード（正しい 64 桁の 16 進数 message を含む）と x402_payment_required_b64 を返すため、エージェントが EIP-3009 ダイジェストを手作業で組み立てる必要はありません。次に、プレビューから返された tx_checkin のフィールドとともに authorization（同じ mcp_token）を使用して、Gate Verify の /v1/tx/checkin／tx_checkin を完了してください。その後、プレビューと同じ url／method／body／headers、Verify から取得した checkin_token、およびプレビュー結果と同じ x402_payment_required_b64 を指定して dex_tx_x402_fetch を呼び出してください。POST JSON の場合は、プレビューと fetch の両方で、headers JSON に Content-Type: application/json を含めてください（よくある 415 エラーを回避できます）。完全な呼び出し順序と Solana／upto の例外については、references/x402.md と references/tx-checkin.md を参照してください。
5. 内部で署名するその他の単一ステップ MCP ツール：ゲートウェイで必要な場合は、ウォレット MCP ツールの直前に同じ /v1/tx/checkin 呼び出しを行ってください。checkin_token／意図のペイロードについては、バックエンドのドキュメントに従ってください。

該当するシナリオ

ユーザーがオンチェーンウォレットのアカウント、ID、または資産を管理したい場合に、このスキルを使用します。

• 認証またはセッションの管理（Google または Gate OAuth でのログイン、ログアウト）
• トークン残高、ポートフォリオ総額、またはウォレットアドレスの照会
• 取引履歴または過去のスワップ記録の表示
• アドレスへのトークンの送金（単一または一括）。署名の前にGate Verify MCP のチェックイン（/v1/tx/checkin）が必須です（references/tx-checkin.md）
• オンチェーンでGate Exchange アカウントへ出金または換金（UID に基づいて入金アドレスを解決します。このスキルでは CEX 内の残高移動は扱いません）
• x402 プロトコルによる HTTP 402 リソースの支払い（EVM exact/upto、Solana exact/upto）。dex_tx_x402_checkin_preview（EVM EIP-3009）の後にGate Verify MCP のチェックインを行い、その後**dex_tx_x402_fetch**を実行します（references/x402.md、references/tx-checkin.md）
• DApp とのやり取り（ウォレット接続、メッセージ署名、トークンの承認、コントラクト呼び出し）
• 上記のいずれかに gate-wallet CLI ツールを使用
• MCP サーバーの接続状態の検出または設定

---

機能の範囲

対応	非対応（別の場所に案内）
認証とセッション管理	トークン価格／K 線の照会 -> gate-dex-market
残高とアドレスの照会	トークンスワップの実行 -> gate-dex-trade
取引履歴とスワップ履歴	トークンのセキュリティ監査 -> gate-dex-market
トークン送金（EVM + Solana）、Gate Exchange へのオンチェーン出金（入金アドレスを使用するフロー）
x402 支払い（EVM exact/upto + Solana exact/upto）
DApp とのやり取りと承認
CLI のデュアルチャネル操作

---

モジュールへの振り分け

ユーザーの意図に基づいて、対応するサブモジュールに振り分けます。

ユーザーの意図	対象
ログイン、ログアウト、サインイン、サインアウト、トークンの期限切れ、セッションの期限切れ、OAuth、Google ログイン、Gate ログイン、認証、再ログイン、アカウントの切り替え、「ウォレットにアクセスできない」、「ログインしていない」	references/auth.md
残高の確認、総資産、ポートフォリオの価値、ウォレットアドレス、自分のアドレス、いくら持っているか、自分のトークンの表示、tx 履歴、取引履歴、スワップ履歴、過去の取引、「自分が所有しているもの」、「ETH をいくつ持っているか」、「自分のコインの一覧」、「保有資産の表示」	references/asset-query.md
Gate Exchange への出金、自分の Gate アカウントへの換金、取引所の入金アドレスへの送金、ウォレットから Gate へのコインの移動（オンチェーン入金）、出金用の Gate UID の紐付けまたは再紐付け	references/withdraw.md
送金、トークンの送金、アドレスへの送金、一括送金、「0x... に 1 ETH を送金」、「USDT を送金」、「トークンを移動」、「誰かに支払う」、「友人に暗号資産を送る」（任意または既知のオンチェーンアドレス。取引所の入金アドレスの解決は対象外）	references/transfer.md + 署名前に references/tx-checkin.md
あらゆる署名：dex_wallet_sign_transaction／dex_wallet_sign_message の前、checkin_token、Gate Verify /v1/tx/checkin	references/tx-checkin.md（署名の前に読む）
402 支払い、x402 支払い、支払いが必要、API の支払い、URL の支払い、「取得して支払う」、「この URL を呼び出して支払う」、「有料エンドポイント」、「アクセス料金の支払い」、「HTTP 402」、Permit2 支払い、upto 支払い	references/x402.md（dex_tx_x402_checkin_preview → references/tx-checkin.md → dex_tx_x402_fetch）
DApp 接続、ウォレット接続、メッセージ署名、承認、承認の取り消し、コントラクト呼び出し、EIP-712、Permit、personal_sign、「Uniswap とのやり取り」、「流動性の追加」、「Lido でのステーキング」、「NFT のミント」、「DApp ログイン用の署名」、コントラクトの認可	references/dapp.md + 署名の前に references/tx-checkin.md
gate-wallet CLI、コマンドライン、ターミナル、openapi-swap、ハイブリッドスワップ、「CLI を使用」、「コマンドを実行」、「gate-wallet balance」、スクリプトの自動化、npm gate-wallet	references/cli.md

---

MCP サーバー接続の検出

セッションで最初の MCP ツールを呼び出す前に、接続プローブを 1 回実行します。

1. 検出：設定済みの MCP サーバーをスキャンし、ツール dex_wallet_get_token_list、dex_tx_quote、dex_tx_swap を探します。
2. 識別：柔軟なサーバー名（gate-wallet、gate-dex、dex、wallet、user-gate-wallet、または任意のカスタム名）を受け入れます。
3. 検証：CallMcpTool(server="<id>", toolName="dex_chain_config", arguments={chain: "eth"}) を呼び出します。

結果	アクション
成功	サーバー識別子を記録し、このセッションの以降のすべての呼び出しで使用します
失敗	以下のセットアップガイドを表示します（セッションあたり最大 1 回）。次のセッションで再検出します

OpenClaw プラットフォームの検出

OpenClaw／mcporter プラットフォームが検出された場合、MCP の呼び出しは mcporter 経由でルーティングします。

CallMcpTool(server="mcporter", toolName="call_tool", arguments={
  server: "<gate-dex-server>",
  tool: "<tool_name>",
  arguments: { ...params }
})

セットアップガイド（検出失敗時に 1 回表示）

Gate DEX MCP Server:
  URL:  https://api.gatemcp.ai/mcp/dex
  Type: HTTP

  Cursor:      Settings -> MCP -> Add server, or edit ~/.cursor/mcp.json
  Claude Code:  claude mcp add --transport http gate-dex --scope project https://api.gatemcp.ai/mcp/dex
  Codex CLI:    codex mcp add gate-dex --transport http --url https://api.gatemcp.ai/mcp/dex

Gate Verify MCP（署名前の確認）

トランザクションの署名前確認にのみ使用する、2 つ目の HTTP MCP サーバーを追加します（references/tx-checkin.md）。

Gate Verify MCP:
  URL:  https://api.gatemcp.ai/mcp/dex/sec
  Type: HTTP

  Cursor:      Settings -> MCP -> Add server (URL only is fine for check-in; pass mcp_token as tool arg authorization per references/tx-checkin.md)
  Tool name:   /v1/tx/checkin or tx_checkin  (discover via tools/list; server name is user-defined, e.g. gate-dex-sec)

セッションで最初の確認を行う前に、設定済みの MCP サーバーをスキャンし、tools/list に tx_checkin または /v1/tx/checkin が含まれるサーバーを特定して、Verify サーバー ID を解決します。

実行時のエラー処理

エラーの種類	キーワード	アクション
MCP サーバーが未設定	server not found, unknown server	セットアップガイドを表示します
リモートサービスに接続できない	connection refused, timeout, DNS error	サーバーの状態とネットワークを確認するよう案内します
認証失敗	400, 401, unauthorized	gate-runtime-rules.md の §3 に従います

---

その後のルーティング

操作の完了後、ユーザーに関連する次のアクションを 2～4 件積極的に提案します（テンプレートについては各モジュールの「操作後の提案」セクションを参照してください）。その後、ユーザーの応答に応じてルーティングします。

操作後のユーザーの意図	対象
トークン価格、K 線チャート、時価総額、取引高を確認する	gate-dex-market
トークンのセキュリティ監査を実行する、トークンが安全か確認する	gate-dex-market
任意のオンチェーンアドレスにトークンを送金する	references/transfer.md
オンチェーン資産を Gate Exchange に出金する、現金化する	references/withdraw.md
DEX でトークンをスワップ、交換、購入、売却、変換する	gate-dex-trade
402 リソース、x402 決済の支払いを行う	references/x402.md（プレビュー → references/tx-checkin.md → 取得）
DApp とやり取りする、ウォレットを接続する、署名する、承認する	references/dapp.md
署名の前に必須となる Gate Verify MCP の確認、checkin_token	references/tx-checkin.md
ログイン、再ログイン、期限切れの認証を修正する、アカウントを切り替える	references/auth.md
CLI コマンド、gate-wallet のターミナル操作を使用する	references/cli.md
残高を確認する、資産や取引履歴を表示する	references/asset-query.md

---

このスキルの対象外（よくある誤ルーティング）

次の意図では、このスキルを起動しないでください。

ユーザーの意図	適切なスキル
「ETH の価格は？」／「BTC のチャートを表示して」／「トークンランキング」	gate-dex-market
「ETH を USDT にスワップして」／「SOL を買って」／「トークンを交換して」／「DEX 取引」	gate-dex-trade
「このトークンは安全？」／「コントラクト 0x... を監査して」／「ハニーポットを確認して」	gate-dex-market
「値上がり上位を表示して」／「新規トークンの上場情報」／「マーケット概要」	gate-dex-market

---

対応チェーン

EVM：eth、bsc、polygon、arbitrum、optimism、avax、base | 非 EVM：sol

---

セキュリティルール

1. 認証を最優先：すべての操作の前に mcp_token の有効性を確認してください。失敗した場合は、gate-runtime-rules.md の§3に従ってください。
2. トークンの機密保持：mcp_token を平文で表示しないでください。<mcp_token> のようなプレースホルダーを使用してください。
3. MCP サーバーのエラー：すべての MCP サーバーのエラーメッセージをユーザーにそのまま表示してください。決して隠したり、変更したりしないでください。
4. トランザクションの不可逆性：デジタル資産のオンチェーントランザクションは、一般に取り消せません。送金、出金、または x402 署名を行う前に、受取人のアドレス（または支払い URL／資産）を確認するようユーザーに伝えてください。送信後は取り消せません。
5. AI 出力に関する免責事項：残高、履歴、分析に関する出力は一般的な情報提供のみを目的としています。Gate による表明、保証、確約を構成するものではなく、投資、金融、税務、法律に関する助言でもありません。