Bridging Your Standard ERC-20 Token to OP Mainnet Using the Standard Bridge
This tutorial is for developers who want to bridge a new ERC-20 token to OP Mainnet. If you want to bridge existing tokens, you can skip to the tutorial on Bridging ERC-20 tokens with the Optimism SDK.
In this tutorial you'll learn how to bridge a standard ERC-20 token from Ethereum to OP Mainnet using the Standard Bridge system. This tutorial is meant for developers who already have an existing ERC-20 token on Ethereum and want to create a bridged representation of that token on OP Mainnet.
This tutorial explains how to use the
OptimismMintableERC20Factory (opens in a new tab) to deploy a standardized ERC-20 token on OP Mainnet.
Tokens created by this factory contract are compatible with the Standard Bridge system and include basic logic for deposits, transfers, and withdrawals.
If you want to include specialized logic within your L2 token, see the tutorial on Bridging Your Custom ERC-20 Token to OP Mainnet Using the Standard Bridge instead.
The Standard Bridge system requires that L2 representations of L1 tokens implement the
IOptimismMintableERC20 (opens in a new tab) interface.
This interface is a superset of the standard ERC-20 interface and includes functions that allow the bridge to properly verify deposits/withdrawals and mint/burn tokens as needed.
Your L2 token contract must implement this interface in order to be bridged using the Standard Bridge system.
This tutorial will show you how to use the
OptimismMintableERC20Factory (opens in a new tab) to create a basic standardized ERC-20 token on OP Mainnet.
This tutorial explains how to create a bridged ERC-20 token on OP Sepolia. You will need to get some ETH on both of these testnets.
You will need an L1 ERC-20 token for this tutorial.
If you already have an L1 ERC-20 token deployed on Sepolia, you can skip this step.
Otherwise, you can use the testing token located at
0x5589BB8228C07c4e15558875fAf2B859f678d129 (opens in a new tab) that includes a
faucet() function that can be used to mint tokens.
Once you have an L1 ERC-20 token, you can use the
OptimismMintableERC20Factory (opens in a new tab) to create a corresponding L2 ERC-20 token on OP Sepolia.
All tokens created by the factory implement the
IOptimismMintableERC20 interface and are compatible with the Standard Bridge system.
Add a private key to your environment
You'll need a private key in order to sign transactions.
Set your private key as an environment variable with the
Make sure this private key corresponds to an address that has ETH on OP Sepolia.
Add an OP Sepolia RPC URL to your environment
You'll need an RPC URL in order to connect to OP Sepolia.
Set your RPC URL as an environment variable with the
Add your L1 ERC-20 token address to your environment
You'll need to know the address of your L1 ERC-20 token in order to create a bridged representation of it on OP Sepolia.
Set your L1 ERC-20 token address as an environment variable with the
# Replace this with your L1 ERC-20 token if not using the testing token!
Deploy your L2 ERC-20 token
You can now deploy our L2 ERC-20 token using the
OptimismMintableERC20Factory (opens in a new tab).
cast command to trigger the deployment function on the factory contract.
This example command creates a token with the name "My Standard Demo Token" and the symbol "L2TKN".
The resulting L2 ERC-20 token address is printed to the console.
cast send 0x4200000000000000000000000000000000000012 "createOptimismMintableERC20(address,string,string)" $TUTORIAL_L1_ERC20_ADDRESS "My Standard Demo Token" "L2TKN" --private-key $PRIVATE_KEY --rpc-url $TUTORIAL_RPC_URL --json | jq -r '.logs.topics' | cast parse-bytes32-address
Now that you have an L2 ERC-20 token, you can bridge some tokens from L1 to L2. Check out the tutorial on Bridging ERC-20 tokens with the Optimism SDK to learn how to bridge your L1 ERC-20 to L2s using the Optimism SDK.
The Superchain Token List (opens in a new tab) is a common list of tokens deployed on chains within the Optimism Superchain. This list is used by services like the Optimism Bridge UI (opens in a new tab). If you want your OP Mainnet token to be included in this list, take a look at the review process and merge criteria (opens in a new tab).