Migrating to Ironwood – iOS Walkthrough

For the Android version of this article, please see here.

Zcash has upgraded, introducing a new shielded pool called Ironwood. This article describes step-by-step migration process for Zodl users on iOS.

Please see our primary article on moving your funds to Ironwood and what users ought to know.

The short version

• If you have an Orchard balance, Zodl will prompt you to migrate it to Ironwood. Migrating is simple and upgrades you to the latest secure pool.
• You stay in control of your funds the whole time.
• Our private migration feature will ensure your funds move with the greatest possible privacy, breaking it into unidentifiable amounts and prompting you to send at randomised intervals.
• If you do not wish to wait, you can also migrate immediately, though this reveals your full balance on-chain.

Step-by-Step (iOS)

Migration widget: Upon updating Zodl, you'll see a prompt to migrate your Orchard balance to Ironwood. Tap Migrate to begin the process.

Migration options: You'll see two options, one to migrate immediately, another to migrate with privacy. Immediate migration will send your full balance to Ironwood in a single transaction. It's the fastest option, but offers less privacy because the full amount crosses over at once, a figure that is revealed on the blockchain. The rest of this walkthrough describes the 'Migrate with privacy' option.

Summary: On the next screen, you'll receive a summary of how migration works.

Enable Tor protection: You'll be prompted to enable Tor. We strongly recommend enabling Tor, as not doing so will leak your IP address to the remove server, which is further linked to your migration amounts. The only reason to disable Tor here would be if Tor isn't legally permitted in your region, in which case, please highly consider using a trusted VPN (such as Nym) before continuing.

Allowing notifications: Ideally, you're able to keep Zodl open and active for as long as possible in order to allow the migration process to continue. If Zodl is closed, you'll receive notifications to prompt you to open Zodl when the next migration step is ready. Please allow notifications.

Confirm transfer plan: This screen shows the plan for each individual migration transaction and their approximate timing. After reviewing, tap 'Start migration'. You'll be prompted for authentication to sign the migration transactions.

Migration scheduled: You'll receive confirmation after signing the transaction plan, with a summary of what to expect, including timing.

Migration progress: On your main Zodl screen, you'll see a persistent widget informing you of the migration process. Tap 'More' to see details.

Keep Zodl open for as long as you can to facilitate the migration. You'll see continued updates on this screen and when tapping 'More'. If you have to close Zodl, no worry: you can open it again later when prompted to continue where it left off.

Migration progress details: Here you'll see the status of each transfer in the process.

Preparing your balance: If tapping 'Show details' on the prior screen, you'll see the breakdown of the first steps of migration. Your balance needs to first be prepared by splitting it into transfer-sized notes.

Notifications: If Zodl is not the active screen, you will periodically receive notifications prompting you to open Zodl when the next step is ready. Please open Zodl and leave it open and active for the next migration steps to take place.

Next step / Transfer waiting: If you see a notification from Zodl that a transfer is waiting, tap 'More' and review the Resume Migration screen.

Resuming migration: Tap 'Send now' to continue with the scheduled migration transaction. After sending, your wallet will have to wait ~3 minutes before syncing again for privacy reasons. If you choose to reschedule, your migration plan will update and you'll be able to use Zodl in the meantime.

Migration complete: Once migration has completed, you'll be notified by the widget below. Tap 'More' for next steps.

Locking funds: The migration process transfers standardised amounts, which means a remainder from your Orchard funds is not moved by default. This screen allows you to sweep it (which can be indentifiable), or for better privacy, lock it from being inadventently spent when using Zodl. This lock is only local to this Zodl instance, and does not remain if importing your wallet into another instance. A future update of Zodl will allow you to unlock these funds.

Viewing your pool balances: On Zodl's main screen, you can confirm your migration to Orchard by tapping your balance. This shows a breakdown of your funds across all pools.

Still need help?

If something doesn't look right, or your migration seems stuck after reopening the app, contact us at support@zodl.com and tell us where you are in the flow.