IOptimismMintableERC20
interface so that it can be used with the Standard Bridge system.
A custom token allows you to do things like trigger extra logic whenever a token is deposited.
If you don’t need extra functionality like this, consider following the tutorial on Bridging Your Standard ERC-20 Token Using the Standard Bridge instead.
The Standard Bridge does not support fee on transfer tokens or rebasing tokens because they can cause bridge accounting errors.
About OptimismMintableERC20s
The Standard Bridge system requires that L2 representations of L1 tokens implement theIOptimismMintableERC20
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 create a custom token that implements this interface.
Dependencies
Get ETH on Sepolia and OP Sepolia
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 can use this faucet to get ETH on Sepolia.
You can use the Superchain Faucet to get ETH on OP Sepolia.
Add OP Sepolia to your wallet
This tutorial uses Remix to deploy contracts. You will need to add the OP Sepolia network to your wallet in order to follow this tutorial. You can use this website to connect your wallet to OP Sepolia.Get an L1 ERC-20 token address
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 at0x5589BB8228C07c4e15558875fAf2B859f678d129
that includes a faucet()
function that can be used to mint tokens.
Create an L2 ERC-20 token
Once you have an L1 ERC-20 token, you can create a corresponding L2 ERC-20 token on OP Sepolia. This tutorial will use Remix so you can easily deploy a token without a framework like Hardhat or Foundry. You can follow the same general process within your favorite framework if you prefer. In this section, you’ll be creating an ERC-20 token that can be deposited but cannot be withdrawn. This is just one example of the endless ways in which you could customize your L2 token.1
Open Remix
Navigate to Remix in your browser.
2
Create a new file
Click the 📄 (“Create new file”) button to create a new empty Solidity file.
You can name this file whatever you’d like, for example
MyCustomL2Token.sol
.3
Copy the example contract
Copy the following example contract into your new file:
4
Review the example contract
Take a moment to review the example contract. It’s closely based on the official
OptimismMintableERC20
contract with one key modification:The burn
function has been modified to always revert, making it impossible to withdraw tokens back to L1.Since the bridge needs to burn tokens when users want to withdraw them to L1, this means that users will not be able to withdraw tokens from this contract. Here’s the key part of the contract that prevents withdrawals:5
Compile the contract
Save the file to automatically compile the contract.
If you’ve disabled auto-compile, you’ll need to manually compile the contract by clicking the “Solidity Compiler” tab (this looks like the letter “S”) and press the blue “Compile” button.Make sure you’re using Solidity compiler version 0.8.15 (the same version used in the official Optimism contracts).
6
Deploy the contract
Open the deployment tab (this looks like an Ethereum logo with an arrow pointing left).
Make sure that your environment is set to “Injected Provider”, your wallet is connected to OP Sepolia, and Remix has access to your wallet.
Then, select the Note: The L2 Standard Bridge address is a predefined address on all OP Stack chains, so it will be the same on OP Sepolia and OP Mainnet.
MyCustomL2Token
contract from the deployment dropdown and deploy it with the following parameters: