Gate DEX Trade

Polar Sponsor
爱发电 赞助
.NET 9.0

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,不支持跨链兑换。

采用渐进式文件加载策略 —— 仅加载当前步骤所需内容:

  1. 始终首先加载:references/openapi/_shared.md —— 环境检测、凭据管理、API 调用方法(通过辅助脚本)
  2. 随后根据兑换阶段加载对应文件:
阶段 加载文件 触发条件
查询(链/ 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 用户查询兑换历史
  1. 出错时:加载 openapi/errors.md

为向后兼容,遗留的单体式文档仍保留在 references/openapi.md。

MCP Server 配置指南

当 MCP 检测失败且需提供配置指引时,请阅读并展示 references/setup.md。若可识别用户当前平台,则仅显示对应平台的配置说明;每会话最多展示一次。

支持的链

实际支持的链由运行时 API / Resource 返回结果决定:

  • MCP 模式:通过 swap://supported_chains Resource 获取
  • 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(本项目限定)

相关专题

更多
GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

2026.11.17

0

15

GoFrame框架安装与gf命令行工具
GoFrame框架安装与gf命令行工具

本专题围绕GoFrame框架的安装与工具链配置展开,讲清Go版本要求、gf命令行的安装方式、代理镜像与依赖准备,说明项目初始化、热编译、交叉编译打包的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.17

0

15

GoFrame框架零基础入门
GoFrame框架零基础入门

本专题整理GoFrame框架的入门知识,从模块化设计理念、环境准备到跑通第一个Web服务,讲清目录分层、配置加载、日志与中间件的用法,并对比Gin、Go-Zero的差异,帮助Go开发者建立整体认知。

2026.11.17

0

15

SQLAlchemy 一对多关系怎么建立
SQLAlchemy 一对多关系怎么建立

SQLAlchemy 一对多关系怎么建立?本专题整理父子表外键、relationship 双向映射、关联查询、级联删除和加载优化等相关文章,帮助你理解并实现常见的 ORM 关系建模。

2026.11.17

0

10

SQLAlchemy 如何增删改查
SQLAlchemy 如何增删改查

SQLAlchemy 如何增删改查?本专题整理 ORM 新增记录、条件查询、更新和删除、Session 事务提交与批量处理等实用文章,帮助你掌握 Python 数据库操作流程。

2026.11.17

0

11

SQLAlchemy ORM 模型怎么写
SQLAlchemy ORM 模型怎么写

SQLAlchemy ORM 模型怎么写?本专题整理模型类定义、Mapped 字段映射、主键与约束、表结构创建和常见报错的相关文章,帮助你从基础配置到实际建模逐步掌握 SQLAlchemy。

2026.11.17

0

16

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

2026.11.12

0

15

Go-Zero安装与goctl环境配置教程
Go-Zero安装与goctl环境配置教程

本专题围绕Go-Zero的安装与工具链配置展开,讲清Go版本要求、goctl安装方式、代理镜像、protoc依赖与环境变量设置,说明多版本共存、升级回退与CI流水线安装的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.12

0

15

Go-Zero零基础入门教程
Go-Zero零基础入门教程

本专题整理Go-Zero的入门知识,从框架定位、环境准备到跑通第一个API服务,讲清目录分层、配置加载、日志与中间件的基本用法,并对比Gin、Kratos的差异,帮助Go开发者建立整体认知,判断它是否适合当前项目。

2026.11.12

0

15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 134.3万人学习