Illuvium is preparing to migrate its assets and core services from the current Immutable infrastructure to Immutable zkEVM. This guide is designed to help players understand what zkEVM is, what will happen during the migration window, which features will be available at different stages, and what actions, if any, are required from you.
What Is Immutable zkEVM?
Immutable zkEVM is an upgraded blockchain environment built using zero-knowledge technology and fully compatible with Ethereum. For players, this basically means a more reliable foundation for Illuvium’s games and web services over the long term.
Why Immutable zkEVM?
Since Illuvium is already built on Immutable, this migration becomes a natural next step within the same ecosystem, and it occurs with minimal friction. Moving from the current Immutable infrastructure to Immutable zkEVM gives us greater scalability, smoother performance, and a modernised foundation for future gameplay systems.
What Do Players Need to Do?
For most players, no action is required. Your assets will migrate automatically. After migration:
Update game clients if prompted
Re-list marketplace items once trading is available
Monitor official channels for feature availability updates
If you notice missing assets or discrepancies after systems are fully back online, contact Support with your wallet address and any relevant transaction details.
Key Dates and Timing
The migration window is scheduled to begin in late-January. We will update with a hard date closer to the migration.
The process includes a multi-hour maintenance period and may involve extended read-only states over the course of the week. Exact timing depends on coordination with Immutable and post-migration verification.
Following the migration, features are expected to return in stages, with systems coming back online gradually rather than all at once.
What to Expect During the Migration Window
During the migration period, players should expect:
Temporary downtime across Illuvium Web services
Read-only modes where assets are visible but not interactive
Trading and marketplace activity to be paused
Delayed availability of some claim and payment flows
These steps are necessary to ensure assets are migrated safely and correctly. We recommend avoiding time-sensitive actions close to the migration start.
⚠️ Note on ERC-20 Migration Timing ERC-20 tokens (e.g. ILV, sILV2, ETH, USDC) held in Passport wallets will not migrate at the same time as assets. ERC-20 migration is handled by Immutable and will occur after the asset migration is complete. Players may briefly see migrated assets without their corresponding tokens. This is expected.
We’re working with Immutable to see if ERC-20 migration can be included during the freeze window for a smoother experience—but timing is not guaranteed.
What to Expect During the Migration Window
During the migration period, players should expect:
Temporary downtime across Illuvium Web services
Read-only modes where assets are visible but not interactive
Trading and marketplace activity to be paused
Delayed availability of some claim and payment flows
We recommend avoiding time-sensitive actions close to the migration start.
Feature Availability: Day One vs Later
Not all features will return at the same time. Here’s a high-level overview of what to expect.
Expected to be available early
Automated reward systems
Automated rewards from the Rewards Dashboard will be available as soon as the migration is complete.
Asset visibility across Illuvidex
You will be able to see all of your assets in Illuvidex as soon as the migration is complete.
Games: Arena, Zero, and Overworld
Arena and Zero will receive patches to connect to the new Assets and Metadata APIs and zkEVM endpoints. For players, this will feel like a normal update.
Overworld will be taken offline separately as part of preparations for the upcoming MMO.
Expected to return in phases
Marketplace Listing and Trading
All existing marketplace listings on the current Immutable chain will be cleared during migration. Listings cannot be carried over to zkEVM.
Once the zkEVM marketplace is live, players will need to re-list any items they wish to trade. This reset also removes stale and outdated listings accumulated over time, helping create a healthier marketplace environment moving forward.
Claims and Legacy Items
Some legacy campaign-style claim flows may be paused, redesigned, or reintroduced later. Usage of many of these legacy claims is extremely low, so any changes are expected to have minimal player impact.
Payments Flows on zkEVM
Fuel purchases via Stripe and existing supported chains are expected to continue with minimal disruption.
Some payment flows directly tied to zkEVM, such as token-based purchases or ILV-related actions on zkEVM, may not be available on day one and will roll out after migration as systems are validated.
Wallet Tokens Migration
The migration of ERC-20 tokens, including ILV and sILV2, held in Passport wallets will occur at the end of the process, once all assets have been successfully migrated.
Gas Fees and IMX
Some actions on zkEVM may require a small IMX balance to cover gas fees.
The player purchasing items from the shop won't incur any fees. Nor if players want to trade in the Illuvidex and their assets are on the Passport Wallet. However, if their assets are on a secondary wallet such as a hardware wallet or Metamask, there will be a gas fee.
Known Risks and Setting Expectations
We want to be transparent about potential friction:
Maintenance may extend based on verification requirements
Marketplace and token features may return gradually
Some claims may be delayed, redesigned, or deprecated
Gas and token handling may evolve as Immutable finalises configuration
Our priority is asset safety and correctness—not speed.
Support and Further Information
For help and updates:
Visit the Help Center for detailed articles and known issues
Follow official announcements on X and Discord
Contact Support if something does not look right after migration
What Comes Next
This migration is a significant infrastructure upgrade that positions Illuvium for the next phase of development across its ecosystem. We appreciate your patience and support as we complete this transition, and we will continue to communicate clearly at every stage.