Introducing a New Process For Mapping Tokens on Polygon

Polygon Labs

January 19, 2023

We're excited to share that Polygon's token mapper has become more efficient and decentralized, handing over power to developers like you. By using Polygon's new and improved token mapping process, you will no longer have to wait on us to get your tokens mapped.

What’s New

Rather than relying so heavily on communicating with the Polygon team, as was the case with the previous token mapping method, we are now using the fx portal to avoid certain problems.

Developers, for instance, had a hard time getting things done quickly because they couldn't execute standard or custom token mappings on their own. Each mapping request that was submitted by developers had to be individually reviewed by the Polygon team. This led to an overwhelming increase in requests, necessitating more coordination between developers and the Polygon team to properly fulfill those requests.

It not only delayed the actual execution of token mapping but also made the entire process highly centralized, something we at Polygon aim to fix with the new mapping system.

For the new fx mapping system, the fx root tunnel is responsible for all token mappings; it processes a single ad hoc transaction where you can deploy and map child contracts on your own.

Developers can finish all standard mappings independently in a decentralized manner, without any assistance from the Polygon team. As for the custom mapping that enables creating child tokens on Polygon, developers can create a custom fx portal implementation and deploy it themselves.

Mapping Tokens

To transfer funds between Ethereum and Polygon, a connection between the contract addresses used for minting or burning tokens must be established. This link is recorded in a certain repository (contract) so that the blockchain knows which token is being transferred from one Network to another.

How To Submit A Mapping Request

Step 1: Go to mapper.polygon.technology and click the Map New Token button in the top right corner.

Step 2: Choose the network to which you want to map tokens. You can select Goerli-Mumbai for the Testnet and Ethereum-Polygon for the Mainnet.

Step 3: Choose a token standard from ERC20, ERC721, or ERC1155. For any other Token Standard, please contact the Polygon team via Discord or submit a request with the subject "Token Mapping" in the ticket title.

Step 4: Enter your Ethereum/Goerli Token address. Ensure that the code of your token contract has been verified on Ethereum/Goerli blockchain explorers. If your root token is valid, the name, symbol, and decimal fields will be filled in automatically and cannot be changed.

Step 5: Select Begin mapping to initiate the mapping process. As this involves an Ethereum transaction, you will have to connect your wallet to proceed.

Step 6: You will be shown a review modal with the token information and the estimated gas fees to complete the mapping.

Step 7: Once the details are verified, you may initiate the mapping transaction by selecting the Pay Gas Fee To Map button.

Step 8: On confirming the transaction from your wallet, you just have to wait for the transaction to get completed on Ethereum.

Step 9: Once the transaction is completed, you will be shown the success screen with child token address on Polygon PoS.

For a successful Mainnet mapping, you may provide your token details here to be added on the Polygon Token List.

Check out Polygon's upgraded token mapper and stay tuned to our blog for the latest Polygon updates!