From 5b8dba05005cd554c081f717e9ef208f40aa7078 Mon Sep 17 00:00:00 2001 From: Bradley Camacho <42678939+bradleycamacho@users.noreply.github.com> Date: Mon, 18 Nov 2024 13:59:23 -0800 Subject: [PATCH 01/17] Basic nav work Adds a top-level category to left nav and new registry page under it --- pages/_meta.json | 13 +++++++++++++ pages/superchain/_meta.json | 3 +++ pages/superchain/superchain-registry.mdx | 9 +++++++++ 3 files changed, 25 insertions(+) create mode 100644 pages/superchain/_meta.json create mode 100644 pages/superchain/superchain-registry.mdx diff --git a/pages/_meta.json b/pages/_meta.json index fe5e52428..26f362e32 100644 --- a/pages/_meta.json +++ b/pages/_meta.json @@ -65,6 +65,19 @@ "display": "children" }, + "+++ THE SUPERCHAIN": { + "title": "", + "type": "separator" + }, + "--- THE SUPERCHAIN": { + "title": "THE SUPERCHAIN", + "type": "separator" + }, + "superchain": { + "title": "The Superchain", + "display": "children" + }, + "+++ OP STACK": { "title": "", "type": "separator" diff --git a/pages/superchain/_meta.json b/pages/superchain/_meta.json new file mode 100644 index 000000000..5108fb983 --- /dev/null +++ b/pages/superchain/_meta.json @@ -0,0 +1,3 @@ +{ + "superchain-registry": "The Superchain Registry" +} diff --git a/pages/superchain/superchain-registry.mdx b/pages/superchain/superchain-registry.mdx new file mode 100644 index 000000000..7749e6f72 --- /dev/null +++ b/pages/superchain/superchain-registry.mdx @@ -0,0 +1,9 @@ +--- +title: The Superchain Registry +lang: en-US +description: Learn about Optimism Superchain components, features, and roadmap. +--- + +import { Callout } from 'nextra/components' + +# The Superchain Registry From 1142844390df4f38f5a24b2be79b0663dbc32086 Mon Sep 17 00:00:00 2001 From: Bradley Camacho <42678939+bradleycamacho@users.noreply.github.com> Date: Mon, 18 Nov 2024 14:53:25 -0800 Subject: [PATCH 02/17] Add standard config and intro --- pages/superchain/superchain-registry.mdx | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/pages/superchain/superchain-registry.mdx b/pages/superchain/superchain-registry.mdx index 7749e6f72..ed34b8338 100644 --- a/pages/superchain/superchain-registry.mdx +++ b/pages/superchain/superchain-registry.mdx @@ -7,3 +7,23 @@ description: Learn about Optimism Superchain components, features, and roadmap. import { Callout } from 'nextra/components' # The Superchain Registry + +The Superchain Registry is an index of chains which serves as the source of truth for who’s in the Superchain and what modifications they’ve made. The Superchain Registry introduces: + +- Clear definition of what constitutes a Standard Chain and config +- A step-by-step process new chains can follow to join the registry +- Validation checks to ensure chains follow the standard config before joining the Superchain Registry +- A Superchain Registry repository that shows who’s in the registry and what changes they have made to the standard config + +## The Standard Config + +The Standard Config is the set of requirements for an OP Stack chain to be considered a Standard Chain within the Superchain. These requirements are currently a draft, pending governance approval. + +All chains must meet this config to meet the inclusion requirements for The Superchain. This config isn't meant to exclude chains, but instead make it easier to understand *how* to configure your chain to make it compatatible with the Superchain. + +You can find the current draft version of The Standard Config in the [specs repo](https://specs.optimism.io/protocol/configurability.html#op-stack-configurability). + + + We recommend using the [OP Contract Manager](/stack/opcm) to deploy L1 contracts that meet the Standard Config. + + From 1cb4e99fb215b862b85318d3705eeb7ded115774 Mon Sep 17 00:00:00 2001 From: Bradley Camacho <42678939+bradleycamacho@users.noreply.github.com> Date: Mon, 18 Nov 2024 15:20:28 -0800 Subject: [PATCH 03/17] "Joining the registry" section --- pages/superchain/superchain-registry.mdx | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/pages/superchain/superchain-registry.mdx b/pages/superchain/superchain-registry.mdx index ed34b8338..5b4599629 100644 --- a/pages/superchain/superchain-registry.mdx +++ b/pages/superchain/superchain-registry.mdx @@ -8,13 +8,15 @@ import { Callout } from 'nextra/components' # The Superchain Registry -The Superchain Registry is an index of chains which serves as the source of truth for who’s in the Superchain and what modifications they’ve made. The Superchain Registry introduces: +The Superchain Registry is a human-readable index of chains which serves as the source of truth for who’s in the Superchain and what modifications they’ve made. The Superchain Registry introduces: - Clear definition of what constitutes a Standard Chain and config - A step-by-step process new chains can follow to join the registry - Validation checks to ensure chains follow the standard config before joining the Superchain Registry - A Superchain Registry repository that shows who’s in the registry and what changes they have made to the standard config +You can find the [Superchain Registry here](https://github.com/ethereum-optimism/superchain-registry) + ## The Standard Config The Standard Config is the set of requirements for an OP Stack chain to be considered a Standard Chain within the Superchain. These requirements are currently a draft, pending governance approval. @@ -27,3 +29,8 @@ You can find the current draft version of The Standard Config in the [specs repo We recommend using the [OP Contract Manager](/stack/opcm) to deploy L1 contracts that meet the Standard Config. +## Joining the registry + +The Superchain Registry is designed to outline and clarify the process for making your chain Superchain-compatible and joining the registry. + +If your chain meets the Standard Config requirements, [follow the steps in this guide](https://github.com/ethereum-optimism/superchain-registry/blob/main/docs/add-chain.md) to submit a pull request and join the Superchain. \ No newline at end of file From 0d0905c887982a00008578eb6837f60937fe2359 Mon Sep 17 00:00:00 2001 From: Bradley Camacho <42678939+bradleycamacho@users.noreply.github.com> Date: Mon, 18 Nov 2024 16:13:14 -0800 Subject: [PATCH 04/17] Various fixes and clarifications --- pages/superchain/superchain-registry.mdx | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/pages/superchain/superchain-registry.mdx b/pages/superchain/superchain-registry.mdx index 5b4599629..419167458 100644 --- a/pages/superchain/superchain-registry.mdx +++ b/pages/superchain/superchain-registry.mdx @@ -8,12 +8,12 @@ import { Callout } from 'nextra/components' # The Superchain Registry -The Superchain Registry is a human-readable index of chains which serves as the source of truth for who’s in the Superchain and what modifications they’ve made. The Superchain Registry introduces: +The Superchain Registry is a human-readable index of chains which serves as the source of truth for who's in the Superchain and what modifications they've made. The Superchain Registry introduces: -- Clear definition of what constitutes a Standard Chain and config -- A step-by-step process new chains can follow to join the registry -- Validation checks to ensure chains follow the standard config before joining the Superchain Registry -- A Superchain Registry repository that shows who’s in the registry and what changes they have made to the standard config +* A clear definition of what constitutes a Standard Chain and config +* A step-by-step process new chains can follow to join the registry +* Validation checks to ensure chains follow the standard config before joining the Superchain Registry +* A Superchain Registry repository that shows who's in the registry and what changes they have made to the standard config You can find the [Superchain Registry here](https://github.com/ethereum-optimism/superchain-registry) @@ -33,4 +33,4 @@ You can find the current draft version of The Standard Config in the [specs repo The Superchain Registry is designed to outline and clarify the process for making your chain Superchain-compatible and joining the registry. -If your chain meets the Standard Config requirements, [follow the steps in this guide](https://github.com/ethereum-optimism/superchain-registry/blob/main/docs/add-chain.md) to submit a pull request and join the Superchain. \ No newline at end of file +If your chain meets the Standard Config requirements, [follow the steps in this guide](https://github.com/ethereum-optimism/superchain-registry/blob/main/docs/add-chain.md) to submit a pull request and join the Superchain. This guide will help you set up your chain, create your environment, and run all the validation checks needed to ensure your chain is ready to join the registry. From a3457f03ab649431bd3149f8622f2aa99b0a74f7 Mon Sep 17 00:00:00 2001 From: Bradley Camacho <42678939+bradleycamacho@users.noreply.github.com> Date: Fri, 20 Dec 2024 04:35:45 -0800 Subject: [PATCH 05/17] Pre-review doc updates --- pages/superchain/_meta.json | 4 +- pages/superchain/blockspace-charter.mdx | 103 ++++++++++++++++++ .../superchain-explainer.mdx} | 0 public/_redirects | 4 +- 4 files changed, 109 insertions(+), 2 deletions(-) create mode 100644 pages/superchain/blockspace-charter.mdx rename pages/{stack/explainer.mdx => superchain/superchain-explainer.mdx} (100%) diff --git a/pages/superchain/_meta.json b/pages/superchain/_meta.json index 5108fb983..23dc0134d 100644 --- a/pages/superchain/_meta.json +++ b/pages/superchain/_meta.json @@ -1,3 +1,5 @@ { - "superchain-registry": "The Superchain Registry" + "superchain-explainer": "The Superchain explainer", + "superchain-registry": "The Superchain Registry", + "blockspace-charter": "Blockspace and Standard charters" } diff --git a/pages/superchain/blockspace-charter.mdx b/pages/superchain/blockspace-charter.mdx new file mode 100644 index 000000000..250033534 --- /dev/null +++ b/pages/superchain/blockspace-charter.mdx @@ -0,0 +1,103 @@ +--- +title: Blockspace and Standard Rollup Charters +lang: en-US +description: Learn about Blockspace charters, the Standard Rollup charter, and the Superchain Registry. +--- +# The Blockspace and Standard Rollup charters + +Blockspace Charters and Standard Rollup Charter provide the essential technical and governance framework for the Superchain ecosystem. These frameworks provide a secure and scalable foundation for all stakeholders. By adhering to these charters, chain operators and users can operate confidently within the Optimism Superchain. + +These documents establish standards to ensure security, transparency, and long-term sustainability. This guide offers an overview of each charter, explains how chains can achieve compliance to be considered Standard Chains, and how the charters tie into the Superchain Registry. + +This doc mostly covers the charters, but references the Superchain Registry as they are all deeply connected. Read more about the Superchain Registry [here](./superchain-registry). + +## Summary of charters + +The components work in unison to form a cohesive governance and technical framework: + +- **Blockspace Charters:** A type of framework that establishes criteria, governing policies, and precommitments for blockspace in the Optimism ecosystem, ensuring security, uptime, and alignment with the [Law of Chains](https://github.com/ethereum-optimism/OPerating-manual/blob/main/Law%20of%20Chains.md). +- **Standard Rollup Charter:** Defines the technical and governance requirements for chains to achieve "Standard" status, ensuring consistency, high security, and operational reliability. Building on Blockspace Charters, this document sets specific technical and operational requirements for "Standard" status. It determines which chains can be added to the Superchain Registry by outlining both on-chain and off-chain validation processes. +- **Superchain Registry:** Serves as the authoritative resource for validating chain compliance, functioning as the integration point for on-chain and off-chain criteria. Acting as the ultimate validator, the registry confirms compliance with the Standard Rollup Charter. Chains listed here are officially recognized as "Standard," meeting all governance and technical benchmarks. + +Together, these components ensure a robust, scalable, and transparent ecosystem. Blockspace Charters provides the vision and principles, the Standard Rollup Charter translates these into concrete requirements, and the Superchain Registry certifies compliance. + +## Blockspace Charters + +Blockspace Charters outline the foundational framework for governing blockspace within the Optimism ecosystem. They are structured around three main components, detailed below: + +### Criteria +The technical parameters defining which chains are subject to the charter include: + - **Version:** The OP Stack version powering the chain, validated via commit-hash or release tag. + - **Configuration:** Parameter bounds for deployment, covering both static variables like Chain ID and dynamic variables such as sequencer roles or upgrade keys. + - **Solvency:** Verification that the chain’s history is free from invalid withdrawals or outputs that could undercollateralize the bridge. + +### Governing policies +These establish rules and procedures for stakeholder interactions and blockspace management. For example: + - Expected behaviors for roles like sequencers and upgrade key holders. + - Processes for identifying and resolving violations, such as governance votes for removing non-compliant actors. + - Alignment with the [Law of Chains](https://github.com/ethereum-optimism/OPerating-manual/blob/main/Law%20of%20Chains.md), ensuring protections like censorship resistance and security. + +### Precommitments +Commitments outlining long-term governance stability and anticipated changes. Examples include: + - Future updates to fee models or role separations. + - Guidance for evolving technical parameters like gas limits and fee margins. + +By defining these components, blockspace charters ensures secure, scalable, and governed blockspace while fostering trust and alignment within the ecosystem. + +Read more about Blockspace Charters in the [governance post](https://gov.optimism.io/t/season-6-introducing-blockspace-charters-superchain-first-governance/8133). + +## The Standard Rollup Charter + +The Standard Rollup Charter is a specific blockspace charter, which are a type of framework defining high-level principles, criteria, and governance policies for managing blockspace. The Standard Rollup Charter defines these into actionable requirements for achieving "Standard" status. It ensures that chains adhere to the technical and operational benchmarks necessary to maintain security, compatibility, and compliance with the overarching ecosystem governance. + +The Standard Rollup Charter defines the criteria for chains aspiring to achieve "Standard" status. These criteria ensure compatibility, security, and operational consistency. Key elements include: + +- **Security and integrity:** Chains must implement robust security measures to protect against attacks and ensure operational stability. Deterministic configurations and rigorous validations are key components. +- **Uptime and accessibility:** Chains are required to meet stringent uptime and liveness criteria, guaranteeing uninterrupted access. For instance, periodic performance checks and reliable failure recovery systems are mandated. + +Learn more about The Standard Charter in [the governance post](https://github.com/ethereum-optimism/OPerating-manual/blob/feat/standard-rollup-charter/Standard%20Rollup%20Charter.md#standard-rollup-charter). + +Here are some specific criteria a chain must meet: +### On-chain criteria + +- **Version validation:** Chains must deploy a governance-approved OP Stack release. Contracts must match the [standard bytecode](https://github.com/ethereum-optimism/superchain-registry/blob/main/validation/standard/standard-versions-mainnet.toml). +- **Configuration checks:** Chain parameters, such as block time and gas metering, must comply with governance-approved specifications. Administrative roles must align with Security Council requirements. + +Read more about On-Chain checks in the [repo](https://github.com/ethereum-optimism/OPerating-manual/blob/feat/standard-rollup-charter/Standard%20Rollup%20Charter.md#onchain-criteria) + +### Off-chain criteria + +The Optimism Foundation performs off-chain checks to verify compliance. These include: + +- Ensuring unique Chain IDs. +- Monitoring security configurations. +- Verifying governance authenticity. + +Such measures remain under the Foundation's oversight until governance transitions to fully autonomous control. + +Read more about Off-Chain checks in the [repo](https://github.com/ethereum-optimism/OPerating-manual/blob/feat/standard-rollup-charter/Standard%20Rollup%20Charter.md#offchain-criteria) + +### History integrity + +The history integrity check identifies discrepancies in chain history. While this process is expected to be phased out, it ensures chains meet the Law of Chains criteria during their transition to "Standard" status. + +### Understanding chain compliance + +Chains must meet strict requirements to qualify as "Standard." Below are answers to common questions: + +- **Can I modify system smart contracts and remain Standard?** No, modifications invalidate compliance. +- **Is a custom gas token chain Standard?** No, chains must use standard gas configurations. +- **Is an alt-DA mode chain Standard?** No, Standard Rollups must adhere to the default data availability model. +- **Will beta features qualify as Standard?** Not initially. Features require governance approval and testing. + + + + +## The Superchain Registry + +The Superchain Registry serves as the authoritative compliance tool. It: + +- **Validates version and configuration:** Ensures chains align with governance-approved standards in the form the The Standard Charter. +- **Indicates promotion:** Certifies chains meet the standard criteria and promotes them to "Standard". + +By integrating with the Standard Rollup Charter, the registry offers an automated and transparent validation system. This ensures chains can independently demonstrate compliance. For additional details, refer to the [Superchain Registry documentation](./superchain-registry). diff --git a/pages/stack/explainer.mdx b/pages/superchain/superchain-explainer.mdx similarity index 100% rename from pages/stack/explainer.mdx rename to pages/superchain/superchain-explainer.mdx diff --git a/public/_redirects b/public/_redirects index a1f267aeb..26d9dc1d1 100644 --- a/public/_redirects +++ b/public/_redirects @@ -116,4 +116,6 @@ /stack/interop/superchain-weth /stack/interop/assets/superchain-weth /stack/interop/transfer-superchainERC20 /stack/interop/assets/transfer-superchainERC20 /builders/app-developers/contracts/superchain-erc20 /stack/interop/assets/superchain-erc20 -/builders/chain-operators/tutorials/sdk /builders/app-developers/overview \ No newline at end of file +/builders/chain-operators/tutorials/sdk /builders/app-developers/overview +/builders/chain-operators/tutorials/sdk /builders/app-developers/overview +/stack/explainer /superchain/superchain-explainer \ No newline at end of file From 0075ef63a6b0babf3f9ab52c414b5ada6836c99b Mon Sep 17 00:00:00 2001 From: Bradley Camacho <42678939+bradleycamacho@users.noreply.github.com> Date: Fri, 20 Dec 2024 08:41:29 -0800 Subject: [PATCH 06/17] Linting --- .../chain-operators/hacks/overview.mdx | 2 +- .../tutorials/create-l2-rollup.mdx | 4 +- pages/index.mdx | 2 +- pages/stack/getting-started.mdx | 2 +- pages/superchain/blockspace-charter.mdx | 61 ++++++++++--------- pages/superchain/superchain-registry.mdx | 2 +- words.txt | 5 +- 7 files changed, 43 insertions(+), 35 deletions(-) diff --git a/pages/builders/chain-operators/hacks/overview.mdx b/pages/builders/chain-operators/hacks/overview.mdx index cf7a56dd6..c4a0f31c0 100644 --- a/pages/builders/chain-operators/hacks/overview.mdx +++ b/pages/builders/chain-operators/hacks/overview.mdx @@ -10,7 +10,7 @@ import { Callout } from 'nextra/components' Welcome to OP Stack Hacks, the **highly experimental** region of the OP Stack docs. OP Stack Hacks are an unofficial guide for messing around with the OP Stack. Here you'll find information about ways that the OP Stack can be modified in interesting ways. -OP Stack Hacks create blockchains that aren't exactly OP Stack, and may be insecure. Hacked OP Stack chains can break key invariants that are required to interoperate with [the Optimism Superchain](/stack/explainer). **Developers of chains that wish to interoperate with [the Optimism Superchain](/stack/explainer) should *not* include any hacks**. When in doubt, stick with the official components within [the current release of the OP Stack](/stack/getting-started#the-op-stack-today). +OP Stack Hacks create blockchains that aren't exactly OP Stack, and may be insecure. Hacked OP Stack chains can break key invariants that are required to interoperate with [the Optimism Superchain](/superchain/superchain-explainer). **Developers of chains that wish to interoperate with [the Optimism Superchain](/superchain/superchain-explainer) should *not* include any hacks**. When in doubt, stick with the official components within [the current release of the OP Stack](/stack/getting-started#the-op-stack-today). OP Stack Hacks are explicitly things that you can do with the OP Stack that are *not* currently intended for production use. diff --git a/pages/builders/chain-operators/tutorials/create-l2-rollup.mdx b/pages/builders/chain-operators/tutorials/create-l2-rollup.mdx index 19bae6b04..56b3df9ca 100644 --- a/pages/builders/chain-operators/tutorials/create-l2-rollup.mdx +++ b/pages/builders/chain-operators/tutorials/create-l2-rollup.mdx @@ -29,8 +29,8 @@ You can use this testnet to experiment and perform tests, or you can choose to m You don't need permission from anyone to modify or deploy the stack in any configuration you want. -Modifications to the OP Stack may prevent a chain from being able to benefit from aspects of the [Optimism Superchain](/stack/explainer). -Make sure to check out the [Superchain Explainer](/stack/explainer) to learn more. +Modifications to the OP Stack may prevent a chain from being able to benefit from aspects of the [Optimism Superchain](/superchain/superchain-explainer). +Make sure to check out the [Superchain Explainer](/superchain/superchain-explainer) to learn more. ## Software dependencies diff --git a/pages/index.mdx b/pages/index.mdx index fa4175ccc..488982016 100644 --- a/pages/index.mdx +++ b/pages/index.mdx @@ -57,5 +57,5 @@ We've got you covered with these detailed guides to help you learn all about Opt } /> - } /> + } /> diff --git a/pages/stack/getting-started.mdx b/pages/stack/getting-started.mdx index a3f5a13a2..384c5cab7 100644 --- a/pages/stack/getting-started.mdx +++ b/pages/stack/getting-started.mdx @@ -41,7 +41,7 @@ Optimism Bedrock is the current iteration of the OP Stack. The Bedrock release provides the tools for launching a production-quality Optimistic Rollup blockchain. At this point in time, the APIs for the different layers of the OP Stack are still tightly coupled to this Rollup configuration of the stack. -The OP Stack of today was built to support [the Optimism Superchain](/stack/explainer), a proposed network of L2s that share security, communication layers, and a common development stack (the OP Stack itself). +The OP Stack of today was built to support [the Optimism Superchain](/superchain/superchain-explainer), a proposed network of L2s that share security, communication layers, and a common development stack (the OP Stack itself). The Bedrock release of the OP Stack makes it easy to spin up an L2 that will be compatible with the Superchain when it launches. If you'd like to launch a Superchain-ready L2, check out our guide for running a chain based on the Bedrock release of the OP Stack. diff --git a/pages/superchain/blockspace-charter.mdx b/pages/superchain/blockspace-charter.mdx index 250033534..dcf1d6425 100644 --- a/pages/superchain/blockspace-charter.mdx +++ b/pages/superchain/blockspace-charter.mdx @@ -3,9 +3,10 @@ title: Blockspace and Standard Rollup Charters lang: en-US description: Learn about Blockspace charters, the Standard Rollup charter, and the Superchain Registry. --- + # The Blockspace and Standard Rollup charters -Blockspace Charters and Standard Rollup Charter provide the essential technical and governance framework for the Superchain ecosystem. These frameworks provide a secure and scalable foundation for all stakeholders. By adhering to these charters, chain operators and users can operate confidently within the Optimism Superchain. +Blockspace Charters and Standard Rollup Charter provide the essential technical and governance framework for the Superchain ecosystem. These frameworks provide a secure and scalable foundation for all stakeholders. By adhering to these charters, chain operators and users can operate confidently within the Optimism Superchain. These documents establish standards to ensure security, transparency, and long-term sustainability. This guide offers an overview of each charter, explains how chains can achieve compliance to be considered Standard Chains, and how the charters tie into the Superchain Registry. @@ -15,9 +16,9 @@ This doc mostly covers the charters, but references the Superchain Registry as t The components work in unison to form a cohesive governance and technical framework: -- **Blockspace Charters:** A type of framework that establishes criteria, governing policies, and precommitments for blockspace in the Optimism ecosystem, ensuring security, uptime, and alignment with the [Law of Chains](https://github.com/ethereum-optimism/OPerating-manual/blob/main/Law%20of%20Chains.md). -- **Standard Rollup Charter:** Defines the technical and governance requirements for chains to achieve "Standard" status, ensuring consistency, high security, and operational reliability. Building on Blockspace Charters, this document sets specific technical and operational requirements for "Standard" status. It determines which chains can be added to the Superchain Registry by outlining both on-chain and off-chain validation processes. -- **Superchain Registry:** Serves as the authoritative resource for validating chain compliance, functioning as the integration point for on-chain and off-chain criteria. Acting as the ultimate validator, the registry confirms compliance with the Standard Rollup Charter. Chains listed here are officially recognized as "Standard," meeting all governance and technical benchmarks. +* **Blockspace Charters:** A type of framework that establishes criteria, governing policies, and precommitments for blockspace in the Optimism ecosystem, ensuring security, uptime, and alignment with the [Law of Chains](https://github.com/ethereum-optimism/OPerating-manual/blob/main/Law%20of%20Chains.md). +* **Standard Rollup Charter:** Defines the technical and governance requirements for chains to achieve "Standard" status, ensuring consistency, high security, and operational reliability. Building on Blockspace Charters, this document sets specific technical and operational requirements for "Standard" status. It determines which chains can be added to the Superchain Registry by outlining both on-chain and off-chain validation processes. +* **Superchain Registry:** Serves as the authoritative resource for validating chain compliance, functioning as the integration point for on-chain and off-chain criteria. Acting as the ultimate validator, the registry confirms compliance with the Standard Rollup Charter. Chains listed here are officially recognized as "Standard," meeting all governance and technical benchmarks. Together, these components ensure a robust, scalable, and transparent ecosystem. Blockspace Charters provides the vision and principles, the Standard Rollup Charter translates these into concrete requirements, and the Superchain Registry certifies compliance. @@ -26,21 +27,27 @@ Together, these components ensure a robust, scalable, and transparent ecosystem. Blockspace Charters outline the foundational framework for governing blockspace within the Optimism ecosystem. They are structured around three main components, detailed below: ### Criteria + The technical parameters defining which chains are subject to the charter include: - - **Version:** The OP Stack version powering the chain, validated via commit-hash or release tag. - - **Configuration:** Parameter bounds for deployment, covering both static variables like Chain ID and dynamic variables such as sequencer roles or upgrade keys. - - **Solvency:** Verification that the chain’s history is free from invalid withdrawals or outputs that could undercollateralize the bridge. + +* **Version:** The OP Stack version powering the chain, validated via commit-hash or release tag. +* **Configuration:** Parameter bounds for deployment, covering both static variables like Chain ID and dynamic variables such as sequencer roles or upgrade keys. +* **Solvency:** Verification that the chain's history is free from invalid withdrawals or outputs that could undercollateralize the bridge. ### Governing policies + These establish rules and procedures for stakeholder interactions and blockspace management. For example: - - Expected behaviors for roles like sequencers and upgrade key holders. - - Processes for identifying and resolving violations, such as governance votes for removing non-compliant actors. - - Alignment with the [Law of Chains](https://github.com/ethereum-optimism/OPerating-manual/blob/main/Law%20of%20Chains.md), ensuring protections like censorship resistance and security. + +* Expected behaviors for roles like sequencers and upgrade key holders. +* Processes for identifying and resolving violations, such as governance votes for removing non-compliant actors. +* Alignment with the [Law of Chains](https://github.com/ethereum-optimism/OPerating-manual/blob/main/Law%20of%20Chains.md), ensuring protections like censorship resistance and security. ### Precommitments + Commitments outlining long-term governance stability and anticipated changes. Examples include: - - Future updates to fee models or role separations. - - Guidance for evolving technical parameters like gas limits and fee margins. + +* Future updates to fee models or role separations. +* Guidance for evolving technical parameters like gas limits and fee margins. By defining these components, blockspace charters ensures secure, scalable, and governed blockspace while fostering trust and alignment within the ecosystem. @@ -52,16 +59,17 @@ The Standard Rollup Charter is a specific blockspace charter, which are a type o The Standard Rollup Charter defines the criteria for chains aspiring to achieve "Standard" status. These criteria ensure compatibility, security, and operational consistency. Key elements include: -- **Security and integrity:** Chains must implement robust security measures to protect against attacks and ensure operational stability. Deterministic configurations and rigorous validations are key components. -- **Uptime and accessibility:** Chains are required to meet stringent uptime and liveness criteria, guaranteeing uninterrupted access. For instance, periodic performance checks and reliable failure recovery systems are mandated. +* **Security and integrity:** Chains must implement robust security measures to protect against attacks and ensure operational stability. Deterministic configurations and rigorous validations are key components. +* **Uptime and accessibility:** Chains are required to meet stringent uptime and liveness criteria, guaranteeing uninterrupted access. For instance, periodic performance checks and reliable failure recovery systems are mandated. Learn more about The Standard Charter in [the governance post](https://github.com/ethereum-optimism/OPerating-manual/blob/feat/standard-rollup-charter/Standard%20Rollup%20Charter.md#standard-rollup-charter). Here are some specific criteria a chain must meet: + ### On-chain criteria -- **Version validation:** Chains must deploy a governance-approved OP Stack release. Contracts must match the [standard bytecode](https://github.com/ethereum-optimism/superchain-registry/blob/main/validation/standard/standard-versions-mainnet.toml). -- **Configuration checks:** Chain parameters, such as block time and gas metering, must comply with governance-approved specifications. Administrative roles must align with Security Council requirements. +* **Version validation:** Chains must deploy a governance-approved OP Stack release. Contracts must match the [standard bytecode](https://github.com/ethereum-optimism/superchain-registry/blob/main/validation/standard/standard-versions-mainnet.toml). +* **Configuration checks:** Chain parameters, such as block time and gas metering, must comply with governance-approved specifications. Administrative roles must align with Security Council requirements. Read more about On-Chain checks in the [repo](https://github.com/ethereum-optimism/OPerating-manual/blob/feat/standard-rollup-charter/Standard%20Rollup%20Charter.md#onchain-criteria) @@ -69,9 +77,9 @@ Read more about On-Chain checks in the [repo](https://github.com/ethereum-optimi The Optimism Foundation performs off-chain checks to verify compliance. These include: -- Ensuring unique Chain IDs. -- Monitoring security configurations. -- Verifying governance authenticity. +* Ensuring unique Chain IDs. +* Monitoring security configurations. +* Verifying governance authenticity. Such measures remain under the Foundation's oversight until governance transitions to fully autonomous control. @@ -85,19 +93,16 @@ The history integrity check identifies discrepancies in chain history. While thi Chains must meet strict requirements to qualify as "Standard." Below are answers to common questions: -- **Can I modify system smart contracts and remain Standard?** No, modifications invalidate compliance. -- **Is a custom gas token chain Standard?** No, chains must use standard gas configurations. -- **Is an alt-DA mode chain Standard?** No, Standard Rollups must adhere to the default data availability model. -- **Will beta features qualify as Standard?** Not initially. Features require governance approval and testing. - - - +* **Can I modify system smart contracts and remain Standard?** No, modifications invalidate compliance. +* **Is a custom gas token chain Standard?** No, chains must use standard gas configurations. +* **Is an alt-DA mode chain Standard?** No, Standard Rollups must adhere to the default data availability model. +* **Will beta features qualify as Standard?** Not initially. Features require governance approval and testing. ## The Superchain Registry The Superchain Registry serves as the authoritative compliance tool. It: -- **Validates version and configuration:** Ensures chains align with governance-approved standards in the form the The Standard Charter. -- **Indicates promotion:** Certifies chains meet the standard criteria and promotes them to "Standard". +* **Validates version and configuration:** Ensures chains align with governance-approved standards in the form the The Standard Charter. +* **Indicates promotion:** Certifies chains meet the standard criteria and promotes them to "Standard". By integrating with the Standard Rollup Charter, the registry offers an automated and transparent validation system. This ensures chains can independently demonstrate compliance. For additional details, refer to the [Superchain Registry documentation](./superchain-registry). diff --git a/pages/superchain/superchain-registry.mdx b/pages/superchain/superchain-registry.mdx index 419167458..c662b83cc 100644 --- a/pages/superchain/superchain-registry.mdx +++ b/pages/superchain/superchain-registry.mdx @@ -21,7 +21,7 @@ You can find the [Superchain Registry here](https://github.com/ethereum-optimism The Standard Config is the set of requirements for an OP Stack chain to be considered a Standard Chain within the Superchain. These requirements are currently a draft, pending governance approval. -All chains must meet this config to meet the inclusion requirements for The Superchain. This config isn't meant to exclude chains, but instead make it easier to understand *how* to configure your chain to make it compatatible with the Superchain. +All chains must meet this config to meet the inclusion requirements for The Superchain. This config isn't meant to exclude chains, but instead make it easier to understand *how* to configure your chain to make it compatible with the Superchain. You can find the current draft version of The Standard Config in the [specs repo](https://specs.optimism.io/protocol/configurability.html#op-stack-configurability). diff --git a/words.txt b/words.txt index f5ae76fbc..d8ff898da 100644 --- a/words.txt +++ b/words.txt @@ -36,6 +36,7 @@ blocklogs BLOCKPROFILERATE blockprofilerate Blockscout +Blockspace blockspace blocktime BLOOMFILTER @@ -200,7 +201,6 @@ minsuggestedpriorityfee Mintable Mintplex MIPSEVM -Mitigations Monitorism Moralis Mordor @@ -267,6 +267,8 @@ POAP POAPs PPROF pprof +Precommitments +precommitments preconfigured Predeploy predeploy @@ -390,6 +392,7 @@ txpool txproxy txproxyd uncountered +undercollateralize Unprotect unsubmitted UPNP From 875ac805825121120d8ecffd33dac2f6b70373bf Mon Sep 17 00:00:00 2001 From: Bradley Camacho <42678939+bradleycamacho@users.noreply.github.com> Date: Fri, 20 Dec 2024 08:43:00 -0800 Subject: [PATCH 07/17] More linting --- words.txt | 1 + 1 file changed, 1 insertion(+) diff --git a/words.txt b/words.txt index d8ff898da..d7aba8f1b 100644 --- a/words.txt +++ b/words.txt @@ -13,6 +13,7 @@ ANDI Ankr Apeworx Arweave +Asterisc authrpc Badgeholder's Badgeholders From 09df23a90787e6c8e488237a3ea46d3e39ffcb6a Mon Sep 17 00:00:00 2001 From: Bradley Camacho <42678939+bradleycamacho@users.noreply.github.com> Date: Fri, 20 Dec 2024 08:45:45 -0800 Subject: [PATCH 08/17] Update words.txt --- words.txt | 3 +++ 1 file changed, 3 insertions(+) diff --git a/words.txt b/words.txt index d7aba8f1b..c4682b162 100644 --- a/words.txt +++ b/words.txt @@ -11,6 +11,7 @@ Allocs allocs ANDI Ankr +Arbitrum's Apeworx Arweave Asterisc @@ -51,6 +52,7 @@ bottlenecked Brotli brotli Callouts +Cartesi callouts CCIP Celestia @@ -410,6 +412,7 @@ VMODULE vmodule voxel Warpcast +WAVM xlarge XORI xtensibility From 59cf1aa78313a6604aeda3794778354e5bb04462 Mon Sep 17 00:00:00 2001 From: Bradley Camacho <42678939+bradleycamacho@users.noreply.github.com> Date: Fri, 20 Dec 2024 08:53:03 -0800 Subject: [PATCH 09/17] Add more words to words file --- words.txt | 1 + 1 file changed, 1 insertion(+) diff --git a/words.txt b/words.txt index c4682b162..5e5d22ad8 100644 --- a/words.txt +++ b/words.txt @@ -420,3 +420,4 @@ ZKPs ZKVM Zora zora +Mitigations \ No newline at end of file From 682cb9a251742d3795ada6c66677a58b2630c5f0 Mon Sep 17 00:00:00 2001 From: Bradley Camacho <42678939+bradleycamacho@users.noreply.github.com> Date: Fri, 20 Dec 2024 08:56:07 -0800 Subject: [PATCH 10/17] Fix broken link --- pages/chain/testing/dev-node.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/chain/testing/dev-node.mdx b/pages/chain/testing/dev-node.mdx index c7da9fee1..228a1a803 100644 --- a/pages/chain/testing/dev-node.mdx +++ b/pages/chain/testing/dev-node.mdx @@ -27,7 +27,7 @@ anyone to modify or deploy the stack in any configuration you want. Modifications to the OP Stack may prevent a chain from being able to benefit from aspects of the [Optimism - Superchain](/stack/explainer). Make sure to check out the [Superchain Explainer](/stack/explainer) to learn more. + Superchain](/superchain/superchain-explainer). Make sure to check out the [Superchain Explainer](/superchain/superchain-explainer) to learn more. ## Installing Dependencies From 19c15be0fa182eb68509a218335532f023ee43cb Mon Sep 17 00:00:00 2001 From: Bradley Camacho <42678939+bradleycamacho@users.noreply.github.com> Date: Fri, 20 Dec 2024 10:01:40 -0800 Subject: [PATCH 11/17] Superchain phrasing --- pages/superchain/blockspace-charter.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/superchain/blockspace-charter.mdx b/pages/superchain/blockspace-charter.mdx index dcf1d6425..13765532f 100644 --- a/pages/superchain/blockspace-charter.mdx +++ b/pages/superchain/blockspace-charter.mdx @@ -18,7 +18,7 @@ The components work in unison to form a cohesive governance and technical framew * **Blockspace Charters:** A type of framework that establishes criteria, governing policies, and precommitments for blockspace in the Optimism ecosystem, ensuring security, uptime, and alignment with the [Law of Chains](https://github.com/ethereum-optimism/OPerating-manual/blob/main/Law%20of%20Chains.md). * **Standard Rollup Charter:** Defines the technical and governance requirements for chains to achieve "Standard" status, ensuring consistency, high security, and operational reliability. Building on Blockspace Charters, this document sets specific technical and operational requirements for "Standard" status. It determines which chains can be added to the Superchain Registry by outlining both on-chain and off-chain validation processes. -* **Superchain Registry:** Serves as the authoritative resource for validating chain compliance, functioning as the integration point for on-chain and off-chain criteria. Acting as the ultimate validator, the registry confirms compliance with the Standard Rollup Charter. Chains listed here are officially recognized as "Standard," meeting all governance and technical benchmarks. +* **Superchain Registry:** The Superchain Registry is a human-readable index of chains which serves as the source of truth for who's in the Superchain and what modifications they've made. Acting as the chain validator, the registry confirms compliance with the Standard Rollup Charter. Chains listed here are officially recognized as "Standard," meeting all governance and technical benchmarks. Together, these components ensure a robust, scalable, and transparent ecosystem. Blockspace Charters provides the vision and principles, the Standard Rollup Charter translates these into concrete requirements, and the Superchain Registry certifies compliance. From d2d75116a9a53882188c0dab22e60725c91b417f Mon Sep 17 00:00:00 2001 From: Bradley Camacho <42678939+bradleycamacho@users.noreply.github.com> Date: Mon, 23 Dec 2024 12:01:12 -0800 Subject: [PATCH 12/17] Superchain Registry feedback --- pages/superchain/superchain-registry.mdx | 23 +++++++++-------------- 1 file changed, 9 insertions(+), 14 deletions(-) diff --git a/pages/superchain/superchain-registry.mdx b/pages/superchain/superchain-registry.mdx index c662b83cc..670ac94ac 100644 --- a/pages/superchain/superchain-registry.mdx +++ b/pages/superchain/superchain-registry.mdx @@ -8,29 +8,24 @@ import { Callout } from 'nextra/components' # The Superchain Registry -The Superchain Registry is a human-readable index of chains which serves as the source of truth for who's in the Superchain and what modifications they've made. The Superchain Registry introduces: +The Superchain Registry serves as the source of truth for who's in the Superchain Ecosystem and what modifications they've made. The Superchain Registry introduces: -* A clear definition of what constitutes a Standard Chain and config * A step-by-step process new chains can follow to join the registry -* Validation checks to ensure chains follow the standard config before joining the Superchain Registry -* A Superchain Registry repository that shows who's in the registry and what changes they have made to the standard config +* Validation checks to ensure standard chains comply with the Standard Rollup Charter and non-standard chains pass baseline validation before joining the Superchain Registry +* A Superchain Registry repository that shows who's in the registry and the chain's configuration -You can find the [Superchain Registry here](https://github.com/ethereum-optimism/superchain-registry) +## The Standard Rollup -## The Standard Config +An OP Stack Standard Rollup meets the set of requirements to be a member of the Superchain. -The Standard Config is the set of requirements for an OP Stack chain to be considered a Standard Chain within the Superchain. These requirements are currently a draft, pending governance approval. +All chains must meet this config to meet the inclusion requirements for The Superchain. This configuration targets the Optimism Collective’s highest bar for security, uptime, and decentralization. -All chains must meet this config to meet the inclusion requirements for The Superchain. This config isn't meant to exclude chains, but instead make it easier to understand *how* to configure your chain to make it compatible with the Superchain. - -You can find the current draft version of The Standard Config in the [specs repo](https://specs.optimism.io/protocol/configurability.html#op-stack-configurability). +You can find more details in the [Standard Rollup Charter documentation](/superchain/blockspace-charter). - We recommend using the [OP Contract Manager](/stack/opcm) to deploy L1 contracts that meet the Standard Config. + We recommend using the [op-deployer](/builders/chain-operators/tools/op-deployer) to deploy L1 contracts and generate the L2 genesis file that meet the configuration requirements outlined in the [Standard Rollup Charter](/superchain/blockspace-charter). ## Joining the registry -The Superchain Registry is designed to outline and clarify the process for making your chain Superchain-compatible and joining the registry. - -If your chain meets the Standard Config requirements, [follow the steps in this guide](https://github.com/ethereum-optimism/superchain-registry/blob/main/docs/add-chain.md) to submit a pull request and join the Superchain. This guide will help you set up your chain, create your environment, and run all the validation checks needed to ensure your chain is ready to join the registry. +All Superchain Ecosystem members are welcome to join the Superchain Registry, regardless of whether they adhere to the standard rollup charter to not. To join the Registry, [follow the steps in this guide](https://github.com/ethereum-optimism/superchain-registry/blob/main/docs/add-chain.md) to submit a pull request and join the Superchain Ecosystem. This guide will help you set up your chain, create your environment, and run all the validation checks needed to ensure your chain is ready to join the Registry. From 1735c5f81b1c444925c54587c2f4ecde1dbd84e1 Mon Sep 17 00:00:00 2001 From: Bradley Camacho <42678939+bradleycamacho@users.noreply.github.com> Date: Mon, 23 Dec 2024 13:15:34 -0800 Subject: [PATCH 13/17] Charters feedback updates --- pages/superchain/blockspace-charter.mdx | 51 +++++++++++++----------- pages/superchain/superchain-registry.mdx | 2 +- 2 files changed, 29 insertions(+), 24 deletions(-) diff --git a/pages/superchain/blockspace-charter.mdx b/pages/superchain/blockspace-charter.mdx index 13765532f..d4a1d3581 100644 --- a/pages/superchain/blockspace-charter.mdx +++ b/pages/superchain/blockspace-charter.mdx @@ -6,25 +6,27 @@ description: Learn about Blockspace charters, the Standard Rollup charter, and t # The Blockspace and Standard Rollup charters -Blockspace Charters and Standard Rollup Charter provide the essential technical and governance framework for the Superchain ecosystem. These frameworks provide a secure and scalable foundation for all stakeholders. By adhering to these charters, chain operators and users can operate confidently within the Optimism Superchain. +Blockspace Charters provide the essential technical and governance framework for the Superchain ecosystem. These frameworks provide a secure and scalable foundation for all stakeholders. By adhering to these charters, chain operators and users can operate confidently within the Superchain ecosystem. The Standard Rollup Charter is the first of several blockspace charters with different customizations and security guarantees. These documents establish standards to ensure security, transparency, and long-term sustainability. This guide offers an overview of each charter, explains how chains can achieve compliance to be considered Standard Chains, and how the charters tie into the Superchain Registry. -This doc mostly covers the charters, but references the Superchain Registry as they are all deeply connected. Read more about the Superchain Registry [here](./superchain-registry). +This doc mostly covers the charters, but references the Superchain Registry as they are all deeply connected. Read more about the Superchain Registry [here](/superchain/superchain-registry). ## Summary of charters The components work in unison to form a cohesive governance and technical framework: * **Blockspace Charters:** A type of framework that establishes criteria, governing policies, and precommitments for blockspace in the Optimism ecosystem, ensuring security, uptime, and alignment with the [Law of Chains](https://github.com/ethereum-optimism/OPerating-manual/blob/main/Law%20of%20Chains.md). -* **Standard Rollup Charter:** Defines the technical and governance requirements for chains to achieve "Standard" status, ensuring consistency, high security, and operational reliability. Building on Blockspace Charters, this document sets specific technical and operational requirements for "Standard" status. It determines which chains can be added to the Superchain Registry by outlining both on-chain and off-chain validation processes. -* **Superchain Registry:** The Superchain Registry is a human-readable index of chains which serves as the source of truth for who's in the Superchain and what modifications they've made. Acting as the chain validator, the registry confirms compliance with the Standard Rollup Charter. Chains listed here are officially recognized as "Standard," meeting all governance and technical benchmarks. +* **Standard Rollup Charter:** The Standard Rollup Charter is the first blockspace charter, defining the technical and governance requirements for our highest-security blockspace. By adhering to the Standard Rollup Charter, chains can achieve "Standard" status, ensuring consistency, high security, and operational reliability. +* **Superchain Registry:** The Superchain Registry is an index of chains which serves as the source of truth for who's in the Superchain ecosystem and the chain's configuration. The registry checks for compliance with the Standard Rollup Charter. Chains with set as `superchain_level = 1` meet all the criteria to be classified as a Standard Rollup. Together, these components ensure a robust, scalable, and transparent ecosystem. Blockspace Charters provides the vision and principles, the Standard Rollup Charter translates these into concrete requirements, and the Superchain Registry certifies compliance. ## Blockspace Charters -Blockspace Charters outline the foundational framework for governing blockspace within the Optimism ecosystem. They are structured around three main components, detailed below: +Blockspace Charters outline the foundational framework for governing blockspace within the Optimism ecosystem. + +They are structured around three main components, detailed below: ### Criteria @@ -32,7 +34,7 @@ The technical parameters defining which chains are subject to the charter includ * **Version:** The OP Stack version powering the chain, validated via commit-hash or release tag. * **Configuration:** Parameter bounds for deployment, covering both static variables like Chain ID and dynamic variables such as sequencer roles or upgrade keys. -* **Solvency:** Verification that the chain's history is free from invalid withdrawals or outputs that could undercollateralize the bridge. +* **Solvency:** Verification that all state transitions in the chain's history are valid, and free from invalid withdrawals or outputs that could undercollateralize the bridge. ### Governing policies @@ -40,7 +42,7 @@ These establish rules and procedures for stakeholder interactions and blockspace * Expected behaviors for roles like sequencers and upgrade key holders. * Processes for identifying and resolving violations, such as governance votes for removing non-compliant actors. -* Alignment with the [Law of Chains](https://github.com/ethereum-optimism/OPerating-manual/blob/main/Law%20of%20Chains.md), ensuring protections like censorship resistance and security. +* Alignment with the [Law of Chains](https://github.com/ethereum-optimism/OPerating-manual/blob/main/Law%20of%20Chains.md), ensuring user protections like censorship resistance and security. ### Precommitments @@ -51,27 +53,30 @@ Commitments outlining long-term governance stability and anticipated changes. Ex By defining these components, blockspace charters ensures secure, scalable, and governed blockspace while fostering trust and alignment within the ecosystem. -Read more about Blockspace Charters in the [governance post](https://gov.optimism.io/t/season-6-introducing-blockspace-charters-superchain-first-governance/8133). +### Criteria governance -## The Standard Rollup Charter +The criteria for Blockspace Charters are set in two ways; either by a governance vote or by the Optimism Foundation. -The Standard Rollup Charter is a specific blockspace charter, which are a type of framework defining high-level principles, criteria, and governance policies for managing blockspace. The Standard Rollup Charter defines these into actionable requirements for achieving "Standard" status. It ensures that chains adhere to the technical and operational benchmarks necessary to maintain security, compatibility, and compliance with the overarching ecosystem governance. +* **Governance controlled**: The three `TOML` files referenced in the charter (standard config params, standard config roles, and standard versions) require a governance vote to alter. Changes to the files require a governance vote, but changes to code or tools that consume or validate them don't "so long as they do not violate the semantic interpretation of those TOML files." +* **Foundation discretion**: Changes to validation, outside of the three TOML files referenced above, remain at the Foundation’s discretion. This includes changes to, but is not limited to, BHIC, other config checks, and RPC availability. -The Standard Rollup Charter defines the criteria for chains aspiring to achieve "Standard" status. These criteria ensure compatibility, security, and operational consistency. Key elements include: +Read more about Blockspace Charters in the [governance post](https://gov.optimism.io/t/season-6-introducing-blockspace-charters-superchain-first-governance/8133). + + +## The Standard Rollup Charter -* **Security and integrity:** Chains must implement robust security measures to protect against attacks and ensure operational stability. Deterministic configurations and rigorous validations are key components. -* **Uptime and accessibility:** Chains are required to meet stringent uptime and liveness criteria, guaranteeing uninterrupted access. For instance, periodic performance checks and reliable failure recovery systems are mandated. +The Standard Rollup Charter is the blockspace charter that defines the requirements for being a standard chain, our highest-security flagship blockspace. The Standard Rollup Charter ensures that chains adhere to the technical and operational benchmarks necessary to maintain the highest standards of security, compatibility, and compliance in the Superchain. Learn more about The Standard Charter in [the governance post](https://github.com/ethereum-optimism/OPerating-manual/blob/feat/standard-rollup-charter/Standard%20Rollup%20Charter.md#standard-rollup-charter). Here are some specific criteria a chain must meet: -### On-chain criteria +### Onchain criteria -* **Version validation:** Chains must deploy a governance-approved OP Stack release. Contracts must match the [standard bytecode](https://github.com/ethereum-optimism/superchain-registry/blob/main/validation/standard/standard-versions-mainnet.toml). +* **Version validation:** Chains must deploy a governance-approved, up-to-date OP Stack release. Contracts must match the [standard bytecode](https://github.com/ethereum-optimism/superchain-registry/blob/main/validation/standard/standard-versions-mainnet.toml). * **Configuration checks:** Chain parameters, such as block time and gas metering, must comply with governance-approved specifications. Administrative roles must align with Security Council requirements. -Read more about On-Chain checks in the [repo](https://github.com/ethereum-optimism/OPerating-manual/blob/feat/standard-rollup-charter/Standard%20Rollup%20Charter.md#onchain-criteria) +Read more about onchain checks in the [repo](https://github.com/ethereum-optimism/OPerating-manual/blob/feat/standard-rollup-charter/Standard%20Rollup%20Charter.md#onchain-criteria) and about configurations required by the Blockspace Charter in the three TOML files above and the Optimism Foundation [here.](https://specs.optimism.io/protocol/configurability.html) ### Off-chain criteria @@ -87,22 +92,22 @@ Read more about Off-Chain checks in the [repo](https://github.com/ethereum-optim ### History integrity -The history integrity check identifies discrepancies in chain history. While this process is expected to be phased out, it ensures chains meet the Law of Chains criteria during their transition to "Standard" status. +The history integrity check identifies discrepancies in chain history, including invalid state transitions. These checks are only required for chains that have not been managed by the Optimism Security Council initially. ### Understanding chain compliance Chains must meet strict requirements to qualify as "Standard." Below are answers to common questions: * **Can I modify system smart contracts and remain Standard?** No, modifications invalidate compliance. -* **Is a custom gas token chain Standard?** No, chains must use standard gas configurations. +* **Is a custom gas token chain Standard?** No, standard chains must use ethereum as their gas token. * **Is an alt-DA mode chain Standard?** No, Standard Rollups must adhere to the default data availability model. -* **Will beta features qualify as Standard?** Not initially. Features require governance approval and testing. +* **Will beta features qualify as Standard?** No. Beta features have not yet been approved by Optimism Governance. When features graduate from Beta to GA, they may be included in the standard rollup charter. ## The Superchain Registry -The Superchain Registry serves as the authoritative compliance tool. It: +The Superchain Registry serves as the source of truth for who's in the Superchain Ecosystem and what modifications they've made. The Superchain Registry has two main tasks: -* **Validates version and configuration:** Ensures chains align with governance-approved standards in the form the The Standard Charter. -* **Indicates promotion:** Certifies chains meet the standard criteria and promotes them to "Standard". +* **Validates version and configuration:** The registry validates that chains align with governance-approved standards in the form the The Standard Rollup Charter. +* **Indicates adherence to the Standard Rollup Charter:** Once the registry validates that a chain meets the standard criteria, it promotes it to "Standard" by setting its `superchain_level` value to `1`. -By integrating with the Standard Rollup Charter, the registry offers an automated and transparent validation system. This ensures chains can independently demonstrate compliance. For additional details, refer to the [Superchain Registry documentation](./superchain-registry). +By integrating with the Standard Rollup Charter, the registry offers an automated and transparent validation system. This ensures chains can independently demonstrate compliance. For additional details, refer to the [Superchain Registry documentation](/superchain/superchain-registry). \ No newline at end of file diff --git a/pages/superchain/superchain-registry.mdx b/pages/superchain/superchain-registry.mdx index 670ac94ac..fea004f2a 100644 --- a/pages/superchain/superchain-registry.mdx +++ b/pages/superchain/superchain-registry.mdx @@ -12,7 +12,7 @@ The Superchain Registry serves as the source of truth for who's in the Superchai * A step-by-step process new chains can follow to join the registry * Validation checks to ensure standard chains comply with the Standard Rollup Charter and non-standard chains pass baseline validation before joining the Superchain Registry -* A Superchain Registry repository that shows who's in the registry and the chain's configuration +* A Superchain Registry repository that shows who's in the registry and the chain's configuration. Chains with set as `superchain_level = 1` meet all the criteria to be classified as a Standard Rollup. ## The Standard Rollup From 7e9e18b58559846155a7519c45fe64beb73540d3 Mon Sep 17 00:00:00 2001 From: Bradley Camacho <42678939+bradleycamacho@users.noreply.github.com> Date: Mon, 23 Dec 2024 13:19:16 -0800 Subject: [PATCH 14/17] Lint fixes --- pages/superchain/blockspace-charter.mdx | 11 +++++------ pages/superchain/superchain-registry.mdx | 2 +- 2 files changed, 6 insertions(+), 7 deletions(-) diff --git a/pages/superchain/blockspace-charter.mdx b/pages/superchain/blockspace-charter.mdx index d4a1d3581..20cd459ed 100644 --- a/pages/superchain/blockspace-charter.mdx +++ b/pages/superchain/blockspace-charter.mdx @@ -18,13 +18,13 @@ The components work in unison to form a cohesive governance and technical framew * **Blockspace Charters:** A type of framework that establishes criteria, governing policies, and precommitments for blockspace in the Optimism ecosystem, ensuring security, uptime, and alignment with the [Law of Chains](https://github.com/ethereum-optimism/OPerating-manual/blob/main/Law%20of%20Chains.md). * **Standard Rollup Charter:** The Standard Rollup Charter is the first blockspace charter, defining the technical and governance requirements for our highest-security blockspace. By adhering to the Standard Rollup Charter, chains can achieve "Standard" status, ensuring consistency, high security, and operational reliability. -* **Superchain Registry:** The Superchain Registry is an index of chains which serves as the source of truth for who's in the Superchain ecosystem and the chain's configuration. The registry checks for compliance with the Standard Rollup Charter. Chains with set as `superchain_level = 1` meet all the criteria to be classified as a Standard Rollup. +* **Superchain Registry:** The Superchain Registry is an index of chains which serves as the source of truth for who's in the Superchain ecosystem and the chain's configuration. The registry checks for compliance with the Standard Rollup Charter. Chains with set as `superchain_level = 1` meet all the criteria to be classified as a Standard Rollup. Together, these components ensure a robust, scalable, and transparent ecosystem. Blockspace Charters provides the vision and principles, the Standard Rollup Charter translates these into concrete requirements, and the Superchain Registry certifies compliance. ## Blockspace Charters -Blockspace Charters outline the foundational framework for governing blockspace within the Optimism ecosystem. +Blockspace Charters outline the foundational framework for governing blockspace within the Optimism ecosystem. They are structured around three main components, detailed below: @@ -55,14 +55,13 @@ By defining these components, blockspace charters ensures secure, scalable, and ### Criteria governance -The criteria for Blockspace Charters are set in two ways; either by a governance vote or by the Optimism Foundation. +The criteria for Blockspace Charters are set in two ways; either by a governance vote or by the Optimism Foundation. * **Governance controlled**: The three `TOML` files referenced in the charter (standard config params, standard config roles, and standard versions) require a governance vote to alter. Changes to the files require a governance vote, but changes to code or tools that consume or validate them don't "so long as they do not violate the semantic interpretation of those TOML files." -* **Foundation discretion**: Changes to validation, outside of the three TOML files referenced above, remain at the Foundation’s discretion. This includes changes to, but is not limited to, BHIC, other config checks, and RPC availability. +* **Foundation discretion**: Changes to validation, outside of the three TOML files referenced above, remain at the Foundation's discretion. This includes changes to, but is not limited to, `BHIC`, other config checks, and RPC availability. Read more about Blockspace Charters in the [governance post](https://gov.optimism.io/t/season-6-introducing-blockspace-charters-superchain-first-governance/8133). - ## The Standard Rollup Charter The Standard Rollup Charter is the blockspace charter that defines the requirements for being a standard chain, our highest-security flagship blockspace. The Standard Rollup Charter ensures that chains adhere to the technical and operational benchmarks necessary to maintain the highest standards of security, compatibility, and compliance in the Superchain. @@ -110,4 +109,4 @@ The Superchain Registry serves as the source of truth for who's in the Superchai * **Validates version and configuration:** The registry validates that chains align with governance-approved standards in the form the The Standard Rollup Charter. * **Indicates adherence to the Standard Rollup Charter:** Once the registry validates that a chain meets the standard criteria, it promotes it to "Standard" by setting its `superchain_level` value to `1`. -By integrating with the Standard Rollup Charter, the registry offers an automated and transparent validation system. This ensures chains can independently demonstrate compliance. For additional details, refer to the [Superchain Registry documentation](/superchain/superchain-registry). \ No newline at end of file +By integrating with the Standard Rollup Charter, the registry offers an automated and transparent validation system. This ensures chains can independently demonstrate compliance. For additional details, refer to the [Superchain Registry documentation](/superchain/superchain-registry). diff --git a/pages/superchain/superchain-registry.mdx b/pages/superchain/superchain-registry.mdx index fea004f2a..e242e11ca 100644 --- a/pages/superchain/superchain-registry.mdx +++ b/pages/superchain/superchain-registry.mdx @@ -18,7 +18,7 @@ The Superchain Registry serves as the source of truth for who's in the Superchai An OP Stack Standard Rollup meets the set of requirements to be a member of the Superchain. -All chains must meet this config to meet the inclusion requirements for The Superchain. This configuration targets the Optimism Collective’s highest bar for security, uptime, and decentralization. +All chains must meet this config to meet the inclusion requirements for The Superchain. This configuration targets the Optimism Collective's highest bar for security, uptime, and decentralization. You can find more details in the [Standard Rollup Charter documentation](/superchain/blockspace-charter). From 935bf1e8c32056a2b56c3221d1a3aaab11c15cd8 Mon Sep 17 00:00:00 2001 From: Bradley Camacho <42678939+bradleycamacho@users.noreply.github.com> Date: Mon, 23 Dec 2024 13:26:05 -0800 Subject: [PATCH 15/17] Add TOML file links --- pages/superchain/blockspace-charter.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/superchain/blockspace-charter.mdx b/pages/superchain/blockspace-charter.mdx index 20cd459ed..bed97cde5 100644 --- a/pages/superchain/blockspace-charter.mdx +++ b/pages/superchain/blockspace-charter.mdx @@ -57,7 +57,7 @@ By defining these components, blockspace charters ensures secure, scalable, and The criteria for Blockspace Charters are set in two ways; either by a governance vote or by the Optimism Foundation. -* **Governance controlled**: The three `TOML` files referenced in the charter (standard config params, standard config roles, and standard versions) require a governance vote to alter. Changes to the files require a governance vote, but changes to code or tools that consume or validate them don't "so long as they do not violate the semantic interpretation of those TOML files." +* **Governance controlled**: The three `TOML` files referenced in the charter ([standard config params](https://github.com/ethereum-optimism/superchain-registry/blob/main/validation/standard/standard-config-params-mainnet.toml), [standard config roles](https://github.com/ethereum-optimism/superchain-registry/blob/main/validation/standard/standard-config-roles-mainnet.toml), and [standard versions](https://github.com/ethereum-optimism/superchain-registry/blob/main/validation/standard/standard-versions-mainnet.toml)) require a governance vote to alter. Changes to the files require a governance vote, but changes to code or tools that consume or validate them don't "so long as they do not violate the semantic interpretation of those TOML files." * **Foundation discretion**: Changes to validation, outside of the three TOML files referenced above, remain at the Foundation's discretion. This includes changes to, but is not limited to, `BHIC`, other config checks, and RPC availability. Read more about Blockspace Charters in the [governance post](https://gov.optimism.io/t/season-6-introducing-blockspace-charters-superchain-first-governance/8133). From b416fbe2e79be7ddcda994d898de2b793c33667d Mon Sep 17 00:00:00 2001 From: Bradley Camacho <42678939+bradleycamacho@users.noreply.github.com> Date: Mon, 23 Dec 2024 13:28:04 -0800 Subject: [PATCH 16/17] Apply suggestions from code review Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com> --- pages/superchain/blockspace-charter.mdx | 6 +++--- pages/superchain/superchain-registry.mdx | 4 ++-- public/_redirects | 1 - 3 files changed, 5 insertions(+), 6 deletions(-) diff --git a/pages/superchain/blockspace-charter.mdx b/pages/superchain/blockspace-charter.mdx index bed97cde5..df41951aa 100644 --- a/pages/superchain/blockspace-charter.mdx +++ b/pages/superchain/blockspace-charter.mdx @@ -18,9 +18,9 @@ The components work in unison to form a cohesive governance and technical framew * **Blockspace Charters:** A type of framework that establishes criteria, governing policies, and precommitments for blockspace in the Optimism ecosystem, ensuring security, uptime, and alignment with the [Law of Chains](https://github.com/ethereum-optimism/OPerating-manual/blob/main/Law%20of%20Chains.md). * **Standard Rollup Charter:** The Standard Rollup Charter is the first blockspace charter, defining the technical and governance requirements for our highest-security blockspace. By adhering to the Standard Rollup Charter, chains can achieve "Standard" status, ensuring consistency, high security, and operational reliability. -* **Superchain Registry:** The Superchain Registry is an index of chains which serves as the source of truth for who's in the Superchain ecosystem and the chain's configuration. The registry checks for compliance with the Standard Rollup Charter. Chains with set as `superchain_level = 1` meet all the criteria to be classified as a Standard Rollup. +* **Superchain Registry:** The Superchain Registry is an index of chains which serves as the source of truth for who's in the Superchain ecosystem and the chain's configuration. The registry checks for compliance with the Standard Rollup Charter. Chains with `superchain_level = 1` meet all the criteria to be classified as a Standard Rollup. -Together, these components ensure a robust, scalable, and transparent ecosystem. Blockspace Charters provides the vision and principles, the Standard Rollup Charter translates these into concrete requirements, and the Superchain Registry certifies compliance. +Together, these components ensure a robust, scalable, and transparent ecosystem. Blockspace Charters provide the vision and principles, the Standard Rollup Charter translates these into concrete requirements, and the Superchain Registry certifies compliance. ## Blockspace Charters @@ -106,7 +106,7 @@ Chains must meet strict requirements to qualify as "Standard." Below are answers The Superchain Registry serves as the source of truth for who's in the Superchain Ecosystem and what modifications they've made. The Superchain Registry has two main tasks: -* **Validates version and configuration:** The registry validates that chains align with governance-approved standards in the form the The Standard Rollup Charter. +* **Validates version and configuration:** The registry validates that chains align with governance-approved standards in the form of the Standard Rollup Charter. * **Indicates adherence to the Standard Rollup Charter:** Once the registry validates that a chain meets the standard criteria, it promotes it to "Standard" by setting its `superchain_level` value to `1`. By integrating with the Standard Rollup Charter, the registry offers an automated and transparent validation system. This ensures chains can independently demonstrate compliance. For additional details, refer to the [Superchain Registry documentation](/superchain/superchain-registry). diff --git a/pages/superchain/superchain-registry.mdx b/pages/superchain/superchain-registry.mdx index e242e11ca..a11896e44 100644 --- a/pages/superchain/superchain-registry.mdx +++ b/pages/superchain/superchain-registry.mdx @@ -12,7 +12,7 @@ The Superchain Registry serves as the source of truth for who's in the Superchai * A step-by-step process new chains can follow to join the registry * Validation checks to ensure standard chains comply with the Standard Rollup Charter and non-standard chains pass baseline validation before joining the Superchain Registry -* A Superchain Registry repository that shows who's in the registry and the chain's configuration. Chains with set as `superchain_level = 1` meet all the criteria to be classified as a Standard Rollup. +* A Superchain Registry repository that shows who's in the registry and the chain's configuration. Chains with `superchain_level = 1` meet all the criteria to be classified as a Standard Rollup. ## The Standard Rollup @@ -28,4 +28,4 @@ You can find more details in the [Standard Rollup Charter documentation](/superc ## Joining the registry -All Superchain Ecosystem members are welcome to join the Superchain Registry, regardless of whether they adhere to the standard rollup charter to not. To join the Registry, [follow the steps in this guide](https://github.com/ethereum-optimism/superchain-registry/blob/main/docs/add-chain.md) to submit a pull request and join the Superchain Ecosystem. This guide will help you set up your chain, create your environment, and run all the validation checks needed to ensure your chain is ready to join the Registry. +All Superchain Ecosystem members are welcome to join the Superchain Registry, regardless of whether they adhere to the standard rollup charter or not. To join the Registry, [follow the steps in this guide](https://github.com/ethereum-optimism/superchain-registry/blob/main/docs/add-chain.md) to submit a pull request and join the Superchain Ecosystem. This guide will help you set up your chain, create your environment, and run all the validation checks needed to ensure your chain is ready to join the Registry. diff --git a/public/_redirects b/public/_redirects index 26d9dc1d1..753e33de4 100644 --- a/public/_redirects +++ b/public/_redirects @@ -117,5 +117,4 @@ /stack/interop/transfer-superchainERC20 /stack/interop/assets/transfer-superchainERC20 /builders/app-developers/contracts/superchain-erc20 /stack/interop/assets/superchain-erc20 /builders/chain-operators/tutorials/sdk /builders/app-developers/overview -/builders/chain-operators/tutorials/sdk /builders/app-developers/overview /stack/explainer /superchain/superchain-explainer \ No newline at end of file From 2598e1c6ff98ba4ff681e9e2c97c18388e1cb9f6 Mon Sep 17 00:00:00 2001 From: soyboy <85043086+sbvegan@users.noreply.github.com> Date: Mon, 23 Dec 2024 16:29:49 -0800 Subject: [PATCH 17/17] Apply suggestions from code review Co-authored-by: Tess Rinearson --- pages/superchain/_meta.json | 2 +- pages/superchain/blockspace-charter.mdx | 6 +++--- pages/superchain/superchain-registry.mdx | 14 +++++++------- 3 files changed, 11 insertions(+), 11 deletions(-) diff --git a/pages/superchain/_meta.json b/pages/superchain/_meta.json index 23dc0134d..8fcebc30b 100644 --- a/pages/superchain/_meta.json +++ b/pages/superchain/_meta.json @@ -1,5 +1,5 @@ { "superchain-explainer": "The Superchain explainer", "superchain-registry": "The Superchain Registry", - "blockspace-charter": "Blockspace and Standard charters" + "blockspace-charter": "Blockspace Charters and the Standard Rollup Charter" } diff --git a/pages/superchain/blockspace-charter.mdx b/pages/superchain/blockspace-charter.mdx index df41951aa..2ab883847 100644 --- a/pages/superchain/blockspace-charter.mdx +++ b/pages/superchain/blockspace-charter.mdx @@ -1,7 +1,7 @@ --- title: Blockspace and Standard Rollup Charters lang: en-US -description: Learn about Blockspace charters, the Standard Rollup charter, and the Superchain Registry. +description: Learn about Blockspace Charters, the Standard Rollup Charter, and the Superchain Registry. --- # The Blockspace and Standard Rollup charters @@ -75,7 +75,7 @@ Here are some specific criteria a chain must meet: * **Version validation:** Chains must deploy a governance-approved, up-to-date OP Stack release. Contracts must match the [standard bytecode](https://github.com/ethereum-optimism/superchain-registry/blob/main/validation/standard/standard-versions-mainnet.toml). * **Configuration checks:** Chain parameters, such as block time and gas metering, must comply with governance-approved specifications. Administrative roles must align with Security Council requirements. -Read more about onchain checks in the [repo](https://github.com/ethereum-optimism/OPerating-manual/blob/feat/standard-rollup-charter/Standard%20Rollup%20Charter.md#onchain-criteria) and about configurations required by the Blockspace Charter in the three TOML files above and the Optimism Foundation [here.](https://specs.optimism.io/protocol/configurability.html) +Read more about onchain checks in the [repo](https://github.com/ethereum-optimism/OPerating-manual/blob/feat/standard-rollup-charter/Standard%20Rollup%20Charter.md#onchain-criteria). ### Off-chain criteria @@ -91,7 +91,7 @@ Read more about Off-Chain checks in the [repo](https://github.com/ethereum-optim ### History integrity -The history integrity check identifies discrepancies in chain history, including invalid state transitions. These checks are only required for chains that have not been managed by the Optimism Security Council initially. +The history integrity check identifies discrepancies in chain history, including invalid state transitions. These checks are only required for chains that have not been managed by the Optimism Security Council from launch. ### Understanding chain compliance diff --git a/pages/superchain/superchain-registry.mdx b/pages/superchain/superchain-registry.mdx index a11896e44..e808ab4d7 100644 --- a/pages/superchain/superchain-registry.mdx +++ b/pages/superchain/superchain-registry.mdx @@ -1,7 +1,7 @@ --- title: The Superchain Registry lang: en-US -description: Learn about Optimism Superchain components, features, and roadmap. +description: Learn about the members of the Optimism Superchain ecosystem. --- import { Callout } from 'nextra/components' @@ -10,22 +10,22 @@ import { Callout } from 'nextra/components' The Superchain Registry serves as the source of truth for who's in the Superchain Ecosystem and what modifications they've made. The Superchain Registry introduces: -* A step-by-step process new chains can follow to join the registry +* A step-by-step process new chains can follow to join the Registry * Validation checks to ensure standard chains comply with the Standard Rollup Charter and non-standard chains pass baseline validation before joining the Superchain Registry -* A Superchain Registry repository that shows who's in the registry and the chain's configuration. Chains with `superchain_level = 1` meet all the criteria to be classified as a Standard Rollup. +* A Superchain Registry repository that shows who's in the registry and the chain's configuration. Chains with `superchain_level = 1` have proven that they follow the Standard Rollup Charter, and can be classified as a Standard Rollup. ## The Standard Rollup -An OP Stack Standard Rollup meets the set of requirements to be a member of the Superchain. +An OP Stack Standard Rollup follows the Standard Rollup Charter. -All chains must meet this config to meet the inclusion requirements for The Superchain. This configuration targets the Optimism Collective's highest bar for security, uptime, and decentralization. +This configuration targets the Optimism Collective's highest bar for security, uptime, and decentralization. You can find more details in the [Standard Rollup Charter documentation](/superchain/blockspace-charter). - We recommend using the [op-deployer](/builders/chain-operators/tools/op-deployer) to deploy L1 contracts and generate the L2 genesis file that meet the configuration requirements outlined in the [Standard Rollup Charter](/superchain/blockspace-charter). + We **strongly** recommend using the [op-deployer](/builders/chain-operators/tools/op-deployer) to deploy L1 contracts and generate the L2 genesis file that meet the configuration requirements outlined in the [Standard Rollup Charter](/superchain/blockspace-charter). -## Joining the registry +## Joining the Registry All Superchain Ecosystem members are welcome to join the Superchain Registry, regardless of whether they adhere to the standard rollup charter or not. To join the Registry, [follow the steps in this guide](https://github.com/ethereum-optimism/superchain-registry/blob/main/docs/add-chain.md) to submit a pull request and join the Superchain Ecosystem. This guide will help you set up your chain, create your environment, and run all the validation checks needed to ensure your chain is ready to join the Registry.