This repository was archived by the owner on Apr 6, 2026. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 336
Refactor RPC page to create Superchain RPC directory #1590
Merged
Merged
Changes from 8 commits
Commits
Show all changes
18 commits
Select commit
Hold shift + click to select a range
bcd2a28
add validation of deployment docs
krofax 65f3147
fix lint issues
krofax 7fabe7d
update categories
krofax 5ed2471
update headers
krofax 0d67154
updated docs
krofax 4913f98
updated rpc docs
krofax 0fb6d50
updated the guides
krofax 99d24e4
updated the tables
krofax 5bc3cb0
Delete pages/operators/chain-operators/deploy/validate-deployment.mdx
krofax 4a907dc
Delete pages/operators/chain-operators/deploy/_meta.json
krofax e3352f8
Delete pages/operators/chain-operators/deploy.mdx
krofax 9c9b042
updated network url
krofax c59aefe
updated network url
krofax 2696649
fix lint issues
krofax 8a066b5
updated link
krofax 40472e7
updated branch
krofax f504c39
updated pages
krofax 2864716
updated page
krofax File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,4 +1,4 @@ | ||
| { | ||
| "networks": "Networks and RPC endpoints", | ||
| "rpc-providers": "RPC and Node providers" | ||
| "rpc-providers": "Superchain RPC directory" | ||
| } |
Large diffs are not rendered by default.
Oops, something went wrong.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,6 +1,7 @@ | ||
| { | ||
| "overview": "Overview", | ||
| "smart-contracts": "Contract deployment", | ||
| "genesis": "Genesis creation" | ||
| "genesis": "Genesis creation", | ||
| "validate-deployment": "Validate contract deployment" | ||
| } | ||
|
|
128 changes: 128 additions & 0 deletions
128
pages/operators/chain-operators/deploy/validate-deployment.mdx
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,128 @@ | ||
| --- | ||
| title: Validating your OP Stack deployment | ||
| lang: en-US | ||
| description: Learn how to validate your OP Stack deployment using op-validator | ||
| content_type: guide | ||
| topic: deployment-validation | ||
| personas: | ||
| - chain-operator | ||
| categories: | ||
| - standardization | ||
| - validation | ||
| - op-validator | ||
| - chain-deployment | ||
| - rollup-configuration | ||
| - genesis-configuration | ||
| - deployment-configuration | ||
| is_imported_content: 'false' | ||
| --- | ||
|
|
||
| import { Callout, Steps } from 'nextra/components' | ||
|
|
||
| # Overview | ||
|
|
||
| After deploying the L1 smart contracts for your OP Stack chain, it's crucial to verify that your deployment conforms to the standard configuration. | ||
| This guide walks you through using `op-validator` to validate your deployment against the Superchain standard. | ||
|
|
||
| ## Why validate your deployment? | ||
|
|
||
| Validating your deployment ensures: | ||
|
|
||
| 1. **Standardization** - Your chain adheres to the Superchain standards | ||
| 2. **Interoperability** - Your chain will properly interact with other Superchain components | ||
| 3. **Security** - Your deployment follows best practices and security guidelines | ||
| 4. **Upgradeability** - Your chain can receive future protocol upgrades | ||
|
|
||
| ## Prerequisites | ||
|
|
||
| * Completed deployment of L1 smart contracts using [op-deployer](/operators/chain-operators/deploy/smart-contracts). | ||
| * Generated [genesis and rollup](/operators/chain-operators/deploy/genesis) files. | ||
| * [op-validator](/operators/chain-operators/tools/op-validator) installed. | ||
|
|
||
| ## Validation process | ||
|
|
||
| <Steps> | ||
| ### Install op-validator | ||
|
|
||
| If you haven't already installed op-validator, follow the [installation instructions](/operators/chain-operators/tools/op-validator#installation). | ||
|
|
||
| ### Gather required information | ||
|
|
||
| You'll need the following information to validate your deployment: | ||
|
|
||
| * **L1 RPC URL:** A reliable RPC endpoint for your L1 network | ||
| * **Absolute prestate:** The absolute prestate hash of your deployment | ||
| * **Proxy admin address:** Your chain's proxy admin contract address (not the proxy admin owner) | ||
| * **System config address:** Your chain's SystemConfig contract address | ||
| * **L2 chain ID:** The chain ID of your L2 network | ||
|
|
||
| With op-deployer, you can retrieve some of this information with: | ||
|
|
||
| ```bash | ||
| # Get deployment information | ||
| op-deployer inspect l1 --workdir .deployer <l2-chain-id> | ||
|
|
||
| # For the absolute prestate | ||
| op-deployer inspect prestates --workdir .deployer <l2-chain-id> | ||
| ``` | ||
|
|
||
| ### Run validation for your contract version | ||
|
|
||
| Run the op-validator with the appropriate version parameter matching your deployed contracts: | ||
|
|
||
| **For op-contracts v1.8.0:** | ||
|
|
||
| ```bash | ||
| ./bin/op-validator validate v1.8.0 \ | ||
| --l1-rpc-url "<YOUR_L1_RPC_URL>" \ | ||
| --absolute-prestate "<YOUR_ABSOLUTE_PRESTATE>" \ | ||
| --proxy-admin "<YOUR_PROXY_ADMIN_ADDRESS>" \ | ||
| --system-config "<YOUR_SYSTEM_CONFIG_ADDRESS>" \ | ||
| --l2-chain-id "<YOUR_L2_CHAIN_ID>" \ | ||
| --fail | ||
| ``` | ||
|
|
||
| **For op-contracts v2.0.0:** | ||
|
|
||
| ```bash | ||
| ./bin/op-validator validate v2.0.0 \ | ||
| --l1-rpc-url "<YOUR_L1_RPC_URL>" \ | ||
| --absolute-prestate "<YOUR_ABSOLUTE_PRESTATE>" \ | ||
| --proxy-admin "<YOUR_PROXY_ADMIN_ADDRESS>" \ | ||
| --system-config "<YOUR_SYSTEM_CONFIG_ADDRESS>" \ | ||
| --l2-chain-id "<YOUR_L2_CHAIN_ID>" \ | ||
| --fail | ||
| ``` | ||
|
|
||
| ### Review the validation results | ||
|
|
||
| The validator will check multiple aspects of your deployment against the standard configuration: | ||
|
|
||
| * Contract implementations and versions | ||
| * Proxy configurations | ||
| * System parameters | ||
| * Cross-component relationships | ||
| * Security settings | ||
|
|
||
| If validation passes, you'll see a success message. If there are issues, you'll see error codes with descriptions like: | ||
|
|
||
| | ERROR | DESCRIPTION | | ||
| | --------------- | -------------------------- | | ||
| | PDDG-40 | Permissioned dispute game | | ||
| | | absolute prestate mismatch | | ||
| | PDDG-ANCHORP-40 | Permissioned dispute game | | ||
| | | anchor state registry root | | ||
| | | hash mismatch | | ||
|
|
||
| ### Address any validation errors | ||
|
|
||
| If your deployment has validation errors: | ||
|
|
||
| 1. Understand the errors - Review the error codes and descriptions. | ||
| 2. Consider redeployment - For critical issues, redeploying with corrected parameters may be necessary. | ||
| </Steps> | ||
|
|
||
| ## Next Steps | ||
|
|
||
| * If you plan to join the Superchain, follow the [Standard Rollup Charter](/superchain/blockspace-charter). | ||
| * Configure [monitoring and maintenance](/operators/chain-operators/tools/chain-monitoring) |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.