よくある質問（FAQ）
Kovaを使う上でよく寄せられる質問をまとめました。目的のカテゴリから探してください。
インストール・セットアップ
Q: Kovaのインストール方法は？
グローバルインストールとnpxによる都度実行の2通りがあります。
# グローバルインストール（推奨）
npm install -g @komlock_lab/kova
# インストールせずに実行
kova <コマンド>グローバルインストールするとkovaコマンドが使えるようになり、毎回ダウンロードが不要になります。
Q: kova の実行が毎回遅い。
npxは実行のたびにパッケージをダウンロードするため、初回または都度実行では時間がかかります。頻繁に使う場合はグローバルインストールを推奨します。
npm install -g @komlock_lab/kovaQ: 対応しているOSは？
macOS（Intel / Apple Silicon）と Linux glibc（x64 / arm64）に対応しています。Node.js 20 以上が必要です。
⚠️ Windows および Alpine Linux (musl) は現在非対応です。 内部で使用している OWS のネイティブバイナリがこれらの環境向けに提供されていないため、インストール後に実行時エラーになります。Windows ユーザーは WSL2 (Ubuntu 等) 経由であれば利用可能です。
ウォレット管理
Q: ウォレットのデータはどこに保存される？
ウォレットは~/.kova/wallets/ディレクトリにAES-256-GCMで暗号化されて保存されます。秘密鍵がそのままディスクに書き込まれることはありません。
Q: ウォレットのバックアップ方法は？
~/.kova/wallets/ディレクトリ全体をバックアップしてください。新しい環境に移行する場合もこのディレクトリをコピーするだけで復元できます。
# バックアップ例
cp -r ~/.kova/wallets/ ~/backup/kova-wallets/Q: 複数のウォレットを管理できる？
v0.x はシングルウォレット固定です。ウォレットは kova init で作成され、自動的に解決されます。
# ウォレット情報の確認
kova wallet info送金・トランザクション
Q: dry-runとは何か？
実際にトランザクションを送信せずに、実行結果をシミュレーションするモードです。--broadcastオプションを付けない限り、自動的にdry-runで動作します。送金前に必ずdry-runで内容を確認する習慣をつけましょう。
# dry-run（デフォルト）
kova send --name my-wallet --to 0xRecipientAddress --amount 0.01 --chain base
# 実際に送信する場合
kova send --name my-wallet --to 0xRecipientAddress --amount 0.01 --chain base --broadcastQ: テストネットで試すことはできる？
はい、base-sepoliaなどのテストネットが利用できます。テストネットのトークンはフォーセットから無料で入手できるため、本番の資金を使わずに動作確認ができます。
# 全チェーン（テストネット含む）の残高を確認
kova balance
kova send --name my-wallet --to 0xRecipientAddress --amount 0.01 --chain base-sepolia --broadcastトラブルシューティング
Q: エラーが出た時はどこを見ればいい？
エラーコードリファレンスを参照してください。エラーコードと対処法が一覧で確認できます。また、トラブルシューティングガイドには具体的な問題と解決策をまとめています。
Q: カスタムRPCを設定するのはなぜ必要？
デフォルトのRPCエンドポイントは共有リソースのため、高負荷時にレート制限や遅延が発生することがあります。本番環境では専用のRPCエンドポイントを使うことで信頼性が向上します。
kova config set rpc.base https://your-rpc-endpoint.comQ: AIエージェントからKovaを使う方法は？
kova skills install でスキルをインストールして、お使いのAIエージェントフレームワークにスキルを有効化してください。スキルを通じてエージェントが自律的にウォレット操作や決済を実行できるようになります。詳細はAIエージェント連携ガイドを参照してください。
Q: Kovaは無料で使える？
CLIツール自体は無料です。ただし、トランザクションを送信する際にはブロックチェーンのガス代が発生します。