4. Adding your ERC-20 token to Immutable's Commerce Widget
This guide will take you through making your ERC-20 tokens available in our widgets, which can be used in your game or project.
Once you have completed this guide, your ERC-20 token will show up in the following widgets:
| Feature | Description |
|---|---|
| Commerce Widget | The Commerce Widget is a drop-in solution for web-based games and marketplaces that offers user's a range of Flows on the Immutable zkEVM network. |
| Commerce Widget - Connect Flow | The Connect Flow is a drop-in solution for web-based games and marketplaces that offers users a friendly wallet interface, simplifying the process of linking their wallets and integrating into the Immutable zkEVM network. |
| Commerce Widget - Wallet Flow | The Wallet Flow is a drop-in solution for web-based games and marketplaces that simplifies the process of checking wallet balances on the Immutable zkEVM and Ethereum networks as well as accessing the bridging and swapping features. |
| Commerce Widget - Swap Flow | The Swap Flow is a drop-in solution for web-based games and marketplaces that simplifies the process of swapping tokens on the Immutable zkEVM network. |
| Commerce Widget - Bridge Flow | The Bridge Flow is a drop-in solution for web-based games and marketplaces that simplifies the process of moving tokens from and to the Immutable zkEVM network. |
| Commerce Widget - On‑ramp Flow | The On-ramp Flow is a drop-in solution for web-based games and marketplaces that simplifies the process of purchasing tokens with fiat (e.g. USD) onto the Immutable zkEVM network. |
| Commerce Widget - Primary Sales Flow | The Primary Sales Flow is a drop-in, web-based solution that allows games to access third party services with an existing inventory system to sell items for the first time on the Immutable zkEVM network. |
To use your ERC-20 token in these widgets, you must verify your token with Immutable. Once verification has been completed, your ERC-20 token will automatically become available across all of our Commerce Widget Flows.
How do I verify my token?
To verify your token with Immutable, you'll need your ERC-20 address on hand.
1. Verify your linked token
Once your token is linked, you can verify it by going to the token details page in the Immutable Hub and clicking the "Verify with Immutable" button.
A more detailed guide can be found in the asset verification guide, alongside the requirements for asset verification.
2. Use your token in the Commerce Widget
After verification, your token is ready to use in our Commerce Widget! Refer to the individual pages on each Widget Flow for more information on integrating them into your game.
3. Additional steps
Certain widgets require some additional steps.
Commerce Widget Bridge Flow
Immutable leverages Squid to perform bridging transactions for users.
For your ERC-20 token to be discoverable through the Squid UI, it first needs to be included in the allowlist of tokens for Immutable zkEVM.
To allowlist an ERC-20 token, you must contact our support team on Discord or your designated contact if you are an Immutable partner. This includes providing requested details about your ERC-20 token and specifying that you want your ERC-20 token included on Squid's bridge tool.
Once included in the allowlist, the token might take a few days to sync on Squid’s UI.
Commerce Widget On-Ramp Flow
To enable users to on-ramp your ERC-20 token using Immutable's widget, please follow all steps in the on-ramp guide later in this section.
Commerce Widget Primary Sales Flow
Refer to the Primary Sales section for instructions on adding your ERC-20 token as an eligible payment form.