Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
39 commits
Select commit Hold shift + click to select a range
cd9ba72
Add standandard config page
krofax Jan 17, 2025
165105b
fin lint issues
krofax Jan 17, 2025
d744072
Import callout
krofax Jan 17, 2025
ac92b86
clean extra spaces
krofax Jan 17, 2025
02c69d4
clean syntax error
krofax Jan 17, 2025
40a5879
added links
krofax Jan 17, 2025
f03bebd
Update words.txt
krofax Jan 17, 2025
eda4386
Update pages/superchain/standard-configuration.mdx
krofax Jan 17, 2025
d7048d0
made indentation fixes
krofax Jan 17, 2025
fd1a28e
Update pages/superchain/standard-configuration.mdx
krofax Jan 17, 2025
89c070e
Update pages/superchain/standard-configuration.mdx
krofax Jan 17, 2025
f0739a6
updated description
krofax Jan 19, 2025
568cd7d
updated standardization comment
krofax Jan 19, 2025
5af7697
updated meta json
krofax Jan 19, 2025
1f8db94
Update pages/superchain/standard-configuration.mdx
krofax Jan 19, 2025
fcf5e79
Update pages/superchain/standard-configuration.mdx
krofax Jan 19, 2025
ba16dd9
Update pages/superchain/standard-configuration.mdx
krofax Jan 19, 2025
0302205
Update pages/superchain/standard-configuration.mdx
krofax Jan 19, 2025
c05b1cc
Update pages/superchain/standard-configuration.mdx
krofax Jan 19, 2025
1b0baaa
Update pages/superchain/standard-configuration.mdx
krofax Jan 19, 2025
6c02432
Update pages/superchain/standard-configuration.mdx
krofax Jan 19, 2025
f5f4006
Update pages/superchain/standard-configuration.mdx
krofax Jan 19, 2025
4720a1e
Update pages/superchain/standard-configuration.mdx
krofax Jan 19, 2025
73fcc9e
Update pages/superchain/standard-configuration.mdx
krofax Jan 19, 2025
5a11ad5
Update pages/superchain/standard-configuration.mdx
krofax Jan 19, 2025
9bc9f2c
Update pages/superchain/standard-configuration.mdx
krofax Jan 19, 2025
af34107
Update pages/superchain/standard-configuration.mdx
krofax Jan 19, 2025
1d44c66
Update pages/superchain/standard-configuration.mdx
krofax Jan 19, 2025
e23a1ed
Update pages/superchain/standard-configuration.mdx
krofax Jan 19, 2025
84f5aac
Update pages/superchain/standard-configuration.mdx
krofax Jan 19, 2025
a946a99
Update pages/superchain/standard-configuration.mdx
krofax Jan 19, 2025
4b56216
Update pages/superchain/standard-configuration.mdx
krofax Jan 19, 2025
b52a2cb
Update pages/superchain/standard-configuration.mdx
krofax Jan 19, 2025
ededf85
Update pages/superchain/standard-configuration.mdx
krofax Jan 19, 2025
c2b8208
Update pages/superchain/standard-configuration.mdx
krofax Jan 19, 2025
1c005ea
Update pages/superchain/standard-configuration.mdx
krofax Jan 19, 2025
14a5849
merge conflict
krofax Jan 19, 2025
3e616c3
resolve comments
krofax Jan 19, 2025
f3e6dd5
resolve conflicts
krofax Jan 19, 2025
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 2 additions & 1 deletion pages/superchain/_meta.json
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
{
"superchain-explainer": "The Superchain explainer",
"superchain-registry": "The Superchain Registry",
"blockspace-charter": "Blockspace Charters and the Standard Rollup Charter"
"blockspace-charter": "Blockspace Charters and the Standard Rollup Charter",
"standard-configuration": "What makes a chain standard"
}
117 changes: 117 additions & 0 deletions pages/superchain/standard-configuration.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,117 @@
---
title: What makes a chain standard?
lang: en-US
description: Learn what makes a chain standard, how op-deployer helps with standardization, and why being standard matters.
---

import { Callout } from 'nextra/components'

# What makes a chain standard?

The standard configuration within the OP Stack ensures that chains deployed in the Superchain ecosystem adhere to a consistent set of technical and governance parameters.
This standardization is critical for Superchain interoperability, network security, and ease of upgrading your chain.

This guide provides an in-depth explanation of what defines a standard configuration, how the [op-deployer](/builders/chain-operators/tools/op-deployer) aids standardization, and why adhering to these standards is essential.

## What is a Standard chain?

A standard chain in the OP Stack refers to a rollup that adheres to the following principles:

1. **Technical conformance:**
* Compliance with the consensus parameters, policy parameters, admin roles, and service roles defined in the specifications.
For more details, please see the [OP Stack Configurability Specification](https://specs.optimism.io/protocol/configurability.html).
* Utilization of officially supported features and modules of the OP Stack.

2. **Governance alignment:**
* Adherence to the [Standard Rollup Charter](/superchain/blockspace-charter#the-standard-rollup-charter).
* Transparent and collaborative decision-making aligned with the Superchain ecosystem.

3. **Interoperability:**
* Maintaining compatibility with the Superchain protocol level cross-chain interactions.

Chains that deviate from these principles, such as introducing unsupported features like custom gas tokens, are considered non-standard configurations.

## Role of op-deployer in standardization

The [op-deployer](/builders/chain-operators/tools/op-deployer) is a powerful tool designed to automate and streamline the deployment of standard configuration-compliant chains.
Key features include:

* **Default values:**
op-deployer provides default values that adhere to standard specifications.


* **Ease of customization within standards:**
The op-deployer tool allows for overriding default values. For example, you can override the L2 block time to 1s, which is standard. However, please ensure you know what you're doing when applying overrides because they may violate standard specifications.

By using op-deployer, chain operators can reduce the complexity of chain deployment while ensuring alignment with Superchain standards.


## Why standardization matters

Standardization benefits the Superchain ecosystem in several ways:

* **Interoperability:**
A standard stack and security model makes your chain eligible for interactions between other standard chains, such as single block cross-chain messaging and token transfers.

* **Simplified upgrade path:**
Reduces the complexity of upgrading your chain to the latest version.


* **Reduced Support Overhead:**
Minimizes the need for custom support by ensuring uniformity across deployments.


### Standard features

* **Default system contracts:**
Core protocol contracts must use governance approved release implementations of the OP Stack to provide security and compatibility.


* **Specified sequencer configurations:**
Sequencer settings must follow prescribed parameters for transaction ordering and submission to maintain network stability.

## What is Not Standard?

Certain configurations are explicitly not part of the standard setup. For example:

* **Custom Gas Tokens:**
Introducing a gas token other than the default is currently not considered standard.


* **Modified system contracts:**
Any alterations to core system contracts break standardization and aren't supported in the official OP Stack specification.

For a detailed list of standard configurations, refer to the [Standard rollup configuration page](/superchain/blockspace-charter).

## Superchain Registry

The [Superchain Registry](/superchain/superchain-registry) is the authoritative index of all chains within the Superchain ecosystem. It ensures:

* **Transparency:**
All registered chains are publicly listed with their configurations.

* **Superchain levels:**
Chains listed in the registry are denoted with a [`superchain_level`](https://github.com/ethereum-optimism/superchain-registry/blob/main/docs/glossary.md#superchain-level-and-rollup-stage) which tells you which chains are standard.

* **Community trust:**
Being part of the registry signals reliability and alignment with Optimism Collective principles.

## Next Steps

1. **Understand standards:**
Familiarize yourself with the [OP Stack specifications](https://specs.optimism.io/protocol/configurability.html) and the Blockspace Charter.

2. **Use op-deployer:**
Leverage op-deployer to ensure your chain aligns with standard configurations.

3. **Seek guidance:**
Consult the [developer support](https://github.com/ethereum-optimism/developers/discussions) team for clarifications on standardization.

4. **Contribute to the ecosystem:**
Engage with the [Optimism Collective](https://community.optimism.io/) to share feedback and propose improvements.

## References

* [OP Stack Specifications](https://specs.optimism.io/protocol/configurability.html)
* [Blockspace Charter](/superchain/blockspace-charter)
* [Superchain Registry](https://github.com/ethereum-optimism/superchain-registry)
2 changes: 2 additions & 0 deletions words.txt
Original file line number Diff line number Diff line change
Expand Up @@ -167,6 +167,7 @@ JSPATH
jspath
jwtsecret
Keccak
Learn
leveldb
lightkdf
logfile
Expand Down Expand Up @@ -264,6 +265,7 @@ PPROF
pprof
Precommitments
precommitments
Preconfigured
preconfigured
predeploy
Predeployed
Expand Down