Skip to main content

The Base Goerli Token List

This page is intended for token issuers who already have an ERC-20 contract deployed on Ethereum and would like to enable their token for bridging between Ethereum and Base Goerli testnet using the base bridge web interface.

Adding your token to the list​

The steps below explain how to get your token on the Base Goerli Token List which serves as the source of truth for these services:

Step 1: Deploy your token on Base Goerli​

Select your preferred bridging framework and use it to deploy an ERC-20 for your token on Base Goerli. We recommend you use the framework provided by Base’s standard bridge contracts, and furthermore deploy your token using the OptimismMintableERC20Factory. Deploying your token on Base Goerli testnet in this manner provides us with guarantees that will smooth the approval process. If you choose a different bridging framework, its interface must be compatible with that of the standard bridge, otherwise it may be difficult for us to support.

Step 2: Submit details for your token​

We are using the Superchain token list repository for annotating which tokens are available on Base Goerli. Follow the instructions in this repository and submit a PR containing the required details for your token. You must specify in your token’s data.json file a section for ‘base-goerli’ (please do not specify a ‘base’ section until our mainnet is live). The change you need to submit is particularly simple if your token has already been added to the Optimism token list. For example, this PR shows the change required for cbETH, which was already on Optimism’s token list and relies on the Base standard bridge.

Step 3: Await final approval.​

info

Note that approval is not guaranteed or automatic. All submissions for Base listing are subject to manual review by the Base team.

FAQ​

Q: Does the standard bridge support common ERC-20 extensions such as ERC-2612 or ERC-677?
A: Tokens minted using the standard bridge token factory do not have these extensions, but you can still deploy a contract with these extensions for your token on Base Goerli and have it bridgeable with the standard bridge as long as it implements the OptimismMintableERC20 interface. We note that Permit2 contract support is available on Base Goerli for anyone wishing to leverage permit-style approvals in their dApp flows without requiring any token contract extensions.
Q: Does my token have to be on the Base Goerli Token List to be used on Base?
A: Base is an open and permissionless network built on the OP Stack. Anyone can therefore create a token on Base with or without the Base standard bridge, or deploy and leverage any other EVM compatible bridging framework.