Bridging Your Standard ERC-20 Token Using the Standard Bridge

In this tutorial you’ll learn how to bridge a standard ERC-20 token from Ethereum to an OP Stack chain 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 layer 2.

This tutorial explains how to use the OptimismMintableERC20Factory to deploy a standardized ERC-20 token on layer 2. 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 Using the Standard Bridge instead.

About OptimismMintableERC20s

The Standard Bridge system requires that L2 representations of L1 tokens implement the IOptimismMintableERC20 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 to create a basic standardized ERC-20 token on layer 2.

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.

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 at 0x5589BB8228C07c4e15558875fAf2B859f678d129 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 use the OptimismMintableERC20Factory 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.

1

You’ll need a private key in order to sign transactions. Set your private key as an environment variable with the export command. Make sure this private key corresponds to an address that has ETH on OP Sepolia.
2

export TUTORIAL_PRIVATE_KEY=0x...
3

You’ll need an RPC URL in order to connect to OP Sepolia. Set your RPC URL as an environment variable with the export command.
4

5

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 export command.
6

7

You can now deploy our L2 ERC-20 token using the OptimismMintableERC20Factory. Use the 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.
8

Bridge Some Tokens

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 Adventure Layer SDK to learn how to bridge your L1 ERC-20 to L2s using the Adventure Layer SDK.

Add to the Superchain Token List

The Superchain Token List is a common list of tokens deployed on chains within the Adventure Layer Superchain. This list is used by services like the Adventure Layer Bridge UI. If you want your Adventure Layer Testnet token to be included in this list, take a look at the review process and merge criteria.

Was this page helpful?