Skip to content

[b-3] EL 01e で全クライアントを SPECA 監査する #149

Closed

Description

@grandchildrice

📖 前提知識(共通)

SPECA は「仕様書 → 形式的なセキュリティプロパティ → 実装コードの監査」を自動化するパイプライン。フェーズは 01a(仕様収集) → 01b(サブグラフ抽出) → 01e(プロパティ生成) → 02c(コード位置解決) → 03(証明ベース監査) → 04(誤検知フィルタ)。エントリポイントは scripts/run_phase.py。

M2 の全体像(#86)= 3トラック × 4フェーズ。トラックは「どの Lean を起点に 01e を作るか」で分ける:

  • a = gasper(コンセンサス層仕様。Lean 形式化は完了済み)
  • b = EL spec(Execution Layer 仕様起点)
  • c = vuln-dataset(NyxFoundation/ethereum-vuln-dataset の critical/high 実バグ起点)

各トラック共通のフェーズ: ①Lean形式化 → ②01e作成 → ③全クライアント監査 → ④Kurtosis再現 → 統合レポート(2-C)。

関係リポジトリ:

repo 役割 言語/実行
NyxFoundation/speca パイプライン本体 Python 3.11 / uv。worker は Claude Code CLI
NyxFoundation/speca-lean4-plugin Lean 形式化 + 01e emit(Lean の実行場所) Lean 4 / lake + Python driver
NyxFoundation/ethereum-vuln-dataset 11クライアントの過去実バグ集(STRIDE/CWEラベル付き) CSV
NyxFoundation/kurtosis-harness findings の devnet 再現 Kurtosis

セットアップ(NyxFoundation/speca): uv sync / npm i -g @anthropic-ai/claude-code / bash scripts/setup_mcp.sh。詳細は CLAUDE.md。


🎯 Goal

b-2(#145)で凍結した EL 01e を入力に、02c → 03 → 04 を 全クライアントで走らせ、per-client の findings を得る。

手順は a-3(#148)と同型。a-3 で確立した流れを踏襲する。

📍 このタスクの位置づけ

トラック b / フェーズ③。01e(何を検査すべきか)が固まった後、実際に各クライアントの実装コードを監査する工程。Lean 非依存——01e がどこから来たかに関係なく naive な speca をそのまま流す。

🛠 作業場所

  • リポジトリ: NyxFoundation/speca
  • 実行: uv run python3 scripts/run_phase.py --target 04 --workers 4(02c→03→04 を解決)。クライアントごとに実行。詳細は scripts/run_phase.py / CLAUDE.md
  • 必要な設定ファイル: outputs/BUG_BOUNTY_SCOPE.json(信頼モデル・severity 基準)、outputs/TARGET_INFO.json(対象 repo + commit pin + 言語)
  • 実行環境: 全クライアント監査は計算量が大きい。実行主体(gohan マシン等)をこの issue で確定すること

📋 手順

  1. クライアント行列を確定(Fusaka 参照セット: go-ethereum, Nethermind, Prysm, Lighthouse, Lodestar, Nimbus, Grandine, Reth 他)。各 commit を pin。
  2. 各クライアントの BUG_BOUNTY_SCOPE.json / TARGET_INFO.json を用意(信頼レベルは各クライアントの実際の入力面に合わせる。コピペで済ませない)。
  3. scripts/run_phase.py で 02c→03→04 をクライアントごとに実行(resume で失敗時の再課金を避ける)。
  4. per-client の 04_PARTIAL_*.json を収集し verdict をトリアージ(CONFIRMED_VULNERABILITY / CONFIRMED_POTENTIAL / DISPUTED_FP / DOWNGRADED / NEEDS_MANUAL_REVIEW)。
  5. 各 finding に spec_reference が付いているか確認。run manifest(commit / 01e version / cost / counts)を記録。

📦 成果物

  • 何を: per-client の confirmed/disputed findings + トリアージ表 + run manifest
  • どこに: NyxFoundation/speca の outputs/04_PARTIAL_*.json(クライアントごと)+ manifest
  • 形式: 04 スキーマ準拠の findings JSON

✅ 完了条件

⚙️ 制約

🔗 参考

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Labels

M2Milestone 2 grant workpipelineFull pipeline runstrack:2-CDeliverable 2-C: cumulative bug & fix report

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions