ユースケース
Kova は、AI エージェントから人間の開発者まで、さまざまな場面で Web3 決済とウォレット運用を自動化します。代表的な 4 つのユースケースを実コマンドで紹介します。
1. AI エージェントから Kova を使う
シナリオ
AI エージェント(Claude Code など)から Kova を操作したいケースです。kova init を実行すると、エージェントキーが ~/.kova/config.json に保存され、Kova のスキルが ~/.claude/skills/ にインストールされます。あとは claude を起動するだけで、エージェントが Kova を agent モードで呼び出せます。環境変数を毎回設定する必要はありません。
コマンド例
# セットアップ(ウォレット・支払いルール・エージェントキー・スキルを一括)
kova init
# claude を起動するだけ。発行済みのエージェントキーが自動で使われる
claude
# 状態を確認(wallet / authMethod / policy / agent setup を集約表示)
kova statusClaude Code から kova send --broadcast などが呼ばれると、自動的に agent 経路(credential 経由)で署名され、enforcePolicy() で policy 上限・許可リストに照合されます。
子プロセスへ渡す環境変数を sanitize して起動したい場合は、任意で
kova launch claudeラッパも使えます。詳細はlaunchリファレンス を参照してください。
2. マルチチェーンウォレット管理
シナリオ
Base・Polygon・Ethereum など複数のチェーンに資産を保有している場合、1 つのウォレット名で各チェーンの残高を横断的に管理できます。DeFi プロトコルの使い分けや、チェーンごとのガスコスト最適化に役立ちます。
コマンド例
# 全チェーンの残高一覧
kova balance
# Base から USDC を送金(dry-run)
kova send \
--name my-wallet \
--chain base \
--token USDC \
--to 0xRecipientAddress \
--amount 5.00
# 同じ送金を実ブロードキャスト
kova send \
--name my-wallet \
--chain base \
--token USDC \
--to 0xRecipientAddress \
--amount 5.00 \
--broadcast
# Polygon のネイティブトークン(POL)を送金
kova send \
--name my-wallet \
--chain polygon \
--to 0xRecipientAddress \
--amount 1.0 \
--broadcastCAIP-2 形式のチェーン ID(eip155:8453 等)で同一のウォレットインターフェースを使い、複数チェーンを統一的に操作できます。
3. 組織・DAO の自動支払い
シナリオ
DAO(分散型自律組織)や企業が、複数のアドレスやサービスに対して定期的・バッチ的に支払いを行うケースです。スマートコントラクトのガバナンス結果や CSV から支払いリストを生成し、CLI で一括実行するワークフローに組み込めます。
コード例
import { execSync } from 'node:child_process';
interface Payment {
address: string;
amount: string;
description: string;
}
// DAO の支払いリスト(ガバナンスデータや CSV から生成)
const payments: Payment[] = [
{ address: '0xContributor1', amount: '100.00', description: 'コントリビューター報酬' },
{ address: '0xContributor2', amount: '75.00', description: 'バグバウンティ報酬' },
{ address: '0xVendor1', amount: '50.00', description: 'インフラ費用' },
];
for (const payment of payments) {
console.log(`送金中: ${payment.description} → ${payment.address}`);
execSync(
`kova send \
--name dao-treasury \
--chain base \
--token USDC \
--to ${payment.address} \
--amount ${payment.amount} \
--broadcast`,
{ stdio: 'inherit' }
);
console.log(`完了: ${payment.amount} USDC`);
}
console.log('全ての支払いが完了しました');DAO Treasury のような無人運用では dao-treasury を agent profile として初期化し、policy(1 日上限・許可リスト)でガードしてから運用するのが推奨パターンです。スクリプトを CI/CD パイプラインや cron ジョブに組み込めば、定期支払いの完全自動化が実現します(credential は環境変数 KOVA_CREDENTIAL / KOVA_API_KEY_ID で渡します)。
次のステップ
- クイックスタート — 実際に動かしてみる
- アーキテクチャ — 技術的な仕組みを理解する
- AI エージェント統合 — エージェントから Kova を使う仕組み
kova status— 現在の wallet / authMethod / policy 状態を確認- Skills 概要 — 公式 Skill を確認する
- CLI コマンドリファレンス — 全コマンドの詳細