wallet コマンド

walletコマンドは、Kova でウォレットの操作を行うためのコマンドです。Open Wallet Standard（OWS）に準拠したHDウォレットを使用し、複数のチェーンで同じアドレスを使用できます。

ウォレットの作成は kova init で行います。kova wallet はすでに作成済みのウォレットに対する操作に使用します。

構文


kova wallet <subcommand>

サブコマンド一覧

サブコマンド	説明
`info`	ウォレット詳細を表示
`export`	シードフレーズ / 秘密鍵をエクスポート
`reset-passphrase`	マスターウォレットのパスフレーズをリセット

サブコマンドにフラグはありません。対象ウォレットは自動解決されます（v0.x はシングルウォレットモデル）。

wallet info

ウォレットの詳細情報を表示します。全チェーンのアカウントアドレスと派生パスが表示されます。

構文


kova wallet info

オプション

このサブコマンドにはオプションはありません。

使用例


kova wallet info

出力例:


{
  "ok": true,
  "data": {
    "wallet": {
      "id": "68cf6dba-a1b2-4c3d-8e9f-0123456789ab",
      "name": "default",
      "accounts": [
        {
          "chainId": "eip155:1",
          "chainName": "Ethereum",
          "address": "0xB8EC761bf83B4374877e903d217222F2cd5512De",
          "derivationPath": "m/44'/60'/0'/0/0"
        },
        {
          "chainId": "eip155:8453",
          "chainName": "Base",
          "address": "0xB8EC761bf83B4374877e903d217222F2cd5512De",
          "derivationPath": "m/44'/60'/0'/0/0"
        },
        {
          "chainId": "eip155:137",
          "chainName": "Polygon",
          "address": "0xB8EC761bf83B4374877e903d217222F2cd5512De",
          "derivationPath": "m/44'/60'/0'/0/0"
        }
        // ... 他のチェーンのアカウント
      ]
    }
  }
}

wallet export

ウォレットのシードフレーズまたは秘密鍵をエクスポートします（owner-only）。実行すると Export wallet secret (seed phrase or private key)? の確認プロンプトと passphrase 入力が要求されます。シークレットは stderr に表示され、stdout の JSON には含まれません（誤って会話履歴等に保存されるのを防ぐため）。

構文


kova wallet export

使用例


kova wallet export

stderr 表示（シークレット本体）:


=== WALLET SECRET (STORE SAFELY) ===
Write down the following words and store them in a safe place.
This is the ONLY way to recover your wallet.
WARNING: Never share this secret. Anyone with it can steal your funds.

  word1 word2 word3 ... word12

===================================

stdout 出力例（JSON、シークレットなし）:


{
  "ok": true,
  "data": {
    "wallet": "default",
    "exported": true
  }
}

警告:

シードフレーズと秘密鍵は厳重に管理してください。漏洩すると資産を失う可能性があります。
表示先は stderr のみなので、ターミナルから直接読むのが前提です。2> で stderr をリダイレクトするとファイルに保存されますが、その場合は確実に削除・暗号化してください。
owner-only 操作なので非 TTY（agent 経由）からは構造的に拒否されます（OperationKind 分類）。

wallet reset-passphrase

マスターウォレットのパスフレーズをリセットします（owner-only）。

構文


kova wallet reset-passphrase

フロー

シードフレーズ入力（所有権証明）
新しいパスフレーズ入力
新しいパスフレーズ確認

注意: パスフレーズを忘れると、ウォレットにアクセスできなくなります。事前に kova wallet export でシードフレーズをバックアップしておくことを推奨します。

セキュリティのベストプラクティス

バックアップ: kova init でウォレット作成後、すぐにシードフレーズをバックアップ
オフライン保管: シードフレーズは紙に書いてオフライン保管
複数箇所に保管: 火災・盗難に備えて複数箇所に分散保管
デジタル保存厳禁: クラウドストレージやメールに保存しない
定期的な確認: バックアップが正しく保存されているか定期確認

ウォレットの仕組み

Kova のウォレットは、Open Wallet Standard（OWS）に準拠したHDウォレットです。

HDウォレットと派生パス

マスターシード: kova init 実行時に生成される12単語のシードフレーズ
派生パス: BIP-44準拠の派生パス（m/44'/60'/0'/0/0）を使用
マルチチェーン: 1つのシードから全チェーンのアカウントを派生

暗号化方式

暗号化アルゴリズム: AES-256-GCM
鍵派生: PBKDF2でパスワードから鍵を派生
保存場所: ~/.kova/wallets/<wallet-id>.json

詳細は、Core Concepts: ウォレットを参照してください。

次のステップ

ウォレット作成: init でウォレットを作成しましょう
残高確認: 残高確認でウォレットの残高を確認しましょう
送金する: 送金ガイドで送金方法を学びましょう
AIエージェント統合: AIエージェント統合ガイドでスキル経由のウォレット操作を学びましょう
セキュリティ: セキュリティガイドでウォレットの安全な管理方法を確認しましょう