gate-dex-wallet-cli

Gate DEX CLI

通用规则

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

• **只能调用此技能中明确列出的 MCP 工具。**不得调用此处未记录的工具，即使它们存在于 MCP 服务中。
• **只能使用此技能及其参考文档中明确列出的 gate-dex CLI 子命令。**对于这些工作流，即使其他接口提供了相关命令，也不得运行此处未记录的命令。

纯路由层——此 SKILL.md 是一个轻量路由器。子模块的详细信息位于 references/ 中。

概览

gate-dex 是一个独立的 CLI 工具，通过 REST API 与 Gate DEX 服务通信。**无需 MCP 服务。**所有签名操作（transfer、sign-msg、swap）都内置了 GV 安全 checkin——Agent 无需运行任何外部二进制文件。

身份验证：通过 Gate/Google OAuth 登录，令牌存储在 ~/.gate-dex/auth.json 中。

CLI 还支持交互式 REPL——不带参数运行 gate-dex 会打开提示符。

适用场景

当用户想要进行以下操作时，请使用此技能：

• 通过 Gate OAuth 或 Google OAuth 进行身份验证（登录/登出）
• 查询代币余额、投资组合总价值或钱包地址
• 查看交易历史
• 向链上地址转账或发送代币（EVM + Solana）
• 签署原始消息或原始交易
• 直接使用 gate-dex CLI 命令

---

能力边界

支持	转到其他技能
身份验证与会话管理	代币兑换 → gate-dex-trade-cli 技能
余额、地址和代币列表查询	市场数据／代币信息／K 线 → gate-dex-market-cli 技能
交易历史	DApp 交互 → gate-dex-wallet 技能（基于 MCP）
代币转账（EVM + Solana）	x402 支付 → gate-dex-wallet 技能（基于 MCP）
签署 32 字节十六进制消息／原始交易	MCP 工具调用 → gate-dex-wallet 技能（基于 MCP）

前置条件：PATH 中必须有 gate-dex 二进制文件。

• GateClaw 托管场景——安装时会自动运行 skill/setup.sh，并将预构建的 Linux 二进制文件放入 /home/node/.openclaw/skills/bin/gate-dex。环境变量（RUN_ENV、*_URL）通过 GateClaw Web 表单收集，并在运行时注入 process.env。
• 个人 OpenClaw 场景——frontmatter 中的 install 规范会自动为宿主机操作系统下载二进制文件（无需 Node.js）。
• 本地开发——从源代码构建：

  cd cli && pnpm install
  pnpm build:binary                  # production binary (no baked env)
  pnpm build:binary -- --bake-env    # bake root .env into the binary (test env)
  

---

安装

已发布的二进制文件是一个独立的可执行文件（无需 Node.js 运行时）。

# GateClaw / OpenClaw: auto-installed via setup.sh or frontmatter.install
# Manual download (example):
curl -fsSL https://gate-dex-cli.gateweb3.cc/latest/gate-dex-linux-x64 \
  -o /usr/local/bin/gate-dex
chmod +x /usr/local/bin/gate-dex

# Login
gate-dex login           # Gate OAuth (default)
gate-dex login --google  # Google OAuth

存储：

• 身份验证令牌 → ~/.gate-dex/auth.json

环境变量（均为可选；默认目标为生产环境）：

变量	用途
RUN_ENV	dev / pre / prod——选择 GV API 环境和 CDN 候选项
WALLET_SERVICE_URL	web3-wallet-service 端点（由 balance 使用）
BW_SERVICE_URL	web3-business-wallet 端点
MARKET_TOKEN_URL	gateio_service_web3_trade_token 端点（市场／代币／兑换）
DATA_API_URL	web3-data-api 端点（代币信息、安全审计、排名）
BIZ_WALLET_URL	OAuth 会话管理端点

---

全局选项

选项	说明
--auth-dir <path>	自定义身份验证存储目录（覆盖 ~/.gate-dex；也可通过 GATE_DEX_HOME 环境变量设置）
--auth-file <path>	自定义 auth.json 文件路径（覆盖 --auth-dir；也可通过 GATE_DEX_AUTH_FILE 环境变量设置）
-v, --version	打印版本号

---

子模块

子模块	文件	范围
身份验证	references/auth.md	OAuth 登录/登出、会话状态、web3-domain
资产查询	references/asset-query.md	余额、地址、代币、交易历史、交易详情
转账与签名	references/transfer.md	transfer（预览）、send（一次性）、sign-msg、sign-tx、sol-tx、gas

路由规则

用户意图	目标
登录、登出、重新登录、会话过期、OAuth、“未登录”、切换账户、web3-domain	references/auth.md
查询余额、总资产、钱包地址、账户地址、代币列表、交易历史、“我有多少钱”、“显示我的代币”	references/asset-query.md
转账、发送代币、“向 0x... 发送 ETH”、“转账 USDT”、“向某人付款”、“转移代币”、sign-msg、sign-tx、sol-tx	references/transfer.md
兑换、交换代币、“将 ETH 兑换为 USDT”、“购买 SOL”、报价、“转换代币”	→ gate-dex-trade-cli 技能
K 线、代币价格、市值、流动性、交易统计、代币安全性、代币排名、新代币	→ gate-dex-market-cli 技能

执行

1. 检测意图，依据路由规则表将其解析为一个且仅一个子模块文件或同级技能路由。
2. 读取匹配的子模块（references/auth.md、references/asset-query.md 或 references/transfer.md），并遵循其工作流作为权威执行规范。
3. 在执行任何写入命令（send、sign-msg、sign-tx）前，应用此 SKILL.md 中的安全规则（安全规则部分）。
4. 对于写入操作路径（send）：在调用 CLI 前，必须在聊天中获得用户明确确认；先通过 transfer 预览。
5. 对于同级技能路由（gate-dex-trade-cli、gate-dex-market-cli）：转交处理，不要在此处调用这些技能的命令。

---

完整命令参考

身份验证与会话

命令	说明
login	Gate OAuth Device Flow 登录
login --google	Google OAuth Device Flow 登录
login --no-open	打印身份验证 URL，而不是打开浏览器
logout	登出并清除 ~/.gate-dex/auth.json
status	显示当前会话信息
web3-domain	查看/刷新动态 web3_domain 列表
web3-domain --refresh	强制重新获取域名列表

钱包查询

命令	说明
balance	所有链上的总投资组合价值（USD）
address	显示 EVM + Solana 钱包地址
tokens	带余额的代币列表（网关）
tokens --chain ETH,SOL	按链筛选
tokens --page N --size N	分页

转账与签名

命令	说明
transfer	仅预览未签名交易（不广播）
send	一次性操作：预览 → GV checkin → 签名 → 广播
send-tx	构建 → GV checkin → 签名 → 广播（或使用 --hex 广播预签名交易）
sol-tx	在本地构建 Solana 未签名交易（最新区块哈希）
gas [chain]	查询 gas 价格 + gas 限额
sign-msg <hex>	签署 32 字节十六进制消息（内置 GV checkin）
sign-tx <raw_tx>	签署原始十六进制交易（内置 GV checkin）

兑换（范围外 — 路由到 gate-dex-trade-cli 技能）

quote、swap、swap-tokens、bridge-tokens、swap-history 和 swap-detail 命令记录在 gate-dex-trade-cli 技能中。请勿从此技能调用这些命令。

交易历史

命令	说明
tx-history	转账交易历史
tx-detail <hash>	根据哈希查询交易详情

市场与代币数据（范围外 — 路由到 gate-dex-market-cli 技能）

tx-stats、kline、liquidity、token-info、token-risk、token-rank 和 new-tokens 命令记录在 gate-dex-market-cli 技能中。请勿从此技能调用这些命令。

链 / RPC

命令	描述
chain-config [chain]	链配置（networkKey、endpoint、chainID）
rpc	原始 JSON-RPC 调用

维护

命令	描述
cleanup	删除 ~/.gate-dex

---

与基于 MCP 的技能的主要设计差异

方面	此技能（gate-dex-wallet-cli）	基于 MCP 的技能（gate-dex-wallet）
传输方式	纯 REST（无 MCP）	MCP 工具调用
GV 安全 checkin	内置于 CLI send/swap/sign-msg/sign-tx	需要外部 tx-checkin 二进制文件
身份验证存储	~/.gate-dex/auth.json	MCP 会话 mcp_token
Swap 方式	gate-dex swap 单次操作	dex_tx_swap_* 多步骤工具
转账方式	gate-dex send 单次操作	dex_wallet_sign_transaction + 广播
Agent 二进制文件依赖	无	tools/tx-checkin/bin/

重要：使用此 CLI 技能时，Agent 不得单独运行 tx-checkin 二进制文件。CLI 会在内部处理 GV checkin。只需在用户确认后运行 CLI 命令。

---

Agent 使用说明

• Agent 在非交互式 Shell 中运行（没有 stdin）。要求确认的命令会一直挂起。对于 send 和 swap，始终先在聊天中与用户确认，然后再运行命令。
• send 和 swap 命令是单次操作：一次运行即可完成预览、checkin、签名和广播。
• 所有金额均使用人类可读的数值，而非链上的最小单位（wei/lamports）。

---

链上操作流程

转账操作遵循：预览 → 在聊天中由用户确认 → 执行单次操作命令。

1. 预检查：运行 gate-dex address → gate-dex tokens，确认资金充足
2. 预览：运行 gate-dex transfer（仅预览，不签名）
3. 在聊天中由用户确认：显示详情，并等待用户明确批准
4. 执行：运行 gate-dex send ...（GV checkin、签名和广播均由内部处理）
5. 验证：运行 gate-dex tx-detail <hash>

未经用户明确确认，绝不要运行 send。

---

后续操作引导

完成操作后，主动建议 2-4 个相关的后续操作：

操作后的用户意图	目标
查询余额 / 代币	references/asset-query.md
转账代币	references/transfer.md
兑换代币	gate-dex-trade-cli 技能
代币价格、K 线、代币安全	gate-dex-market-cli 技能
登录 / 会话问题	references/auth.md

---

此技能不适用的场景（常见路由错误）

用户意图	正确的技能
DApp 连接 / 签名 / 授权 / 合约调用	gate-dex-wallet 技能（基于 MCP）
x402 付款	gate-dex-wallet 技能（基于 MCP）
链上提现到 Gate Exchange（UID 绑定）	gate-dex-wallet 技能（基于 MCP）
直接调用 MCP 工具	gate-dex-wallet 技能（基于 MCP）

---

支持的链

EVM：eth、bsc、polygon、arbitrum（arb）、optimism（op）、avax、base 非 EVM：sol

链名称不区分大小写。

---

安全规则

1. 执行资金操作前先确认：send 涉及真实资金。运行命令前，务必在聊天中与用户确认目标地址、金额、代币和链。未经用户在聊天中明确确认，不得执行 send——仅允许进行只读查询（balance、address、tokens、tx-history、tx-detail、transfer 预览）。
2. 执行前先预览：在执行 send 前，使用 transfer（仅预览）。
3. 不使用外部签到二进制文件：不要运行 tx-checkin 二进制文件——不需要运行；CLI 会在内部处理。
4. 令牌保密：~/.gate-dex/auth.json 存储凭据。切勿向用户显示原始令牌。切勿将此文件提交到 Git。
5. 交易不可逆：链上转账通常不可逆。执行 send 前，务必再次与用户核实收款地址、链和代币合约。

---

风险披露

数字资产交易通常不可逆。确认前请核实收款地址。此技能的输出仅供参考，不构成投资、财务、税务或法律建议。AI 辅助生成的输出仅供一般参考，不构成 Gate 的任何陈述、保证或担保。此技能面向年满 18 周岁且具有完全民事行为能力的用户；是否可用可能因司法管辖区而异。