Gate DEX 交易执行技能。用于修改区块链状态的链上代币兑换交易:兑换(swap)、买入(buy)、卖出(sell)、代币交换(exchange)、代币转换(convert tokens)、跨链(cross-chain)……
Gate DEX Trade 中 : ure Routing Layer —— 仅交换执行层
功能概述
Gate DEX Trade 中 : ure Routing Layer —— 仅交换执行层是一项面向实际任务的技能,主要用于每个操作都产生链上交易;参考文献中的所有规格;
核心要点
- 一般规则 {{} 停止}}/ 您必须读写并严格 f。
- 它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。
- 使用时应结合输入条件选择合适的执行方式,核对必要参数、依赖环境与输出内容,并按原始要求处理异常情况。
使用与执行
该技能适合需要稳定复用相关能力的场景,可作为自动化工作流的一部分,也便于后续检查、调整和扩展。从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;
结果检查与注意事项
若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。
Gate DEX 交易
纯路由层 — 仅执行兑换(Swap EXECUTION)。所有操作均生成链上交易。全部规范详见
references/目录。
通用规则
⚠️ 停止 — 在继续前,你必须阅读并严格遵守共享的运行时规则。
在读完全部规则前,禁止选择或调用任何工具。这些规则具有最高优先级。
→ 阅读 gate-runtime-rules.md
触发场景:当用户希望执行**修改区块链状态的代币兑换操作**时使用:
- 兑换(Swap):“将 ETH 兑换为 USDT”、“将 100 USDC 兑换为 DAI”、“转换我的 BNB”
- 买入/卖出(Buy/Sell):“买入 ETH”、“卖出我的 USDT”、“购买 SOL”
- 跨链操作(Cross-chain):“将 ETH 从 Arbitrum 桥接到 Base”、“跨链兑换”
- 兑换报价(Swap quote):“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 交互)
路由流程
用户触发交易意图
↓
步骤 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 回退机制
模式分发
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)、本地预编译二进制文件执行(swap-checkin-mac / swap-checkin-linux / swap-checkin-win.exe(Windows amd64))、代币地址解析、native_in/native_out 规则、三步确认网关(SOP)、报价模板、风险提示、跨 Skill 协作、安全规则等。
OpenAPI 模式(渐进式加载)
本工作区默认禁用 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 Server 配置指南
当 MCP 检测失败且需提供配置指引时,请阅读并展示 references/setup.md。若可识别用户当前平台,则仅显示对应平台的配置说明;每会话最多展示一次。
支持的链
实际支持的链由运行时 API / Resource 返回结果决定:
- MCP 模式:通过
swap://supported_chainsResource 获取 - OpenAPI 模式:通过
trade.swap.chain接口获取
对于非常规链:MCP 调用 dex_chain_config,OpenAPI 调用 trade.swap.chain。
安全规则
- 三步确认网关:交易对确认 → 报价展示 → 签名授权 —— 不得跳过任一环节
- 余额预检:交易前必须强制校验资产余额及 Gas 代币是否充足
- 风险提示:当兑换价值差异 > 5%、滑点 > 5%,或存在 MEV 攻击风险时,必须强制弹出警告
- 身份认证与凭据:遵循
gate-runtime-rules.md第 3 节;MCP 使用mcp_token,OpenAPI 使用 AK/SK —— 严禁混用 - MCP 失败时禁止回退至 OpenAPI(本项目限定)
热门AI工具
相关专题
本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。
0
2026.11.17
本专题围绕GoFrame框架的安装与工具链配置展开,讲清Go版本要求、gf命令行的安装方式、代理镜像与依赖准备,说明项目初始化、热编译、交叉编译打包的做法,并整理安装阶段的常见报错与验证步骤。
0
2026.11.17
本专题整理GoFrame框架的入门知识,从模块化设计理念、环境准备到跑通第一个Web服务,讲清目录分层、配置加载、日志与中间件的用法,并对比Gin、Go-Zero的差异,帮助Go开发者建立整体认知。
0
2026.11.17
SQLAlchemy 一对多关系怎么建立?本专题整理父子表外键、relationship 双向映射、关联查询、级联删除和加载优化等相关文章,帮助你理解并实现常见的 ORM 关系建模。
0
2026.11.17
SQLAlchemy 如何增删改查?本专题整理 ORM 新增记录、条件查询、更新和删除、Session 事务提交与批量处理等实用文章,帮助你掌握 Python 数据库操作流程。
0
2026.11.17
SQLAlchemy ORM 模型怎么写?本专题整理模型类定义、Mapped 字段映射、主键与约束、表结构创建和常见报错的相关文章,帮助你从基础配置到实际建模逐步掌握 SQLAlchemy。
0
2026.11.17
本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。
0
2026.11.12
本专题围绕Go-Zero的安装与工具链配置展开,讲清Go版本要求、goctl安装方式、代理镜像、protoc依赖与环境变量设置,说明多版本共存、升级回退与CI流水线安装的做法,并整理安装阶段的常见报错与验证步骤。
0
2026.11.12
本专题整理Go-Zero的入门知识,从框架定位、环境准备到跑通第一个API服务,讲清目录分层、配置加载、日志与中间件的基本用法,并对比Gin、Kratos的差异,帮助Go开发者建立整体认知,判断它是否适合当前项目。
0
2026.11.12
热门下载
相关下载
精品课程
共6课时 | 12.1万人学习
共79课时 | 161.9万人学习
共6课时 | 54.8万人学习