Skip to Content
Introductionユースケース

ユースケース

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 status

Claude 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 \ --broadcast

CAIP-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 で渡します)。

次のステップ

Last updated on