Skip to Content
Referenceエラーコード

エラーコード一覧

Kova は、すべてのエラーを JSON 形式で出力します。エラーが発生した場合は ok: false となり、error オブジェクトにエラーコードとメッセージが含まれます。

エラーレスポンスの形式

{
  "ok": false,
  "error": {
    "code": "WALLET_NOT_FOUND",
    "message": "Wallet 'my-wallet' not found"
  }
}

code フィールドには本ページに列挙されたコードが入ります。本ページは packages/cli/src/types.ts の ErrorCode enum と一致しています。

カテゴリ別

ウォレット関連

WALLET_NOT_FOUND

説明: 指定した名前または ID のウォレットが見つかりません。

主な発生コマンド: balance, send, call, wallet info / export, init (HD 派生時)

対処法:

# ウォレット情報を確認
kova wallet info
 
# 正しい名前で再実行
kova balance

チェーン・送金関連

CHAIN_NOT_SUPPORTED

説明: 指定したチェーン名が lib/chains.ts の登録チェーンに含まれていません。

主な発生コマンド: balance, send, call, delegate

対処法: サポートチェーン一覧 から正しい名前を選んでください。

INSUFFICIENT_BALANCE

説明: 送金量・ガス代が不足。--broadcast で実トランザクションを送る前のガス見積もりや残高チェックで検出されます。

主な発生コマンド: send --broadcast, call --broadcast, delegate --broadcast

対処法:

# 残高確認
kova balance
 
# 残高を補充（faucet / 入金）してから再試行

TX_FAILED

説明: トランザクションは送信されたが受領に失敗、または revert したケース。

主な発生コマンド: send --broadcast, call --broadcast

対処法:

  • ネットワーク混雑なら時間を空けて再実行
  • カスタム RPC を使っているなら別エンドポイントへ切り替え（kova config set rpc.<chain> <url>）
  • コントラクト側の require 条件を確認

SIMULATION_FAILED

説明: dry-run 時 (eth_estimateGas / eth_call) のシミュレーションがチェーン側で失敗。

主な発生コマンド: send, call, delegate（--broadcast なしでも発生）

対処法:

  • calldata / args を見直す
  • 残高不足が原因のことも多い → kova balance で確認
  • ERC-7702 経路（--gasless）の場合は delegation 設定済みか kova delegate status で確認

BUNDLER_ERROR

説明: ERC-4337 / ERC-7702 の --gasless 経路で bundler / paymaster が拒否したケース。

主な発生コマンド: send --gasless, call --gasless

対処法:

  • bundler / paymaster URL を確認（kova config list の出力で bundler.<chain> 行を読む）
  • paymaster に対象アドレスのスポンサー枠が残っているか確認

CALLDATA_INVALID

説明: --function の signature と --args の JSON 配列が型・個数不一致、または --data が hex として無効。

主な発生コマンド: call

対処法:

# args は JSON 文字列としてクオート
kova call --name w --to 0x... --function "transfer(address,uint256)" \
  --args '["0xRECIPIENT", "1000000"]' --chain base

CONTRACT_NOT_ALLOWED

説明: --gasless で paymaster の allowlist 外コントラクトを呼ぼうとした。

主な発生コマンド: call --gasless

対処法: 通常実行（--gasless なし）に切り替えるか、allowlist 対象のコントラクトに変更。

Policy / Credential 関連

POLICY_DENIED

説明: ローカル policy エンジンまたは OWS server policy がリクエストを拒否。fail-closed が原則のため、明示的に許可されない操作はすべてここに集約されます。

主な発生コマンド: send, call, sign-*, delegate (agent 経路), policy remove

主な原因:

  • spending_limit の累積超過
  • spending_limit の whitelist にない (chain, token) を試行
  • allowed_chains 違反
  • 参照中の API 鍵があるのに policy remove を実行
  • expires_at 経過

対処法:

kova policy list                          # 設定確認
kova policy update --id <policy-id>       # 対話編集
kova key rotate --name <key-name>         # 参照中キーをローテーションしてから policy remove

POLICY_TAMPERED

説明: API 鍵に紐づくポリシーのハッシュ記録（~/.kova/policy-hashes.json）と OWS 上の現在のポリシー内容が一致しない。改ざん検出。

対処法: kova key rotate --name <key-name> で新しい鍵に差し替え（rotate は新規 hash を再記録）。

POLICY_NOT_FOUND

説明: 指定された policy ID（または API 鍵に紐づく policy）が OWS に存在しない。

対処法: kova policy list で ID を確認、kova policy create --file <path> で作り直す。

SPEND_DATA_CORRUPT

説明: ~/.kova/spend.json（spending_limit の累積記録）が JSON として壊れている。fail-closed のため 0 扱いせず明示的に拒否します。

対処法: ファイルを退避してから削除し、累積を初期化する。次回 --broadcast で新規ファイルが作られます。

mv ~/.kova/spend.json ~/.kova/spend.json.bak

CREDENTIAL_REQUIRED

説明: 非 TTY（agent 経路）で policy-gated 操作を実行したが、credential（OWS API key）が ~/.kova/config.json のアクティブプロファイルに保存されていない。

主な発生コマンド: send / call / sign / delegate（agent 経路）

対処法:

kova init                # credential を作成・保存
kova launch claude       # credential を子プロセスへ注入して claude を起動

KEY_EXPIRED

説明: API 鍵の expires_at を過ぎている。

対処法:

kova key rotate --name <key-name>   # 新しい鍵に差し替え + アクティブ profile 自動更新

ADMIN_REQUIRED

説明: 管理者権限が必要な OWS 操作で、現在の API 鍵に admin scope がない。

対処法: owner として（passphrase 入力で）操作するか、admin 権限を持つ API 鍵で再実行。

Init / Setup 関連

INIT_FAILED

説明: kova init の処理中に致命的な失敗が起きた。

対処法: kova wallet info / kova policy list で現状を確認し、必要に応じて kova init を再実行する。

INIT_INCOMPLETE

説明: kova init でウォレットは作成済みだが Step 4/4 (agent profile 設定) に失敗した half-state。stdout に作成済みウォレット情報が details で含まれる。

主な発生コマンド: init

対処法:

kova init                # セットアップを最初からやり直す（既存ウォレット上書きは確認プロンプトあり）

署名・delegation 関連

DELEGATION_REQUIRED

説明: ERC-7702 --gasless 経路で送信しようとしたが、対象ウォレットに delegation が設定されていない。

主な発生コマンド: send --gasless, call --gasless

対処法:

kova delegate status --name my-wallet --chain base
kova delegate --name my-wallet --chain base --broadcast

DELEGATION_FAILED

説明: kova delegate の broadcast 自体が失敗（authorization 署名や delegation 設定が拒否されたケース）。

対処法: ガス代を確保 → 再試行。チェーンが ERC-7702 をサポートしているか サポートチェーン で確認。

Skills / Plugin 関連

SKILL_NOT_FOUND

説明: 指定された skill 名が登録 repository に存在しない、または local cache から見つからない。

主な発生コマンド: skills install, skills remove

対処法: kova skills search <query> で正しい名前を確認。

SKILL_ALREADY_INSTALLED

説明: 同名 skill が既にインストール済み。

主な発生コマンド: skills install

対処法: kova skills list で現状確認。kova skills update で最新化、または別の名前を指定。

GIT_ERROR

説明: skill repository の clone / pull が失敗。

主な発生コマンド: skills install, skills update

対処法: ネットワーク疎通・git の認証情報を確認。プロキシ環境では GIT_* env var を確認。

Config 関連

CONFIG_NOT_FOUND

説明: ~/.kova/config.json が存在しない、または指定キー / プロファイルが未設定。

対処法:

kova config set defaultWallet my-wallet     # 設定ファイルを生成
kova config list                             # 内容確認

CONFIG_PARSE_ERROR

説明: ~/.kova/config.json が JSON として壊れている。

対処法: ファイルを退避して再作成するか、JSON syntax を手で修正。

Audit / Lock 関連

AUDIT_LOG_FAILED

説明: policy-gated 操作の前後で ~/.kova/audit.log への書き込みが失敗。fail-closed のため操作自体も拒否されます。

対処法: ホームディレクトリの書き込み権限を確認。ディスク残量を確認。

LOCK_ACQUIRE_FAILED

説明: ~/.kova/spend.json または ~/.kova/policy-hashes.json の advisory lock を 30 秒待っても取得できなかった。

対処法: 別の Kova プロセスが走っていないか確認 → 終了。.lock ファイルが残留していたら手動で削除。

TOS 関連

TOS_NOT_AGREED

説明: 利用規約 (TOS) に未同意の状態で書き込み系コマンドを実行しようとした。

対処法:

kova init を実行するか、terms / init 以外の任意のコマンドを TTY 上で叩くと TOS 同意 prompt が再表示されます。非対話環境ではこの prompt に応答できないため、必ず TTY で一度同意を完了させてください。

kova init               # onboarding と TOS 同意を完了させる
kova terms show         # 同意状態の確認

対話・操作要件

INTERACTIVE_INPUT_REQUIRED

説明: owner-only 操作を非 TTY（agent / 非対話）から呼び出した。構造的に block されます。

対処法: 対話可能なターミナルで実行する。owner-only の一覧は OperationKind 分類 を参照。

USER_DENIED

説明: 確認プロンプトでユーザーが明示的に拒否した。

主な発生コマンド: wallet export, wallet reset-passphrase, policy update, policy remove

対処法: 意図して拒否した場合は何もしない。誤操作なら再度コマンドを実行して確認に Yes と答える。

汎用

INVALID_PARAMS

説明: コマンドに渡されたパラメータが無効、不足、または相互排他のオプションを同時指定した。

主な発生コマンド: すべて

対処法: kova <command> --help で構文確認。

OWS_ERROR

説明: ローカル OWS（暗号化ウォレットストレージ）操作の汎用失敗。passphrase mismatch / wallet ファイル破損 / I/O エラーなどがここに集約されます。

主な発生コマンド: ウォレット系全般

対処法:

ls -la ~/.kova/wallets/      # 権限とファイル存在を確認
chmod 700 ~/.kova/wallets/
chmod 600 ~/.kova/wallets/*.json

passphrase 入力ミスなら正しい passphrase で再実行。passphrase を忘れた場合は kova wallet reset-passphrase で変更できます（seed phrase が必要です）。

UNKNOWN_ERROR

説明: 想定外のエラー。

対処法: エラーメッセージとともに Issue を報告してください。

関連項目

Last updated on
サポートトークンよくある質問