perasyudha/skill-web3

skill-web3 は何をしますか？

AIエージェント（OpenClaw、Claude、Cursor）向けのセキュアで非カストディアルなWeb3およびEVM操作スキル。内蔵MCPサーバー、PnL追跡、セキュリティ監査、取引監視を備えています。

はじめに

このスキルにより、AIエージェントはEVM互換のブロックチェーン上でトランザクションの実行、履歴の照会、取引の監視を安全に行うことができます。秘密鍵はエージェント環境から直接アクセスされることはありません。

特徴

• 非カストディアル設計: 秘密鍵は安全に管理され、エージェントが直接アクセスすることはありません。
• マルチチェーン対応: 主要なEVMチェーン（Ethereum、Polygon、Arbitrum、Optimism、Baseなど）をサポートします。
• リアルタイムPnL追跡: トレードのパフォーマンスをリアルタイムで追跡・計算します。
• セキュリティ監査: トランザクションをシミュレートし、実行前にリスクを評価します。
• 取引監視: オンチェーンアクティビティを監視し、異常または不正なトランザクションを特定します。
• MCPサーバー: AIエージェントとブロックチェーンとの間の標準化された通信を容易にするModel Context Protocolサーバーを内蔵しています。

インストール

必要条件

• Node.js 18+（または互換性のあるランタイム）
• 有効なEVMウォレット（MetaMask、WalletConnectなど）

セットアップ

1. リポジトリをクローンします：

   git clone https://github.com/perasyudha/skill-web3.git
   cd skill-web3
   

2. 依存関係をインストールします：

   npm install
   

3. 環境変数を設定します（以下の例を参照）：

   cp .env.example .env
   # .env ファイルを編集し、必要な設定値を追加します。
   

設定

以下の環境変数を設定する必要があります：

変数名	説明	デフォルト値
RPC_URL	EVM互換チェーン用のRPCエンドポイントURL	なし（必須）
WALLET_PRIVATE_KEY	オプション：署名用の暗号化された秘密鍵（push操作がある場合）	なし
MCP_PORT	MCPサーバーがリッスンするポート	3000
DB_PATH	PnLデータを保存するSQLiteデータベースのパス	./data/pnl.db

使用方法

MCPサーバーの起動

npm start

デフォルトでは、MCPサーバーは http://localhost:3000 で起動します。

AIエージェントとの統合

• OpenClaw: MCPサーバーが提供する適切なツール呼び出しを通じて統合します。
• Claude: AnthropicのMCPクライアントを使用してサーバーに接続します。
• Cursor: カスタムスクリプトまたはプラグインを使用します。

使用例（疑似コード）

// MCPクライアントを使用した例示コード
const client = new MCPClient('http://localhost:3000');

// トークン残高を取得
const balance = await client.getBalance('0xYourWalletAddress');
console.log(`残高: ${balance}`);

// トランザクションをシミュレート
const simulation = await client.simulateTransaction({
  to: '0xRecipientAddress',
  value: '1000000000000000000', // 1 ETH（wei単位）
});
console.log(`シミュレーション結果: ${simulation}`);

貢献

1. このリポジトリをフォークします。
2. フィーチャーブランチを作成します（git checkout -b feature/amazing-feature）。
3. 変更をコミットします（git commit -m '素晴らしい機能を追加'）。
4. ブランチにプッシュします（git push origin feature/amazing-feature）。
5. プルリクエストを開きます。

ライセンス

MIT

謝辞

• このプロジェクトに貢献してくれたすべての開発者とテスターに感謝します。