zerion-wallet

Zerion — ウォレット管理

Open Wallet Standard（OWS）のボルト ~/.ows/ に保存される暗号化されたローカルウォレットです。AES-256-GCM を使用します。キーがデバイスの外に出ることはありません。

セットアップ

zerion コマンドが command not found で失敗する場合は、次のコマンドを一度実行してインストールしてください。

npm install -g zerion-cli

Node.js ≥ 20 が必要です。認証については、zerion の統合スキルを参照してください。

使用する場面

• 「新しいウォレットを作成する」
• 「秘密鍵／ニーモニックからウォレットをインポートする」
• 「ウォレットを表示する」／「入金アドレスを一覧表示する」
• 「リカバリーフレーズをバックアップする」
• 「このウォレットを削除する」
• 「ウォレットを Zerion モバイルアプリと同期する」

ウォレットを使ったオンチェーン操作については、zerion-trading を参照してください。ウォレットでのエージェントトークンのセットアップについては、zerion-agent-management を参照してください。

ウォレットとチェーン

ニーモニックから生成されたウォレット（wallet create または wallet import --mnemonic で作成）は、EVM アカウントと Solana アカウントの両方を保持します。そのため、同じウォレットでどちらのチェーンでも署名でき、双方向のクロスチェーンブリッジの送金先として使用できます。

単一の秘密鍵からインポートしたウォレットが保持するアカウントは、1 つのチェーンのみです。

インポートフラグ	アカウントの種類	スワップ可能なチェーン	クロスチェーンの送金先として使用可能なチェーン
--mnemonic	EVM + Solana	両方	両方
--evm-key	EVM のみ	EVM チェーン	EVM チェーン
--sol-key	Solana のみ	Solana	Solana

wallet list では、各ウォレットがどのアカウントを持っているかを確認できます。クロスチェーンブリッジの --to-wallet を選ぶ際は、この情報を確認してください。送金先のウォレットには、対象チェーンのアカウントが必要です。

エージェント操作と手動操作

操作	種類	備考
wallet list、wallet fund	エージェント	読み取り専用です。自律的に実行しても安全です。
wallet create、wallet import、wallet backup、wallet delete、wallet sync	手動	パスフレーズまたは対話形式の入力が必要です。人間が直接実行する必要があります。エージェントは実行してはいけません。

読み取り専用 — エージェントは自由に実行できます

zerion wallet list                        # All wallets, addresses, active policies
zerion wallet list --search <query>       # Filter by name or address
zerion wallet list --limit <n> --offset <n>   # Paginate
zerion wallet fund --wallet <name>        # Show EVM + Solana deposit addresses

手動 — 人間のみ

パスフレーズ、秘密鍵、または確認を求められます。エージェントのループから実行しないでください。

# Create a fresh encrypted wallet (EVM + Solana, generated locally)
zerion wallet create --name <name>

# Import from existing keys (interactive secret prompts — never expose keys in shell history)
zerion wallet import --name <name> --evm-key
zerion wallet import --name <name> --sol-key
zerion wallet import --name <name> --mnemonic

# Export the recovery phrase (passphrase required)
zerion wallet backup --wallet <name>

# Permanently delete (passphrase + confirmation)
zerion wallet delete <name>

# Sync to the Zerion mobile app via a one-time QR code
zerion wallet sync --wallet <name>
zerion wallet sync --all

デフォルトの設定

ウォレット関連の設定は zerion config で行います。

zerion config set defaultWallet <name>    # Used when --wallet is omitted
zerion config get defaultWallet
zerion config unset defaultWallet         # Resets to "no default"
zerion config list                        # Show all config (sensitive values redacted)

~/.zerion/config.json はモード 0o600 で作成されます。

典型的なセットアップの流れ（人間が順番に実行）

# 1. Create wallet (passphrase prompt; offers agent-token setup at the end)
zerion wallet create --name agent-bot

# 2. Fund it
zerion wallet fund --wallet agent-bot
# → prints EVM and Solana deposit addresses

# 3. Set as default so future commands omit --wallet
zerion config set defaultWallet agent-bot

# 4. (Optional) sync to mobile
zerion wallet sync --wallet agent-bot

手順 1 のエージェントトークンのプロンプトに答えると、ウォレットを zerion-trading 経由で自律的な取引に利用できるようになります。後からエージェントトークンやポリシーを設定する場合は、zerion-agent-management を参照してください。

よくあるエラー

コード	原因	解決方法
wallet_exists	ウォレット名がすでに使われています	別の名前を選ぶか、先に wallet delete を実行してください
wallet_not_found	OWS ボルトにその名前がありません	zerion wallet list で既存のウォレットを確認してください
bad_passphrase	間違ったパスフレーズを入力しました	再試行してください。パスフレーズは作成時に設定されています
bad_mnemonic	リカバリーフレーズの形式が無効です	再入力してください。有効な BIP-39 形式である必要があります
bad_evm_key	0x で始まる 16 進数が無効です	0x の後に 64 桁の 16 進数を指定してください
bad_sol_key	base58 のキーペアが無効です	Solana のキーは base58 形式で、87 文字以上である必要があります