docs Audit of message passing tutorial

Description

Bring it in line with the standards for other interop tutorials.
Create a separate tutorial for manual relay (which will be needed rarely, if at all).

Tests

None, but I did make sure everything runs.

Additional context

N/A

Metadata

Replacing #1581

May 20 '25 00:05 qbzzt

Deploy Preview for docs-optimism ready!

Built without sensitive environment variables

Name	Link
Latest commit	75b1c8d6f276ba830a479454c2c551cc74041b30
Latest deploy log	https://app.netlify.com/projects/docs-optimism/deploys/6837349a4948c60008ce8679
Deploy Preview	https://deploy-preview-1616--docs-optimism.netlify.app
Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

May 20 '25 00:05 netlify[bot]

📝 Walkthrough

## Walkthrough

The changes restructure and clarify the message-passing tutorials for cross-chain communication. Two relay tutorial entries ("relay-messages-cast" and "relay-messages-viem") were removed from the main tutorials metadata. The primary message-passing tutorial was reorganized for clarity, with improved prerequisite and network setup sections, standardized environment variable usage, and clearer distinctions between Supersim and Devnet environments. The Solidity contract examples were updated for correct imports and interface usage. The manual relay tutorial was expanded to include both shell script (`cast`) and JavaScript API relay methods, with detailed setup and code instructions. Supporting scripts and contract files were updated for consistency, and unused or redundant files were removed or refactored.

## Sequence Diagram(s)

### Manual Cross-Chain Message Relay (New Flow)

```mermaid
sequenceDiagram
    participant User
    participant ChainA (L2A)
    participant ChainB (L2B)
    participant ManualRelayScript

    User->>ChainA (L2A): Send setGreeting via GreetingSender
    ChainA (L2A)-->>User: Transaction receipt (message sent)
    User->>ManualRelayScript: Run relay script (cast or JS)
    ManualRelayScript->>ChainA (L2A): Fetch message from outbox
    ManualRelayScript->>ChainB (L2B): Relay message to Greeter contract
    ChainB (L2B)-->>ManualRelayScript: Transaction receipt (greeting updated)
    ManualRelayScript-->>User: Print updated greeting

Comparison: Old vs. New Tutorial Flow

sequenceDiagram
    participant User
    participant ChainA (L2A)
    participant ChainB (L2B)
    participant ViemScript
    participant ManualRelayScript

    %% Old flow with viem (deleted)
    User->>ViemScript: Run viem relay script
    ViemScript->>ChainA (L2A): Send setGreeting via GreetingSender
    ViemScript->>ChainB (L2B): setGreeting directly
    ChainB (L2B)-->>ViemScript: Read greeting

    %% New flow (manual relay)
    User->>ChainA (L2A): Send setGreeting via GreetingSender
    ChainA (L2A)-->>User: Transaction receipt
    User->>ManualRelayScript: Run relay script (cast or JS)
    ManualRelayScript->>ChainA (L2A): Fetch message from outbox
    ManualRelayScript->>ChainB (L2B): Relay message to Greeter contract
    ChainB (L2B)-->>ManualRelayScript: Transaction receipt

Possibly related PRs

ethereum-optimism/docs#1589: Removes "relay-messages-cast" and "relay-messages-viem" tutorials and restructures the message-passing tutorial, closely related to the current tutorial content removal and reorganization.
ethereum-optimism/docs#1367: Adds a cross-domain event and expands manual relay instructions in the message-passing tutorial, modifying the same tutorial content that this PR removes or restructures.
ethereum-optimism/docs#1334: Introduces the original interop message-passing tutorial with cross-domain messaging logic, which this PR subsequently modifies and streamlines.

Suggested reviewers

krofax
zainbacchus


</details>

<!-- walkthrough_end -->


---

<details>
<summary>📜 Recent review details</summary>

**Configuration used: .coderabbit.yaml**
**Review profile: CHILL**
**Plan: Pro**


<details>
<summary>📥 Commits</summary>

Reviewing files that changed from the base of the PR and between 107118a75c465aa3ca5649d601737e82d97dbca3 and 75b1c8d6f276ba830a479454c2c551cc74041b30.

</details>

<details>
<summary>📒 Files selected for processing (1)</summary>

* `words.txt` (1 hunks)

</details>

<details>
<summary>🧰 Additional context used</summary>

<details>
<summary>🪛 LanguageTool</summary>

<details>
<summary>words.txt</summary>

[duplication] ~97-~97: Možný preklep: zopakovali ste slovo
Context: ...adir DATADIR devs devdocs Devnet devnet devnets Devnets direnv disabletxpoolgossip DISABLETXPOO...

(WORD_REPEAT_RULE)

</details>

</details>

</details>

<details>
<summary>⏰ Context from checks skipped due to timeout of 90000ms (3)</summary>

* GitHub Check: Redirect rules - docs-optimism
* GitHub Check: Header rules - docs-optimism
* GitHub Check: Pages changed - docs-optimism

</details>

<details>
<summary>🔇 Additional comments (1)</summary><blockquote>

<details>
<summary>words.txt (1)</summary>

`96-99`: **Inconsistent entry ordering relative to established pattern**  
The `Devnet` entry has been placed before its lowercase counterpart (`devnet`), which deviates from the file’s standard convention of listing lowercase singular, uppercase singular, lowercase plural, uppercase plural (e.g., `alphanet`, `Alphanet`, `alphanets`, `Alphanets`). Please confirm whether this swap is intentional or revert to maintain consistency across the list.

<details>
<summary>🧰 Tools</summary>

<details>
<summary>🪛 LanguageTool</summary>

[duplication] ~97-~97: Možný preklep: zopakovali ste slovo
Context: ...adir DATADIR devs devdocs Devnet devnet devnets Devnets direnv disabletxpoolgossip DISABLETXPOO...

(WORD_REPEAT_RULE)

</details>

</details>

</details>

</blockquote></details>

</details>
<!-- internal state start -->


<!-- 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 -->

<!-- internal state end -->
<!-- tips_start -->

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

<details>
<summary>❤️ Share</summary>

- [X](https://twitter.com/intent/tweet?text=I%20just%20used%20%40coderabbitai%20for%20my%20code%20review%2C%20and%20it%27s%20fantastic%21%20It%27s%20free%20for%20OSS%20and%20offers%20a%20free%20trial%20for%20the%20proprietary%20code.%20Check%20it%20out%3A&url=https%3A//coderabbit.ai)
- [Mastodon](https://mastodon.social/share?text=I%20just%20used%20%40coderabbitai%20for%20my%20code%20review%2C%20and%20it%27s%20fantastic%21%20It%27s%20free%20for%20OSS%20and%20offers%20a%20free%20trial%20for%20the%20proprietary%20code.%20Check%20it%20out%3A%20https%3A%2F%2Fcoderabbit.ai)
- [Reddit](https://www.reddit.com/submit?title=Great%20tool%20for%20code%20review%20-%20CodeRabbit&text=I%20just%20used%20CodeRabbit%20for%20my%20code%20review%2C%20and%20it%27s%20fantastic%21%20It%27s%20free%20for%20OSS%20and%20offers%20a%20free%20trial%20for%20proprietary%20code.%20Check%20it%20out%3A%20https%3A//coderabbit.ai)
- [LinkedIn](https://www.linkedin.com/sharing/share-offsite/?url=https%3A%2F%2Fcoderabbit.ai&mini=true&title=Great%20tool%20for%20code%20review%20-%20CodeRabbit&summary=I%20just%20used%20CodeRabbit%20for%20my%20code%20review%2C%20and%20it%27s%20fantastic%21%20It%27s%20free%20for%20OSS%20and%20offers%20a%20free%20trial%20for%20proprietary%20code)

</details>

<details>
<summary>🪧 Tips</summary>

### Chat

There are 3 ways to chat with [CodeRabbit](https://coderabbit.ai?utm_source=oss&utm_medium=github&utm_campaign=ethereum-optimism/docs&utm_content=1616):

- Review comments: Directly reply to a review comment made by CodeRabbit. Example:
  - `I pushed a fix in commit <commit_id>, please review it.`
  - `Explain this complex logic.`
  - `Open a follow-up GitHub issue for this discussion.`
- Files and specific lines of code (under the "Files changed" tab): Tag `@coderabbitai` in a new review comment at the desired location with your query. Examples:
  - `@coderabbitai explain this code block.`
  -	`@coderabbitai modularize this function.`
- PR comments: Tag `@coderabbitai` in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
  - `@coderabbitai gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.`
  - `@coderabbitai read src/utils.ts and explain its main purpose.`
  - `@coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.`
  - `@coderabbitai help me debug CodeRabbit configuration file.`

### Support

Need help? Create a ticket on our [support page](https://www.coderabbit.ai/contact-us/support) for assistance with any issues or questions.

Note: Be mindful of the bot's finite context window. It's strongly recommended to break down tasks such as reading entire modules into smaller chunks. For a focused discussion, use review comments to chat about specific files and their changes, instead of using the PR comments.

### CodeRabbit Commands (Invoked using PR comments)

- `@coderabbitai pause` to pause the reviews on a PR.
- `@coderabbitai resume` to resume the paused reviews.
- `@coderabbitai review` to trigger an incremental review. This is useful when automatic reviews are disabled for the repository.
- `@coderabbitai full review` to do a full review from scratch and review all the files again.
- `@coderabbitai summary` to regenerate the summary of the PR.
- `@coderabbitai generate docstrings` to [generate docstrings](https://docs.coderabbit.ai/finishing-touches/docstrings) for this PR.
- `@coderabbitai generate sequence diagram` to generate a sequence diagram of the changes in this PR.
- `@coderabbitai resolve` resolve all the CodeRabbit review comments.
- `@coderabbitai configuration` to show the current CodeRabbit configuration for the repository.
- `@coderabbitai help` to get help.

### Other keywords and placeholders

- Add `@coderabbitai ignore` anywhere in the PR description to prevent this PR from being reviewed.
- Add `@coderabbitai summary` to generate the high-level summary at a specific location in the PR description.
- Add `@coderabbitai` anywhere in the PR title to generate the title automatically.

### Documentation and Community

- Visit our [Documentation](https://docs.coderabbit.ai) for detailed information on how to use CodeRabbit.
- Join our [Discord Community](http://discord.gg/coderabbit) to get help, request features, and share feedback.
- Follow us on [X/Twitter](https://twitter.com/coderabbitai) for updates and announcements.

</details>

<!-- tips_end -->

May 20 '25 00:05 coderabbitai[bot]

The section is very unclear, typically the structure should be;

the script:

The output/response from the script:

Then an explanation of the output. Right now we have the script, the header title, i.e explanation of the script's "capacity", rather than explanation of the output of the script.

Maybe move the output of the script above, "What does the script do?" header, or even change that to just "Explanation"(this doesn't matter much).

Maybe using steps here might make it clearer what's going on, i.e before every cast command you have a bullet point header/text, followed by the cast command, and the explanation.

Rewritten. I don't show the script output because it's not very relevant - but I do explain the script and what it does now.

May 24 '25 19:05 qbzzt

LGTM, Approved! When you fix the conflict let me know, so i can merge. @qbzzt

May 28 '25 15:05 krofax

docs docs copied to clipboard

Audit of message passing tutorial

✅ Deploy Preview for docs-optimism ready!

Comparison: Old vs. New Tutorial Flow

Possibly related PRs

Suggested reviewers

docs
docs copied to clipboard

Deploy Preview for docs-optimism ready!