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
| Supported |
Route elsewhere |
| Authentication & session management |
Token swap → gate-dex-trade-cli skill |
| Balance, address & token list queries |
Market data / token info / K-line → gate-dex-market-cli skill |
| Transaction history |
DApp interactions → gate-dex-wallet skill (MCP-based) |
| Token transfers (EVM + Solana) |
x402 payments → gate-dex-wallet skill (MCP-based) |
| Sign 32-byte hex messages / raw tx |
MCP tool calls → gate-dex-wallet skill (MCP-based) |
Prerequisites: A gate-dex binary on PATH.
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):
| Variable |
Purpose |
RUN_ENV |
dev / pre / prod — selects GV API environment and CDN candidates |
WALLET_SERVICE_URL |
web3-wallet-service endpoint (used by balance) |
BW_SERVICE_URL |
web3-business-wallet endpoint |
MARKET_TOKEN_URL |
gateio_service_web3_trade_token endpoint (market/token/swap) |
DATA_API_URL |
web3-data-api endpoint (token info, security audit, ranking) |
BIZ_WALLET_URL |
OAuth session management endpoint |
Global Options
| Option |
Description |
--auth-dir <path> |
Custom auth storage directory (overrides ~/.gate-dex; also via GATE_DEX_HOME env) |
--auth-file <path> |
Custom auth.json file path (overrides --auth-dir; also via GATE_DEX_AUTH_FILE env) |
-v, --version |
Print version |
Sub-Modules
| Sub-module |
File |
Scope |
| Auth |
references/auth.md |
OAuth login/logout, session status, web3-domain |
| Asset Query |
references/asset-query.md |
balance, address, tokens, tx-history, tx-detail |
| Transfer & Sign |
references/transfer.md |
transfer (preview), send (one-shot), sign-msg, sign-tx, sol-tx, gas |
Routing Rules
| User Intent |
Target |
| Login, logout, re-login, session expired, OAuth, "not logged in", switch account, web3-domain |
references/auth.md |
| Check balance, total assets, wallet address, account address, token list, tx history, "how much do I have", "show my tokens" |
references/asset-query.md |
| Transfer, send tokens, "send ETH to 0x...", "transfer USDT", "pay someone", "move tokens", sign-msg, sign-tx, sol-tx |
references/transfer.md |
| Swap, exchange tokens, "swap ETH for USDT", "buy SOL", quote, "convert tokens" |
→ gate-dex-trade-cli skill |
| K-line, token price, market cap, liquidity, trading stats, token security, token rankings, new tokens |
→ gate-dex-market-cli skill |
Execution
- Detect intent using the Routing Rules table; resolve to exactly one sub-module file or a peer-skill route.
- 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.
- Apply the safety rules in this SKILL.md (Security Rules section) before any write command (
send, sign-msg, sign-tx).
- For write paths (
send): require explicit user confirmation in chat before invoking the CLI; preview via transfer first.
- 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
| Command |
Description |
login |
Gate OAuth Device Flow login |
login --google |
Google OAuth Device Flow login |
login --no-open |
Print auth URL instead of opening browser |
logout |
Logout and clear ~/.gate-dex/auth.json |
status |
Show current session info |
web3-domain |
View / refresh dynamic web3_domain list |
web3-domain --refresh |
Force re-fetch domain list |
Wallet Queries
| Command |
Description |
balance |
Total portfolio value (USD) across all chains |
address |
Show EVM + Solana wallet addresses |
tokens |
Token list with balances (gateway) |
tokens --chain ETH,SOL |
Filter by chain |
tokens --page N --size N |
Pagination |
Transfer & Signing
| Command |
Description |
transfer |
Preview-only unsigned tx (no broadcast) |
send |
One-shot: preview → GV checkin → sign → broadcast |
send-tx |
Build → GV checkin → sign → broadcast (or broadcast pre-signed with --hex) |
sol-tx |
Build Solana unsigned tx locally (latest blockhash) |
gas [chain] |
Query gas price + gas limit |
sign-msg <hex> |
Sign 32-byte hex message (GV checkin built-in) |
sign-tx <raw_tx> |
Sign raw hex transaction (GV checkin built-in) |
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
| Command |
Description |
tx-history |
Transfer transaction history |
tx-detail <hash> |
Transaction detail by hash |
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
| Command |
Description |
chain-config [chain] |
Chain config (networkKey, endpoint, chainID) |
rpc |
Raw JSON-RPC call |
Maintenance
| Command |
Description |
cleanup |
Delete ~/.gate-dex |
Key Design Differences from MCP-based Skills
| Aspect |
This skill (gate-dex-wallet-cli) |
MCP-based skill (gate-dex-wallet) |
| Transport |
Pure REST (no MCP) |
MCP tool calls |
| GV security checkin |
Built into CLI send/swap/sign-msg/sign-tx |
External tx-checkin binary required |
| Auth storage |
~/.gate-dex/auth.json |
MCP session mcp_token |
| Swap method |
gate-dex swap one-shot |
dex_tx_swap_* multi-step tools |
| Transfer method |
gate-dex send one-shot |
dex_wallet_sign_transaction + broadcast |
| Agent binary dependency |
None |
tools/tx-checkin/bin/ |
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.
- Pre-check:
gate-dex address → gate-dex tokens for sufficient funds
- Preview:
gate-dex transfer (preview-only, no signing)
- User confirmation in chat: Display details, wait for explicit approval
- Execute:
gate-dex send ... (GV checkin, sign, broadcast handled internally)
- 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:
| User Intent After Operation |
Target |
| Check balance / tokens |
references/asset-query.md |
| Transfer tokens |
references/transfer.md |
| Swap tokens |
gate-dex-trade-cli skill |
| Token prices, K-line, token security |
gate-dex-market-cli skill |
| Login / session issues |
references/auth.md |
NOT This Skill (Common Misroutes)
| User Intent |
Correct Skill |
| DApp connect / sign / approve / contract call |
gate-dex-wallet skill (MCP-based) |
| x402 payment |
gate-dex-wallet skill (MCP-based) |
| On-chain withdraw to Gate Exchange (UID binding) |
gate-dex-wallet skill (MCP-based) |
| MCP tool calls directly |
gate-dex-wallet skill (MCP-based) |
Supported Chains
EVM: eth, bsc, polygon, arbitrum (arb), optimism (op), avax, base
Non-EVM: sol
Chain names are case-insensitive.
Security Rules
- 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.
- Preview before execute: Use
transfer (preview-only) before send.
- No external checkin binary: Do not run
tx-checkin binary — it is not needed; CLI handles it internally.
- Token confidentiality:
~/.gate-dex/auth.json stores credentials. Never display the raw token to users. Never commit this file to Git.
- 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.
1---2name: gate-dex-wallet-cli3description: Gate DEX CLI wallet skill (pure REST). Auth via OAuth, balance, wallet/account addresses, token list, tx history, transfers, and signing. GV checkin is built into signing commands. Use this skill whenever the user wants to log in, check balance/address, view tx history, transfer tokens, or sign messages via the gate-dex CLI. Trigger phrases include login, logout, balance, address, tokens, tx history, transfer, send, sign-msg, sign-tx. For swaps use gate-dex-trade-cli; for market data use gate-dex-market-cli.4---56# Gate DEX CLI78## General Rules910⚠️ STOP — You MUST read and strictly follow the shared runtime rules before proceeding.11Do NOT select or call any tool until all rules are read. These rules have the highest priority.12→ Read [gate-runtime-rules.md](https://github.com/gate/gate-skills/blob/master/skills/gate-runtime-rules.md)13- **Only call MCP tools explicitly listed in this skill.** Tools not documented here must NOT be called, even if they14 exist in the MCP server.15- **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.1617> **Pure Routing Layer** — This SKILL.md is a lightweight router. Sub-module details live in `references/`.1819## Overview2021`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.2223Auth: login via Gate/Google OAuth, token stored in `~/.gate-dex/auth.json`.2425The CLI also supports an **interactive REPL** — running `gate-dex` with no arguments opens a prompt.2627## Applicable Scenarios2829Use this skill when the user wants to:3031- Authenticate (login/logout) via Gate OAuth or Google OAuth32- Query token balances, total portfolio value, or wallet addresses33- View transaction history34- Transfer or send tokens to an on-chain address (EVM + Solana)35- Sign raw messages or raw transactions36- Use `gate-dex` CLI commands directly3738---3940## Capability Boundaries4142| Supported | Route elsewhere |43|-----------|----------------|44| Authentication & session management | Token swap → `gate-dex-trade-cli` skill |45| Balance, address & token list queries | Market data / token info / K-line → `gate-dex-market-cli` skill |46| Transaction history | DApp interactions → `gate-dex-wallet` skill (MCP-based) |47| Token transfers (EVM + Solana) | x402 payments → `gate-dex-wallet` skill (MCP-based) |48| Sign 32-byte hex messages / raw tx | MCP tool calls → `gate-dex-wallet` skill (MCP-based) |4950**Prerequisites**: A `gate-dex` binary on PATH.5152- **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 (`RUN_ENV`, `*_URL`) are collected via the GateClaw Web form and injected into `process.env` at runtime.53- **Personal OpenClaw scenario** — the frontmatter `install` spec downloads the binary for the host OS automatically (no Node.js required).54- **Local development** — build from source:55 ```bash56 cd cli && pnpm install57 pnpm build:binary # production binary (no baked env)58 pnpm build:binary -- --bake-env # bake root .env into the binary (test env)59 ```6061---6263## Installation6465The published binary is a single self-contained executable (no Node.js runtime required).6667```bash68# GateClaw / OpenClaw: auto-installed via setup.sh or frontmatter.install69# Manual download (example):70curl -fsSL https://gate-dex-cli.gateweb3.cc/latest/gate-dex-linux-x64 \71 -o /usr/local/bin/gate-dex72chmod +x /usr/local/bin/gate-dex7374# Login75gate-dex login # Gate OAuth (default)76gate-dex login --google # Google OAuth77```7879**Storage**:80- Auth token → `~/.gate-dex/auth.json`8182**Environment variables** (all optional; defaults target production):8384| Variable | Purpose |85|----------|---------|86| `RUN_ENV` | `dev` / `pre` / `prod` — selects GV API environment and CDN candidates |87| `WALLET_SERVICE_URL` | `web3-wallet-service` endpoint (used by `balance`) |88| `BW_SERVICE_URL` | `web3-business-wallet` endpoint |89| `MARKET_TOKEN_URL` | `gateio_service_web3_trade_token` endpoint (market/token/swap) |90| `DATA_API_URL` | `web3-data-api` endpoint (token info, security audit, ranking) |91| `BIZ_WALLET_URL` | OAuth session management endpoint |9293---9495## Global Options9697| Option | Description |98|--------|-------------|99| `--auth-dir <path>` | Custom auth storage directory (overrides `~/.gate-dex`; also via `GATE_DEX_HOME` env) |100| `--auth-file <path>` | Custom auth.json file path (overrides `--auth-dir`; also via `GATE_DEX_AUTH_FILE` env) |101| `-v, --version` | Print version |102103---104105## Sub-Modules106107| Sub-module | File | Scope |108|-----------|------|-------|109| **Auth** | `references/auth.md` | OAuth login/logout, session status, web3-domain |110| **Asset Query** | `references/asset-query.md` | balance, address, tokens, tx-history, tx-detail |111| **Transfer & Sign** | `references/transfer.md` | transfer (preview), send (one-shot), sign-msg, sign-tx, sol-tx, gas |112113## Routing Rules114115| User Intent | Target |116|-------------|--------|117| Login, logout, re-login, session expired, OAuth, "not logged in", switch account, web3-domain | `references/auth.md` |118| Check balance, total assets, wallet address, account address, token list, tx history, "how much do I have", "show my tokens" | `references/asset-query.md` |119| Transfer, send tokens, "send ETH to 0x...", "transfer USDT", "pay someone", "move tokens", sign-msg, sign-tx, sol-tx | `references/transfer.md` |120| Swap, exchange tokens, "swap ETH for USDT", "buy SOL", quote, "convert tokens" | → `gate-dex-trade-cli` skill |121| K-line, token price, market cap, liquidity, trading stats, token security, token rankings, new tokens | → `gate-dex-market-cli` skill |122123## Execution1241251. **Detect intent** using the Routing Rules table; resolve to exactly one sub-module file or a peer-skill route.1262. **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.1273. **Apply the safety rules in this SKILL.md** (Security Rules section) before any write command (`send`, `sign-msg`, `sign-tx`).1284. **For write paths** (`send`): require explicit user confirmation in chat before invoking the CLI; preview via `transfer` first.1295. **For peer-skill routes** (`gate-dex-trade-cli`, `gate-dex-market-cli`): hand off without invoking those skills' commands from here.130131---132133## Full Command Reference134135### Auth & Session136| Command | Description |137|---------|-------------|138| `login` | Gate OAuth Device Flow login |139| `login --google` | Google OAuth Device Flow login |140| `login --no-open` | Print auth URL instead of opening browser |141| `logout` | Logout and clear `~/.gate-dex/auth.json` |142| `status` | Show current session info |143| `web3-domain` | View / refresh dynamic web3_domain list |144| `web3-domain --refresh` | Force re-fetch domain list |145146### Wallet Queries147| Command | Description |148|---------|-------------|149| `balance` | Total portfolio value (USD) across all chains |150| `address` | Show EVM + Solana wallet addresses |151| `tokens` | Token list with balances (gateway) |152| `tokens --chain ETH,SOL` | Filter by chain |153| `tokens --page N --size N` | Pagination |154155### Transfer & Signing156| Command | Description |157|---------|-------------|158| `transfer` | Preview-only unsigned tx (no broadcast) |159| `send` | One-shot: preview → GV checkin → sign → broadcast |160| `send-tx` | Build → GV checkin → sign → broadcast (or broadcast pre-signed with `--hex`) |161| `sol-tx` | Build Solana unsigned tx locally (latest blockhash) |162| `gas [chain]` | Query gas price + gas limit |163| `sign-msg <hex>` | Sign 32-byte hex message (GV checkin built-in) |164| `sign-tx <raw_tx>` | Sign raw hex transaction (GV checkin built-in) |165166### Swap (out of scope — route to `gate-dex-trade-cli` skill)167168The `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.169170### Transaction History171172| Command | Description |173|---------|-------------|174| `tx-history` | Transfer transaction history |175| `tx-detail <hash>` | Transaction detail by hash |176177### Market & Token Data (out of scope — route to `gate-dex-market-cli` skill)178179The `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.180181### Chain / RPC182| Command | Description |183|---------|-------------|184| `chain-config [chain]` | Chain config (networkKey, endpoint, chainID) |185| `rpc` | Raw JSON-RPC call |186187### Maintenance188| Command | Description |189|---------|-------------|190| `cleanup` | Delete `~/.gate-dex` |191192---193194## Key Design Differences from MCP-based Skills195196| Aspect | This skill (gate-dex-wallet-cli) | MCP-based skill (gate-dex-wallet) |197|--------|------------------------------|-----------------------------------|198| Transport | Pure REST (no MCP) | MCP tool calls |199| GV security checkin | Built into CLI `send`/`swap`/`sign-msg`/`sign-tx` | External `tx-checkin` binary required |200| Auth storage | `~/.gate-dex/auth.json` | MCP session `mcp_token` |201| Swap method | `gate-dex swap` one-shot | `dex_tx_swap_*` multi-step tools |202| Transfer method | `gate-dex send` one-shot | `dex_wallet_sign_transaction` + broadcast |203| Agent binary dependency | None | `tools/tx-checkin/bin/` |204205**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.206207---208209## Agent Usage Notes210211- 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.212- The `send` and `swap` commands are one-shot: they preview, checkin, sign, and broadcast in a single run.213- All amounts use **human-readable values**, not smallest chain units (wei/lamports).214215---216217## On-Chain Operation Flow218219Transfer operations follow: **preview → user confirm in chat → execute one-shot command**.2202211. **Pre-check**: `gate-dex address` → `gate-dex tokens` for sufficient funds2222. **Preview**: `gate-dex transfer` (preview-only, no signing)2233. **User confirmation in chat**: Display details, wait for explicit approval2244. **Execute**: `gate-dex send ...` (GV checkin, sign, broadcast handled internally)2255. **Verify**: `gate-dex tx-detail <hash>`226227**NEVER run `send` without explicit user confirmation.**228229---230231## Follow-up Routing232233After completing an operation, **proactively suggest 2-4 relevant next actions**:234235| User Intent After Operation | Target |236|-----------------------------|--------|237| Check balance / tokens | `references/asset-query.md` |238| Transfer tokens | `references/transfer.md` |239| Swap tokens | `gate-dex-trade-cli` skill |240| Token prices, K-line, token security | `gate-dex-market-cli` skill |241| Login / session issues | `references/auth.md` |242243---244245## NOT This Skill (Common Misroutes)246247| User Intent | Correct Skill |248|-------------|---------------|249| DApp connect / sign / approve / contract call | `gate-dex-wallet` skill (MCP-based) |250| x402 payment | `gate-dex-wallet` skill (MCP-based) |251| On-chain withdraw to Gate Exchange (UID binding) | `gate-dex-wallet` skill (MCP-based) |252| MCP tool calls directly | `gate-dex-wallet` skill (MCP-based) |253254---255256## Supported Chains257258EVM: `eth`, `bsc`, `polygon`, `arbitrum` (arb), `optimism` (op), `avax`, `base`259Non-EVM: `sol`260261Chain names are case-insensitive.262263---264265## Security Rules2662671. **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.2682. **Preview before execute**: Use `transfer` (preview-only) before `send`.2693. **No external checkin binary**: Do not run `tx-checkin` binary — it is not needed; CLI handles it internally.2704. **Token confidentiality**: `~/.gate-dex/auth.json` stores credentials. Never display the raw token to users. Never commit this file to Git.2715. **Transaction irreversibility**: On-chain transfers are generally irreversible. Re-verify recipient address, chain, and token contract with the user before executing `send`.272273---274275## Risk Disclosure276277Digital 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.
gate