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

gate-dex-wallet