nansen-wallet

ウォレット

認証の設定

# Save API key (non-interactive)
nansen login --api-key <key>
# Or via env var:
NANSEN_API_KEY=<key> nansen login

# Verify
nansen research profiler labels --address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 --chain ethereum

ウォレットの作成（エージェントによる2段階の手順）

ウォレットの作成には、人間のユーザーが設定したパスワードが必要です。エージェントはパスワードを生成したり、自分で保存したりしてはいけません。

ステップ1（エージェント → 人間）： ウォレットのパスワード（12文字以上）をユーザーに入力してもらいます。

ステップ2（エージェントが実行）： ユーザーから受け取ったパスワードを使って、作成コマンドを実行します。

NANSEN_WALLET_PASSWORD="<password_from_user>" nansen wallet create

作成後、CLI はパスワードを自動的に保存します。

• OS のキーチェーン（macOS Keychain、Linux secret-tool、Windows Credential Manager）— 安全性が高く、推奨されます
• ~/.nansen/wallets/.credentials ファイル — キーチェーンを利用できない場合の安全性の低い代替手段（コンテナや CI など）

今後のすべてのウォレット操作では、パスワードが自動的に取得されます — 環境変数も人間による入力も必要ありません。

.credentials ファイルによる代替手段が使われる場合、CLI は操作のたびに警告を表示します。後から安全なストレージに移行するには、nansen wallet secure を実行してください。

パスワードの解決順序（自動）

1. NANSEN_WALLET_PASSWORD 環境変数（設定されている場合）
2. OS のキーチェーン（ウォレット作成時に自動保存）
3. ~/.nansen/wallets/.credentials ファイル（警告を伴う安全性の低い代替手段）
4. 手順を示す構造化 JSON エラー（いずれも利用できない場合）

エージェントに関する重要なルール

• 絶対に自分でパスワードを生成しないでください — 必ず人間のユーザーに確認してください
• パスワードをファイル、メモリ、ログ、会話履歴に絶対に保存しないでください
• --human フラグは絶対に使用しないでください — エージェントが処理できない対話型プロンプトを有効にします
• ウォレット作成後は、今後の操作でパスワードは不要です — キーチェーンが処理します
• PASSWORD_REQUIRED エラーが発生した場合は、ユーザーにもう一度パスワードの入力を依頼してください

作成

# Ask the user for a password first, then:
NANSEN_WALLET_PASSWORD="<password_from_user>" nansen wallet create
# Or with a custom name:
NANSEN_WALLET_PASSWORD="<password_from_user>" nansen wallet create --name trading

一覧表示と確認

nansen wallet list
nansen wallet show <name>
nansen wallet default <name>

送信

# Send native token (SOL, ETH) — password auto-resolved from keychain
nansen wallet send --to <addr> --amount 1.5 --chain solana

# Send entire balance
nansen wallet send --to <addr> --chain evm --max

# Dry run (preview, no broadcast)
nansen wallet send --to <addr> --amount 1.0 --chain evm --dry-run

エクスポートと削除

# Password auto-resolved from keychain
nansen wallet export <name>
nansen wallet delete <name>

パスワードを忘れる

# Remove saved password from all stores (keychain + .credentials file)
nansen wallet forget-password

安全なストレージへの移行

nansen wallet secure

（~/.nansen/.env、.credentials、または環境変数のみを使用する構成からの）詳しい移行手順については、nansen-wallet-migration スキルを参照してください。

フラグ

フラグ	用途
--to	送信先アドレス
--amount	送信する数量
--chain	evm または solana
--max	残高全額を送信
--dry-run	ブロードキャストせずにプレビュー
--human	対話型プロンプトを有効化（人間がターミナルで使用する場合のみ — エージェントは使用してはいけません）
--unsafe-no-password	暗号化をスキップ（キーが平文で保存されます — 非推奨）

環境変数

変数	用途
NANSEN_WALLET_PASSWORD	ウォレットの暗号化パスワード — wallet create の初回実行時のみ必要です。それ以降は OS のキーチェーンが処理します。
NANSEN_API_KEY	API キー（nansen login --api-key <key> でも設定できます）
NANSEN_EVM_RPC	カスタム EVM RPC エンドポイント
NANSEN_SOLANA_RPC	カスタム Solana RPC エンドポイント