Ethereum Wingman

Scaffold-ETH 2 プロジェクト向けの包括的な Ethereum 開発ガイド。スマートコントラクト開発、DeFi プロトコル、セキュリティベストプラクティス、SpeedRun Ethereum カリキュラムをカバー。

---

AI エージェント用指示 - まず読んでください

デフォルトスタック: Fork モード付き Scaffold-ETH 2

ユーザーが Ethereum プロジェクトを構築したいときは、以下の手順に従ってください：

ステップ 1: プロジェクトを作成

npx create-eth@latest
# 選択: foundry (推奨), ターゲットチェーン, プロジェクト名

ステップ 2: ポーリング間隔を修正

packages/nextjs/scaffold.config.ts を編集して：

pollingInterval: 30000,  // デフォルト: 30 秒（遅すぎます！）

を以下に変更：

pollingInterval: 3000,   // 3 秒（開発に適切）

ステップ 3: インストール & ライブネットワークをフォーク

cd <project-name>
yarn install
yarn fork --network base  # または mainnet, arbitrum, optimism, polygon

ステップ 4: 自動ブロックマイニングを有効化（必須！）

# 新しいターミナルで区間マイニングを有効化（1 秒/ブロック）
cast rpc anvil_setIntervalMining 1

これなしでは、block.timestamp が凍結したままになり、時間依存ロジックが破壊されます！

オプション: 永続化 - packages/foundry/package.json を編集して fork スクリプトに --block-time 1 を追加。

ステップ 5: ローカルフォークにデプロイ（無料！）

yarn deploy

ステップ 6: フロントエンドを起動

yarn start

ステップ 7: フロントエンドをテスト

フロントエンドが実行中になったら、ブラウザを開いてアプリをテスト：

1. 移動 - http://localhost:3000 へ
2. スナップショット取得 - ページ要素を取得（バーナーウォレットアドレスはヘッダーに表示）
3. フォーセットをクリック - バーナーウォレットに ETH を供給
4. トークン転送 - 必要に応じてクジラからトークンを転送（ページのバーナーアドレスを使用）
5. アプリをクリック - 機能を検証

ブラウザ自動化には cursor-browser-extension MCP ツールを使用。 詳細なワークフローは tools/testing/frontend-testing.md を参照。

禁止事項：

• yarn chain を実行しない（代わりに yarn fork --network <chain> を使用！）
• 手動で forge init を実行したり、Foundry をスクラッチから設定しない
• 手動で Next.js プロジェクトを作成しない
• ウォレット接続を手動で設定しない（SE2 に RainbowKit が事前設定済み）

Fork モードを使う理由？

yarn chain（間違い）           yarn fork --network base（正解）
└─ 空のローカルチェーン       └─ 実際の Base メインネットのフォーク
└─ プロトコルなし             └─ Uniswap, Aave など利用可能
└─ トークンなし               └─ 実際の USDC, WETH が存在
└─ 隔離環境でテスト           └─ 実際の状態でテスト

アドレスデータが利用可能

トークン、プロトコル、クジラアドレスは data/addresses/ にあります：

• tokens.json - チェーンごとの WETH, USDC, DAI など
• protocols.json - チェーンごとの Uniswap, Aave, Chainlink
• whales.json - テスト資金用の大型トークン保有者

---

最も重要な概念

Ethereum では何も自動ではありません。

スマートコントラクトは自分で実行できません。クーロンジョブ、スケジューラ、バックグラウンドプロセスはありません。「発生する必要がある」すべての関数について：

1. 誰でも呼び出せるようにする（管理者のみではなく）
2. 呼び出し者に理由を与える（利益、報酬、自分の利益）
3. インセンティブを十分にしてガス代と利益をカバーする

常に問う：「誰がこの関数を呼び出すのか？なぜガス代を払うのか？」

これに答えられなければ、関数は呼ばれません。

適切なインセンティブ設計の例

// 清算：呼び出し者がボーナス担保を取得
function liquidate(address user) external {
    require(getHealthFactor(user) < 1e18, "Healthy");
    uint256 bonus = collateral * 5 / 100; // 5% ボーナス
    collateralToken.transfer(msg.sender, collateral + bonus);
}

// 利回り収穫：呼び出し者が収穫の % を取得
function harvest() external {
    uint256 yield = protocol.claimRewards();
    uint256 callerReward = yield / 100; // 1%
    token.transfer(msg.sender, callerReward);
}

// クレーム：ユーザーが自分のトークンを取得
function claimRewards() external {
    uint256 reward = pendingRewards[msg.sender];
    pendingRewards[msg.sender] = 0;
    token.transfer(msg.sender, reward);
}

---

重大な落とし穴（これを覚えてください）

1. トークン小数点が異なる

USDC = 18 ではなく 6 小数点！

// 悪い例：18 小数点と仮定 - 1 兆 USDC を転送！
uint256 oneToken = 1e18;

// 良い例：小数点をチェック
uint256 oneToken = 10 ** token.decimals();

一般的な小数点：

• USDC, USDT：6 小数点
• WBTC：8 小数点
• ほとんどのトークン（DAI, WETH）：18 小数点

2. ERC-20 承認パターンが必須

コントラクトはトークンを直接引き出せません。2 ステッププロセス：

// ステップ 1：ユーザーが承認
token.approve(spenderContract, amount);

// ステップ 2：コントラクトがトークンを引き出す
token.transferFrom(user, address(this), amount);

無限承認を使わないこと：

// 危険
token.approve(spender, type(uint256).max);

// 安全
token.approve(spender, exactAmount);

3. Solidity に浮動小数点はない

ベーシスポイントを使用（1 bp = 0.01%）：

// 悪い例：これは 0 です
uint256 fivePercent = 5 / 100;

// 良い例：ベーシスポイント
uint256 FEE_BPS = 500; // 5% = 500 ベーシスポイント
uint256 fee = (amount * FEE_BPS) / 10000;

4. リエントランシー攻撃

外部呼び出しはコントラクトにコールバックできます：

// 安全：Checks-Effects-Interactions パターン
function withdraw() external nonReentrant {
    uint256 bal = balances[msg.sender];
    balances[msg.sender] = 0; // インタラクション前にエフェクト
    (bool success,) = msg.sender.call{value: bal}("");
    require(success);
}

常に OpenZeppelin の ReentrancyGuard を使用。

5. DEX スポット価格をオラクルとして使わない

フラッシュローンはスポット価格を即座に操作できます：

// 安全：Chainlink を使用
function getPrice() internal view returns (uint256) {
    (, int256 price,, uint256 updatedAt,) = priceFeed.latestRoundData();
    require(block.timestamp - updatedAt < 3600, "Stale");
    require(price > 0, "Invalid");
    return uint256(price);
}

6. ボルト膨張攻撃

最初のデポジター者はシェア操作で資金を盗める：

// 緩和策：仮想オフセット
function convertToShares(uint256 assets) public view returns (uint256) {
    return assets.mulDiv(totalSupply() + 1e3, totalAssets() + 1);
}

7. SafeERC20 を使用

一部のトークン（USDT）は転送で bool を返さない：

import "@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol";
using SafeERC20 for IERC20;

token.safeTransfer(to, amount); // 非標準トークンに対応

---

Scaffold-ETH 2 開発

プロジェクト構造

packages/
├── foundry/              # スマートコントラクト
│   ├── contracts/        # Solidity ファイル
│   └── script/           # デプロイスクリプト
└── nextjs/
    ├── app/              # React ページ
    └── contracts/        # 生成 ABI + externalContracts.ts

必須フック

// コントラクトデータを読取
const { data } = useScaffoldReadContract({
  contractName: "YourContract",
  functionName: "greeting",
});

// コントラクトに書き込み
const { writeContractAsync } = useScaffoldWriteContract("YourContract");

// イベントを監視
useScaffoldEventHistory({
  contractName: "YourContract",
  eventName: "Transfer",
  fromBlock: 0n,
});

---

SpeedRun Ethereum チャレンジ

実践学習にはこれらを参照：

チャレンジ	コンセプト	主要レッスン
0: シンプル NFT	ERC-721	ミント、メタデータ、tokenURI
1: ステーキング	コーディネーション	デッドライン、エスクロー、閾値
2: トークンベンダー	ERC-20	承認パターン、買い/売り
3: サイコロゲーム	ランダムネス	オンチェーン乱数は不安全
4: DEX	AMM	x*y=k 公式、スリッページ
5: オラクル	価格フィード	Chainlink、操作耐性
6: レンディング	担保	ヘルスファクター、清算インセンティブ
7: ステーブルコイン	ペッグ	CDP、過剰担保化
8: 予測市場	解決	結果決定
9: ZK投票	プライバシー	ゼロ知識証明
10: マルチシグ	署名	閾値承認
11: SVG NFT	オンチェーンアート	ジェネレーティブ、base64 エンコーディング

---

DeFi プロトコルパターン

Uniswap（AMM）

• 定積公式：x * y = k
• スリッページ保護が必須
• LP トークンはプール シェアを表す

Aave（レンディング）

• 担保を供給し、資産を借用
• ヘルスファクター = 担保価値 / 債務価値
• ヘルスファクター < 1 の場合に清算

ERC-4626（トークン化ボルト）

• 利回りボルト向けの標準インターフェース
• シェア会計で deposit/withdraw
• インフレーション攻撃から保護

---

セキュリティレビューチェックリスト

デプロイ前に確認：

• すべての管理者関数でアクセス制御
• リエントランシー保護（CEI + nonReentrant）
• トークン小数点の処理が正確
• オラクル操作に耐性あり
• 整数オーバーフロー対応（0.8 以上または SafeMath）
• 戻り値チェック（SafeERC20）
• 入力検証あり
• 状態変化でイベント発行
• メンテナンス関数のインセンティブ設計

---

レスポンスガイドライン

開発者を支援する際：

1. Fork ワークフローに従う - 常に yarn fork を使用、yarn chain は禁止
2. 直接答える - まず質問に対応
3. コードを表示 - 動作する例を提供
4. 落とし穴を警告 - 関連する落とし穴を主動的に言及
5. チャレンジを参照 - 練習用に SpeedRun Ethereum を指摘
6. インセンティブについて質問 - 「自動」関数について、誰が呼び出すのか、なぜかを質問