Repository navigation
Closed
Labels
M2Milestone 2 grant workMilestone 2 grant workpipelineFull pipeline runsFull pipeline runstrack:2-CDeliverable 2-C: cumulative bug & fix reportDeliverable 2-C: cumulative bug & fix report
Description
📖 前提知識(共通)
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 で確定すること
📋 手順
- クライアント行列を確定(Fusaka 参照セット: go-ethereum, Nethermind, Prysm, Lighthouse, Lodestar, Nimbus, Grandine, Reth 他)。各 commit を pin。
- 各クライアントの
BUG_BOUNTY_SCOPE.json/TARGET_INFO.jsonを用意(信頼レベルは各クライアントの実際の入力面に合わせる。コピペで済ませない)。 scripts/run_phase.pyで02c→03→04をクライアントごとに実行(resume で失敗時の再課金を避ける)。- per-client の
04_PARTIAL_*.jsonを収集し verdict をトリアージ(CONFIRMED_VULNERABILITY / CONFIRMED_POTENTIAL / DISPUTED_FP / DOWNGRADED / NEEDS_MANUAL_REVIEW)。 - 各 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
✅ 完了条件
- 行列の全クライアントで 04 完了、per-client findings JSON
- verdict トリアージ済み(NEEDS_MANUAL_REVIEW は落とさずフラグ)
- 各 finding に
spec_reference、run manifest あり - b-4([b-4] EL findings を kurtosis-harness で再現する #152)へ引き渡し
⚙️ 制約
- 締切: 2026-08-22
- 依存: b-2([b-2] EL Lean に対する 01e チェックリストを作成する #145)の 01e 凍結
- スコープ外: devnet 再現(b-4 [b-4] EL findings を kurtosis-harness で再現する #152)、レポート
🔗 参考
- パイプライン:
CLAUDE.md/ オーケストレータ:scripts/orchestrator// 04 の verdict 定義
Metadata
Metadata
Assignees
Labels
M2Milestone 2 grant workMilestone 2 grant workpipelineFull pipeline runsFull pipeline runstrack:2-CDeliverable 2-C: cumulative bug & fix reportDeliverable 2-C: cumulative bug & fix report
Activity