gate-dex-wallet-cli

Gate DEX CLI

基本ルール

⚠️ 停止 — 続行する前に、共有ランタイムルールを必ず読み、厳密に従ってください。 すべてのルールを読むまで、いかなるツールも選択または呼び出さないでください。これらのルールは最優先です。 → gate-runtime-rules.md を読んでください。

• このスキルに明記されている MCP ツールのみ呼び出してください。 MCP サーバーに存在していても、ここに記載されていないツールを呼び出してはいけません。
• このスキルおよびその参照資料に明記されている gate-dex CLI サブコマンドのみ使用してください。 ほかのインターフェースから利用できる場合でも、ここに記載されていないコマンドをこれらのワークフローで実行してはいけません。

純粋なルーティングレイヤー — この SKILL.md は軽量なルーターです。サブモジュールの詳細は references/ にあります。

概要

gate-dex は、REST API 経由で Gate DEX サービスと通信するスタンドアロンの CLI ツールです。MCP サーバーは不要です。 すべての署名操作（transfer、sign-msg、swap）には GV セキュリティチェックインが組み込まれているため、エージェントが外部バイナリを実行する必要はありません。

認証：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 バイトの 16 進数メッセージ／生 tx への署名	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 仕様により、ホスト OS 用のバイナリが自動的にダウンロードされます（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	送金（プレビュー）、送信（ワンショット）、メッセージ署名、トランザクション署名、Solana トランザクション、ガス

ルーティングルール

ユーザーの意図	対象
ログイン、ログアウト、再ログイン、セッションの期限切れ、OAuth、「ログインしていない」、アカウントの切り替え、web3-domain	references/auth.md
残高、総資産、ウォレットアドレス、アカウントアドレス、トークン一覧、取引履歴、「いくら持っていますか」、「トークンを表示して」	references/asset-query.md
送金、トークンの送信、「0x... に ETH を送って」、「USDT を送金」、「誰かに支払う」、「トークンを移動する」、メッセージ署名、トランザクション署名、Solana トランザクション	references/transfer.md
スワップ、トークン交換、「ETH を USDT にスワップ」、「SOL を購入」、見積もり、「トークンを変換」	→ gate-dex-trade-cli スキル
K ライン、トークン価格、時価総額、流動性、取引統計、トークンのセキュリティ、トークンランキング、新規トークン	→ gate-dex-market-cli スキル

実行

1. ルーティングルールの表を使って意図を検出し、サブモジュールファイルまたは関連スキルへのルートのいずれか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 デバイスフローでログイン
login --google	Google OAuth デバイスフローでログイン
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 チェックイン → 署名 → ブロードキャスト
send-tx	構築 → GV チェックイン → 署名 → ブロードキャスト（または --hex で署名済みトランザクションをブロードキャスト）
sol-tx	Solana の未署名トランザクションをローカルで構築（最新のブロックハッシュ）
gas [chain]	ガス価格とガス上限を照会
sign-msg <hex>	32 バイトの 16 進数メッセージに署名（GV チェックイン内蔵）
sign-tx <raw_tx>	生の 16 進数トランザクションに署名（GV チェックイン内蔵）

スワップ（対象外 — 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 セキュリティチェックイン	CLI の send／swap／sign-msg／sign-tx に組み込み済み	外部の tx-checkin バイナリが必要
認証情報の保存先	~/.gate-dex/auth.json	MCP セッションの mcp_token
スワップ方法	gate-dex swap によるワンショット実行	dex_tx_swap_* による複数ステップのツール
送金方法	gate-dex send によるワンショット実行	dex_wallet_sign_transaction ＋ブロードキャスト
エージェントのバイナリ依存関係	なし	tools/tx-checkin/bin/

重要：この CLI スキルを使用する場合、エージェントは tx-checkin バイナリを別途実行してはなりません。CLI が内部で GV チェックインを処理します。ユーザーの確認後に CLI コマンドを実行してください。

---

エージェントの使用上の注意

• エージェントは非対話型シェル（stdin なし）で実行されます。確認を求めるコマンドは停止するため、send と swap を実行する前に、必ずチャットでユーザーの確認を得てください。
• send と swap コマンドはワンショットです。1 回の実行でプレビュー、チェックイン、署名、ブロードキャストを行います。
• すべての金額は、チェーンの最小単位（wei／lamports）ではなく、人が読みやすい値を使用します。

---

オンチェーン操作のフロー

送金操作は、次の順序で行います：プレビュー → チャットでユーザーが確認 → ワンショットコマンドを実行。

1. 事前確認：gate-dex address → gate-dex tokens で十分な残高があることを確認
2. プレビュー：gate-dex transfer（プレビューのみ。署名は行いません）
3. チャットでユーザーが確認：詳細を表示し、明示的な承認を待つ
4. 実行：gate-dex send ...（GV チェックイン、署名、ブロードキャストは内部で処理）
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. 外部の checkin バイナリを実行しない：tx-checkin バイナリは実行しないでください。不要であり、CLI が内部で処理します。
4. トークンの機密性：~/.gate-dex/auth.json には認証情報が保存されています。生のトークンをユーザーに表示しないでください。このファイルを Git にコミットしないでください。
5. トランザクションの不可逆性：オンチェーン送金は一般に取り消せません。send を実行する前に、送信先アドレス、チェーン、トークンコントラクトをユーザーに再確認してください。

---

リスクに関する開示

デジタル資産の取引は一般に取り消せません。確認する前に、送信先アドレスを確認してください。このスキルの出力は情報提供のみを目的としており、投資、財務、税務、法律に関する助言を構成するものではありません。AI 支援による出力は一般的な情報提供のみを目的としており、Gate による表明、保証、確約を構成するものではありません。このスキルは、十分な民事行為能力を有する18歳以上のユーザーを対象としています。利用可否は管轄区域によって異なる場合があります。