🎉 We are deprecating the Optimism SDK and migrating all tutorials to use viem/op-stack. Read more →
App Devs
Tutorials
Interop tutorials
Transferring a SuperchainERC20
💡

The SuperchainERC20 standard is ready for production use with active Mainnet deployments. Please note that the OP Stack interoperability upgrade, required for crosschain messaging, is currently still in active development.

Transferring a SuperchainERC20

This guide provides an overview of transferring SuperchainERC20 tokens between chains.

Overview

Transferring SuperchainERC20 tokens between chains involves two main phases:

  1. Source Chain Operations
    • Mint tokens if needed
    • Initiate the transfer using the bridge
  2. Destination Chain Operations
    • Relay the transfer message
    • Verify the transfer completion
⚠️

Always verify your addresses and amounts before sending transactions. Cross-chain transfers cannot be reversed.

How it works

This diagram illustrates the process of a SuperchainERC20 token transfer between chains. Through the L2ToL2CrossDomainMessenger contract, tokens are burned on the source chain and a transfer message is emitted. This message must then be relayed to the destination chain, where an equivalent amount of tokens will be minted to the specified recipient address - ensuring secure cross-chain transfers while maintaining the total token supply across all chains.

Prepare your tokens

Ensure you have tokens on the source chain using one of these methods:

Initiate the transfer

To start the transfer:

  1. Choose the destination chain where you want to receive the tokens
  2. Specify the recipient address and the amount to transfer
  3. Call the bridge contract, which will:
    • Lock or burn your tokens on the source chain
    • Emit a message that will be used to mint tokens on the destination chain

Complete the transfer

To finalize the transfer on the destination chain:

  1. Get the message details from the source chain event
  2. Use the L2ToL2CrossDomainMessenger contract to relay the message
  3. The message relay will trigger the minting of tokens on the destination chain

The transfer isn't complete until the message is successfully relayed on the destination chain. See the technical reference guide for specific relay instructions.

Verify completion

After relaying the message:

  1. Check your token balance on the destination chain
  2. Confirm the transferred amount matches what you sent
  3. The tokens should now be available for use on the destination chain

For detailed technical instructions including contract addresses, specific commands, and message relaying details, refer to our technical reference guide.

Alternative methods

You can also use:

Next steps