Gate DEX Wallet
Comprehensive Wallet Skill — Unified entry point for authentication, assets, transfers, DApp interactions, and CLI command-line. 5 major modules through sub-function routing distribution.
Trigger Scenarios: Use this Skill when users mention "login", "check balance", "transfer", "DApp", "sign", "wallet", "assets", "gate-wallet", "CLI", "command-line", "openapi-swap" and other wallet-related operations.
Core Modules
| Module | Description | Typical Scenarios |
|---|
| 🔐 Authentication | Google OAuth login, Token management | "login", "logout", "token expired" |
| 💰 Assets | Balance queries, address retrieval, transaction history | "check balance", "total assets", "transaction history" |
| 💸 Transfer | Gas estimation, transaction building, signature broadcast | "transfer", "send tokens", "batch transfer" |
| 🎯 DApp | Wallet connection, message signing, contract interaction | "connect DApp", "sign message", "Approve" |
| 🖥️ CLI | gate-wallet CLI dual-channel (MCP custodial signing + OpenAPI hybrid mode) | "gate-wallet", "CLI", "command-line", "openapi-swap", "hybrid swap" |
Routing Rules
Route to corresponding sub-function reference files based on user intent:
| User Intent | Example Keywords | Reference File |
|---|
| Authentication login | "login", "login", "auth", "token expired", "session" | references/auth.md |
| Asset queries | "check balance", "total assets", "wallet address", "transaction history", "Swap history" | Keep current SKILL.md main flow |
| Transfer operations | "transfer", "send", "transfer", "batch transfer", "Gas fee" | references/transfer.md |
| DApp interactions | "DApp", "sign message", "Approve", "connect wallet", "contract call" | references/dapp.md |
| CLI operations | "gate-wallet", "CLI", "command-line", "openapi-swap", "hybrid swap", "hybrid mode swap" | references/cli.md |
MCP Server Connection Detection
Initial Session Detection
Execute connection probe once before first MCP tool call in session to confirm Gate Wallet MCP Server availability. No need to repeat detection for subsequent operations.
CallMcpTool(server="gate-wallet", toolName="chain.config", arguments={chain: "eth"})
| Result | Handling |
|---|
| Success | MCP Server available, continue executing user-requested specific operations |
| Failure | Show configuration guidance based on error type (see error handling below) |
Runtime Error Fallback
For subsequent operations, if business tool calls fail (connection error, timeout, etc.), handle according to the following rules:
| Error Type | Keywords | Handling |
|---|
| MCP Server not configured | server not found, unknown server | Show MCP Server configuration guidance |
| Remote service unreachable | connection refused, timeout, DNS error | Suggest checking server status and network connection |
| Authentication failure | 401, unauthorized, x-api-key | Suggest contacting administrator for API Key |
Authentication State Management
All operations requiring authentication (asset queries, transfers, DApp interactions) need valid mcp_token:
- If currently no
mcp_token → Guide to references/auth.md to complete login then return
- If
mcp_token expired (MCP Server returns token expired error) → First try auth.refresh_token silent refresh, guide to re-login if failed
MCP Tool Call Specifications (Asset Query Module)
1. wallet.get_token_list — Query Token Balances
Query token balance list for specified chain or all chains.
| Field | Description |
|---|
| Tool Name | wallet.get_token_list |
| Parameters | { chain?: string, network_keys?: string, account_id?: string, mcp_token: string, page?: number, page_size?: number } |
| Return Value | Token array, each item contains symbol, balance, price, value, chain, contract_address, etc. |
Call example:
CallMcpTool(
server="gate-wallet",
toolName="wallet.get_token_list",
arguments={ chain: "ETH", mcp_token: "<mcp_token>" }
)
2. wallet.get_total_asset — Query Total Asset Value
| Field | Description |
|---|
| Tool Name | wallet.get_total_asset |
| Parameters | { account_id: string, mcp_token: string } |
| Return Value | { total_value_usd: number, chains: Array<{chain: string, value_usd: number}> } |
3. wallet.get_addresses — Get Wallet Addresses
| Field | Description |
|---|
| Tool Name | wallet.get_addresses |
| Parameters | { account_id: string, mcp_token: string } |
| Return Value | Wallet address objects for each chain |
4. chain.config — Chain Configuration Info
| Field | Description |
|---|
| Tool Name | chain.config |
| Parameters | { chain: string, mcp_token: string } |
| Return Value | Chain configuration info (RPC, block explorer, etc.) |
5. tx.list — Wallet comprehensive (auth, assets, transfer, DApp) transaction list
| Field | Description |
|---|
| Tool Name | tx.list |
| Parameters | { account_id: string, chain?: string, page?: number, limit?: number, mcp_token: string } |
| Return Value | Transaction history array |
6. tx.detail — Transaction Details
| Field | Description |
|---|
| Tool Name | tx.detail |
| Parameters | { hash_id: string, chain: string, mcp_token: string } |
| Return Value | Detailed transaction information |
7. tx.history_list — Swap History Records
| Field | Description |
|---|
| Tool Name | tx.history_list |
| Parameters | { account_id: string, chain?: string, page?: number, limit?: number, mcp_token: string } |
| Return Value | Swap history array |
Operation Flows
Flow A: Query Token Balances
Step 0: MCP Server connection detection
↓ Success
Step 1: Authentication check
Confirm holding valid mcp_token and account_id
No token → Route to references/auth.md
↓
Step 2: Execute query
Call wallet.get_token_list({ chain?, network_keys?, mcp_token })
↓
Step 3: Format display
Group by chain, sort by value, filter zero balances
Flow B: Query Total Asset Value
Step 0-1: Same as Flow A
↓
Step 2: Execute query
Call wallet.get_total_asset({ account_id, mcp_token })
↓
Step 3: Format display
Total value + distribution by chain
Flow C-G: Other Asset Query Flows
Similar to above flows, detailed specifications see original SKILL.md content.
Skill Routing
Post-asset viewing follow-up operation guidance:
| User Intent | Target |
|---|
| View token prices, K-line charts | gate-dex-market |
| View token security audits | gate-dex-market |
| Transfer, send tokens | This Skill references/transfer.md |
| Swap/Exchange tokens | gate-dex-trade |
| Interact with DApps | This Skill references/dapp.md |
| Login/Auth expired | This Skill references/auth.md |
| Use CLI / command-line operations / hybrid mode Swap | This Skill references/cli.md |
Cross-Skill Collaboration
This Skill serves as wallet data center, called by other Skills:
| Caller | Scenario | Used Tools |
|---|
gate-dex-trade | Pre-swap balance validation, token address resolution | wallet.get_token_list |
gate-dex-trade | Get chain-specific wallet address | wallet.get_addresses |
gate-dex-market | Guide to view holdings after market data query | wallet.get_token_list |
| CLI sub-module | CLI dual-channel operations (MCP custodial signing / OpenAPI hybrid Swap) | references/cli.md |
Supported Chains
| Chain ID | Network Name | Type |
|---|
eth | Ethereum | EVM |
bsc | BNB Smart Chain | EVM |
polygon | Polygon | EVM |
arbitrum | Arbitrum One | EVM |
optimism | Optimism | EVM |
avax | Avalanche C-Chain | EVM |
base | Base | EVM |
sol | Solana | Non-EVM |
Security Rules
- Authentication check: Check
mcp_token validity before all operations
- Sensitive information:
mcp_token must not be displayed in plain text in conversations
- Auto refresh: Prioritize silent refresh when token expires
- Guidance mechanism: Guide to
references/auth.md when authentication fails
- Cross-Skill security: Provide secure balance validation and address retrieval for other Skills