create-wallet

ウォレットのセットアップ・情報確認・エクスポート・パスフレーズリセットを行うSkillです。AIエージェントが「ウォレットを作って」「ウォレットの情報を確認して」「シードフレーズをエクスポートして」といった自然言語の指示を受けたとき、このSkillが起動します。

kova は シングルウォレットモデルです。ウォレットは kova init 時に1つ作成され、名前指定なしで自動解決されます。複数ウォレットの作成・一覧・削除には対応していません。

トリガー条件

以下のような自然言語の指示でこのSkillが呼び出されます。

“ウォレットをセットアップして”
“ウォレットの情報を表示して”
“アドレスを確認して”
“シードフレーズをエクスポートして”

実行されるコマンド


# ウォレット作成（初期セットアップ）
npx kova@latest init
 
# ウォレット情報確認
npx kova@latest wallet info
 
# ウォレット秘密鍵・シードフレーズのエクスポート
npx kova@latest wallet export
 
# パスフレーズのリセット
npx kova@latest wallet reset-passphrase

ウォレットは kova init 時に自動生成されます。以降は kova wallet info / kova status で情報を確認できます。

入力バリデーション

このSkillはユーザーが渡すパラメータを最小限に絞っています。kova wallet info は引数を取りません。kova wallet export と kova wallet reset-passphrase はインタラクティブなプロンプトで確認を求めます（非TTY経路では INTERACTIVE_INPUT_REQUIRED で構造的にブロックされます）。

出力例

ウォレット情報確認


{
  "ok": true,
  "data": {
    "wallet": {
      "id": "wlt_abc123",
      "name": "my-wallet",
      "accounts": [
        { "chainId": "eip155:1", "address": "0x1234...abcd" },
        { "chainId": "eip155:8453", "address": "0x1234...abcd" },
        { "chainId": "eip155:137", "address": "0x1234...abcd" }
      ]
    }
  }
}

ウォレットはEthereum・Base・Polygon・Arbitrum・Optimism・Sepolia・Base Sepolia・Polygon Amoyの全チェーンで同一アドレスが自動的に割り当てられます。

エクスポート成功


{
  "ok": true,
  "data": {
    "wallet": "my-wallet",
    "exported": true
  }
}

シードフレーズはターミナルの標準エラー出力に表示されます。JSON出力には含まれません。

エラーハンドリング

ウォレットが未設定


{
  "ok": false,
  "error": {
    "code": "WALLET_NOT_FOUND",
    "message": "No wallet found. Run \"kova init\" first."
  }
}

npx kova@latest init でウォレットをセットアップしてください。

非TTY経路でのowner-only操作


{
  "ok": false,
  "error": {
    "code": "INTERACTIVE_INPUT_REQUIRED",
    "message": "This operation requires an interactive terminal."
  }
}

kova wallet export と kova wallet reset-passphrase はTTY環境（人間が直接操作するターミナル）でのみ実行できます。

使用例

初めてのウォレットセットアップ


# 1. kova init でウォレットを作成（対話プロンプトで名前・パスフレーズを設定）
npx kova@latest init
 
# 2. ウォレット情報を確認（Base用アドレスを取得する場合など）
npx kova@latest wallet info
 
# 3. 残高を確認
npx kova@latest balance

ウォレット情報の確認


# ウォレットのアドレスや詳細を確認
npx kova@latest wallet info
 
# ステータス（ウォレット・エージェント設定の概要）を確認
npx kova@latest status