Skip to content

Latest commit

 

History

History

op-validator

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
cmd
cmd
 
 
pkg
pkg
 
 
.gitignore
.gitignore
 
 
README.md
README.md
 
 
justfile
justfile
 
 

README.md

op-validator

The op-validator is a tool for validating Optimism chain configurations and deployments. It works by calling into the StandardValidator smart contracts (StandardValidatorV180 and StandardValidatorV200). 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

Usage

The validator supports different protocol versions through subcommands:

op-validator validate [version] [flags]

Where version is one of:

  • v1.8.0 - For validating protocol version 1.8.0
  • v2.0.0 - For validating protocol version 2.0.0

Required Flags

  • --l1-rpc-url: L1 RPC URL (can also be set via L1_RPC_URL environment variable)
  • --absolute-prestate: Absolute prestate as hex string
  • --proxy-admin: Proxy 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.
  • --system-config: System config proxy address as hex string
  • --l2-chain-id: L2 chain ID

Optional Flags

  • --fail: Exit with non-zero code if validation errors are found (defaults to true)

Example

op-validator validate v2.0.0 \
  --l1-rpc-url "https://mainnet.infura.io/v3/YOUR-PROJECT-ID" \
  --absolute-prestate "0x1234..." \
  --proxy-admin "0xabcd..." \
  --system-config "0xefgh..." \
  --l2-chain-id "10" \
  --fail