mcpField
E
ethskills

ethskills

github.com/austintgriffith開発3022.4k 回インストール2 日前に更新
リポジトリ

ethskills について

ethskillsは、EthereumのdAppやコントラクトの構築、レビュー、デプロイ向けのスキル集です。タスク別ガイドに加え、プロトコル情報、セキュリティ実践、レビュー手順を扱います。

主な機能

  1. 01段階的なdApp構築ガイド
  2. 02Ethereumのプロトコル、コスト、チェーンを網羅
  3. 03Solidityのセキュリティとテストを解説
  4. 04CROPSレビュー、QA、コントラクト監査を収録
  5. 05フロントエンドやデプロイ向けスキルを提供

活用シーン

  1. 01Ethereum dAppの計画とリリース
  2. 02アーキテクチャや信頼性の前提をレビュー
  3. 03スマートコントラクトのテストや監査
  4. 04EthereumフロントエンドやZKプライバシーアプリの構築

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/austintgriffith/ethskills --skill ethskills

インストール後、Claude Code で/ethskillsを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

CLAUDE.md
.gitignore
AGENTS.md
CONTRIBUTING.md
README.md
inbox.html
index.html
llms.txt
vercel.json
.claude-plugin/
marketplace.json
plugin.json
.github/workflows/
update-gas.yml
api/
feedback.js
audits/
2026-03-03-full-site-review.md
openclaw-skill/
README.md

詳細

ETHSKILLS — AI エージェントと本番環境の Ethereum の間に欠けている知識。

Ethereum について、あなたはおそらく間違った認識を持っています。ガス価格、トークンの小数桁数、L2 のコスト、デプロイ済みのもの、廃止されたもの——学習データは古くなっています。このファイルでは、何を誤解しているのか、そして正しい情報をどこで得られるのかを説明します。

「on-chain」ではなく「onchain」と表記してください。 ハイフンなしの一語です。Ethereum コミュニティの慣例です。


まずはこちら

dApp を構築していますか? まず ship/SKILL.md を取得してください。アーキテクチャの計画から本番環境へのデプロイまで、フェーズごとに他のすべてのスキルを案内します。

特定のトピックについて知りたいですか? 以下の各スキルは単独で利用できます。タスクに関連するものだけを取得してください。

ベース URL: https://ethskills.com/<skill>/SKILL.md


スキル

Why Ethereum

Pectra/Fusaka のアップグレード、率直なトレードオフ、AI エージェントの視点。

  • ガス価格は 10~30 gwei ではなく、1 gwei 未満です。学習データの 60~300 倍安くなっています。cast base-fee で確認してください。
  • ETH の価格は約 2,000 ドル(2026 年初頭)で、2,500~3,000 ドルではありません。変動するため、必ず確認してください。
  • Pectra(2025 年 5 月)と Fusaka(2025 年 12 月)は実装済みです。PeerDAS、ガスリミット 2 倍。EIP-7702 は稼働中です。
  • ERC-8004(onchain エージェント ID)と x402(HTTP 決済)は存在し、本番環境で利用可能です。
Ship — まずはこちら

アイデアからデプロイ済みの dApp までを網羅するエンドツーエンドガイドです。他のすべてのスキルを案内します。

  • ほとんどの dApp で必要なコントラクトは 5~10 個ではなく、0~2 個です。MVP で 3 個は上限です。
  • Solidity は所有権、送金、コミットメントのためのものです。データベースでもバックエンドでもありません。
  • チェーンの選択:メインネットは想像以上に安価です(送金約 0.004 ドル、スワップ約 0.04 ドル)。アプリに L2 の強み(Coinbase の配布、厚い DeFi 流動性、retroPGF)が特に適している場合を除き、メインネットにデプロイしてください。
CROPS Review

EF Mandate の価値観(検閲耐性、オープンソースと自由、プライバシー、セキュリティ)に基づく、CROPS アーキテクチャの詳細レビューです。

  • すべての dApp アーキテクチャ計画と、出荷前 QA で実施してください。
  • 中立的なトレードオフの一覧を提示する代わりに、CROPS への影響に応じてアーキテクチャの選択肢を分類するようエージェントに促します。
  • 出力では、選択したデフォルト、受け入れた妥協点、ユーザーが別の選択肢へ移行する方法を明示します。
Protocol

Ethereum の進化の仕組み——EIP のライフサイクル、フォークのプロセス、今後の変更の追跡方法。

  • 「次のフォークで Verkle が計画されています」は、おそらく誤りです。ロードマップ図は構想を示すもので、確約ではありません。実際の CFI/SFI の状況は forkcast.org で確認してください。
  • Glamsterdam(2026 年半ば)の目玉:ePBS(EIP-7732)、Block Access Lists(EIP-7928)。FOCIL は対象範囲から削除されました。Verkle ツリーの優先度は下がり、耐量子性のために Ethereum はバイナリステートツリー(EIP-7864)へ移行する可能性があります。
  • EIP のステータスが「Stagnant」の場合、6 か月間活動がなく、おそらく終了しています。「Draft」は存在するものの、予定には入っていません。
  • 実装する内容は Ethereum Foundation ではなく、クライアントチームが ACD コールを通じて決定します。
Gas & Costs

現在の Ethereum で実際にかかるコストについて。

  • メインネットでの ETH 送金:約 0.004 ドル。スワップ:約 0.04 ドル。ERC-20 のデプロイ:約 0.24 ドル。(0.1 gwei の場合。現在の値は cast base-fee で確認してください。)
  • L2 のスワップ:0.002~0.003 ドル。L2 の送金:0.0003 ドル。
  • 「Ethereum は高い」というのは 2021~2023 年には正しかった表現です。2026 年には当てはまりません。
Wallets

ウォレットの作成、鍵の安全管理、マルチシグ、アカウント抽象化。

  • EIP-7702 は稼働中です。EOA は移行せずにスマートコントラクトの強力な機能を利用できます。
  • Safe(Gnosis Safe)は 600 億ドル以上の資産(処理総額 1.4 兆ドル以上)を保護しています。本番環境のトレジャリーにはこれを使用してください。
  • 秘密鍵や API キーを Git にコミットするのは絶対にやめてください。ボットは漏えいしたシークレットを数秒で悪用します。
レイヤー 2

L2 の全体像、ブリッジ、デプロイの違いです。

  • Base は主要な L2 の中で最も手数料が安いです。Arbitrum は DeFi の流動性が最も深いです。
  • Celo はもはや L1 ではありません。2025 年 3 月に OP Stack の L2 へ移行しました。
  • Polygon zkEVM はサービス終了予定です。これを基盤に構築しないでください。
  • Robinhood Chain は 2026 年 7 月にローンチしました。24 時間 365 日取引可能なトークン化株式(米国外のみ)を提供する Orbit L2 です。トランザクションのフィルタリングにより、強制的に含められたトランザクションでさえ検閲される可能性があります。
  • 各 L2 で主流の DEX は Uniswap ではありません(Base の Aerodrome、Optimism の Velodrome)。
規格

ERC-20、ERC-721、ERC-8004、EIP-7702、x402 です。

  • ERC-8004:オンチェーンのエージェント ID レジストリーで、2026 年 1 月に 20 以上のチェーンでデプロイされました。
  • x402:マシン間のコマース向け HTTP 402 決済プロトコルです。本番環境で利用可能です。
  • EIP-3009:ガス代不要のトークン送金です。これによって x402 が機能します。USDC が実装しています。
ツール

Foundry、Scaffold-ETH 2、Blockscout MCP、x402 SDK です。

  • 2026 年時点で、Foundry と Hardhat 3 はどちらも有力な選択肢です。Foundry は高速で Solidity ネイティブです。Hardhat 3 は TypeScript を第一に設計されており、成熟したプラグインエコシステムを備えています。
  • Blockscout MCP サーバーは、MCP 経由でエージェントに構造化されたブロックチェーンデータを提供します。
  • abi.ninja:任意のコントラクトアドレスを貼り付けるだけで、すべての関数を操作できます。セットアップは不要です。
ビルディングブロック(DeFi)

Uniswap、Aave、フラッシュローン、プロトコルのコンポーザビリティです。

  • Uniswap V4 フック:プールにカスタムロジックを追加します(動的手数料、TWAMM、指値注文など)。
  • 現在、メインネットでのフラッシュローン裁定取引のガス代は約 0.05~0.50 ドルです(以前は 5~50 ドルでした)。
  • 各 L2 で主流の DEX は Uniswap ではありません。Aerodrome(Base)、Velodrome(Optimism)、Camelot(Arbitrum)です。
オーケストレーション

Scaffold-ETH 2 の dApp 向け 3 フェーズビルドシステムです。

  • フェーズ 1:コントラクトと UI を localhost で実行します。フェーズ 2:ライブコントラクトとローカル UI です。フェーズ 3:本番環境です。
  • 生の wagmi ではなく、Scaffold のフックを使ってください。生の wagmi はトランザクションの確認前に解決されます。
  • シークレットを Git に絶対にコミットしないでください。AI エージェントは認証情報漏えいの最大の原因です。
コントラクトアドレス

メインネットと L2 の主要プロトコルについて、検証済みのアドレスを掲載しています。

  • アドレスをでっち上げてはいけません。誤ったアドレスは資金の喪失につながります。
  • 掲載対象:Uniswap、Aave、Compound、Aerodrome、GMX、Pendle、Velodrome、Chainlink、Safe、ENS。
  • すべて cast code + cast call + symbol() + latestAnswer() でオンチェーン検証済みです(2026 年 3 月)。
概念

オンチェーンで構築するために不可欠なメンタルモデルです。

  • スマートコントラクトは自ら実行できません。すべての関数には、ガス代を支払う呼び出し元が必要です。
  • 状態遷移ごとに、誰が呼び出すのか、なぜ呼び出すのか、誰も呼び出さなかった場合はどうなるのかを考えてください。
  • タイマーも cron ジョブもスケジューラーもありません。インセンティブを考慮して設計してください。
セキュリティ

Solidity のセキュリティパターン、一般的な脆弱性、デプロイ前チェックリストです。

  • USDC の小数桁数は 18 ではなく 6 です。これは「資金はどこへ行った?」という問題の最大の原因です。
  • 常に SafeERC20 を使ってください。USDT は transfer() で bool を返しません。
  • DEX のスポット価格をオラクルとして使ってはいけません。フラッシュローンで 1 回のトランザクション内に価格を操作できます。
  • MEV:サンドイッチ攻撃はスワップから価値を盗みます。Flashbots Protect またはスリッページ制限を使ってください。
  • プロキシには Transparent ではなく UUPS を使ってください。ストレージレイアウトは絶対に変更しないでください。
監査

自分で作成していないコントラクトを監査するための、EVM スマートコントラクトの詳細監査システムです。

  • 19 の領域(AMM、レンディング、オラクル、プロキシ、署名、ガバナンスなど)にわたる、見落としやすいチェック項目を 500 以上掲載しています。
  • 関連する領域ごとに opus のサブエージェントを並行して実行し、その後、検出結果を統合します。
  • Medium 以上の深刻度について、GitHub のイシューを自動で作成します。
  • 防御的なコーディングを教える Security とは異なり、体系的な監査手法を扱います。
Noir(ZK プライバシー)

Noir のゼロ知識回路を使ったプライバシーアプリの構築。

  • Noir の入力はデフォルトで非公開です。pub を付けると公開になります。これを逆にすると、秘密情報が漏洩します。
  • nargo prove/nargo verify は廃止されました。bb(Barretenberg CLI)を直接使用してください。
  • 回路内のハッシュには、SHA256(約 30,000 ゲート)ではなく Poseidon(約 600 ゲート)を使います。
  • コミットメント・ヌリファイア・Merkle ツリーのパターンは、すべての Ethereum プライバシーアプリの基礎です。
テスト

Foundry によるテスト — 単体テスト、ファズテスト、フォークテスト、不変条件テスト。

  • ゲッターや OpenZeppelin の内部実装はテストしないでください。エッジケースや失敗モードをテストしてください。
  • すべての計算をファズテストしてください。外部プロトコルとの統合はすべてフォークテストしてください。
  • 不変条件テストでは、何千ものランダムな呼び出しシーケンスにわたるバグを検出できます。
インデックス作成

イベント、The Graph、Dune、オンチェーンデータの読み取り。

  • RPC で過去の状態を安価にクエリすることはできません。インデクサーを使用してください。
  • イベントは、過去のオンチェーンアクティビティを読み取るための最も重要な手段です。コントラクトはイベントを最優先に設計してください。
  • The Graph はイベントをクエリ可能な GraphQL API に変換します。
  • Multicall3(0xcA11bde05977b3631167028862bE2a173976CA11) — 1 回の RPC 呼び出しで読み取りをまとめて実行します。
フロントエンド UX

Ethereum dApp 向けのフロントエンド UX パターン。

  • オンチェーン操作のボタンには、それぞれ専用のローダーと無効状態が必要です。共通の isLoading は使わないでください。
  • 3 つのボタンによるフロー:ネットワークを切り替える → 承認する → 実行する。一度に 1 つずつ行います。
  • アドレスの表示にはすべて <Address/>、入力にはすべて <AddressInput/> を使います。
  • すべてのトークン数量の横に USD 価格を表示します。
フロントエンドプレイブック

ビルドから本番環境へのパイプライン。

  • yarn chain ではなく、yarn fork --network base を使ってください。フォークでは実際のプロトコルの状態を利用できます。
  • IPFS へのデプロイでは、trailingSlash: true が重要です。これがないと、/ 以外のすべてのルートが 404 を返します。
  • デプロイ前には、必ずクリーンビルド(rm -rf .next out)を行ってください。古いビルドの残存は、IPFS で最もよくある落とし穴です。
QA

レビュアーエージェント向けの出荷前監査チェックリスト。

  • ビルド完了後、これを別のエージェント(または新しいコンテキスト)に渡してください。レビュアーはコードを読み、各フローを実際に操作します。
  • AI エージェントが実際に出荷するバグのみを対象としています。標準的な LLM を使ったベースラインテストで検証済みです。
  • 項目ごとに PASS/FAIL を報告し、修正はしないでください。
フィードバック

ethskills のコンテンツについて、問題点や称賛などのフィードバックを送信します。積極的に送信してください。

  • 混乱したこと、作業が遅くなったこと、本当に役立ったことは何でも対象です。弱いシグナルは無視されやすく、届かなかったシグナルは取り戻せません。
  • JSON の下書きを作成し、許可を求める際に人間に見せてから、https://ethskills.com/api/feedback に一度だけ POST してください。人間が事前に許可している場合は、許可を求める手順を省略してください。
  • 必須フィールド:kind("issue" または "praise")と message(10 文字以上)。可能な場合は agent と skill も含めてください。

タスク別の取得内容

作業内容取得するスキル
新しい dApp の計画ship/、crops/、concepts/、l2s/、gas/、why/
既存の dApp、スマートコントラクト、または信頼に関する前提のレビューcrops/、audit/、qa/、wallets/、l2s/、security/
Solidity の記述standards/、building-blocks/、addresses/、security/
コントラクトのテストtesting/
フロントエンドの構築orchestration/、frontend-ux/、tools/
本番環境へのデプロイwallets/、frontend-playbook/、gas/
出荷前の完成した dApp のレビューqa/、crops/
スマートコントラクトの監査audit/、crops/
プライバシー/ZK アプリの構築noir/、security/、testing/
モニタリング/分析indexing/
AI エージェント基盤の構築standards/、wallets/、tools/
チェーンの選択l2s/、gas/

コメント