gate-dex-wallet

Gate DEX Wallet

纯路由层 — 此 SKILL.md 是一个轻量级路由器。所有子模块详情均位于 references/ 中。

通用规则

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

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

签名门禁 — Gate Verify MCP（必需）

在进行任何对 dex_wallet_sign_transaction、dex_wallet_sign_message 或 dex_tx_x402_fetch 的 MCP 调用之前（仅限签名工具 — dex_tx_x402_checkin_preview 不是签名调用，不需要事先执行 tx_checkin）：

1. 用户必须通过该操作现有的确认门禁（预览 / 消息文本 / 付款意图）。
2. Agent 必须调用 Gate Verify HTTP MCP 服务（参见 MCP 服务连接检测 下的 Gate Verify MCP）工具 /v1/tx/checkin 或 tx_checkin，并按照 references/tx-checkin.md 执行，将成功视为硬性前置条件。不得运行旧版 tx-checkin shell 二进制文件，也不得要求用户执行本地 check-in 命令。扫描已配置的 MCP 服务，直到 tools/list 中包含 check-in 工具，以此发现 Verify 服务。身份验证： 在 check-in 工具的 arguments 中传入 authorization，并使用与钱包 MCP 调用相同的 mcp_token — 不得将钱包服务的 HTTP headers 复制到 Verify MCP 条目中 — 参见 references/tx-checkin.md。
3. 执行 dex_tx_transfer_preview 后，check-in 的 message 参数必须仅使用预览字段 txBundle 字符串 — 不得从 unsigned_tx_hex 或其他字段拼装 txbundle JSON（参见 references/tx-checkin.md）。
4. x402（dex_tx_x402_fetch）： 不得先调用 dex_tx_x402_fetch 来探测 402。对于 EVM exact / EIP-3009（例如 Base 上的 CoinGecko Pro x402），先调用钱包 MCP dex_tx_x402_checkin_preview — 它会返回 tx_checkin 负载（包括正确的 64 位十六进制 message）以及 x402_payment_required_b64，因此 Agent 无需手动构造 EIP-3009 摘要。然后使用 authorization（相同的 mcp_token）以及预览返回的 tx_checkin 字段，完成 Gate Verify /v1/tx/checkin / tx_checkin。接着调用 dex_tx_x402_fetch，使用与预览相同的 url / method / body / headers、Verify 返回的 checkin_token，以及预览结果中相同的 x402_payment_required_b64。对于 POST JSON，在预览和 fetch 的 headers JSON 中都加入 Content-Type: application/json（可避免常见的 415）。完整调用顺序以及 Solana / upto 例外情况：references/x402.md、references/tx-checkin.md。
5. 其他会在内部签名的单步 MCP 工具：若网关有要求，必须在调用钱包 MCP 工具前立即执行同一个 /v1/tx/checkin 调用；checkin_token / 意图负载请遵循后端文档。

适用场景

当用户想要管理链上钱包账户、身份或资产时，使用此技能：

• 进行身份验证或管理会话（通过 Google 或 Gate OAuth 登录、登出）
• 查询代币余额、总投资组合价值或钱包地址
• 查看交易历史或过往兑换记录
• 向地址转账或发送代币（单笔或批量）；任何签名操作前都必须通过 Gate Verify MCP 签到（/v1/tx/checkin）（references/tx-checkin.md）
• 在链上提现或将资金提现到其 Gate Exchange 账户（根据其 UID 解析存款地址；此技能不支持 CEX 内部余额划转）
• 通过 x402 协议支付 HTTP 402 资源（EVM exact/upto、Solana exact/upto）；先执行 dex_tx_x402_checkin_preview（EVM EIP-3009），然后通过 Gate Verify MCP 签到，最后执行 dex_tx_x402_fetch（references/x402.md、references/tx-checkin.md）
• 与 DApp 交互（连接钱包、签署消息、授权代币、调用合约）
• 使用 gate-wallet CLI 工具执行上述任一操作
• 检测或配置 MCP Server 连接

---

能力边界

支持	不支持（转至其他位置）
身份验证与会话管理	代币价格 / K 线查询 -> gate-dex-market
余额与地址查询	代币兑换执行 -> gate-dex-trade
交易与兑换历史	代币安全审计 -> gate-dex-market
代币转账（EVM + Solana）；链上提现到 Gate Exchange（存款地址流程）
x402 支付（EVM exact/upto + Solana exact/upto）
DApp 交互与授权
CLI 双通道操作

---

模块路由

根据用户意图路由到相应的子模块：

用户意图	目标
登录、登出、签到、签出、代币过期、会话过期、OAuth、Google 登录、Gate 登录、身份验证、重新登录、切换账户、“我无法访问钱包”、“未登录”	references/auth.md
查询余额、总资产、投资组合价值、钱包地址、我的地址、我有多少钱、显示我的代币、交易记录、交易历史、兑换历史、过往交易、“我拥有什么”、“有多少 ETH”、“列出我的币”、“显示持仓”	references/asset-query.md
提现到 Gate Exchange、提现到我的 Gate 账户、将资金发送到交易所存款地址、将币从钱包转到 Gate（链上存款）、绑定或重新绑定用于提现的 Gate UID	references/withdraw.md
转账、发送代币、发送到地址、批量转账、“向 0x... 发送 1 ETH”、“转账 USDT”、“转移代币”、“付钱给某人”、“给朋友发送加密货币”（任意或已知的链上地址 — 不解析交易所存款地址）	references/transfer.md + 签名前参阅 references/tx-checkin.md
任何签名操作：在执行 dex_wallet_sign_transaction / dex_wallet_sign_message 之前；checkin_token；Gate Verify /v1/tx/checkin	references/tx-checkin.md（签名前阅读）
402 支付、x402 支付、需要付款、支付 API 费用、支付 URL 费用、“获取并付款”、“调用此 URL 并付款”、“付费端点”、“支付以获取访问权限”、“HTTP 402”、Permit2 支付、upto 支付	references/x402.md（dex_tx_x402_checkin_preview → references/tx-checkin.md → dex_tx_x402_fetch）
DApp 连接、连接钱包、签署消息、授权、撤销授权、合约调用、EIP-712、Permit、personal_sign、“与 Uniswap 交互”、“添加流动性”、“在 Lido 质押”、“铸造 NFT”、“签名以登录 DApp”、授权合约	references/dapp.md + 每次签名前参阅 references/tx-checkin.md
gate-wallet CLI、命令行、终端、openapi-swap、混合兑换、“使用 CLI”、“运行命令”、“gate-wallet balance”、脚本自动化、npm gate-wallet	references/cli.md

---

MCP 服务连接检测

在会话中首次调用 MCP 工具之前，执行一次连接探测：

1. 发现：扫描已配置的 MCP 服务，查找工具 dex_wallet_get_token_list、dex_tx_quote 和 dex_tx_swap。
2. 识别：接受灵活的服务名称（gate-wallet、gate-dex、dex、wallet、user-gate-wallet 或任何自定义名称）。
3. 验证：CallMcpTool(server="<id>", toolName="dex_chain_config", arguments={chain: "eth"})。

结果	操作
成功	记录服务标识符；在本会话的所有后续调用中使用该标识符
失败	显示下方的设置指南（每个会话最多显示一次）；在下个会话重新检测

OpenClaw 平台检测

检测到 OpenClaw/mcporter 平台时，通过 mcporter 路由 MCP 调用：

CallMcpTool(server="mcporter", toolName="call_tool", arguments={
  server: "<gate-dex-server>",
  tool: "<tool_name>",
  arguments: { ...params }
})

设置指南（检测失败时显示一次）

Gate DEX MCP Server:
  URL:  https://api.gatemcp.ai/mcp/dex
  Type: HTTP

  Cursor:      Settings -> MCP -> Add server, or edit ~/.cursor/mcp.json
  Claude Code:  claude mcp add --transport http gate-dex --scope project https://api.gatemcp.ai/mcp/dex
  Codex CLI:    codex mcp add gate-dex --transport http --url https://api.gatemcp.ai/mcp/dex

Gate Verify MCP（签名前核验）

添加第二个 HTTP MCP 服务，仅用于签名前的交易核验（references/tx-checkin.md）：

Gate Verify MCP:
  URL:  https://api.gatemcp.ai/mcp/dex/sec
  Type: HTTP

  Cursor:      Settings -> MCP -> Add server (URL only is fine for check-in; pass mcp_token as tool arg authorization per references/tx-checkin.md)
  Tool name:   /v1/tx/checkin or tx_checkin  (discover via tools/list; server name is user-defined, e.g. gate-dex-sec)

在会话中首次核验之前，扫描已配置的 MCP 服务，直到 tools/list 中包含 tx_checkin 或 /v1/tx/checkin，以解析验证服务 ID。

运行时错误处理

错误类型	关键词	操作
未配置 MCP 服务	server not found、unknown server	显示设置指南
远程服务无法访问	connection refused、timeout、DNS error	提示检查服务状态和网络
身份验证失败	400、401、unauthorized	遵循 gate-runtime-rules.md 第 3 节

---

后续路由

完成操作后，主动向用户建议 2-4 个相关的后续操作（模板请参阅各模块的“Post-XXX Suggestions”部分）。然后根据用户的回复进行路由：

操作后的用户意图	目标
查看代币价格、K 线图、市值、交易量	gate-dex-market
执行代币安全审计，检查代币是否安全	gate-dex-market
向任意链上地址转账或发送代币	references/transfer.md
提现或将链上资产套现到 Gate Exchange	references/withdraw.md
在 DEX 上交换、兑换、买入、卖出代币	gate-dex-trade
为 402 资源付费、x402 支付	references/x402.md（预览 → references/tx-checkin.md → 获取）
与 DApp 交互、连接钱包、签名、授权	references/dapp.md
在任何签名前进行强制性 Gate Verify MCP 核验、checkin_token	references/tx-checkin.md
登录、重新登录、修复过期的身份验证、切换账户	references/auth.md
使用 CLI 命令、执行 gate-wallet 终端操作	references/cli.md
检查余额、查看资产、交易历史	references/asset-query.md

---

不适用于此技能（常见错误路由）

这些意图不应触发此技能：

用户意图	正确的技能
“ETH 的价格是多少？”/“显示 BTC 图表”/“代币排名”	gate-dex-market
“用 ETH 兑换 USDT”/“买入 SOL”/“兑换代币”/“DEX 交易”	gate-dex-trade
“这个代币安全吗？”/“审计合约 0x...”/“蜜罐检查”	gate-dex-market
“显示涨幅最高的代币”/“新代币上线”/“市场概览”	gate-dex-market

---

支持的链

EVM：eth、bsc、polygon、arbitrum、optimism、avax、base | 非 EVM：sol

---

安全规则

1. 先进行身份验证：在执行所有操作前，验证 mcp_token 是否有效；如果验证失败，请遵循 gate-runtime-rules.md 的 §3。
2. 令牌保密：绝不以明文形式显示 mcp_token；请使用 <mcp_token> 等占位符。
3. MCP 服务错误：向用户如实显示所有 MCP 服务错误消息——绝不隐藏或修改。
4. 交易不可逆：链上的数字资产交易通常不可逆。在进行任何转账、提现或 x402 签名之前，请提醒用户核实收款地址（或支付 URL／资产）——提交后无法撤销。
5. AI 输出免责声明：任何余额、历史记录或分析输出仅供一般信息参考，不构成 Gate 作出的任何陈述、保证或担保，也不构成投资、财务、税务或法律建议。