From c6331fe2cb4f270b74c23bf058f7530c24ae451e Mon Sep 17 00:00:00 2001 From: David <165518730+Red-Pandaz@users.noreply.github.com> Date: Wed, 15 Jan 2025 16:25:47 -0600 Subject: [PATCH 1/8] Small grammatical fixes to op-supervisor.mdx --- pages/stack/interop/op-supervisor.mdx | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/pages/stack/interop/op-supervisor.mdx b/pages/stack/interop/op-supervisor.mdx index 7afafb83b..3382811fe 100644 --- a/pages/stack/interop/op-supervisor.mdx +++ b/pages/stack/interop/op-supervisor.mdx @@ -33,7 +33,7 @@ OP Supervisor verifies messages between different chains in the OP Stack, reduci ## Log data indexing and management -OP Supervisor acts as a hub for indexing data that every `op-node` needs to cross-verify with other chains, centralizing the process of managing interoperability data. Maintains the integrity of cross-chain interactions by tracking safety changes⁠ across the Superchain, ensuring consistent application of invalid dependency resolutions. ⁠ +OP Supervisor acts as a hub for indexing data that every `op-node` needs to cross-verify with other chains, centralizing the process of managing interoperability data. It maintains the integrity of cross-chain interactions by tracking safety changes⁠ across the Superchain, ensuring consistent application of invalid dependency resolutions. ⁠ `op-supervisor` indexes two types of cross-chain dependencies: @@ -46,11 +46,11 @@ OP Supervisor provides an interface for `op-node` to query cross-chain safety in Key API methods include: -| Method | Description | +| Method(s) | Description | | ----------------------------------------- | ------------------------------------------------------------------------------------- | -| `UnsafeView` and `SafeView` | Returns the Local and Cross heads for their respective levels | +| `UnsafeView` and `SafeView` | Return the Local and Cross heads for their respective levels | | `DerivedFrom` | OP Nodes use to check the L1 source of the Supervisor (needed for Safe Head tracking) | -| `UpdateLocalSafe` and `UpdateLocalUnsafe` | Tells the Supervisor when the Node's heads change | +| `UpdateLocalSafe` and `UpdateLocalUnsafe` | Tell the Supervisor when the Node's heads change | | `Finalized` | Returns the Finalized Head | | `UpdateFinalizedL1` | Signals to the Supervisor new finality signals | | `CheckMessage` | Checks logs in the DB directly in tests | From 40c77e5b0efda4d0bc55f9259b9bea11d19ec4f4 Mon Sep 17 00:00:00 2001 From: David <165518730+Red-Pandaz@users.noreply.github.com> Date: Wed, 15 Jan 2025 16:26:52 -0600 Subject: [PATCH 2/8] Rearrange link cards in assets.mdx to match the sequence of the navbar --- pages/stack/interop/assets.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/pages/stack/interop/assets.mdx b/pages/stack/interop/assets.mdx index 4d287b5f9..87950ceb6 100644 --- a/pages/stack/interop/assets.mdx +++ b/pages/stack/interop/assets.mdx @@ -13,11 +13,11 @@ Documentation covering SuperchainERC20, Superchain WETH, Supersim, and how to tr - - + + From ff7c6b385d1cbef55359d54d071ec5ec28c51fb6 Mon Sep 17 00:00:00 2001 From: David <165518730+Red-Pandaz@users.noreply.github.com> Date: Wed, 15 Jan 2025 18:11:19 -0600 Subject: [PATCH 3/8] Clarify PREVRANDAO description to specify pseudorandomness --- pages/stack/differences.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/stack/differences.mdx b/pages/stack/differences.mdx index 5f370f4b0..0e5fb4120 100644 --- a/pages/stack/differences.mdx +++ b/pages/stack/differences.mdx @@ -27,7 +27,7 @@ Withdrawal transactions are how the state of the L2 rollup can be proven to the | Opcode | Solidity Equivalent | Behavior | | ------------ | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `COINBASE` | `block.coinbase` | Returns the address of the current Sequencer's fee wallet. Effectively the same as Ethereum with the caveat that the value typically does not change from block to block. | -| `PREVRANDAO` | `block.prevrandao` | Set **pseudorandomly** for each block by the Sequencer as opposed to the stronger guarantees provided by [RANDAO](https://eips.ethereum.org/EIPS/eip-4399) on Ethereum. | +| `PREVRANDAO` | `block.prevrandao` | Set **pseudorandomness** for each block by the Sequencer as opposed to the stronger guarantees provided by [RANDAO](https://eips.ethereum.org/EIPS/eip-4399) on Ethereum. | | `ORIGIN` | `tx.origin` | If the transaction is an L1 ⇒ L2 transaction triggered by a smart contract on L1, then `tx.origin` is set to the [aliased address](#address-aliasing) of the address that triggered the L1 ⇒ L2 transaction. Otherwise, this opcode behaves normally. | | `CALLER` | `msg.sender` | If the transaction is an L1 ⇒ L2 transaction triggered by a smart contract on L1, and this is the first call frame (rather than an internal transaction from one contract to another), the same [address aliasing](#address-aliasing) behavior applies. | From a9ab3a7c9c63a5c8f49e0352a8b85ea6e250cc4d Mon Sep 17 00:00:00 2001 From: David <165518730+Red-Pandaz@users.noreply.github.com> Date: Wed, 15 Jan 2025 20:00:50 -0600 Subject: [PATCH 4/8] Remove unnecessary character --- pages/stack/smart-contracts.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/stack/smart-contracts.mdx b/pages/stack/smart-contracts.mdx index 07b18dd2b..6bf906f13 100644 --- a/pages/stack/smart-contracts.mdx +++ b/pages/stack/smart-contracts.mdx @@ -79,7 +79,7 @@ of 13 owners. This meets the 75% threshold requirement for a Stage 1 rollup outlined in [L2Beat's Stages framework](https://medium.com/l2beat/stages-update-security-council-requirements-4c79cea8ef52) 2. Reassigning the role of Guardian from the Foundation to a new Guardian Safe with the Security Council Safe as its sole owner. This moves the Superchain -closer to satisfying the 1 week exit window 5 requirement for Stage 1. +closer to satisfying the 1 week exit window requirement for Stage 1. * Additionally the Foundation is appointed to the new DeputyGuardian role which is able to act as Guardian through the Guardian Safe. This appointment can be revoked by the Security Council Safe at any time. From ce2e4a46b0257134102ae88ece148026cc7db7e6 Mon Sep 17 00:00:00 2001 From: David <165518730+Red-Pandaz@users.noreply.github.com> Date: Wed, 15 Jan 2025 20:07:18 -0600 Subject: [PATCH 5/8] Remove unnecessary word --- pages/stack/smart-contracts.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/stack/smart-contracts.mdx b/pages/stack/smart-contracts.mdx index 6bf906f13..ba91f376f 100644 --- a/pages/stack/smart-contracts.mdx +++ b/pages/stack/smart-contracts.mdx @@ -355,7 +355,7 @@ optionally halt if using the wrong version. #### SystemConfig -The `SystemConfig` contract is helps manage configuration of an OP Stack +The `SystemConfig` contract helps manage configuration of an OP Stack network. Much of the network's configuration is stored on L1 and picked up by L2 as part of the derivation of the L2 chain. The contract also contains references to all other contract addresses for the chain. From 6ad6a3ad25d75e650d9a4caf6a03cb2a0429a375 Mon Sep 17 00:00:00 2001 From: David <165518730+Red-Pandaz@users.noreply.github.com> Date: Wed, 15 Jan 2025 20:13:02 -0600 Subject: [PATCH 6/8] Add missing words --- pages/stack/smart-contracts.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/stack/smart-contracts.mdx b/pages/stack/smart-contracts.mdx index ba91f376f..d036fe68c 100644 --- a/pages/stack/smart-contracts.mdx +++ b/pages/stack/smart-contracts.mdx @@ -399,7 +399,7 @@ Architecture (ISA). #### PreimageOracle -The `PreimageOracle` contract for storing permissioned pre-images. +The `PreimageOracle` contract is used for storing permissioned pre-images. #### DEPRECATED - L2OutputOracle From 33979385b80210c908786a4215736cd5027194a0 Mon Sep 17 00:00:00 2001 From: David <165518730+Red-Pandaz@users.noreply.github.com> Date: Wed, 15 Jan 2025 21:35:40 -0600 Subject: [PATCH 7/8] Remove unnecessary character --- pages/stack/differences.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/stack/differences.mdx b/pages/stack/differences.mdx index 0e5fb4120..6976b0515 100644 --- a/pages/stack/differences.mdx +++ b/pages/stack/differences.mdx @@ -16,7 +16,7 @@ However, there are some minor differences between the behavior of Ethereum and O ### Bridging - Deposit Transactions -Deposit transactions don't exist on L1's, and are how transactions on an L2 can be initiated from the L1. Importantly, this is how bridge applications can get L1 ETH or tokens into an L2 OP Stack chain. You can read more on deposit transactions [here](/stack/transactions/deposit-flow). +Deposit transactions don't exist on L1s, and are how transactions on an L2 can be initiated from the L1. Importantly, this is how bridge applications can get L1 ETH or tokens into an L2 OP Stack chain. You can read more on deposit transactions [here](/stack/transactions/deposit-flow). ### Bridging - Withdrawal Transactions and Fault Proofs From d732a536f3c10fcf9cdebdf1839a467d8c30371b Mon Sep 17 00:00:00 2001 From: David <165518730+Red-Pandaz@users.noreply.github.com> Date: Wed, 15 Jan 2025 22:27:46 -0600 Subject: [PATCH 8/8] Add a more accurate definition of PREVRANDAO --- pages/stack/differences.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/stack/differences.mdx b/pages/stack/differences.mdx index 6976b0515..62060359f 100644 --- a/pages/stack/differences.mdx +++ b/pages/stack/differences.mdx @@ -27,7 +27,7 @@ Withdrawal transactions are how the state of the L2 rollup can be proven to the | Opcode | Solidity Equivalent | Behavior | | ------------ | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `COINBASE` | `block.coinbase` | Returns the address of the current Sequencer's fee wallet. Effectively the same as Ethereum with the caveat that the value typically does not change from block to block. | -| `PREVRANDAO` | `block.prevrandao` | Set **pseudorandomness** for each block by the Sequencer as opposed to the stronger guarantees provided by [RANDAO](https://eips.ethereum.org/EIPS/eip-4399) on Ethereum. | +| `PREVRANDAO` | `block.prevrandao` | Returns the PREVRENDAO (the most recent [RANDAO](https://eips.ethereum.org/EIPS/eip-4399)) value of L1 at the current L1 origin block. | | `ORIGIN` | `tx.origin` | If the transaction is an L1 ⇒ L2 transaction triggered by a smart contract on L1, then `tx.origin` is set to the [aliased address](#address-aliasing) of the address that triggered the L1 ⇒ L2 transaction. Otherwise, this opcode behaves normally. | | `CALLER` | `msg.sender` | If the transaction is an L1 ⇒ L2 transaction triggered by a smart contract on L1, and this is the first call frame (rather than an internal transaction from one contract to another), the same [address aliasing](#address-aliasing) behavior applies. |