gate-dex-trade-cli

Gate DEX CLI — スワップ

一般的なルール

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

• このスキルに明示的に記載されている MCP ツールのみを呼び出してください。 MCP サーバーに存在していても、ここに記載されていないツールを呼び出してはいけません。
• このスキルおよびその参照先に明示的に記載されている gate-dex CLI サブコマンドのみを使用してください。 他のインターフェースで実行できる場合でも、これらのワークフローでは、記載されていないコマンドを実行してはいけません。

CLI を使った、1 回の操作で完了する DEX スワップです。GV チェックイン、署名、ブロードキャストはすべて swap コマンドに組み込まれています。外部の tx-checkin バイナリは必要ありません。EVM と Solana に対応しています。

スキルの範囲

このスキル	他のスキルへの案内
トークンのスワップ（同一チェーン）	認証／ログインの問題 → gate-dex-wallet-cli
クロスチェーンブリッジ	残高、アドレス、トークン一覧 → gate-dex-wallet-cli
スワップ見積もり（プレビュー）	トークンの送金（送信） → gate-dex-wallet-cli
スワップ／ブリッジ履歴と注文詳細	K 線、トークン情報、トークンのセキュリティ → gate-dex-market-cli
スワップ可能なトークンとブリッジトークンの検索	—

---

対象となるシナリオ

• 「ETH を USDT にスワップ」「トークンを交換」「SOL を購入」「変換」「取引」
• 実行前にスワップ見積もりを取得する
• スワップ履歴または特定のスワップ注文の詳細を確認する
• スワップ可能なトークンまたはクロスチェーンブリッジトークンを一覧表示する

---

CLI コマンド

見積もり（プレビューのみ、署名なし）

# EVM: swap native ETH → USDT on Ethereum (chain_id = 1)
gate-dex quote --from-chain 1 --to-chain 1 --from - --to 0xdAC17F958D2ee523a2206206994597C13D831ec7 --amount 0.01

# EVM: swap USDT → USDC on Arbitrum
gate-dex quote --from-chain 42161 --to-chain 42161 \
  --from 0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9 \
  --to 0xaf88d065e77c8cC2239327C5EDb3A432268e5831 \
  --amount 100

# Solana: swap native SOL → USDC
gate-dex quote --from-chain 501 --to-chain 501 --from - \
  --to EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v --amount 0.1

# Cross-chain bridge: ETH on Ethereum → USDT on Arbitrum
gate-dex quote --from-chain 1 --to-chain 42161 --from - \
  --to 0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9 --amount 0.1 \
  --to-wallet 0xYourArbitrumAddress

推定出力量、価格への影響、ルート、手数料を返します。署名は行いません。

1 回の操作で完了するスワップ（見積もり + GV チェックイン + 署名 + ブロードキャスト）

# EVM: swap native ETH → USDT
gate-dex swap --from-chain 1 --to-chain 1 --from - \
  --to 0xdAC17F958D2ee523a2206206994597C13D831ec7 --amount 0.01

# EVM: swap ERC20 with custom slippage
gate-dex swap --from-chain 42161 --to-chain 42161 \
  --from 0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9 \
  --to 0xaf88d065e77c8cC2239327C5EDb3A432268e5831 \
  --amount 100 --slippage 0.005

# Solana: swap SOL → USDC
gate-dex swap --from-chain 501 --to-chain 501 --from - \
  --to EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v --amount 0.05

# Cross-chain bridge: ETH on Ethereum → USDT on Arbitrum
gate-dex swap --from-chain 1 --to-chain 42161 --from - \
  --to 0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9 --amount 0.1 \
  --to-wallet 0xYourArbitrumAddress

オプション	必須	説明
--from-chain <id>	はい	送信元チェーン ID
--to-chain <id>	いいえ	宛先チェーン ID（デフォルトは from-chain と同じ）
--from <token>	はい	送信元トークンのコントラクト。ネイティブトークン（ETH/SOL/BNB）には - を使用
--to <token>	はい	宛先トークンのコントラクト
--amount <n>	はい	人が読み取れる形式の入力金額
--slippage <n>	いいえ	小数で指定するスリッページ許容度（デフォルトは 0.03 = 3%）
--native-in <0|1>	いいえ	送信元トークンがネイティブの場合は 1（ETH/SOL）。デフォルトは 0
--native-out <0|1>	いいえ	宛先トークンがネイティブの場合は 1。デフォルトは 0
--wallet <addr>	いいえ	送信元ウォレットアドレス（認証情報から自動検出）
--to-wallet <addr>	いいえ	宛先ウォレットアドレス（クロスチェーンブリッジでは必須）

スワップ履歴

gate-dex swap-history

スワップ注文の詳細

gate-dex swap-detail <order_id>

スワップ可能なトークンの一覧表示

gate-dex swap-tokens
gate-dex swap-tokens --chain eth
gate-dex swap-tokens --chain sol --search USDC

--search を使って、シンボルからトークンアドレスを検索します。

クロスチェーンブリッジトークンの一覧表示

gate-dex bridge-tokens
gate-dex bridge-tokens --src-chain eth --dest-chain arb

---

swap コマンドの内部フロー

エージェントがこれらの手順を手動で実行することはありません。すべて CLI が処理します。

EVM same-chain flow:
1. Load auth; fetch wallet address
2. Get quote
3. Check if ERC20 approve is needed → auto-approve if needed (GV checkin for approve)
4. Re-quote after approve
5. Build swap transaction
6. GV security checkin (built-in) for swap tx
7. Server-side signing
8. Broadcast
9. Print tx hash + order ID

EVM cross-chain bridge flow (from-chain ≠ to-chain):
1. Load auth; fetch wallet address
2. Get cross-chain bridge quote (--from-chain / --to-chain / --to-wallet required)
3. Check if ERC20 approve is needed on source chain → auto-approve if needed
4. Build bridge transaction on source chain
5. GV security checkin (built-in)
6. Server-side signing
7. Broadcast on source chain
8. Print source tx hash + order ID (destination arrival is async, monitor via swap-detail)

Solana flow:
1. Load auth; fetch Solana address
2. Get quote
3. Build transaction (base64 → base58 conversion handled internally)
4. GV security checkin (built-in, includes priority fee)
5. Server-side signing
6. Broadcast via Solana mainnet RPC
7. Print tx hash + order ID

重要：実行する tx-checkin バイナリはありません。swap の前にチェックイン用バイナリを実行しようとしないでください。CLI には GV チェックインが組み込まれています。

---

チェーン ID

チェーン	ID	ネイティブトークン
Ethereum	1	ETH
BSC	56	BNB
Polygon	137	MATIC
Arbitrum	42161	ETH
Optimism	10	ETH
Avalanche	43114	AVAX
Base	8453	ETH
Solana	501	SOL

ネイティブトークンのアドレス：ネイティブトークン（ETH、SOL、BNB など）のトークンアドレスには - を使用します。

---

スリッページのガイドライン

トークンの種類	推奨スリッページ
ステーブルコイン（USDT ↔ USDC）	0.005（0.5%）
主要トークン（ETH、BTC、SOL）	0.01–0.03（1%–3%）
ミッドキャップトークン	0.03（3%）
ミーム／流動性の低いトークン	0.05–0.10（5%–10%）

---

一般的なトークンアドレス

チェーン	USDT	USDC
Ethereum (1)	0xdAC17F958D2ee523a2206206994597C13D831ec7	0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48
Arbitrum (42161)	0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9	0xaf88d065e77c8cC2239327C5EDb3A432268e5831
BSC (56)	0x55d398326f99059fF775485246999027B3197955	0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d
Solana (501)	Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB	EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v

---

ワークフロー

ステップ 1：認証チェック

gate-dex status を呼び出してセッションを確認します。

抽出する主なデータ：

• is_authenticated：ブール値
• ログインしていない場合 → gate-dex login を実行するようユーザーに案内します（gate-dex-wallet-cli に委任）。

ステップ 2：パラメーターの収集

必須：from-chain、to-chain（デフォルトは from-chain）、from-token、to-token、amount。任意：slippage、to-wallet（クロスチェーンの場合のみ）。

トークンシンボルが指定され、アドレスがない場合 → gate-dex swap-tokens --chain <chain> --search <symbol> を呼び出し、解決されたアドレスをユーザーに確認します。

抽出する主なデータ：

• from_chain、to_chain、from_token、to_token、amount、slippage、to_wallet

ステップ 3：見積もりの取得

gate-dex quote --from-chain <id> --to-chain <id> --from <token> --to <token> --amount <n> を呼び出します。

抽出する主なデータ：

• estimated_out、price_impact、route、fee、slippage_used

ステップ 4：チャットでのユーザー確認（必須）

スワップ確認テンプレートを表示し、明示的な「confirm」の返信を待ちます。

• 「cancel」→中止します。
• 「modify」→ステップ 2 に戻ります。

ステップ 5：実行

gate-dex swap --from-chain <id> --to-chain <id> --from <token> --to <token> --amount <n> [--slippage <n>] [--to-wallet <addr>] を呼び出します。CLI が GV のチェックイン、署名、ブロードキャストを内部で処理します。

抽出する主なデータ：

• tx_hash、order_id、explorer_url

ステップ 6：レポートの表示

以下のレポートテンプレートに従って出力を整形します。必須のリスク開示を表示します。

ステップ 4 でユーザーから明示的な確認を受ける前に、gate-dex swap を絶対に実行しないでください。

---

判断ロジックの概要

ユーザーの意図	トリガーフレーズ	アクション
同一チェーンのスワップ	同じチェーンでの「swap」、「exchange」、「convert」、「buy」、「sell」	見積もり → 確認 → スワップ（ステップ 3～5）
クロスチェーンブリッジ	「bridge」、「cross-chain」、異なる from-chain / to-chain	bridge-tokens → 見積もり（--to-wallet を指定）→ 確認 → スワップ
見積もりのみ	実行の意図を伴わない「how much would I get」、「estimate」、「preview」	ステップ 3 のみ。実行しないでください
トークンアドレスの解決	「what's the address」、「find token X」	gate-dex swap-tokens --search
スワップ可能なトークンの一覧表示	「what tokens can I swap」	gate-dex swap-tokens
ブリッジペアの一覧表示	「what cross-chain pairs are supported」	gate-dex bridge-tokens
注文履歴	「my swap history」、「past trades」	gate-dex swap-history
注文の詳細	「details of order X」、ブリッジの決済確認	gate-dex swap-detail <order_id>
認証失敗	CLI からの Not logged in	ログインのため gate-dex-wallet-cli に案内

---

スワップ確認テンプレート

========== Swap Confirmation ==========
From:     {amount} {from_symbol} on {from_chain}
To:       ~{estimated_out} {to_symbol} on {to_chain}
Slippage: {slippage}%
Route:    {route_path}
Fee:      {fee_usd} USD
========================================
Reply "confirm" to execute, "cancel" to abort.

---

レポートテンプレート

swap の呼び出しが成功した後：

========== Swap Result ==========
Status:       Submitted
From:         {amount} {from_symbol} on {from_chain}
To:           ~{estimated_out} {to_symbol} on {to_chain}
Tx hash:      {tx_hash}
Explorer:     {explorer_url}
Order ID:     {order_id}
=================================
{Cross-chain note (if applicable): destination arrival is asynchronous; track via gate-dex swap-detail <order_id>.}

Risk Disclosure: Digital asset trading involves significant risk and may result in partial or total loss of your investment. For informational purposes only; not investment, financial, tax, or legal advice.

quote の場合（プレビューのみ）：

========== Swap Quote (Preview) ==========
{Same fields as Swap Confirmation Template}
==========================================
No transaction has been signed or broadcast.

swap-history / swap-detail の場合：注文 ID、チェーンペア、トークンペア、ステータス、タイムスタンプを簡潔なリストまたはテーブルで表示します。

---

会話例

例 1：Ethereum で ETH → USDT に交換 ユーザー：「Ethereum で 0.01 ETH を USDT に交換して」

1. gate-dex quote --from-chain 1 --to-chain 1 --from - --to 0xdAC17... --amount 0.01
2. 見積もりをユーザーに提示し、「confirm」を待ちます。
3. gate-dex swap --from-chain 1 --to-chain 1 --from - --to 0xdAC17... --amount 0.01
4. tx ハッシュ、etherscan リンク、注文 ID を表示します。

例 2：SOL → USDC に交換 ユーザー：「0.1 SOL を USDC に交換して」

1. gate-dex quote --from-chain 501 --to-chain 501 --from - --to EPjFWdd5... --amount 0.1
2. 見積もりを提示し、ユーザーの確認を待ちます。
3. gate-dex swap --from-chain 501 --to-chain 501 --from - --to EPjFWdd5... --amount 0.1
4. tx ハッシュと solscan リンクを表示します。

例 3：不明なトークンシンボル ユーザー：「Arbitrum で 10 USDT を ARB に交換して」

1. gate-dex swap-tokens --chain arb --search ARB → ARB のコントラクトアドレスを取得します。
2. 解決したアドレスを使って、見積もりと交換に進みます。

例 4：クロスチェーンブリッジで ETH（Ethereum）→ USDT（Arbitrum） ユーザー：「Ethereum から Arbitrum 上の USDT に 0.1 ETH をブリッジして」

1. gate-dex bridge-tokens --src-chain eth --dest-chain arb → トークンペアに対応していることを確認します。
2. gate-dex quote --from-chain 1 --to-chain 42161 --from - --to 0xFd086bC7... --amount 0.1 --to-wallet 0xYourAddress
3. 見積もりをユーザーに提示し、「confirm」を待ちます。
4. gate-dex swap --from-chain 1 --to-chain 42161 --from - --to 0xFd086bC7... --amount 0.1 --to-wallet 0xYourAddress
5. 送信元チェーンの tx ハッシュを表示します。送信先への到着は非同期であることを伝え、ユーザーは gate-dex swap-detail <order_id> で追跡できます。

---

エラー処理

エラー	対処
Not logged in	gate-dex login を実行します
残高不足	中止し、不足額を表示します
見積もりの有効期限切れ	CLI は署名前に自動的に再見積もりします
スリッページが小さすぎる	より高いスリッページを提案します（価格変動の大きいトークンでは 0.05）
GV チェックイン失敗（組み込み）	CLI がエラーを表示します。再試行を提案します
ブロードキャスト失敗	エラーコードを表示し、自動再試行はしません
ユーザーによるキャンセル	ただちに中止します

---

セキュリティルール

1. 交換前に確認する：gate-dex swap を実行する前に、必ずユーザーから明示的な確認を得てください。チャットでユーザーから明示的な確認が得られていない場合、quote やその他の読み取り専用コマンドのみ実行でき、swap コマンドは実行できません。
2. 最初に見積もりを提示する：ユーザーが予想される受取額を確認できるよう、必ず最初に quote を実行してください。
3. tx-checkin バイナリを使わない：CLI が内部で GV チェックインを処理します。外部バイナリは実行しないでください。
4. 不明なトークンを確認する：不明なトークンを交換する前に、gate-dex token-risk の実行を推奨してください。
5. トランザクションの不可逆性：オンチェーンの交換とブリッジは、一般に取り消せません。実行前に必ず、チェーン、トークンアドレス、数量、および（ブリッジの場合は）送信先ウォレットをユーザーと再確認してください。

---

リスクの開示

**取引出力に必ず記載：**デジタル資産の取引には重大なリスクが伴い、投資の一部または全額を失う可能性があります。クロスチェーンブリッジ取引には、決済時間に関するリスクと相手方リスクが加わります。送信先への到着は非同期です。

上記は情報提供のみを目的としており、投資、金融、税務、または法律に関する助言ではありません。AI 支援による出力は一般的な情報提供のみを目的としており、Gate による表明、保証、または確約を構成するものではありません。このスキルは、18 歳以上で完全な民事行為能力を有するユーザーを対象としています。利用可能かどうかは、管轄区域によって異なる場合があります。