Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.optimism.io/llms.txt

Use this file to discover all available pages before exploring further.

The op-validator is a tool for validating Standard OP Stack chain configurations and deployments to ensure they’re in compliance with the Standard Rollup Charter. It works by calling into the StandardValidator smart contracts. These then perform a set of checks, and return error codes for any issues found. These checks include:
  • Contract implementations and versions
  • Proxy configurations
  • System parameters
  • Cross-component relationships
  • Security settings

​
How to use op-validator

1

Clone the monorepo

  git clone https://github.com/ethereum-optimism/optimism.git
2

Build the `op-validator` binary

  cd optimism/op-validator
  just build
3

Run the `op-validator` binary

  ./bin/op-validator validate v1.8.0 \
    --l1-rpc-url "https://ethereum-sepolia-rpc.publicnode.com" \
    --absolute-prestate "0x03f89406817db1ed7fd8b31e13300444652cdb0b9c509a674de43483b2f83568" \
    --proxy-admin "0x189aBAAaa82DfC015A588A7dbaD6F13b1D3485Bc" \
    --system-config "0x034edD2A225f7f429A63E0f1D2084B9E0A93b538" \
    --l2-chain-id "11155420" \
    --fail
4

Understanding the output

In the previous command, we provided a non-standard absolute prestate. The op-validator returned the following output to describe the discrepancies between the provided absolute prestate and the expected prestate in the L1 smart contracts:
|      ERROR      |          DESCRIPTION           |
|-----------------|--------------------------------|
| PDDG-40         | Permissioned dispute game      |
|                 | absolute prestate mismatch     |
| PDDG-ANCHORP-40 | Permissioned dispute game      |
|                 | anchor state registry root     |
|                 | hash mismatch                  |
| PLDG-40         | Permissionless dispute game    |
|                 | absolute prestate mismatch     |
| PLDG-ANCHORP-40 | Permissionless dispute game    |
|                 | anchor state registry root     |
|                 | hash mismatch                  |

Validation errors found

​
Usage

The validator supports different protocol versions through subcommands: 
op-validator validate [version] [flags]
Choose a version based on your op-contracts version:
  • v1.8.0 - For validating op-contracts/1.8.0
  • v2.0.0 - For validating op-contracts/2.0.0

​
Flags

OptionDescriptionRequired/Optional
--l1-rpc-urlL1 RPC URL (can also be set via L1_RPC_URL environment variable)Required
--absolute-prestateAbsolute prestate as hex stringRequired
--proxy-adminProxy admin address as hex string. This should be a specific chain’s proxy admin contract on L1. It is not the proxy admin owner or the superchain proxy admin.Required
--system-configSystem config proxy address as hex stringRequired
--l2-chain-idL2 chain IDRequired
--failExit with non-zero code if validation errors are found (defaults to true)Optional

​
Example

op-validator validate v2.0.0 \
  --l1-rpc-url "L1_RPC_URL" \
  --absolute-prestate "0x1234..." \
  --proxy-admin "0xabcd..." \