gate-dex-trade

Gate DEX Trade

纯路由层 — 仅执行兑换。每项操作都会生成一笔链上交易。所有规范均位于 references/。

通用规则

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

• 只能调用此技能中明确列出的 MCP 工具。 不得调用此处未记录的工具，即使它们 存在于 MCP 服务中。

触发场景：当用户想要执行会修改区块链状态的代币兑换时使用：

• 兑换：“用 ETH 兑换 USDT”“将 100 USDC 兑换成 DAI”“兑换我的 BNB”
• 买入/卖出：“买入 ETH”“卖出我的 USDT”“购买 SOL”
• 跨链：“将 ETH 从 Arbitrum 跨链桥接到 Base”“跨链兑换”
• 兑换报价：“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 Resource/工具调用（dex_tx_swap_quote / dex_tx_swap_prepare / dex_tx_swap_checkin_preview / 分阶段签名与提交 / dex_tx_swap_detail）、代币地址解析、native_in/native_out 规则、三步确认网关（SOP）、报价模板、风险警告、跨技能协作、安全规则。

分阶段兑换签到 — 每次调用 dex_tx_swap_checkin_preview 后（按阶段：根据需要先执行 approve，再执行 swap），使用预览字段调用 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。不要使用原始 curl 或自定义签名重新实现 GV 签到。

OpenAPI 模式（渐进式加载）

此工作区默认关闭——仅在明确请求 OpenAPI 时启用。

限制：OpenAPI 模式仅支持同链 Swap，不支持跨链兑换。

渐进式加载文件——仅加载当前步骤所需的文件：

1. 始终首先加载：references/openapi/_shared.md — 环境检测、凭据、API 调用方法（通过辅助脚本）
2. 然后根据 Swap 阶段加载：

阶段	加载文件	时机
查询（链/Gas）	references/openapi/quote.md	用户询问链或 Gas 时
Swap：获取报价	references/openapi/quote.md + references/openapi/sop.md	用户发起 Swap 时
Swap：构建交易	references/openapi/build.md	报价确认后（SOP 第 2 步）
Swap：签名交易	references/openapi/sign.md	构建确认后（SOP 第 3 步）
Swap：提交	references/openapi/submit.md	签名完成后
历史记录	references/openapi/submit.md	用户询问 Swap 历史记录时

3. 出错时：references/openapi/errors.md

为保持向后兼容，保留旧版单体文件 references/openapi.md。

MCP 服务设置指南

当 MCP 检测失败且需要设置指南时，读取并展示 references/setup.md。如果能识别用户当前使用的平台，仅展示该平台对应的配置。每个会话最多展示一次。

---

支持的链

实际支持的链由运行时 API/资源返回结果决定：

• MCP 模式：swap://supported_chains 资源
• OpenAPI 模式：trade.swap.chain 接口

对于不常见的链：MCP 调用 dex_chain_config，OpenAPI 调用 trade.swap.chain。

---

安全规则

1. 三步确认关卡：交易对确认 → 显示报价 → 签名授权——不可跳过
2. 余额预检查：交易前必须核验资产和 Gas 代币是否充足
3. 风险警告：兑换价值差异 > 5% 时必须发出警告；高滑点（> 5%）时必须发出 MEV 攻击警告
4. 身份验证与凭据：遵循 gate-runtime-rules.md 第 3 节；MCP 使用 mcp_token，OpenAPI 使用 AK/SK——绝不可混用
5. MCP 失败时不得回退到 OpenAPI（本项目）
6. 风险披露（交易输出中必须包含）：数字资产交易涉及重大风险，可能导致您的投资部分或全部损失。本技能的输出仅供参考，不构成投资、财务、税务或法律建议。