dispute-game-investigator

Diagnose OP Stack fault dispute games and challenger behavior during incidents.

6.5k|4.0k|Updated Feb 6, 2020
One-click install
npx skills add https://github.com/ethereum-optimism/optimism --skill dispute-game-investigator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dispute-game-investigator
Source: https://github.com/ethereum-optimism/optimism/tree/main/.claude/skills/dispute-game-investigator
Command: npx skills add https://github.com/ethereum-optimism/optimism --skill dispute-game-investigator

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

When an OP Stack fault dispute game misbehaves — a challenger disagreeing with proposals, making excessive moves, or contradicting itself — operators need a structured, read-only way to determine which op-node is at fault, whether proposals are valid, and who ultimately wins the bonds.

Core Features & Use Cases

  • Incident Triage: Identify which games and claims are involved, whose node is responsible, and whether in-progress proposals are valid.
  • Root Cause Diagnosis: Cross-check output roots, super roots, and block hashes against canonical reference nodes to pinpoint a faulty op-node or incomplete safe-head database.
  • Post-Incident Analysis: Determine bond outcomes after a game resolves.
  • Use Case: During a live incident where a challenger keeps countering a proposal, use the skill to enumerate games with op-challenger list-games, verify the canonical output root with check-output-root, and explain which node diverged — all without making any on-chain moves.

Quick Start

Ask the assistant to investigate why the challenger is disagreeing with the current dispute game proposal and which op-node is at fault.

Frequently Asked Questions about dispute-game-investigator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I investigate an OP Stack fault dispute game?

Start by enumerating games and claims with op-challenger list-games and list-claims in JSON format, then triage which game and whose node is involved. Pull only the relevant guide sections for the specific question rather than running every step.

How to check if a dispute game proposal is valid?

Verify the canonical output root using the check-output-root or check-super-root tools, which work against public nodes via EL-only queries. Compare the result with the game's claimed output to determine validity.

Why is my op-challenger making many moves or contradicting itself?

This often indicates a faulty op-node or an incomplete safe-head database. Use op-challenger game-proposal-outputs to inspect outputAtBlock and safeHeadAtL1Block, and cross-check block hashes against a reference node with the check-game-block-hashes script.

Can this skill make moves or resolve a dispute game?

No, the skill is strictly read-only. It investigates and explains dispute game behavior but never makes moves, resolves games, funds challengers, or restarts challenger processes.

How do I find out who wins the bonds after a dispute game?

Bond outcome analysis is covered in section 7 of the investigation guide and is typically a post-incident question rather than live triage. For a full end-to-end written analysis, use the dispute-game-investigator agent instead.