This PR updates the bridge tutorial content and structure.#1980
Open
opfocus wants to merge 2 commits intoethereum-optimism:mintlifyfrom
Open
This PR updates the bridge tutorial content and structure.#1980opfocus wants to merge 2 commits intoethereum-optimism:mintlifyfrom
opfocus wants to merge 2 commits intoethereum-optimism:mintlifyfrom
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
This PR updates the bridge tutorial content and structure.
1. Tutorial Theme Update
Previous title:
Updated focus:
The tutorial now introduces Deposited Transactions and Withdrawals, and explains how to process these cross-domain transactions using Viem.
Rationale
Mismatch between title and implementation
Although the original tutorial was framed as “bridging ETH”, the example implementation did not use the
StandardBridge.Instead, it directly interacted with:
L2ToL1MessagePasserOptimismPortalProxyIn practice, most bridge UIs and production flows rely on the StandardBridge, so the tutorial approach was not representative of common ETH bridging workflows.
Lower impact of removing ETH bridge focus
Bridging ETH is simpler compared to bridging ERC-20 tokens.
Adjusting the tutorial focus has minimal impact on overall learning coverage.
Highlighting foundational protocol concepts
Deposited Transactions and Withdrawals are more fundamental than:
They operate at a lower protocol level and provide a more general mechanism for cross-domain execution.
Sequencer bypass use case
Deposited transactions enable EOAs to interact with L2 contracts even when the Sequencer is down.
This tutorial now serves as a concrete example of:
2. Tutorial Order Adjustment
Tutorials related to Supersim have been moved to appear after the standard tutorials to improve learning flow and conceptual progression.
Testing
Submitting Arbitrary L2 Transactions from L1
Verified via the following transactions:
L1 Transaction
https://sepolia.etherscan.io/tx/0xa16603a96a236b12ac97f2c025cf25a3f5d1a68d4162e5f021dfe7e934a8d157
L2 Transaction
https://sepolia-optimism.etherscan.io/tx/0x879c9bd7e4f25769dbcabbe6e60aa8c9a3ea9a6d9587dd1223ffa067ef225a88
References
Unichain Docs:
Submitting Transactions from L1
OP Stack Specification:
Deposited transactions
Withdrawals
Viem OP Stack Docs:
Deposits Guide