Gate DEX 交易执行技能。用于修改区块链状态的链上代币兑换交易:兑换(swap)、买入(buy)、卖出(sell)、代币交换(exchange)、代币转换(convert tokens)、跨链(cross-chain)……
Gate DEX Trade 中 : ure Routing Layer —— 仅交换执行层是一项面向实际任务的技能,主要用于每个操作都产生链上交易;参考文献中的所有规格;
该技能适合需要稳定复用相关能力的场景,可作为自动化工作流的一部分,也便于后续检查、调整和扩展。从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;
若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。
纯路由层 — 仅执行兑换(Swap EXECUTION)。所有操作均生成链上交易。全部规范详见
references/目录。
⚠️ 停止 — 在继续前,你必须阅读并严格遵守共享的运行时规则。
在读完全部规则前,禁止选择或调用任何工具。这些规则具有最高优先级。
→ 阅读 gate-runtime-rules.md
触发场景:当用户希望执行**修改区块链状态的代币兑换操作**时使用:
除非用户明确要求 OpenAPI / AK / SK,否则禁止使用 OpenAPI 进行兑换操作。
若 MCP 不可用 → 仅可提供 references/setup.md 中的配置指南。
不属于本技能处理范围(常见误路由):
gate-dex-market(只读查询,无交易意图)gate-dex-wallet(账户查询)gate-dex-wallet(直接转账,非兑换)gate-dex-wallet(DApp 交互)用户触发交易意图
↓
步骤 1:用户是否已明确指定模式?
├─ 明确提及 “OpenAPI” / “AK/SK” / “API Key” → 进入 OpenAPI 模式
├─ 否则 → 仅使用 MCP 模式(进入步骤 2)
└─ 未指定 → 进入步骤 2
↓
步骤 2:是否为跨链兑换?
├─ 是跨链 → 必须使用 MCP 模式(OpenAPI 不支持跨链),进入步骤 3
└─ 同链 / 不确定 → 进入步骤 3
↓
步骤 3:Gate Wallet MCP Server 发现与检测
a) 扫描已配置的 MCP Server 列表,查找提供 `dex_tx_swap_quote`、`dex_tx_swap_prepare` 及分阶段签名工具的 Server
b) 若找到 → 记录 Server 标识符,并通过以下方式验证:
CallMcpTool(server="", toolName="dex_chain_config", arguments={chain: "ETH"})
├─ 成功 → 使用 MCP 模式
└─ 失败 → 进入步骤 4
c) 未找到匹配 Server → 进入步骤 4
↓
步骤 4:MCP 不可用 → 仅提供配置指南([`references/setup.md`](./references/setup.md)),不启用 OpenAPI 回退机制
请务必阅读并严格遵循 references/mcp.md,并按其完整工作流执行。
涵盖内容包括:连接检测、身份认证(mcp_token)、MCP Resource/工具调用(dex_tx_swap_quote / dex_tx_swap_prepare / dex_tx_swap_checkin_preview / 分阶段签名提交 / dex_tx_swap_detail)、本地预编译二进制文件执行(swap-checkin-mac / swap-checkin-linux / swap-checkin-win.exe(Windows amd64))、代币地址解析、native_in/native_out 规则、三步确认网关(SOP)、报价模板、风险提示、跨 Skill 协作、安全规则等。
本工作区默认禁用 OpenAPI 模式 —— 仅响应用户明确提出的 OpenAPI 请求。
限制:OpenAPI 模式仅支持同链 Swap,不支持跨链兑换。
采用渐进式文件加载策略 —— 仅加载当前步骤所需内容:
references/openapi/_shared.md —— 环境检测、凭据管理、API 调用方法(通过辅助脚本)| 阶段 | 加载文件 | 触发条件 |
|---|---|---|
| 查询(链/ Gas) | openapi/quote.md |
用户询问链信息或 Gas 费用 |
| 兑换:获取报价 | openapi/quote.md + openapi/sop.md |
用户发起兑换请求 |
| 兑换:构建交易 | openapi/build.md |
报价确认后(SOP 第 2 步) |
| 兑换:签名交易 | openapi/sign.md |
交易构建确认后(SOP 第 3 步) |
| 兑换:提交交易 | openapi/submit.md |
签名完成后 |
| 历史记录 | openapi/submit.md |
用户查询兑换历史 |
openapi/errors.md为向后兼容,遗留的单体式文档仍保留在
references/openapi.md。
当 MCP 检测失败且需提供配置指引时,请阅读并展示 references/setup.md。若可识别用户当前平台,则仅显示对应平台的配置说明;每会话最多展示一次。
实际支持的链由运行时 API / Resource 返回结果决定:
swap://supported_chains Resource 获取trade.swap.chain 接口获取对于非常规链:MCP 调用 dex_chain_config,OpenAPI 调用 trade.swap.chain。
gate-runtime-rules.md 第 3 节;MCP 使用 mcp_token,OpenAPI 使用 AK/SK —— 严禁混用相关专题
热门下载
相关下载
精品课程
共6课时 | 54.7万人学习
共89课时 | 134.3万人学习
共49课时 | 82.7万人学习