Skip to content

Create Multichain Tokens

Introduction

Blockchain ecosystems are becoming increasingly interconnected, with assets often needing to exist across multiple networks to maximize their utility and reach. For example, tokens created on one chain may want to expand to others to tap into broader audiences and liquidity pools.

This guide explains how to create a multichain token—a token that seamlessly bridges across blockchains using the Wormhole protocol. The process is designed to be user-friendly. With just a few steps, your token can become multichain, enabling it to be traded or used on various networks.

By the end of this tutorial, you'll learn:

  • How to register your token for bridging
  • How to create a wrapped version of your token
  • How to ensure its visibility on blockchain explorers

Let’s begin with a straightforward, step-by-step process for creating a multichain token and expanding its reach.

Register the Token on the Source Chain

The first step in creating a multichain token is registering your token on its source chain. This ensures the token is prepared for bridging across blockchains. Follow these steps:

  1. Open the Portal Bridge
  2. Select the blockchain where your token is currently deployed (source chain)
  3. Connect your wallet by following the on-screen instructions
  4. Locate the Asset field and paste the token contract address
  5. Click Next to proceed

Source Chain Registration Screen

Register the Token on the Target Chain

After registering your token on the source chain, the next step is to select the target chain—the blockchain where you want the wrapped version of your token to exist. This step connects your token to its destination network.

  1. Choose the blockchain where you want the token to be bridged (target chain)
  2. Connect your wallet to the target chain
  3. Click Next to finalize the registration process

Target Chain Registration Screen

Send an Attestation

Attestation is a key step in the process. It verifies your token’s metadata, ensuring it is correctly recognized on the target chain’s blockchain explorer (e.g., Etherscan).

  1. Click Attest to initiate the attestation process
  2. Approve the transaction in your wallet when prompted

Send Attestation Screen

Note

  • Attestation is crucial for token metadata to appear correctly on blockchain explorers like Etherscan, allowing users to identify and trust your token
  • Ensure you have sufficient funds to cover transaction fees on the target chain

Create the Wrapped Token

The final step is to create the wrapped token on the target chain. This token represents the original asset and enables its use within the target blockchain.

  1. Click Create to generate the wrapped token
  2. Approve the transaction in your wallet when prompted

Create Wrapped Token Screen

Upon successful creation, you will see a confirmation screen displaying key details such as the source chain, target chain, and transaction status. This helps verify that the process was completed correctly. Refer to the image below as an example:

Confirmation Screen

Additional Steps and Recommendations

After creating your multichain token, there are a few optional but highly recommended steps to ensure the best experience for users interacting with your token.

Add Your Token to the Wormhole Metadata List (Legacy)

For legacy compatibility in the Advanced Tools section of Portal Bridge, you can request updates to your token metadata. Follow these steps:

  1. Join the Wormhole Discord server
  2. Submit a request for metadata updates in the appropriate support channel

Note

These updates only apply to the Advanced Tools section of Portal Bridge and will not update how your token appears in other Wormhole-powered apps or on blockchain explorers like Etherscan.

Update Metadata on Blockchain Explorers

It is recommended that you update your token’s metadata on blockchain explorers such as Etherscan. This includes adding details like the token logo, price, and contract verification.

  1. Create an account on the relevant scanner and go to the token update section (or the relevant scanner that you would like to update metadata on)
  2. Copy and paste the wrapped contract address in the Token Update Application Form
  3. Before proceeding to the next step, you will need to verify as the contract address owner on Etherscan’s address verification tool
  4. Follow the directions to verify contract address ownership via MetaMask by reviewing the guide on verifying address ownership
  5. Given that Wormhole may be the contract owner, use the manual verification process by reaching out through the Etherscan contact form. The team will provide support as needed
  6. Once the step above is completed, follow the instructions to update token information

Got any questions?

Find out more