レッスン9 — ソース読解コースの読み方

問い

Bridge to Advanced 完走 = 中級 3 コース（Inside Revm / Inside Reth / Inside Alloy）への準備完了。中級コースをどう読むか — 編集スタイル / クイズゲート / 積み上げ→ウォークスルー→クイズ→ドリル のチェーン構造 + ペース配分。

原理（最小モデル）

• 3 中級コース. Inside Revm（EVM 実行エンジン）/ Inside Reth（Staged Sync + ExEx + SDK）/ Inside Alloy（Provider + Network + Signer）= 順序自由、依存的には Alloy → Revm → Reth 推奨。
• チェーン構造. 各トピック = buildup（素朴版 → 本物へ積み上げ）→ walkthrough（実ソース 1 行ずつ）→ クイズ（進行ゲート）→ ドリル（手を動かす証明）。
• Predict プロンプト + クイズゲート. 「ここで止まって予測せよ」が至る所、クイズで 2 問以上落としたら前レッスンに戻る = 「読んだ気」を防ぐ強制。
• ペース配分. レッスンあたり 30-40 分、1 日 1-2 レッスンが現実的、ドリルは別 30-60 分、週末 capstone は半日。
• セットアップ必須. git clone bluealloy/revm / git clone paradigmxyz/reth / cargo-expand インストール / セカンドモニタ or 分割端末、これなしでドリルできない。
• コードを読むメンタルモデル. トレイトヘッダーから読む → 主要 struct → 関数本体、grep / rg で関連箇所、cargo doc --open で API ドキュメント。
• 詰まったときの対処. 不明箇所はマークして先進む、後で戻る、Discord / GitHub で質問、答えを見る前に 30 分自力で。
• 完走後. Advanced / Expert で本番 production 視点、Foundry で Solidity 側、openhl DIY Perp で 1 つの本物を作る、選択肢が広がる。

具体例 + ステップで組み立てる

ソース読解コースの読み方

あなたは Intermediate ティア の入口にいる。3 つの独立コース（Inside Revm・Inside Reth・Inside Alloy）はいずれも同じスキル、つまり 本番 Rust ソースを 1 行ずつ読む力 を扱う。この短いレッスンは構成と学習姿勢をそろえるための共通ガイドである。

(各コースにも、固有の前提とセットアップを扱う短いウェルカムがある。このレッスン は 1 度読めば済む 汎用的な オリエンテーション。)

ティアシフト

Beginner ティア (Beginner / Fundamentals / 中級への橋渡し) は、スタックの 形 を教えました — Alloy 型はどんなものか、Foundry の使い方、EVM が高レベルで何をしているか。

Intermediate ティアが要求するのは別の能力である。Reth・Revm・Alloy・Foundry の本番ソースを 1 行ずつ読む。 レッスンはスタック利用経験を前提に、読める状態 へ引き上げる。

前レッスンで技術的前提（add Opcode シグネチャ読解）を確認した。残るのは、レッスン自体の書き方と、ここで要求する学習リズムである。

レッスンの書き方 — そしてその理由

ソース読解レッスンは、これまでのティアにはない 能動学習プロンプト を使います：

• 🛑 Predict (予測) — 止まる。解説を読む前に、これに頭の中で答えてください。 ポイントは質問に取り組むこと。間違っていてもいい。間違った予測こそが学習の起点。
• 🔍 Find in repo (リポジトリで確認) — 実際のソースファイルを開いて、レッスンの主張を検証する。レッスンはガイダンス、ソースが真実。
• 理解度チェック (Anti-fluency) — 自分の言葉で、なぜ効くか。 答えられないなら戻る。スキップしない。
• 末尾の想起テスト — 多くのレッスンは「自分の言葉で答えられるまで終わらない」という設計で終わる。文字通り受け取る。
• クイズゲート — 主要トピックは 4 問クイズで終わり、進行をゲートする。うなずきでは通せない 設計であり、2 問落としたら積み上げに戻る。

編集スタイルは従来チュートリアルより難しい。意図的である。滑らかな散文は「わかった気になる」罠を生みやすい。 Predict / Recall / Quiz は実エンゲージメントを強制するための設計である。

これは 設計上の摩擦。受け入れて。

レッスンの実際の読み方

各主要ソース読解トピック（add・カスタム Opcode・Database トレイト・Staged Sync・ExEx・Reth SDK・Provider トレイト）はそれぞれ 3〜4 本のアトミックなレッスンの「チェーン」 に分割されています：

1. 積み上げレッスン (Build-up) — まず最も素朴に書ける版から始め、複雑さを 1 つずつ意味付きで獲得していく。終わりには本物の本番ソースの全行を、動機付きで自分で組み立てたことになる。各ステップで Predict プロンプト。
2. ウォークスルー / パイプライン / 仲間トレイトのレッスン（チェーンによって 1 本ある）— 周辺の本番コードを詳しく読む。Predict と Find-in-repo プロンプト付き。
3. クイズ — 4〜5 問の選択式で進行をゲート。通れば次へ、落とし過ぎたら戻る。
4. ドリル — 本物のチェックアウトでの実践（cargo build、ソース改変、挙動観察）。1 日経ってもレッスンが残るのは、この読みではなく「やる」段階のおかげ。

各レッスン内のリズム：

1. 解説の前に 🛑 Predict プロンプトが出てきたら、止まる。頭の中か紙で答える。それから続ける。
2. 解説を読む。予測と比較。間違っていた箇所が学びの場所。
3. 🔍 Find-in-repo プロンプトが出てきたら、リポジトリを開く。実際のファイルを見つける。レッスンの主張を検証。
4. 末尾の想起テスト。自分の言葉で答えられたらタブを閉じる。答えられないならスクロールバック。

これは典型的チュートリアルより遅い。ただし定着する。 意図的なトレードオフである。

ペース

各アトミックレッスンは表示上 8〜12 分、プロンプトに本気で取り組むと 15〜25 分。1 つのトピックチェーン全体（積み上げ → ウォークスルー → クイズ → ドリル、3〜4 本）は おおよそ 45〜80 分 — 1 晩がかりの仕事。Advanced ティア（Intermediate の先の L1 Architect 系） のチェーンはさらに長い — 1 セッションに 1.5〜3 時間が普通。実際の L1 アーキテクトの仕事が要求する長さだから。

正しい単位はセッションあたり 1 チェーン である。チェーン（例: Inside Revm の add 4 本）を始めたら、その日で終える計画を立てる。積み上げ・ウォークスルー・クイズが相互強化し、ドリルで「読み」が「記憶」に変わる。跨日で分割するとモデルが壊れやすい。

時間がないなら: 2 本を流すよりも 1 本を丁寧に。このティアではエンゲージメントが網羅性より重要。

さあ、コースを選ぶ

3 つのソース読解コースは独立していて任意の順序で進められます — ただし Inside Revm を最初に推奨、その型（Address、U256、Database トレイト）が Reth と Alloy の前提になるから:

• Inside Revm — EVM エンジンの内部
• Inside Reth — Reth の内部: Staged Sync・ExEx・Reth SDK
• Inside Alloy — Alloy の内部: Provider・Network・Signer

各コースには、固有の前提とセットアップを扱う短いウェルカムがある。それを読んでレッスン 1 を始める。

Intermediate の先 — Advanced ティア (L1 Architect)

Intermediate のソース読解を完走すると、次は Advanced ティア（5 コース、難易度 ADVANCED、track reth-l1-architect）である。Intermediate が本番ソースを 読む 力を育てるのに対し、Advanced は自分で レッスン1を 設計する 実装力を扱う。

• Consensus Engineering — PoS / BFT / Tendermint の内部、レイテンシ・ライブネス・finality の設計トレードオフ
• Cross-Chain Bridges — CCIP・OP Standard Bridge・light client を本番ソースで読み、自分で書く
• Sequencer & Rollup アーキテクチャ — 中央集権 sequencer から共有 sequencer まで、MEV 防衛と forced inclusion
• P2P ネットワーキング内部 — devp2p・libp2p・gossip サブプロトコル・ピアスコアリングの実装読解
• Validator 運用 — 鍵管理、slashing 条件、協調アップグレード

各チェーンは Intermediate のソース読解チェーンの 1.5〜3 倍の長さ。今は気にしないこと — まずソース読解のチェーンを 1 つ完走するのが先。Advanced (L1 Architect) は遠い目的地としてだけ意識しておけば十分。

準備完了。

まとめ（3行）

• 3 中級コース（Revm / Reth / Alloy）= buildup → walkthrough → クイズ → ドリル の 4 連、Predict プロンプト + クイズゲートで「読んだ気」防止。
• セットアップ必須（revm / reth clone + cargo-expand + 2 モニタ）、ペース配分は 1 日 1-2 レッスン + ドリル別、週末 capstone は半日。
• Bridge to Advanced 完走、3 中級コースへの準備完了、選択肢広がる（Advanced / Expert / Foundry / openhl DIY Perp）、Rust + Ethereum + systems キャリアの出発点。