Skip to main content

Deploy smart contracts

Learn everything you need to know to deploy contracts on Immutable zkEVM. As zkEVM offers EVM (Ethereum Virtual Machine) compatibility, smart contract development on zkEVM is almost identical to that on Ethereum.

For convenience, your quick access network details are here:

NetworkChain IDBlock ExplorerRPC Endpoint
Testnet13473https://explorer.testnet.immutable.com/https://rpc.testnet.immutable.com
Mainnet13371https://explorer.immutable.com/https://rpc.immutable.com

⚠️You may not be allowed to deploy your contract on Mainnet
There are two main ways to deploy contracts on Immutable zkEVM.
  1. You can deploy via Immutable Hub
  2. You can also deploy via code
If you are looking to deploy custom non-Immutable contracts via code on Immutable zkEVM Mainnet, your deployment wallet address needs to be specifically allowed. We have a waitlist process for this while we're in "Early Access". Please follow instructions here.

Please note, you DO NOT NEED TO BE ALLOWLISTED either of the following cases:
  • Deploy on Immutable zkEVM Testnet
  • You're deploying contracts via Immutable Hub

Articles in this tutorial includes:

Immutable zkEVM collection requirements

All collections deployed on Immutable's zkEVM must utilise the operator allowlist to protect content creator (eg: you, the game studio's) royalty fees and Immutable's 2% protocol fees.

This can be achieved through embedding the following into your smart contract collection designs:

  • Recommended Approach: For seamless implementation use or inherit Immutable's preset contracts tailored for gas-efficient creation of Web3 gaming assets on the zkEVM network. Immutable offers the following 2 preset contracts:

  • Minimally Required Standard: If the above options are not compatible with your game design, it is mandatory for your collection to inherit the OperatorAllowlistEnforced.sol contract, allowing your collection to interact with the OperatorAllowlist. OperatorAllowlistEnforced includes the functions to identify compliant smart contracts for approvals and transfers, ensuring the preservation of content creators’ royalty fees and protocol fees in third-party marketplace transactions.

    • If your game design restricts your collections from importing Immutable's preset contracts, please note that your request for inclusion on the Mainnet's deployer allowlist may undergo additional processing time. Immutable will conduct thorough verification to ensure that your collections comply with our mandated standards, safeguarding content creators on the network. Thank you for your understanding and cooperation in ensuring Immutable's zkEVM network remains secure for our web3 gaming community.
note

The use of the preset contracts accelerates integration with Immutable's ecosystem. If your studio has developed custom ERC721 or ERC1155 collections, ensure they adhere to their respective standards in addition to inheriting the OperatorAllowlistEnforced.sol contract, to safeguard compatibility with Immutable's ecosystem.