Skip to main content

Deploy preset contracts via Immutable Hub

This quick tutorial covers everything you need to do to launch a standard contract (ERC-721, ERC-1155, ERC-20) via the Immutable Hub.


Prerequisites and setup

Setting up Immutable Hub account and zkEVM project

Join Immutable Hub

Immutable Hub is the admin panel and learning platform for Immutable developers. Sign up typically takes between 3 and 5 minutes and you’ll be asked a few simple questions to help us understand what you’re building.

Immutable Hub

Use the Immutable Hub to create a zkEVM project

Once you’ve set up your Immutable Hub account, you can create a project. Create a project and fill in the following in the setup flow:

  • Project Name: the name of your application (e.g. My Project)
  • Project Rollup: Immutable zkEVM
  • Environment Name: anything you want (e.g. Testing)
  • Environment Type: Testnet

Games should initially build on our testing/testnet environment before switching to production/mainnet.

Once complete, you will see many features on the sidebar where you'll configure your Immutable integration for this project and environment.

New Immutable Hub Project

Deploying a preset contract via Immutable Hub

The Immutable Hub allows you to deploy preset contracts for ERC-721, ERC-1155, and ERC-20 tokens. This is the easiest way to deploy a contract and is recommended for most users.

If you haven't, follow the setup guide above, and then navigate to your project and environment in the Immutable Hub. Click on the Contracts submenu on the left-hand side.

Hub contracts page

A drawer will open with a list of preset contracts you can deploy. Select a preset, fill in the necessary details and click on the Deploy button.

Deploy contract drawer

Hub will automatically check your wallet's connected network. If your network is not already connected to the respective chain (IMX zkEVM Testnet or IMX zkEVM Mainnet), then you will prompted in Metamask to switch. Here, select Switch Network. If you are deploying on Testnet, tIMX will be automatically given to you via our faucet as part of the process.

Switching network

Once connected to the correct network, you will see a Deploy Status modal with the steps required to deploy your contract. The steps vary depending on the preset you are deploying, but we will prompt you for any actions required for each step (such as signing a transaction, granting minting permissions for ERC-721 and ERC-1155, etc).

Deployment steps

Once all steps are completed, you will be redirected to your deployed contract's page with a link to view your contract on the Immutable zkEVM Testnet Explorer or the Immutable zkEVM Mainnet Explorer.

Contract details page
🎉Contract Deployed Successfully!
You can now view your contract on the Immutable zkEVM Testnet Explorer or the Immutable zkEVM Mainnet Explorer by searching for your contract address (visible in Hub). Alternatively, you can click on your deployed contract in the Immutable Hub and click the Block Explorer link.