Skip to Content
ReferenceSkillsmanage-config

manage-config

デフォルトウォレット・カスタムRPC URLなどの設定を管理するSkillです。AIエージェントが「毎回ウォレット名を指定したくない」「カスタムRPCを設定して」といった指示を受けたとき、このSkillが起動します。

トリガー条件

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

  • “my-walletをデフォルトウォレットにして”
  • “AlchemyのRPC URLを設定して”
  • “現在の設定を確認して”
  • “defaultWalletを取得して”

実行されるコマンド

# 設定値を保存
npx kova@latest config set <key> <value>
 
# すべての設定を一覧表示（個別キー確認もこちら。`config get` は撤去済）
npx kova@latest config list

設定可能なキー

キー説明設定例
defaultWalletデフォルトウォレット名my-wallet
rpc.<chain>チェーン別カスタムRPC URLrpc.base https://your-rpc.com

入力バリデーション

パラメータルール
keydefaultWallet, rpc.<chain> のいずれか
value（チェーン名）サポートされているチェーン名のみ
value（ウォレット名）英数字とハイフンのみ
value（RPC URL）有効なURL形式（https:// または http:// で始まる）

出力例

設定値の保存

{
  "ok": true,
  "data": {
    "key": "defaultWallet",
    "value": "my-wallet"
  }
}

設定一覧表示

{
  "ok": true,
  "data": {
    "config": {
      "defaultWallet": "my-wallet",
      "rpc": {
        "base": "https://base-mainnet.g.alchemy.com/v2/...",
        "ethereum": "https://mainnet.infura.io/v3/..."
      }
    }
  }
}

エラーハンドリング

無効な設定値

{
  "ok": false,
  "error": {
    "code": "INVALID_PARAMS",
    "message": "Invalid chain name: 'invalid-chain'"
  }
}

サポートされているチェーン名（ethereum, base, polygon, arbitrum, optimism等）を使用してください。

パーミッションエラー

設定ファイルへの書き込み権限がない場合は以下を確認してください。

# パーミッションを確認
ls -la ~/.kova/config.json
 
# 必要に応じて修正
chmod 600 ~/.kova/config.json

使用例

初期セットアップ

# 1. デフォルトウォレットを設定
npx kova@latest config set defaultWallet my-wallet
 
# 2. 設定を確認
npx kova@latest config list

設定後は、--chain や --name を省略してコマンドを実行できます。

# 設定後（--json フィルタと組み合わせて特定チェーン・トークンを取り出す）
npx kova@latest balance
npx kova@latest balance --json | jq '.data.rows[] | select(.chain == "base")'

カスタムRPCの設定

本番環境では、信頼性向上のためカスタムRPC URLの設定を推奨します。

# AlchemyのRPCをBaseに設定
npx kova@latest config set rpc.base https://base-mainnet.g.alchemy.com/v2/YOUR_API_KEY
 
# InfuraのRPCをEthereumに設定
npx kova@latest config set rpc.ethereum https://mainnet.infura.io/v3/YOUR_PROJECT_ID
 
# 設定を確認（rpc.base の行を読む）
npx kova@latest config list

主なRPCプロバイダーの無料枠：

プロバイダー無料枠
Alchemy300Mコンピュートユニット/月
Infura10万リクエスト/日
QuickNode1,000万リクエスト/月

設定のバックアップとリセット

# バックアップ
cp ~/.kova/config.json ~/.kova/config.json.backup
 
# バックアップから復元
cp ~/.kova/config.json.backup ~/.kova/config.json
 
# 設定をリセット（デフォルトに戻す）
rm ~/.kova/config.json

設定ファイルの場所

設定は ~/.kova/config.json に保存されます。

{
  "defaultWallet": "my-wallet",
  "rpc": {
    "base": "https://base-mainnet.g.alchemy.com/v2/...",
    "ethereum": "https://mainnet.infura.io/v3/..."
  }
}

直接ファイルを編集することも可能ですが、config set コマンドの使用を推奨します。

関連項目

Last updated on
run-tests用語集