Merge pull request #1578 from ethereum-optimism/sb/u15-docs-warning

adding custom genesis guidance

Author: sbvegan

pages/interop/tutorials/message-passing.mdx

@@ -119,7 +119,7 @@ For development purposes, we'll first use autorelay mode to handle message execu
   1.  In the directory where Supersim is installed, start it with autorelay.
 
       ```sh
-      supersim --interop.autorelay
+      ./supersim --interop.autorelay
       ```
 
       Supersim creates three `anvil` blockchains:
@@ -221,12 +221,24 @@ For development purposes, we'll first use autorelay mode to handle message execu
   4.  Install the Optimism Solidity libraries into the project.
 
       ```sh
-      forge install ethereum-optimism/optimism --no-commit
+      cd lib
+      npm install @eth-optimism/contracts-bedrock
+      cd ..
+      echo @eth-optimism/=lib/node_modules/@eth-optimism/ >> remappings.txt
       ```
 
-  5.  Create `src/GreetingSender.sol`.
+  5.  The [`@eth-optimism/contracts-bedrock`](https://www.npmjs.com/package/@eth-optimism/contracts-bedrock) library does not have the Interop Solidity code yet.
+      Run these commands to add it.
 
-      ```solidity file=<rootDir>/public/tutorials/GreetingSender.sol#L1-L28 hash=9ed77001810caf52bbaa94da8b0dc5c6
+      ```sh
+      mkdir -p lib/node_modules/@eth-optimism/contracts-bedrock/interfaces/L2
+      wget https://raw.githubusercontent.com/ethereum-optimism/optimism/refs/heads/develop/packages/contracts-bedrock/interfaces/L2/IL2ToL2CrossDomainMessenger.sol
+      mv IL2ToL2CrossDomainMessenger.sol lib/node_modules/@eth-optimism/contracts-bedrock/interfaces/L2
+      ```
+
+  6.  Create `src/GreetingSender.sol`.
+
+      ```solidity file=<rootDir>/public/tutorials/GreetingSender.sol#L1-L28 hash=75d197d1e1da112421785c2160f6a55a
       ```
 
   <details>
@@ -284,8 +296,8 @@ In this section we change `Greeter.sol` to emit a separate event in it receives
       //SPDX-License-Identifier: MIT
       pragma solidity ^0.8.0;
 
-      import { Predeploys } from "lib/optimism/packages/contracts-bedrock/src/libraries/Predeploys.sol";
-      import { IL2ToL2CrossDomainMessenger } from "lib/optimism/packages/contracts-bedrock/interfaces/L2/IL2ToL2CrossDomainMessenger.sol";    
+      import { Predeploys } from "@eth-optimism/contracts-bedrock/src/libraries/Predeploys.sol";
+      import { IL2ToL2CrossDomainMessenger } from "@eth-optimism/contracts-bedrock/interfaces/L2/IL2ToL2CrossDomainMessenger.sol";    
 
       contract Greeter {
 
@@ -505,29 +517,29 @@ In this section we change `Greeter.sol` to emit a separate event in it receives
   <details>
     <summary>Explanation</summary>
 
-    ```typescript file=<rootDir>/public/tutorials/app_v2.mts#L11 hash=fef2e60f0dbefba4d1e16f4d87800993
+    ```typescript file=<rootDir>/public/tutorials/app_v2.mts#L11-L15 hash=84fb4799b2fdd18785f691d602567145
     ```
 
     Import from the [`@eth-optimism/viem`](https://www.npmjs.com/package/@eth-optimism/viem) package.
 
-    ```typescript file=<rootDir>/public/tutorials/app_v2.mts#L18-L24 hash=ffa76edb1191121e15eb4286e16ad041
+    ```typescript file=<rootDir>/public/tutorials/app_v2.mts#L22-L28 hash=28c42407a1a01774f25ca78535d93c6e
     ```
 
     In addition to extending the wallets with [Viem public actions](https://viem.sh/docs/accounts/local#5-optional-extend-with-public-actions), extend with the OP-Stack actions, both the public ones and the ones that require an account.
 
-    ```typescript file=<rootDir>/public/tutorials/app_v2.mts#L55 hash=23aa6f24baeb5757130361f30c1b0e9c
+    ```typescript file=<rootDir>/public/tutorials/app_v2.mts#L59 hash=fc1aae397872717a3ed364930cdab9fc
     ```
 
     To relay a message we need the information in the receipt.
     Also, we need to wait until the transaction with the relayed message is actually part of a block.
 
-    ```typescript file=<rootDir>/public/tutorials/app_v2.mts#L57-L60 hash=8cc99e67ee36474c81183108531cb295
+    ```typescript file=<rootDir>/public/tutorials/app_v2.mts#L61-L63 hash=d45ebbc0d53dfbecbd8d357eb83e1b68
     ```
 
     A single transaction can send multiple messages.
     But here we know we sent just one, so we look for the first one in the list.
 
-    ```typescript file=<rootDir>/public/tutorials/app_v2.mts#L61-L68 hash=fa49aa2a099c57f3b86671a4c0414f31
+    ```typescript file=<rootDir>/public/tutorials/app_v2.mts#L64-L70 hash=079ffd3e6fdf4eff3653ee7a74078183
     ```
 
     Here we first send the relay message on chain B, and then wait for the receipt for it.
@@ -593,15 +605,13 @@ In this section we change `Greeter.sol` to emit a separate event in it receives
   To see what messages were relayed by a specific transaction you can use this code:
 
   ```typescript
-  const messages = await walletA.interop.getCrossDomainMessages({
-    logs: receiptRelay.logs,
-  })
-
-  console.log(messages)
-  const status = await walletB.interop.getCrossDomainMessageStatus({
-    message: messages[0],
-  })
-  console.log(status)
+  import { decodeRelayedL2ToL2Messages } from '@eth-optimism/viem'
+
+  const decodedRelays = decodeRelayedL2ToL2Messages(
+      {receipt: receiptRelay})
+
+  console.log(decodedRelays)
+  console.log(decodedRelays.successfulMessages[0].log)
   ```
 </Steps>
 

pages/interop/tutorials/transfer-superchainERC20.mdx

@@ -191,27 +191,27 @@ The tutorial uses these primary tools:
       <details>
         <summary>Explanation of `xfer-erc20.mts`</summary>
 
-        ```typescript file=<rootDir>/public/tutorials/xfer-erc20.mts#L75-L80 hash=b144852a4fa9ae45e79ec6f124e48e79
+        ```typescript file=<rootDir>/public/tutorials/xfer-erc20.mts#L79-L84 hash=5084a0cf4064dc7cfaf1cf0f88e1f2d1
         ```
 
         Use `@eth-optimism/viem`'s `walletActionsL2().sendSuperchainERC20` to send the `SuperchainERC20` tokens.
         Internally, this function calls [`SuperchainTokenBridge.sendERC20`](https://github.com/ethereum-optimism/optimism/blob/develop/packages/contracts-bedrock/src/L2/SuperchainTokenBridge.sol#L52-L78) to send the tokens.
 
         <AutorelayCallout />
 
-        ```typescript file=<rootDir>/public/tutorials/xfer-erc20.mts#L84-L86 hash=cab6e961b558f4f5a7b877062b1cfa45 
+        ```typescript file=<rootDir>/public/tutorials/xfer-erc20.mts#L88-L90 hash=b353aebabd92c4af52858461d18fe8cd 
         ```
 
         To relay a message, we need the information in the receipt.
         Also, we need to wait until the transaction with the relayed message is actually part of a block.
 
-        ```typescript file=<rootDir>/public/tutorials/xfer-erc20.mts#L88-L91 hash=e1445aa565f4aaff02a62365fb196ca8 
+        ```typescript file=<rootDir>/public/tutorials/xfer-erc20.mts#L92-L94 hash=47d2387a65e4a5f5dbfa98868c2c5abc 
         ```
 
         A single transaction can send multiple messages.
         But here we know we sent just one, so we look for the first one in the list.
 
-        ```typescript file=<rootDir>/public/tutorials/xfer-erc20.mts#L92-L96 hash=0a65e0138ab6954b863ebafacaa23c84 
+        ```typescript file=<rootDir>/public/tutorials/xfer-erc20.mts#L96-L99 hash=4cf177987a894a8cb58ae5a3e9d731e8 
         ```
 
         This is how you use `@eth-optimism/viem` to create an executing message.

pages/notices/upgrade-15.mdx

@@ -129,6 +129,10 @@ These following steps are necessary for every node operator:
     The override flag for op-node was missed and will be added in the mainnet release. If you utilize the override flags, please just set the activation time in the rollup configuration file. 
   </Callout>
 
+  <Callout type="warning">
+    If you use custom genesis chain configuration, you need to set the `pragueTime` to the same value as the `isthmusTime`. It is not automatically set, this happens by default for chains using the network flags and also when using the override flags.
+  </Callout>
+
   *   **Option 1:** Set the activation time in the `rollup.json` for `op-node`. You will still need to set the `override.isthmus` flag in `op-geth` if you use this option. Please note that the chain configuration file is subject to a stricter format and needs to contain the `chain_op_config` outlined in the `op-node/v1.11.0` [release notes](https://github.com/ethereum-optimism/optimism/releases/tag/op-node%2Fv1.11.0).
   *   **Option 2:** Set the activation time via overrides (CLI) in both `op-node` and `op-geth`. These will need to be set on `op-node` and `op-geth` for the sequencer and all other nodes.