Wormhole
Search
⌃K

Token Register

Portal bridge allows protocols to permissionlessly send their tokens cross-chain, allowing access to more markets and users! Using Portal bridge as the canonical bridge to send your token cross-chain ensures there is no double wrapping of your asset when sending it between multiple chains. Following the guide below ensures that the token name and symbols appear correctly on the explorers.
By adding your token into Wormhole's token list, your token will appear in the Portal bridge's token selector UI

📖 Terminology

Origin chain: The chain the tokens are minted on
Target chain: The chain you want to send the tokens to

⛓ Origin chain: Solana, Target chain: EVM chain

Before registering:
Registering:
  • Register the token using Portal bridge token register​
  • Send tokens to target chain via Portal bridge
  • Add token to the token list (Coingecko, Coinmarketcap etc)
  • (Optional): Add token to Wormhole's token list ​

⛓ Origin chain: EVM chain, Target chain: Solana

Before registering:
  • Ensure the token contract’s name and symbol are correct on the EVM chain
Registering

⛓ Origin chain: EVM chain, Target chain: EVM chain

Before registering:
  • Ensure the token contract’s name and symbol are correct on the origin EVM chain
Registering
  • Register the token using Portal bridge token register​
  • Send tokens to target chain via the Portal bridge
  • Add token to token list (Coingecko, Coinmarketcap etc)
  • (Optional): Add token to Wormhole's token list ​

⛓ Origin chain: Solana, Target chain: Move chain

Before registering:
Registering:

⛓Origin chain: Move chain, Target chain: EVM chain

Registering:
  • Register the token using Portal bridge token register​
  • Send tokens to target chain via the Portal bridge
  • Add token to token list (Coingecko, Coinmarketcap etc)
  • (Optional): Add token to Wormhole's token list​

⛓Origin chain: Move chain, Target chain: Solana

Registering:

⛓Origin chain: EVM chain, Target chain: Move chain

Before registering:
  • Ensure the token contract’s name and symbol are correct on the origin EVM chain
Registering

❓Frequently asked questions

How do I check if my token’s metadata is registered on-chain?

Using the token origin verifier:
  1. 1.
    Head to https://portalbridge.com/#/token-origin-verifier​
  2. 2.
    Select chain as Solana, paste in the token contract address
  3. 3.
    In Bridge Results, select the target chain
  4. 4.
    Hover on top of the token name in bridge results, it will show the correct name on the target chain <token name> (Wormhole)
Using Solana explorer:
On Solana, you’ll be able to see if your token has on-chain metadata by searching the token on the Solana explorer and details in the metadata tab.
Example of a token with no on-chain meta data:
​

My token’s name doesn’t show up correctly on the explorer.

  • If the token is originally from Solana, ensure the token has on-chain meta data
  • Update the token using the Portal bridge token register​
  • Once updated, You’ll need to contact the relevant explorer to update their on-chain data.

My token logo does not appear on the explorer or any of the properly.

The token logo is retrieved from token lists such as Coingecko and Coinmarketcap. Please contact the token lists and add your token to their list.
​

My token cannot be searched on <dex/protocol>, I can only search for it via the token contract code, not the name.

The token name is retrieved from token lists such as Coingecko and Coinmarketcap. Please contact the token lists and add your token to their list.

I registered my token without adding the on-chain metadata from Solana and sent the token cross chain.

  • Add on-chain metadata for the token
  • Update the token using the token register ​
  • If the name on the target chain explorer appears as (Wormhole), please contact the explorer to update the name.

How do I verify my token on <chain> ?

For Ethereum and most EVM chains, please check out this doc herehttps://github.com/wormhole-foundation/wormhole/blob/main/ethereum/docs/token_verification.md
Previous
Video Tutorial: How to use the Token Origin Verifier
Next
Tutorial: Token registration
Last modified 1mo ago