If you're unable to access your assets on Immutable X Layer 2 (L2) due to using a hardware wallet that doesn't support deterministic signing, follow this guide to recover your assets.
Why Am I Locked Out?
Some hardware wallets do not support deterministic signing, preventing proper transaction signing on Immutable X. This can lead to error messages when interacting with your assets on L2.
Common Error Messages:
- "Provided Stark key does not match with the current active key"
- "Withdraw preparation failed"
- "Link error code 6005. The API rejected the listing"
Solution: Ejecting Assets from L2 to L1
If your Stark key doesn't match, recovery is unfortunately not possible. The only option is to eject your assets from Immutable X (L2) to Ethereum (L1) using a forced withdrawal.
However, if you did not register your Stark key on-chain before the v4 upgrade, we cannot perform a forced withdrawal for you.
Why?
- In previous versions, on-chain registration was required for users to claim their withdrawals.
- With the v4 upgrade, on-chain registration is no longer mandatory, meaning some users may not have completed this step.
- If your Stark key was never registered on-chain, a forced withdrawal would result in your funds being locked on-chain, requiring a signature from your Starkex private key—which you no longer have access to.
- This process only works if you manually registered on-chain or performed ramping operations before the v4 upgrade.
Steps to Recover Your Assets
Step 1: Confirm Wallet Ownership
- Go to the Message Signing Tool.
- Enter a test message and click Sign the message.
- Follow the prompts in your wallet to sign the transaction.
- Copy and save the generated Signature URL.
Step 2: Retrieve Your Stark Key
Open your browser and visit the following URL:
https://api.x.immutable.com/v1/users/<replace_this_with_users_wallet_address>
The results will show something like this:
{"accounts":["<your_stark_key>"]}
Step 3: Raise a Support Request
- Contact us through here.
- Provide the following details:
- Wallet address
- Signature URL from Step 1
- Stark key from Step 2
- Any relevant screenshots or videos
Step 4: Investigation
- Our engineering team will work to force the withdrawal of your assets.
- The process may take 1–2 weeks, depending on volume.
Step 5: Complete the Withdrawal
Once your assets are ready for withdrawal, use the Immutable X Full Withdrawal Tool to transfer them to Ethereum (L1):
- Ensure you select Mainnet and connect your wallet.
- Initiate a full withdrawal to complete the process.