Gate DEX CLI

General Rules

⚠️ STOP — You MUST read and strictly follow the shared runtime rules before proceeding. Do NOT select or call any tool until all rules are read. These rules have the highest priority. → Read gate-runtime-rules.md

• Only call MCP tools explicitly listed in this skill. Tools not documented here must NOT be called, even if they

exist in the MCP server.

• Only use the gate-dex CLI subcommands explicitly listed in this skill and its references. Commands not documented here must NOT be run for these workflows, even if other interfaces expose them.

Pure Routing Layer — This SKILL.md is a lightweight router. Sub-module details live in references/.

Overview

gate-dex is a standalone CLI tool that communicates with Gate DEX services via REST APIs. No MCP server is required. All signing operations (transfer, sign-msg, swap) include built-in GV security checkin — the agent does not need to run any external binary.

Auth: login via Gate/Google OAuth, token stored in ~/.gate-dex/auth.json.

The CLI also supports an interactive REPL — running gate-dex with no arguments opens a prompt.

Applicable Scenarios

Use this skill when the user wants to:

• Authenticate (login/logout) via Gate OAuth or Google OAuth
• Query token balances, total portfolio value, or wallet addresses
• View transaction history
• Transfer or send tokens to an on-chain address (EVM + Solana)
• Sign raw messages or raw transactions
• Use gate-dex CLI commands directly

Capability Boundaries

Prerequisites: A gate-dex binary on PATH.

• GateClaw managed scenario — skill/setup.sh runs automatically on install and drops a pre-built Linux binary into /home/node/.openclaw/skills/bin/gate-dex. Environment variables (RUNENV, *URL) are collected via the GateClaw Web form and injected into process.env at runtime.
• Personal OpenClaw scenario — the frontmatter install spec downloads the binary for the host OS automatically (no Node.js required).
• Local development — build from source:

``bash 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) ``

Installation

The published binary is a single self-contained executable (no Node.js runtime required).

# 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

Storage:

• Auth token → ~/.gate-dex/auth.json

Environment variables (all optional; defaults target production):

Global Options

Sub-Modules

Routing Rules

Execution

1. Detect intent using the Routing Rules table; resolve to exactly one sub-module file or a peer-skill route.
2. Read the matched sub-module (references/auth.md, references/asset-query.md, or references/transfer.md) and follow its workflow as the authoritative execution contract.
3. Apply the safety rules in this SKILL.md (Security Rules section) before any write command (send, sign-msg, sign-tx).
4. For write paths (send): require explicit user confirmation in chat before invoking the CLI; preview via transfer first.
5. For peer-skill routes (gate-dex-trade-cli, gate-dex-market-cli): hand off without invoking those skills' commands from here.

Full Command Reference

Auth & Session

Wallet Queries

Transfer & Signing

Swap (out of scope — route to gate-dex-trade-cli skill)

The quote, swap, swap-tokens, bridge-tokens, swap-history, and swap-detail commands are documented in the gate-dex-trade-cli skill. Do not invoke them from this skill.

Transaction History

Market & Token Data (out of scope — route to gate-dex-market-cli skill)

The tx-stats, kline, liquidity, token-info, token-risk, token-rank, and new-tokens commands are documented in the gate-dex-market-cli skill. Do not invoke them from this skill.

Chain / RPC

Maintenance

Key Design Differences from MCP-based Skills

CRITICAL: When using this CLI skill, the agent MUST NOT run tx-checkin binary separately. The CLI handles GV checkin internally. Just run the CLI command after user confirmation.

Agent Usage Notes

• Agent runs in a non-interactive shell (no stdin). Commands that ask for confirmation will hang. For send and swap, always confirm with the user in chat before running the command.
• The send and swap commands are one-shot: they preview, checkin, sign, and broadcast in a single run.
• All amounts use human-readable values, not smallest chain units (wei/lamports).

On-Chain Operation Flow

Transfer operations follow: preview → user confirm in chat → execute one-shot command.

1. Pre-check: gate-dex address → gate-dex tokens for sufficient funds
2. Preview: gate-dex transfer (preview-only, no signing)
3. User confirmation in chat: Display details, wait for explicit approval
4. Execute: gate-dex send ... (GV checkin, sign, broadcast handled internally)
5. Verify: gate-dex tx-detail <hash>

NEVER run send without explicit user confirmation.

Follow-up Routing

After completing an operation, proactively suggest 2-4 relevant next actions:

NOT This Skill (Common Misroutes)

Supported Chains

EVM: eth, bsc, polygon, arbitrum (arb), optimism (op), avax, base Non-EVM: sol

Chain names are case-insensitive.

Security Rules

1. Confirm before fund operations: send involves real funds. Always confirm target address, amount, token, and chain with the user in chat before running the command. Without explicit user confirmation in chat, no send may be executed — only read-only queries (balance, address, tokens, tx-history, tx-detail, transfer preview) are allowed.
2. Preview before execute: Use transfer (preview-only) before send.
3. No external checkin binary: Do not run tx-checkin binary — it is not needed; CLI handles it internally.
4. Token confidentiality: ~/.gate-dex/auth.json stores credentials. Never display the raw token to users. Never commit this file to Git.
5. Transaction irreversibility: On-chain transfers are generally irreversible. Re-verify recipient address, chain, and token contract with the user before executing send.

Risk Disclosure

Digital asset transactions are generally irreversible. Please verify the recipient address before confirming. Outputs from this skill are for informational purposes only and do not constitute investment, financial, tax, or legal advice. AI-assisted outputs are for general information only and do not constitute any representation, warranty, or guarantee by Gate. This skill is intended for users aged 18 or above with full civil capacity; availability may vary by jurisdiction.