gate-dex-trade-cli

Gate DEX CLI — 兑换

通用规则

⚠️ 停止 — 继续之前，必须阅读并严格遵循共享运行时规则。 在阅读完所有规则之前，请勿选择或调用任何工具。这些规则具有最高优先级。 → 阅读 gate-runtime-rules.md

• 只能调用本技能中明确列出的 MCP 工具。 即使 MCP 服务中存在其他工具，也绝不能调用未在此处说明的工具。
• 只能使用本技能及其参考文档中明确列出的 gate-dex CLI 子命令。 即使其他接口提供了这些工作流所需的命令，也绝不能运行未在文档中说明的命令。

通过 CLI 一次性完成 DEX 兑换。GV checkin + 签名 + 广播均内置于 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

返回预估输出金额、价格影响、路线和费用。不进行签名。

一次性兑换（报价 + GV checkin + 签名 + 广播）

# 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 <token>	是	源代币合约；原生代币（ETH/SOL/BNB）请使用 -
--to <token>	是	目标代币合约
--amount <n>	是	人类可读的输入金额
--slippage <n>	否	滑点容差（小数形式，默认 0.03 = 3%）
--native-in <0|1>	否	如果源代币为原生代币（ETH/SOL），则设为 1；默认 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 命令的内部流程

Agent 不会手动运行以下任何步骤 — 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 之前尝试运行 checkin 二进制文件。CLI 内置了 GV checkin。

---

链 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%）
Meme / 流动性较低的代币	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. 显示交易哈希 + 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. 显示交易哈希 + solscan 链接。

示例 3：未知代币符号 用户：“在 Arbitrum 上将 10 USDT 兑换为 ARB”

1. gate-dex swap-tokens --chain arb --search ARB → 获取 ARB 合约地址。
2. 使用解析出的地址继续查询报价并兑换。

示例 4：跨链桥接 ETH（Ethereum）→ USDT（Arbitrum） 用户：“将 0.1 ETH 从 Ethereum 跨链桥接为 Arbitrum 上的 USDT”

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. 显示源链交易哈希；说明目标链到账是异步的，用户可以通过 gate-dex swap-detail <order_id> 跟踪。

---

错误处理

错误	处理方式
Not logged in	运行 gate-dex login
余额不足	中止；显示差额
报价已过期	CLI 会在签名前自动重新获取报价
滑点过低	建议提高滑点（波动较大的代币可设为 0.05）
GV 签到失败（内置）	CLI 显示错误；建议重试
广播失败	显示错误代码；不要自动重试
用户取消	立即中止

---

安全规则

1. 兑换前确认：运行 gate-dex swap 前，务必征得用户明确确认。若用户未在聊天中明确确认，不得执行任何 swap 命令；只允许执行 quote 和其他只读命令。
2. 先展示报价：务必先运行 quote，以便用户查看预估输出。
3. 不要使用 tx-checkin 二进制文件：CLI 会在内部处理 GV 签到，不要运行任何外部二进制文件。
4. 检查不熟悉的代币：建议在兑换未知代币前运行 gate-dex token-risk。
5. 交易不可逆：链上兑换和跨链桥接通常不可逆。执行前，务必与用户再次确认链、代币地址、数量，以及（跨链桥接时）目标钱包。

---

风险披露

**交易输出中必须包含：**数字资产交易风险较高，可能导致投资部分或全部损失。跨链桥接交易还存在结算时间和交易对手风险；目标链到账为异步过程。

以上内容仅供参考，不构成投资、财务、税务或法律建议。AI 辅助生成的内容仅供一般参考，不代表 Gate 作出任何陈述、保证或担保。本技能面向年满 18 周岁且具有完全民事行为能力的用户；服务可用性可能因司法管辖区而异。